برای اتصال Google Workspace خود به ChatGPT با استفاده از راه‌اندازی مدیریت‌شده توسط ادمین، ابتدا دسترسی را در کنسول‌های ادمین Google پیکربندی می‌کنید:

یک حساب سرویس ایجاد کنید که به Google Drive، کاربران و گروه‌ها دسترسی فقط خواندنی داشته باشد.
- به‌شدت توصیه می‌شود این حساب سرویس زیر همان حساب Google مرتبط با فضای کاری ChatGPT شما ایجاد شود. اگر حساب‌های موجود در فضای کاری ChatGPT دامنهٔ ایمیلی متفاوت از دامنهٔ استفاده‌شده در Google Workspace دارند، برای فعال‌کردن این کانکتور برای کاربران خود باید مراحل اضافی را دنبال کنید.
یک حساب ادمین ایجاد کنید که حساب سرویس از طرف آن عمل خواهد کرد.

سپس، راه‌اندازی را در کنسول ادمین ChatGPT کامل کنید:

کلید خصوصی حساب سرویس را بارگذاری کنید (یک فایل JSON از Google)
حساب ادمین را مشخص کنید (اعتبارنامه لازم نیست).
انتخاب کنید کدام فایل‌ها همگام‌سازی شوند و کاربرانی را انتخاب کنید که به اتصال دسترسی خواهند داشت.

این راهنما هر یک از این ۶ مرحله را توضیح می‌دهد.

راه‌اندازی حساب سرویس

به console.cloud.google.com بروید.
روی منوی کشویی پروژه‌ها کلیک کنید.تصویرمطمئن شوید وارد همان فضای کاری Google شده‌اید که با فضای کاری ChatGPT شما مرتبط است (اگر فضای کاری Google مرتبط با فضای کاری ChatGPT خود ندارید و ایمیل‌های این دو متفاوت است، باید مراحل اضافی را دنبال کنید؛ در غیر این صورت ممکن است کاربران شما نتوانند از کانکتورهای همگام‌شدهٔ Google Drive استفاده کنند).
پروژهٔ جدید را انتخاب کنید

Google Cloud Select a resource dialog with dolores-lab.com organization selected

یک نام پروژه وارد کنید

Google Cloud New Project form with organization dolores-lab.com selected and Create button available

پروژه را ایجاد کنید

Google Cloud New Project form with ChatGPT Google Connector entered under the dolores-lab.com organization

صبر کنید تا پروژه ایجاد شود، سپس روی انتخاب پروژه کلیک کنید

Google Cloud notifications confirm creation of the ChatGPT Google Connector project for dolores-lab.com

روی APIها و سرویس‌ها کلیک کنید

روی کتابخانه کلیک کنید

اکنون می‌خواهیم سه API اضافه کنیم و برای یافتن آن‌ها از کادر جستجو استفاده می‌کنیم

Google Cloud API Library page with the ChatGPT Google Connector project selected

Google Drive API را جستجو و انتخاب کنید

Google Cloud API Library search results for Google Drive API in the ChatGPT Google Connector project

روی فعال‌سازی کلیک کنید

Google Cloud Console Google Drive API page with the Enable button for the ChatGPT Google Connector project

روی کتابخانه کلیک کنید

Google Drive API details page with the API enabled and Create Credentials available

Google Drive Activity را جستجو کنید

Google Cloud API Library open for the ChatGPT Google Connector project

Google Drive Activity API را انتخاب کنید

Google Cloud API Library search results for Google Drive Activity API

روی فعال‌سازی کلیک کنید

روی کتابخانه کلیک کنید

Google Cloud Console Drive Activity API details page with the API enabled and Create credentials available

Admin SDK API را جستجو کنید

Google Cloud API Library page for the ChatGPT Google Connector project

Admin SDK API را انتخاب کنید

Google Cloud API Library search results for Admin SDK API with Admin SDK API listed

روی فعال‌سازی کلیک کنید

Google Cloud Admin SDK API page with the Enable button for the ChatGPT Google Connector project

روی اعتبارنامه‌ها کلیک کنید

Google Cloud Admin SDK API details page with the API enabled and Create credentials button available

روی ایجاد اعتبارنامه کلیک کنید

Google Cloud APIs & Services Credentials page with Configure consent screen button

روی حساب سرویس کلیک کنید

Google Cloud Credentials page with Create credentials menu open for API key, OAuth client ID, or service account

برای این حساب سرویس، یک نام و توضیح دلخواه ارائه کنید

