لبدء استخدام واجهات برمجة تطبيقات "صور Google"، عليك ضبط مشروعك من خلال تفعيل واجهتَي برمجة تطبيقات "صور Google" اللتين تحتاج إليهما باستخدام "وحدة تحكّم Google API" وإعداد معرّف عميل OAuth 2.0.
يتفاعل تطبيقك مع "صور Google" نيابةً عن مستخدمي "صور Google". على سبيل المثال، عند إنشاء ألبومات في مكتبة "صور Google" خاص بأحد المستخدمين أو تحميل ملفات وسائط إلى حساب مستخدم على "صور Google"، يفوّض المستخدم طلبات واجهة برمجة التطبيقات هذه باستخدام بروتوكول OAuth 2.0.
يتيح معرِّف عميل OAuth 2.0 لمستخدمي التطبيقات تسجيل الدخول والمصادقة، وبالتالي استخدام واجهات برمجة تطبيقات الصور. لا تتوافق واجهات برمجة التطبيقات للصور مع حسابات الخدمة، ولاستخدام واجهات برمجة التطبيقات هذه، يجب على المستخدمين تسجيل الدخول إلى حساب Google صالح.
ضبط إعدادات تطبيقك
فعِّل أولاً واجهة برمجة التطبيقات، ثم اطلب الحصول على معرّف عميل OAuth 2.0.
تفعيل واجهة برمجة التطبيقات
قبل أن تتمكن من استخدام واجهات برمجة تطبيقات الصور، يجب تفعيلها في مشروعك.
- انتقِل إلى وحدة التحكم في واجهة Google API.
- من شريط القوائم، اختَر مشروعًا أو أنشئ مشروعًا جديدًا.
- لفتح إحدى واجهات برمجة التطبيقات في "صور Google"، اختَر واجهات برمجة التطبيقات والخدمات > المكتبة من قائمة "التنقّل".
- ابحث عن "صور Google". اختَر واجهة واحدة أو أكثر من واجهات برمجة التطبيقات في "صور Google" وانقر على تفعيل.
طلب معرِّف عميل OAuth 2.0
اتّبِع الخطوات التالية لطلب معرِّف عميل OAuth وإعداده للتطبيق. يستخدم هذا المثال تطبيقًا تتم فيه معالجة تدفق OAuth بالكامل من جهة الخادم، مثل التطبيق الموجود في نماذجنا. قد تختلف عملية الإعداد في سيناريوهات التنفيذ الأخرى.
- انتقِل إلى وحدة التحكم في واجهة Google API واختَر مشروعك.
- من القائمة، حدد APIs & Services (واجهات برمجة التطبيقات والخدمات) > Credentials (بيانات الاعتماد).
في صفحة بيانات الاعتماد، انقر على إنشاء بيانات اعتماد > معرِّف عميل OAuth.
اختَر نوع التطبيق. في هذا المثال، يكون نوع التطبيق هو تطبيق ويب.
سجِّل المصادر التي يُسمح لتطبيقك من خلالها بالوصول إلى واجهات Google APIs على النحو التالي:
- لتحديد معرّف العميل، أدخِل اسمًا.
في حقل مصادر JavaScript المسموح بها، أدخِل مصدر تطبيقك. لا يسمح هذا الحقل بأحرف البدل.
يمكنك إدخال عدة مصادر للسماح لتطبيقك بالعمل على بروتوكولات أو نطاقات أو نطاقات فرعية مختلفة. يُسمَح لعناوين URL التي تُدخلها ببدء طلب OAuth.
يعرض المثال التالي عنوان URL لتطوير التطبيقات على الجهاز (تستخدم عيّنات التطبيق عنوان URL يليه
localhost:8080) وعنوان URL للإصدار العلني.http://localhost:8080 https://myproductionurl.example.comحقل معرّف الموارد المنتظم (URI) المعتمَد لإعادة التوجيه هو نقطة النهاية التي تتلقّى استجابات من خادم OAuth 2.0. عادةً ما يتضمن ذلك بيئة التطوير لديك ويشير إلى مسار في تطبيقك.
http://localhost:8080/auth/google/callback https://myproductionurl.example.com/auth/google/callbackانقر على إنشاء.
-
من مربّع حوار عميل OAuth الناتج، انسخ ما يلي:
- معرِّف العميل
- سر العميل
يمكن لتطبيقك الوصول إلى واجهات Google APIs المفعَّلة باستخدام هذه القيم.
قبل إطلاق تطبيق عام يمكنه الوصول إلى واجهات برمجة التطبيقات للصور، يجب أن تراجع Google تطبيقك. تظهر رسالة "لم يتم التحقّق من التطبيق" على الشاشة عند اختبار تطبيقك، إلى أن يتم إثبات ملكيته.
بعد ضبط تطبيقك، ستكون جاهزًا للبدء:
تغيير معرّف العميل
لا يمكن الوصول إلى الموارد التي تم إنشاؤها من خلال أي من واجهات برمجة تطبيقات "صور Google" أو تعديلها إلا باستخدام معرّف العميل الأصلي المستخدَم لإنشائها. على سبيل المثال، إذا أنشأت "جلسة" في واجهة برمجة التطبيقات Picker API باستخدام معرّف عميل محدّد وغيّرت لاحقًا معرّف العميل هذا في تطبيقك، سيفقد تطبيقك إمكانية الوصول إلى أي موارد لواجهة برمجة التطبيقات تم إنشاؤها باستخدام معرِّف العميل السابق.
خطِّط بعناية واختَر نوع معرّف العميل المناسب لواجهة Photos API التي تستخدمها. لا تغيّر معرِّف العميل إلا إذا لزم الأمر بشدة لتجنُّب مشاكل الوصول.