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

قبل استخدام ميزة "مساعدة ترميز Gemini"، يحتاج كل مستخدم في مؤسستك إلى ترخيص.

تتطلّب الاشتراكات الجديدة تلقائيًا منك منح التراخيص يدويًا. بعد إعداد منتجات معيّنة من Gemini لـ Google Cloud، يمكنك بعد ذلك اختيار منح التراخيص يدويًا أو تلقائيًا.

قبل البدء

• تأكَّد من أنّ لديك دور "مشرف حساب الفوترة" (roles/billing.admin) أو دور "مشرف طلبات المشتريات من المستهلكين" (roles/consumerprocurement.orderAdmin) في إدارة الهوية وإمكانية الوصول (IAM) حتى تتمكّن من منح أذونات إضافية مطلوبة على حساب الفوترة لمهام إدارة تراخيص محدّدة موضّحة في الأقسام التالية.

• إذا كنت تريد إدارة التراخيص باستخدام واجهة برمجة تطبيقات بدلاً من وحدة تحكّم Google Cloud، عليك التأكّد مما يلي:
  • إعداد مشروع حصة لحساب الفوترة
  • فعِّل Cloud Commerce Consumer Procurement API في مشروع الحصة.
  • تأكَّد من توفّر أزواج المفتاح/القيمة التالية للعنوان في جميع طلبات البيانات من واجهة برمجة التطبيقات:
    • Authorization: معرّف رمز الوصول إلى Google Cloud من Google Cloud CLI
    • x-goog-user-project: رقم تعريف مشروع الحصة

تغيير عدد تراخيص Gemini Code Assist في اشتراك

يمكنك إضافة أو إزالة عدد تراخيص Gemini for Google Cloud مباشرةً من خلال وحدة تحكّم Google Cloud، أو من خلال ممثل حسابك على Google أو مورّد مفوَّض.

لتغيير عدد التراخيص في اشتراك، اتّبِع الخطوات التالية:

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

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

2. في وحدة تحكّم Google Cloud، انتقِل إلى صفحة مشرف Gemini.

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

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

4. أدخِل عدد التراخيص التي تريد الحصول عليها. يتم عرض المعلومات التالية:

   • إجمالي عدد التراخيص بعد الشراء
   • عدد التراخيص المتاحة للتخصيص بعد الشراء
   • سعر الاشتراك الجديد لكل مدة يتم تقسيم المبلغ الإضافي مقابل التراخيص المُضافة على أساس المدة المتبقية من المدة الراهنة.

5. انقروا على حفظ.

عرض عمليات منح تراخيص Gemini Code Assist

اختر أحد الخيارات التالية:

وحدة التحكّم واجهة برمجة التطبيقات

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

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

2. انتقِل إلى صفحة مشرف Gemini.

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

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

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

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

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

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

للاطّلاع على عمليات تخصيص تراخيص Gemini Code Assist، استخدِم billingAccounts.orders.licensePool.enumerateLicensedUsers.

لتنفيذ هذه المهمة، يجب أن يكون لديك إذن consumerprocurement.licensePools.enumerateLicensedUsers في حساب الفوترة الذي يملك الاشتراك.

GET https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:enumerateLicensedUsers/

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

• 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 أو كانORDER_ID غير صالح، يتم عرض الإخراجlicensedUsers التالي بالصيغة التالية:

{}

منح تراخيص Gemini Code Assist يدويًا لمستخدمين فرديين

اختر أحد الخيارات التالية:

وحدة التحكّم واجهة برمجة التطبيقات

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 هذا، تأكَّد من ضبط تعيين الترخيص على تعيين التراخيص يدويًا. إذا تم ضبط اشتراك Gemini Code Assist على تعيين التراخيص تلقائيًا، لا يمكنك إدارة التراخيص الفردية. يؤدي تبديل حساب الفوترة هذا إلى منح التراخيص يدويًا إلى إيقاف منح التراخيص تلقائيًا بعد التغيير، ولكن لا تتأثر عمليات منح التراخيص السابقة.

5. اختَر تخصيص التراخيص. سيظهر مربّع حوار اختيار المستخدم. للبحث عن مستخدمين محدّدين، أدخِل عنوان بريدهم الإلكتروني ثم انقر على التالي.

6. اختَر تخصيص التراخيص.

7. تأكَّد من منح أدوار "إدارة الهوية وإمكانية الوصول" لمستخدمي Gemini for Google Cloud و"مستخدِمي استخدام الخدمة" للمستخدمين المرخَّص لهم.

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

لتنفيذ هذه المهمة، تأكَّد من أنّ لديك الأذونات التالية في حساب الفوترة الذي يملك الاشتراك:

• billing.accounts.get
• consumerprocurement.licensePools.assign
• consumerprocurement.licensePools.get
• consumerprocurement.licensePools.unassign
• consumerprocurement.orders.get

POST https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/

{
  "usernames": [
            "[e-mail]",
            "[e-mail]"
  ]
}

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

• BILLING_ACCOUNT_ID: رقم تعريف حساب الفوترة
• ORDER_ID: سياسة إدارة الهوية وإمكانية الوصول

إذا كان الأمر ناجحًا، سيعرض نص استجابة فارغًا بالشكل التالي:

{}

للتحقّق من المهمة، اطّلِع على قائمة المهام.

بعد ذلك، تأكَّد من منح أدوار إدارة الهوية وإمكانية الوصول (IAM) لمستخدمي Gemini for Google Cloud ومستخدِمي "استخدام الخدمة" للمستخدمين المرخَّصين.

