מאגר הנתונים של Microsoft Outlook ל-Gemini Enterprise מאפשר לכם לחפש ולבצע פעולות באימיילים, ביומנים, באנשי הקשר ובקבצים של Microsoft 365 (חוברות עבודה של Excel, מסמכי Word ומצגות PowerPoint) שמאוחסנים ב-OneDrive וב-SharePoint.
גרסאות נתמכות של Microsoft Outlook
מאגר הנתונים של Microsoft Outlook תומך ב-Microsoft Graph API בגרסה 1.0 עם שילוב של IDP.
פעולות נתמכות
כשהגישה למאגר הנתונים של Microsoft Outlook מופעלת, משתמשי הקצה יכולים להשתמש בפקודות בשפה טבעית ב-Gemini Enterprise כדי לבצע את הפעולות הבאות.
| פעולה | תיאור |
|---|---|
| יצירת איש קשר | יצירת איש קשר חדש ב-Microsoft Outlook. |
| יצירת אירוע | יצירת אירוע חדש. |
| הורדת קבצים מצורפים | הורדת קובץ מצורף מהודעת אימייל ב-Microsoft Outlook. |
| שליחת דואר | שליחת הודעת אימייל. זה כולל שליחת אימייל עם קבצים מצורפים. |
| הוספת קבצים מצורפים | הוספה של קובץ מצורף אחד או יותר לטיוטה קיימת של הודעת אימייל. |
| יצירת הודעה | יוצר טיוטה חדשה של הודעת אימייל בתיבת הדואר של המשתמש המחובר. |
| העברת אימייל | העברה של הודעת אימייל קיימת לנמען אחד או יותר. |
| העברת אימייל | העברת הודעת אימייל לתיקיית דואר אחרת בתיבת הדואר של המשתמש שמחובר לחשבון. |
| מענה להודעה | שליחת תשובה להודעת אימייל קיימת בתיבת הדואר של המשתמש המחובר. |
| עריכת ההודעה | עדכון טיוטה קיימת של הודעת אימייל בתיבת הדואר של המשתמש המחובר. |
| עדכון איש הקשר | עדכון איש קשר קיים ב-Microsoft Outlook. |
| עדכון אירועים | עדכון אירוע קיים. |
| קריאת נתונים מ-Excel | מציג רשימה של חוברות עבודה, קורא גיליונות עבודה, טבלאות ושורות מקובצי Excel (בסיומת .xlsx) שמאוחסנים ב-OneDrive או ב-SharePoint. |
| עריכת נתונים ב-Excel | הוספה ועדכון של שורות, יצירת גיליונות אלקטרוניים וטבלאות והוספת עמודות מפתח בקובצי Excel (בסיומת .xlsx) שמאוחסנים ב-OneDrive או ב-SharePoint. |
| יצירת מסמך Word | יוצר מסמך Word חדש (.docx) ב-OneDrive של המשתמש. |
| המרת מסמך Word ל-PDF | המרת מסמך Word (בפורמט .docx) שמאוחסן ב-OneDrive או ב-SharePoint ל-PDF. |
| יצירת מצגת PowerPoint | יוצר מצגת PowerPoint חדשה (.pptx) ב-OneDrive של המשתמש. |
| המרת PowerPoint ל-PDF | המרת מצגת PowerPoint (.pptx) שמאוחסנת ב-OneDrive או ב-SharePoint ל-PDF. |
| יצירת יומן | יצירת יומן חדש למשתמש שמחובר לחשבון. |
| עדכון היומן | עדכון יומן קיים של המשתמש שמחובר לחשבון. |
| אישור השתתפות באירוע | שליחת תשובה (אישור, דחייה או אישור טנטטיבי) להזמנה לאירוע ביומן. |
ההרשאות הנדרשות
בטבלה הבאה מפורטות ההרשאות שנדרשות לחיפוש ולפעולות ב-Microsoft Outlook.
| מצב חיבור | הרשאה | מטרה |
|---|---|---|
| חיפוש מאוחד | Mail.ReadMail.Read.SharedCalendars.ReadContacts.Read |
(מוענקת) מאפשרת למאגר הנתונים לקרוא את תיבת הדואר של המשתמש המחובר, אימיילים מתיבות דואר משותפות, אירועים ביומן ואנשי קשר. |
| <!-- empty -->הטמעת נתונים | Calendars.Read |
(אפליקציה) מאפשרת למאגר הנתונים לקרוא אירועים בכל היומנים. |
Calendars.ReadBasic.All |
(אפליקציה) מאפשרת למאגר הנתונים לקרוא אירועים מכל היומנים, מלבד מאפיינים כמו גוף האימייל, קבצים מצורפים ותוספים. | |
Contacts.Read |
(אפליקציה) מאפשרת למאגר הנתונים לקרוא את כל אנשי הקשר בכל תיבות הדואר. | |
Mail.Read |
(אפליקציה) מאפשרת למאגר הנתונים לקרוא אימיילים בכל תיבות הדואר. | |
Mail.ReadBasic |
(אפליקציה) מאפשרת למאגר הנתונים לקרוא מאפייני אימייל בסיסיים בכל תיבות הדואר. כולל את כל המאפיינים חוץ מ-body, previewBody, attachments וכל המאפיינים המורחבים. | |
Mail.ReadBasic.All |
(אפליקציה) מאפשרת למאגר הנתונים לקרוא מאפייני אימייל בסיסיים בכל תיבות הדואר. כולל את כל המאפיינים חוץ מ-body, previewBody, attachments וכל המאפיינים המורחבים. | |
User.Read |
(מוענקת) מאפשרת למאגר הנתונים לקרוא את הפרופיל של משתמשים שמחוברים לחשבון. | |
User.Read.All |
(אפליקציה) מאפשרת למאגר הנתונים לקרוא את כל מאפייני הפרופיל, הדוחות והמנהלים של משתמשים אחרים בארגון. | |
User.ReadBasic.All |
(אפליקציה) מאפשרת למאגר הנתונים לקרוא קבוצה בסיסית של מאפייני פרופיל של משתמשים אחרים בארגון. | |
| פעולות | Mail.Send |
(מיופה כוח) מאפשר למאגר הנתונים לשלוח אימיילים בשם המשתמשים בארגון. |
Mail.ReadWrite |
(מוענקת) מאפשרת למאגר הנתונים ליצור, לקרוא, לעדכן, להעביר ולמחוק הודעות, ולהוסיף קבצים מצורפים להודעות. נדרשת לפעולות **הוספת קבצים מצורפים**, **יצירת הודעה**, **עדכון הודעה** ו **העברת אימייל**. | |
Calendars.ReadWrite |
(מיופה כוח) מאפשר למאגר הנתונים ליצור, לקרוא, לעדכן ולמחוק אירועים ביומנים של המשתמשים. | |
Contacts.ReadWrite |
(בהקצאה) מאפשרת למאגר הנתונים ליצור, לקרוא, לעדכן ולמחוק את אנשי הקשר של המשתמש. | |
User.Read |
(מוענקת) מאפשרת למאגר הנתונים לקרוא את הפרופיל של משתמשים שמחוברים לחשבון. | |
| פרודוקטיביות של קבצים (Excel, Word, PowerPoint) | Files.Read.All |
(מואצלת) מספיקה רק לכלים שקוראים מטא-נתונים של קבצים או מורידים תוכן של קבצים: הצגת רשימה של חוברות עבודה ב-Excel, קריאת מטא-נתונים של חוברות עבודה ב-Excel והמרת מסמכי Word (בפורמט .docx) או PowerPoint (בפורמט .pptx) ל-PDF. קורא את כל הקבצים שלמשתמש יש גישה אליהם, כולל קבצים שמאוחסנים באתרי SharePoint שלמשתמש יש גישה אליהם. לא מספיק לפעולות תוכן של חוברת עבודה ב-Excel (ראו את השורה הבאה). |
Files.ReadWrite.All |
(מיופה כוח) נדרשת לכל פעולות התוכן של חוברת העבודה ב-Excel (קריאה וגם כתיבה), כולל קבלת גיליונות אלקטרוניים, קבלת טבלאות, קבלת שורות, קבלת שורה, יצירת גיליונות אלקטרוניים וטבלאות, הוספה ועדכון של שורות והוספת עמודות מפתח. בהתאם למאמרי העזרה של Microsoft Graph API לנקודות הקצה האלה (לדוגמה, worksheet-list, table-list, tablerow-list), ההרשאה המוקצית המקובלת היא Files.ReadWrite. ההרשאה Files.ReadWrite.All מעניקה את אותה יכולת בכל הכוננים שהמשתמש יכול לגשת אליהם (OneDrive אישי וכל ספריית מסמכים ב-SharePoint שלמשתמש יש גישה אליה). נדרשת גם כדי ליצור מסמכי Word ו-PowerPoint ב-OneDrive של המשתמש. |
|
User.Read |
(מוענקת) נדרשת כדי לפתור את המיקום של המשתמש המחובר ב-OneDrive לפעולות על קבצים. | |
| משימות (רשימות של משימות ומשימות ב-Outlook) | Tasks.Read |
(מוענקת) נדרשת לפעולות קריאה ברשימות המשימות ובמשימות של המשתמש המחובר ב-Outlook (הצגת רשימות של משימות, הצגת משימות, קבלת משימה). |
Tasks.ReadWrite |
(בהקצאה) נדרשת לפעולות כתיבה: יצירה, עדכון ומחיקה של משימות ברשימות המשימות של המשתמש המחובר ב-Outlook. | |
| משתמשים וספרייה (ספירה מואצלת) | User.ReadBasic.All |
(מוענקת) נדרשת לכלים שמפרטים או מחפשים פרופילים של משתמשים אחרים בארגון (Get User, List Users וכלים שפועלים בתיבות דואר או ביומנים של משתמשים אחרים). |
כדי לדעת איך מוסיפים את ההרשאות ל-Microsoft Outlook, קראו את המאמר הגדרת Microsoft Outlook וההרשאות הנדרשות.
מגבלות קצב של הטמעת נתונים
מגבלת נפח הבקשות היא 10,000 בקשות API לכל פרק זמן של 10 דקות. המגבלות האלה על קצב העברת הנתונים חלות רק על מאגר הנתונים של Microsoft Outlook כשבוחרים להשתמש בהטמעה כמצב החיבור.
מגבלות
בקטע הזה מתוארות בעיות ומגבלות ידועות שעשויות להשפיע על השימוש שלכם במאגר הנתונים של Microsoft Outlook.
- כשיוצרים אפליקציה חדשה או מוסיפים מאגר נתונים לאפליקציה קיימת, מומלץ לשייך רק מאגר נתונים אחד לפעולות ששייכות לסוג מחבר אחד.
- אי אפשר לאכוף את היקף ההרשאות של VPC Service Controls על מאגרי נתונים קיימים של Microsoft Outlook. כדי לאכוף את VPC Service Controls, צריך למחוק את מאגרי הנתונים וליצור אותם מחדש. מידע נוסף על VPC Service Controls ועל השימוש בפעולות אחרי הפעלת VPC Service Controls זמין במאמר אבטחת האפליקציה באמצעות VPC Service Controls.
- מאגר הנתונים של Microsoft Outlook נתמך רק במיקומים
global,usו-eu.
מאגר הנתונים של Microsoft Outlook יכול לעבד עסקה אחת לשנייה, לכל צומת, ומגביל את העסקאות מעבר למגבלה הזו.
היכולת של מאגר הנתונים של Microsoft Outlook לנסות שוב במקרה של שגיאות חריגה ממגבלת הקצב תלויה בקבלת ערך retry-after מ-Microsoft Graph API, שניתן רק למאגר הנתונים של Outlook. מספר ברירת המחדל של ניסיונות חוזרים הוא 3.
קצב העברת הנתונים של מאגר הנתונים של Microsoft Outlook מוגבל על ידי הגבלות על קריאות ל-API שמוטלות על ידי Microsoft Graph. המגבלות חלות על כל שילוב של מזהה אפליקציה ותיבת דואר – כלומר, אפליקציה ספציפית שניגשת לתיבת דואר של משתמש או קבוצה ספציפיים. חריגה מהמגבלה בתיבת דואר אחת לא משפיעה על היכולת של האפליקציה לגשת לתיבת דואר אחרת.
מאגר הנתונים של Microsoft Outlook ממפה אחד לאחד עם מזהה דייר אחד ב-Azure. הוא לא יכול לכלול כמה דיירים מבודדים ב-Microsoft 365 בתוך ארגון עם כמה דיירים (MTO). צריך ליצור מאגר נתונים ייעודי לכל דייר נפרד.
תיבות הדואר צריכות להיות מועברות באופן מלא ל-Exchange Online. אי אפשר לגשת לתיבות דואר שמתארחות באופן מקומי בסביבת Hybrid Exchange דרך Microsoft Graph API. ניסיונות לשלוח שאילתות לתיבות הדואר האלה או לתיבות דואר בדיירים אחרים עלולים לגרום לשגיאה
MailboxNotEnabledForRESTAPI.מאגר הנתונים של Microsoft Outlook יכול לעבד עסקה אחת בשנייה לכל צומת, ומגביל את העסקאות מעבר למגבלה הזו.
פתרון בעיות בתוצאות החיפוש במאגר הנתונים של Microsoft Outlook
חוסר התאמה בזהות (מצב הטמעת נתונים): אם אתם נתקלים בבעיות של אימיילים, אירועים ביומן או תוצאות חיפוש חסרים כשאתם משתמשים במצב הטמעת נתונים עם Google Identity, ודאו שכתובת האימייל של כל משתמש ב-Google תואמת לכתובת האימייל שלו ב-Microsoft. אם יש חוסר התאמה, Gemini Enterprise לא יכול להחזיר תוצאות חיפוש.
המאמרים הבאים
- כדי ליצור ולהגדיר מאגר נתונים עם Microsoft Outlook, קראו את המאמר הגדרה של מאגר נתונים ב-Microsoft Outlook.