زمین بازی OAuth

یکی از گزینه های تولید اعتبارنامه OAuth2 استفاده از OAuth2 Playground است. OAuth2 Playground، در ارتباط با کنسول Google Ads API، به شما امکان می دهد به صورت دستی توکن های OAuth2 ایجاد کنید.

OAuth2 Playground برای کاربرانی است که فقط باید به حساب‌های یک حساب مدیر یا کاربر Google Ads دسترسی داشته باشند. اگر نیاز به درخواست چند کاربر برای دریافت اعتبار دارید، احتمالاً بهتر است یک کتابخانه مشتری برای OAuth در Search Ads 360 پیکربندی کنید.

شناسه مشتری و راز مشتری دریافت کنید

هشدار: برای استفاده از OAuth2 Playground ، باید یک شناسه مشتری برای یک برنامه وب ایجاد کنید. این تنها نوع برنامه ای است که با OAuth2 Playground کار می کند. برای اطلاعات بیشتر به انتخاب نوع برنامه مراجعه کنید.

اگر پروژه ابری موجود ندارید:

1. صفحه Google API Console Credentials را باز کنید.

2. از منوی کشویی پروژه، یک پروژه موجود را انتخاب کنید یا یک پروژه جدید ایجاد کنید.

3. در صفحه Credentials، Create credentials را انتخاب کنید، سپس OAuth Client ID را انتخاب کنید.

4. در زیر نوع برنامه ، برنامه وب را انتخاب کنید.

5. در بخش URIهای مجاز تغییر مسیر ، یک خط با https://developers.google.com/oauthplayground اضافه کنید

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

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

اگر یک پروژه ابری موجود دارید، می توانید با تنظیم URI های مجاز تغییر مسیر مانند بالا از آن مجددا استفاده کنید.

توکن تولید کنید

هشدار: کاربر Search Ads 360 که در مرورگر خود به سیستم وارد شده‌اید، تعیین می‌کند که با اعتبارنامه OAuth2 که ایجاد می‌کنید به کدام حساب‌ها دسترسی خواهید داشت. بنابراین، ممکن است بخواهید این مراحل را در یک پنجره ناشناس یا زمانی که به حساب Search Ads 360 خود وارد نشده‌اید انجام دهید، زیرا به احتمال زیاد کاربری که می‌خواهید از اعتبارنامه‌اش استفاده کنید، همان کاربری نباشد که به سیستم وارد شده‌اید. مانند زمانی که شناسه مشتری و راز را دریافت کردید.

1. به زمین بازی OAuth2 بروید، (با استفاده از این پیوند باید برخی از مقادیر کلیدی را از قبل برای شما پر کند).

2. روی نماد چرخ دنده کلیک کنید در گوشه سمت راست بالا و کادر با عنوان Use your own OAuth credentials را علامت بزنید (اگر قبلاً علامت زده نشده باشد).

3. اطمینان حاصل کنید که:

   • جریان OAuth روی سمت سرور تنظیم شده است.
   • نوع دسترسی روی آفلاین تنظیم شده است (این تضمین می کند که به جای یک نشانه دسترسی، یک نشانه تازه سازی و یک نشانه دسترسی دریافت می کنید).

4. شناسه مشتری OAuth2 و راز سرویس گیرنده OAuth2 را که در بالا به دست آورده اید وارد کنید.

   

5. در بخش با عنوان مرحله 1 - انتخاب و مجوز APIها ، روی Search Ads 360 Reporting API از لیست کلیک کنید و محدوده آن را انتخاب کنید، https://www.googleapis.com/auth/doubleclicksearch . سپس روی Authorize APIs کلیک کنید:

   

6. در صورت درخواست، وارد حسابی شوید که می‌خواهید به آن دسترسی و مجوز بدهید. در غیر این صورت، تأیید کنید که کاربر فعلی در گوشه بالا سمت راست، مشتری یا حساب مدیری است که می‌خواهید اعتبارنامه را برای آن به دست آورید.

   اگر فقط چند دقیقه پیش شناسه مشتری و راز خود را دریافت کردید و با خطایی مانند Error: redirect_uri_mismatch مواجه شدید، ممکن است تغییراتی که ایجاد کرده اید منتشر نشده باشد. روی دکمه برگشت در مرورگر خود کلیک کنید، چند دقیقه صبر کنید، سپس دوباره روی Authorize APIs کلیک کنید.
   اگر با خطایی مواجه شدید مبنی بر اینکه برنامه‌نویس به شما اجازه دسترسی نداده است و برنامه در حال آزمایش است، باید از صفحه نمایش رضایت OAuth در پروژه GCP خود بازدید کنید و یکی از موارد زیر را انجام دهید:

   • اپلیکیشن را منتشر کنید.

   • برنامه را در وضعیت تست نگه دارید و خود را به عنوان کاربر آزمایشی اضافه کنید.

