קניית מינויים והקצאת רישיונות ל-Gemini Enterprise

בדף הזה מוסבר איך לרכוש מינויים ל-Gemini Enterprise ואיך לנהל את רישיונות המשתמשים.

הגדרת הגישה כוללת בדרך כלל את השלבים הבאים:

  1. רכישה: רכישת מינוי למהדורת מוצר בחשבון לחיוב.
  2. הפצה: הקצאת רישיונות מהמינוי לפרויקטים ולמיקומים ספציפיים.
  3. הקצאה: מקצים את הרישיונות שהופצו למשתמשים ספציפיים.

מידע על רישיונות

כדי להיכנס לאפליקציית Gemini Enterprise, למשתמש צריך להיות רישיון. אפשר להקצות רישיונות למשתמשים באופן ידני או אוטומטי.

  • רישיונות שהוקצו ידנית: אתם יכולים להוסיף משתמשים לפי כתובות האימייל שלהם.

  • רישיונות שמוקצים אוטומטית: אתם יכולים להגדיר מינוי כך ש-Gemini Enterprise יקצה אוטומטית רישיון למשתמש בפעם הראשונה שהוא ניגש לממשק של Gemini Enterprise או של Gemini Notebook Enterprise.

מידע על מינויים

כדי לקבל רישיונות, קודם צריך מינוי למהדורת Gemini Enterprise. המינויים הם ספציפיים לחשבון לחיוב. השוואה בין המהדורות של Gemini Enterprise

ב-Gemini Enterprise, אתם יכולים לקנות מינוי חודשי או מינוי שנתי. אפשר להגדיר שהמינויים האלה יתחדשו באופן אוטומטי.

אתם יכולים לרכוש מינויים למהדורות Gemini Enterprise Standard,‏ Gemini Enterprise Plus ו-Gemini Enterprise Pay-as-you-go באמצעותGoogle Cloud מסוף Admin.

מגבלות על מספר המושבים במינוי

כשרוכשים או משנים מינוי מבוסס-מושבים ישירות דרך מסוףGoogle Cloud , חלות מגבלות אוטומטיות על כמות המושבים בהתאם לסוג החשבון לחיוב ב-Cloud:

  • חשבונות לחיוב בניהול עצמי (אונליין) וחשבונות לחיוב של מפיצים: אפשר לנהל מינויים באמצעות מסוף Google Cloud , עד 25 מושבים לכל חשבון.
  • חשבונות לחיוב שמחויבים בחשבונית (אופליין): עד 1,000 מושבים לכל חשבון.

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

מידע על מצבי המינוי

מינוי יכול להיות באחד מהמצבים הבאים:

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

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

לפני שמתחילים את התהליכים שבדף הזה, צריך לוודא שאתם עומדים בדרישות המוקדמות הבאות:

  • משלימים את כל המשימות שמפורטות במאמר הגדרת Gemini Enterprise. למשל:

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

  • מוודאים שהחיוב מופעל בפרויקט ב- Google Cloud . איך מוודאים שהחיוב מופעל בפרויקט ב- Google Cloud ?

  • מוודאים שיש לכם את התפקידים וההרשאות הנדרשים ב-IAM:

    • התפקיד אדמין ב-Gemini Enterprise.

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

      לחלופין, כדי לקבל שליטה מפורטת ב-IAM, אתם יכולים להשתמש בתפקיד בהתאמה אישית עם ההרשאות הבאות במקום בתפקיד Billing Account Administrator:

      שירות הרשאות
      Discovery Engine discoveryengine.billingAccountLicenseConfigs.distribute
      discoveryengine.billingAccountLicenseConfigs.get
      discoveryengine.billingAccountLicenseConfigs.list
      discoveryengine.billingAccountLicenseConfigs.retract
      discoveryengine.licenseConfigs.create
      discoveryengine.licenseConfigs.get
      discoveryengine.licenseConfigs.list
      discoveryengine.licenseConfigs.update
      discoveryengine.projects.get
      discoveryengine.projects.provision
      discoveryengine.projects.reportConsentChange
      discoveryengine.userStores.batchUpdateUserLicenses
      discoveryengine.userStores.listUserLicenses
      רכש צרכני consumerprocurement.orders.get
      consumerprocurement.licensePools.assign
      consumerprocurement.licensePools.unassign
      consumerprocurement.licensePools.enumerateLicensedUsers
      מנהל המשאבים resourcemanager.projects.get
      resourcemanager.projects.list
      שימוש בשירות serviceusage.services.get
      serviceusage.services.list

