ניהול רישיונות Standard ו-Enterprise של Gemini Code Assist

כדי להשתמש ב-Gemini Code Assist Standard וב-Gemini Code Assist Enterprise, כל משתמש בארגון שלכם צריך רישיון.

כברירת מחדל, הקצאת רישיונות אוטומטית מופעלת לכל המינויים. למשתמשים בארגון שלכם עם ההרשאות הנדרשות מוקצה רישיון באופן אוטומטי כשהם מתחילים להשתמש ב-Gemini Code Assist בסביבת פיתוח משולבת (IDE) נתמכת. ההרשאות האלה מפורטות בהמשך המסמך. אחרי שמגדירים את Gemini ל Google Cloud מוצרים ספציפיים, אפשר להקצות רישיונות באופן ידני או להמשיך עם הקצאה אוטומטית.

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

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

  • כדי שתוכלו לתת הרשאות נוספות שנדרשות בחשבון לחיוב למשימות ספציפיות של ניהול רישיונות שמפורטות בקטעים הבאים, אתם צריכים לוודא שיש לכם את תפקידי ה-IAM הבאים: אדמין של חשבון לחיוב (roles/billing.admin) או אדמין של הזמנות לרכישת מוצרים לצרכנים (roles/consumerprocurement.orderAdmin).

  • מוודאים שהגדרתם את Gemini Code Assist.

  • אם רוצים לנהל רישיונות באמצעות API ולא באמצעות Google Cloud המסוף, צריך לוודא את הדברים הבאים:

שינוי מספר הרישיונות ל-Gemini Code Assist Standard ול-Gemini Enterprise במינוי

אתם יכולים להוסיף או להסיר את מספר הרישיונות ל-Gemini for Google Cloud ישירות דרך מסוף Google Cloud הניהול, או דרך הנציג שלכם בחשבון Google או מפיץ מורשה.

כדי לשנות את מספר הרישיונות במינוי:

  1. מוודאים שיש לכם את ההרשאות הבאות לניהול זהויות והרשאות גישה (IAM) בחשבון לחיוב שאליו משויך המינוי:

    • billing.accounts.get
    • consumerprocurement.orders.get
    • consumerprocurement.orders.modify
    • resourcemanager.projects.get

  2. נכנסים לדף Admin for Gemini במסוף Google Cloud .

    אל Gemini ל- Google Cloud

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

  4. מזינים את מספר הרישיונות שרוצים שיהיו. מוצג המידע הבא:

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

  5. לוחצים על שמירה.

איך רואים את הקצאות הרישיונות ל-Gemini Code Assist Standard ול-Gemini Code Assist Enterprise

בוחרים באחת מהאפשרויות הבאות:

המסוף

  1. צריך לוודא שיש לכם את הרשאות ה-IAM הבאות בחשבון לחיוב שאליו משויך המינוי:

    • billing.accounts.get
    • consumerprocurement.orders.get
    • consumerprocurement.licensePools.get
    • consumerprocurement.licensePools.enumerateLicensedUsers
    • resourcemanager.projects.get

  2. עוברים לדף Admin for Gemini ובוחרים את הפרויקט שמצורף לחשבון לחיוב עם מינוי ל-Gemini Code Assist Standard או ל-Enterprise.

    אל Gemini ל- Google Cloud

  3. בוחרים את המינוי שרוצים לשנות ואז לוחצים על שינוי המינוי.

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

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

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

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

API

כדי לראות את הקצאות הרישיונות ל-Gemini Code Assist Standard או Enterprise, משתמשים בשיטה billingAccounts.orders.licensePool.enumerateLicensedUsers.

  1. מוודאים שיש לכם את הרשאת ה-IAM‏ consumerprocurement.licensePools.enumerateLicensedUsers בחשבון לחיוב שמכיל את מאגר הרישיונות שאתם רוצים לראות את הקצאות הרישיונות שלו.

  2. משתמשים ב-cURL כדי לקרוא לשיטה:

    curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:enumerateLicensedUsers/"

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

    • ‫PROJECT_ID: מזהה הפרויקט. השימוש במכסה והחיובים שמשויכים לבקשת ה-API יחולו על הפרויקט הזה.
    • ‫BILLING_ACCOUNT_ID: המזהה של חשבון החיוב שמשויך למאגר הרישיונות.
    • ‫ORDER_ID: מזהה ההזמנה. אם אתם לא יודעים את מזהה ההזמנה, אתם יכולים לראות את רשימת ההזמנות שמשויכות לחשבון לחיוב.

אם הפקודה מסתיימת בלי שגיאות, היא מחזירה פלט licensedUsers בפורמט הבא:

{
  "licensedUsers": [
      {
          "username": "dana@example.com",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "lee@example.com",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "taylor@example.com",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "bola@example.com",
          "assignTime": "2024-09-26T16:24:14.610828Z"
      }
  ]
}

