Method: mediaItems.search

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

HTTP অনুরোধ

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

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

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

অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

JSON প্রতিনিধিত্ব
{
  "albumId": string,
  "pageSize": integer,
  "pageToken": string,
  "filters": {
    object (Filters)
  },
  "orderBy": string
}
ক্ষেত্র
albumId

string

একটি অ্যালবামের শনাক্তকারী। জনবহুল হলে, নির্দিষ্ট অ্যালবামে সমস্ত মিডিয়া আইটেম তালিকাভুক্ত করে। কোনো ফিল্টারের সাথে সেট করা যাবে না।

pageSize

integer

প্রতিক্রিয়ায় ফিরে আসার জন্য সর্বাধিক সংখ্যক মিডিয়া আইটেম। নির্দিষ্ট সংখ্যার চেয়ে কম মিডিয়া আইটেম ফেরত দেওয়া হতে পারে। ডিফল্ট pageSize 25, সর্বাধিক 100।

pageToken

string

ফলাফলের পরবর্তী পৃষ্ঠা পেতে একটি ধারাবাহিকতা টোকেন। অনুরোধে এটি যোগ করলে pageToken পরে সারিগুলি ফিরে আসে। pageToken হবে searchMediaItems অনুরোধের প্রতিক্রিয়ায় nextPageToken প্যারামিটারে ফেরত দেওয়া মান।

filters

object ( Filters )

অনুরোধে আবেদন করার জন্য ফিল্টার। albumId সাথে সেট করা যাবে না।

orderBy

string

অনুসন্ধান ফলাফলের সাজানোর ক্রম নির্দিষ্ট করার জন্য একটি ঐচ্ছিক ক্ষেত্র। orderBy ক্ষেত্রটি শুধুমাত্র তখনই কাজ করে যখন একটি dateFilter ব্যবহার করা হয়। যখন এই ক্ষেত্রটি নির্দিষ্ট করা না থাকে, ফলাফলগুলি তাদের creationTime দ্বারা নতুনতম প্রথম, সবচেয়ে পুরানো শেষ প্রদর্শিত হয়৷ MediaMetadata.creation_time প্রদান করা সার্চের ফলাফল বিপরীত ক্রমে প্রদর্শন করে, প্রথমে সবচেয়ে পুরানো তারপর সর্বশেষ সর্বশেষ। ফলাফলগুলিকে প্রথমে নতুন তারপরে সবচেয়ে পুরানো ফলাফল প্রদর্শন করতে, নিম্নরূপ desc আর্গুমেন্ট অন্তর্ভুক্ত করুন: MediaMetadata.creation_time desc

শুধুমাত্র অতিরিক্ত ফিল্টার যা এই প্যারামিটারের সাথে ব্যবহার করা যেতে পারে তা হল includeArchivedMedia এবং excludeNonAppCreatedData । অন্য কোনো ফিল্টার সমর্থিত নয়।

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

সার্চ প্যারামিটারের সাথে মেলে এমন মিডিয়া আইটেমগুলির তালিকা৷

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

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

object ( MediaItem )

শুধুমাত্র আউটপুট। সার্চ প্যারামিটারের সাথে মেলে এমন মিডিয়া আইটেমগুলির তালিকা৷

nextPageToken

string

শুধুমাত্র আউটপুট। মিডিয়া আইটেম পরবর্তী সেট পেতে এই টোকেন ব্যবহার করুন. এর উপস্থিতি পরবর্তী অনুরোধে আরও মিডিয়া আইটেম উপলব্ধ হওয়ার একমাত্র নির্ভরযোগ্য সূচক।

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

নিম্নলিখিত OAuth সুযোগগুলির মধ্যে একটি প্রয়োজন:

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.readonly
  • https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata
  • https://www.googleapis.com/auth/photoslibrary.readonly.originals

ফিল্টার

একটি মিডিয়া আইটেম অনুসন্ধান প্রয়োগ করা যেতে পারে যে ফিল্টার. একাধিক ফিল্টার বিকল্প নির্দিষ্ট করা থাকলে, সেগুলি একে অপরের সাথে AND হিসাবে গণ্য করা হয়।

JSON প্রতিনিধিত্ব
{
  "dateFilter": {
    object (DateFilter)
  },
  "contentFilter": {
    object (ContentFilter)
  },
  "mediaTypeFilter": {
    object (MediaTypeFilter)
  },
  "featureFilter": {
    object (FeatureFilter)
  },
  "includeArchivedMedia": boolean,
  "excludeNonAppCreatedData": boolean
}
ক্ষেত্র
dateFilter

object ( DateFilter )

মিডিয়া আইটেমগুলি তাদের তৈরির তারিখের উপর ভিত্তি করে ফিল্টার করে।