לרכישת מינוי

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

‫Standard ו-Plus

כדי להירשם למהדורת Gemini Enterprise Standard או Plus:

  1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .

    Gemini Enterprise

  2. לוחצים על ניהול מינויים > יצירת מינוי.

  3. במהדורת Gemini Enterprise Standard או Gemini Enterprise Plus, לוחצים על הרשמה.

  4. מגדירים את פרטי החיוב:

    1. בוחרים את החשבון לחיוב מהתפריט הנפתח.
    2. מזינים שם למינוי.
    3. מזינים את מספר הרישיונות שצריך למהדורה.

  5. בוחרים את תקופת המינוי.

  6. אם רוצים שהמינוי יתחדש אוטומטית, בוחרים באפשרות חידוש אוטומטי של המינוי.

  7. מגדירים את Distribution details:

    1. בתפריט הנפתח Select a project, בוחרים את הפרויקט.
    2. בוחרים Location type למינוי. אם אין סיבות של תאימות או רגולציה שמחייבות אתכם למקם את הנתונים שלכם במספר אזורים בארה"ב או באיחוד האירופי, Google ממליצה לבחור את המיקום global כדי ליהנות מזמינות מקסימלית ומזמן אחזור קצר.

  8. לוחצים על יצירה > אישור.

Pay-as-you-go

במינוי בתשלום לפי שימוש, אתם משלמים מדי חודש על מה שאתם צורכים. מידע נוסף על מכסות ותמחור במהדורת תשלום לפי שימוש אתם יכולים להשתמש במינוי בכל פרויקט שמקושר לחשבון לחיוב.

כדי להירשם למהדורת Gemini Enterprise בתשלום לפי שימוש:

  1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .

    Gemini Enterprise

  2. לוחצים על ניהול מינויים > יצירת מינוי.

  3. במהדורת Gemini Enterprise בתשלום לפי שימוש, לוחצים על הרשמה.

  4. מגדירים את פרטי החיוב:

    1. מזינים שם למינוי.
    2. מזינים את מספר הרישיונות שצריך למהדורה.

  5. מגדירים את Distribution details:

    1. בתפריט הנפתח Select a project, בוחרים את הפרויקט.
    2. בוחרים Location type למינוי. אם אין סיבות של תאימות או רגולציה שמחייבות אתכם למקם את הנתונים שלכם במספר אזורים בארה"ב או באיחוד האירופי, Google ממליצה לבחור את המיקום global כדי ליהנות מזמינות מקסימלית ומזמן אחזור קצר.

  6. לוחצים על יצירה > אישור.

ניהול מינויים

בקטע הזה מוסבר איך להציג, לעדכן, להפיץ ולהחזיר מינויים ל-Gemini Enterprise.

הצגה של פרטי המינוי

כדי לראות את פרטי המינויים ל-Gemini Enterprise:

המסוף

  1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .

    Gemini Enterprise

  2. לוחצים על ניהול המינויים.

  3. בוחרים את החשבון לחיוב מהתפריט הנפתח.

  4. בטבלה מינויים ל-Gemini, לוחצים על שם המינוי.

REST

כדי לקבל את פרטי המינוי, מריצים את הפקודה הבאה:

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  "https://discoveryengine.googleapis.com/v1alpha/billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs"

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_NUMBER: מספר הפרויקט או המזהה שלו שמשמשים לשיוך החיוב והמכסה לקריאה הזו ל-API. אתם צריכים את התפקיד Service Usage Consumer בפרויקט הזה.

  • ‫BILLING_ACCOUNT_ID: המזהה של Google Cloud החשבון לחיוב.

פלט לדוגמה

