Method: mediaItems.batchCreate

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

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

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

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

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

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

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

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

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

अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:

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

string

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

object (NewMediaItem)

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

object (AlbumPosition)

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

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

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

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

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

object (NewMediaItemResult)

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

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

इनमें से किसी एक OAuth दायरों की ज़रूरत होती है:

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

NewMediaItem

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

जेएसओएन के काेड में दिखाना 
{
  "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 में सामान्य मीडिया आइटम बनाया जा सकता है.

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

string

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

string

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

NewMediaItemResult

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

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

string

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

object (Status)

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

object (MediaItem)

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