ऐप्लिकेशन से बनाए गए मीडिया आइटम ऐक्सेस करना

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

अनुमति के लिए ज़रूरी स्कोप

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

मीडिया आइटम

mediaItem, Google Photos लाइब्रेरी में अपलोड की गई फ़ोटो या वीडियो जैसे मीडिया का प्रतिनिधित्व करता है. यह एक टॉप-लेवल ऑब्जेक्ट है और इसके मीडिया टाइप के आधार पर, इसकी प्रॉपर्टी अलग-अलग हो सकती हैं.

यहां दी गई टेबल में mediaItem प्रॉपर्टी की सूची दी गई है:

मीडिया आइटम पाना

मीडिया आइटम वापस पाने के लिए, mediaItemId का इस्तेमाल करके mediaItems.get को कॉल करें. इस अनुरोध से एक मीडिया आइटम मिलता है.

mediaItem में आईडी, ब्यौरा, और यूआरएल जैसी प्रॉपर्टी होती हैं. photo या video में मौजूद अतिरिक्त जानकारी, फ़ाइल में मौजूद मेटाडेटा पर आधारित होती है. ऐसा हो सकता है कि सभी प्रॉपर्टी मौजूद न हों.

अगर मीडिया आइटम कोई वीडियो है, तो वीडियो फ़ाइल को पहले प्रोसेस करना होगा. mediaItem में mediaMetadata के अंदर एक status फ़ील्ड होता है, जिसमें वीडियो फ़ाइल की प्रोसेसिंग की स्थिति के बारे में बताया जाता है. नई अपलोड की गई फ़ाइल, PROCESSING वैल्यू के साथ videoProcessingStatus दिखाती है. इसके बाद, इसे READY के तौर पर इस्तेमाल किया जा सकता है. वीडियो मीडिया आइटम का baseUrl तब तक उपलब्ध नहीं होता, जब तक वीडियो को प्रोसेस नहीं किया जाता.

GET https://photoslibrary.googleapis.com/v1/mediaItems/media-item-id
Content-type: application/json
Authorization: Bearer oauth2-token

{
  "id": "media-item-id",
  "description": "item-description",
  "productUrl": "url-to-open-in-google-photos",
  "baseUrl": "base-url_do-not-use-directly",
  "mimeType": "mime-type-of-media",
  "filename": "item-filename",
  "mediaMetadata": {
    "width": "media-item-width",
    "height": "media-item-height",
    "creationTime": "media-item-creation-time",
    "photo": {
       "cameraMake": "make-of-the-camera",
       "cameraModel": "model-of-the-camera",
       "focalLength": "focal-length-of-the-camera-lens",
       "apertureFNumber": "aperture-f-number-of-the-camera-lens",
       "isoEquivalent": "iso-of-the-camera",
       "exposureTime": "exposure-time-of-the-camera-aperture"
    }
  },
  "contributorInfo": {
    "profilePictureBaseUrl": "profile-picture-base-url_do-not-use-directly",
    "displayName": "name-of-user"
  }
}

{
  "id": "media-item-id",
  "description": "item-description",
  "productUrl": "url-to-open-in-google-photos",
  "baseUrl": "base-url_do-not-use-directly",
  "mimeType": "mime-type-of-media",
  "filename": "item-filename",
  "mediaMetadata": {
    "width": "media-item-width",
    "height": "media-item-height",
    "creationTime": "media-item-creation-time",
    "video": {
     "cameraMake": "make-of-the-camera",
     "cameraModel": "model-of-the-camera",
     "fps": "frame-rate-of-the-video",
     "status": "READY"
    },
  },
  "contributorInfo": {
    "profilePictureBaseUrl": "profile-picture-base-url_do-not-use-directly",
    "displayName": "name-of-user"
  }
}

एक से ज़्यादा मीडिया आइटम पाना

आइडेंटिफ़ायर के हिसाब से एक से ज़्यादा मीडिया आइटम वापस पाने के लिए, mediaItemId का इस्तेमाल करके mediaItems.batchGet को कॉल करें.

अनुरोध में दिए गए मीडिया आइटम आइडेंटिफ़ायर के क्रम में, यह अनुरोध MediaItemResults की सूची दिखाता है. हर नतीजे में MediaItem या Status दिखता है. अगर कोई गड़बड़ी हुई है, तो Status दिखता है.

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

GET https://photoslibrary.googleapis.com/v1/mediaItems:batchGet?mediaItemIds=media-item-id&mediaItemIds=another-media-item-id&mediaItemIds=incorrect-media-item-id
Content-type: application/json
Authorization: Bearer oauth2-token

{
  "mediaItemResults": [
    {
      "mediaItem": {
        "id": "media-item-id",
        ...
      }
    },
    {
      "mediaItem": {
        "id": "another-media-item-id",
        ...
      }
    },
    {
      "status": {
        "code": 3,
        "message": "Invalid media item ID."
      }
    }
  ]
}

बेस यूआरएल

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

Picker API के लिए:

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

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

Library API के लिए:

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

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

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

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

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

base-url=wmax-width-hmax-height

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

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

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

base-url=d

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

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

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

base-url=dv

https://lh3.googleusercontent.com/p/AF....BsdZ=dv

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

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

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

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