{
  "billingAccountLicenseConfigs": [{
    "name": "billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs/BILLING_ACCOUNT_LICENSE_CONFIG_ID",
    "licenseCount": "2",
    "licenseConfigDistributions": {"projects/PROJECT_NUMBER/locations/global/licenseConfigs/LICENSE_CONFIG_ID": "1"
    },
    "subscriptionName": "subscriptions/SUBSCRIPTION_NAME",
    "subscriptionTier": "SUBSCRIPTION_TIER",
    "subscriptionTerm": "SUBSCRIPTION_TERM",
    "startDate": ...,
    "endDate": ...,
    "state": "ACTIVE",
    "procurementEntitlementId": "...",
    "subscriptionDisplayName": "...",
    "geminiBundle": true
  }]
}

עדכון הגדרות המינוי

אחרי שיוצרים מינוי, אפשר לעדכן את ההגדרות שלו, כמו מספר הרישיונות או הגדרת החידוש האוטומטי.

השיטה להוספת רישיונות תלויה באופן שבו רכשתם את המינוי במקור:

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

כדי לעדכן את מספר הרישיונות אם רכשתם דרך מסוףGoogle Cloud :

  1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .

    Gemini Enterprise

  2. לוחצים על ניהול המינויים.

  3. בטבלה Gemini Subscriptions, לוחצים על המינוי שרוצים לעדכן.

  4. לוחצים על עריכה לצד פרטי המינוי.

  5. לעדכן את מספר הרישיונות או להפעיל או להשבית את החידוש האוטומטי.

  6. לוחצים על שליחה.

ביטול המינוי

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

כדי לבטל את המינוי:

  1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .

    Gemini Enterprise

  2. לוחצים על ניהול המינויים.

  3. בטבלה Gemini Subscriptions, לוחצים על שם המינוי כדי לפתוח את דף פרטי המינוי.

  4. לוחצים על Edit.

  5. בחלונית Edit subscription, מבטלים את הסימון בתיבה Auto renew subscription.

  6. לוחצים על שליחה.

הפצת רישיונות

אם לא הקציתם את הרישיונות של המינוי לפרויקט, למשל אם רכשתם את המינוי אופליין או אם הקצאת הרישיונות נכשלה בעבר, בצעו את הפעולות הבאות:

המסוף

  1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .

    Gemini Enterprise

  2. לוחצים על ניהול המינויים.

  3. בוחרים את החשבון לחיוב מהתפריט הנפתח.

  4. בטבלה מינויים ל-Gemini, לוחצים על שם המינוי.

  5. בחלק העליון של הדף, לוחצים על הפצת רישיון. מופיעה רשימה של הקצאות הרישיונות הקיימות ונתונים סטטיסטיים של המושבים שנותרו ושל סך כל המושבים.

  6. כדי להקצות רישיונות לפרויקט:

    1. לוחצים על בורר הפרויקטים כדי לבחור פרויקט. הבורר תומך בהשלמה אוטומטית.
    2. הערה: אם לא הפעלתם את Discovery Engine API בפרויקט שבחרתם, תופיע תיבת דו-שיח שבה תתבקשו להפעיל אותו.
    3. בוחרים מיקום.
    4. מזינים את מספר הרישיונות שרוצים להקצות.
    5. אם רוצים להקצות רישיונות לכמה פרויקטים או מיקומים, חוזרים על השלבים האלה.

  7. לוחצים על שליחה.

  8. בתיבת הדו-שיח לאישור, בודקים את סיכום השינויים ולוחצים על אישור.

REST

