تدفقات OAuth على سطح المكتب وتطبيقات الويب

يرشدك هذا الدليل إلى كيفية إعداد OAuth2 للوصول إلى واجهة برمجة التطبيقات باستخدام بيانات الاعتماد الخاصة بك وإما تدفق سطح المكتب أو تدفق الويب. يجب تنفيذ هذه الخطوات مرة واحدة فقط، ما لم يتم إبطال النطاقات المسموح بها أو حذفها أو تغيير النطاقات المسموح بها لبيانات اعتماد OAuth2.

إنشاء بيانات اعتماد OAuth2

  1. اتّبِع الخطوات من أجل ضبط مشروع وحدة تحكّم Google API على واجهة Google Ads API.

  2. دوِّن Client ID وsecret ثم ارجع إلى هذه الصفحة.

إعداد مكتبة البرامج

  1. في وحدة طرفية، شغِّل مثال GenerateUserCredentials، الذي يطالبك بإدخال معرّف عميل OAuth2 وسره.

    هذا مثال تفاعلي يتطلّب منك إدخال إدخال.

    php GenerateUserCredentials.php
    
  2. يطالبك المثال بزيارة عنوان URL حيث ستحتاج إلى السماح لبيانات اعتماد OAuth2 بالوصول إلى حسابك في "إعلانات Google" نيابةً عنك.

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

    انتقِل إلى عنوان URL في جلسة متصفّح بخصوصيّة تامّة أو في نافذة التصفّح المتخفي. سجِّل الدخول بحساب Google نفسه الذي تستخدمه للوصول إلى "إعلانات Google". انقر على متابعة في شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth2.

    شاشة الموافقة

  3. يتم نقلك بعد ذلك إلى صفحة تحتوي على رسالة تشير إلى نجاح التفويض.

    تم استرجاع الرمز المميّز لإعادة التحميل. تحقق من ناتج وحدة التحكم للحصول على مزيد من التعليمات.

  4. ارجع إلى وحدة التحكم التي كنت تشغّل المثال فيها. من المفترض أن يكون المثال قد اكتمل ويعرض الرمز المميز للتحديث وبعض الإرشادات، متبوعًا بالخصائص التي ستحتاج إليها لإعداد مكتبة البرامج:

    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 = "****"