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

Google Photos के एपीआई का इस्तेमाल शुरू करने के लिए, Google API Console का इस्तेमाल करके, अपने प्रोजेक्ट को कॉन्फ़िगर करें. इसके लिए, आपको 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 के एक या एक से ज़्यादा एपीआई चुनें और चालू करें पर क्लिक करें.

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

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

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

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

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

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

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

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

   1. क्लाइंट आईडी की पहचान करने के लिए, कोई नाम डालें.

   2. Authorized JavaScript origins फ़ील्ड में, अपने ऐप्लिकेशन के लिए ऑरिजिन डालें. इस फ़ील्ड में वाइल्डकार्ड इस्तेमाल नहीं किए जा सकते.

      अपने ऐप्लिकेशन को अलग-अलग प्रोटोकॉल, डोमेन या सबडोमेन पर चलाने के लिए, एक से ज़्यादा ऑरिजिन डाले जा सकते हैं. आपके डाले गए यूआरएल से, OAuth अनुरोध शुरू किया जा सकता है.

      नीचे दिए गए उदाहरण में, लोकल डेवलपमेंट यूआरएल (हमारे सैंपल में localhost:8080 का इस्तेमाल किया गया है) और प्रोडक्शन यूआरएल दिखाया गया है.

      http://localhost:8080
      https://myproductionurl.example.com
      

   3. Authorized redirect URI फ़ील्ड, वह एंडपॉइंट होता है जिसे OAuth 2.0 सर्वर से रिस्पॉन्स मिलते हैं. आम तौर पर, इसमें आपका डेवलपमेंट एनवायरमेंट शामिल होता है और यह आपके ऐप्लिकेशन के किसी पाथ पर ले जाता है.

      http://localhost:8080/auth/google/callback
      https://myproductionurl.example.com/auth/google/callback
      

   4. बनाएं पर क्लिक करें.

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

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

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

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

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

• Picker API का इस्तेमाल शुरू करना
• Library API का इस्तेमाल शुरू करना

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

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

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