मीडिया आइटम की सूची बनाएं और उन्हें फिर से पाएं

जब कोई उपयोगकर्ता Picker API का इस्तेमाल करके मीडिया आइटम चुन लेता है, तो उनके बारे में जानकारी हासिल की जा सकती है और उनका कॉन्टेंट ऐक्सेस किया जा सकता है. इस गाइड में, मीडिया आइटम को सूची में शामिल करने और वापस पाने की प्रोसेस के बारे में बताया गया है.

शुरू करने से पहले

  • फ़्लो को समझना: फ़ोटो चुनने की पूरी प्रोसेस के बारे में खास जानकारी पाने के लिए, Picker API का इस्तेमाल शुरू करना देखें.
  • मीडिया आइटम चुनना पूरा करना: पक्का करें कि उपयोगकर्ता ने अपने सेशन से मीडिया आइटम चुने हों. ज़्यादा जानकारी के लिए, सेशन के बारे में गाइड देखें.
  • अनुमति के ज़रूरी दायरों की समीक्षा करें: सेशन के साथ काम करने के लिए, photospicker.mediaitems.readonly दायरे की ज़रूरत होती है. स्कोप के बारे में ज़्यादा जानकारी के लिए, अनुमति के स्कोप देखें.

चुने गए मीडिया आइटम की सूची

  1. mediaItems.list एंडपॉइंट का इस्तेमाल करें: क्वेरी पैरामीटर के तौर पर sessionId का इस्तेमाल करके, https://photospicker.googleapis.com/v1/mediaItems पर GET अनुरोध करें.

  2. पेजेशन को मैनेज करें (अगर ज़रूरी हो):

    अगर उपयोगकर्ता ने कई आइटम चुने हैं, तो हो सकता है कि जवाब को पेज पर दिखाया जाए. नतीजों के अगले पेज देखने के लिए, जवाब में nextPageToken का इस्तेमाल करें.

  3. मीडिया आइटम प्रोसेस करें: जवाब में PickedMediaItem ऑब्जेक्ट का कलेक्शन होगा. हर ऑब्जेक्ट, चुने गए मीडिया आइटम को दिखाता है. इन ऑब्जेक्ट में ज़रूरी जानकारी शामिल होती है, जैसे:

    • id: मीडिया आइटम का यूनीक आइडेंटिफ़ायर.
    • baseUrl: वह बेस यूआरएल जिससे मीडिया आइटम के कॉन्टेंट को अलग-अलग रिज़ॉल्यूशन में ऐक्सेस करने के लिए यूआरएल बनाए जा सकते हैं.
    • mimeType: मीडिया आइटम का एमआईएम टाइप (उदाहरण के लिए, image/jpeg, video/mp4).

चुने गए मीडिया आइटम वापस पाना

पक्का करें कि आपके पास अपने अनुरोधों को अनुमति देने के लिए, https://www.googleapis.com/auth/photospicker.mediaitems.readonly स्कोप वाला मान्य OAuth 2.0 ऐक्सेस टोकन हो.

  • कॉन्टेंट का यूआरएल बनाएं: PickedMediaItem ऑब्जेक्ट में मौजूद baseUrl का इस्तेमाल करें. baseUrl में रिज़ॉल्यूशन या फ़ाइल फ़ॉर्मैट जोड़ें. ज़्यादा जानकारी के लिए, बेस यूआरएल वाला सेक्शन देखें.

  • कॉन्टेंट फ़ेच करना: मीडिया आइटम के बेस यूआरएल पर GET अनुरोध करें. रिस्पॉन्स में, मीडिया आइटम (इमेज या वीडियो) के बाइट शामिल होंगे. baseURL के कई अलग-अलग विकल्प उपलब्ध हैं.

बेस यूआरएल

Google Photos API में मौजूद बेस यूआरएल, मीडिया आइटम के रॉ बाइट का ऐक्सेस देते हैं. इससे आपके ऐप्लिकेशन को उन्हें डाउनलोड या दिखाने में मदद मिलती है. ये यूआरएल, लाइब्रेरी एपीआई की मदद से एल्बम की सूची बनाते समय या लाइब्रेरी और पिकर, दोनों एपीआई की मदद से मीडिया आइटम ऐक्सेस करते समय, रिस्पॉन्स में शामिल किए जाते हैं. याद रखें कि बेस यूआरएल के सही तरीके से काम करने के लिए, ज़्यादा पैरामीटर की ज़रूरत होती है.

Picker API के लिए:

सभी PickedMediaItem.mediaFile ऑब्जेक्ट में एक baseUrl शामिल होता है.

बेस यूआरएल 60 मिनट तक चालू रहते हैं. हालांकि, अगर उपयोगकर्ता अपने Google खाते की सेटिंग में जाकर, आपके ऐप्लिकेशन की अनुमतियां रद्द कर देता है, तो इनकी समयसीमा खत्म हो सकती है.

Library API के लिए:

बेस यूआरएल 60 मिनट तक चालू रहते हैं.

अलग-अलग बेस यूआरएल ये हैं:

  • baseUrl: सीधे किसी फ़ोटो या वीडियो के थंबनेल को ऐक्सेस करना या वीडियो के बाइट डाउनलोड करना.
  • coverPhotoBaseUrl: एल्बम की कवर फ़ोटो को सीधे ऐक्सेस करें.
  • profilePictureBaseUrl: mediaItem के मालिक की प्रोफ़ाइल फ़ोटो को सीधे ऐक्सेस करें.

इमेज के बेस यूआरएल

यहां उन विकल्पों की सूची दी गई है जिनका इस्तेमाल इमेज के बेस यूआरएल के साथ किया जा सकता है:

