إدارة تراخيص Gemini Code Assist Standard وEnterprise

وحدة التحكّم

1. تأكَّد من توفّر أذونات "إدارة الهوية وإمكانية الوصول" التالية في حساب الفوترة الذي يملك الاشتراك:

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

2. انتقِل إلى صفحة المشرف في Gemini واختَر المشروع المرتبط بحساب الفوترة الذي يتضمّن اشتراك Gemini Code Assist Standard أو Enterprise.

   الانتقال إلى "Gemini في Google Cloud"

3. اختَر الاشتراك الذي تريد تغييره، ثم انقر على تعديل الاشتراك.

   تتوفّر المعلومات التالية لكل مستخدم تم منح ترخيص له:

   • الاسم
   • البريد الإلكتروني.
   • تاريخ منح الترخيص
   • تاريخ ووقت آخر استخدام للترخيص

4. للعثور على مجموعة معيّنة من المستخدمين، يمكنك فلترة القائمة وترتيبها باتّباع الخطوات التالية:

   • لفلترة القائمة، أدخِل الخصائص والقيم في حقل الفلتر.
   • لترتيب القائمة، اختَر عنوان العمود الذي تريد الترتيب حسبه. على سبيل المثال، للترتيب أبجديًا حسب أسماء المستخدمين، اختَر عنوان العمود الاسم.

واجهة برمجة التطبيقات

لعرض عمليات تعيين تراخيص Gemini Code Assist Standard أو Enterprise، استخدِم طريقة billingAccounts.orders.licensePool.enumerateLicensedUsers.

1. تأكَّد من أنّ لديك إذن 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: رقم تعريف المشروع يتم تطبيق استخدام الحصة والرسوم المرتبطة بطلب واجهة برمجة التطبيقات على هذا المشروع.
   • ‫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 بالتنسيق التالي:

{}

وحدة التحكّم

1. تأكَّد من توفّر أذونات "إدارة الهوية وإمكانية الوصول" التالية في حساب الفوترة الذي يملك الاشتراك:

   • 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) للمستخدمين للمستخدمين الحاصلين على ترخيص.

واجهة برمجة التطبيقات

لتعيين تراخيص Gemini Code Assist Standard وEnterprise، استخدِم طريقة billingAccounts.orders.licensePool.assign.

1. تأكَّد من توفّر أذونات "إدارة الهوية وإمكانية الوصول" التالية في حساب الفوترة الذي يحتوي على مجموعة التراخيص التي تريد تعيينها:

• 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: رقم تعريف المشروع يتم تطبيق استخدام الحصة والرسوم المرتبطة بطلب واجهة برمجة التطبيقات على هذا المشروع.
   • ‫BILLING_ACCOUNT_ID: رقم تعريف حساب الفوترة المرتبط بمجموعة التراخيص
   • ‫ORDER_ID: معرّف الطلب إذا لم يكن لديك معرّف الطلب، يمكنك استرداده من خلال إدراج الطلبات المرتبطة بحساب الفوترة.

في حال نجاح العملية، ستكون الاستجابة مشابهة لما يلي:

{}

للتأكّد من الواجب، اطّلِع على قائمة الواجبات.

بعد ذلك، تأكَّد من منح أدوار Gemini for Google Cloud User وService Usage Consumer IAM للمستخدمين المرخّص لهم.

وحدة التحكّم

1. تأكَّد من توفّر أذونات "إدارة الهوية وإمكانية الوصول" التالية في حساب الفوترة الذي يملك الاشتراك:

   • 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. اختَر تأكيد.

واجهة برمجة التطبيقات

لإلغاء تعيين تراخيص Gemini Code Assist Standard وEnterprise، استخدِم طريقة billingAccounts.orders.licensePool.unassign.

1. لتنفيذ هذه المهمة، يجب أن يكون لديك إذن consumerprocurement.licensePools.unassign Identity and Access Management في حساب الفوترة الذي يحتوي على مجموعة التراخيص التي تريد إلغاء تخصيص الترخيص منها.

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: رقم تعريف المشروع يتم تطبيق استخدام الحصة والرسوم المرتبطة بطلب واجهة برمجة التطبيقات على هذا المشروع.
   • ‫BILLING_ACCOUNT_ID: رقم تعريف حساب الفوترة المرتبط بمجموعة التراخيص
   • ‫ORDER_ID: معرّف الطلب إذا لم يكن لديك معرّف الطلب، يمكنك استرداده من خلال إدراج الطلبات المرتبطة بحساب الفوترة.

في حال نجاح العملية، ستكون الاستجابة مشابهة لما يلي:

{}

للتأكّد من إلغاء التعيين، اطّلِع على قائمة عمليات التعيين.