پرش به محتویات

Google: سرویس تنها OAuth2#

این سند شامل دستورالعمل‌هایی برای ایجاد اعتبارنامه‌ Google برای یک سرویس واحد است. همچنین به صورت ویدیو در دسترس است.

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

  • تقویم گوگل
  • مخاطبین گوگل
  • درایو گوگل
  • ایمیل گوگل
  • گوگل شیتس
  • نود تریگر گوگل شیتس
  • وظایف گوگل /// 
     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
    ## پیش‌نیازها

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

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

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

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هایی که نیاز دارید را فعال کنید:

  1. به کنسول گوگل کلود - کتابخانه مراجعه کنید. مطمئن شوید در پروژه صحیح قرار دارید.
پایین منوی پروژه در ناوبری بالای گوگل کلود
بررسی منوی پروژه در ناوبری بالا گوگل کلود
  1. به رسانه‌ها و خدمات > کتابخانه بروید.
  2. برای فعال‌سازی، API(ها) موردنظر خود را جستجو و انتخاب کنید. مثلا برای نود Gmail، جستجو و فعال‌سازی API gmail را انجام دهید.
  3. برخی اینتگریشن‌ها نیازمند APIهای دیگر هستند یا باید درخواست دسترسی بدهید:

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

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

1
2
3
4
* گوگل داکس
* گوگل شیتس
* گوگل سلایدز 
///

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

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

1
///
  1. بر روی فعال‌سازی کلیک کنید. 
     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
    ### پیکربندی صفحه رضایت OAuth

اگر قبلاً در پروژه Google Cloud خود از 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. منوی ناوبری سمت چپ را باز کنید و به **APIها و سرویس‌ها > صفحه رضایت OAuth** بروید.
1. بر روی **شروع کنید** کلیک کنید تا تنظیمات رضایت OAuth آغاز شود.
1. نام برنامه (App name) و ایمیل پشتیبانی کاربر را وارد کنید تا در صفحه OAuth نمایش داده شود.
1. برای **مخاطب (Audience)**، گزینه **داخلی (Internal)** را برای دسترسی کاربران در داخل فضای کاری Google سازمان خود انتخاب کنید یا **خارجی (External)** برای هر کاربر با حساب Google. برای اطلاعات بیشتر، به [مستندات نوع کاربر گوگل](https://support.google.com/cloud/answer/15549945?sjid=17061891731152303663-EU#user-type) مراجعه کنید.
1. آدرس‌های ایمیلی که گوگل باید برای شما درباره تغییرات پروژه‌تان تماس بگیرد را انتخاب کنید.
1. سیاست‌های کاربر داده‌های گوگل را مطالعه و قبول کنید و بر روی **ایجاد** کلیک کنید.
1. در منوی سمت چپ، بر روی **Branding** کلیک کنید.
1. در بخش **دامنه‌های مجاز (Authorized domains)**، بر روی **افزودن دامنه (Add domain)** کلیک کنید:
	* اگر از سرویس ابری n98n استفاده می‌کنید، `n8n.cloud` را اضافه کنید.
	* اگر [خود میزبانی](#self-hosting) می‌کنید، دامنه اینستنس n98n خود را وارد کنید.
1. در پایین صفحه، بر روی **ذخیره (Save)** کلیک کنید.

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

در مرحله بعد، در Google کلاینت OAuth را ایجاد کنید:

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

### تکمیل اعتبار n98n شما

پس از پیکربندی کامل پروژه و اعتبارنامه‌های Google، n98n را تکمیل کنید:

1. از مودال **کلاینت OAuth ایجاد شده در Google**، **شناسه کلاینت (Client ID)** را کپی کنید. این را در اعتبار n98n خود وارد کنید.
2. از همان مودال Google، **رمز کلاینت (Client Secret)** را کپی کنید و در اعتبار n98n وارد کنید.
2. در n98n، بر روی **ورود با Google (Sign in with Google)** کلیک کنید تا فرآیند احراز هویت Google شما کامل شود.
3. اعتبارنامه‌های جدید خود را **ذخیره (Save)** کنید.

## ویدیو

<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>

## عیب‌یابی

### این برنامه توسط Google تأیید نشده است


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