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 ऐप्लिकेशन में, आइटम की जानकारी वाले सेक्शन में दिखता है. इसमें 1000 से कम वर्ण होने चाहिए. सिर्फ़ उपयोगकर्ताओं का लिखा हुआ टेक्स्ट शामिल करें. ब्यौरे में संदर्भ जोड़ना चाहिए. साथ ही, उपयोगकर्ता मीडिया को आसानी से समझ सकें. अपने-आप जनरेट होने वाली कोई भी स्ट्रिंग शामिल न करें. जैसे: फ़ाइल नाम, टैग, और अन्य मेटाडेटा.

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 ऐप्लिकेशन में, आइटम की जानकारी वाले सेक्शन में उपयोगकर्ता को दिखती है.

मीडिया मेटाडेटा

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

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

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)

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

इमेज

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

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

string

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

cameraModel

string

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

focalLength

number

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

apertureFNumber

number

कैमरे के उस लेंस की एपर्चर f जिससे फ़ोटो ली गई.

isoEquivalent

integer

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

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)

वीडियो की प्रोसेसिंग स्थिति.

वीडियोप्रोसेसिंग की स्थिति

Google Photos पर अपलोड हो रहे वीडियो का स्टेटस.

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

योगदानकर्ता जानकारी

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

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

string

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

displayName

string

योगदान देने वाले का नाम दिखाया जा रहा है.

तरीके

batchCreate

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

batchGet

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

get

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

list

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

patch

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