لإعداد بروتوكول OAuth لتطبيقك، يمكنك إعداد سير عمل OAuth، وتفعيل نطاقات OAuth لواجهة برمجة تطبيقات نقل البيانات.
إعداد سير عمل OAuth
لإعداد مسار OAuth لتطبيقك، اتّبِع الخطوات الأساسية في مستندات Google Identity.
يستخدم معظم المطوّرين مسار تطبيقات الويب من جهة الخادم للحصول على موافقة OAuth، ولكن يمكنك أيضًا استخدام تدفق تطبيقات الويب باستخدام JavaScript أو مسار تطبيقات الأجهزة الجوّالة وأجهزة الكمبيوتر المكتبي.
نطاقات OAuth لواجهة برمجة التطبيقات لنقل البيانات
عند ضبط تطبيق واجهة برمجة تطبيقات نقل البيانات لبروتوكول OAuth، فعِّل نطاقات OAuth لواجهة برمجة تطبيقات نقل البيانات ذات الصلة بتطبيقك. للاطّلاع على قائمة بجميع نطاقات OAuth المتوافقة مع واجهة برمجة تطبيقات Data Portability API، يُرجى الاطّلاع على نطاقات OAuth 2.0 لواجهات Google APIs. للحصول على قائمة بجميع مجموعات الموارد ونطاقات OAuth المتوافقة مع خدمة معيّنة، يُرجى الاطّلاع على الصفحة المرجعية للمخطط لتلك الخدمة.
عند إضافة نطاقات واجهة برمجة التطبيقات Data Portability API إلى مسار OAuth، قد تكون هناك حالات يمنح فيها المستخدم الموافقة على بعض النطاقات وليس جميعها. يجب أن يتمكّن تطبيقك من معالجة هذه الحالات باتّباع الخطوات التالية:
- السماح بعمليات تصدير البيانات الجزئية
- إخطار المستخدم بأنه لم يتم تحديد جميع النطاقات اللازمة (والفشل في العمل بسلاسة)
- مطالبة المستخدم بالموافقات المتبقية
تجدر الإشارة إلى أنّ موافقة المستخدم تتيح لك تصدير بيانات واحدة للحصول على تلك الموافقة المحدّدة. لتنزيل البيانات مرة أخرى، تحتاج إلى موافقة جديدة من المستخدم.
ويجب أيضًا ملاحظة أنّه أثناء مسار OAuth، لا يعرف تطبيقك حساب Google الذي تم استخدامه لمنح الموافقة. يكون رمز OAuth المميز الذي يتلقّاه تطبيقك معتمًا.
إذا كنت تبحث عن معلومات حول كيفية مشاركة المستخدمين للبيانات، يمكنك الاطّلاع على مشاركة نسخة من بياناتك مع جهة خارجية.