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

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

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

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

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

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

  1. در یک ترمینال، مثال کد GenerateUserCredentials را اجرا کنید، که از شما شناسه کلاینت OAuth 2.0 و رمز کلاینت شما را درخواست می‌کند.

    php GenerateUserCredentials.php
    
  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 روی ادامه کلیک کنید.

    صفحه رضایت OAuth 2.0

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

    Your refresh token has been fetched. Check the console output for further
    instructions.
    
  3. به کنسولی که در آن مثال کد را اجرا می‌کنید، برگردید. خواهید دید که مثال کد تکمیل شده و توکن به‌روزرسانی شما و برخی دستورالعمل‌ها را نمایش می‌دهد، و در ادامه دستورالعمل‌هایی که برای پیکربندی کتابخانه کلاینت باید دنبال کنید، آمده است:

    Your refresh token is: 1/Yw**********
    Copy the text below into a file named "google_ads_php.ini" in your home directory, and
      replace "INSERT_DEVELOPER_TOKEN_HERE" with your developer token:
    
    [GOOGLE_ADS]
    developerToken = "INSERT_DEVELOPER_TOKEN_HERE"
    [OAUTH2]
    Copy the following lines to your 'google_ads_php.ini' file:
    clientId = "***********************apps.googleusercontent.com"
    clientSecret = "****"
    refreshToken = "****"