بدء استخدام REST

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

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

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

إعداد تطبيقك

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

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

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

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

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

1. انتقِل إلى وحدة التحكم في واجهة Google API. واختر مشروعك.
2. من القائمة، حدد واجهات برمجة التطبيقات الخدمات > بيانات الاعتماد:
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. انقر على إنشاء.

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

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

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

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

تجربة النموذج

الآن وبعد أن أعددت مشروعك للاستخدام مع واجهة برمجة تطبيقات المكتبة، يمكنك مراجعة نموذج التطبيق على GitHub. نموذج التطبيق طريقة إنشاء إطار صور ذكي باستخدام واجهة برمجة تطبيقات المكتبة.