- एचटीटीपी अनुरोध
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- NewMediaItem
- SimpleMediaItem
- NewMediaItemResult
- इसे आज़माएं!
उपयोगकर्ता की Google Photos लाइब्रेरी में एक या उससे ज़्यादा मीडिया आइटम बनाता है.
मीडिया आइटम बनाने का यह दूसरा चरण है. चरण 1, Google सर्वर पर रॉ बाइट अपलोड करने से जुड़ी ज़्यादा जानकारी के लिए, मीडिया अपलोड करना देखें.
इस कॉल से मीडिया आइटम, लाइब्रेरी में जुड़ जाता है. अगर किसी एल्बम id
के बारे में बताया जाता है, तो कॉल भी एल्बम में मीडिया आइटम जोड़ देता है. हर एल्बम में 20,000 मीडिया आइटम हो सकते हैं. डिफ़ॉल्ट रूप से, मीडिया आइटम को लाइब्रेरी या एल्बम के आखिर में जोड़ा जाएगा.
अगर एल्बम id
और जगह, दोनों को परिभाषित किया गया है, तो मीडिया आइटम को तय जगह पर एल्बम में जोड़ा जाता है.
अगर कॉल में कई मीडिया आइटम हैं, तो उन्हें तय की गई जगह पर जोड़ा जाता है. अगर आप किसी ऐसे शेयर किए गए एल्बम में मीडिया आइटम बना रहे हैं जिसके आप मालिक नहीं हैं, तो आपको मीडिया आइटम को रखने की अनुमति नहीं है. ऐसा करने से BAD REQUEST
गड़बड़ी होगी.
एचटीटीपी अनुरोध
POST https://photoslibrary.googleapis.com/v1/mediaItems:batchCreate
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:
जेएसओएन के काेड में दिखाना |
---|
{ "albumId": string, "newMediaItems": [ { object ( |
फ़ील्ड | |
---|---|
albumId |
उस एल्बम का आइडेंटिफ़ायर जिसमें मीडिया आइटम जोड़े गए हैं. मीडिया आइटम भी उपयोगकर्ता की लाइब्रेरी में जोड़ दिए जाते हैं. यह फ़ील्ड ज़रूरी नहीं है. |
newMediaItems[] |
ज़रूरी है. बनाए जाने वाले मीडिया आइटम की सूची. हर कॉल में ज़्यादा से ज़्यादा 50 मीडिया आइटम. |
albumPosition |
एल्बम में वह जगह रखें जहां मीडिया आइटम जोड़े गए हैं. अगर इसके बारे में नहीं बताया गया है, तो मीडिया आइटम को एल्बम के आखिर में जोड़ दिया जाता है (डिफ़ॉल्ट वैल्यू यानी |
जवाब का मुख्य भाग
मीडिया आइटम की सूची बनाई गई.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{
"newMediaItemResults": [
{
object ( |
फ़ील्ड | |
---|---|
newMediaItemResults[] |
सिर्फ़ आउटपुट के लिए. मीडिया आइटम की सूची बनाई गई. |
अनुमति के दायरे
इनमें से किसी एक 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 |
फ़ील्ड | |
---|---|
description |
मीडिया आइटम की जानकारी. यह जानकारी, उपयोगकर्ता को Google Photos ऐप्लिकेशन में आइटम की जानकारी वाले सेक्शन में दिखती है. इसमें 1,000 से कम वर्ण होने चाहिए. सिर्फ़ उपयोगकर्ताओं का लिखा टेक्स्ट शामिल करें. ब्यौरे में संदर्भ जोड़ने और मीडिया को समझने में लोगों की मदद होनी चाहिए. अपने-आप जनरेट हुई कोई भी स्ट्रिंग शामिल न करें, जैसे कि फ़ाइल के नाम, टैग, और दूसरा मेटाडेटा. |
यूनियन फ़ील्ड new_media_item_type . नया मीडिया आइटम कई तरह का हो सकता है - यह अपलोड पाथ पर निर्भर करता है. फ़िलहाल, अपलोड किए जा सकने वाले आइटम में मीडिया आइटम के सामान्य पाथ का इस्तेमाल किया जाता है. new_media_item_type इनमें से सिर्फ़ एक हो सकती है: |
|
simpleMediaItem |
एक नया मीडिया आइटम, जिसे शामिल किए गए |
SimpleMediaItem
अपलोड टोकन की मदद से, Google Photos में सामान्य मीडिया आइटम बनाया जा सकता है.
जेएसओएन के काेड में दिखाना |
---|
{ "uploadToken": string, "fileName": string } |
फ़ील्ड | |
---|---|
uploadToken |
Google पर अपलोड किए गए मीडिया बाइट की पहचान करने वाला टोकन. |
fileName |
मीडिया आइटम के एक्सटेंशन के साथ फ़ाइल का नाम. यह उपयोगकर्ता को Google Photos में दिखता है. अगर यह फ़ील्ड सेट है, तो बाइट अपलोड प्रोसेस के दौरान बताए गए फ़ाइल नाम को अनदेखा कर दिया जाता है. फ़ाइल के नाम के साथ-साथ, फ़ाइल एक्सटेंशन में 255 से ज़्यादा वर्ण नहीं होने चाहिए. यह फ़ील्ड ज़रूरी नहीं है. |
NewMediaItemResult
नया मीडिया आइटम बनाने का नतीजा.
जेएसओएन के काेड में दिखाना |
---|
{ "uploadToken": string, "status": { object ( |
फ़ील्ड | |
---|---|
uploadToken |
इस नए (आसान) मीडिया आइटम को बनाने के लिए, अपलोड टोकन का इस्तेमाल किया गया. सिर्फ़ तब अपने-आप जानकारी भर जाती है, जब मीडिया आइटम आसान हो और उसके लिए एक अपलोड टोकन की ज़रूरत हो. |
status |
अगर इस मीडिया आइटम को बनाते समय कोई गड़बड़ी होती है, तो इस फ़ील्ड में गड़बड़ी से जुड़ी जानकारी अपने-आप भर जाती है. इस फ़ील्ड से जुड़ी जानकारी के लिए, स्टेटस देखें. |
mediaItem |
अपलोड टोकन का इस्तेमाल करके बनाया गया मीडिया आइटम. अगर कोई गड़बड़ी नहीं होती है और मीडिया आइटम बन जाता है, तो इसकी जानकारी अपने-आप भर जाती है. |