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

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

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

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

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

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

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

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

שינוי מספר הרישיונות ל-Gemini Code Assist Standard ול-Gemini Code Assist 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 או ל-Gemini Code Assist 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 או ל-Gemini Code Assist Enterprise, או אם הרישיון ORDER_ID לא תקין, הפלט licensedUsers יוחזר בפורמט הבא:

{}

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

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

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

אם בחרתם להקצות רישיונות אוטומטית ל-Gemini Code Assist Standard או 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. חשוב לוודא שהענקתם למשתמשים את התפקידים Gemini for Google Cloud User ו-Service Usage Consumer ב-IAM.

    משתמשים עם ההרשאה cloudaicompanion.licenses.selfAssign מקבלים רישיון באופן אוטומטי כשהם ניגשים לראשונה ל-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. בוחרים באפשרות ניהול רישיונות ואז באפשרות ניהול הקצאת רישיונות אוטומטית. מופיעה תיבת הדו-שיח ניהול הקצאת רישיונות אוטומטית.

  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 ו-Service Usage Consumer ב-IAM.

API

כדי להקצות רישיונות ל-Gemini Code Assist Standard ו-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 ול-Gemini Code Assist 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. בוחרים באפשרות Manage Gemini Code Assist (ניהול Gemini Code Assist) ואז באפשרות Manage Subscription (ניהול המינוי).

  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 ול-Gemini Code Assist Enterprise

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

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

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

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

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

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

מגבלות

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