این سند نحوه پیکربندی کانالهای انتشار Gemini Code Assist برای یک پروژه را با استفاده از کنسول Google Cloud یا یک API شرح میدهد.
ما ویژگیهای Gemini Code Assist را در کانالهای انتشار مختلف منتشر میکنیم. شما میتوانید هر پروژه Google Cloud را بسته به تعادل انتخابی خود بین در دسترس بودن ویژگیها و پایداری، روی یک کانال انتشار واحد تنظیم کنید. کاربرانی که در سازمان شما از Gemini Code Assist در IDE محلی خود استفاده میکنند، میتوانند از ویژگیها و مدلهایی که بر اساس کانال انتشار پیکربندی شده برای پروژه هستند، استفاده کنند.
کانالهای انتشار زیر در دسترس هستند:
- بهطورکلی در دسترس. کانال انتشار پیشفرض. به شما امکان میدهد از مدلها و ویژگیهای موجود بهطورکلی استفاده کنید. توجه داشته باشید که دسترسی به برخی از ویژگیهای پیشنمایش بدون انتخاب کانال پیشنمایش، با استفاده از مکانیسمهای جایگزین ثبتنام پیشنمایش، امکانپذیر است. این ویژگیها در کانال GA قابل دسترسی خواهند بود، اما همچنان تحت پوشش شرایط ارائه پیش از GA هستند.
- پیشنمایش. به شما امکان میدهد به برخی از ویژگیهای پیشنمایش Gemini Code Assist دسترسی داشته باشید و در صورت تمایل، بازخورد و دادههای مربوط به میزان استفاده را برای کمک به گوگل در بهبود نسخههای آینده ارائه دهید. توجه داشته باشید که در حال حاضر هیچ ویژگی متمایزی در کانال انتشار پیشنمایش وجود ندارد. - وقتی کانال انتشار پیشنمایش را در یک پروژه فعال میکنید، از طرف مشتری موافقت میکنید که تمام استفاده از Gemini Code Assist در آن پروژه تابع شرایط ارائه Pre-GA از شرایط خدمات خاص پلتفرم Google Cloud باشد. از این کانال برای پروژهها و منابعی که برای استفاده با پیشنهادات pre-GA مناسب نیستند، استفاده نکنید. 
بخشهای زیر مراحل لازم برای تنظیم یا تغییر کانال انتشار Gemini Code Assist شما را ارائه میدهند.
قبل از اینکه شروع کنی
- تأیید کنید که پروژه Google Cloud شما به یک حساب صورتحساب متصل است. برای اطلاعات بیشتر، به «تأیید وضعیت صورتحساب پروژههای شما» مراجعه کنید.
نقشهای مورد نیاز
 برای مجوزهای لازم جهت ایجاد تنظیمات و پیوندهایی که کانال انتشار را کنترل میکنند، از مدیر سیستم خود بخواهید که نقش Gemini for Google Cloud Settings Admin ( roles/cloudaicompanion.settingsAdmin ) را در پروژه به شما اعطا کند.