כדי להפיץ רישיונות לפרויקט אחד או לכמה פרויקטים, מריצים את הפקודה הבאה:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  -d '{
    "projectNumber": "TARGET_PROJECT_NUMBER",
    "location": "LOCATION",
    "licenseCount": LICENSE_COUNT,
    "licenseConfigId": "LICENSE_CONFIG_ID"
  }' \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs/BILLING_ACCOUNT_LICENSE_CONFIG_ID:distributeLicenseConfig"

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_NUMBER: מספר הפרויקט או המזהה שלו שמשמשים לשיוך החיוב והמכסה לקריאה הזו ל-API. אתם צריכים את התפקיד Service Usage Consumer בפרויקט הזה. אפשר להשתמש ב-TARGET_PROJECT_NUMBER אם Discovery Engine מופעל בפרויקט הזה.

  • ‫ENDPOINT_LOCATION: האזור המרובה לבקשת ה-API. מציינים אחד מהערכים הבאים:

    • ‫us לאזור הגיאוגרפי שכולל מספר אזורים בארה"ב
    • ‫eu למספר אזורים באיחוד האירופי
    • ‫global למיקום הגלובלי
    מידע נוסף זמין במאמר הגדרת מספר אזורים למאגר הנתונים.

  • ‫LOCATION: האזור של מאגר הנתונים: global,‏ us או eu.

  • ‫TARGET_PROJECT_NUMBER: מספר הפרויקט שרוצים להפיץ אליו רישיונות.

  • ‫LICENSE_COUNT: מספר הרישיונות להפצה.

  • ‫BILLING_ACCOUNT_ID: המזהה של Google Cloud החשבון לחיוב.

  • ‫BILLING_ACCOUNT_LICENSE_CONFIG_ID: מאתרים את מזהה הגדרת הרישיון של החשבון לחיוב בפרטי המינוי.

  • Optional LICENSE_CONFIG_ID: המזהה של הגדרת רישיון קיימת ברמת הפרויקט. המזהה הזה מופיע בשדה licenseConfigDistributions כשמציגים את פרטי המינוי.

החזרת רישיונות שלא הוקצו במינוי

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

המסוף

  1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .

    Gemini Enterprise

  2. לוחצים על ניהול המינויים.

  3. בוחרים את החשבון לחיוב מהתפריט הנפתח.

  4. בטבלה מינויים ל-Gemini, לוחצים על שם המינוי.

  5. בחלק העליון של הדף, לוחצים על הפצת רישיון (הכפתור הזה פותח את טופס הניהול של כל ההקצאות).

  6. ברשימת ההקצאות, מאתרים את השורה של הפרויקט והמיקום שמהם רוצים להחזיר רישיונות.

  7. בוחרים אחת מהפעולות הבאות:

    • כדי להקטין את מספר הרישיונות: מקטינים את המספר בשדה להזנת קלט של הרישיונות.
    • כדי להחזיר רישיונות באופן מלא: מעבירים את הסמן מעל השורה כדי לחשוף את לחצן המחיקה, ואז לוחצים על מחיקה.

  8. לוחצים על שליחה.

  9. בתיבת הדו-שיח לאישור, בודקים את סיכום השינויים (שבה יופיעו כל הרישיונות שהוחזרו) ולוחצים על אישור.

REST

כדי להעביר רישיונות של מינויים בחזרה לחשבון לחיוב לצורך הפצה מחדש, מריצים את הפקודה הבאה:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  -d '{
    "licenseConfig": "projects/TARGET_PROJECT_NUMBER/locations/LOCATION/licenseConfigs/LICENSE_CONFIG_ID",
    "licenseCount": LICENSE_COUNT
  }' \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs/BILLING_ACCOUNT_LICENSE_CONFIG_ID:retractLicenseConfig"

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_NUMBER: מספר הפרויקט או המזהה שלו שמשמשים לשיוך החיוב והמכסה לקריאה הזו ל-API. אתם צריכים את התפקיד Service Usage Consumer בפרויקט הזה. אפשר להשתמש ב-TARGET_PROJECT_NUMBER אם Discovery Engine מופעל בפרויקט הזה.

  • ‫ENDPOINT_LOCATION: האזור המרובה לבקשת ה-API. מציינים אחד מהערכים הבאים:

    • ‫us לאזור הגיאוגרפי שכולל מספר אזורים בארה"ב
    • ‫eu למספר אזורים באיחוד האירופי
    • ‫global למיקום הגלובלי
    מידע נוסף זמין במאמר הגדרת מספר אזורים למאגר הנתונים.

  • ‫LOCATION: האזור של מאגר הנתונים: global,‏ us או eu.

  • ‫TARGET_PROJECT_NUMBER: מספר הפרויקט שממנו רוצים להחזיר רישיונות. זה הפרויקט שבו הרישיונות מוקצים כרגע.

  • ‫LICENSE_COUNT: מספר הרישיונות שרוצים להחזיר.

  • ‫BILLING_ACCOUNT_ID: המזהה של Google Cloud החשבון לחיוב.

  • ‫BILLING_ACCOUNT_LICENSE_CONFIG_ID: מאתרים את מזהה הגדרת הרישיון של החשבון לחיוב בפרטי המינוי.

  • ‫LICENSE_CONFIG_ID: מזהה הגדרת הרישיון של הגדרת רישיון קיימת ברמת הפרויקט.