אם לא הוקצו רישיונות ל-Gemini Code Assist Standard או Enterprise, או אם הרישיון ORDER_ID לא תקף, הפלט licensedUsers יוחזר בפורמט הבא:

{}

הקצאה אוטומטית של רישיונות ל-Gemini Code Assist Standard ול-Gemini Code Assist Enterprise

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

הקצאת רישיונות אוטומטית נתמכת רק ב-VS Code, ב-IntelliJ ובסביבות פיתוח משולבות (IDE) נתמכות אחרות של JetBrains.

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

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

    אל Gemini ל- Google Cloud

  2. בוחרים באפשרות Manage Gemini Code Assist (ניהול Gemini Code Assist) ואז באפשרות Manage Subscription (ניהול המינוי).

  3. בוחרים באפשרות ניהול רישיונות ואז באפשרות הפעלת הקצאת רישיונות אוטומטית. מופיעה תיבת הדו-שיח Enable automatic licenses (הפעלת רישיונות אוטומטיים).

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

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

    אם הגדרתם T ימים של חוסר פעילות לביטול ההקצאה, הרישיונות יבוטלו באופן אוטומטי ויהיו זמינים במאגר הרישיונות ביום T+1. לדוגמה, אם הגדרתם 7 ימים של חוסר פעילות לביטול ההקצאה, הרישיונות יבוטלו ויהיו זמינים במאגר הרישיונות ביום 8.

  5. לוחצים על סגירה.

  6. חשוב לוודא שהענקתם למשתמשים את התפקידים ב-IAM‏ Gemini for Google Cloud User ו-Service Usage Consumer.

    משתמשים עם ההרשאה cloudaicompanion.licenses.selfAssign מקבלים רישיון באופן אוטומטי כשהם ניגשים לראשונה ל-Gemini Code Assist Standard או Enterprise בפרויקט שמשולם על ידי חשבון לחיוב עם מינוי בתוקף שמוגדר להקצאת רישיונות אוטומטית, ויש בו רישיונות זמינים שכלולים במינויים שלכם בחשבון לחיוב.

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

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

    אל Gemini ל- Google Cloud

  2. בוחרים באפשרות ניהול Gemini Code Assist ואז באפשרות ניהול המינוי.

  3. בוחרים באפשרות ניהול רישיונות ואז באפשרות ניהול הקצאת רישיונות אוטומטית. מופיעה תיבת הדו-שיח ניהול הקצאת רישיונות אוטומטית.

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

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

הקצאה ידנית של רישיונות ל-Gemini Code Assist Standard ול-Gemini Code Assist Enterprise למשתמשים פרטיים

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

בוחרים באחת מהאפשרויות הבאות:

המסוף

  1. צריך לוודא שיש לכם את הרשאות ה-IAM הבאות בחשבון לחיוב שאליו משויך המינוי:

    • billing.accounts.get
    • consumerprocurement.orders.get
    • consumerprocurement.licensePools.get
    • consumerprocurement.licensePools.enumerateLicensedUsers
    • consumerprocurement.licensePools.assign
    • resourcemanager.projects.get

  2. עוברים לדף האדמין של Gemini.

    אל Gemini ל- Google Cloud

  3. בוחרים באפשרות ניהול Gemini Code Assist ואז באפשרות שינוי המינוי.

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

  5. בוחרים באפשרות הוספת משתמש עם רישיון. מופיעה תיבת דו-שיח לבחירת משתמש. המערכת תומכת רק בכתובות אימייל של חשבונות Google פרטיים, כמו @gmail.com,‏ @googlegroups.com ודומיינים של Google Workspace. אין תמיכה באיחוד שירותי אימות הזהות של כוח העבודה (BYOID).

  6. בוחרים באפשרות הוספת משתמש עם רישיון.

  7. מוודאים שהענקתם למשתמשים שיש להם רישיון את התפקידים Gemini for Google Cloud User ו-שימוש בשירות Consumer ב-IAM.

API

כדי להקצות רישיונות ל-Gemini Code Assist Standard ו-Gemini Code Assist Enterprise, צריך להשתמש בשיטה billingAccounts.orders.licensePool.assign.

  1. צריך לוודא שיש לכם את הרשאות ה-IAM הבאות בחשבון לחיוב שמכיל את מאגר הרישיונות שאתם רוצים להקצות:
  • billing.accounts.get
  • consumerprocurement.licensePools.assign
  • consumerprocurement.licensePools.get
  • consumerprocurement.licensePools.unassign
  • consumerprocurement.orders.get

  1. יוצרים קובץ JSON שמכיל את הפרטים הבאים:

    {
  "usernames": [
    USER_EMAILS
  ]
}

    מחליפים את USER_EMAILS ברשימה של חשבונות משתמשים שמוקצה להם הרישיון, מופרדים בפסיקים. לדוגמה, "dana@example.com", "lee@example.com". המערכת תומכת רק בכתובות אימייל של חשבונות Google פרטיים, כמו @gmail.com, @googlegroups.com ודומיינים של Google Workspace. אין תמיכה באיחוד שירותי אימות הזהות של כוח העבודה (BYOID).

  2. משתמשים ב-cURL כדי לקרוא לשיטה:

    curl -X POST --data-binary @JSON_FILE_NAME \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/"

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

    • ‫JSON_FILE_NAME: הנתיב לקובץ JSON שיצרתם בשלב 2.
    • ‫PROJECT_ID: מזהה הפרויקט. השימוש במכסה והחיובים שמשויכים לבקשת ה-API יחולו על הפרויקט הזה.
    • ‫BILLING_ACCOUNT_ID: המזהה של חשבון החיוב שמשויך למאגר הרישיונות.
    • ‫ORDER_ID: מזהה ההזמנה. אם אתם לא יודעים את מזהה ההזמנה, אתם יכולים לראות את רשימת ההזמנות שמשויכות לחשבון לחיוב.

