Method: mediaItems.list

নির্দিষ্ট ডিভাইসের জন্য ব্যবহারকারী-কনফিগার করা মিডিয়া উৎস থেকে পরিবেষ্টিত মিডিয়া আইটেমগুলির একটি তালিকা প্রদান করে।

ডিফল্টরূপে, listMediaItems পরিবেষ্টিত অভিজ্ঞতা প্রদান করে, সমস্ত ব্যবহারকারী-কনফিগার করা উৎস থেকে মিডিয়া আইটেমগুলির একটি কিউরেটেড সেট ফিরিয়ে দেয়।

ঐচ্ছিকভাবে, আপনি একটি নির্দিষ্ট মিডিয়া সোর্স থেকে আইটেমগুলির একটি পেজিনেটেড তালিকা পুনরুদ্ধার করার অনুরোধে mediaSourceId অন্তর্ভুক্ত করতে পারেন, যা আরও ঐতিহ্যগত ফিল্টারিংয়ের অনুমতি দেয়।

ক্লায়েন্ট অ্যাপ্লিকেশন প্রতি ডিভাইস প্রতি দিনে 240 অনুরোধের মধ্যে সীমাবদ্ধ।

ব্যবহারকারী কোনো মিডিয়া উৎস কনফিগার না করলে একটি FAILED_PRECONDITION ত্রুটি ঘটে।

HTTP অনুরোধ

GET https://photosambient.googleapis.com/v1/mediaItems

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

ক্যোয়ারী প্যারামিটার

পরামিতি
deviceId

string

প্রয়োজন। এই ডিভাইসের অনন্য শনাক্তকারী।

mediaSourceId

string

ঐচ্ছিক। পরিবেষ্টিত অভিজ্ঞতার জন্য , এই ক্ষেত্রটি বাদ দিন। এটি সমস্ত কনফিগার করা উত্স থেকে মিডিয়া আইটেমগুলির একটি কিউরেটেড সেট ফিরিয়ে দেবে৷ প্রত্যাবর্তিত আইটেমের সংখ্যা আপনার pageSize অনুরোধকে সম্মান করবে, সর্বাধিক 100টি আইটেম পর্যন্ত। নির্দিষ্ট করা হলে, শুধুমাত্র নির্দিষ্ট মিডিয়া উৎস থেকে আইটেম ফেরত দেওয়া হবে।

id অবশ্যই নির্দিষ্ট ডিভাইসের জন্য ব্যবহারকারী দ্বারা নির্বাচিত একটি উৎস হতে হবে (যেমন AmbientDevice.media_sources.id )।

দ্রষ্টব্য, highlights সমর্থিত নয় যদিও এটি ব্যবহারকারীর দ্বারা এই ডিভাইসের জন্য একটি নির্বাচিত উত্স হয়৷ এই ক্ষেত্রটিকে highlights সেট করা একটি INVALID_ARGUMENT ত্রুটি ফিরিয়ে দেবে৷

pageSize

integer

ঐচ্ছিক। ফেরত দিতে মিডিয়া আইটেমের সর্বাধিক সংখ্যা৷

পরিষেবাটি আপনার pageSize অনুরোধকে সম্মান করবে, যদিও এটি নির্দিষ্ট করা থেকে কম আইটেম ফেরত দিতে পারে (শূন্য ফলাফল সহ)।

যদি pageSize অনির্দিষ্ট থাকে বা 0 তে সেট করা হয়, তাহলে সর্বাধিক 50টি মিডিয়া আইটেম ফেরত দেওয়া হবে। 100-এর বেশি মানগুলিকে 100-এর সর্বাধিক অনুমোদিত মানকে জোর করে নামিয়ে দেওয়া হবে৷ একটি নেতিবাচক মান প্রদান করলে একটি INVALID_ARGUMENT ত্রুটি দেখা দেবে৷

pageToken

string

ঐচ্ছিক। একটি পূর্ববর্তী mediaItems.list কল থেকে প্রাপ্ত একটি পৃষ্ঠা টোকেন। পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করতে এটি প্রদান করুন।

শরীরের অনুরোধ

অনুরোধের বডি খালি হতে হবে।

প্রতিক্রিয়া শরীর

mediaItems.list পদ্ধতিতে প্রতিক্রিয়া।

সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:

JSON প্রতিনিধিত্ব 
{
  "mediaItems": [
    {
      object (AmbientMediaItem)
    }
  ],
  "nextPageToken": string
}
ক্ষেত্র
mediaItems[]

object ( AmbientMediaItem )

ডিভাইস প্রদর্শনের জন্য পরিবেষ্টিত মিডিয়া আইটেমগুলির একটি পৃষ্ঠা৷

nextPageToken

string

যদি সেট করা থাকে, এই ক্ষেত্রটিকে পরবর্তী mediaItems.list কলে pageToken হিসাবে ব্যবহার করা যেতে পারে আইটেমগুলির পরবর্তী পৃষ্ঠা পুনরুদ্ধার করতে।

যদি এই ক্ষেত্রটি বাদ দেওয়া হয়, তবে এটি অগত্যা একটি ইঙ্গিত নয় যে আর কোনও সামগ্রী আনার জন্য উপলব্ধ নেই, বরং পরবর্তী পৃষ্ঠাগুলিতে এমন মিডিয়া আইটেম থাকতে পারে যা পূর্ববর্তী পৃষ্ঠাগুলিতে ইতিমধ্যেই ফিরে এসেছে৷

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগ প্রয়োজন:

  • https://www.googleapis.com/auth/photosambient.mediaitems