بدء استخدام REST

لبدء استخدام واجهة برمجة التطبيقات لمكتبة "صور Google"، يمكنك ضبط مشروعك من خلال تفعيل واجهة برمجة التطبيقات عبر وحدة تحكُّم واجهة برمجة تطبيقات Google وإعداد معرِّف عميل OAuth 2.0.

يتفاعل تطبيقك مع "صور Google" نيابةً عن مستخدم من مستخدمي "صور Google". على سبيل المثال، عند إنشاء ألبومات في مكتبة مستخدم صور Google أو تحميل عناصر وسائط إلى حساب مستخدم على "صور Google"، يسمح المستخدم لطلبات واجهة برمجة التطبيقات هذه عبر بروتوكول OAuth 2.0.

يتيح معرِّف عميل OAuth 2.0 لمستخدمي تطبيقك تسجيل الدخول والمصادقة، وبالتالي استخدام Library API. لا تتيح واجهة برمجة التطبيقات Library API استخدام حسابات الخدمة، ولاستخدام واجهة برمجة التطبيقات هذه، على المستخدمين تسجيل الدخول إلى حساب Google صالح.

ضبط إعدادات تطبيقك

تفعيل واجهة برمجة التطبيقات

يجب تفعيل واجهة برمجة التطبيقات Library API في مشروعك قبل أن تتمكّن من استخدامها.

  1. انتقِل إلى وحدة التحكم في واجهة Google API.
  2. من شريط القوائم، اختَر مشروعًا أو أنشِئ مشروعًا جديدًا.
  3. لفتح مكتبة Google API، اختَر واجهات برمجة التطبيقات والخدمات > المكتبة من قائمة التنقّل.
  4. ابحث عن "Google Photos Library API". اختَر النتيجة الصحيحة وانقر على تفعيل.

طلب معرِّف عميل OAuth 2.0

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

  1. انتقِل إلى وحدة التحكم في واجهة Google API واختَر مشروعك.
  2. من القائمة، اختر APIs & Services (واجهات برمجة التطبيقات والخدمات) > Credentials (بيانات الاعتماد).
  3. في صفحة بيانات الاعتماد، انقر على إنشاء بيانات اعتماد > معرِّف عميل OAuth.
  4. اختَر نوع التطبيق. في هذا المثال، نوع التطبيق هو تطبيق الويب.

  5. سجّل المصادر التي تم السماح لتطبيقك من خلالها بالوصول إلى Google APIs على النحو التالي:

    1. لتحديد معرِّف العميل، أدخِل اسمًا.

    2. في الحقل مصادر JavaScript المسموح بها، أدخِل أصل تطبيقك. لا يسمح هذا الحقل بأحرف البدل.

      يمكنك إدخال مصادر متعددة للسماح بتشغيل تطبيقك على بروتوكولات أو نطاقات أو نطاقات فرعية مختلفة. يُسمح لعناوين URL التي تُدخلها ببدء طلب OAuth.

      يعرض المثال التالي عنوان URL للتطوير المحلي (تستخدم نماذجنا localhost:8080) وعنوان URL للإنتاج.

      http://localhost:8080
https://myproductionurl.example.com

    3. حقل معرّف الموارد المنتظم (URI) لإعادة التوجيه المعتمد هو نقطة النهاية التي تتلقى الردود من خادم OAuth 2.0. عادةً ما يتضمن ذلك بيئة التطوير الخاصة بك ويشير إلى مسار في تطبيقك.

      http://localhost:8080/auth/google/callback
https://myproductionurl.example.com/auth/google/callback

    4. انقر على إنشاء.

  1. من مربّع حوار عميل OAuth الناتج، انسخ ما يلي:

    • معرِّف العميل
    • سر العميل

    يمكن لتطبيقك الوصول إلى واجهات Google APIs المفعَّلة باستخدام هذه القيم.

قبل أن تتمكّن من إطلاق تطبيق عام يمكنه الوصول إلى واجهة برمجة تطبيقات Library (واجهة برمجة تطبيقات المكتبة)، يجب أن تُراجع Google تطبيقك. تظهر الرسالة "لم يتم التحقق من التطبيق" على الشاشة عند اختبار التطبيق، حتى يتم التحقق منه.

تجربة العيّنة

الآن بعد أن انتهيت من إعداد مشروعك للاستخدام مع Library API، اطّلِع على نموذج التطبيق على GitHub. يوضح نموذج التطبيق كيف يمكنك إنشاء إطار صور ذكي باستخدام Library API.