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

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

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

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

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

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

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

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

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

  • מגדירים פרויקט לחיוב מכסה בחשבון לחיוב.
  • מפעילים את Cloud Commerce Consumer Procurement API בפרויקט שמוגדר כמכסה.
  • מוודאים שצמדי המפתח/ערך הבאים של הכותרת קיימים בכל הקריאות ל-API:
    • ‫Authorization: Google Cloud טוקן הגישה שלכם מ-Google Cloud CLI
    • ‫x-goog-user-project: מזהה הפרויקט של הפרויקט לחיוב מכסות

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

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

איך בודקים את הקצאות הרישיונות ל-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.

   אל Admin for Gemini

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

   המידע הבא זמין לכל משתמש שהוקצה לו רישיון:

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

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

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

API

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

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

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": "[e-mail]",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "[e-mail]",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "[e-mail]",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "[e-mail]",
          "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 .

   אל Admin for Gemini

2. לוחצים על Manage Gemini Code Assist ואז על Manage Subscription.

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

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

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

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

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

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

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

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

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

   אל Admin for Gemini

2. לוחצים על Manage 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. עוברים לדף Admin for Gemini.

   אל Admin for Gemini

3. לוחצים על Manage Gemini Code Assist ואז על Modify Subscription.

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

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

6. לוחצים על הוספת משתמש עם רישיון.

7. מוודאים שנתתם למשתמשים עם הרישיון את התפקידים Gemini ל-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 ברשימה מופרדת בפסיקים של חשבונות המשתמשים שמוקצה להם הרישיון, לדוגמה "[e-mail]", "[e-mail]". אפשר להשתמש רק בכתובות אימייל של חשבונות 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 ל-Google Cloud" ו-"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. עוברים לדף Admin for Gemini.

   אל Admin for Gemini

3. לוחצים על Manage Gemini Code Assist ואז על Manage Subscription.

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

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

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

API

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

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

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

   {
     "usernames": [
       USER_EMAILS
     ]
   }
   

   מחליפים את USER_EMAILS ברשימה מופרדת בפסיקים של חשבונות משתמשים שהוקצה להם הרישיון, לדוגמה "[e-mail]", "[e-mail]".

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 ו-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 Code Assist Standard וב-Gemini Code Assist Enterprise בפרויקט בארגונים שונים, אתם יכולים:

• השבתת Gemini for Google Cloud API בפרויקט
• להשתמש בכללי מדיניות הדחייה של ניהול זהויות והרשאות גישה (IAM) כדי לדחות את הגישה של משתמשים ספציפיים לפרויקט.

מגבלות

• בניהול הרישיונות של Gemini Code Assist אי אפשר להשתמש באיחוד שירותי אימות הזהות של כוח העבודה.