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 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "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)

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

फ़ोटो

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

JSON के काेड में दिखाना
{
  "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 (फ़्रेम प्रति सेकंड) और प्रोसेसिंग की स्थिति. ऐसा हो सकता है कि इनमें से कुछ फ़ील्ड खाली हों या शामिल न किए गए हों.

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

batchGet

get

list

patch

मीडिया आइटम को बताए गए id के साथ अपडेट करें.