Java क्लाइंट लाइब्रेरी के साथ Google Photos Library API का इस्तेमाल शुरू करने के लिए, आपको ये काम करने होंगे अपने डेवलपमेंट एनवायरमेंट में क्लाइंट लाइब्रेरी सेट अप करें. ऐसा करने से पहले, एपीआई चालू करके अपना प्रोजेक्ट कॉन्फ़िगर करें को ऐक्सेस किया जा सकता है.
आपका ऐप्लिकेशन इनकी ओर से Google Photos के साथ इंटरैक्ट करता है: Google Photos उपयोगकर्ता हैं. उदाहरण के लिए, जब आप किसी उपयोगकर्ता के उपयोगकर्ता की Google Photos लाइब्रेरी या मीडिया आइटम अपलोड करके Google Photos खाते का इस्तेमाल करते हैं, तो उपयोगकर्ता इन एपीआई अनुरोधों को OAuth 2.0 प्रोटोकॉल.
OAuth 2.0 क्लाइंट आईडी की मदद से आपके ऐप्लिकेशन के उपयोगकर्ता साइन इन कर सकते हैं. साथ ही, और इस प्रकार लाइब्रेरी API का उपयोग कर सकता है. Library API इस्तेमाल नहीं की जा सकती सेवा खाते; इस एपीआई का इस्तेमाल करने के लिए, उपयोगकर्ताओं को किसी मान्य Google खाते में साइन इन करना होगा खाता.
अपना ऐप्लिकेशन कॉन्फ़िगर करें
इस एपीआई को चालू करें
Library API का इस्तेमाल करने से पहले, आपको इसे अपने प्रोजेक्ट के लिए चालू करना होगा.
- Google के एपीआई कंसोल पर जाएं.
- मेन्यू बार से, कोई प्रोजेक्ट चुनें या नया प्रोजेक्ट बनाएं.
- Google API लाइब्रेरी खोलने के लिए, नेविगेशन मेन्यू से, एपीआई और सेवाएं > लाइब्रेरी.
- "Google Photos Library API" खोजें. सही नतीजा चुनें और क्लिक करें चालू करें.
OAuth 2.0 क्लाइंट आईडी का अनुरोध करना
OAuth क्लाइंट आईडी का अनुरोध करने और उसे अपने का इस्तेमाल करें. इस उदाहरण में ऐसे ऐप्लिकेशन का इस्तेमाल किया गया है जहां पूरा OAuth फ़्लो मौजूद है सर्वर-साइड को हैंडल किया जाता है, जैसा कि हमारे सैंपल में मौजूद सर्वर साइड पर होता है. सेटअप की प्रोसेस अलग-अलग हो सकती है लागू करने की अन्य स्थितियों के लिए.
- Google API कंसोल पर जाएं और अपना प्रोजेक्ट चुनें.
- मेन्यू से, एपीआई और सेवाएं > क्रेडेंशियल.
- क्रेडेंशियल पेज पर, क्रेडेंशियल बनाएं > OAuth क्लाइंट आईडी.
- ऐप्लिकेशन का टाइप चुनें. इस उदाहरण में, ऐप्लिकेशन टाइप वेब ऐप्लिकेशन.
उन ऑरिजिन को रजिस्टर करें जिनसे आपके ऐप्लिकेशन को Google API ऐक्सेस करने की अनुमति है इस तरह से:
- क्लाइंट आईडी की पहचान करने के लिए कोई नाम डालें.
अनुमति वाले JavaScript ऑरिजिन फ़ील्ड में, अपने है. इस फ़ील्ड में वाइल्डकार्ड इस्तेमाल नहीं किए जा सकते.
आप एक से ज़्यादा ऑरिजिन डालकर, अपने ऐप्लिकेशन को अलग-अलग ऑरिजिन पर शामिल हैं. आपके डाले गए यूआरएल ये काम कर सकते हैं OAuth अनुरोध शुरू करें.
नीचे दिया गया उदाहरण एक लोकल डेवलपमेंट यूआरएल दिखाता है (हमारे सैंपल,
localhost:8080
) और प्रोडक्शन यूआरएल भी होना चाहिए.http://localhost:8080 https://myproductionurl.example.com
अनुमति वाला रीडायरेक्ट यूआरआई फ़ील्ड वह एंडपॉइंट होता है जिसे OAuth 2.0 सर्वर से मिले रिस्पॉन्स. आम तौर पर, इसमें आपकी डेवलपमेंट एनवायरमेंट का इस्तेमाल करता है और आपके ऐप्लिकेशन के पाथ की ओर इशारा करता है.
http://localhost:8080/auth/google/callback https://myproductionurl.example.com/auth/google/callback
बनाएं पर क्लिक करें.
-
आपको मिलने वाले OAuth क्लाइंट डायलॉग से, JSON फ़ाइल डाउनलोड करें जिसमें आपके क्लाइंट कॉन्फ़िगरेशन शामिल है. आपके क्लाइंट की जानकारी में ये शामिल हैं: फ़ॉलो किया जा रहा है:
- Client ID
- क्लाइंट सीक्रेट
इस JSON फ़ाइल का इस्तेमाल, बाद में सेट अप करने के लिए किया जाएगा Java के लिए Google पुष्टि लाइब्रेरी जो इस क्लाइंट लाइब्रेरी के साथ काम करती है.
Library API को ऐक्सेस करने वाले सार्वजनिक ऐप्लिकेशन को लॉन्च करने से पहले, यह ज़रूरी है कि Google आपके ऐप्लिकेशन की समीक्षा करे. "पुष्टि नहीं किया गया ऐप्लिकेशन" तो मैसेज इस पर दिखता है: स्क्रीन दिखाई देती है, जब तक कि पुष्टि की गई है.
क्लाइंट लाइब्रेरी सेट अप करना
Java क्लाइंट लाइब्रेरी आपके लिए सभी बैकएंड एपीआई कॉल को हैंडल करती है और काम करने के लिए फ़्रेंडली ऑब्जेक्ट. इसमें, एपीआई के कुछ सामान्य कामों के लिए कोड के सैंपल भी शामिल हैं. सबसे पहले, Java के लिए Google Photos Library API की क्लाइंट लाइब्रेरी को डाउनलोड और इंस्टॉल करें GitHub पर निर्भर करता है. इसके बाद, 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>
रिलीज़ डाउनलोड करना:
रिलीज़ पेज इसमें हर लाइब्रेरी की रिलीज़ के लिए अलग-अलग आर्टफ़ैक्ट शामिल होते हैं. इनमें जार फ़ाइलें भी शामिल होती हैं.
डेटा स्टोर करने की जगह का क्लोन बनाएं:
अगर आपको इस लाइब्रेरी में बदलाव करना है या इसमें योगदान देना है, तो यह तरीका अपनाएं आप चाहें, तो पुल के अनुरोध सबमिट कर सकते हैं या हमारे सैंपल आज़मा सकते हैं. आसानी से अपने कैलेंडर में जोड़ें. डेटा स्टोर करने की जगह का क्लोन बनाएं, तो इस रिपॉज़िटरी में मौजूद सभी फ़ाइलें डाउनलोड हो जाएंगी.
git clone https://github.com/google/java-photoslibrary.git
को इस पर चलाएं कमांड प्रॉम्प्ट सबमिट करें.- आपको
java-photoslibrary
डायरेक्ट्री मिलेगी. चलाकर, इस पर नेविगेट करेंcd java-photoslibrary
. - अपने IDE में
build.gradle
फ़ाइल खोलें या./gradlew assemble
को यहां चलाएं कमांड प्रॉम्प्ट डालें. ज़्यादा जानकारी के लिए,./gradlew tasks
पर जाएं उपलब्ध टास्क.
Java के लिए, अपने OAuth2 क्रेडेंशियल सेट अप करना
यह क्लाइंट लाइब्रेरी इसके लिए Google प्राधिकरण लाइब्रेरी के साथ काम करती है: Java. ज़्यादा जानकारी के लिए, Google API क्लाइंट लाइब्रेरी के साथ OAuth 2.0 का इस्तेमाल करना Java.
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 पर आज़माएं.