Method: mediaItems.search

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

{
  "albumId": string,
  "pageSize": integer,
  "pageToken": string,
  "filters": {
    object (Filters)
  },
  "orderBy": 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 در نظر گرفته می شوند.

این فیلتر تاریخ ها یا محدوده های تاریخ مجاز را برای رسانه بازگشتی تعریف می کند. امکان انتخاب مجموعه ای از تاریخ های خاص و مجموعه ای از محدوده های تاریخ وجود دارد. موارد رسانه ای آپلود شده بدون ابرداده که تاریخ ضبط مورد رسانه را مشخص می کند، در جستارهایی با استفاده از فیلترهای تاریخ بازگردانده نمی شوند. در این مورد از زمان آپلود سرور Google Photos به عنوان یک بازگشت استفاده نمی شود.

نشان دهنده یک تاریخ کامل تقویم است. وقتی فقط ماه و سال مهم هستند، day را روی 0 تنظیم کنید، به عنوان مثال، تمام دسامبر 2018. اگر فقط سال مهم است، day و month را روی 0 تنظیم کنید، به عنوان مثال، کل سال 2018. year را روی 0 تنظیم کنید، زمانی که فقط روز باشد. و ماه مهم هستند، به عنوان مثال، سالگرد یا تولد.

پشتیبانی نشده: تنظیم همه مقادیر روی 0، فقط month به 0، یا هر دو day و year روی 0 به طور همزمان.

محدوده ای از تاریخ ها را تعریف می کند. هر دو تاریخ باید از یک قالب باشند. برای اطلاعات بیشتر، به Date مراجعه کنید.

این فیلتر به شما امکان می دهد آیتم های رسانه ای را بر اساس نوع محتوا برگردانید.

می‌توان فهرستی از دسته‌ها را برای گنجاندن و/یا فهرستی از دسته‌ها را برای حذف مشخص کرد. در هر لیست، دسته ها با یک OR ترکیب می شوند.

فیلتر محتوا includedContentCategories : [c1, c2, c3] موارد رسانه‌ای را دریافت می‌کند که حاوی (c1 OR c2 OR c3) هستند.

فیلتر محتوا از دسته‌های محتوا excludedContentCategories : [c1, c2, c3] موارد رسانه‌ای را دریافت نمی‌کند که حاوی (c1 OR c2 OR c3) باشد.

همچنین می‌توانید برخی از دسته‌ها را در حالی که دسته‌های دیگر را حذف می‌کنید، اضافه کنید، مانند این مثال: includedContentCategories : [c1, c2], excludedContentCategories : [c3, c4]

مثال قبلی موارد رسانه ای را دریافت می کند که حاوی (c1 OR c2) و NOT (c3 OR c4) هستند. دسته ای که در includedContentategories ظاهر می شود نباید در excludedContentCategories ظاهر شود.

این مجموعه ای از دسته بندی های محتوای از پیش تعریف شده است که می توانید بر روی آنها فیلتر کنید.

این فیلتر نوع آیتم های رسانه ای را که قرار است بازگردانده شوند، برای مثال، فیلم ها یا عکس ها را مشخص می کند. فقط یک نوع رسانه پشتیبانی می شود.

مجموعه ای از انواع رسانه ای که می توان آنها را جستجو کرد.

این فیلتر ویژگی هایی را که آیتم های رسانه باید داشته باشند را مشخص می کند.

مجموعه ای از ویژگی هایی که می توانید روی آنها فیلتر کنید.