قبل از استفاده از Gemini Code Assist Standard و Enterprise، هر کاربر در سازمان شما نیاز به مجوز دارد.
به طور پیشفرض، اشتراکهای جدید از شما میخواهند که مجوزها را به صورت دستی اختصاص دهید. پس از راهاندازی Gemini خاص برای محصولات Google Cloud، سپس میتوانید انتخاب کنید که مجوزها را به صورت دستی یا خودکار اختصاص دهید.
میتوانید به هر کاربری که پروژه مرتبط با حساب صورتحساب را دارند مجوز اختصاص دهید. پس از اینکه مجوز را به کاربر اختصاص دادید، آنها می توانند از Gemini Code Assist در هر پروژه ای استفاده کنند.
طرح Google Developer Program Premium مجوز استاندارد Gemini Code Assist را در اختیار کاربران قرار می دهد. نمیتوانید مجوز صندلی Gemini Code Assist Standard را به کاربری اختصاص دهید که دارای اشتراک Google Developer Program Premium است، زیرا آنها قبلاً از طریق Google Developer Program Premium مجوز دارند.
قبل از شروع
- مطمئن شوید که نقشهای IAM مدیر حساب صورتحساب (
roles/billing.admin
) یا مدیر سفارش تدارکات مصرفکننده (roles/consumerprocurement.orderAdmin
) را دارید تا بتوانید مجوزهای اضافی مورد نیاز در حساب صورتحساب را برای وظایف مدیریت مجوز خاص که در بخشهای زیر شرح داده شده است، اعطا کنید.
- اگر می خواهید مجوزها را با استفاده از API به جای کنسول API Google مدیریت کنید، از موارد زیر اطمینان حاصل کنید:
- یک پروژه سهمیه برای حساب صورتحساب خود تنظیم کنید.
- Cloud Commerce Consumer Procurement API را در پروژه سهمیه خود فعال کنید.
- اطمینان حاصل کنید که جفتهای هدر کلید-مقدار زیر در همه تماسهای API وجود دارد:
-
Authorization
: رمز دسترسی Google Cloud شما از Google Cloud CLI -
x-goog-user-project
: شناسه پروژه پروژه سهمیه شما
-
تعداد مجوزهای Gemini Code Assist Standard و Enterprise را در یک اشتراک تغییر دهید
میتوانید تعداد مجوزهای Gemini برای Google Cloud را مستقیماً از طریق کنسول API یا از طریق نماینده حساب Google خود یا یک فروشنده مجاز اضافه یا حذف کنید.
برای تغییر تعداد مجوزها در یک اشتراک، مراحل زیر را دنبال کنید:
مطمئن شوید که مجوزهای مدیریت هویت و دسترسی زیر را در حساب صورتحساب مالک اشتراک دارید:
-
billing.accounts.get
-
consumerprocurement.orders.get
-
consumerprocurement.orders.modify
-
resourcemanager.projects.get
-
در کنسول API، به صفحه Admin for Gemini بروید.
اشتراکی را که می خواهید تغییر دهید انتخاب کنید و سپس اصلاح اشتراک را انتخاب کنید.
تعداد مجوزهایی که می خواهید داشته باشید را وارد کنید. اطلاعات زیر نمایش داده می شود:
- تعداد کل مجوزها پس از خرید.
- تعداد مجوزهای موجود برای واگذاری پس از خرید.
- قیمت اشتراک جدید در هر ترم. مبلغ اضافی برای مجوزهای اضافه شده بر اساس مدت زمان باقی مانده در دوره فعلی تقسیم می شود.
ذخیره را انتخاب کنید.
تخصیص مجوزهای استاندارد و Enterprise Code Assist را مشاهده کنید
یکی از گزینه های زیر را انتخاب کنید:
کنسول
مطمئن شوید که مجوزهای IAM زیر را در حساب صورتحساب مالک اشتراک دارید:
-
billing.accounts.get
-
consumerprocurement.orders.get
-
consumerprocurement.licensePools.get
-
consumerprocurement.licensePools.enumerateLicensedUsers
-
resourcemanager.projects.get
-
به صفحه Admin for Gemini بروید و پروژه پیوست شده به حساب صورتحساب خود را با اشتراک استاندارد Gemini Code Assist یا Enterprise انتخاب کنید.
اشتراکی را که می خواهید تغییر دهید انتخاب کنید و سپس اصلاح اشتراک را انتخاب کنید.
اطلاعات زیر برای هر کاربری که مجوز تخصیص یافته است موجود است:
- نام.
- ایمیل.
- تاریخ واگذاری مجوز
- تاریخ و ساعت آخرین استفاده از مجوز.
برای پیدا کردن یک مجموعه خاص از کاربران، می توانید لیست را به صورت زیر فیلتر و مرتب کنید:
- برای فیلتر کردن لیست، در قسمت Filter ، ویژگی ها و مقادیر را وارد کنید.
- برای مرتبسازی فهرست، عنوان ستونی را که میخواهید بر اساس آن مرتب کنید، انتخاب کنید. به عنوان مثال، برای مرتب کردن بر اساس حروف الفبا بر اساس نام کاربری، عنوان ستون Name را انتخاب کنید.
API
برای مشاهده تخصیص مجوزهای استاندارد یا Enterprise Code Assist Gemini، از روش 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": "[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" } ] }
اگر هیچ تخصیص مجوز یا مجوز Enterprise Code Assist استاندارد Gemini وجود نداشته باشد یا ORDER_ID
نامعتبر باشد، خروجی licensedUsers
را در قالب زیر برمیگرداند:
{}
مجوزهای Gemini Code Assist Standard و Enterprise را به صورت دستی به کاربران اختصاص دهید
یکی از گزینه های زیر را انتخاب کنید:
کنسول
مطمئن شوید که مجوزهای IAM زیر را در حساب صورتحساب مالک اشتراک دارید:
-
billing.accounts.get
-
consumerprocurement.orders.get
-
consumerprocurement.licensePools.get
-
consumerprocurement.licensePools.enumerateLicensedUsers
-
consumerprocurement.licensePools.assign
-
resourcemanager.projects.get
-
به صفحه Admin for Gemini بروید.
Manage Gemini Code Assist را انتخاب کنید و سپس Modify Subscription را انتخاب کنید.
برای این اشتراک استاندارد Gemini Code Assist یا Enterprise، اطمینان حاصل کنید که تخصیص مجوز را روی انتساب دستی مجوزها تنظیم کرده اید. اگر اشتراک استاندارد Gemini Code Assist یا Enterprise روی Automatically Assign Licenses تنظیم شده باشد، نمی توانید مجوزهای فردی را مدیریت کنید. تغییر این حساب صورتحساب به واگذاری دستی مجوزها، تخصیص خودکار مجوز را پس از تغییر خاموش میکند، اما تخصیص مجوزهای قبلی تحت تأثیر قرار نمیگیرد.
Assign Licenses را انتخاب کنید. یک گفتگوی انتخاب کاربر ظاهر می شود. برای جستجوی کاربران خاص، آدرس ایمیل آنها را وارد کرده و سپس Next را انتخاب کنید.
Assign Licenses را انتخاب کنید.
اطمینان حاصل کنید که نقشهای Gemini for Google Cloud User and Service Usage Consumer IAM را به کاربران به کاربران دارای مجوز اختصاص میدهید .
API
برای تخصیص مجوزهای 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
با فهرستی از حسابهای کاربری جدا شده با کاما که مجوز را به آنها اختصاص میدهند، جایگزین کنید - برای مثال،"[email protected]", "[email protected]"
.برای فراخوانی متد
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 که در مرحله ۲ ایجاد کردید. - PROJECT_ID : شناسه یک پروژه. استفاده از سهمیه و هزینههای مربوط به درخواست API برای این پروژه اعمال میشود.
-
BILLING_ACCOUNT_ID
: شناسه حساب صورتحساب مرتبط با مجموعه مجوز. -
ORDER_ID
: شناسه سفارش. اگر شناسه سفارش را نمیدانید، میتوانید با فهرست کردن سفارشهای مرتبط با حساب صورتحساب خود، آن را بازیابی کنید.
-
در صورت موفقیت آمیز بودن، پاسخ مشابه زیر است:
{}
برای تأیید تکلیف، فهرست تکالیف را مشاهده کنید .
سپس، مطمئن شوید که نقشهای Gemini for Google Cloud User و Service Usage Consumer IAM را به کاربران به کاربران دارای مجوز اعطا میکنید .
به طور خودکار مجوزهای Gemini Code Assist Standard و Enterprise را اختصاص دهید
میتوانید بهطور خودکار مجوزی را به هر کاربری در سازمانتان که نیاز به دسترسی به Gemini Code Assist Standard یا Enterprise از صفحه واگذاری مجوز دارد اختصاص دهید. تخصیص خودکار مجوز به صورت جداگانه برای هر اشتراک تنظیم می شود.
تخصیص خودکار مجوز فقط در VS Code، IntelliJ و سایر IDE های پشتیبانی شده JetBrains پشتیبانی می شود.
اگر انتخاب کنید به طور خودکار مجوزهای Gemini Code Assist Standard یا Enterprise را اختصاص دهید، نمیتوانید مجوزهای کاربر فردی را تحت آن حساب حذف یا اضافه کنید. کاربرانی که دارای مجوز هستند و از هیچیک از ویژگیهای Gemini Code Assist Standard یا Enterprise استفاده نکردهاند، در پایان دوره عدم فعالیت تعیینشده توسط سرپرست، بهطور خودکار از اختیار خارج میشوند.
در کنسول API، به صفحه Admin for Gemini بروید.
Manage Gemini Code Assist و سپس Manage Subscription را انتخاب کنید.
مدیریت مجوز را انتخاب کنید و سپس Enable Automatic License Assignment را انتخاب کنید. گفتگوی Enable Automatic Licenses ظاهر می شود.
تغییر این اشتراک برای اختصاص خودکار مجوزها، واگذاری مجوز دستی پس از تغییر را غیرفعال میکند، اما تخصیص مجوزهای قبلی تحت تأثیر قرار نمیگیرد.
مدت زمانی را برای لغو اختصاص مجوز در صورت غیرفعال بودن گیرنده تعیین کنید، سپس تأیید تغییر را انتخاب کنید. گفتگوی تخصیص خودکار مجوز فعال شده است ظاهر می شود.
اگر
T
روز عدم فعالیت را برای لغو تخصیص پیکربندی کردهاید، مجوز(ها) به طور خودکار حذف میشوند و در روزT+1
در مجموعه مجوز موجود هستند. به عنوان مثال، اگر7
روز عدم فعالیت را برای لغو تخصیص پیکربندی کنید، مجوز(ها) واگذار نشده و در روز8
در مجموعه مجوز موجود است.بستن را انتخاب کنید.
اطمینان حاصل کنید که نقشهای Gemini for Google Cloud User and Service Usage Consumer IAM را به کاربران به کاربران دارای مجوز اعطا کردهاید .
کاربرانی که دارای مجوز
cloudaicompanion.licenses.selfAssign
هستند، هنگامی که برای اولین بار به Gemini Code Assist Standard یا Enterprise در پروژهای که توسط حساب صورتحساب پرداخت میشود و دارای اشتراک معتبری است که برای تخصیص خودکار مجوز پیکربندی شده است و دارای مجوزهای موجود تحت پوشش اشتراکهای شما در حساب صورتحساب است، بهطور خودکار مجوز دریافت میکنند.
برای غیرفعال کردن تخصیص خودکار مجوز، مراحل زیر را دنبال کنید:
در کنسول API، به صفحه Admin for Gemini بروید.
Manage Gemini Code Assist و سپس Manage Subscription را انتخاب کنید.
مدیریت مجوز را انتخاب کنید و سپس 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
-
به صفحه Admin for Gemini بروید.
Manage Gemini Code Assist و سپس Manage Subscription را انتخاب کنید.
مدیریت مجوز را انتخاب کنید و سپس Manage Automatic License Assignment را انتخاب کنید. کادر گفتگوی مدیریت تخصیص مجوز خودکار ظاهر می شود.
کاربرانی را که میخواهید مجوزها را لغو اختصاص دهید انتخاب کنید، سپس لغو اختصاص مجوز را انتخاب کنید.
تایید را انتخاب کنید.
API
برای لغو اختصاص مجوزهای Gemini Code Assist Standard و Enterprise، از روش billingAccounts.orders.licensePool.unassign
استفاده کنید.
برای انجام این کار، باید مجوز
consumerprocurement.licensePools.unassign
Identity and Access Management را در حساب صورتحساب که حاوی مجموعه مجوزی است که میخواهید مجوز آن را لغو کنید، داشته باشید.یک فایل JSON ایجاد کنید که حاوی اطلاعات زیر باشد:
{ "usernames": [ USER_EMAILS ] }
USER_EMAILS
با فهرستی از حسابهای کاربری جدا شده با کاما که مجوز به آنها اختصاص داده شده است، جایگزین کنید - برای مثال،"[email protected]", "[email protected]"
.برای فراخوانی متد
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 که در مرحله ۲ ایجاد کردید. - PROJECT_ID : شناسه یک پروژه. استفاده از سهمیه و هزینههای مربوط به درخواست API برای این پروژه اعمال میشود.
-
BILLING_ACCOUNT_ID
: شناسه حساب صورتحساب مرتبط با مجموعه مجوز. -
ORDER_ID
: شناسه سفارش. اگر شناسه سفارش را نمیدانید، میتوانید با فهرست کردن سفارشهای مرتبط با حساب صورتحساب خود، آن را بازیابی کنید.
-
در صورت موفقیت آمیز بودن، پاسخ مشابه زیر است:
{}
برای تأیید عدم تخصیص، فهرست تکالیف را مشاهده کنید .
مجوزهای استاندارد و Enterprise 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 در پروژه، می توانید یکی از موارد زیر را انجام دهید:
- Gemini for Google Cloud API را در پروژه غیرفعال کنید.
- از مجوزها برای ممانعت از دسترسی کاربر به پروژه استفاده کنید.
محدودیت ها
- Gemini برای مدیریت مجوز Google Cloud از فدراسیون هویت نیروی کار پشتیبانی نمیکند.