Google Photos API से जुड़े अपडेट

सितंबर 2024 में पोस्ट किया गया.

इस पेज पर, Google Photos के एपीआई में किए जा रहे खास बदलावों के बारे में जानकारी दी गई है. इस पेज पर दी गई जानकारी पढ़ें. इससे आपको यह समझने में मदद मिलेगी कि आपके इस्तेमाल किए जा रहे तरीकों और दायरों पर क्या असर पड़ सकता है. इन बदलावों के एलान के बारे में ज़्यादा जानने के लिए, इससे जुड़ी ब्लॉग पोस्ट पढ़ें.

Library API: इस्तेमाल के सामान्य उदाहरणों पर असर

नीचे दिए गए सेक्शन में बताया गया है कि आने वाले समय में होने वाले बदलावों का, सामान्य इस्तेमाल के उदाहरणों पर क्या असर पड़ेगा.

मीडिया आइटम अपलोड करना और एल्बम बनाना

क्या बदलाव हो रहा है: कोई बदलाव नहीं. photoslibrary.appendonly स्कोप का इस्तेमाल करके, मीडिया आइटम अपलोड किए जा सकते हैं और एल्बम बनाए जा सकते हैं.

आपके पास ये विकल्प हैं:

अगर आपका ऐप्लिकेशन मीडिया आइटम अपलोड कर रहा है या एल्बम बना रहा है, तो पक्का करें कि आपने photoslibrary स्कोप के बजाय photoslibrary.appendonly स्कोप का इस्तेमाल किया हो. photoslibrary स्कोप को हटाया जा रहा है.

मीडिया आइटम और एल्बम की सूची बनाना, उन्हें खोजना, और वापस लाना

क्या बदलाव हो रहा है: अब सिर्फ़ उन एल्बम और मीडिया आइटम को सूची में शामिल किया जा सकता है, खोजा जा सकता है, और वापस लाया जा सकता है जिन्हें आपके ऐप्लिकेशन ने बनाया है.

आपके पास ये विकल्प हैं:

• अगर आपके ऐप्लिकेशन में उपयोगकर्ताओं को अपनी पूरी लाइब्रेरी से फ़ोटो या एल्बम चुनने की ज़रूरत है, तो Google Photos पिकर एपीआई का इस्तेमाल करें. इससे उपयोगकर्ताओं को किसी खास कॉन्टेंट का ऐक्सेस देने का सुरक्षित और उपयोगकर्ता-अनुकूल तरीका मिलता है.
• अगर आपका ऐप्लिकेशन, उपयोगकर्ता की पूरी लाइब्रेरी को ऐक्सेस करने पर निर्भर है, तो आपको अपने ऐप्लिकेशन का फिर से आकलन करना पड़ सकता है या अन्य तरीकों पर विचार करना पड़ सकता है.

शेयर करना और शेयर किए गए एल्बम

क्या बदलाव हो रहा है: शेयर किए गए एल्बम और उनसे जुड़े एपीआई फ़ंक्शन (शेयर करना, शेयर करना बंद करना, पाना, शामिल होना, छोड़ना, और सूची) 31 मार्च, 2025 के बाद 403 PERMISSION_DENIED दिखाएंगे.

आपके पास ये विकल्प हैं:

उपयोगकर्ताओं को Google Photos ऐप्लिकेशन पर भेजें, ताकि वे फ़ोटो शेयर करने की सेटिंग को खुद मैनेज कर सकें. उन्हें निर्देश देने के लिए, अपने ऐप्लिकेशन में साफ़ निर्देश या डीप लिंक जोड़े जा सकते हैं.

ऐप्लिकेशन से बनाए गए एल्बम मैनेज करना: ज़्यादा जानकारी और एल्बम का कॉन्टेंट

क्या बदलाव किया जा रहा है: photoslibrary.edit.appcreateddata को इन तीन तरीकों में जोड़ा जा रहा है, ताकि कॉन्सेप्ट एक जैसा रहे:

• albums.addEnrichment
• albums.batchAddMediaItems
• albums.batchRemoveMediaItems

