قبل از استفاده از Gemini Code Assist Standard و Enterprise، هر کاربر در سازمان شما به یک مجوز نیاز دارد.
به طور پیشفرض، اشتراکهای جدید نیاز به اختصاص دستی مجوزها دارند. پس از تنظیم Gemini برای محصولات Google Cloud، میتوانید مجوزها را به صورت دستی یا خودکار اختصاص دهید.
شما میتوانید به هر کاربری که به پروژهای مرتبط با حساب صورتحساب مربوطه دسترسی دارد، مجوز اختصاص دهید. پس از اختصاص مجوز به کاربر، او میتواند از Gemini Code Assist در هر پروژهای استفاده کند.
قبل از اینکه شروع کنی
- مطمئن شوید که نقشهای IAM مدیر حساب صورتحساب ( - roles/billing.admin) یا مدیر سفارش تدارکات مصرفکننده (- roles/consumerprocurement.orderAdmin) را دارید تا بتوانید مجوزهای اضافی مورد نیاز در حساب صورتحساب را برای وظایف خاص مدیریت مجوز که در بخشهای بعدی به تفصیل شرح داده شده است، اعطا کنید.
- تأیید کنید که Gemini Code Assist را راهاندازی کردهاید . 
- اگر میخواهید مجوزها را با استفاده از API به جای کنسول Google Cloud مدیریت کنید، موارد زیر را تأیید کنید: - یک پروژه سهمیهبندی برای حساب صورتحساب خود تنظیم کنید.
- API مربوط به تدارکات مصرفکننده در تجارت ابری را در پروژه سهمیهبندی خود فعال کنید.
-  تأیید کنید که جفتهای کلید-مقدار هدر زیر در تمام فراخوانیهای API وجود دارند:-  Authorization: توکن دسترسی به گوگل کلود شما از رابط خط فرمان گوگل کلود
-  x-goog-user-project: شناسه پروژه سهمیهبندی شما
 
-  
 
تعداد مجوزهای Gemini Code Assist Standard و Enterprise را در یک اشتراک تغییر دهید
شما میتوانید تعداد مجوزهای Gemini برای Google Cloud را مستقیماً از طریق کنسول Google Cloud یا از طریق نماینده حساب Google خود یا یک فروشنده مجاز اضافه یا حذف کنید.
برای تغییر تعداد لایسنسها در یک اشتراک، مراحل زیر را دنبال کنید:
- تأیید کنید که مجوزهای مدیریت هویت و دسترسی زیر را در حساب صورتحسابی که مالک اشتراک است، دارید: -  billing.accounts.get
-  consumerprocurement.orders.get
-  consumerprocurement.orders.modify
-  resourcemanager.projects.get
 
-  
- در کنسول گوگل کلود، به صفحه ادمین برای جمینی بروید. 
- اشتراکی را که میخواهید تغییر دهید انتخاب کنید و سپس «اصلاح اشتراک» را انتخاب کنید. توجه داشته باشید که اگر در یک دوره آزمایشی فعال هستید، این دکمه به صورت «غیرفعال کردن تمدید خودکار» نمایش داده میشود. 
- تعداد مجوزهایی را که میخواهید داشته باشید وارد کنید. اطلاعات زیر نمایش داده میشود: - تعداد کل لایسنسها پس از خرید.
- تعداد مجوزهای موجود برای واگذاری پس از خرید.
- قیمت اشتراک جدید برای هر ترم. مبلغ اضافی برای مجوزهای اضافه شده بر اساس مدت زمان باقی مانده از ترم جاری محاسبه میشود.
 
- ذخیره را انتخاب کنید. 
مشاهده تکالیف مجوز استاندارد و سازمانی Gemini Code Assist
یکی از گزینههای زیر را انتخاب کنید:
کنسول
- تأیید کنید که مجوزهای IAM زیر را در حساب صورتحسابی که مالک اشتراک است، دارید: -  billing.accounts.get
-  consumerprocurement.orders.get
-  consumerprocurement.licensePools.get
-  consumerprocurement.licensePools.enumerateLicensedUsers
-  resourcemanager.projects.get
 
-  
- به صفحه مدیریت Gemini بروید و پروژهای را که با اشتراک Gemini Code Assist Standard یا Enterprise به حساب صورتحساب شما متصل شده است، انتخاب کنید. 
- اشتراکی را که میخواهید تغییر دهید انتخاب کنید و سپس «تغییر اشتراک» را انتخاب کنید. - اطلاعات زیر برای هر کاربری که مجوز به او اختصاص داده شده است، در دسترس است: - نام.
- ایمیل.
- تاریخ واگذاری مجوز.
- تاریخ و زمان آخرین استفاده از مجوز.
 
