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

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

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

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

قبل از اینکه شروع کنی

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

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

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

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

    • billing.accounts.get
    • consumerprocurement.orders.get
    • consumerprocurement.orders.modify
    • resourcemanager.projects.get
  2. در کنسول گوگل کلود، به صفحه ادمین برای جمینی بروید.

    برای دسترسی به فضای ابری گوگل به Gemini بروید

  3. اشتراکی را که می‌خواهید تغییر دهید انتخاب کنید و سپس «اصلاح اشتراک» را انتخاب کنید. توجه داشته باشید که اگر در یک دوره آزمایشی فعال هستید، این دکمه به صورت «غیرفعال کردن تمدید خودکار» نمایش داده می‌شود.

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

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

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

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

کنسول

  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 بروید

  3. اشتراکی را که می‌خواهید تغییر دهید انتخاب کنید و سپس «تغییر اشتراک» را انتخاب کنید.

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

    • نام.
    • ایمیل.
    • تاریخ واگذاری مجوز.
    • تاریخ و زمان آخرین استفاده از مجوز.
  4. برای یافتن مجموعه‌ای خاص از کاربران، می‌توانید لیست را به صورت زیر فیلتر و مرتب کنید:

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

رابط برنامه‌نویسی کاربردی

برای مشاهده‌ی تخصیص‌های لایسنس Gemini Code Assist Standard یا Enterprise، از متد billingAccounts.orders.licensePool.enumerateLicensedUsers استفاده کنید.

  1. تأیید کنید که مجوز IAM مربوط به 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 : شناسه یک پروژه. سهمیه استفاده و هزینه‌های مرتبط با درخواست API برای این پروژه اعمال می‌شود.
    • 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 را با فرمت زیر برمی‌گرداند:

{}

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

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

کنسول

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

    • billing.accounts.get
    • consumerprocurement.orders.get
    • consumerprocurement.licensePools.get
    • consumerprocurement.licensePools.enumerateLicensedUsers
    • consumerprocurement.licensePools.assign
    • resourcemanager.projects.get
  2. به صفحه مدیریت Gemini بروید.

    برای دسترسی به فضای ابری گوگل به Gemini بروید

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

  4. برای این اشتراک Gemini Code Assist Standard یا Enterprise، تأیید کنید که License Assignment را روی Manually Assigning Licenses تنظیم کرده‌اید. اگر اشتراک Gemini Code Assist Standard یا Enterprise روی Automatically Assigning Licenses تنظیم شده باشد، نمی‌توانید مجوزهای تکی را مدیریت کنید. تغییر این حساب صورتحساب به Manually Assigning Licenses ، پس از تغییر، تخصیص خودکار مجوز را غیرفعال می‌کند، اما تخصیص‌های مجوز از قبل موجود تحت تأثیر قرار نمی‌گیرند.

  5. گزینه «افزودن کاربر دارای مجوز» را انتخاب کنید. یک کادر محاوره‌ای انتخاب کاربر نمایش داده می‌شود. فقط آدرس‌های ایمیل حساب گوگل شخصی، مانند @gmail.com ، @googlegroups.com و دامنه‌های Google Workspace پشتیبانی می‌شوند. فدراسیون هویت نیروی کار (BYOID) پشتیبانی نمی‌شود.

  6. افزودن کاربر دارای مجوز را انتخاب کنید.

  7. تأیید کنید که نقش‌های IAM کاربر و مصرف‌کننده‌ی استفاده از سرویس Gemini برای Google Cloud را به کاربران دارای مجوز اعطا می‌کنید .

رابط برنامه‌نویسی کاربردی

برای اختصاص مجوزهای Gemini Code Assist Standard و Enterprise، از متد billingAccounts.orders.licensePool.assign استفاده کنید.

  1. تأیید کنید که مجوزهای IAM زیر را در حساب صورتحسابی که شامل مجموعه مجوزهایی است که قصد واگذاری مجوز به آن را دارید، دارید:
  • 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" . فقط آدرس‌های ایمیل حساب‌های کاربری گوگل، مانند @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 : شناسه یک پروژه. سهمیه استفاده و هزینه‌های مرتبط با درخواست API برای این پروژه اعمال می‌شود.
    • BILLING_ACCOUNT_ID : شناسه حساب پرداخت مرتبط با مجموعه مجوزها.
    • ORDER_ID : شناسه سفارش. اگر شناسه سفارش را نمی‌دانید، می‌توانید با فهرست کردن سفارش‌های مرتبط با حساب صورتحساب خود ، آن را بازیابی کنید.