טיפול בסיום מוקדם של המינוי

כשעוברים בין סוגי מינויים שונים או אם יש בעיה בחשבון לחיוב, יכול להיות שהמינוי יסתיים מוקדם מהמתוכנן.

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

כדי לוודא שהמשתמשים ימשיכו לקבל גישה, צריך להעביר את הרישיונות שלהם למינוי חדש ופעיל, באופן אוטומטי או באופן ידני.

בתמונה הבאה מוצגת דוגמה להשבתת רישיון במסוףGoogle Cloud :

דוגמה להשבתת רישיון במסוף Google Cloud

באפשרותך לנהל את רישיונות המשתמשים

בקטע הזה מוסבר איך להציג רישיונות, לייצא נתוני משתמשים ולהקצות, להעביר ולהסיר רישיונות של משתמשים ספציפיים.

הצגת רישיונות

כדי לראות את הרישיונות ואת המשתמשים שהוקצו להם:

  1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .

    Gemini Enterprise

  2. לוחצים על ניהול משתמשים.

  3. בוחרים את האפשרות מספר אזורים של הרישיון הקיים.

ייצוא נתוני משתמשים

טבלת המשתמשים במסוף Google Cloud לא תומכת במיון או בסינון. אם אתם צריכים למיין, לסנן או לנתח את נתוני המשתמשים, אתם יכולים לייצא עד מיליון רשומות של משתמשים לקובץ CSV (ערכים מופרדים בפסיקים).

קובץ ה-CSV שמייצאים כולל את העמודות הבאות.

שם העמודה תיאור
user_principal כתובת האימייל של המשתמש.
license_config שם המשאב המלא של המינוי שהוקצה למשתמש (לדוגמה, projects/PROJECT_NUMBER/locations/LOCATION/licenseConfigs/LICENSE_CONFIG_ID). מזהה הגדרת הרישיון תואם למהדורת Gemini Enterprise (לדוגמה, Standard או Plus) שהוקצתה למשתמש. Google Cloud
assignment_time חותמת הזמן (לפי שעון UTC) שבה אדמין הקצה את הרישיון.
last_login_time חותמת הזמן (ב-UTC) שבה המשתמש נכנס לחשבון בפעם האחרונה.
license_assignment_state מצב הקצאת הרישיון. אלה הערכים הזמינים:
  • ‫ASSIGNED: למשתמש הוקצה רישיון.
  • NO_LICENSE: למשתמש אין רישיון כי אדמין לא הקצה לו רישיון או הסיר רישיון קיים.
  • BLOCKED: מדיניות או אדמין חוסמים את המשתמש מלקבל רישיון.

כדי לייצא נתוני משתמשים לקובץ CSV:

  1. במסוף Google Cloud , נכנסים לדף Gemini Enterprise > Manage users.

    ניהול משתמשים

  2. בוחרים את האפשרות מספר אזורים של הרישיון הקיים.

  3. בקטע משתמשים, לוחצים על ייצוא כל המשתמשים.

    בהתאם לגודל של טבלת המשתמשים, תהליך הייצוא יכול להימשך עד 2.5 דקות. בזמן הזה, במסוף מוצג מצב טעינה. בסיום הייצוא, הדפדפן מוריד את קובץ ה-CSV למיקום ברירת המחדל להורדות.

פתרון בעיות בייצוא

בטבלה הבאה מפורטות בעיות נפוצות בייצוא נתוני משתמשים והפתרונות שלהן.

