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

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

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

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

בתוכנית Google Developer Program Premium המשתמשים מקבלים רישיון ל-Gemini Code Assist Standard. אי אפשר להקצות רישיון ל-Gemini Code Assist Standard למשתמש שיש לו מינוי לתוכנית Google למפתחים Premium, כי כבר יש לו רישיון דרך התוכנית הזו.

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

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

• אם רוצים לנהל רישיונות באמצעות API ולא באמצעות Google API Console, צריך לוודא את הדברים הבאים:
  • מגדירים פרויקט מכסת שימוש לחשבון לחיוב.
  • מפעילים את 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 for Google Cloud ישירות דרך API Console, או דרך הנציג שלכם בחשבון Google או דרך מפיץ מורשה.

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

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

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

2. במסוף API, עוברים לדף Admin for Gemini.

   כניסה לדף Gemini for 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 for Google Cloud

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

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

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

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

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

API

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

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

2. משתמשים ב-cURL כדי להפעיל את ה-method:

   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 או Enterprise, או אם הרישיון  לא תקין, הפלט  יוחזר בפורמט הבא:ORDER_IDlicensedUsers

{}

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

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

המסוף

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

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

2. עוברים לדף Admin for Gemini.

   כניסה לדף Gemini for Google Cloud

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

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

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

6. לוחצים על הקצאת רישיונות.

7. חשוב לוודא שהקציתם למשתמשים שיש להם רישיון את התפקידים Gemini for Google Cloud User ו-Service Usage 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

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

   {
     "usernames": [
       USER_EMAILS
     ]
   }
   

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

3. משתמשים ב-cURL כדי להפעיל את ה-method:

   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: מזהה ההזמנה. אם אתם לא יודעים את מזהה ההזמנה, אתם יכולים לראות את רשימת ההזמנות שמשויכות לחשבון לחיוב.

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

{}

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

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

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

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

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

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

1. במסוף API, עוברים לדף Admin for Gemini.

   כניסה לדף Gemini for Google Cloud

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

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

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

4. מגדירים את משך הזמן שבו הרישיון יבוטל אם המשתמש שהוקצה לו לא פעיל, ואז לוחצים על אישור השינוי. מופיעה תיבת הדו-שיח Automatic license assignment has been enabled (הקצאת רישיונות אוטומטית הופעלה).

   אם הגדרתם 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. במסוף API, עוברים לדף Admin for Gemini.

   כניסה לדף Gemini for Google Cloud

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

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
   • consumerprocurement.licensePools.unassign
   • resourcemanager.projects.get

2. עוברים לדף Admin for Gemini.

   כניסה לדף Gemini for Google Cloud

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

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

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

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

API

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

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

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

   {
     "usernames": [
       USER_EMAILS
     ]
   }
   

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

3. משתמשים ב-cURL כדי להפעיל את ה-method:

   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 ול-Gemini Code Assist 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 בפרויקט.
• משתמשים בהרשאות כדי לשלול את הגישה של המשתמש לפרויקט.

מגבלות

• ניהול הרישיונות של Gemini for Google Cloud לא תומך באיחוד שירותי אימות הזהות של כוח העבודה.