الموافقة على الطلبات

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

يجب أن يتضمن كل طلب يرسله تطبيقك إلى واجهة برمجة تطبيقات إدارة عرض السعر رمزًا مميزًا للتفويض. يحدّد الرمز المميّز التطبيق أيضًا لمحرّك البحث Google.

لمحة عن بروتوكولات الموافقة على الطلبات

يجب أن يستخدم تطبيقك OAuth 2.0 للسماح بالطلبات. ولا يُسمح باستخدام أي بروتوكولات أخرى للموافقة على الطلبات. إذا كان تطبيقك يستخدم تسجيل الدخول بحساب Google، سيتم التعامل مع بعض جوانب التفويض نيابةً عنك.

الموافقة على الطلبات باستخدام OAuth 2.0

ويجب أن يسمح مستخدم تمت مصادقته بإجراء طلبات معيّنة بشأن واجهة برمجة التطبيقات لإدارة عرض السعر.

تختلف تفاصيل عملية التفويض أو "flow;&&;; بالنسبة إلى OAuth 2.0 إلى حد ما حسب نوع التطبيق الذي تكتبه. وتسري العملية العامة التالية على جميع أنواع التطبيقات:

  1. عند إنشاء تطبيقك، عليك تسجيله باستخدام وحدة التحكم في واجهة Google API. وبعد ذلك، توفّر Google المعلومات التي ستحتاج إليها لاحقًا، مثل معرِّف العميل وسر العميل.
  2. أرسِل طلب مراجعة OAuth لتطبيقك للوصول إلى نطاق واجهة برمجة التطبيقات Manager Manager.
  3. فعِّل واجهة برمجة تطبيقات إدارة عرض السعر في وحدة تحكم واجهة برمجة تطبيقات Google. (إذا لم تكن واجهة برمجة التطبيقات مُدرَجة في وحدة تحكّم واجهة برمجة التطبيقات، يمكنك تخطّي هذه الخطوة).
  4. عندما يحتاج تطبيقك إلى الوصول إلى بيانات المستخدم، يطلب من Google نطاقًا معيّنًا من الوصول.
  5. يعرض محرّك البحث Google شاشة موافقة للمستخدم، تطلب منه تفويض تطبيقك بالوصول إلى بعض بياناته.
  6. إذا وافق المستخدم، ستمنح Google تطبيقك رمز دخول قصير الأجل.
  7. يطلب تطبيقك بيانات المستخدمين، مع إرفاق رمز الدخول بالطلب.
  8. يعرض Google البيانات المطلوبة بعد تحققه من صلاحية طلبك ورمز الدخول.

وتتضمّن بعض المسارات خطوات إضافية، مثل استخدام إعادة تحميل الرموز المميّزة للحصول على رموز دخول جديدة. للحصول على معلومات تفصيلية عن التدفقات في أنواع مختلفة من التطبيقات، يُرجى الاطّلاع على وثائق OAuth 2.0 على Google.

نطاق OAuth

في ما يلي معلومات حول نطاق OAuth 2.0 في واجهة برمجة التطبيقات لإدارة عرض السعر:

النطاق المعنى
https://www.googleapis.com/auth/doubleclickbidmanager الإذن بالقراءة/الكتابة

لطلب الوصول باستخدام OAuth 2.0، يحتاج تطبيقك إلى معلومات النطاق، بالإضافة إلى المعلومات التي يوفّرها Google عند تسجيل التطبيق (مثل معرِّف العميل وسر العميل).