Java क्लाइंट लाइब्रेरी का इस्तेमाल शुरू करना

Java क्लाइंट लाइब्रेरी के साथ Google Photos के एपीआई का इस्तेमाल शुरू करने के लिए, आपको अपने डेवलपमेंट एनवायरमेंट में क्लाइंट लाइब्रेरी सेट अप करनी होगी. ऐसा करने से पहले, एपीआई चालू करके अपना प्रोजेक्ट कॉन्फ़िगर करें को ऐक्सेस किया जा सकता है.

आपका ऐप्लिकेशन, Google Photos के उपयोगकर्ता की ओर से Google Photos के साथ इंटरैक्ट करता है. उदाहरण के लिए, जब आप किसी उपयोगकर्ता के उपयोगकर्ता की Google Photos लाइब्रेरी या मीडिया आइटम अपलोड करके Google Photos खाते का इस्तेमाल करते हैं, तो उपयोगकर्ता इन एपीआई अनुरोधों को OAuth 2.0 प्रोटोकॉल.

OAuth 2.0 क्लाइंट आईडी की मदद से, आपके ऐप्लिकेशन के उपयोगकर्ता साइन इन कर सकते हैं, पुष्टि कर सकते हैं, और Photos API का इस्तेमाल कर सकते हैं. Photos API, सेवा खातों के साथ काम नहीं करता. इस एपीआई का इस्तेमाल करने के लिए, उपयोगकर्ताओं को किसी मान्य Google खाते में साइन इन करना होगा.

अपना ऐप्लिकेशन कॉन्फ़िगर करें

इस एपीआई को चालू करें

Photos API का इस्तेमाल करने से पहले, आपको इसे अपने प्रोजेक्ट के लिए चालू करना होगा.

Google के एपीआई कंसोल पर जाएं.
मेन्यू बार से, कोई प्रोजेक्ट चुनें या नया प्रोजेक्ट बनाएं.
Google API लाइब्रेरी खोलने के लिए, नेविगेशन मेन्यू से, एपीआई और सेवाएं > लाइब्रेरी.
"Google Photos API" खोजें. सही नतीजा चुनें और क्लिक करें चालू करें.

OAuth 2.0 क्लाइंट आईडी का अनुरोध करना

OAuth क्लाइंट आईडी का अनुरोध करने और उसे अपने का इस्तेमाल करें. इस उदाहरण में ऐसे ऐप्लिकेशन का इस्तेमाल किया गया है जहां पूरा OAuth फ़्लो मौजूद है सर्वर-साइड को हैंडल किया जाता है, जैसा कि हमारे सैंपल में मौजूद सर्वर साइड पर होता है. सेटअप की प्रोसेस अलग-अलग हो सकती है अन्य लागू करने की स्थितियों के लिए.

Google API कंसोल पर जाएं और अपना प्रोजेक्ट चुनें.
मेन्यू से, एपीआई और सेवाएं > क्रेडेंशियल.
क्रेडेंशियल पेज पर, क्रेडेंशियल बनाएं > OAuth क्लाइंट आईडी पर क्लिक करें.
ऐप्लिकेशन का टाइप चुनें. इस उदाहरण में, ऐप्लिकेशन का टाइप वेब ऐप्लिकेशन है.
उन ऑरिजिन को रजिस्टर करें जिनसे आपके ऐप्लिकेशन को Google API ऐक्सेस करने की अनुमति है इस तरह से:
1. क्लाइंट आईडी की पहचान करने के लिए कोई नाम डालें.
2. अनुमति वाले JavaScript ऑरिजिन फ़ील्ड में, अपने ऐप्लिकेशन के ऑरिजिन की जानकारी डालें. इस फ़ील्ड में वाइल्डकार्ड का इस्तेमाल नहीं किया जा सकता.
  
  अपने ऐप्लिकेशन को अलग-अलग प्रोटोकॉल, डोमेन या सबडोमेन पर चलाने के लिए, एक से ज़्यादा ऑरिजिन डाले जा सकते हैं. आपके डाले गए यूआरएल से, OAuth अनुरोध शुरू किया जा सकता है.
  
  यहां दिए गए उदाहरण में, लोकल डेवलपमेंट यूआरएल (हमारे सैंपल में localhost:8080 का इस्तेमाल किया गया है) और प्रोडक्शन यूआरएल दिखाया गया है.
```
http://localhost:8080
https://myproductionurl.example.com
```
3. अनुमति वाला रीडायरेक्ट यूआरआई फ़ील्ड वह एंडपॉइंट होता है जिसे OAuth 2.0 सर्वर से मिले रिस्पॉन्स. आम तौर पर, इसमें आपका डेवलपमेंट एनवायरमेंट शामिल होता है और यह आपके ऐप्लिकेशन के किसी पाथ पर ले जाता है.
```
http://localhost:8080/auth/google/callback
https://myproductionurl.example.com/auth/google/callback
```
4. बनाएं पर क्लिक करें.

