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

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

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

1. اتّبِع الخطوات لضبط مشروع وحدة تحكّم واجهة برمجة تطبيقات Google من أجل 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 = "****"