הגדרת מאגר נתונים של Gmail

בדף הזה מוסבר איך ליצור מאגר מידע ולחבר את Gmail ל-Gemini Enterprise.

לפני שמתחילים

  • נכנסים למסוף Google Cloud באמצעות אותו חשבון שבו משתמשים במופע Google Workspace שמתכננים לחבר. ‫Gemini Enterprise משתמש במזהה הלקוח שלכם ב-Google Workspace כדי להתחבר ל-Gmail.

  • כדי לאכוף את בקרת הגישה למקורות נתונים ולאבטח את הנתונים ב-Gemini Enterprise, צריך לוודא שהגדרתם את ספק הזהויות.

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

יצירת מאגר נתונים של Gmail

כדי ליצור את מאגר הנתונים של Gmail, פועלים לפי השלבים הבאים:

  1. במסוף Google Cloud של Google, עוברים לדף Gemini Enterprise.

    ‫Gemini Enterprise

  2. בוחרים פרויקט קיים או יוצרים פרויקט חדש ב- Google Cloud .

  3. בתפריט הניווט, לוחצים על מאגרי נתונים.

  4. לוחצים על + יצירת מאגר נתונים.

  5. בשדה מקור, מחפשים את Gmail ולוחצים על בחירה.

  6. בקטע פעולות:

    1. מזינים את מזהה הלקוח ואת סוד הלקוח שהתקבלו מאפליקציית OAuth 2.0, ואז לוחצים על אימות הרשאה.

      במאמר יצירת פרטי כניסה של לקוח OAuth מוסבר איך מקבלים את מזהה הלקוח ואת סוד הלקוח. היקפי ההרשאות הנדרשים לחיפוש ולפעולות מפורטים במאמר היקפי הרשאות נדרשים.

    2. אופציונלי: מרחיבים את ההגדרות המתקדמות ומזינים את שם השירות, שהוא שם המשאב של השירות שיצרתם בספריית השירותים. חובה למלא את השדה הזה כשמופעל VPC Service Controls.

    3. בוחרים את הפעולות מהרשימה כדי להפעיל אותן עבור מחבר Gmail.

    במאמר ניהול פעולות מוסבר איך לנהל את רשימת הפעולות.

  7. לוחצים על Continue.

  8. בקטע Configuration (הגדרה):

    1. ברשימה Multi-region, בוחרים את המיקום של מחבר הנתונים.
    2. בשדה Data connector name, מזינים שם למחבר.
    3. אם בחרתם במיקום us או eu, צריך להגדיר את הגדרות ההצפנה:
      • בוחרים באפשרות מפתח הצפנה בניהולGoogle או מפתח Cloud KMS.
      • אם בחרתם באפשרות מפתח Cloud KMS:
        • ברשימה Key management type (סוג ניהול המפתחות), בוחרים את הסוג המתאים.
        • ברשימה Cloud KMS key בוחרים את המפתח.
      מידע נוסף זמין במאמר בנושא מפתחות הצפנה בניהול הלקוח.

  9. לוחצים על Continue.

  10. בקטע Billing, בוחרים באפשרות General pricing או Configurable pricing. מידע נוסף זמין במאמרים אימות סטטוס החיוב של הפרויקטים ורישיונות.

  11. לוחצים על יצירה. ‫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.

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