आपको मिलने वाले OAuth क्लाइंट डायलॉग से, JSON फ़ाइल डाउनलोड करें जिसमें आपके क्लाइंट कॉन्फ़िगरेशन शामिल है. आपके क्लाइंट की जानकारी में ये चीज़ें शामिल होती हैं:
- Client ID
- क्लाइंट सीक्रेट
इस JSON फ़ाइल का इस्तेमाल, बाद में सेट अप करने के लिए किया जाएगा Java के लिए Google की पुष्टि लाइब्रेरी जो इस क्लाइंट लाइब्रेरी के साथ काम करती है.

Photos API को ऐक्सेस करने वाला कोई सार्वजनिक ऐप्लिकेशन लॉन्च करने से पहले, यह ज़रूरी है कि Google आपके ऐप्लिकेशन की समीक्षा करे. "पुष्टि नहीं किया गया ऐप्लिकेशन" तो मैसेज इस पर दिखता है: स्क्रीन दिखाई देती है, जब तक कि वह पुष्टि की गई है.

क्लाइंट लाइब्रेरी सेट अप करना

Java क्लाइंट लाइब्रेरी आपके लिए सभी बैकएंड एपीआई कॉल मैनेज करती है. साथ ही, काम करने के लिए आसान ऑब्जेक्ट दिखाती है. इनमें, एपीआई के कुछ सामान्य टास्क के लिए कोड सैंपल भी शामिल हैं. सबसे पहले, GitHub से Java के लिए Google Photos APIs की क्लाइंट लाइब्रेरी और डिपेंडेंसी डाउनलोड और इंस्टॉल करें. इसके बाद, Java के लिए OAuth2 क्रेडेंशियल सेट अप करें.

डाउनलोड करने के विकल्प

क्लाइंट लाइब्रेरी डाउनलोड करने के कुछ विकल्प यहां दिए गए हैं:

Gradle डिपेंडेंसी:

इस लाइब्रेरी का इस्तेमाल Gradle के साथ करने के लिए, अपनी build.gradle फ़ाइल में यह डिपेंडेंसी जोड़ें.
```
repositories {
  mavenCentral()
}
dependencies {
  compile 'com.google.photos.library:google-photos-library-client:1.7.3'
}
```
Maven डिपेंडेंसी:

Maven के साथ इस लाइब्रेरी का इस्तेमाल करने के लिए, अपनी Maven pom.xml फ़ाइल में यह जानकारी जोड़ें.
```
<dependency>
  <groupId>com.google.photos.library</groupId>
  <artifactId>google-photos-library-client</artifactId>
  <version>1.7.3</version>
</dependency>
```
रिलीज़ डाउनलोड करना:

रिलीज़ पेज पर, लाइब्रेरी की हर रिलीज़ के लिए अलग-अलग आर्टफ़ैक्ट होते हैं. इनमें jar फ़ाइलें भी शामिल होती हैं.
डेटा स्टोर करने की जगह को क्लोन करना:

अगर आपको इस लाइब्रेरी में बदलाव करना है या इसमें योगदान देना है, तो यह तरीका अपनाएं आप चाहें, तो पुल के अनुरोध सबमिट कर सकते हैं या हमारे सैंपल आज़मा सकते हैं. आसानी से अपने कैलेंडर में जोड़ें. डेटा स्टोर करने की जगह का क्लोन बनाएं, तो इस रिपॉज़िटरी में मौजूद सभी फ़ाइलें डाउनलोड हो जाएंगी.
1. git clone https://github.com/google/java-photoslibrary.git को इस पर चलाएं कमांड प्रॉम्प्ट सबमिट करें.
2. आपको java-photoslibrary डायरेक्ट्री मिलेगी. चलाकर, इस पर नेविगेट करें cd java-photoslibrary.
3. प्रोजेक्ट बनाने के लिए, अपने IDE में build.gradle फ़ाइल खोलें या कमांड प्रॉम्प्ट में ./gradlew assemble चलाएं. ज़्यादा जानकारी के लिए, ./gradlew tasks पर जाएं उपलब्ध टास्क.

Java के लिए OAuth2 क्रेडेंशियल सेट अप करना

यह क्लाइंट लाइब्रेरी इसके लिए Google प्राधिकरण लाइब्रेरी के साथ काम करती है: Java. ज़्यादा जानकारी के लिए, Java के लिए Google API क्लाइंट लाइब्रेरी के साथ OAuth 2.0 का इस्तेमाल करना लेख पढ़ें.

CredentialsProvider में अपने क्लाइंट OAuth कॉन्फ़िगरेशन के बारे में बताएं, जब PhotosLibraryClient ऑब्जेक्ट के लिए PhotoLibrarySettings बनाया जा रहा है.

कुछ सैंपल आज़माएं

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 पर आज़माएं.