السماح بالطلبات

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

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

نبذة عن بروتوكولات التفويض

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

السماح بالطلبات باستخدام OAuth 2.0

يجب أن يتم السماح بكل الطلبات المرسلة إلى واجهة برمجة التطبيقات للفهرسة بواسطة مستخدم مُصدَّق عليه.

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

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

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

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

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

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

نصيحة: يمكن لمكتبات عملاء Google APIs معالجة جزء من عملية السماح بالنيابة عنك. وتتوفر هذه المكتبات للعديد من لغات البرمجة، راجِع صفحة المكتبات والنماذج لمزيد من التفاصيل.

إرسال تعليقات حول...