7. درخواستی ظاهر می‌شود که نشان می‌دهد برنامه شما می‌خواهد کمپین‌های Search Ads 360 شما را مدیریت کند . برای ادامه روی Accept کلیک کنید.

8. در برگه با برچسب مرحله 2 - کد مجوز مبادله برای توکن ها ، یک کد مجوز باید ظاهر شود. روی کد مجوز تبادل برای توکن‌ها کلیک کنید.

   

9. اگر همه چیز خوب پیش برود، رمز Refresh و نشانه دسترسی باید برای شما پر شود (شاید مجبور شوید مرحله 2 - کد مجوز تبادل برای توکن ها را دوباره گسترش دهید):

   

10. کد Refresh را به همراه شناسه مشتری و راز سرویس گیرنده در فایل پیکربندی کتابخانه مشتری انتخابی خود کپی کنید.

11. یک کتابخانه سرویس گیرنده برای OAuth در Search Ads 360 Reporting API پیکربندی کنید .

OAuth2 Playground را از شناسه مشتری خود حذف کنید

اکنون که یک نشانه به‌روزرسانی دارید، دیگر نیازی به OAuth2 Playground ندارید تا یک URI تغییر مسیر مجاز باشد. برای حذف آن از لیست URI های مجاز تغییر مسیر:

1. به صفحه Google API Console Credentials بروید.

2. از منوی کشویی پروژه، پروژه خود را انتخاب کنید.

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

4. https://developers.google.com/oauthplayground از URIهای مجاز تغییر مسیر حذف کنید. توجه داشته باشید که باید حداقل یک URI تغییر مسیر را در محل خود بگذارید.

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

،

یکی از گزینه های تولید اعتبارنامه OAuth2 استفاده از OAuth2 Playground است. OAuth2 Playground، در ارتباط با کنسول Google Ads API، به شما امکان می دهد به صورت دستی توکن های OAuth2 ایجاد کنید.

OAuth2 Playground برای کاربرانی است که فقط باید به حساب‌های یک حساب مدیر یا کاربر Google Ads دسترسی داشته باشند. اگر نیاز به درخواست چند کاربر برای دریافت اعتبار دارید، احتمالاً بهتر است یک کتابخانه مشتری برای OAuth در Search Ads 360 پیکربندی کنید.

شناسه مشتری و راز مشتری دریافت کنید

هشدار: برای استفاده از OAuth2 Playground ، باید یک شناسه مشتری برای یک برنامه وب ایجاد کنید. این تنها نوع برنامه ای است که با OAuth2 Playground کار می کند. برای اطلاعات بیشتر به انتخاب نوع برنامه مراجعه کنید.

اگر پروژه ابری موجود ندارید:

1. صفحه Google API Console Credentials را باز کنید.

2. از منوی کشویی پروژه، یک پروژه موجود را انتخاب کنید یا یک پروژه جدید ایجاد کنید.

3. در صفحه Credentials، Create credentials را انتخاب کنید، سپس OAuth Client ID را انتخاب کنید.

4. در زیر نوع برنامه ، برنامه وب را انتخاب کنید.

5. در بخش URIهای مجاز تغییر مسیر ، یک خط با https://developers.google.com/oauthplayground اضافه کنید

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

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

اگر یک پروژه ابری موجود دارید، می توانید با تنظیم URI های مجاز تغییر مسیر مانند بالا از آن مجددا استفاده کنید.

توکن تولید کنید

هشدار: کاربر Search Ads 360 که در مرورگر خود به سیستم وارد شده‌اید، تعیین می‌کند که با اعتبارنامه OAuth2 که ایجاد می‌کنید به کدام حساب‌ها دسترسی خواهید داشت. بنابراین، ممکن است بخواهید این مراحل را در یک پنجره ناشناس یا زمانی که به حساب Search Ads 360 خود وارد نشده‌اید انجام دهید، زیرا به احتمال زیاد کاربری که می‌خواهید از اعتبارنامه‌اش استفاده کنید، همان کاربری نباشد که به سیستم وارد شده‌اید. مانند زمانی که شناسه مشتری و راز را دریافت کردید.