आपके पास ये विकल्प हैं:

• अगर आपका ऐप्लिकेशन पहले से ही इन तरीकों का इस्तेमाल करता है, तो अनुमति की प्रोसेस को आसान बनाने के लिए, photoslibrary.edit.appcreateddata स्कोप का इस्तेमाल करें.

Library API: जिन स्कोप और तरीकों पर असर पड़ा है

Google Photos के एपीआई में किए गए बदलावों के तहत, हमने ये अपडेट किए हैं.

अनुमति के अपडेट किए गए पेज पर दिखाए गए मुताबिक, 31 मार्च, 2025 के बाद Library API से ये स्कोप हटा दिए जाएंगे:

• photoslibrary.readonly
• photoslibrary.sharing
• photoslibrary

ये स्कोप पहले की तरह ही काम करेंगे:

• photoslibrary.appendonly
• photoslibrary.readonly.appcreateddata
• photoslibrary.edit.appcreateddata

इस टेबल में, लाइब्रेरी एपीआई के उन तरीकों और स्कोप के बारे में बताया गया है जिन पर असर पड़ा है.

अपडेट	तरीके	स्कोप
अब इन तरीकों का इस्तेमाल, सिर्फ़ आपके ऐप्लिकेशन से बनाए गए एल्बम और मीडिया आइटम के लिए किया जा सकता है.	albums.create mediaItems.batchCreate	बचे हुए स्कोप: photoslibrary.appendonly हटाए गए स्कोप: photoslibrary photoslibrary.sharing
	albums.get albums.list mediaItems.batchGet mediaItems.get mediaItems.list mediaItems.search	बचे हुए स्कोप: photoslibrary.readonly.appcreateddata हटाए गए स्कोप: photoslibrary photoslibrary.readonly
ये तरीके अब उपलब्ध नहीं होंगे.	albums.share albums.unshare sharedAlbums.get sharedAlbums.join sharedAlbums.leave sharedAlbums.list	बचे हुए स्कोप: कोई नहीं हटाए गए स्कोप: photoslibrary.sharing
इन तरीकों में photoslibrary.edit.appcreateddata जोड़ा जाएगा. अब इन तरीकों का इस्तेमाल, सिर्फ़ आपके ऐप्लिकेशन से बनाए गए एल्बम और मीडिया आइटम के लिए किया जा सकता है.	albums.addEnrichment albums.batchAddMediaItems	बचे हुए स्कोप: photoslibrary.appendonly photoslibrary.edit.appcreateddata हटाए गए स्कोप: photoslibrary
	albums.batchRemoveMediaItems	बचे हुए स्कोप: photoslibrary.edit.appcreateddata हटाए गए स्कोप: photoslibrary
इन तरीकों में कोई बदलाव नहीं होगा.	albums.patch mediaItems.patch	बचे हुए स्कोप: photoslibrary.edit.appcreateddata हटाए गए स्कोप: कोई नहीं

Photos API की नीति में हुए अपडेट

स्वीकार किए जा सकने वाले इस्तेमाल से जुड़ी मौजूदा नीति को 31 मार्च, 2025 के बाद, Photos API के उपयोगकर्ता के डेटा और डेवलपर से जुड़ी नई नीति से बदल दिया जाएगा. नई नीति की झलक देखने के लिए, अब यह उपलब्ध है.

Photos API के दस्तावेज़ में किए गए अपडेट

हमने Photos API के दस्तावेज़ में अहम बदलाव किए हैं, ताकि आने वाले अपडेट दिखाए जा सकें और डेवलपमेंट के आपके अनुभव को बेहतर बनाया जा सके:

