برای دریافت اعتبارنامه Google (Client ID و Client Secret) برای استفاده از Google Drive با آدرس تغییر مسیر OAuth زیر (https://n8n2.recybers.com/rest/oauth2-credential/callback)، مراحل زیر را دنبال کنید:
مرحله 1: ورود به Google Cloud Console
- به وب‌سایت Google Cloud Console بروید: https://console.cloud.google.com/
- با حساب Google خود وارد شوید.
مرحله 2: ایجاد یا انتخاب پروژه
- اگر قبلاً پروژه دارید:
- از منوی کشویی بالای صفحه (کنار نام Google Cloud Platform)، پروژه مورد نظر خود را انتخاب کنید.
- اگر پروژه ندارید:
- روی "ایجاد پروژه" یا "Create Project" کلیک کنید.
- یک نام برای پروژه خود وارد کنید.
- سازمان (Organization) و مکان (Location) را در صورت نیاز انتخاب کنید (اختیاری).
- روی "ایجاد" یا "Create" کلیک کنید.
مرحله 3: فعال کردن Google Drive API
- پس از ایجاد یا انتخاب پروژه، در نوار جستجوی بالای صفحه، عبارت "API Library" را جستجو کنید و روی نتیجه "API Library" کلیک کنید.
- در صفحه "API Library"، در نوار جستجو عبارت "Google Drive API" را جستجو کنید.
- روی نتیجه "Google Drive API" کلیک کنید.
- در صفحه Google Drive API، روی دکمه "فعال کردن" یا "Enable" کلیک کنید. منتظر بمانید تا API فعال شود.
مرحله 4: پیکربندی صفحه رضایت OAuth (OAuth consent screen)
- در منوی سمت چپ، به "APIs & Services" بروید و سپس روی "OAuth consent screen" کلیک کنید.
- در قسمت "User type"، نوع کاربری را انتخاب کنید:
- Internal: اگر فقط کاربران داخل سازمان Google Workspace شما به این برنامه دسترسی خواهند داشت.
- External: اگر کاربران خارج از سازمان شما (عموم مردم) به این برنامه دسترسی خواهند داشت. (در بیشتر موارد برای استفاده شخصی یا تیمی کوچک مناسب است)
روی "ایجاد" یا "Create" کلیک کنید.
در صفحه پیکربندی صفحه رضایت:
- App name: یک نام برای برنامه خود وارد کنید. این نام به کاربران در هنگام درخواست دسترسی نمایش داده می‌شود.
- User support email: یک ایمیل پشتیبانی برای کاربران خود وارد کنید.
- App domain: اگر دامنه وب‌سایت دارید، آن را وارد کنید (اختیاری).
- Developer contact information: آدرس ایمیل خود را در قسمت "Email addresses" وارد کنید.
(در صورت نیاز) بخش‌های "Scopes" و "Optional info" را بررسی کنید. برای دسترسی به Google Drive، معمولاً نیازی به پیکربندی خاصی در این بخش‌ها در این مرحله نیست (scopes در مرحله بعدی تعیین می‌شوند).
روی "ذخیره و ادامه" یا "Save and Continue" کلیک کنید.
(در صورت نیاز) در صفحه "Scopes"، روی "Add or Remove Scopes" کلیک کنید و مطمئن شوید که scope های مربوط به Google Drive (مانند .../auth/drive یا .../auth/drive.file) انتخاب شده‌اند. اگر نیاز دارید فقط به فایل‌های ایجاد شده توسط برنامه خود دسترسی داشته باشید، scope مناسب را انتخاب کنید. برای استفاده عمومی Google Drive، scope .../auth/drive کافی است.
روی "ذخیره و ادامه" یا "Save and Continue" کلیک کنید.
(در صورت نیاز) در صفحه "Test users"، می‌توانید کاربران آزمایشی را اضافه کنید (اختیاری، معمولاً برای برنامه‌های "External" در فاز توسعه).
روی "ذخیره و ادامه" یا "Save and Continue" کلیک کنید.
در صفحه "Summary"، تنظیمات خود را مرور کنید و روی "Back to Dashboard" کلیک کنید.
مرحله 5: ایجاد اعتبارنامه OAuth 2.0
- در منوی سمت چپ، به "APIs & Services" بروید و سپس روی "Credentials" کلیک کنید.
- روی "+ CREATE CREDENTIALS" کلیک کنید و "OAuth client ID" را انتخاب کنید.
- در قسمت "Application type"، "Web application" را انتخاب کنید.
- یک نام برای اعتبارنامه خود در قسمت "Name" وارد کنید (مثلاً "n8n Google Drive Credential").
- در قسمت "Authorized redirect URIs"، روی "+ Add URI" کلیک کنید و آدرس تغییر مسیر OAuth ارائه شده در n8n خود را وارد کنید:
"https://n8n.example.com/rest/oauth2-credential/callback" - روی دکمه "ایجاد" یا "Create" کلیک کنید.
مرحله 6: دریافت Client ID و Client Secret
- پس از ایجاد اعتبارنامه، پنجره‌ای باز می‌شود که "Client ID" و "Client secret" شما را نشان می‌دهد.
- این مقادیر را کپی کرده و در مکانی امن ذخیره کنید. شما به این مقادیر برای پیکربندی Google Drive credential در n8n نیاز خواهید داشت.
- روی "OK" کلیک کنید.
مرحله 7: بررسی و انتشار برنامه
- در صفحه "OAuth consent screen"، از منوی "Audience" به دنبال بخش "Publishing status" بگردید.
- اگر وضعیت "Testing" را مشاهده می‌کنید، برنامه شما هنوز در حالت آزمایشی است و فقط برای کاربران آزمایشی که در بخش "Test users" اضافه کرده‌اید قابل دسترس است.
- برای انتشار برنامه و دسترسی همگان به آن، باید آن را از حالت "Testing" به "Production" تغییر دهید.
مرحله 3:
- در بخش "Publishing status"، روی دکمه "PUBLISH APP" (یا "Publish app" یا "انتشار برنامه") کلیک کنید. (ممکن است متن دکمه کمی متفاوت باشد.)
- یک پنجره تأیید باز می‌شود که از شما می‌پرسد آیا مطمئن هستید که می‌خواهید برنامه را منتشر کنید.
- روی "CONFIRM" (یا "Confirm" یا "تأیید") کلیک کنید.
مرحله 7: استفاده از Credentials در n8n
- در n8n، به بخش Credentials بروید و یک Credential جدید از نوع "Google OAuth2" ایجاد کنید.
- نامی برای Credential خود انتخاب کنید.
- "Client ID" و "Client Secret" که در مرحله 6 دریافت کردید را در فیلدهای مربوطه وارد کنید.
- "Authorization URL" را به https://accounts.google.com/o/oauth2/auth و "Access Token URL" را به https://oauth2.googleapis.com/token تنظیم کنید (به طور پیش فرض در n8n تنظیم شده‌اند).
- "Scope" های مورد نیاز برای Google Drive را مشخص کنید (مثلاً https://www.googleapis.com/auth/drive). می‌توانید scopes های بیشتر را با کاما جدا کنید.
- روی "ذخیره Credential" کلیک کنید.
- اکنون می‌توانید از این Credential در گره‌های Google Drive در n8n استفاده کنید.
نکات مهم:
- امنیت Client Secret: Client Secret را به دقت نگهداری کنید و آن را در مکان‌های عمومی (مانند کد منبع عمومی) قرار ندهید.
- آدرس Redirect URI: اطمینان حاصل کنید که آدرس Redirect URI دقیقاً مطابق با آدرس ارائه شده (https://n8n2.recybers.com/rest/oauth2-credential/callback) باشد. هرگونه اشتباه در این آدرس باعث عدم کارکرد OAuth خواهد شد.
- Scopes: Scopes مجوزهایی هستند که برنامه شما از کاربر درخواست می‌کند. scopes مناسب را بر اساس نیازهای برنامه خود انتخاب کنید. scope https://www.googleapis.com/auth/drive دسترسی کامل به Google Drive کاربر را می‌دهد. scopes های محدودتر مانند https://www.googleapis.com/auth/drive.file فقط دسترسی به فایل‌های ایجاد شده توسط برنامه را می‌دهند.
- وضعیت انتشار برنامه: اگر نوع کاربری "External" را انتخاب کرده‌اید، برنامه شما در ابتدا در وضعیت "Testing" خواهد بود. تا زمانی که برنامه را برای انتشار (Publish) بررسی و تایید نکنید، فقط کاربران آزمایشی که در صفحه "OAuth consent screen" اضافه کرده‌اید می‌توانند از آن استفاده کنند. برای استفاده عمومی، باید برنامه را منتشر کنید.