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

وحدة التحكّم

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

   • 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": "[email protected]",           "assignTime": "2024-09-26T16:24:40.559222Z"       },       {           "username": "[email protected]",           "assignTime": "2024-09-26T16:24:40.559222Z"       },       {           "username": "[email protected]",           "assignTime": "2024-09-26T16:24:40.559222Z"       },       {           "username": "[email protected]",           "assignTime": "2024-09-26T16:24:14.610828Z"       }   ] } 

في حال عدم توفّر تراخيص Gemini Code Assist Standard أو Enterprise أو إذا كان ORDER_ID غير صالح، سيعرض الناتج licensedUsers بالتنسيق التالي:

{} 

وحدة التحكّم

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. انقر على منح التراخيص. يظهر مربّع حوار لاختيار المستخدم. للبحث عن مستخدمين محدّدين، أدخِل عنوان بريدهم الإلكتروني، ثم انقر على التالي.

6. انقر على منح التراخيص.

7. تأكَّد من منح أدوار IAM الخاصة بمستخدمي Gemini في Google Cloud ومستهلكي استخدام الخدمات للمستخدمين الحاصلين على ترخيص.

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

لتعيين تراخيص 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

2. أنشئ ملف JSON يحتوي على المعلومات التالية:

    {   "usernames": [     USER_EMAILS   ] } 

   استبدِل USER_EMAILS بقائمة مفصولة بفواصل لحسابات المستخدمين التي يتم تعيين الترخيص لها، مثل "[email protected]", "[email protected]".

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:assign/"

   غيِّر القيم في السلسلة على الشكل التالي:

   • استبدِل JSON_FILE_NAME بمسار ملف JSON الذي أنشأته في الخطوة 2.
   • ‫PROJECT_ID: رقم تعريف المشروع يتم تطبيق استخدام الحصة والرسوم المرتبطة بطلب واجهة برمجة التطبيقات على هذا المشروع.
   • ‫BILLING_ACCOUNT_ID: رقم تعريف حساب الفوترة المرتبط بمجموعة التراخيص
   • ‫ORDER_ID: معرّف الطلب إذا لم يكن لديك معرّف الطلب، يمكنك استرداده من خلال إدراج الطلبات المرتبطة بحساب الفوترة.

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

{} 

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

بعد ذلك، تأكَّد من منح أدوار IAM الخاصة بـ "مستخدم Gemini في Google Cloud" و"مستهلك استخدام الخدمة" للمستخدمين الحاصلين على ترخيص.

وحدة التحكّم

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

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

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

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

2. أنشئ ملف JSON يحتوي على المعلومات التالية:

    {   "usernames": [     USER_EMAILS   ] } 

   استبدِل USER_EMAILS بقائمة مفصولة بفواصل لحسابات المستخدمين الذين تم تعيين الترخيص لهم، مثل "[email protected]", "[email protected]".

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

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

{} 

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