استخدام OAuth

تتيح Places API (الإصدار الجديد) استخدام بروتوكول OAuth 2.0 للمصادقة. تتيح Google استخدام سيناريوهات OAuth 2.0 الشائعة، مثل سيناريوهات خادم الويب.

يوضّح هذا المستند كيفية تمرير رمز مميّز لبروتوكول OAuth إلى طلب Places API (الإصدار الجديد) في بيئة التطوير. للحصول على تعليمات حول استخدام OAuth في production (الإنتاج)، يُرجى مراجعة المصادقة في Google:

قبل البدء

قبل البدء في استخدام Places API (جديدة)، ستحتاج إلى مع حساب فوترة مع تفعيل Places API (جديدة). ننصحك بإنشاء عدة أصحاب مشاريع ومشرفي الفوترة، حتى يتوفّر لديك دائمًا شخص يمتلك هذين الدورين ويمكن لفريقك التواصل معه. للمزيد من المعلومات، يُرجى الاطّلاع على الإعداد في Cloud Console.

لمحة عن بروتوكول OAuth

هناك العديد من الطرق لإنشاء رموز الدخول وإدارتها من خلال OAuth بناءً على عملية النشر محددة.

على سبيل المثال، يتيح نظام Google OAuth 2.0 التفاعلات بين الخوادم، مثل تلك التي تتم بين تطبيقك وخدمة Google. لهذا السيناريو، تحتاج إلى حساب خدمة، والذي هو حساب ينتمي إلى تطبيقك بدلاً من مستخدم فردي. إنّ Google APIs بالنيابة عن حساب الخدمة، ولذلك لا يكون المستخدمون مشاركين بشكل مباشر. لمزيد من المعلومات عن طرق المصادقة، يُرجى الاطّلاع على المصادقة في Google.

بدلاً من ذلك، يمكنك استخدام Places API (الإصدار الجديد) كجزء من تطبيق Android أو iOS متوافق مع الأجهزة الجوّالة. للحصول على معلومات عامة عن استخدام OAuth مع Places API (الإصدار الجديد)، بما في ذلك معلومات عن إدارة الرموز المميّزة للوصول إلى بيئات النشر المختلفة، يُرجى الاطّلاع على استخدام OAuth 2.0 للوصول إلى Google APIs.

لمحة عن نطاقات OAuth

لاستخدام بروتوكول OAuth مع Places API (الإصدار الجديد)، يجب منح رمز OAuth المميّز النطاق التالي:

  • https://www.googleapis.com/auth/cloud-platform

مثال: تجربة طلبات البيانات من واجهة برمجة تطبيقات REST في بيئة التطوير المحلي

إذا كنت ترغب في تجربة واجهة برمجة تطبيقات الأماكن (جديدة) باستخدام رمز OAuth المميز، ولكن لا تتوفر لديك بيئة الإعداد لإنشاء رموز مميزة، يمكنك استخدام الإجراء الوارد في هذا القسم لإجراء الاتصال.

يوضح هذا المثال كيفية استخدام رمز OAuth المميز الذي يقدمه بيانات الاعتماد التلقائية للتطبيق (ADC) لإجراء المكالمة. للحصول على معلومات عن استخدام أداة "إدارة الاعتمادات" للاتصال بـ Google API باستخدام مكتبات العملاء، اطّلِع على مقالة المصادقة باستخدام مكتبات العملاء.

المتطلبات الأساسية

قبل أن تتمكّن من إرسال طلب REST باستخدام أداة ربط البيانات (ADC)، استخدِم Google Cloud CLI لتوفير بيانات الاعتماد لخدمة ADC:

  1. أنشئ مشروعًا وفعِّل الفوترة من خلال اتّباع الخطوات الواردة في، إذا لم يسبق لك ذلك. الإعداد في Google Cloud Console
  2. تثبيت gcloud CLI وإعداده

  3. شغِّل الأمر gcloud التالي على جهازك المحلي لإنشاءملف بيانات الاعتماد:

    gcloud auth application-default login
  4. تظهر شاشة تسجيل الدخول. بعد تسجيل الدخول، يتم تخزين بيانات الاعتماد في ملف بيانات الاعتماد المحلي الذي تستخدمه ADC.

لمزيد من المعلومات، يُرجى مراجعة بيئة تطوير محلي في تقديم بيانات الاعتماد الخاصة ببيانات الاعتماد التلقائية للتطبيق التوثيق.

تقديم طلب REST

في هذا المثال، يتمّ تمرير رأسَي طلب:

  • مرِّر رمز OAuth المميز في العنوان Authorization باستخدام ما يلي: لإنشاء الرمز المميز:

    gcloud auth application-default print-access-token

    للرمز المميز المعروض نطاق https://www.googleapis.com/auth/cloud-platform.

  • نقْل رقم تعريف أو اسم مشروعك على Google Cloud الذي تم تفعيل الفوترة فيه في عنوان X-Goog-User-Project. لمزيد من المعلومات، يُرجى مراجعة الإعداد في Cloud Console

يُجري المثال التالي طلبًا إلى Places API (الإصدار الجديد) باستخدام رمز OAuth المميّز:

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "X-Goog-FieldMask: places.displayName,places.formattedAddress" \
"https://places.googleapis.com/v1/places:searchText"

تحديد المشاكل وحلّها

إذا كان طلبك يعرض رسالة خطأ تفيد بأنّ واجهة برمجة التطبيقات هذه لا تتوافق مع بيانات اعتماد المستخدم النهائي، راجِع بيانات اعتماد المستخدم لا تعمل.