بدء استخدام مكتبة عملاء Java

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

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

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

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

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

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

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

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

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

انتقِل إلى وحدة التحكم في واجهة Google API. واختر مشروعك.
من القائمة، اختَر واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد.
في صفحة بيانات الاعتماد، انقر على إنشاء بيانات الاعتماد >. معرِّف عميل OAuth.
اختَر نوع التطبيق. في هذا المثال، يكون نوع التطبيق هو تطبيق ويب.
تسجيل المصادر التي يُسمح لتطبيقك من خلالها بالوصول إلى واجهات 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. انقر على إنشاء.

من مربّع حوار عميل OAuth الناتج، نزِّل ملف JSON الذي يحتوي على إعدادات العميل. تتكون تفاصيل العميل من التالي:
- معرِّف العميل
- سر العميل
سيتم استخدام ملف JSON هذا لاحقًا للإعداد. مكتبة مصادقة Google للغة Java التي تعمل مع مكتبة البرامج هذه.

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

إعداد مكتبة البرامج

تعالج مكتبة برامج Java جميع طلبات البيانات من واجهة برمجة التطبيقات التي تعمل في الخلفية، وتعرض للعمل بها، بما في ذلك عيّنات التعليمات البرمجية لبعض المهام الشائعة في واجهة برمجة التطبيقات. أولاً، نزِّل مكتبة برامج Google Photos APIs للغة Java وثبِّتها مع التبعيات من GitHub. بعد ذلك، يمكنك إعداد بيانات اعتماد OAuth2 لـ Java.

خيارات التنزيل

في ما يلي بعض الخيارات لتنزيل مكتبة العميل:

تبعية Gradle:

لاستخدام هذه المكتبة مع Gradle، أضِف التبعية التالية إلى ملف build.gradle.

repositories {
  mavenCentral()
}
dependencies {
  compile 'com.google.photos.library:google-photos-library-client:1.7.3'
}

اعتمادية Maven:

لاستخدام هذه المكتبة مع Maven، يجب إضافة ما يلي إلى pom.xml Maven. الملف.

<dependency>
  <groupId>com.google.photos.library</groupId>
  <artifactId>google-photos-library-client</artifactId>
  <version>1.7.3</version>
</dependency>

تنزيل إصدار:

صفحة الإصدارات يحتوي على عناصر مختلفة لكل إصدار مكتبة، بما في ذلك ملفات البرطمان.
استنساخ المستودع:

استخدم هذه الطريقة إذا كنت تريد تغيير هذه المكتبة أو المساهمة فيها، مثل تقديم طلبات السحب، أو إذا كنت ترغب في تجربة عيناتنا. عند استنساخ المستودع، سيتم تنزيل جميع الملفات في هذا المستودع.
1. تشغيل git clone https://github.com/google/java-photoslibrary.git عند .
2. سيصلك دليل java-photoslibrary. الانتقال إليه عن طريق تشغيل cd java-photoslibrary
3. افتح ملف build.gradle في بيئة التطوير المتكاملة (IDE) أو شغِّل ./gradlew assemble على موجه الأوامر لإنشاء المشروع. راجِع ./gradlew tasks للاطّلاع على المهام المتاحة.

إعداد بيانات اعتماد OAuth2 لـ Java

تعمل مكتبة البرامج هذه مع مكتبة مصادقة Google لـ Java: لمزيد من المعلومات راجع استخدام OAuth 2.0 مع مكتبة برامج Google API للاطلاع على Java:

حدِّد إعدادات OAuth للعميل في CredentialsProvider عند إنشاء PhotoLibrarySettings لكائن PhotosLibraryClient.

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

جرِّب الرمز البرمجي أدناه لإجراء أول طلب بيانات من واجهة برمجة التطبيقات باستخدام مكتبة برامج Java.

// Set up the Photos Library Client that interacts with the API
PhotosLibrarySettings settings =
     PhotosLibrarySettings.newBuilder()
    .setCredentialsProvider(
        FixedCredentialsProvider.create(/* Add credentials here. */)) 
    .build();

try (PhotosLibraryClient photosLibraryClient =
    PhotosLibraryClient.initialize(settings)) {

    // Create a new Album  with at title
    Album createdAlbum = photosLibraryClient.createAlbum("My Album");

    // Get some properties from the album, such as its ID and product URL
    String id = album.getId();
    String url = album.getProductUrl();

} catch (ApiException e) {
    // Error during album creation
}

هناك المزيد من النماذج على GitHub لتجربتها.

بدء استخدام مكتبة عملاء Java تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.