منح تراخيص Gemini Code Assist تلقائيًا

يمكنك منح ترخيص تلقائيًا لأي مستخدم في مؤسستك يحتاج إلى الوصول إلى Gemini Code Assist من صفحة منح الترخيص. يتم ضبط عملية منح التراخيص تلقائيًا بشكلٍ فردي لكل اشتراك.

إذا اخترت تعيين التراخيص تلقائيًا للخدمة Gemini Code Assist، لا يمكنك إزالة تراخيص المستخدمين الفرديين أو إضافتها ضمن هذا الحساب. بالنسبة إلى المستخدمين الذين تم إسناد تراخيص لهم ولم يستخدموا أيًا من ميزات Gemini Code Assist، يتم إيقاف إمكانية استخدامهم للميزات تلقائيًا في نهاية مدة الفوترة بعد عدد محدّد من أيام عدم النشاط على النحو الذي يحدّده المشرف.

1. في وحدة تحكّم Google Cloud، انتقِل إلى صفحة مشرف Gemini.

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

2. انقر على إدارة Gemini Code Assist، ثم على إدارة الاشتراك.

3. اختَر إدارة التراخيص، ثمّ اختَر تفعيل تعيين التراخيص تلقائيًا. يظهر مربّع الحوار تفعيل التراخيص التلقائية.

   يؤدي تبديل هذا الاشتراك لتخصيص التراخيص تلقائيًا إلى إيقاف تخصيص التراخيص يدويًا بعد التغيير، ولكن لن تتأثر عمليات تخصيص التراخيص السابقة.

4. اضبط المدة التي سيتم خلالها إلغاء تعيين ترخيص إذا كان المستخدم المُسنَد إليه الترخيص غير نشط، ثم انقر على تأكيد التغيير. يظهر مربّع الحوار تم فعالة منح التراخيص تلقائيًا.

5. انقر على إغلاق.

6. تأكَّد من منح أدوار إدارة الهوية وإمكانية الوصول (IAM) لمستخدمي Gemini for Google Cloud ومستخدِمي "استخدام الخدمة" للمستخدمين المرخَّص لهم.

   يتلقّى المستخدمون الذين لديهم الإذنcloudaicompanion.licenses.selfAssign ترخيصًا تلقائيًا عند وصولهم لأول مرة إلى Gemini Code Assist في مشروع يتم الدفع له من خلال حساب فوترة لديه اشتراك صالح تم ضبطه لمنح الترخيص تلقائيًا ويحتوي على تراخيص متاحة تشملها اشتراكاتك في حساب الفوترة.

لإيقاف منح الترخيص التلقائي، اتّبِع الخطوات التالية:

1. في وحدة تحكّم Google Cloud، انتقِل إلى صفحة مشرف Gemini.

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

2. انقر على إدارة Gemini Code Assist، ثم على إدارة الاشتراك.

3. انقر على إدارة التراخيص، ثم على إدارة منح التراخيص تلقائيًا . يظهر مربّع الحوار إدارة تعيين التراخيص تلقائيًا.

4. اختَر إيقاف إدارة الترخيص التلقائية.

5. انقر على تأكيد التغيير.

إلغاء منح تراخيص Gemini Code Assist يدويًا

اختر أحد الخيارات التالية:

وحدة التحكّم واجهة برمجة التطبيقات

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، استخدِم billingAccounts.orders.licensePool.unassign الطريقة.

لتنفيذ هذه المهمة، يجب أن يكون لديك إذن consumerprocurement.licensePools.unassign في حساب الفوترة الذي يملك الاشتراك.

POST https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:unassign/

{
  "usernames": [
            "[e-mail]",
            "[e-mail]"
  ]
}

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

• BILLING_ACCOUNT_ID: رقم تعريف حساب الفوترة
• ORDER_ID: سياسة إدارة الهوية وإمكانية الوصول

إذا كان الأمر ناجحًا، سيعرض نص استجابة فارغًا بالشكل التالي:

{}

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

نقل تراخيص Gemini Code Assist

لا يمكن نقل تراخيص Gemini Code Assist مباشرةً بين المستخدِمين. بدلاً من ذلك، يمكنك إلغاء تعيين الترخيص من مستخدم ثم منح ترخيص للمستخدم الجديد.

منع استخدام الترخيص في مؤسسات متعددة

يتم منح تراخيص Gemini Code Assist للمستخدمين الفرديين، وليس للمؤسسات أو المشاريع، ما يتيح للمستخدمين الفرديين استخدام Gemini Code Assist في مؤسسات متعددة.

إنّ أي استخدام للسجلّات التي تم إنشاؤها من ميزة "مساعدة ترميز Gemini" يكون مرتبطًا بالمشروع الذي حدث فيه الاستخدام، وليس بالمستخدِم المرخّص. بالإضافة إلى ذلك، يتم إجراء أي تخصيص أو ضبط لميزة Gemini Code Assist (مثل تخصيص الرموز البرمجية) على مستوى المشروع، وليس على مستوى الترخيص أو الاشتراك.

لمنع استخدام ميزة "مساعدة ترميز Gemini" في مشروع على مستوى المؤسسات، يمكنك تنفيذ أحد الإجراءات التالية:

• أوقِف واجهة برمجة التطبيقات Gemini for Google Cloud في المشروع.
• استخدام الأذونات لرفض وصول المستخدم إلى المشروع

القيود

• لا تتوافق أداة إدارة تراخيص Google Cloud من Gemini مع Workforce Identity Federation.