שגיאה רזולוציה
הלחצן ייצוא כל המשתמשים מוסתר צריך לוודא שיש משתמשים שהוקצו להם רישיונות במספר האזורים שנבחרו. אם אין משתמשים שהוקצו, הלחצן ייצוא כל המשתמשים לא מופיע.
בקשת הייצוא נכשלת ומופיעה שגיאה של חריגה מהמגבלה אם רשימת המשתמשים חורגת ממגבלת הייצוא של מיליון משתמשים, בקשת הייצוא נדחית במסוף Google Cloud ומוצגת הודעת שגיאה על חריגה מהמגבלה.
בקשת הייצוא נכשלת ומוצגת הודעת שגיאה על דחיית הרשאה מוודאים שלחשבון שלכם יש את התפקיד אדמין ב-Gemini Enterprise, שכולל את ההרשאה הנדרשת discoveryengine.userStores.listUserLicenses.

הקצה רישיונות למשתמשים

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

הוספת משתמשים והקצאת רישיונות באופן אוטומטי

כדי להקצות רישיונות למשתמשים באופן אוטומטי כשהם נכנסים לאפליקציית Gemini Enterprise:

  1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .

    Gemini Enterprise

  2. לוחצים על ניהול משתמשים.

  3. בוחרים את האפשרות מספר אזורים של הרישיון הקיים.

  4. בוחרים באפשרות הקצאת רישיונות באופן אוטומטי ואז בוחרים את המינוי.

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

    מידע נוסף על מינויים זמין בקטע מידע על מינויים.

הוספת משתמשים והקצאת רישיונות באופן ידני

כדי לתת למשתמשים ספציפיים גישה ל-Gemini Enterprise, אתם יכולים להקצות להם רישיונות באופן ידני ממינוי פעיל.

המסוף

כדי להקצות רישיונות למשתמשים באופן ידני:

  1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .

    Gemini Enterprise

  2. לוחצים על ניהול משתמשים.

  3. בוחרים את האפשרות מספר אזורים של הרישיון הקיים.

  4. לוחצים על הוספת משתמשים.

  5. בדף הוספת משתמשים:

    1. מזינים את כתובות האימייל של המשתמשים. חשוב להשתמש באותה כתובת אימייל שבה הם ישתמשו כדי להיכנס לאפליקציית Gemini Enterprise.

    2. בוחרים את המינוי שרוצים להקצות למשתמשים האלה.

    3. לוחצים על שליחה.

REST

כדי להקצות רישיונות למשתמשים באופן ידני, מריצים את הפקודה הבאה:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/userStores/default_user_store:batchUpdateUserLicenses" \
  -d '{
   "inlineSource":{
      "userLicenses":[
         {
            "userPrincipal":"USER_EMAIL_1",
            "licenseConfig":"projects/PROJECT_NUMBER/locations/LOCATION/licenseConfigs/SUBSCRIPTION_ID"
         },
         {
            "userPrincipal":"USER_EMAIL_2",
            "licenseConfig":"projects/PROJECT_NUMBER/locations/LOCATION/licenseConfigs/SUBSCRIPTION_ID"
         }
      ],
      "updateMask": "userPrincipal,licenseConfig"
   },
   "deleteUnassignedUserLicenses":false
  }'

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫ENDPOINT_LOCATION: האזור המרובה לבקשת ה-API. מציינים אחד מהערכים הבאים:
    • ‫us לאזור הגיאוגרפי שכולל מספר אזורים בארה"ב
    • ‫eu למספר אזורים באיחוד האירופי
    • ‫global למיקום הגלובלי
    מידע נוסף זמין במאמר הגדרת מספר אזורים למאגר הנתונים.
  • ‫LOCATION: האזור הגיאוגרפי של מאגר הנתונים: global, ‏ us או eu
  • ‫USER_EMAIL: כתובת האימייל של המשתמש שרוצים להוסיף לרישיון.
  • ‫PROJECT_NUMBER: מספר הפרויקט ב- Google Cloud .
  • ‫SUBSCRIPTION_ID: המזהה של המינוי ל-Gemini Enterprise.

העברת רישיונות ממינויים שפג תוקפם

המשתמשים לא יכולים להיכנס ל-Gemini Enterprise אם המינוי פג. יש כמה דרכים להחזיר להם את גישת הכניסה:

העברה אוטומטית של משתמשים למינוי פעיל