Google Cloud Create service account page with Service Accounts selected and service account details fields

(اختیاری) می‌توانید یک نقش اختصاص دهید؛ ChatGPT به این مورد نیاز ندارد.

Google Cloud Create service account page with optional IAM role step and Service account created confirmation

(اختیاری) می‌توانید به حساب سرویس دسترسی بدهید؛ ChatGPT به این مورد نیاز ندارد.

Google Cloud Create service account step 3 with Done button and Service account created confirmation

روی انجام شد کلیک کنید.

Create service account step 3 in Google Cloud with Done button and Service account created confirmation

روی حساب سرویس که اکنون ایجاد شده است کلیک کنید.

Google Cloud Credentials page listing the newly created ChatGPT Google Connector service account

روی کلیدها. کلیک کنید

Google Cloud IAM service account details for ChatGPT Google Connector, enabled after creation

روی افزودن کلید کلیک کنید

روی ایجاد کلید جدید کلیک کنید

Google Cloud service account Keys tab with Add key menu open to create or upload a key

نوع کلید پیش‌فرض JSON را نگه دارید و روی ایجاد کلیک کنید

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

Create private key dialog for ChatGPT Google Connector with JSON key type selected

روی بستن کلیک کنید. کلید اکنون در رایانهٔ شما دانلود شده است. بعداً این مورد را در کنسول ادمین ChatGPT بارگذاری خواهید کرد.

Google Cloud service account Keys tab with confirmation that a private key JSON file was saved to the computer

روی جزئیات کلیک کنید

Google Cloud service account Keys tab for ChatGPT Google Connector with Add Key button

به شناسهٔ یکتا توجه کنید. این مورد در مرحلهٔ ۴۲ لازم خواهد بود.

Google Cloud service account details for ChatGPT Google Connector with status Enabled

تنظیمات پیشرفته را باز کنید

Google Cloud service account details for ChatGPT Google Connector with the account enabled

به پایین پیمایش کنید و روی مشاهدهٔ کنسول ادمین Google Workspace کلیک کنید. کنسول Google Workspace در یک برگهٔ جدید باز خواهد شد.

روی نمایش بیشتر کلیک کنید

Google Workspace Admin console home page for dolores-lab.com

بخش امنیت را باز کنید

بخش دسترسی و کنترل‌های داده را باز کنید

Google Workspace Admin console home with Security section expanded in the left navigation

روی بخش کنترل‌های API کلیک کنید

Google Workspace Admin console home with Security > Access and data control expanded in the sidebar

روی مدیریت تفویض در سطح دامنه کلیک کنید

Google Admin console API controls page under Security > Access and data control

روی افزودن جدید کلیک کنید

Google Admin Domain-wide Delegation page with API clients list and Add new option

از شناسهٔ یکتا که قبلاً یادداشت کرده‌اید به‌عنوان مقدار این شناسهٔ کلاینت استفاده کنید

Google Admin Domain-wide Delegation dialog for adding a new client ID and OAuth scopes

برای دامنه‌های OAuth، به مقادیر دامنه‌های مجوز جداشده با ویرگول در زیر مراجعه کنید که باید کپی و جای‌گذاری کنید:

https://www.googleapis.com/auth/admin.directory.group.readonly, https://www.googleapis.com/auth/admin.directory.group.member.readonly, https://www.googleapis.com/auth/admin.directory.user.readonly, https://www.googleapis.com/auth/admin.directory.user.alias.readonly, https://www.googleapis.com/auth/drive.activity.readonly, https://www.googleapis.com/auth/drive.metadata.readonly, https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/userinfo.profile, https://www.googleapis.com/auth/userinfo.email

دامنه	استدلال
admin.directory.group.readonly	اعمال مجوزهای مبتنی بر گروه
admin.directory.group.member.readonly	اعمال مجوزهای مبتنی بر گروه
admin.directory.user.alias.readonly	رسیدگی به مواردی که در آن‌ها مجوز از طریق یک نام مستعار به کاربر داده می‌شود
drive.activity.readonly	برای دریافت اعلان هنگام ایجاد تغییرات در فایل‌ها
drive.metadata.readonly	همگام‌سازی محتوای فایل و فرادادهٔ مرتبط (مثلاً تاریخ آخرین تغییر)
drive.readonly	همگام‌سازی محتوای فایل و فرادادهٔ مرتبط (مثلاً تاریخ آخرین تغییر)
userinfo.profile	تعیین کاربرانی که فایل‌هایشان را همگام‌سازی می‌کنیم
userinfo.email	تعیین کاربرانی که فایل‌هایشان را همگام‌سازی می‌کنیم

