مجوزهای Gemini Code Assist را مدیریت کنید

قبل از استفاده از Gemini Code Assist، هر کاربر در سازمان شما نیاز به مجوز دارد.

به طور پیش‌فرض، اشتراک‌های جدید از شما می‌خواهند که مجوزها را به صورت دستی اختصاص دهید. پس از راه‌اندازی Gemini خاص برای محصولات Google Cloud، سپس می‌توانید انتخاب کنید که مجوزها را به صورت دستی یا خودکار اختصاص دهید.

قبل از شروع

  • مطمئن شوید که نقش‌های IAM مدیر حساب صورت‌حساب ( roles/billing.admin ) یا مدیر سفارش تدارکات مصرف‌کننده ( roles/consumerprocurement.orderAdmin ) را دارید تا بتوانید مجوزهای اضافی مورد نیاز در حساب صورت‌حساب را برای وظایف مدیریت مجوز خاص که در بخش‌های زیر شرح داده شده است، اعطا کنید.
  • اگر می‌خواهید مجوزها را با استفاده از API به جای کنسول Google Cloud مدیریت کنید، از موارد زیر اطمینان حاصل کنید:

تعداد مجوزهای Gemini Code Assist را در یک اشتراک تغییر دهید

می‌توانید تعداد مجوزهای Gemini برای Google Cloud را مستقیماً از طریق کنسول Google Cloud یا از طریق نماینده حساب Google خود یا یک فروشنده مجاز اضافه یا حذف کنید.

برای تغییر تعداد مجوزها در یک اشتراک، مراحل زیر را دنبال کنید:

  1. مطمئن شوید که مجوزهای مدیریت هویت و دسترسی زیر را در حساب صورت‌حساب مالک اشتراک دارید:

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

  2. در کنسول Google Cloud، به صفحه Admin for Gemini بروید.

    برای Google Cloud به Gemini بروید

  3. اشتراکی را که می خواهید تغییر دهید انتخاب کنید و سپس اصلاح اشتراک را انتخاب کنید.

  4. تعداد مجوزهایی که می خواهید داشته باشید را وارد کنید. اطلاعات زیر نمایش داده می شود:

    • تعداد کل مجوزها پس از خرید.
    • تعداد مجوزهای موجود برای واگذاری پس از خرید.
    • قیمت اشتراک جدید در هر ترم. مبلغ اضافی برای مجوزهای اضافه شده بر اساس مدت زمان باقی مانده در دوره فعلی تقسیم می شود.

  5. ذخیره را انتخاب کنید.

مشاهده تکالیف مجوز کد Gemini Assist

یکی از گزینه های زیر را انتخاب کنید:

کنسول API

  1. مطمئن شوید که مجوزهای IAM زیر را در حساب صورت‌حساب مالک اشتراک دارید:

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

  2. به صفحه Admin for Gemini بروید.

    برای Google Cloud به Gemini بروید

  3. اشتراکی را که می خواهید تغییر دهید انتخاب کنید و سپس اصلاح اشتراک را انتخاب کنید.

    اطلاعات زیر برای هر کاربری که مجوز تخصیص یافته است موجود است:

    • نام.
    • ایمیل.
    • تاریخ واگذاری مجوز
    • تاریخ و ساعت آخرین استفاده از مجوز.

  4. برای پیدا کردن یک مجموعه خاص از کاربران، می توانید لیست را به صورت زیر فیلتر و مرتب کنید:

    • برای فیلتر کردن لیست، در قسمت Filter ، ویژگی ها و مقادیر را وارد کنید.
    • برای مرتب‌سازی فهرست، عنوان ستونی را که می‌خواهید بر اساس آن مرتب کنید، انتخاب کنید. به عنوان مثال، برای مرتب کردن بر اساس حروف الفبا بر اساس نام کاربری، عنوان ستون Name را انتخاب کنید.

برای مشاهده تکالیف مجوز 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 : خط مشی IAM

در صورت موفقیت آمیز بودن دستور، خروجی 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 وجود نداشته باشد یا ORDER_ID نامعتبر باشد، خروجی licensedUsers را در قالب زیر برمی‌گرداند:

{}

مجوزهای Gemini Code Assist را به صورت دستی به کاربران اختصاص دهید

یکی از گزینه های زیر را انتخاب کنید:

کنسول API

  1. اطمینان حاصل کنید که مجوزهای IAM زیر را در حساب صورت‌حساب مالک اشتراک دارید:

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

  2. به صفحه Admin for Gemini بروید.

    برای Google Cloud به Gemini بروید

  3. Manage Gemini Code Assist را انتخاب کنید و سپس Modify Subscription را انتخاب کنید.

  4. برای این اشتراک Gemini Code Assist، اطمینان حاصل کنید که تخصیص مجوز را روی انتساب دستی مجوزها تنظیم کرده‌اید. اگر اشتراک Gemini Code Assist روی Automatically Assign Licenses تنظیم شده باشد، نمی توانید مجوزهای فردی را مدیریت کنید. تغییر این حساب صورت‌حساب به واگذاری دستی مجوزها، تخصیص خودکار مجوز را پس از تغییر خاموش می‌کند، اما تخصیص مجوزهای قبلی تحت تأثیر قرار نمی‌گیرد.

  5. Assign Licenses را انتخاب کنید. یک گفتگوی انتخاب کاربر ظاهر می شود. برای جستجوی کاربران خاص، آدرس ایمیل آنها را وارد کرده و سپس Next را انتخاب کنید.

  6. Assign Licenses را انتخاب کنید.

  7. اطمینان حاصل کنید که نقش‌های Gemini for Google Cloud User and Service Usage Consumer IAM را به کاربران به کاربران دارای مجوز اختصاص می‌دهید .

برای اختصاص مجوزهای 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": [
            "dana@example.com",
            "lee@example.com"
  ]
}

موارد زیر را جایگزین کنید:

  • BILLING_ACCOUNT_ID : شناسه حساب صورت‌حساب
  • ORDER_ID : خط مشی IAM

در صورت موفقیت آمیز بودن دستور، یک بدنه پاسخ خالی را در قالب زیر برمی گرداند:

{}

برای تأیید تکلیف، فهرست تکالیف را مشاهده کنید .

سپس، مطمئن شوید که نقش‌های Gemini for Google Cloud User و Service Usage Consumer IAM را به کاربران به کاربران دارای مجوز اعطا می‌کنید .

به طور خودکار مجوزهای Gemini Code Assist را اختصاص دهید

می‌توانید به‌طور خودکار مجوزی را به هر کاربری در سازمانتان که نیاز به دسترسی به Gemini Code Assist از صفحه واگذاری مجوز دارد اختصاص دهید. تخصیص خودکار مجوز به صورت جداگانه برای هر اشتراک تنظیم می شود.

اگر انتخاب کنید به طور خودکار مجوزها را برای Gemini Code Assist اختصاص دهید، نمی‌توانید مجوزهای کاربر فردی را تحت آن حساب حذف یا اضافه کنید. کاربرانی که دارای مجوز هستند و از هیچ‌یک از ویژگی‌های Gemini Code Assist استفاده نکرده‌اند، در پایان دوره صورت‌حساب، پس از تعداد معینی از روزهای عدم فعالیت که توسط سرپرست تنظیم شده است، به‌طور خودکار از دسترسی خارج می‌شوند.

  1. در کنسول Google Cloud، به صفحه Admin for Gemini بروید.

    برای Google Cloud به Gemini بروید

  2. Manage Gemini Code Assist و سپس Manage Subscription را انتخاب کنید.

  3. مدیریت مجوز را انتخاب کنید و سپس Enable Automatic License Assignment را انتخاب کنید. گفتگوی Enable Automatic Licenses ظاهر می شود.

    تغییر این اشتراک برای اختصاص خودکار مجوزها، واگذاری مجوز دستی پس از تغییر را غیرفعال می‌کند، اما تخصیص مجوزهای قبلی تحت تأثیر قرار نمی‌گیرد.

  4. مدت زمانی را برای لغو اختصاص مجوز در صورت غیرفعال بودن گیرنده تعیین کنید، سپس تأیید تغییر را انتخاب کنید. گفتگوی تخصیص خودکار مجوز فعال شده است ظاهر می شود.

  5. بستن را انتخاب کنید.

  6. اطمینان حاصل کنید که نقش‌های Gemini for Google Cloud User and Service Usage Consumer IAM را به کاربران به کاربران دارای مجوز اختصاص می‌دهید .

    کاربرانی که دارای مجوز cloudaicompanion.licenses.selfAssign هستند، هنگامی که برای اولین بار به Gemini Code Assist در پروژه‌ای که توسط حساب صورت‌حساب پرداخت می‌شود و دارای اشتراک معتبری است که برای تخصیص خودکار مجوز پیکربندی شده است و دارای مجوزهای موجود تحت پوشش اشتراک‌های شما در حساب صورت‌حساب است، به‌طور خودکار مجوز دریافت می‌کنند.