- برای یافتن مجموعهای خاص از کاربران، میتوانید لیست را به صورت زیر فیلتر و مرتب کنید: - برای فیلتر کردن لیست، در فیلد Filter ، ویژگیها و مقادیر را وارد کنید.
- برای مرتبسازی لیست، عنوان ستونی را که میخواهید بر اساس آن مرتبسازی انجام شود، انتخاب کنید. به عنوان مثال، برای مرتبسازی الفبایی بر اساس نام کاربران، عنوان ستون نام را انتخاب کنید.
 
رابط برنامهنویسی کاربردی
 برای مشاهدهی تخصیصهای لایسنس Gemini Code Assist Standard یا Enterprise، از متد billingAccounts.orders.licensePool.enumerateLicensedUsers استفاده کنید.
- تأیید کنید که مجوز IAM مربوط به - consumerprocurement.licensePools.enumerateLicensedUsersرا روی حساب صورتحسابی که شامل مخزن مجوزی است که میخواهید تخصیصهای مجوز آن را مشاهده کنید، دارید.
- برای فراخوانی متد از - 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 را به صورت دستی به کاربران اختصاص دهید
یکی از گزینههای زیر را انتخاب کنید:
کنسول
- تأیید کنید که مجوزهای IAM زیر را در حساب صورتحسابی که مالک اشتراک است، دارید: -  billing.accounts.get
-  consumerprocurement.orders.get
-  consumerprocurement.licensePools.get
-  consumerprocurement.licensePools.enumerateLicensedUsers
-  consumerprocurement.licensePools.assign
-  resourcemanager.projects.get
 
-  
- به صفحه مدیریت Gemini بروید. 
- گزینه مدیریت کمک کد جمینی و سپس اصلاح اشتراک را انتخاب کنید. 
- برای این اشتراک Gemini Code Assist Standard یا Enterprise، تأیید کنید که License Assignment را روی Manually Assigning Licenses تنظیم کردهاید. اگر اشتراک Gemini Code Assist Standard یا Enterprise روی Automatically Assigning Licenses تنظیم شده باشد، نمیتوانید مجوزهای تکی را مدیریت کنید. تغییر این حساب صورتحساب به Manually Assigning Licenses ، پس از تغییر، تخصیص خودکار مجوز را غیرفعال میکند، اما تخصیصهای مجوز از قبل موجود تحت تأثیر قرار نمیگیرند. 
- گزینه «افزودن کاربر دارای مجوز» را انتخاب کنید. یک کادر محاورهای انتخاب کاربر نمایش داده میشود. فقط آدرسهای ایمیل حساب گوگل شخصی، مانند - @gmail.com،- @googlegroups.comو دامنههای Google Workspace پشتیبانی میشوند. فدراسیون هویت نیروی کار (BYOID) پشتیبانی نمیشود.
- افزودن کاربر دارای مجوز را انتخاب کنید. 
- تأیید کنید که نقشهای IAM کاربر و مصرفکنندهی استفاده از سرویس Gemini برای Google Cloud را به کاربران دارای مجوز اعطا میکنید . 
رابط برنامهنویسی کاربردی
 برای اختصاص مجوزهای Gemini Code Assist Standard و Enterprise، از متد billingAccounts.orders.licensePool.assign استفاده کنید.
