בדף הזה מוסבר איך ליצור מאגר נתונים ולקשר את Gmail ל-Gemini Enterprise.
לפני שמתחילים
נכנסים למסוף Google Cloud באמצעות אותו חשבון שבו משתמשים במופע של Google Workspace שמתכננים לחבר. Gemini Enterprise משתמש במזהה הלקוח שלכם ב-Google Workspace כדי להתחבר ל-Gmail. לחשבונות Google אישיים (חשבונות צרכניים שמסתיימים ב-
@gmail.com) אין מספר לקוח, והם לא נתמכים.כדי לאכוף את בקרת הגישה למקורות נתונים ולאבטח את הנתונים ב-Gemini Enterprise, צריך לוודא שהגדרתם את ספק הזהויות.
הפעלת התכונות החכמות: בחשבון Google Workspace, מפעילים את ההגדרה התכונות החכמות ב-Google Workspace ואת ההגדרה התכונות החכמות במוצרים אחרים שלGoogle . לפרטים, אפשר לעיין במאמר בנושא הפעלה או השבתה של התכונות החכמות ב-Google Workspace.
הוספה לרשימת ההיתרים של אפליקציית OAuth (אדמינים בלבד): מאגר הנתונים של Gmail משתמש באפליקציית OAuth שמנוהלת על ידי Googleכדי לגשת לנתונים שלכם. אם הארגון שלכם מגביל את הגישה לאפליקציות OAuth, האדמין שלכם ב-Google Workspace צריך להוסיף את האפליקציה הזו לרשימת ההיתרים של הארגון. לפרטים נוספים, אפשר לעיין במאמר בנושא הוספת אפליקציית OAuth שמנוהלת על ידי Googleלרשימת ההיתרים.
יצירת מאגר נתונים של Gmail
כדי ליצור את מאגר הנתונים של Gmail, פועלים לפי השלבים הבאים:
במסוף Google Cloud של Google, עוברים לדף Gemini Enterprise.
בוחרים פרויקט קיים או יוצרים פרויקט חדש ב- Google Cloud .
בתפריט הניווט, לוחצים על מאגרי נתונים.
לוחצים על + יצירת מאגר נתונים.
בשדה מקור, מחפשים את Gmail ולוחצים על בחירה.
בקטע פעולות, בוחרים מהרשימה את הפעולות שרוצים להפעיל עבור מחבר Gmail.
במאמר ניהול פעולות מוסבר איך לנהל את רשימת הפעולות.
לוחצים על Continue.
בקטע Configuration (הגדרה):
- ברשימה Multi-region, בוחרים את המיקום של מחבר הנתונים.
- בשדה Data connector name, מזינים שם למחבר נתונים.
- אם בחרתם במיקום
usאוeu, צריך להגדיר את הגדרות ההצפנה:- בוחרים באפשרות מפתח הצפנה בניהולGoogle או מפתח Cloud KMS.
- אם בחרתם באפשרות מפתח Cloud KMS:
- ברשימה Key management type (סוג ניהול המפתחות), בוחרים את הסוג המתאים.
- ברשימה Cloud KMS key בוחרים את המפתח.
אופציונלי: בסעיף מדיניות בנושא הגנה על נתונים רגישים, מצרפים מדיניות קיימת של הגנה על נתונים רגישים כדי לבדוק את הנתונים ש-Gemini Enterprise מאחזר דרך מאגר הנתונים הזה ולבטל את הזיהוי שלהם. אם הארגון שלכם לא דורש מדיניות Sensitive Data Protection, אפשר לדלג על השלב הזה.
אם בתהליך ליצירת מאגר נתונים מופיע הקטע אפשרויות מתקדמות, אפשר לסמן את התיבה הפעלת כתובות IP סטטיות. כך מאפשרים למאגר הנתונים להשתמש בקבוצה קבועה של כתובות IP לתנועה יוצאת, שמתאימה להוספה לרשימת ההיתרים במערכת המקור. מידע נוסף מופיע במאמר בנושא הגדרת יציאה עם כתובת IP סטטית.
לוחצים על יצירה. Gemini Enterprise יוצר את מאגר הנתונים ומציג את מאגרי הנתונים בדף מאגרי נתונים.
בדף מאגרי נתונים, לוחצים על שם מאגר הנתונים כדי לראות את הסטטוס. כשהסטטוס של מאגר הנתונים משתנה מיצירה לפעיל, אפשר להשתמש במחבר של Gmail.
אחרי שיוצרים את מאגר הנתונים, צריך ליצור אפליקציה ולקשר אותה למאגר הנתונים של Gmail לפני שמריצים את השאילתה.
ביצוע שאילתה
בקטע הזה מוסבר איך Gemini Enterprise מנהל את השאילתה שלכם ומהן ההשלכות על הפרטיות של השימוש במאגר הנתונים המאוחד.
אחרי שנותנים הרשאה ל-Gmail ושולחים שאילתת חיפוש ל-Gemini Enterprise:
- Gemini Enterprise שולח את שאילתת החיפוש שלכם ישירות אל Gmail API.
- Gemini Enterprise משלב את התוצאות עם תוצאות ממקורות נתונים מקושרים אחרים ומציג תוצאת חיפוש מקיפה.
הודעות שגיאה ופתרון בעיות
בטבלה הבאה מתוארות הודעות שגיאה נפוצות שאפשר להיתקל בהן במהלך העבודה עם כלי המחבר של Gmail, כולל קודי שגיאות HTTP אפשריים והצעות לפתרון בעיות.
| קוד שגיאה | הודעת השגיאה | תיאור | פתרון בעיות |
|---|---|---|---|
| 403 (ההרשאה נדחתה) | אין תמיכה בחיפוש באמצעות פרטי כניסה של חשבון שירות במאגרי נתונים של Google Workspace. | מנוע החיפוש מכיל מאגרי נתונים של Google Workspace, והאישורים שמועברים הם של חשבון שירות. אין תמיכה בחיפוש באמצעות פרטי כניסה של חשבון שירות במאגרי נתונים של Google Workspace. | להתקשר לחיפוש באמצעות פרטי הכניסה של המשתמש, או להסיר מאגרי נתונים של Google Workspace מהמנוע. |
| 403 (ההרשאה נדחתה) | מאגרי נתונים של Google Workspace לא תומכים בחשבונות לשימוש אישי. | החיפוש מתבצע באמצעות פרטי כניסה של חשבון אישי (@gmail.com), שלא נתמכים במאגרי נתונים של Google Workspace. | להסיר את מאגרי הנתונים של Google Workspace מהמנוע או להשתמש בחשבון Google מנוהל. |
| 403 (ההרשאה נדחתה) | מספר הלקוח לא זהה במאגר הנתונים | החיפוש מותר רק למשתמשים ששייכים לאותו ארגון כמו מאגרי הנתונים של Google Workspace. | מסירים את מאגרי הנתונים של Google Workspace מהמנוע או פונים לתמיכה אם המשתמש ומאגרי הנתונים של Google Workspace אמורים להיות בארגונים שונים. |
| 403 (ההרשאה נדחתה) | האדמין של הארגון השבית את הגישה של Workspace ל-Agent Space. | אדמין ב-Google Workspace השבית את הגישה של Gemini Enterprise לנתוני Google Workspace. | כדי לקבל גישה, צריך לפנות לאדמין ב-Google Workspace. |
המאמרים הבאים
- כדי לספק ממשק משתמש לשאילתות על נתוני Gmail, יוצרים אפליקציה ומקשרים אותה למאגר הנתונים של Gmail.
- במאמר ניהול פעולות מוסבר איך לנהל את רשימת הפעולות.
- כדי להפעיל התראות למאגר הנתונים, אפשר לעיין במאמר הגדרת התראות למאגרי נתונים של צד שלישי.
- כדי לראות תצוגה מקדימה של תוצאות החיפוש אחרי הגדרת האפליקציה, אפשר לעיין במאמר קבלת תוצאות חיפוש.