REST का इस्तेमाल शुरू करना

Google Photos Library API का इस्तेमाल शुरू करने के लिए, अपना प्रोजेक्ट कॉन्फ़िगर करें. ऐसा करने के लिए, Google API कंसोल के ज़रिए एपीआई चालू करें और OAuth 2.0 क्लाइंट आईडी सेट अप करें.

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

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

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

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

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

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

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

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

1. Google API कंसोल पर जाएं और अपना प्रोजेक्ट चुनें.
2. मेन्यू में जाकर, एपीआई और सेवाएं > क्रेडेंशियल चुनें.
3. क्रेडेंशियल पेज पर, क्रेडेंशियल बनाएं > OAuth क्लाइंट आईडी पर क्लिक करें.
4. अपने ऐप्लिकेशन का टाइप चुनें. इस उदाहरण में, ऐप्लिकेशन का टाइप वेब ऐप्लिकेशन है.

5. उन ऑरिजिन को यहां बताए गए तरीके से रजिस्टर करें जिनसे आपके ऐप्लिकेशन को 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. बनाएं पर क्लिक करें.

6. दिखने वाले OAuth क्लाइंट डायलॉग से, इन्हें कॉपी करें:

   • Client ID
   • क्लाइंट सीक्रेट

   आपका ऐप्लिकेशन इन वैल्यू का इस्तेमाल करके, चालू किए गए Google API को ऐक्सेस कर सकता है.

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

सैंपल आज़माएं

अब जब आपने अपने प्रोजेक्ट को Library API के साथ इस्तेमाल करने के लिए कॉन्फ़िगर कर लिया है, तो GitHub पर सैंपल ऐप्लिकेशन देखें. सैंपल ऐप्लिकेशन में बताया गया है कि Library API का इस्तेमाल करके स्मार्ट फ़ोटो फ़्रेम कैसे बनाया जा सकता है.