إذا كنت تخطّط لإجراء عملية تكامل مع "مساعد Google"، يمكنك الاطّلاع على وحدة تحكّم "المهام مع مساعد Google".
بخلاف ذلك، قبل إضافة تفويض OAuth 2.0 إلى خدمتك، عليك تجهيز المعلومات التالية والتواصل مع ممثل علاقات المطوّرين أو تطوير الأعمال:
عنوان URL لنقطة نهاية التفويض هذا هو عنوان URL لنقطة نهاية التفويض التي تستضيفها والتي ترسل إليها Google الطلبات. يجب قبول الزيارات عبر HTTPS فقط. على سبيل المثال،
https://myservice.example.com/auth
. في كثير من الأحيان، يمكن تعديل صفحة تسجيل دخول حالية لتكون بمثابة نقطة نهاية التفويض.سيتضمّن
redirect_uri
المُرسَل كمعلَمة إلى نقطة نهاية التفويض الشكل التالي:https://oauth-redirect.googleusercontent.com/r/YOUR_PROJECT_ID https://oauth-redirect-sandbox.googleusercontent.com/r/YOUR_PROJECT_ID
يجب إدراج
redirect_uri
في القائمة المسموح بهاclient_id
الذي تخصّصه لشركة Google.عنوان URL لنقطة نهاية الرمز المميز: هذا هو عنوان URL لنقطة نهاية الرمز المميز التي تستضيفها وتجري Google طلبات إليها. يجب قبول الزيارات عبر HTTPS فقط ومن خدمات أخرى معروفة (مثل خدمات Google). على سبيل المثال،
https://oauth2.example.com/token
. قد تتم استضافة نقاط نهاية التفويض والرموز المميزة على نطاقات مختلفة.عنوان URL اختياري لنقطة نهاية إبطال الرمز المميّز هذا هو عنوان URL لنقطة نهاية الإبطال التي تستضيفها وتجري Google عمليات طلب إليها. يجب قبول الزيارات عبر HTTPS فقط ومن خدمات أخرى معروفة (مثل خدمات Google). على سبيل المثال،
https://oauth2.example.com/revoke
. قد تتم استضافة نقاط نهاية التفويض والرمز المميز والإبطال على نطاقات مختلفة.عنوان URL اختياري لخدمة "حماية الحسابات المتعددة" (RISC) هذا هو عنوان URL الذي تستضيفه وتجري Google مكالمات إليه. يمكنك اختيار القيمة.
معرّف العميل ورمز العميل السري في Google يجب أن تمنح Google معرّف عميل، وهو المعرّف المستخدَم في طلبات OAuth 2.0 لتحديد مصدر الطلب، بالإضافة إلى سر العميل المستخدَم لمنع تزوير الطلبات. يمكن أن يكون معرّف العميل وسر العميل في Google أي قيم سلاسل آمنة للاستخدام في عناوين URL من اختيارك. يجب التأكّد من أنّ سر العميل لا يظهر إلا لـ Google وخدمتك.
سلاسل النطاق الاختيارية: استنادًا إلى مقدار بيانات المستخدمين ونوعها التي يتيحها واجهة برمجة التطبيقات، قد تحتاج إلى تحديد نطاقات تمثّل فئات مختلفة من بيانات المستخدمين. من خلال ذلك، يمكن للجهات طلب الإذن من المستخدمين للوصول إلى أنواع معيّنة فقط من البيانات، وحصر البيانات المتاحة للعملاء في النطاقات المصرّح بها فقط. على وجه الخصوص، إذا كانت خدمتك تتيح بيانات أكثر من اللازم لإجراء عملية الدمج مع Google، يمكنك استخدام النطاقات لمنح إذن الوصول إلى بعض البيانات فقط.
- رقم تعريف مشروع Google API
للاطّلاع على رقم تعريف مشروعك، اتّبِع الخطوات التالية:
- Go to the Google API Console.
- ابحث عن مشروعك في الجدول على الصفحة المقصودة. يظهر رقم تعريف المشروع في العمود المعرّف.