۴۵. روی مجوزدهی کلیک کنید

۴۶. موفقیت‌آمیز بود!

راه‌اندازی حساب ادمین

Directory را باز کنید

Google Admin Domain-wide Delegation page with a ChatGPT API client and scopes listed

روی Users کلیک کنید

Google Admin domain-wide delegation page listing a ChatGPT Google Connector API client and scopes

Google Admin console Users page listing workspace accounts for setup and management

یک نام، نام خانوادگی و آدرس ایمیل اصلی دلخواه ارائه کنید

Google Admin console Add new user form for creating a Workspace user at dolores-lab.com

روی افزودن کاربر جدید کلیک کنید

Google Admin console Add new user form filled for a ChatGPT Connector account

(اختیاری) این اعتبارنامه‌ها را ثبت کنید. ChatGPT به این اعتبارنامه‌ها نیاز ندارد.

Google Admin Console New user added page for ChatGPT Connector with Copy Password and Done actions

روی انجام شد کلیک کنید.

Google Admin console Copy password dialog for a newly created user account

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

Google Admin console Users page listing accounts including ChatGPT Connector

روی اختصاص نقش‌ها کلیک کنید.

Google Admin user details page for the ChatGPT Connector service account

نقش‌های Groups Reader, User Management Admin, و Storage Admin را فعال کنید.

Google Admin ChatGPT Connector user page with Admin roles and privileges open and no roles assigned

به پایین پیمایش کنید و روی ذخیره. کلیک کنید حساب ادمین اکنون با موفقیت ایجاد و پیکربندی شده است.

تکمیل راه‌اندازی در کنسول ادمین ChatGPT

به ChatGPT بروید و روی نماد پروفایل در گوشهٔ بالای سمت راست صفحه کلیک کنید.

روی مدیریت فضای کاری کلیک کنید

ChatGPT workspace menu with Manage workspace selected under the organization switcher

روی اتصالات و سپس در بخش «کانکتورهای همگام‌شده» ← فعال‌سازی همگام‌سازی کلیک کنید

Connectors page with Google Drive sync prompt and Enable Sync button highlighted

مطمئن شوید مدیریت‌شده توسط ادمین انتخاب شده است و روی بعدی کلیک کنید

Google Drive connection setup with Admin-managed setup selected over Self-service setup

یک نام نمایشی وارد کنید. توصیه می‌کنیم از نام Google Workspace خود استفاده کنید.

لطفاً توجه داشته باشید که در حال حاضر از تغییر نام اتصال شما پشتیبانی نمی‌کنیم.

Google Workspace connector setup dialog with display name Dolores Labs entered

روی ذخیرهٔ پیش‌نویس و ادامه کلیک کنید

روی بارگذاری کلید کلیک کنید. فایل JSON را انتخاب کنید؛ این همان کلیدی است که در چارچوب راه‌اندازی حساب سرویس در بالا دانلود کرده‌اید. مطمئن شوید این کلید دقیق است

Google Workspace connection setup step prompting upload of a service account key and admin email address

آدرس ایمیل ادمین را وارد کنید. این همان حساب ادمینی است که قبلاً ایجاد کرده‌اید.

روی ذخیره. کلیک کنید

ChatGPT Connections credentials dialog with service account key and Google Workspace admin email entered

انتخاب کنید آیا می‌خواهید فایل‌های موجود در My Drive همهٔ کاربران شما نیز شامل شوند یا نه.

ChatGPT Connections modal for User files with Include user My Drives enabled at step 2 of 5

روی بعدی کلیک کنید

ChatGPT admin Connections modal for User files with Include user My Drives enabled in step 2 of 5

نحوهٔ مدیریت درایوهای مشترک را انتخاب کنید. ما از سه سناریوی زیر پشتیبانی می‌کنیم:

اگر می‌خواهید همهٔ درایوهای مشترک را شامل کنید، شامل‌کردن به‌صورت پیش‌فرض را انتخاب کنید و شناسهٔ درایو مشترکی برای حذف‌شدن اضافه نکنید
اگر می‌خواهید بیشتر درایوهای مشترک را شامل کنید، شامل‌کردن به‌صورت پیش‌فرض را انتخاب کنید و شناسهٔ درایوهای مشترکی را که می‌خواهید حذف شوند اضافه کنید
اگر می‌خواهید بیشتر درایوهای مشترک را حذف کنید، حذف‌کردن به‌صورت پیش‌فرض را انتخاب کنید و شناسهٔ درایوهای مشترکی را که می‌خواهید شامل شوند اضافه کنید

