סקירה כללית

מאגר הנתונים של Microsoft Outlook ל-Gemini Enterprise מאפשר לכם לחפש ולבצע פעולות באימיילים, ביומנים, באנשי הקשר ובקובצי Microsoft 365 (חוברות עבודה של Excel, מסמכי Word ומצגות PowerPoint) שמאוחסנים ב-OneDrive וב-SharePoint.

הערה: כשמשתמשים בחיפוש מאוחד או במחברים מאוחדים, מחרוזת השאילתה נשלחת לכל מערכות הבק-אנד של צד שלישי שמופעלות לחיפוש. מחרוזת השאילתה שנשלחת למערכת של צד שלישי עשויה לכלול חלקים מהנתונים שבבקשת החיפוש ובהיסטוריית השיחות שלכם. המערכת של הצד השלישי יכולה לקשר את השאילתה לזהות שלכם. אחרי שהנתונים מגיעים למערכת של צד שלישי, הם כפופים לתנאים ולהגבלות ולמדיניות הפרטיות של המערכת הזו, ולא לתנאים ולהגבלות של Google Cloud.

גרסאות נתמכות של 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.
יצירת יומן	יצירת יומן חדש למשתמש שמחובר לחשבון.
עדכון היומן	עדכון של יומן קיים של המשתמש שמחובר לחשבון.
אישור השתתפות באירוע	שליחת תשובה (אישור, דחייה או אישור טנטטיבי) להזמנה לאירוע ביומן.

הערות:

• יש גם פעולות נוספות לקריאה בלבד.
• גודל הקובץ המקסימלי להעלאה ולהורדה ב-Gemini Enterprise הוא 25MB.
• פעולות ב-Excel,‏ Word ו-PowerPoint דורשות הרשאות נוספות של Microsoft Graph API בקבצים ב-OneDrive או ב-SharePoint שהמשתמש עובד איתם. פרטים נוספים זמינים בקטע [ההרשאות הנדרשות](#required-permissions).

ההרשאות הנדרשות

בטבלה הבאה מפורטות ההרשאות שנדרשות לחיפוש ולפעולות ב-Microsoft Outlook.

מצב חיבור	הרשאה	מטרה
חיפוש מאוחד	Mail.Read Mail.Read.Shared Calendars.Read Contacts.Read	(הענקת הרשאה) מאפשרת למאגר הנתונים לקרוא את תיבת הדואר של המשתמש המחובר, אימיילים מתיבות דואר משותפות, אירועים ביומן ואנשי קשר.
<!--Data ingestion-->הטמעת נתונים	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	(מוענקת) נדרשת לכלים שמפרטים או מחפשים פרופילים של משתמשים אחרים בארגון (קבלת משתמש, הצגת רשימת משתמשים וכלים שפועלים בתיבות דואר או ביומנים של משתמשים אחרים).

הערה: כדי לבצע את הפעולות שקשורות לקבצים שצוינו למעלה, אדמין הדייר של המשתמש צריך להעניק את ההרשאות המתאימות ל-Microsoft Graph API ברישום של אפליקציית OAuth. אם ההרשאות האלה לא ניתנות, בקשות לכלים של Excel, ‏ Word ו-PowerPoint נכשלות עם שגיאת HTTP 403 accessDenied. מומלץ: להעניק את ההרשאה Files.ReadWrite.All, שכוללת את כל הכלים לשיפור הפרודוקטיביות של הקבצים. אם אתם צריכים רק המרה של קובצי Word או PowerPoint ל-PDF וגישה למטא-נתונים או לרשימה של חוברות עבודה ב-Excel (בלי גישה לגיליונות, לטבלאות או לשורות), מספיק להשתמש ב-Files.Read.All. ב-Microsoft Graph יש גם תיעוד של הפעולות שמבוססות על driveItem (המרת PDF של Word/PowerPoint, הצגת רשימה של חוברות עבודה של Excel, קריאת מטא-נתונים של חוברת עבודה של Excel) Sites.Read.All או Sites.ReadWrite.All כחלופות מקובלות (ראו driveItem-get ו-driveItem-get-content-format). שלבי ההגדרה מפורטים במאמר הגדרת Microsoft Outlook וההרשאות הנדרשות.

הערה: אם חסרים Tasks.Read או Tasks.ReadWrite, כלי המשימות של Outlook נכשלים עם שגיאת HTTP 403 notAllowed. אם חסרה ההרשאה User.ReadBasic.All (שהוקצתה), הכלים לחיפוש משתמשים נכשלים עם שגיאת HTTP 403 ‏Authorization_RequestDenied. דיירים שזקוקים לגישת משתמש עם הרשאות גבוהות יותר יכולים להשתמש ב-User.Read.All או ב-Directory.Read.All במקום ב-User.ReadBasic.All.

מידע על הוספת הרשאות ל-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. מספר ברירת המחדל של ניסיונות חוזרים הוא שלושה.

• קצב העברת הנתונים של מאגר הנתונים של Microsoft Outlook מוגבל על ידי מגבלות על קריאות ל-API שנקבעו על ידי Microsoft Graph. המגבלות חלות על כל שילוב של מזהה אפליקציה ותיבת דואר – כלומר, אפליקציה ספציפית שניגשת לתיבת דואר של משתמש או קבוצה ספציפיים. חריגה מהמגבלה של תיבת דואר אחת לא משפיעה על היכולת של האפליקציה לגשת לתיבת דואר אחרת.

• מאגר הנתונים של Microsoft Outlook ממפה אחד לאחד עם מזהה דייר אחד ב-Azure. הוא לא יכול לכלול כמה דיירים מבודדים ב-Microsoft 365 בתוך ארגון עם כמה דיירים (MTO). צריך ליצור מאגר נתונים ייעודי לכל דייר נפרד.

• תיבות הדואר צריכות להיות מועברות באופן מלא ל-Exchange Online. אי אפשר לגשת לתיבות דואר שמתארחות באופן מקומי בסביבת Hybrid Exchange דרך Microsoft Graph API. ניסיונות לשלוח שאילתות לתיבות הדואר האלה או לתיבות דואר של דיירים אחרים עלולים לגרום לשגיאה MailboxNotEnabledForRESTAPI.

• מאגר הנתונים של Microsoft Outlook יכול לעבד עסקה אחת לשנייה לכל צומת, ומגביל את העסקאות מעבר למגבלה הזו.

המאמרים הבאים

• כדי ליצור מאגר נתונים ולהגדיר אותו באמצעות Microsoft Outlook, אפשר לעיין במאמר בנושא הגדרה של מאגר נתונים ב-Microsoft Outlook.