contentFilter

object ( ContentFilter )

মিডিয়া আইটেমগুলি তাদের বিষয়বস্তুর উপর ভিত্তি করে ফিল্টার করে।

mediaTypeFilter

object ( MediaTypeFilter )

মিডিয়ার ধরনের উপর ভিত্তি করে মিডিয়া আইটেম ফিল্টার করে।

featureFilter

object ( FeatureFilter )

মিডিয়া আইটেমগুলিকে তাদের বৈশিষ্ট্যের উপর ভিত্তি করে ফিল্টার করে।

includeArchivedMedia

boolean

যদি সেট করা থাকে, ফলাফলগুলি মিডিয়া আইটেমগুলিকে অন্তর্ভুক্ত করে যা ব্যবহারকারী সংরক্ষণাগারভুক্ত করেছে৷ ডিফল্ট থেকে মিথ্যা (আর্কাইভ করা মিডিয়া আইটেম অন্তর্ভুক্ত করা হয় না)।

excludeNonAppCreatedData

boolean

যদি সেট করা হয়, ফলাফলগুলি মিডিয়া আইটেমগুলি বাদ দেয় যা এই অ্যাপ দ্বারা তৈরি করা হয়নি৷ ডিফল্ট থেকে মিথ্যা (সমস্ত মিডিয়া আইটেম ফেরত দেওয়া হয়)। photoslibrary.readonly.appcreateddata স্কোপ ব্যবহার করা হলে এই ক্ষেত্রটি উপেক্ষা করা হয়।

তারিখ ফিল্টার

এই ফিল্টারটি প্রত্যাবর্তিত মিডিয়ার জন্য অনুমোদিত তারিখ বা তারিখের সীমা নির্ধারণ করে। নির্দিষ্ট তারিখের একটি সেট এবং তারিখ ব্যাপ্তির একটি সেট বাছাই করা সম্ভব। মিডিয়া আইটেমটি ক্যাপচার করার তারিখ উল্লেখ করে মেটাডেটা ছাড়া আপলোড করা মিডিয়া আইটেমগুলি তারিখ ফিল্টার ব্যবহার করে প্রশ্নে ফেরত দেওয়া হবে না। Google Photos সার্ভার আপলোড সময় এই ক্ষেত্রে একটি ফলব্যাক হিসাবে ব্যবহার করা হয় না.

JSON প্রতিনিধিত্ব
{
  "dates": [
    {
      object (Date)
    }
  ],
  "ranges": [
    {
      object (DateRange)
    }
  ]
}
ক্ষেত্র
dates[]

object ( Date )

তারিখের তালিকা যা মিডিয়া আইটেম তৈরির তারিখের সাথে মেলে। প্রতি অনুরোধে সর্বাধিক 5 তারিখ অন্তর্ভুক্ত করা যেতে পারে।

ranges[]

object ( DateRange )

তারিখ ব্যাপ্তির তালিকা যা মিডিয়া আইটেম তৈরির তারিখের সাথে মেলে। প্রতি অনুরোধে সর্বাধিক 5টি তারিখের সীমা অন্তর্ভুক্ত করা যেতে পারে।

তারিখ

একটি সম্পূর্ণ ক্যালেন্ডার তারিখ প্রতিনিধিত্ব করে। শুধুমাত্র মাস এবং বছর তাৎপর্যপূর্ণ হলে day 0-এ সেট করুন, উদাহরণস্বরূপ, ডিসেম্বর 2018-এর পুরোটাই। শুধুমাত্র বছর গুরুত্বপূর্ণ হলে day এবং month 0-এ সেট করুন, উদাহরণস্বরূপ, পুরো 2018-এর ক্ষেত্রে। year 0-এ সেট করুন যখন শুধুমাত্র দিন এবং মাস উল্লেখযোগ্য, উদাহরণস্বরূপ, একটি বার্ষিকী বা জন্মদিন।

অসমর্থিত: সমস্ত মান 0-এ সেট করা, শুধুমাত্র month 0-এ, অথবা day এবং year উভয়ই একই সময়ে 0-এ সেট করা।

JSON প্রতিনিধিত্ব
{
  "year": integer,
  "month": integer,
  "day": integer
}
ক্ষেত্র
year

integer

তারিখের বছর। একটি বছর ছাড়া একটি তারিখ নির্দিষ্ট করতে 1 থেকে 9999, বা 0 হতে হবে।

month

integer

এক বছরের মাস। একটি মাস এবং দিন ছাড়া একটি বছর নির্দিষ্ট করতে 1 থেকে 12, বা 0 হতে হবে৷

day

integer