כדי להעביר משתמשים באופן אוטומטי למינוי פעיל:

  1. במסוף Google Cloud , נכנסים לדף Gemini Enterprise > Manage users.

    רישיון ל-Gemini Enterprise

  2. בוחרים את האפשרות מספר אזורים של הרישיון הקיים.

  3. מוודאים שיש לכם מינוי פעיל. אם אין לכם מינוי, אתם יכולים להירשם למינוי.

  4. בוחרים באפשרות הקצאת רישיונות באופן אוטומטי ובוחרים את המינוי הפעיל.

  5. לוחצים על עדכון אוטומטי של רישיון שפג תוקפו.

    בפעם הבאה שמשתמש עם רישיון שפג תוקפו ייכנס לחשבון, Gemini Enterprise יקצה לו רישיון באופן אוטומטי במינוי שנבחר.

העברה ידנית של משתמשים למינוי פעיל

כדי להעביר משתמשים באופן ידני למינוי פעיל:

  1. במסוף Google Cloud , נכנסים לדף Gemini Enterprise > Manage users.

    רישיון ל-Gemini Enterprise

  2. בוחרים את האפשרות מספר אזורים של הרישיון הקיים.

  3. מוודאים שיש לכם מינוי פעיל. אם אין לכם מינוי, אתם יכולים להירשם למינוי.

  4. בוחרים את המשתמשים ולוחצים על הקצאת רישיון אחר.

  5. בחלונית Edit Users, בוחרים את המינוי ולוחצים על Submit.

הצגת רשימת הרישיונות

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

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/userStores/default_user_store/userLicenses"

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫ENDPOINT_LOCATION: האזור המרובה לבקשת ה-API. מציינים אחד מהערכים הבאים:
    • ‫us לאזור הגיאוגרפי שכולל מספר אזורים בארה"ב
    • ‫eu למספר אזורים באיחוד האירופי
    • ‫global למיקום הגלובלי
    מידע נוסף זמין במאמר הגדרת מספר אזורים למאגר הנתונים.
  • ‫LOCATION: האזור הגיאוגרפי של מאגר הנתונים: global, ‏ us או eu

הסרת משתמשים מרישיון

אתם יכולים להסיר רישיון ממשתמש בכל שלב. כשמסירים רישיון, המשתמש מאבד מיד את הגישה ל-Gemini Enterprise. כדי להסיר משתמשים מרישיון:

המסוף

כדי להסיר משתמשים מרישיון באמצעות מסוף Google Cloud :

  1. במסוף Google Cloud , נכנסים לדף Gemini Enterprise > Manage users.

    רישיון ל-Gemini Enterprise

  2. בוחרים את האפשרות מספר אזורים של הרישיון הקיים.

  3. בטבלת המשתמשים, בוחרים את המשתמשים.

  4. כדי להסיר משתמשים מרישיון, בוחרים באחת מהאפשרויות הבאות:

    • כדי להסיר את הרישיון רק מהמשתמשים שנבחרו, לוחצים על ביטול הקצאת הרישיון.
    • כדי להסיר את הרישיון וגם למחוק את המשתמשים שנבחרו מהפרויקט, לוחצים על ביטול ההקצאה ומחיקת הרישיון.

  5. לוחצים על אישור.

REST

כדי להסיר משתמשים מרישיון, מריצים את הפקודה הבאה:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/userStores/default_user_store:batchUpdateUserLicenses" \
  -d '{
   "inlineSource":{
      "userLicenses":[
         {
            "userPrincipal":"USER_EMAIL_1"
         },
         {
            "userPrincipal":"USER_EMAIL_2"
         }
      ],
      "updateMask": "userPrincipal,licenseConfig"
   },
   "deleteUnassignedUserLicenses":true
  }'

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫ENDPOINT_LOCATION: האזור המרובה לבקשת ה-API. מציינים אחד מהערכים הבאים:
    • ‫us לאזור הגיאוגרפי שכולל מספר אזורים בארה"ב
    • ‫eu למספר אזורים באיחוד האירופי
    • ‫global למיקום הגלובלי
    מידע נוסף זמין במאמר הגדרת מספר אזורים למאגר הנתונים.
  • ‫LOCATION: האזור הגיאוגרפי של מאגר הנתונים: global, ‏ us או eu
  • ‫USER_EMAIL: כתובת האימייל של המשתמש שרוצים להסיר מהרישיון.

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