REST Resource: mediaItems

संसाधन: MediaItem

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

जेएसओएन के काेड में दिखाना 
{
  "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

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

जेएसओएन के काेड में दिखाना 
{
  "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 पर अपलोड किया गया था).

RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड का रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक हो सकते हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
width

string (int64 format)

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

string (int64 format)

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

object (Photo)

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

object (Video)

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

फ़ोटो

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

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

string

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

string

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

number

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

number

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

integer

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

string (Duration format)

फ़ोटो लिए जाने के समय, कैमरे के एपर्चर का एक्सपोज़र समय.

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

वीडियो

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

जेएसओएन के काेड में दिखाना 
{
  "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

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

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

string

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

string

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

तरीके

batchCreate

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

batchGet

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

get

 दिए गए मीडिया आइटम आइडेंटिफ़ायर के लिए मीडिया आइटम दिखाता है.

list

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

patch

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