تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

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

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

إعداد تطبيقك

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

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

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

طلب معرِّف عميل 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 Library API للغة 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 لتجربتها.