- تأیید کنید که مجوزهای IAM زیر را در حساب صورتحسابی که شامل مجموعه مجوزهایی است که قصد واگذاری مجوز به آن را دارید، دارید:
-  billing.accounts.get
-  consumerprocurement.licensePools.assign
-  consumerprocurement.licensePools.get
-  consumerprocurement.licensePools.unassign
-  consumerprocurement.orders.get
- یک فایل JSON ایجاد کنید که شامل اطلاعات زیر باشد: - { "usernames": [ USER_EMAILS ] }- USER_EMAILSبا فهرستی از حسابهای کاربری که مجوز به آنها اختصاص داده شده است و با کاما از هم جدا شدهاند، جایگزین کنید - برای مثال،- "dana@example.com", "lee@example.com". فقط آدرسهای ایمیل حسابهای کاربری گوگل، مانند- @gmail.com،- @googlegroups.comو دامنههای Google Workspace پشتیبانی میشوند. فدراسیون هویت نیروی کار (BYOID) پشتیبانی نمیشود.
- برای فراخوانی متد از - 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 استفاده نکردهاند، در پایان دوره عدم فعالیت تعیین شده توسط مدیر، به طور خودکار از دسترسی خارج میشوند.
- در کنسول گوگل کلود، به صفحه ادمین برای جمینی بروید. 
- گزینه مدیریت کمک کد جمینی و سپس مدیریت اشتراک را انتخاب کنید. 
- مدیریت مجوز (License Management ) و سپس فعال کردن تخصیص خودکار مجوز (Enable Automatic License Assignment) را انتخاب کنید. پنجرهی فعال کردن مجوزهای خودکار (Enable automatic licenses) ظاهر میشود. - تغییر این اشتراک به تخصیص خودکار مجوزها، تخصیص دستی مجوز را پس از تغییر غیرفعال میکند، اما تخصیصهای مجوز از پیش موجود تحت تأثیر قرار نمیگیرند. 
- مدت زمانی را که در صورت غیرفعال بودن گیرنده مجوز، مجوز از حالت واگذاری خارج میشود، تنظیم کنید، سپس تأیید تغییر را انتخاب کنید. کادر محاورهای «اختصاص خودکار مجوز فعال شده است» ظاهر میشود. - اگر - Tروز عدم فعالیت را برای عدم واگذاری پیکربندی کرده باشید، مجوز(ها) به طور خودکار از روز- T+1از حالت واگذاری خارج شده و در مخزن مجوزها در دسترس قرار میگیرند. به عنوان مثال، اگر- 7روز عدم فعالیت را برای عدم واگذاری پیکربندی کنید، مجوز(ها) از روز- 8از حالت واگذاری خارج شده و در مخزن مجوزها در دسترس قرار میگیرند.
- بستن را انتخاب کنید. 
- مطمئن شوید که نقشهای IAM مربوط به Gemini برای کاربر Google Cloud و مصرفکنندهی استفاده از سرویس را به کاربران دارای مجوز اعطا میکنید . - کاربرانی که مجوز - cloudaicompanion.licenses.selfAssignرا دارند، هنگام دسترسی اولیه به Gemini Code Assist Standard یا Enterprise در یک پروژه که توسط یک حساب صورتحساب پرداخت میشود، به طور خودکار یک مجوز دریافت میکنند. این حساب دارای اشتراک معتبری است که برای تخصیص خودکار مجوز پیکربندی شده است و مجوزهای موجود تحت پوشش اشتراکهای شما را در حساب صورتحساب دارد.
برای غیرفعال کردن تخصیص خودکار مجوز، مراحل زیر را دنبال کنید:
- در کنسول گوگل کلود، به صفحه ادمین برای جمینی بروید. 
- گزینه مدیریت کمک کد جمینی و سپس مدیریت اشتراک را انتخاب کنید. 
- مدیریت مجوز (License Management ) و سپس مدیریت تخصیص خودکار مجوز (Manage Automatic License Assignment) را انتخاب کنید. پنجره مدیریت تخصیص خودکار مجوز (Manage automatic license assignment) ظاهر میشود. 
- غیرفعال کردن مدیریت خودکار مجوز را انتخاب کنید. 
- تأیید تغییر را انتخاب کنید. 
لغو دستی مجوزهای Gemini Code Assist Standard و Enterprise
یکی از گزینههای زیر را انتخاب کنید:
کنسول
- تأیید کنید که مجوزهای IAM زیر را در حساب صورتحسابی که مالک اشتراک است، دارید: -  billing.accounts.get
-  consumerprocurement.orders.get
-  consumerprocurement.licensePools.get
-  consumerprocurement.licensePools.enumerateLicensedUsers
-  consumerprocurement.licensePools.unassign
-  resourcemanager.projects.get
 
-  
- به صفحه مدیریت Gemini بروید. 
- گزینه مدیریت کمک کد جمینی و سپس مدیریت اشتراک را انتخاب کنید. 
- مدیریت مجوز (License Management ) و سپس مدیریت تخصیص خودکار مجوز (Manage Automatic License Assignment) را انتخاب کنید. پنجره مدیریت تخصیص خودکار مجوز (Manage automatic license assignment) ظاهر میشود. 
- کاربرانی را که میخواهید مجوزها را برای آنها لغو کنید، انتخاب کنید، سپس گزینه «لغو مجوز» را انتخاب کنید. 
- تأیید را انتخاب کنید. 
رابط برنامهنویسی کاربردی
 برای لغو تخصیص مجوزهای Gemini Code Assist Standard و Enterprise، از متد billingAccounts.orders.licensePool.unassign استفاده کنید.
- برای انجام این کار، باید مجوز - consumerprocurement.licensePools.unassignIdentity and Access Management را روی حساب صورتحسابی که شامل مخزن مجوزی است که قصد دارید مجوز آن را لغو کنید، داشته باشید.
- یک فایل JSON ایجاد کنید که شامل اطلاعات زیر باشد: - { "usernames": [ USER_EMAILS ] }- به جای - USER_EMAILSلیستی از حسابهای کاربری که با کاما از هم جدا شدهاند و مجوز به آنها اختصاص داده شده است را قرار دهید—برای مثال،- "dana@example.com", "lee@example.com".
- برای فراخوانی متد از - 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 را در پروژه غیرفعال کنید.
- از مجوزها برای رد دسترسی کاربر به پروژه استفاده کنید.
محدودیتها
- Gemini برای مدیریت مجوز Google Cloud از فدراسیون هویت نیروی کار پشتیبانی نمیکند.