ChatGPT admin Shared drives setup with Include by default selected and an Excluded Shared drives field

برای یافتن شناسهٔ یک درایو مشترک، در یک مرورگر وب به آن بروید. آخرین بخش URL همان شناسهٔ درایو مشترک است.

در مثال زیر، مقدار آن 0ADvY03uUbEcQUk9PVA است

Google Drive shared drive with Manage members visible for Example Shared Drive

روی بعدی کلیک کنید

ChatGPT admin Connections modal for Shared drives with Include by default selected at step 3 of 5

انتخاب کنید چه کسانی باید به اتصال Google Drive دسترسی داشته باشند. می‌توانید فقط ادمین‌های فضای کاری ChatGPT را انتخاب کنید، یا آن را برای همه فعال کنید. اگر برای همه فعال شود، کاربران جدیدی که به فضای کاری اضافه می‌شوند به‌طور خودکار شامل خواهند شد.

Google Drive connector permission set to Admins only for workspace members

روی شروع همگام‌سازی کلیک کنید

اتصال Google Drive شما اکنون با موفقیت ایجاد شده است!

لطفاً توجه داشته باشید که اگرچه همگام‌سازی بلافاصله شروع می‌شود، بسته به تعداد فایل‌هایی که بر اساس تنظیمات شما شامل شده‌اند، تکمیل آن می‌تواند از چند ساعت تا چند روز طول بکشد. پس از پایان همگام‌سازی فایل‌هایی که در ۳۰ روز گذشته اضافه/ویرایش شده‌اند، کانکتور برای کاربرانی که آن را برایشان فعال کرده‌اید در دسترس خواهد بود.

فعال‌سازی ایجاد کلید حساب سرویس

اگر خطای زیر را دریافت کردید، باید ایجاد حساب سرویس را برای این پروژهٔ مشخص فعال کنید:

محدودیت خط‌مشی سازمانی «iam.disableServiceAccountKeyCreation» بر سازمان شما اعمال شده است.

Google Cloud service account Keys tab with error that service account key creation is disabled

یک برگهٔ جدید باز کنید و به console.cloud.google.com بروید. مطمئن شوید پروژهٔ انتخاب‌شده همان پروژه‌ای است که قبلاً انتخاب کرده‌اید.

روی نماد منو در گوشهٔ بالای سمت چپ کلیک کنید.

Google Cloud Console welcome page for the ChatGPT Google Connector project

نشانگر را روی IAM & Admin ببرید

Google Cloud Console navigation with IAM & Admin open and Organization Policies selected

روی سیاست‌های سازمانی کلیک کنید

Google Cloud Console IAM & Admin menu opened to Organization Policies

iam.disableServiceAccountKeyCreation را جستجو کنید

Google Cloud organization policies for the ChatGPT Google Connector project

روی نتیجهٔ constraints/iam.disableServiceAccountKeyCreation کلیک کنید

روی … مربوط به ردیفی با شناسهٔ iam.disableServiceAccountKeyCreation کلیک کنید

Organization policies filtered to Disable service account key creation for the ChatGPT Google Connector project

روی ویرایش خط‌مشی کلیک کنید. اگر ویرایش خط‌مشی غیرفعال است، باید به «مدیر خط‌مشی سازمان» تبدیل شوید.

Google Cloud Organization Policies filtered to Disable service account key creation with Edit policy menu open

روی نادیده‌گرفتن خط‌مشی والد کلیک کنید

روی افزودن یک قانون کلیک کنید

Edit policy page for Disable service account key creation with Override parent's policy selected

روی تنظیم خط‌مشی کلیک کنید

Google Cloud Edit policy page with Override parent's policy selected and enforcement set to Off

اکنون می‌توانید یک کلید حساب سرویس ایجاد کنید. ممکن است چند دقیقه طول بکشد تا این فعال‌سازی اثر کند.

Google Cloud policy details with Disable service account key creation set to Not enforced

تبدیل‌شدن به مدیر خط‌مشی سازمان

به console.cloud.google.com بروید و روی انتخابگر پروژه/سازمان کلیک کنید

Google Cloud welcome page for the ChatGPT Google Connector project

روی سازمان خود کلیک کنید

روی نماد منو در گوشهٔ بالای سمت چپ کلیک کنید

