جریان های برنامه های کاربردی وب و دسکتاپ OAuth

این راهنما به شما نحوه تنظیم OAuth 2.0 برای دسترسی به API با استفاده از اعتبارنامه‌های خودتان و یا جریان دسکتاپ یا جریان وب را آموزش می‌دهد. این مراحل فقط یک بار باید انجام شوند، مگر اینکه دامنه‌های مجاز برای اعتبارنامه‌های OAuth 2.0 خود را لغو، حذف یا نیاز به تغییر داشته باشید.

ایجاد اعتبارنامه‌های OAuth 2.0

1. مراحل پیکربندی یک پروژه کنسول API گوگل برای API تبلیغات گوگل را دنبال کنید.

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

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

1. در یک ترمینال، مثال generate_user_credentials.pl را اجرا کنید. می‌توانید مقادیر INSERT_XXX_HERE را در مثال قبل از اجرا تغییر دهید یا از آرگومان‌های خط فرمان -client_id برای شناسه کلاینت و -client_secret برای راز کلاینت استفاده کنید.

   perl generate_user_credentials.pl -client_id {client_id} -client_secret {client_secret}
   

2. این نمونه کد شما را به بازدید از یک URL ترغیب می‌کند که در آن باید به برنامه اجازه دهید از طرف شما به حساب Google Ads شما دسترسی پیدا کند.

   Paste this url in your browser:
   https://accounts.google.com/o/oauth2/v2/auth?response_type=code&access_type=offline&client_id=...
   

   در یک جلسه مرورگر خصوصی یا یک پنجره ناشناس به URL بروید. با حساب گوگلی که برای دسترسی به Google Ads استفاده می‌کنید، وارد شوید. معمولاً این یک ایمیل ورود به حساب مدیریت Google Ads است که شامل تمام حساب‌هایی است که باید تحت سلسله مراتب حساب‌های خود مدیریت کنید. در صفحه رضایت OAuth 2.0 روی ادامه کلیک کنید.

   

   به صفحه‌ای هدایت می‌شوید که پیامی مبنی بر موفقیت‌آمیز بودن مجوز در آن نمایش داده می‌شود.

   Authorization code was successfully retrieved.
   

3. به کنسولی که در آن مثال کد را اجرا می‌کنید، برگردید. خواهید دید که مثال کد تکمیل شده و توکن به‌روزرسانی شما و برخی دستورالعمل‌ها را نمایش می‌دهد، و در ادامه دستورالعمل‌هایی که برای پیکربندی کتابخانه کلاینت باید دنبال کنید، آمده است:

   Replace the following keys and values in your googleads.properties configuration file:
   
   clientId==***********************apps.googleusercontent.com
   clientSecret=****
   refreshToken=****

4. برای خاتمه دادن به فرآیند، Ctrl + C فشار دهید. سپس توکن refresh تولید شده را به همراه شناسه کلاینت و رمز کلاینت در فایل googleads.properties خود کپی کنید یا آن را در جای دیگری ذخیره کنید تا در صورت نمونه‌سازی کتابخانه در زمان اجرا، از آن استفاده کنید.