REST Resource: mediaItems

रिसॉर्स: MediaItem

Google Photos में किसी मीडिया आइटम (जैसे, फ़ोटो या वीडियो) की इमेज.

JSON के काेड में दिखाना 
{
  "id": string,
  "description": string,
  "productUrl": string,
  "baseUrl": string,
  "mimeType": string,
  "mediaMetadata": {
    object (MediaMetadata)
  },
  "contributorInfo": {
    object (ContributorInfo)
  },
  "filename": string
}
फ़ील्ड
id

string

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

string

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

string

मीडिया आइटम का Google Photos यूआरएल. यह लिंक, उपयोगकर्ता के लिए सिर्फ़ तब उपलब्ध होता है, जब वह साइन इन करता है. एल्बम में खोजने पर, यूआरएल एल्बम में मौजूद आइटम पर ले जाता है.
baseUrl

string

मीडिया आइटम के बाइट का यूआरएल. इसका इस्तेमाल इस तरह नहीं किया जाना चाहिए. इस्तेमाल करने से पहले, इस यूआरएल में पैरामीटर जोड़ने चाहिए. साथ में काम करने वाले पैरामीटर की पूरी सूची देखने के लिए, डेवलपर दस्तावेज़ देखें. उदाहरण के लिए, '=w2048-h1024', फ़ोटो टाइप के मीडिया आइटम के डाइमेंशन को 2048 पिक्सल चौड़ाई और 1024 पिक्सल ऊंचाई पर सेट करेगा.
mimeType

string

मीडिया आइटम का MIME टाइप. उदाहरण के लिए, image/jpeg.
mediaMetadata

object (MediaMetadata)

मीडिया आइटम से जुड़ा मेटाडेटा, जैसे कि ऊंचाई, चौड़ाई या बनाने का समय.
contributorInfo

object (ContributorInfo)

इस मीडिया आइटम को जोड़ने वाले उपयोगकर्ता के बारे में जानकारी. ध्यान दें कि यह सिर्फ़ तब शामिल किया जाता है, जब शेयर किए गए एल्बम के आईडी के साथ mediaItems.search का इस्तेमाल किया जाता है. एल्बम को आपके ऐप्लिकेशन से बनाया जाना चाहिए. साथ ही, आपके पास एल्बम शेयर करने का स्कोप होना चाहिए.
filename

string

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

MediaMetadata

मीडिया आइटम का मेटाडेटा.

JSON के काेड में दिखाना 
{
  "creationTime": string,
  "width": string,
  "height": string,

  // Union field metadata can be only one of the following:
  "photo": {
    object (Photo)
  },
  "video": {
    object (Video)
  }
  // End of list of possible types for union field metadata.
}
फ़ील्ड
creationTime

string (Timestamp format)

मीडिया आइटम को पहली बार बनाने का समय (Google Photos पर अपलोड करने का समय नहीं).

आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़्ड होगा और इसमें 0, 3, 6 या 9 दशमलव अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
width

string (int64 format)

मीडिया आइटम की ओरिजनल चौड़ाई (पिक्सल में).
height

string (int64 format)

मीडिया आइटम की ओरिजनल ऊंचाई (पिक्सल में).
यूनियन फ़ील्ड metadata. मीडिया आइटम का मेटाडेटा, जो उसमें मौजूद मीडिया टाइप के हिसाब से होता है. metadata इनमें से कोई एक हो सकता है:
photo

object (Photo)

फ़ोटो के मीडिया टाइप का मेटाडेटा.
video

object (Video)

वीडियो मीडिया टाइप का मेटाडेटा.

फ़ोटो

फ़ोटो से जुड़ा मेटाडेटा, जैसे कि ISO, फ़ोकल लेंथ, और एक्सपोज़र का समय. इनमें से कुछ फ़ील्ड शायद खाली हों या इनमें कोई वैल्यू शामिल न की गई हो.

JSON के काेड में दिखाना 
{
  "cameraMake": string,
  "cameraModel": string,
  "focalLength": number,
  "apertureFNumber": number,
  "isoEquivalent": integer,
  "exposureTime": string
}
फ़ील्ड
cameraMake

string

उस कैमरे का ब्रैंड जिससे फ़ोटो ली गई थी.
cameraModel

string

उस कैमरे का मॉडल जिससे फ़ोटो ली गई थी.
focalLength

number

उस कैमरे के लेंस की फ़ोकल लेंथ जिससे फ़ोटो ली गई थी.
apertureFNumber

number

उस कैमरे लेंस का अपर्चर एफ़ नंबर जिससे फ़ोटो ली गई थी.
isoEquivalent

integer

उस कैमरे का आईएसओ जिससे फ़ोटो ली गई थी.
exposureTime

string (Duration format)

फ़ोटो खींचने के दौरान, कैमरे के अपर्चर का एक्सपोज़र समय.

सेकंड में कुल अवधि, जिसमें दशमलव के बाद नौ अंक हो सकते हैं. यह अवधि 's' पर खत्म होती है. उदाहरण: "3.5s".

वीडियो

किसी वीडियो से जुड़ा मेटाडेटा. उदाहरण के लिए, फ़्रेम प्रति सेकंड (एफ़पीएस) और प्रोसेसिंग का स्टेटस. इनमें से कुछ फ़ील्ड शायद खाली हों या इनमें कोई वैल्यू शामिल न की गई हो.

JSON के काेड में दिखाना 
{
  "cameraMake": string,
  "cameraModel": string,
  "fps": number,
  "status": enum (VideoProcessingStatus)
}
फ़ील्ड
cameraMake

string

उस कैमरे का ब्रैंड जिससे वीडियो रिकॉर्ड किया गया था.
cameraModel

string

उस कैमरे का मॉडल जिससे वीडियो रिकॉर्ड किया गया था.
fps

number

वीडियो का फ़्रेम रेट.
status

enum (VideoProcessingStatus)

वीडियो के प्रोसेस होने की स्थिति.

VideoProcessingStatus

Google Photos पर अपलोड किए जा रहे वीडियो की प्रोसेसिंग की स्थिति.

Enums
UNSPECIFIED वीडियो प्रोसेस करने की स्थिति के बारे में जानकारी नहीं है.
PROCESSING वीडियो को प्रोसेस किया जा रहा है. उपयोगकर्ता को Google Photos ऐप्लिकेशन में इस वीडियो का आइकॉन दिखता है. हालांकि, इसे अभी नहीं चलाया जा सकता.
READY वीडियो प्रोसेस हो गया है और अब उसे देखा जा सकता है. अहम जानकारी: अगर वीडियो 'तैयार है' स्टेटस में नहीं है, तो हो सकता है कि उसे डाउनलोड न किया जा सके.
FAILED कोई गड़बड़ी हुई है और वीडियो प्रोसेस नहीं हो सका.

ContributorInfo

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

JSON के काेड में दिखाना 
{
  "profilePictureBaseUrl": string,
  "displayName": string
}
फ़ील्ड
profilePictureBaseUrl

string

योगदान देने वाले व्यक्ति की प्रोफ़ाइल फ़ोटो का यूआरएल.
displayName

string

योगदान देने वाले का डिसप्ले नेम.

तरीके

batchCreate

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

batchGet

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

get

 बताए गए मीडिया आइटम आइडेंटिफ़ायर के लिए, ऐप्लिकेशन से बनाया गया मीडिया आइटम दिखाता है.

list

 उपयोगकर्ता की Google Photos लाइब्रेरी में, आपके ऐप्लिकेशन से बनाए गए सभी मीडिया आइटम की सूची बनाएं.

patch

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