אם הפעולה מצליחה, התשובה תהיה דומה לדוגמה הבאה:

{}

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

לאחר מכן, מוודאים שהקציתם למשתמשים את תפקידי ה-IAM של Gemini for Google Cloud User ו-Service Usage Consumer.

ביטול הקצאה ידני של רישיונות ל-Gemini Code Assist Standard ו-Enterprise

בוחרים באחת מהאפשרויות הבאות:

המסוף

  1. צריך לוודא שיש לכם את הרשאות ה-IAM הבאות בחשבון לחיוב שאליו משויך המינוי:

    • billing.accounts.get
    • consumerprocurement.orders.get
    • consumerprocurement.licensePools.get
    • consumerprocurement.licensePools.enumerateLicensedUsers
    • consumerprocurement.licensePools.unassign
    • resourcemanager.projects.get

  2. עוברים לדף האדמין של Gemini.

    אל Gemini ל- Google Cloud

  3. בוחרים באפשרות ניהול Gemini Code Assist ואז באפשרות ניהול המינוי.

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

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

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

API

כדי לבטל הקצאה של רישיונות ל-Gemini Code Assist Standard ו-Enterprise, משתמשים בשיטה billingAccounts.orders.licensePool.unassign.

  1. כדי לבצע את המשימה הזו, אתם צריכים את ההרשאה consumerprocurement.licensePools.unassign לניהול זהויות והרשאות גישה (IAM) בחשבון לחיוב שמכיל את מאגר הרישיונות שאתם רוצים לבטל את ההקצאה של הרישיון שלו.

  2. יוצרים קובץ JSON שמכיל את הפרטים הבאים:

    {
  "usernames": [
    USER_EMAILS
  ]
}

    מחליפים את USER_EMAILS ברשימה של חשבונות משתמשים שמוקצה להם הרישיון, כשהחשבונות מופרדים בפסיקים. לדוגמה: "dana@example.com", "lee@example.com".

  3. משתמשים ב-cURL כדי לקרוא לשיטה:

    curl -X POST --data-binary @JSON_FILE_NAME \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:unassign/"

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

    • ‫JSON_FILE_NAME: הנתיב לקובץ JSON שיצרתם בשלב 2.
    • ‫PROJECT_ID: מזהה הפרויקט. השימוש במכסה והחיובים שמשויכים לבקשת ה-API יחולו על הפרויקט הזה.
    • ‫BILLING_ACCOUNT_ID: המזהה של חשבון החיוב שמשויך למאגר הרישיונות.
    • ‫ORDER_ID: מזהה ההזמנה. אם אתם לא יודעים את מזהה ההזמנה, אתם יכולים לראות את רשימת ההזמנות שמשויכות לחשבון לחיוב.

אם הפעולה מצליחה, התשובה תהיה דומה לדוגמה הבאה:

{}

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

העברת רישיונות ל-Gemini Code Assist Standard ו-Enterprise

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

מניעת שימוש ברישיונות בין ארגונים

רישיונות ל-Gemini Code Assist Standard ול-Gemini Enterprise מוקצים למשתמשים ספציפיים, ולא לארגונים או לפרויקטים. כך משתמשים ספציפיים יכולים להשתמש ב-Gemini Code Assist Standard וב-Gemini Enterprise בכמה ארגונים.

יומנים שנוצרו משימוש ב-Gemini Code Assist נמצאים בפרויקט שבו נוצר השימוש, ולא אצל בעל הרישיון. בנוסף, כל התאמה אישית או הגדרה של Gemini Code Assist (למשל התאמה אישית של קוד) מתבצעת ברמת הפרויקט, ולא ברמת הרישיון או המינוי.

כדי למנוע שימוש ב-Gemini Code Assist Standard ו-Enterprise בפרויקט על ידי משתמשים מארגונים שונים, אפשר לבצע אחת מהפעולות הבאות:

  • משביתים את Gemini for Google Cloud API בפרויקט.
  • משתמשים בהרשאות כדי לשלול את הגישה של המשתמש לפרויקט.

מגבלות

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