برای غیرفعال کردن تخصیص خودکار مجوز، مراحل زیر را دنبال کنید:

  1. در کنسول Google Cloud، به صفحه Admin for Gemini بروید.

    برای Google Cloud به Gemini بروید

  2. Manage Gemini Code Assist و سپس Manage Subscription را انتخاب کنید.

  3. مدیریت مجوز را انتخاب کنید و سپس Manage Automatic License Assignment را انتخاب کنید. کادر گفتگوی مدیریت تخصیص مجوز خودکار ظاهر می شود.

  4. غیرفعال کردن مدیریت مجوز خودکار را انتخاب کنید.

  5. تأیید تغییر را انتخاب کنید.

مجوزهای Gemini Code Assist را به صورت دستی لغو اختصاص دهید

یکی از گزینه های زیر را انتخاب کنید:

کنسول API

  1. مطمئن شوید که مجوزهای IAM زیر را در حساب صورت‌حساب مالک اشتراک دارید:

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

  2. به صفحه Admin for Gemini بروید.

    برای Google Cloud به Gemini بروید

  3. Manage Gemini Code Assist و سپس Manage Subscription را انتخاب کنید.

  4. مدیریت مجوز را انتخاب کنید و سپس Manage Automatic License Assignment را انتخاب کنید. کادر گفتگوی مدیریت تخصیص مجوز خودکار ظاهر می شود.

  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": [
            "dana@example.com",
            "lee@example.com"
  ]
}

موارد زیر را جایگزین کنید:

  • BILLING_ACCOUNT_ID : شناسه حساب صورت‌حساب
  • ORDER_ID : خط مشی IAM

در صورت موفقیت آمیز بودن دستور، یک بدنه پاسخ خالی را در قالب زیر برمی گرداند:

{}

برای تأیید عدم تخصیص، فهرست تکالیف را مشاهده کنید .

مجوزهای Gemini Code Assist را انتقال دهید

مجوزهای Gemini Code Assist را نمی توان مستقیماً بین کاربران منتقل کرد. در عوض، مجوز را از یک کاربر لغو و سپس یک مجوز را به کاربر جدید اختصاص دهید .

جلوگیری از استفاده از مجوز بین سازمانی

مجوزهای Gemini Code Assist به کاربران فردی اختصاص داده می‌شود، نه سازمان‌ها یا پروژه‌ها، و به کاربران اجازه می‌دهد از Gemini Code Assist در چندین سازمان استفاده کنند.

هر گزارشی که از استفاده Gemini Code Assist ایجاد می‌شود، با پروژه‌ای که استفاده در آن رخ داده است، قرار می‌گیرد و نه با صاحب مجوز. علاوه بر این، هرگونه سفارشی‌سازی یا پیکربندی Gemini Code Assist (مانند سفارشی‌سازی کد ) در پروژه انجام می‌شود، نه در سطح مجوز یا اشتراک.

برای جلوگیری بیشتر از استفاده بین سازمانی از Gemini Code Assist در یک پروژه، می توانید یکی از موارد زیر را انجام دهید:

  • Gemini for Google Cloud API را در پروژه غیرفعال کنید.
  • از مجوزها برای ممانعت از دسترسی کاربر به پروژه استفاده کنید.

محدودیت ها