تدفقات 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 أو احفظه في مكان آخر لاستخدامه في حال إنشاء مثيل للمكتبة أثناء التشغيل.