Method: mediaItems.batchCreate

ব্যবহারকারীর Google Photos লাইব্রেরিতে এক বা একাধিক মিডিয়া আইটেম তৈরি করে।

এটি একটি মিডিয়া আইটেম তৈরি করার জন্য দ্বিতীয় ধাপ। ধাপ 1 সম্পর্কিত বিশদ বিবরণের জন্য, একটি Google সার্ভারে কাঁচা বাইট আপলোড করা, মিডিয়া আপলোড করা দেখুন।

এই কল লাইব্রেরিতে মিডিয়া আইটেম যোগ করে। একটি অ্যালবাম id নির্দিষ্ট করা থাকলে, কলটি অ্যালবামেও মিডিয়া আইটেম যোগ করে। প্রতিটি অ্যালবামে 20,000টি মিডিয়া আইটেম থাকতে পারে। ডিফল্টরূপে, লাইব্রেরি বা অ্যালবামের শেষে মিডিয়া আইটেম যোগ করা হবে।

যদি একটি অ্যালবাম id এবং অবস্থান উভয়ই সংজ্ঞায়িত করা হয়, তবে মিডিয়া আইটেমটি নির্দিষ্ট অবস্থানে অ্যালবামে যোগ করা হয়।

কলটিতে একাধিক মিডিয়া আইটেম থাকলে, সেগুলি নির্দিষ্ট অবস্থানে যোগ করা হয়। আপনি যদি একটি শেয়ার্ড অ্যালবামে একটি মিডিয়া আইটেম তৈরি করেন যেখানে আপনি মালিক নন, তাহলে আপনাকে মিডিয়া আইটেমটি অবস্থান করার অনুমতি দেওয়া হবে না৷ এটি করার ফলে একটি BAD REQUEST ত্রুটি হবে৷

HTTP অনুরোধ

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

URL 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
  • https://www.googleapis.com/auth/photoslibrary.appendonly
  • https://www.googleapis.com/auth/photoslibrary.sharing

নিউমিডিয়া আইটেম

একটি ব্যবহারকারীর 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 অ্যাপে আইটেমের তথ্য বিভাগে ব্যবহারকারীকে দেখানো হয়। 1000 অক্ষরের চেয়ে ছোট হতে হবে। শুধুমাত্র ব্যবহারকারীদের দ্বারা লিখিত টেক্সট অন্তর্ভুক্ত. বর্ণনায় প্রসঙ্গ যোগ করা উচিত এবং ব্যবহারকারীদের মিডিয়া বুঝতে সাহায্য করা উচিত। ফাইলের নাম, ট্যাগ এবং অন্যান্য মেটাডেটার মতো কোনো স্বয়ংক্রিয়ভাবে তৈরি স্ট্রিং অন্তর্ভুক্ত করবেন না।

ইউনিয়ন ক্ষেত্র new_media_item_type . নতুন মিডিয়া আইটেম বিভিন্ন ধরনের হতে পারে - এটি আপলোড পথের উপর নির্ভরশীল। বর্তমানে সমর্থিত আপলোডগুলি শুধুমাত্র সাধারণ মিডিয়া আইটেম পাথ ব্যবহার করে৷ new_media_item_type নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
simpleMediaItem

object ( SimpleMediaItem )

একটি নতুন মিডিয়া আইটেম যা অন্তর্ভুক্ত uploadToken মাধ্যমে আপলোড করা হয়েছে।

সরলমিডিয়া আইটেম

একটি আপলোড টোকেনের মাধ্যমে Google ফটোতে একটি সাধারণ মিডিয়া আইটেম তৈরি করা হবে৷

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 )

আপলোড টোকেন দিয়ে মিডিয়া আইটেম তৈরি করা হয়েছে। কোনো ত্রুটি না ঘটলে এবং মিডিয়া আইটেমটি সফলভাবে তৈরি করা হলে এটি পপুলেট করা হয়।