• Photos API की एकीकृत साइट: हमने Photos API के सभी संसाधनों को एक ही जगह (इस साइट) पर इकट्ठा किया है. इससे डेवलपर को बेहतर अनुभव मिलता है. यहां आपको ये विकल्प मिलेंगे:
  • एक ही जगह पर मौजूद संसाधन: Picker API और Library API, दोनों के लिए सेटअप करने के निर्देश और इस्तेमाल से जुड़े सामान्य दिशा-निर्देश और सहायता और नीति से जुड़ी जानकारी एक ही जगह पर उपलब्ध है.
  • एपीआई से जुड़ी खास साइटें: Picker API और Library API के लिए, ज़्यादा जानकारी वाली गाइड, रेफ़रंस दस्तावेज़, और कोड सैंपल वाली अलग-अलग साइटें
• Library API का अपडेट किया गया कॉन्टेंट: Library API के दस्तावेज़ में बदलाव किया गया है, ताकि बंद होने की अवधि के बाद Library API की सुविधाओं के बारे में जानकारी दी जा सके.
• लेगसी दस्तावेज़ को सुरक्षित रखा गया है: हमने Library API के मूल दस्तावेज़ को उन डेवलपर के लिए सुरक्षित रखा है जिन्हें मौजूदा इंटिग्रेशन को माइग्रेट करना है. अगर कोई नया प्रोजेक्ट शुरू किया जा रहा है, तो अपडेट किए गए दस्तावेज़ का इस्तेमाल करें. अगर किसी मौजूदा प्रोजेक्ट को अपडेट किया जा रहा है, तो माइग्रेशन के दौरान ज़रूरत के हिसाब से, लेगसी और अपडेट किए गए दस्तावेज़, दोनों देखें.

अक्सर पूछे जाने वाले सवाल

Google Photos API में क्या बदलाव हो रहे हैं?

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

ये बदलाव कब से लागू होंगे?

ये बदलाव 31 मार्च, 2025 से लागू होंगे. हमारा सुझाव है कि जिन लोगों के पास फ़ोटो चुनने के लिए, Library API का इस्तेमाल करने वाले मौजूदा इंटिग्रेशन हैं वे जल्द से जल्द Picker API पर माइग्रेट कर लें.

इससे लाइब्रेरी एपीआई पर क्या असर पड़ेगा?

photoslibrary.readonly, photoslibrary.sharing, और photoslibrary के स्कोप हटा दिए जाएंगे. सिर्फ़ इन स्कोप पर निर्भर एपीआई कॉल, 31 मार्च, 2025 के बाद 403 PERMISSION_DENIED दिखाएंगे. कई अन्य कॉल, सिर्फ़ आपके ऐप्लिकेशन से बनाई गई फ़ोटो और वीडियो के साथ काम करेंगे.

इस पेज पर, जिन स्कोप और तरीकों पर असर पड़ा है उनकी टेबल में, बदलावों का पूरा सेट देखा जा सकता है.

अगर मेरा ऐप्लिकेशन फ़िलहाल, उन स्कोप या तरीकों का इस्तेमाल करता है जिन पर असर पड़ा है, तो मुझे क्या करना चाहिए?

अगर आपका ऐप्लिकेशन, जिन स्कोप या तरीकों पर असर पड़ा है उनमें से किसी का इस्तेमाल करता है, तो हमारा सुझाव है कि आप ये कार्रवाइयां करें:

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

Google Photos पिकर एपीआई क्या है?

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

मुझे इन बदलावों के बारे में ज़्यादा जानकारी कहां मिल सकती है?

फ़िलहाल, आपको जो पेज दिख रहा है उस पर सभी बदलावों की खास जानकारी और खास जानकारी दी गई है.

अपडेट किए गए एपीआई दिखाने के लिए, हमारी साइट पर मौजूद बाकी दस्तावेज़ अपडेट कर दिए गए हैं.

इस ब्लॉग पोस्ट में, इन बदलावों के बारे में बताया गया है.

अगर मेरे पास और सवाल हैं या मुझे अपने ऐप्लिकेशन को माइग्रेट करने में मदद चाहिए, तो क्या होगा?

अगर आपको डेवलपर दस्तावेज़ के बारे में कुछ पूछना है, तो मदद पाने के बारे में ज़्यादा जानकारी के लिए, हमारे सहायता पेज पर जाएं.