برای مشاهدهی مجوزهای دقیق مورد نیاز، بخش مجوزهای مورد نیاز را باز کنید:
مجوزهای مورد نیاز
-  cloudaicompanion.releaseChannelSettings.create
-  cloudaicompanion.releaseChannelSettings.delete
-  cloudaicompanion.releaseChannelSettings.get
-  cloudaicompanion.releaseChannelSettings.list
-  cloudaicompanion.releaseChannelSettings.update
-  cloudaicompanion.dataSharingWithGoogleSettings.create
- کانالهای انتشار را با استفاده از API پیکربندی کنید:
-  cloudaicompanion.settingBindings.releaseChannelSettingsCreate
-  cloudaicompanion.settingBindings.releaseChannelSettingsDelete
-  cloudaicompanion.settingBindings.releaseChannelSettingsGet
-  cloudaicompanion.settingBindings.releaseChannelSettingsList
-  cloudaicompanion.settingBindings.releaseChannelSettingsUpdate
-  cloudaicompanion.settingBindings.releaseChannelSettingsUse
- پیکربندی اشتراکگذاری اعلان و پاسخ با استفاده از یک API:
-  cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsCreate
-  cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUse
- تنظیمات ادمین گوگل کلود برای Gemini را مشاهده کنید:
-  cloudaicompanion.instances.queryEffectiveSetting
-  cloudaicompanion.instances.queryEffectiveSettingBindings
کانالهای انتشار Gemini Code Assist را پیکربندی کنید
یکی از گزینههای زیر را انتخاب کنید:
کنسول
- در کنسول گوگل کلود، به صفحه ادمین برای جمینی بروید. - برای دسترسی به فضای ابری گوگل به Gemini بروید - صفحه Gemini برای Google Cloud بارگذاری میشود. 
- در منوی ناوبری، روی تنظیمات کلیک کنید. - صفحه تنظیمات بارگذاری میشود. 
- در بخش کانالهای انتشار برای Gemini Code Assist در IDEهای محلی ، کانال انتشاری را انتخاب کنید که به بهترین وجه با نیازهای شما مطابقت دارد: - پیشنمایش- پیشنمایش را انتخاب کنید.
- جزئیات کانال انتشار پیشنمایش و شرایط برنامهی Trusted Tester را بررسی کنید و سپس روی ذخیره تغییرات کلیک کنید.
 - به طور کلی موجود است- جی ای را انتخاب کنید.
- روی ذخیره تغییرات کلیک کنید.
 
رابط برنامهنویسی کاربردی
- تنظیمات کانال انتشار و یک مقدار مختص به تنظیمات را ایجاد کنید: - یک توکن احراز هویت دریافت کنید. برای دریافت آن باید با استفاده از احراز هویت gcloud احراز هویت شوید: - TOKEN=$(gcloud auth print-access-token)
- تنظیمات را ایجاد کنید. این دستورالعملها از - cURLبرای فراخوانی متدهای API استفاده میکنند:- curl -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' -d '{ "release_channel": "RELEASE_CHANNEL", } ' -X POST "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/releaseChannelSettings?release_channel_setting_id=RC_SETTING_ID"- موارد زیر را جایگزین کنید: -  RELEASE_CHANNEL: کانال انتشار، که میتواندEXPERIMENTAL(پیشنمایش) یاSTABLE(پایدار) باشد.
-  CONTAINER_PROJECT_NAME: شناسه پروژهای که منبع اتصال در آن ذخیره شده است. این پروژه والد اتصال است.
-  RC_SETTING_ID: یک نام تنظیم منحصر به فرد - برای مثال،rc1برایRelease Channel.
 - خروجی نشان میدهد که - releaseChannelروی- RELEASE_CHANNELتنظیم شده است:- { "name": "projects/CONTAINER_PROJECT_NAME /locations/global/releaseChannelSettings/RC_SETTING_ID", "createTime": "2025-01-23T15:22:49.717166932Z", "updateTime": "2025-01-23T15:22:49.717166932Z", "releaseChannel": RELEASE_CHANNEL }
-  
- اتصال تنظیمات کانال انتشار را ایجاد کنید: - curl \ -H "Authorization: Bearer $TOKEN" \ -H 'Content-Type: application/json' \ -d '{ "target": "projects/TARGET_PROJECT_NAME", "product": "GEMINI_CODE_ASSIST" }' \ -X POST "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/releaseChannelSettings/RC_SETTING_ID/settingBindings?setting_binding_id=RC_BINDING_ID"- موارد زیر را جایگزین کنید: -  TARGET_PROJECT_NAME: پروژه هدفی که اتصال باید به آن متصل شود. این اغلب مشابه پروژه کانتینر است. با این حال، میتوانید یک تنظیم را به چندین پروژه متصل کنید تا نیازی به تکرار منبع تنظیم نباشد.
-  CONTAINER_PROJECT_NAME: شناسه پروژهای که منبع اتصال در آن ذخیره شده است. این پروژه والد اتصال است.
-  RC_SETTING_ID: همانRC_SETTING_IDکه هنگام ایجاد تنظیمات استفاده کردید، اما بهb1اضافه شده است. برای مثال، ازrc1b1برایRelease Channelاستفاده کنید.
-  RC_BINDING_ID: یک نام منحصر به فرد برای اتصال تنظیمات - برای مثال،rc_binding.
 - خروجی شامل فرادادههای عملیات در قالب زیر است: - { "name": "projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-RC_BINDING_OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.cloudaicompanion.v1.OperationMetadata", "createTime": "2025-01-23T15:27:50.076075570Z", "target": "projects/TARGET_PROJECT_NAME/locations/global/releaseChannelSettings/RC_SETTING_ID/settingBindings/RC_BINDING_ID", "verb": "create", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }
