Google: OAuth2 عمومی#

این سند شامل دستورالعمل‌هایی برای ساختن اعتبارنامه‌ی عمومی OAuth2 گوگل برای استفاده در عملیات سفارشی است.

/// یادداشت | راهنمای کاربران n98n کلود برای نودهای زیر، می‌توانید با انتخاب ورود با گوگل در بخش OAuth احراز هویت کنید:

تقویم گوگل
مخاطبین گوگل
درایو گوگل
ایمیل گوگل
گوگل شیتس
نود تریگر گوگل شیتس

وظایف گوگل ///

## پیش‌نیازها

* یک حساب [Google Cloud](https://cloud.google.com/) بسازید.

## راه‌اندازی OAuth

برای کانکشن اعتبارنامه‌ی n98n خود به خدمات گوگل، پنج مرحله وجود دارد:

1. [ایجاد پروژه در کنسول Google Cloud](#create-a-google-cloud-console-project).
1. [فعال‌سازی APIها](#enable-apis).
1. [پیکربندی صفحه رضایت OAuth](#configure-your-oauth-consent-screen).
1. [ساخت اعتبارنامه‌های کلاینت OAuth در گوگل](#create-your-google-oauth-client-credentials).
1. [تکمیل اعتبارنامه n98n خود](#finish-your-n8n-credential).

### ایجاد پروژه در کنسول Google Cloud

در ابتدای کار، یک پروژه در کنسول Google Cloud بسازید. اگر قبلا پروژه‌ای دارید، مستقیماً به [بخش بعدی](#enable-apis) بروید:


1. وارد حساب کاربری خود در [کنسول گوگل کلود](https://console.cloud.google.com) شوید.
2. در منوی بالای صفحه، منوی کشویی پروژه را در ناوبری بالا انتخاب کرده و **پروژه جدید** را انتخاب کنید یا مستقیم به صفحه [پروژه جدید](https://console.cloud.google.com/projectcreate) بروید.
3. یک **نام پروژه** وارد کنید و **مکان** پروژه خود را انتخاب کنید.
4. روی **ایجاد** کلیک کنید.
5. در ناوبری بالا بررسی کنید و مطمئن شوید که منوی کشویی پروژه، پروژه‌تان را انتخاب کرده است. اگر نه، پروژه‌ای که تازه ساخته‌اید را انتخاب کنید.

	<figure markdown="span">
	![منوی کشویی پروژه در ناوبری بالای کنسول گوگل کلود](/_images/integrations/builtin/credentials/google/google-cloud-project-dropdown.png)
	<figcaption>بررسی منوی کشویی پروژه در ناوبری بالای کنسول گوگل کلود</figcaption>
	</figure>

فعال‌سازی APIها#

بعد از ساخت پروژه، APIهایی را که نیاز دارید فعال کنید:

به کنسول گوگل کلود - کتابخانه مراجعه کنید. مطمئن شوید در پروژه صحیح قرار دارید.

پایین منوی پروژه در ناوبری بالای گوگل کلود — بررسی منوی پروژه در ناوبری بالا گوگل کلود

به رسانه‌ها و خدمات > کتابخانه بروید.
برای فعال‌سازی، API(ها) موردنظر خود را جستجو و انتخاب کنید. مثلا برای نود Gmail، جستجو و فعال‌سازی API gmail را انجام دهید.
برخی اینتگریشن‌ها نیازمند APIهای دیگر هستند یا باید درخواست دسترسی بدهید:
- دیدگاه گوگل: درخواست دسترسی API.
- تبلیغات گوگل: دریافت یک توکن توسعه‌دهنده.

نیاز به API گوگل درایو

اینتگریشن‌های زیر نیازمند API گوگل درایو و همچنین API خاص خود هستند:

* گوگل داکس
* گوگل شیتس
* گوگل سلایدز 
///

API هوش مصنوعی وکستر گوگل

علاوه بر API وکستر هوش مصنوعی، باید API مدیر منابع ابری را نیز فعال کنید.

///

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

### پیکربندی صفحه رضایت OAuth

اگر در پروژه گوگل کلود خود قبلاً از OAuth استفاده نکرده‌اید، باید [صفحه رضایت OAuth را پیکربندی کنید](https://developers.google.com/workspace/guides/configure-oauth-consent):

1. به [کنسول Google Cloud - کتابخانه](https://console.cloud.google.com/apis/library) بروید. مطمئن شوید در پروژه‌ی صحیح هستید.
	<figure markdown="span">
	![منوی انتخاب پروژه در ناوبری بالا در کنسول Google Cloud](/_images/integrations/builtin/credentials/google/google-cloud-project-dropdown.png)
	<figcaption>بررسی منوی انتخاب پروژه در ناوبری بالا در کنسول Google Cloud</figcaption>
	</figure>
1. منوی سمت چپ را باز کنید و به **APIs & Services > OAuth consent screen** بروید.
1. برای شروع تنظیم رضایت OAuth، روی **Get started** کلیک کنید.
1. نام **App** و ایمیل **User support** را وارد کنید تا در صفحه OAuth نمایش داده شوند.
1. برای **Audience**، گزینه **Internal** را برای دسترسی داخلی کاربران در فضای کاری Google سازمانتان یا **External** برای هر کاربری با حساب گوگل انتخاب کنید. برای اطلاعات بیشتر، به [مستندات نوع کاربر گوگل](https://support.google.com/cloud/answer/15549945?sjid=17061891731152303663-EU#user-type) مراجعه کنید.
1. ایمیل‌هایی که گوگل باید برای اطلاع‌رسانی درباره تغییرات در پروژه شما استفاده کند را انتخاب کنید.
1. سیاست داده‌های کاربر گوگل را مطالعه و تایید کنید و روی **Create** کلیک کنید.
1. در منوی سمت چپ، روی **Branding** کلیک کنید.
1. در بخش **Authorized domains**، گزینه **Add domain** را انتخاب کنید:
	* اگر در سرویس ابری n98n استفاده می‌کنید، `n8n.cloud` را اضافه کنید.
	* اگر [خود میزبان](/hosting) هستید، دامنه نود n98n خود را اضافه کنید.
1. در پایان صفحه روی **Save** کلیک کنید.

### ساخت اعتبارنامه‌های کلاینت OAuth در گوگل

در مرحله بعد، اعتبارنامه‌ی کلاینت OAuth را در گوگل بسازید:

1. در بخش **APIs & Services**، روی [**Credentials**](https://console.cloud.google.com/apis/credentials) کلیک کنید.
2. روی **+ Create credentials** > **OAuth client ID** کلیک کنید.
3. در فهرست **Application type**، گزینه **Web application** را انتخاب کنید.
4. نام **Name** به صورت خودکار تولید می‌شود. این نام را تغییر دهید تا در کنسول شناسایی کنید.
5. از اعتبارنامه n98n خود، **OAuth Redirect URL** را کپی کنید و در **Authorized redirect URIs** در کنسول Google قرار دهید.
6. روی **Create** کلیک کنید.

### تکمیل اعتبارنامه‌های n8n

با اتمام تنظیم پروژه و اعتبارنامه‌های گوگل، اعتبارنامه n98n خود را کامل کنید:

1. در پنجره **OAuth client created** گوگل، **Client ID** را کپی کنید و آن را در اعتبارنامه n98n وارد کنید.
2. در همان پنجره، **Client Secret** را کپی کنید و وارد کنید.
3. باید حوزه‌های (scopes) این اعتبارنامه را تعریف کنید. برای اطلاعات بیشتر به [Scopes](#scopes) مراجعه کنید. حوزه‌های متعدد را جدا با فاصله وارد کنید، مثلاً:
	```
	https://www.googleapis.com/auth/gmail.labels https://www.googleapis.com/auth/gmail.addons.current.action.compose
	```
4. در n8n، روی **Sign in with Google** کلیک کنید تا فرآیند احراز هویت گوگل کامل شود.
5. **ذخیره** کنید تا اعتبارنامه جدید فعال شود.

## ویدئو

در این ویدئو، مراحل توصیف‌شده در بالا نشان داده شده است:


<div class="video-container">
<iframe width="840" height="472.5" src="https://www.youtube.com/embed/gZ6N2H3_vys" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
</div>

## حوزه‌ها (Scopes)

خدمات گوگل دارای یک یا چند حوزه‌ی دسترسی ممکن هستند. یک حوزه محدود می‌کند کارهای کاربر چه باشد. برای فهرست حوزه‌ها برای کلیه سرویس‌ها، به [OAuth 2.0 Scopes for Google APIs](https://developers.google.com/identity/protocols/oauth2/scopes) مراجعه کنید.

n98n تمام حوزه‌ها را پشتیبانی نمی‌کند. هنگام ساخت یک اعتبار عمومی OAuth2 برای گوگل، می‌توانید حوزه‌ها را از فهرست **Supported scopes** زیر وارد کنید. اگر حوزه‌ای را وارد کنید که n98n از آن پشتیبانی نمی‌کند، کار نخواهد کرد.

??? جزئیات "حوزه‌های پشتیبانی‌شده"
	| سرویس | حوزه‌های موجود |
	|--------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
	| جیمیل | <ul><li>`https://www.googleapis.com/auth/gmail.labels`</li><li>`https://www.googleapis.com/auth/gmail.addons.current.action.compose`</li><li>`https://www.googleapis.com/auth/gmail.addons.current.message.action`</li><li>`https://mail.google.com/`</li><li>`https://www.googleapis.com/auth/gmail.modify`</li><li>`https://www.googleapis.com/auth/gmail.compose`</li></ul> |
	| تبلیغات گوگل | <ul><li>`https://www.googleapis.com/auth/adwords`</li></ul> |
	| گوگل آنالیتیکس | <ul><li>`https://www.googleapis.com/auth/analytics`</li><li>`https://www.googleapis.com/auth/analytics.readonly`</li></ul> |
	| بیگ‌کوئری گوگل | <ul><li>`https://www.googleapis.com/auth/bigquery`</li></ul> |
	| کتاب‌های گوگل | <ul><li>`https://www.googleapis.com/auth/books`</li></ul> |
	| تقویم گوگل | <ul><li>`https://www.googleapis.com/auth/calendar`</li><li>`https://www.googleapis.com/auth/calendar.events`</li></ul> |
	| ابری گوگل<br> زبان طبیعی | <ul><li>`https://www.googleapis.com/auth/cloud-language`</li><li>`https://www.googleapis.com/auth/cloud-platform`</li></ul> |
	| ابری گوگل<br>ذخیره‌سازی | <ul><li>`https://www.googleapis.com/auth/cloud-platform`</li><li>`https://www.googleapis.com/auth/cloud-platform.read-only`</li><li>`https://www.googleapis.com/auth/devstorage.full_control`</li><li>`https://www.googleapis.com/auth/devstorage.read_only`</li><li>`https://www.googleapis.com/auth/devstorage.read_write`</li></ul> |
	| مخاطبین گوگل | <ul><li>`https://www.googleapis.com/auth/contacts`</li></ul> |
	| مستندات گوگل | <ul><li>`https://www.googleapis.com/auth/documents`</li><li>`https://www.googleapis.com/auth/drive`</li><li>`https://www.googleapis.com/auth/drive.file`</li></ul> |
	| گوگل درایو | <ul><li>`https://www.googleapis.com/auth/drive`</li><li>`https://www.googleapis.com/auth/drive.appdata`</li><li>`https://www.googleapis.com/auth/drive.photos.readonly`</li></ul> |
	| فایربیس گوگل<br> Firestore ابری | <ul><li>`https://www.googleapis.com/auth/datastore`</li><li>`https://www.googleapis.com/auth/firebase`</li></ul> |
	| فایربیس گوگل<br> پایگاه داده‌های لحظه‌ای | <ul><li>`https://www.googleapis.com/auth/userinfo.email`</li><li>`https://www.googleapis.com/auth/firebase.database`</li><li>`https://www.googleapis.com/auth/firebase`</li></ul> |
	| Google Perspective | <ul><li>`https://www.googleapis.com/auth/userinfo.email`</li></ul> |
	| گوگل شیت | <ul><li>`https://www.googleapis.com/auth/drive.file`</li><li>`https://www.googleapis.com/auth/spreadsheets`</li></ul> |
	| گوگل اسلاید | <ul><li>`https://www.googleapis.com/auth/drive.file`</li><li>`https://www.googleapis.com/auth/presentations`</li></ul> |
	| گوگل تسک | <ul><li>`https://www.googleapis.com/auth/tasks`</li></ul> |
	| ترجمه گوگل | <ul><li>`https://www.googleapis.com/auth/cloud-translation`</li></ul> |
	| مدیر GSuite | <ul><li>`https://www.googleapis.com/auth/admin.directory.group`</li><li>`https://www.googleapis.com/auth/admin.directory.user`</li><li>`https://www.googleapis.com/auth/admin.directory.domain.readonly`</li><li>`https://www.googleapis.com/auth/admin.directory.userschema.readonly`</li></ul> |

## عیب‌یابی

### این‌که گوگل این‌اپ را تایید نکرده است


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

در صورت نیاز به استفاده از اعتبارنامه‌هایی که توسط حساب کاربری دیگری (توسط توسعه‌دهنده یا شخص ثالث دیگر) تولید شده است، دستورالعمل‌های موجود در [مستندساز Google Cloud | خطاهای مجوز: گوگل این برنامه را تأیید نکرده است](https://developers.google.com/nest/device-access/reference/errors/authorization#google_hasnt_verified_this_app){:target=_blank .external-link} را دنبال کنید.

اپلیکیشن گوگل در حال تبدیل به غیرفعال‌سازی است#

برای برنامه‌های Google Cloud با وضعیت انتشار در حال آزمایش و نوع کاربر مخاطب خارجی، مجوز و توکن‌ها پس از هفت روز منقضی می‌شوند. برای اطلاعات بیشتر به راهنمای کنسول Google Cloud Platform | تنظیم صفحه مجوز OAuth مراجعه کنید. برای رفع مشکل، برنامه را در حالت اعتبارنامه‌های n98n مجدد متصل کنید. ```