पैरामीटर
w, h

जानकारी

चौड़ाई, w और ऊंचाई, h पैरामीटर.

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

उदाहरण:

base-url=wmax-width-hmax-height

यहां एक उदाहरण दिया गया है, जिसमें मीडिया आइटम की चौड़ाई 2048 पिक्सल और ऊंचाई 1024 पिक्सल से ज़्यादा नहीं है:

https://lh3.googleusercontent.com/p/AF....VnnY=w2048-h1024
c

जानकारी

फ़ोटो का काटा गया हिस्सा, c पैरामीटर.

अगर आपको इमेज को अपनी तय की गई चौड़ाई और लंबाई के डाइमेंशन में काटना है, तो ज़रूरी w और h पैरामीटर के साथ-साथ, वैकल्पिक -c पैरामीटर के साथ बेस यूआरएल को जोड़ें.

साइज़ (पिक्सल में), [1, 16383] की रेंज में होना चाहिए. अगर इमेज की चौड़ाई या ऊंचाई, अनुरोध किए गए साइज़ से ज़्यादा है, तो इमेज को आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) बनाए रखते हुए, छोटा और काटा जाता है.

उदाहरण:

base-url=wmax-width-hmax-height-c

इस उदाहरण में, ऐप्लिकेशन ऐसा मीडिया आइटम दिखाता है जो बिल्कुल 256 पिक्सल चौड़ा और 256 पिक्सल ऊंचा होता है. जैसे, कोई थंबनेल:

https://lh3.googleusercontent.com/p/AF....VnnY=w256-h256-c
d

जानकारी

डाउनलोड, d पैरामीटर.

अगर आपको जगह की जानकारी वाले मेटाडेटा को छोड़कर, इमेज का सारा Exif मेटाडेटा बरकरार रखते हुए उसे डाउनलोड करना है, तो बेस यूआरएल को d पैरामीटर के साथ जोड़ें.

उदाहरण:

base-url=d

इस उदाहरण में, ऐप्लिकेशन जगह की जानकारी वाले मेटाडेटा को छोड़कर, सभी मेटाडेटा के साथ इमेज डाउनलोड करता है:

https://lh3.googleusercontent.com/p/Az....XabC=d

वीडियो के बेस यूआरएल

यहां उन विकल्पों की सूची दी गई है जिनका इस्तेमाल वीडियो के बेस यूआरएल के साथ किया जा सकता है:

पैरामीटर
dv

जानकारी

किसी वीडियो mediaItem के बाइट ऐक्सेस करने के लिए, baseUrl को डाउनलोड किए गए वीडियो dv पैरामीटर के साथ जोड़ें.

dv पैरामीटर, ओरिजनल वीडियो के अच्छी क्वालिटी वाले ट्रांसकोड किए गए वर्शन का अनुरोध करता है. यह पैरामीटर, w और h पैरामीटर के साथ काम नहीं करता.

वीडियो डाउनलोड करने के लिए बेस यूआरएल से, बिट भेजने में कुछ सेकंड लग सकते हैं.

इस पैरामीटर का इस्तेमाल करने से पहले, देख लें कि मीडिया आइटम का mediaMetadata.status फ़ील्ड READY हो. अगर आपका मीडिया आइटम प्रोसेस नहीं हो पाया है, तो आपको गड़बड़ी का मैसेज मिल सकता है.

उदाहरण:

base-url=dv

यहां दिए गए उदाहरण में, किसी वीडियो के बाइट डाउनलोड करने का तरीका बताया गया है:

https://lh3.googleusercontent.com/p/AF....BsdZ=dv
w, h, c, और d

जानकारी

वीडियो का थंबनेल ऐक्सेस करने के लिए, इमेज के बेस यूआरएल के किसी भी पैरामीटर का इस्तेमाल करें.

डिफ़ॉल्ट रूप से, सभी वीडियो थंबनेल में वीडियो चलाने के बटन का ओवरले शामिल होता है. इस ओवरले को हटाने के लिए, -no पैरामीटर देखें.

उदाहरण:

उदाहरणों के लिए, इमेज के बेस यूआरएल की टेबल देखें.
no

जानकारी

थंबनेल ओवरले हटाएं, no पैरामीटर.

अगर आपको वीडियो का थंबनेल, वीडियो चलाने के बटन के ओवरले के बिना पाना है, तो बेस यूआरएल को no पैरामीटर के साथ जोड़ें.

no पैरामीटर का इस्तेमाल, कम से कम एक इमेज के बेस यूआरएल पैरामीटर के साथ किया जाना चाहिए.

उदाहरण:

base-url=wmax-width-hmax-height-no

नीचे दिए गए उदाहरण में, वीडियो का ऐसा थंबनेल दिखाया गया है जिसकी चौड़ाई 1280 पिक्सल और ऊंचाई 720 पिक्सल है. साथ ही, इसमें वीडियो चलाने के बटन का ओवरले नहीं है:

https://lh3.googleusercontent.com/p/AF....VnnY=w1280-h720-no

मोशन फ़ोटो के बेस यूआरएल

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

पैरामीटर
dv

जानकारी

मोशन फ़ोटो मीडिया आइटम का वीडियो एलिमेंट पाने के लिए, dv पैरामीटर का इस्तेमाल उसी तरह करें जिस तरह वीडियो के बेस यूआरएल से डाउनलोड किया जाता है.
w, h, c, और d

जानकारी

मोशन फ़ोटो मीडिया आइटम का फ़ोटो एलिमेंट पाने के लिए, इमेज के बेस यूआरएल के फ़ॉर्मैट का इस्तेमाल करें.