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

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

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

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

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

सबसे पहले एपीआई को चालू करें. इसके बाद, OAuth 2.0 क्लाइंट आईडी का अनुरोध करें.

एपीआई चालू करना

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

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

ध्यान दें: Google API में खोजते समय, आपको "Google Picker API" भी दिख सकता है. यह Google Photos Picker API से अलग है.

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

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

1. Google API कंसोल पर जाएं और अपना प्रोजेक्ट चुनें.
2. मेन्यू से, एपीआई और सेवाएं > क्रेडेंशियल चुनें.

3. क्रेडेंशियल पेज पर, क्रेडेंशियल बनाएं > OAuth क्लाइंट आईडी पर क्लिक करें.

   ध्यान दें: नया प्रोजेक्ट सेट अप करते समय, आपसे प्रोजेक्ट की सहमति स्क्रीन को कॉन्फ़िगर करने के लिए कहा जा सकता है.

4. ऐप्लिकेशन का टाइप चुनें. इस उदाहरण में, ऐप्लिकेशन का टाइप वेब ऐप्लिकेशन है.

5. उन ऑरिजिन को इस तरह से रजिस्टर करें जिनसे आपके ऐप्लिकेशन को Google एपीआई ऐक्सेस करने की अनुमति है:

   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 क्लाइंट डायलॉग से, इन्हें कॉपी करें:

   • क्लाइंट आईडी
   • क्लाइंट सीक्रेट

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

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

ऐप्लिकेशन को कॉन्फ़िगर करने के बाद, इसे इस्तेमाल करना शुरू किया जा सकता है:

• पिकर एपीआई का इस्तेमाल शुरू करना
• Library API का इस्तेमाल शुरू करना

अपना क्लाइंट आईडी बदलना

Google Photos के किसी भी एपीआई की मदद से बनाए गए संसाधनों को सिर्फ़ उस ओरिजनल क्लाइंट आईडी का इस्तेमाल करके ऐक्सेस या उनमें बदलाव किया जा सकता है जिसका इस्तेमाल उन्हें बनाने के लिए किया गया था. उदाहरण के लिए, अगर आपने किसी क्लाइंट आईडी का इस्तेमाल करके Picker API में 'सेशन' बनाया है और बाद में अपने ऐप्लिकेशन में उस क्लाइंट आईडी को बदल दिया है, तो आपके ऐप्लिकेशन के पास पिछले क्लाइंट आईडी से बनाए गए किसी भी API रिसॉर्स का ऐक्सेस नहीं रहेगा.

सोच-समझकर प्लान बनाएं और Photos API के लिए, सही क्लाइंट आईडी टाइप चुनें. ऐक्सेस से जुड़ी समस्याओं से बचने के लिए, ज़रूरी होने पर ही अपना क्लाइंट आईडी बदलें.