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

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

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

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

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