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

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

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

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

  2. دوِّن معرّف العميل والسرية، ثم ارجع إلى هذه الصفحة.

إعداد مكتبة العملاء

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