در صورت موفقیت، پاسخ مشابه زیر است:

{}

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

سپس، تأیید کنید که نقش‌های IAM مربوط به Gemini برای کاربر Google Cloud و مصرف‌کننده‌ی استفاده از سرویس را به کاربران دارای مجوز اعطا می‌کنید .

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

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

تخصیص خودکار مجوز فقط در VS Code، IntelliJ و سایر IDE های پشتیبانی شده JetBrains پشتیبانی می‌شود.

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

  1. در کنسول گوگل کلود، به صفحه ادمین برای جمینی بروید.

    برای دسترسی به فضای ابری گوگل به Gemini بروید

  2. گزینه مدیریت کمک کد جمینی و سپس مدیریت اشتراک را انتخاب کنید.

  3. مدیریت مجوز (License Management ) و سپس فعال کردن تخصیص خودکار مجوز (Enable Automatic License Assignment) را انتخاب کنید. پنجره‌ی فعال کردن مجوزهای خودکار (Enable automatic licenses) ظاهر می‌شود.

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

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

    اگر T روز عدم فعالیت را برای عدم واگذاری پیکربندی کرده باشید، مجوز(ها) به طور خودکار از روز T+1 از حالت واگذاری خارج شده و در مخزن مجوزها در دسترس قرار می‌گیرند. به عنوان مثال، اگر 7 روز عدم فعالیت را برای عدم واگذاری پیکربندی کنید، مجوز(ها) از روز 8 از حالت واگذاری خارج شده و در مخزن مجوزها در دسترس قرار می‌گیرند.

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

  6. مطمئن شوید که نقش‌های IAM مربوط به Gemini برای کاربر Google Cloud و مصرف‌کننده‌ی استفاده از سرویس را به کاربران دارای مجوز اعطا می‌کنید .

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

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

  1. در کنسول گوگل کلود، به صفحه ادمین برای جمینی بروید.

    برای دسترسی به فضای ابری گوگل به Gemini بروید

  2. گزینه مدیریت کمک کد جمینی و سپس مدیریت اشتراک را انتخاب کنید.

  3. مدیریت مجوز (License Management ) و سپس مدیریت تخصیص خودکار مجوز (Manage Automatic License Assignment) را انتخاب کنید. پنجره مدیریت تخصیص خودکار مجوز (Manage automatic license assignment) ظاهر می‌شود.

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

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

لغو دستی مجوزهای Gemini Code Assist Standard و Enterprise

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

کنسول

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

    • billing.accounts.get
    • consumerprocurement.orders.get
    • consumerprocurement.licensePools.get
    • consumerprocurement.licensePools.enumerateLicensedUsers
    • consumerprocurement.licensePools.unassign
    • resourcemanager.projects.get
  2. به صفحه مدیریت Gemini بروید.

    برای دسترسی به فضای ابری گوگل به Gemini بروید

  3. گزینه مدیریت کمک کد جمینی و سپس مدیریت اشتراک را انتخاب کنید.

  4. مدیریت مجوز (License Management ) و سپس مدیریت تخصیص خودکار مجوز (Manage Automatic License Assignment) را انتخاب کنید. پنجره مدیریت تخصیص خودکار مجوز (Manage automatic license assignment) ظاهر می‌شود.

  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 : شناسه یک پروژه. سهمیه استفاده و هزینه‌های مرتبط با درخواست API برای این پروژه اعمال می‌شود.
    • BILLING_ACCOUNT_ID : شناسه حساب پرداخت مرتبط با مجموعه مجوزها.
    • ORDER_ID : شناسه سفارش. اگر شناسه سفارش را نمی‌دانید، می‌توانید با فهرست کردن سفارش‌های مرتبط با حساب صورتحساب خود ، آن را بازیابی کنید.

در صورت موفقیت، پاسخ مشابه زیر است:

{}

برای تأیید عدم واگذاری، فهرست واگذاری‌ها را مشاهده کنید .

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

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

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

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

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

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

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

محدودیت‌ها