Method: mediaItems.batchCreate

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

मीडिया आइटम बनाने का यह दूसरा चरण है. पहले चरण के बारे में जानकारी पाने के लिए, Google सर्वर पर रॉ बाइट अपलोड करने के बारे में मीडिया अपलोड करना लेख पढ़ें.

इस कॉल से, मीडिया आइटम को लाइब्रेरी में जोड़ा जाता है. अगर ऐप्लिकेशन से बनाए गए एल्बम id की जानकारी दी जाती है, तो कॉल से मीडिया आइटम को एल्बम में भी जोड़ दिया जाता है. हर एल्बम में ज़्यादा से ज़्यादा 20,000 मीडिया आइटम हो सकते हैं. डिफ़ॉल्ट रूप से, मीडिया आइटम को लाइब्रेरी या एल्बम में सबसे आखिर में जोड़ा जाएगा.

अगर एल्बम id और पोज़िशन, दोनों की जानकारी दी गई है, तो मीडिया आइटम को एल्बम में बताई गई पोज़िशन पर जोड़ दिया जाता है.

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

एचटीटीपी अनुरोध

POST https://photoslibrary.googleapis.com/v1/mediaItems:batchCreate

यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य भाग में नीचे दिए गए स्ट्रक्चर वाला डेटा होता है:

JSON के काेड में दिखाना 
{
  "albumId": string,
  "newMediaItems": [
    {
      object (NewMediaItem)
    }
  ],
  "albumPosition": {
    object (AlbumPosition)
  }
}
फ़ील्ड
albumId

string

उस एल्बम का आइडेंटिफ़ायर जिसमें मीडिया आइटम जोड़े गए हैं. मीडिया आइटम, उपयोगकर्ता की लाइब्रेरी में भी जोड़ दिए जाते हैं. यह फ़ील्ड ज़रूरी नहीं है.
newMediaItems[]

object (NewMediaItem)

ज़रूरी है. बनाए जाने वाले मीडिया आइटम की सूची. हर कॉल में ज़्यादा से ज़्यादा 50 मीडिया आइटम.
albumPosition

object (AlbumPosition)

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

जवाब का मुख्य भाग

बनाए गए मीडिया आइटम की सूची.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON के काेड में दिखाना 
{
  "newMediaItemResults": [
    {
      object (NewMediaItemResult)
    }
  ]
}
फ़ील्ड
newMediaItemResults[]

object (NewMediaItemResult)

सिर्फ़ आउटपुट के लिए. बनाए गए मीडिया आइटम की सूची.

अनुमति के दायरे

इसके लिए, OAuth के इनमें से किसी एक स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/photoslibrary.appendonly

NewMediaItem

उपयोगकर्ता के Google Photos खाते में बनाया गया नया मीडिया आइटम.

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

  // Union field new_media_item_type can be only one of the following:
  "simpleMediaItem": {
    object (SimpleMediaItem)
  }
  // End of list of possible types for union field new_media_item_type.
}
फ़ील्ड
description

string

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

object (SimpleMediaItem)

शामिल किए गए uploadToken की मदद से अपलोड किया गया नया मीडिया आइटम.

SimpleMediaItem

अपलोड टोकन की मदद से, Google Photos में बनाया जाने वाला एक आसान मीडिया आइटम.

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

string

Google पर अपलोड किए गए मीडिया बाइट की पहचान करने वाला टोकन.
fileName

string

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

NewMediaItemResult

नया मीडिया आइटम बनाने का नतीजा.

JSON के काेड में दिखाना 
{
  "uploadToken": string,
  "status": {
    object (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
फ़ील्ड
uploadToken

string

इस नए (साधारण) मीडिया आइटम को बनाने के लिए इस्तेमाल किया गया अपलोड टोकन. यह सिर्फ़ तब पॉप्युलेट होता है, जब मीडिया आइटम आसान हो और उसे अपलोड करने के लिए एक ही टोकन की ज़रूरत हो.
status

object (Status)

अगर इस मीडिया आइटम को बनाते समय कोई गड़बड़ी हुई है, तो इस फ़ील्ड में गड़बड़ी से जुड़ी जानकारी अपने-आप भर जाएगी. इस फ़ील्ड के बारे में ज़्यादा जानकारी के लिए, स्थिति देखें.
mediaItem

object (MediaItem)

अपलोड टोकन की मदद से बनाया गया मीडिया आइटम. अगर कोई गड़बड़ी नहीं हुई और मीडिया आइटम बन गया, तो यह फ़ील्ड अपने-आप पॉप्युलेट हो जाता है.