-  
- اختیاری: وضعیت ایجاد اتصال تنظیمات کانال انتشار را بررسی کنید: - curl -H "Authorization: Bearer $TOKEN" \ https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-RC_BINDING_OPERATION_ID- موارد زیر را جایگزین کنید: -  CONTAINER_PROJECT_NAME: شناسه پروژهای که منبع اتصال در آن ذخیره شده است. این پروژه والد اتصال است.
-  RC_BINDING_OPERATION_ID: شناسه عملیات ایجاد اتصال تنظیمات کانال انتشار که در پاسخ مرحله قبل ارائه شده است.
 
-  
 
- اختیاری: تنظیمات اشتراکگذاری اعلان و پاسخ و یک مقدار مختص به تنظیمات را ایجاد کنید: - دریافت توکن: - TOKEN=$(gcloud auth print-access-token)
- تنظیمات را ایجاد کنید: - curl -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' -d '{ "enable_preview_data_sharing": true, } ' -X POST "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings?data_sharing_with_google_setting_id=DSWG_SETTING_ID"- موارد زیر را جایگزین کنید: -  CONTAINER_PROJECT_NAME: شناسه پروژه والد
-  DSWG_SETTING_ID: یک نام تنظیم منحصر به فرد - برای مثال،dswg1برایData Sharing with Google
 - خروجی نشان میدهد که - enablePreviewDataSharingروی- trueتنظیم شده است:- { "name": "projects/CONTAINER_PROJECT_NAME /locations/global/dataSharingWithGoogleSettings/DSWG_SETTING_ID", "createTime": "2025-01-23T15:22:49.717166932Z", "updateTime": "2025-01-23T15:22:49.717166932Z", "enablePreviewDataSharing": true }
-  
- اتصال تنظیمات اعلان و پاسخ را ایجاد کنید: - curl \ -H "Authorization: Bearer $TOKEN" \ -H 'Content-Type: application/json' \ -d '{ "target": "projects/TARGET_PROJECT_NAME", "product": "GEMINI_CODE_ASSIST" }' \ -X POST "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings/DSWG_SETTING_ID/settingBindings?setting_binding_id=DSWG_BINDING_ID"- موارد زیر را جایگزین کنید: -  TARGET_PROJECT_NAME: پروژه هدفی که تنظیمات باید روی آن اعمال شود.
-  CONTAINER_PROJECT_NAME: شناسه پروژه والد.
-  DSWG_SETTING_ID: همانDSWG_SETTING_IDکه هنگام ایجاد تنظیمات استفاده کردید، اما بهb1اضافه شده است. برای مثال، ازdswg1b1برایData Sharing with Googleاستفاده کنید.
-  DSWG_BINDING_ID: یک نام منحصر به فرد برای اتصال تنظیمات - برای مثال،dswg_binding.
 - خروجی شامل فرادادههای عملیات در قالب زیر است: - { "name": "projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-DSWG_BINDING_OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.cloudaicompanion.v1.OperationMetadata", "createTime": "2025-01-23T15:27:50.076075570Z", "target": "projects/TARGET_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings/DSWG_SETTING_ID/settingBindings/DSWG_BINDING_ID", "verb": "create", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }
-  
- اختیاری: وضعیت ایجاد اتصال تنظیمات اعلان و پاسخ را بررسی کنید: - curl -H "Authorization: Bearer $TOKEN" \ https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-DSWG_BINDING_OPERATION_ID- موارد زیر را جایگزین کنید: -  CONTAINER_PROJECT_NAME: شناسه پروژهای که منبع اتصال در آن ذخیره شده است. این پروژه والد اتصال است.
-  DSWG_BINDING_OPERATION_ID: شناسه عملیات ایجاد اتصال تنظیمات اعلان و پاسخ که در پاسخ مرحله قبل ارائه شده است.
 
-