মাসের দিন। 1 থেকে 31 পর্যন্ত হতে হবে এবং বছর এবং মাসের জন্য বৈধ হতে হবে, অথবা 0 যদি এমন একটি বছর/মাস উল্লেখ করে যেখানে দিনটি উল্লেখযোগ্য নয়৷

তারিখ রেঞ্জ

তারিখের একটি পরিসীমা সংজ্ঞায়িত করে। উভয় তারিখ একই বিন্যাসের হতে হবে। আরও তথ্যের জন্য, Date দেখুন।

JSON প্রতিনিধিত্ব
{
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
ক্ষেত্র
startDate

object ( Date )

বর্ণনা করা ফর্ম্যাটের একটিতে শুরুর তারিখ (ব্যাপ্তির অংশ হিসেবে অন্তর্ভুক্ত)।

endDate

object ( Date )

শেষ তারিখ (ব্যাপ্তির অংশ হিসাবে অন্তর্ভুক্ত)। এটি অবশ্যই শুরুর তারিখের মতো একই বিন্যাসে উল্লেখ করতে হবে।

কন্টেন্ট ফিল্টার

এই ফিল্টারটি আপনাকে বিষয়বস্তুর প্রকারের উপর ভিত্তি করে মিডিয়া আইটেমগুলি ফেরত দেওয়ার অনুমতি দেয়৷

অন্তর্ভুক্ত করার জন্য বিভাগগুলির একটি তালিকা এবং/অথবা বাদ দেওয়ার জন্য বিভাগগুলির একটি তালিকা নির্দিষ্ট করা সম্ভব। প্রতিটি তালিকার মধ্যে, বিভাগগুলি একটি OR এর সাথে মিলিত হয়।

বিষয়বস্তু ফিল্টার includedContentCategories : [c1, c2, c3] মিডিয়া আইটেমগুলি পাবে যা (c1 বা c2 বা c3) ধারণ করে।

বিষয়বস্তু ফিল্টার excludedContentCategories : [c1, c2, c3] মিডিয়া আইটেম পাবে না যেগুলি (c1 বা c2 বা c3) রয়েছে৷

অন্যদের বাদ দিয়ে আপনি কিছু বিভাগও অন্তর্ভুক্ত করতে পারেন, যেমন এই উদাহরণে: includedContentCategories : [c1, c2], excludedContentCategories : [c3, c4]

পূর্ববর্তী উদাহরণে মিডিয়া আইটেম পাওয়া যাবে যাতে (c1 বা c2) এবং নয় (c3 বা c4) থাকে। includedContentategories বিভাগগুলিতে প্রদর্শিত একটি বিভাগ অবশ্যই excludedContentCategories উপস্থিত হবে না।

JSON প্রতিনিধিত্ব
{
  "includedContentCategories": [
    enum (ContentCategory)
  ],
  "excludedContentCategories": [
    enum (ContentCategory)
  ]
}
ক্ষেত্র
includedContentCategories[]

enum ( ContentCategory )

মিডিয়া আইটেম সার্চ ফলাফলে অন্তর্ভুক্ত করা বিভাগের সেট। সেটের আইটেম ORed হয়. প্রতি অনুরোধে সর্বাধিক 10টি includedContentCategories রয়েছে৷

excludedContentCategories[]

enum ( ContentCategory )

মিডিয়া আইটেম সার্চ ফলাফলে অন্তর্ভুক্ত করা যাবে না এমন বিভাগের সেট। সেটের আইটেম ORed হয়. প্রতি অনুরোধে সর্বাধিক 10টি excludedContentCategories রয়েছে৷

বিষয়বস্তু বিভাগ

এটি পূর্ব-নির্ধারিত বিষয়বস্তু বিভাগের একটি সেট যা আপনি ফিল্টার করতে পারেন।

Enums
NONE ডিফল্ট বিষয়বস্তু বিভাগ। এই বিভাগটি উপেক্ষা করা হয় যখন ফিল্টারে অন্য কোনো বিভাগ ব্যবহার করা হয়।
LANDSCAPES ল্যান্ডস্কেপ ধারণকারী মিডিয়া আইটেম.
RECEIPTS রসিদ ধারণকারী মিডিয়া আইটেম.
CITYSCAPES সিটিস্কেপ ধারণকারী মিডিয়া আইটেম.
LANDMARKS ল্যান্ডমার্ক ধারণকারী মিডিয়া আইটেম.
SELFIES মিডিয়া আইটেম যে সেলফি.
PEOPLE মানুষ ধারণকারী মিডিয়া আইটেম.
PETS পোষা প্রাণী ধারণকারী মিডিয়া আইটেম.
WEDDINGS বিবাহ থেকে মিডিয়া আইটেম.
BIRTHDAYS জন্মদিন থেকে মিডিয়া আইটেম.
DOCUMENTS নথি ধারণকারী মিডিয়া আইটেম.
TRAVEL ভ্রমণের সময় নেওয়া মিডিয়া আইটেম।
ANIMALS মিডিয়া আইটেম প্রাণী ধারণকারী.
FOOD খাবার ধারণকারী মিডিয়া আইটেম.
SPORT ক্রীড়া ইভেন্ট থেকে মিডিয়া আইটেম.
NIGHT মিডিয়া আইটেম রাতে নেওয়া.
PERFORMANCES পারফরম্যান্স থেকে মিডিয়া আইটেম।
WHITEBOARDS হোয়াইটবোর্ড ধারণকারী মিডিয়া আইটেম.
SCREENSHOTS মিডিয়া আইটেম যে স্ক্রিনশট.
UTILITY মিডিয়া আইটেম যে উপযোগী বলে মনে করা হয়. এর মধ্যে রয়েছে, কিন্তু নথি, স্ক্রিনশট, হোয়াইটবোর্ড ইত্যাদির মধ্যে সীমাবদ্ধ নয়।
ARTS শিল্প ধারণকারী মিডিয়া আইটেম.
CRAFTS কারুশিল্প ধারণকারী মিডিয়া আইটেম.
FASHION ফ্যাশন সম্পর্কিত মিডিয়া আইটেম।
HOUSES মিডিয়া আইটেম ঘর ধারণকারী.
GARDENS মিডিয়া আইটেম বাগান ধারণকারী.
FLOWERS ফুল ধারণকারী মিডিয়া আইটেম.
HOLIDAYS মিডিয়া আইটেম ছুটির নেওয়া.

মিডিয়া টাইপ ফিল্টার

এই ফিল্টারটি রিটার্ন করা মিডিয়া আইটেমগুলির ধরন সংজ্ঞায়িত করে, উদাহরণস্বরূপ, ভিডিও বা ফটো৷ শুধুমাত্র একটি মিডিয়া টাইপ সমর্থিত।

JSON প্রতিনিধিত্ব
{
  "mediaTypes": [
    enum (MediaType)
  ]
}
ক্ষেত্র
mediaTypes[]

enum ( MediaType )

মিডিয়া আইটেম ধরনের অন্তর্ভুক্ত করা হবে. এই ক্ষেত্রটি শুধুমাত্র একটি মিডিয়া টাইপ দিয়ে তৈরি করা উচিত। আপনি যদি একাধিক মিডিয়া প্রকার উল্লেখ করেন, এটি একটি ত্রুটির কারণ হয়৷

মিডিয়া টাইপ

মিডিয়া প্রকারের সেট যা অনুসন্ধান করা যেতে পারে।

Enums
ALL_MEDIA কোন ফিল্টার প্রয়োগ করা হয় না হিসাবে চিকিত্সা. সব ধরনের মিডিয়া অন্তর্ভুক্ত করা হয়.
VIDEO সমস্ত মিডিয়া আইটেম যে ভিডিও হিসাবে বিবেচিত হয়. এর মধ্যে Google Photos অ্যাপ ব্যবহার করে ব্যবহারকারীর তৈরি করা সিনেমাগুলিও রয়েছে।
PHOTO সমস্ত মিডিয়া আইটেম যেগুলি ফটো হিসাবে বিবেচিত হয়৷ এর মধ্যে রয়েছে .bmp, .gif, .ico, .jpg (এবং অন্যান্য বানান), .tiff, .webp এবং বিশেষ ধরনের ফটো যেমন iOS লাইভ ফটো, অ্যান্ড্রয়েড মোশন ফটো, প্যানোরামা, ফটোস্ফিয়ার।

ফিচার ফিল্টার

এই ফিল্টার মিডিয়া আইটেম থাকা উচিত বৈশিষ্ট্য সংজ্ঞায়িত করে.

JSON প্রতিনিধিত্ব
{
  "includedFeatures": [
    enum (Feature)
  ]
}
ক্ষেত্র
includedFeatures[]

enum ( Feature )

মিডিয়া আইটেম অনুসন্ধান ফলাফলে অন্তর্ভুক্ত করা বৈশিষ্ট্যের সেট. সেটের আইটেমগুলি ORed এবং নির্দিষ্ট বৈশিষ্ট্যগুলির সাথে মেলে।

বৈশিষ্ট্য

বৈশিষ্ট্যগুলির সেট যা আপনি ফিল্টার করতে পারেন৷

Enums
NONE কোন ফিল্টার প্রয়োগ করা হয় না হিসাবে চিকিত্সা. সমস্ত বৈশিষ্ট্য অন্তর্ভুক্ত করা হয়.
FAVORITES মিডিয়া আইটেম যা ব্যবহারকারী Google Photos অ্যাপে পছন্দসই হিসেবে চিহ্নিত করেছেন।