نشانگر را روی IAM & Admin ببرید

Google Cloud console navigation menu open with Google Cloud Setup pinned

روی IAM کلیک کنید

روی مداد مربوط به حساب خود کلیک کنید

Google Cloud IAM page for dolores-lab.com showing organization permissions and the Grant Access action

روی افزودن نقش دیگر کلیک کنید

Google Cloud IAM dialog assigning the Organization Administrator role for dolores-lab.com

مدیر خط‌مشی سازمان را جستجو کنید

Google Cloud IAM edit access dialog assigning the Organization Administrator role to a user

روی مدیر خط‌مشی سازمان کلیک کنید

Google Cloud IAM role picker with Organization Policy Administrator selected while editing access

روی ذخیره کلیک کنید

Google Cloud IAM access editor assigning Organization Administrator and Organization Policy Administrator roles

حساب شما اکنون مجوز فعال‌سازی ایجاد کلید حساب سرویس را دارد. ممکن است چند دقیقه طول بکشد تا اثر کند.

استفاده از نام مستعار ایمیل Google برای حفظ حساب‌های ایمیل متفاوت برای Google Workspace و ChatGPT

اگر ادمینی هستید که Google Workspace را با استفاده از راه‌اندازی مدیریت‌شده توسط ادمین برای کانکتورهای همگام‌شدهٔ Google Drive به فضای کاری ChatGPT خود متصل می‌کنید و سازمان شما از دامنه‌های ایمیل متفاوت برای ChatGPT و Google Workspace استفاده می‌کند، باید مراحل اضافی را انجام دهید تا مطمئن شوید کاربران می‌توانند با موفقیت به کانکتورهای همگام‌شدهٔ Google Drive دسترسی داشته باشند.

توصیه: هر زمان که ممکن است، از یک آدرس ایمیل اصلی یکسان برای هر دو حساب Google Workspace و ChatGPT استفاده کنید.

اگر این کار ممکن نیست، دستورالعمل‌های زیر را دنبال کنید تا یک alias ایمیل Google Workspace تنظیم کنید که با ایمیل ورود ChatGPT مطابقت داشته باشد.

مراحل افزودن نام مستعار Google Workspace

این مراحل را در کنسول ادمین Google دنبال کنید تا مطمئن شوید ایمیل ChatGPT هر کاربر می‌تواند به حساب Google Workspace او پیوند داده شود:

به کنسول ادمین بروید. مسیر زیر را دنبال کنید: Directory > Users

یک کاربر را انتخاب کنید، سپس «ADD ALTERNATIVE EMAILS» را انتخاب کنید.

Google Admin user details page with Add alternate emails action highlighted

یک ایمیل جایگزین اضافه کنید. مطمئن شوید با حساب ChatGPT کاربر مطابقت دارد.

Google Workspace Admin alternate email alias form with alias-testing-alt-email on bytesheaven.com

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

---

محدودیت‌های شناخته‌شده

آدرس‌های ایمیل شخصی پشتیبانی نمی‌شوند

کاربرانی که با آدرس‌های شخصی برای ChatGPT ثبت‌نام می‌کنند (برای مثال، example@gmail.com) نمی‌توانند به Google Workspace متصل شوند. این نوع راه‌اندازی پشتیبانی نمی‌شود و یک ریسک امنیتی ایجاد می‌کند، زیرا امکان دسترسی به داده‌های داخلی از خارج از سازمان را فراهم می‌کند.

Aliasهای Gmail با «+» پشتیبانی نمی‌شوند

Gmail به کاربران اجازه می‌دهد با افزودن «+» به آدرس خود alias ایجاد کنند (برای مثال، user+alias@gmail.com). این نوع aliasing با synced connectorهای Google Drive کار نمی‌کند. alias باید به‌صورت صریح در Google Workspace پیکربندی شده باشد.

پیام خطای رایج

اگر آدرس‌های ایمیل به‌درستی پیوند داده نشده باشند، کاربران ممکن است با این پیام مواجه شوند: «نتوانستیم حساب شما را به Google Drive متصل کنیم. برای کسب اطلاعات بیشتر کلیک کنید.»

اگر کاربران این پیام را دریافت کردند، مراحل این سند را مرور کنید و مطمئن شوید دقیقاً دنبال شده‌اند. اگر به کمک بیشتری نیاز است، لطفاً با تیم پشتیبانی ما تماس بگیرید.

Google Workspace - راه‌اندازی مدیریت‌شده توسط مدیر