1. به زمین بازی OAuth2 بروید، (با استفاده از این پیوند باید برخی از مقادیر کلیدی را از قبل برای شما پر کند).

2. روی نماد چرخ دنده کلیک کنید در گوشه سمت راست بالا و کادر با عنوان Use your own OAuth credentials را علامت بزنید (اگر قبلاً علامت زده نشده باشد).

3. اطمینان حاصل کنید که:

   • جریان OAuth روی سمت سرور تنظیم شده است.
   • نوع دسترسی روی آفلاین تنظیم شده است (این تضمین می کند که به جای یک نشانه دسترسی، یک نشانه تازه سازی و یک نشانه دسترسی دریافت می کنید).

4. شناسه مشتری OAuth2 و راز سرویس گیرنده OAuth2 را که در بالا به دست آورده اید وارد کنید.

   

5. در بخش با عنوان مرحله 1 - انتخاب و مجوز APIها ، روی Search Ads 360 Reporting API از لیست کلیک کنید و محدوده آن را انتخاب کنید، https://www.googleapis.com/auth/doubleclicksearch . سپس روی Authorize APIs کلیک کنید:

   

6. در صورت درخواست، وارد حسابی شوید که می‌خواهید به آن دسترسی و مجوز بدهید. در غیر این صورت، تأیید کنید که کاربر فعلی در گوشه بالا سمت راست، مشتری یا حساب مدیری است که می‌خواهید اعتبارنامه را برای آن به دست آورید.

   اگر فقط چند دقیقه پیش شناسه مشتری و راز خود را دریافت کردید و با خطایی مانند Error: redirect_uri_mismatch مواجه شدید، ممکن است تغییراتی که ایجاد کرده اید منتشر نشده باشد. روی دکمه برگشت در مرورگر خود کلیک کنید، چند دقیقه صبر کنید، سپس دوباره روی Authorize APIs کلیک کنید.
   اگر با خطایی مواجه شدید مبنی بر اینکه برنامه‌نویس به شما اجازه دسترسی نداده است و برنامه در حال آزمایش است، باید از صفحه نمایش رضایت OAuth در پروژه GCP خود بازدید کنید و یکی از موارد زیر را انجام دهید:

   • اپلیکیشن را منتشر کنید.

   • برنامه را در وضعیت تست نگه دارید و خود را به عنوان کاربر آزمایشی اضافه کنید.

7. درخواستی ظاهر می‌شود که نشان می‌دهد برنامه شما می‌خواهد کمپین‌های Search Ads 360 شما را مدیریت کند . برای ادامه روی Accept کلیک کنید.

8. در برگه با برچسب مرحله 2 - کد مجوز مبادله برای توکن ها ، یک کد مجوز باید ظاهر شود. روی کد مجوز تبادل برای توکن‌ها کلیک کنید.

   

9. اگر همه چیز خوب پیش برود، رمز Refresh و نشانه دسترسی باید برای شما پر شود (شاید مجبور شوید مرحله 2 - کد مجوز تبادل برای توکن ها را دوباره گسترش دهید):

   

10. کد Refresh را به همراه شناسه مشتری و راز سرویس گیرنده در فایل پیکربندی کتابخانه مشتری انتخابی خود کپی کنید.

11. یک کتابخانه سرویس گیرنده برای OAuth در Search Ads 360 Reporting API پیکربندی کنید .

OAuth2 Playground را از شناسه مشتری خود حذف کنید

اکنون که یک نشانه به‌روزرسانی دارید، دیگر نیازی به OAuth2 Playground ندارید تا یک URI تغییر مسیر مجاز باشد. برای حذف آن از لیست URI های مجاز تغییر مسیر:

1. به صفحه Google API Console Credentials بروید.

2. از منوی کشویی پروژه، پروژه خود را انتخاب کنید.

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

4. https://developers.google.com/oauthplayground از URIهای مجاز تغییر مسیر حذف کنید. توجه داشته باشید که باید حداقل یک URI تغییر مسیر را در محل خود بگذارید.

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