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

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

כדי להגדיר גישה, בדרך כלל מבצעים את השלבים הבאים:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

      משאב שירות הרשאות
      חשבון לחיוב ב-Cloud חיוב ב-Cloud billing.billingAccountPrices.list
      חשבון לחיוב ב-Cloud רכש צרכני consumerprocurement.orders.get
      consumerprocurement.orders.place
      consumerprocurement.licensePools.assign
      consumerprocurement.licensePools.unassign
      consumerprocurement.licensePools.enumerateLicensedUsers
      חשבון לחיוב ב-Cloud Discovery Engine discoveryengine.billingAccountLicenseConfigs.distribute
      discoveryengine.billingAccountLicenseConfigs.get
      discoveryengine.billingAccountLicenseConfigs.list
      discoveryengine.billingAccountLicenseConfigs.retract
      פרויקט Discovery Engine 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
      פרויקט מנהל המשאבים resourcemanager.projects.get
      resourcemanager.projects.list
      פרויקט שימוש בשירות serviceusage.services.get
      serviceusage.services.list

הרשמה למינוי

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

‫Standard ו-Plus

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

  1. במסוף Google Cloud , נכנסים לדף Gemini Enterprise > Plans & billing.

    מעבר אל "תוכניות וחיוב"

  2. בתפריט הנפתח Selected billing account, בוחרים את החשבון לחיוב.

  3. לוחצים על Create Subscription.

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

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

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

  7. אם רוצים שהמינוי יתחדש אוטומטית, מסמנים את התיבה Auto renew subscription.

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

    1. בשדה Project, מזינים מזהה פרויקט ובוחרים פרויקט מבין האפשרויות התואמות. אם מופיעה בקשה במסוף, מפעילים את ממשקי ה-API הנדרשים.
    2. בוחרים מיקום למינוי. אם אין סיבות של תאימות או רגולציה שמחייבות אתכם למקם את הנתונים שלכם במספר אזורים בארה"ב או באיחוד האירופי, Google ממליצה לבחור את המיקום global כדי ליהנות מזמינות מקסימלית ומזמן אחזור קצר.
  9. לוחצים על יצירה > אישור.

Pay-as-you-go

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

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

  1. במסוף Google Cloud , נכנסים לדף Gemini Enterprise > Plans & billing.

    מעבר אל "תוכניות וחיוב"

  2. בתפריט הנפתח Selected billing account, בוחרים את החשבון לחיוב.

  3. לוחצים על Create Subscription.

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

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

    1. מאשרים או בוחרים את החשבון לחיוב מהתפריט הנפתח.
    2. מזינים Subscription name.
    3. מזינים את מספר הרישיונות בתשלום לפי שימוש שצריך למהדורה.
  6. מגדירים את Distribution details:

    1. בשדה Project, מזינים מזהה פרויקט ובוחרים פרויקט מבין האפשרויות התואמות. אם מופיעה בקשה במסוף, מפעילים את ממשקי ה-API הנדרשים.
    2. בוחרים מיקום למינוי. אם אין סיבות של תאימות או רגולציה שמחייבות אתכם למקם את הנתונים שלכם במספר אזורים בארה"ב או באיחוד האירופי, Google ממליצה לבחור את המיקום global כדי ליהנות מזמינות מקסימלית ומזמן אחזור קצר.
  7. לוחצים על יצירה > אישור.

  8. אם הפרויקט מקושר לחשבון לחיוב ב-Cloud ממשק בניהול עצמי (אונליין), ייפתח החלון Buy credits. בוחרים סכום ואמצעי תשלום, ומשלימים את הרכישה. אם רוצים, מגדירים טעינה אוטומטית.

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

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

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

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

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

המסוף

  1. במסוף Google Cloud , נכנסים לדף Gemini Enterprise > Plans & billing.

    מעבר אל "תוכניות וחיוב"

  2. בתפריט הנפתח Selected billing account, בוחרים את החשבון לחיוב.

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

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. במסוף Google Cloud , נכנסים לדף Gemini Enterprise > Plans & billing.

    מעבר אל "תוכניות וחיוב"

  2. בתפריט הנפתח Selected billing account, בוחרים את החשבון לחיוב.

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

  4. בדף Subscription detail, לוחצים על Edit.

  5. בחלונית Edit Subscription, מזינים ערך חדש בשדה Number of licenses, או מסמנים או מבטלים את הסימון של התיבה Auto renewal.

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

ביטול המינוי

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

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

  1. במסוף Google Cloud , נכנסים לדף Gemini Enterprise > Plans & billing.

    מעבר אל "תוכניות וחיוב"

  2. בתפריט הנפתח Selected billing account, בוחרים את החשבון לחיוב.

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

  4. בדף Subscription detail, לוחצים על Edit.

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

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

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

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

המסוף

  1. במסוף Google Cloud , נכנסים לדף Gemini Enterprise > Plans & billing.

    מעבר אל "תוכניות וחיוב"

  2. בתפריט הנפתח Selected billing account, בוחרים את החשבון לחיוב.

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

  4. בדף פרטי המינוי, לוחצים על הפצת רישיונות.

    נפתחת החלונית Distribute Licenses, שבה מוצגות הקצאות הרישיונות הקיימות לפרויקט, לצד מספר הרישיונות הזמינים (Available licenses) ומספר הרישיונות הכולל (Total licenses).

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

    1. בשדה Select a project, מזינים מזהה פרויקט ובוחרים פרויקט מבין האפשרויות התואמות.
    2. אם מופיעה תיבת דו-שיח שמבקשת להפעיל את Discovery Engine API בפרויקט שנבחר, לוחצים כדי להפעיל אותו.
    3. בתפריט הנפתח Region, בוחרים אזור.
    4. בשדה מספר הרישיונות, מזינים את מספר הרישיונות שרוצים להקצות.
    5. אם רוצים להקצות רישיונות לפרויקטים או לאזורים נוספים, לוחצים על Add license distribution וחוזרים על השלבים.
  6. לוחצים על שליחה.

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

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. במסוף Google Cloud , נכנסים לדף Gemini Enterprise > Plans & billing.

    מעבר אל "תוכניות וחיוב"

  2. בתפריט הנפתח Selected billing account, בוחרים את החשבון לחיוב.

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

  4. בדף פרטי המינוי, לוחצים על הפצת רישיונות.

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

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

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

  8. בתיבת הדו-שיח Confirm License Distribution, קוראים את האזהרה שביטול רישיונות מוגבל לפעם אחת ביום, ולוחצים על Submit.

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 שם המשאב המלא Google Cloud של המינוי שהוקצה למשתמש (לדוגמה, projects/PROJECT_NUMBER/locations/LOCATION/licenseConfigs/LICENSE_CONFIG_ID). מזהה הגדרת הרישיון תואם למהדורת Gemini Enterprise (לדוגמה, Standard או Plus) שאדמין הקצה למשתמש.
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: כתובת האימייל של המשתמש שרוצים להסיר מהרישיון.

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