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

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

إنشاء بيانات اعتماد OAuth 2.0

  1. اتّبِع الخطوات لضبط مشروع على Google API Console من أجل Google Ads API.

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

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

  1. في الوحدة الطرفية، شغِّل المثال generate_user_credentials.pl. يمكنك إما تعديل قيم INSERT_XXX_HERE في المثال قبل التشغيل أو استخدام وسيطات سطر الأوامر -client_id لمعرّف العميل و-client_secret لسر العميل.

    perl generate_user_credentials.pl -client_id {client_id} -client_secret {client_secret}

  2. يطلب منك مثال الرمز البرمجي هذا الانتقال إلى عنوان URL حيث يجب أن تمنح التطبيق الإذن بالوصول إلى حسابك على "إعلانات 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". عادةً، يكون هذا العنوان هو عنوان البريد الإلكتروني لتسجيل الدخول إلى حساب إداري على "إعلانات Google" يحتوي على جميع الحسابات التي تحتاج إلى إدارتها ضمن التدرّج الهرمي للحساب. انقر على متابعة في شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth 2.0.

    شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth 2.0

    سيتم توجيهك إلى صفحة تتضمّن رسالة تشير إلى أنّ عملية التفويض تمت بنجاح.

    Authorization code was successfully retrieved.

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

    Replace the following keys and values in your googleads.properties configuration file:

clientId==***********************apps.googleusercontent.com
clientSecret=****
refreshToken=****

  4. اضغط على Ctrl + C لإنهاء العملية. بعد ذلك، انسخ رمز التحديث الذي تم إنشاؤه مع معرّف العميل وسر العميل إلى ملف googleads.properties أو احفظه في مكان آخر لاستخدامه عند إنشاء مثيل للمكتبة في وقت التشغيل.