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)

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

फ़ोटो

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

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".

वीडियो

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

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 लाइब्रेरी में मीडिया आइटम खोजता है.