ขอบเขตการให้สิทธิ์ที่จำเป็น
Google Photos Library API มีขอบเขตหลายรายการที่ใช้ในการเข้าถึงรายการสื่อและอัลบั้ม รายการสื่อที่แสดงผลจากการเรียกหลายครั้งจะแตกต่างกันไปตามขอบเขต ตามที่นักพัฒนาซอฟต์แวร์ขอ
ขอบเขต photoslibrary.readonly
อนุญาตให้เข้าถึงรายการสื่อทั้งหมดใน
ไลบรารีของผู้ใช้ ขอบเขต photoslibrary.readonly.appcreateddata
อนุญาตให้เข้าถึง
ไปยังรายการสื่อที่แอปสร้างขึ้นเท่านั้น สำหรับข้อมูลเพิ่มเติม โปรดดู
ขอบเขตการให้สิทธิ์
ตัวกรองที่พร้อมใช้งาน
คุณค้นหาประเภทสื่อที่เฉพาะเจาะจงได้จากคลังของผู้ใช้ ตัวอย่างเช่น คุณสามารถ ต้องการเฉพาะสิ่งของที่เป็นสัตว์ จากวันใดวันหนึ่ง หรือคุณอาจต้องการ เพื่อยกเว้นรูปภาพใบเสร็จ คุณสามารถยกเว้นหรือรวมเฉพาะบางรายการได้โดย การใช้ตัวกรองกับรายชื่ออัลบั้มหรือห้องสมุด มี 5 รายการที่ใช้ได้ ตัวกรองที่อิงจากพร็อพเพอร์ตี้รายการสื่อ
- หมวดหมู่เนื้อหา (
includedContentCategories
,excludedContentCategories
) - วันที่และช่วงวันที่ (
dates
,ranges
) - ฟีเจอร์ (
featureFilter
) - ประเภทสื่อ (
mediaTypeFilter
) - สถานะที่เก็บถาวร (
includeArchivedMedia
)
ไม่ควรใช้ตัวกรองในคำขอ mediaItems:search
หาก albumId
คือ
ตั้งค่า หากใช้ตัวกรองเมื่อตั้งค่า AlbumsId ข้อผิดพลาด INVALID_ARGUMENT
(400) จะแสดงผล
ผลลัพธ์จะจัดเรียงตามเวลาที่สร้างรายการสื่อ แก้ไขลำดับการจัดเรียงได้สำหรับการค้นหาโดยใช้ตัวกรองวันที่
โปรดรอสักระยะหนึ่งเพื่อให้สื่อที่เพิ่งอัปโหลดปรากฏในการค้นหา สื่อ จะปรากฏในการค้นหาที่ไม่ผ่านการกรองทันที
รายการสื่อที่มีวันที่ในอนาคตจะไม่ปรากฏในการค้นหาที่กรอง โดยจะปรากฏในการค้นหาที่ไม่ได้กรองและการค้นหาอัลบั้ม
การใช้ฟิลเตอร์
หากต้องการใช้ตัวกรอง ให้โทร
mediaItems.search
และ
ระบุพร็อพเพอร์ตี้ filter
REST
คำขอ POST มีดังนี้
POST https://photoslibrary.googleapis.com/v1/mediaItems:search
Content-type: application/json
Authorization: Bearer oauth2-token
{
"pageSize": "100",
"filters": {
...
}
}
คำขอ POST จะแสดงการตอบกลับต่อไปนี้
{ "mediaItems": [ ... ], "nextPageToken": "token-for-pagination" }
Java
try { // Create a new Filter object Filters filters = Filters.newBuilder() // .setContentFilter(...) // .setDateFilter(...) // ... .build(); // Specify the Filter object in the searchMediaItems call SearchMediaItemsPagedResponse response = photosLibraryClient.searchMediaItems(filters); for (MediaItem item : response.iterateAll()) { // ... } } catch (ApiException e) { // Handle error }
PHP
try { $filtersBuilder = new FiltersBuilder(); // $filtersBuilder->addIncludedCategory(...); // $filtersBuilder->addDate(...); // ... // Make a search call with the options set in the filters builder $response = $photosLibraryClient->searchMediaItems( ['filters' => $filtersBuilder->build()] ); foreach ($response->iterateAllElements() as $element) { // ... } } catch (\Google\ApiCore\ApiException $e) { // Handle error }
โปรดดูรายละเอียดที่หัวข้อ แสดงเนื้อหาในคลังภาพ อัลบั้ม และรายการสื่อ
หมวดหมู่เนื้อหา
รายการสื่อทั้งหมดจะได้รับการประมวลผลและติดป้ายกำกับแล้ว คุณสามารถรวมและยกเว้น หมวดหมู่ใดก็ได้ต่อไปนี้
ANIMALS |
FASHION |
LANDMARKS |
RECEIPTS |
WEDDINGS |
ARTS |
FLOWERS |
LANDSCAPES |
SCREENSHOTS |
WHITEBOARDS |
BIRTHDAYS |
FOOD |
NIGHT |
SELFIES |
|
CITYSCAPES |
GARDENS |
PEOPLE |
SPORT |
|
CRAFTS |
HOLIDAYS |
PERFORMANCES |
TRAVEL |
|
DOCUMENTS |
HOUSES |
PETS |
UTILITY |
รูปภาพยูทิลิตี้ครอบคลุมสื่อหลากหลายประเภท โดยทั่วไปแล้วหมวดหมู่นี้จะมี รายการที่ผู้ใช้บันทึกไว้เพื่อทำงานบางอย่าง และไม่น่าจะต้องการหลังจาก ทำงานนั้นเสร็จแล้ว ซึ่งรวมถึงเอกสาร ใบเสร็จ ภาพหน้าจอ สติกเกอร์ โน้ต เมนู และรายการสื่ออื่นๆ ที่คล้ายกัน
หมวดหมู่ต่างๆ จะมีความถูกต้องเท่ากับป้ายกำกับที่เทียบเท่าใน Google Photos ในบางครั้งสินค้าอาจติดป้ายกำกับไม่ถูกต้อง เราจึงไม่รับประกันว่า ความแม่นยำของตัวกรองหมวดหมู่เนื้อหา
รวมหมวดหมู่
เมื่อคุณรวมหลายหมวดหมู่ รายการสื่อที่ตรงกับรายการใดรายการหนึ่ง
หมวดหมู่ต่างๆ ด้วย ใส่หมวดหมู่ได้สูงสุด 10 หมวดหมู่ต่อคำขอ
ตัวกรองตัวอย่างนี้แสดงรายการที่เป็น LANDSCAPES
หรือ LANDMARKS
REST
{ "filters": { "contentFilter": { "includedContentCategories": [ "LANDSCAPES", "LANDMARKS" ] } } }
Java
// Create a content filter that includes landmarks and landscapes ContentFilter contentFilter = ContentFilter.newBuilder() .addIncludedContentCategories(ContentCategory.LANDMARKS) .addIncludedContentCategories(ContentCategory.LANDSCAPES) .build(); // Create a new Filters object Filters filters = Filters.newBuilder() .setContentFilter(contentFilter) .build(); // Specify the Filter object in the searchMediaItems call SearchMediaItemsPagedResponse response = photosLibraryClient.searchMediaItems(filters);
PHP
// Create a content filter that includes landmarks and landscapes $filtersBuilder = new FiltersBuilder(); $filtersBuilder->addIncludedCategory(ContentCategory::LANDMARKS); $filtersBuilder->addIncludedCategory(ContentCategory::LANDSCAPES); // Make a search call with the options set in the filters builder $response = $photosLibraryClient->searchMediaItems( ['filters' => $filtersBuilder->build()] );
ยกเว้นหมวดหมู่
ระบบจะแสดงเฉพาะรายการสื่อที่ไม่ตรงกับหมวดหมู่ที่ยกเว้น สามารถยกเว้นหมวดหมู่ได้สูงสุด 10 หมวดหมู่เช่นเดียวกับหมวดหมู่ที่รวมไว้ ต่อคำขอ
ตัวกรองนี้แสดงรายการที่ไม่ใช่ PEOPLE
หรือ SELFIES
:
REST
{ "filters": { "contentFilter": { "excludedContentCategories": [ "PEOPLE", "SELFIES" ] } } }
Java
// Create a content filter that excludes people and selfies ContentFilter contentFilter = ContentFilter.newBuilder() .addExcludedContentCategories(ContentCategory.PEOPLE) .addExcludedContentCategories(ContentCategory.SELFIES) .build(); // Create a new Filters object Filters filters = Filters.newBuilder() .setContentFilter(contentFilter) .build(); // Specify the Filter object in the searchMediaItems call SearchMediaItemsPagedResponse response = photosLibraryClient.searchMediaItems(filters);
PHP
// Create a content filter that excludes people and selfies $filtersBuilder = new FiltersBuilder(); $filtersBuilder->addExcludedCategory(ContentCategory::PEOPLE); $filtersBuilder->addExcludedCategory(ContentCategory::SELFIES); // Make a search call with the options set in the filters builder $response = $photosLibraryClient->searchMediaItems( ['filters' => $filtersBuilder->build()] );
การรวมและยกเว้นหลายหมวดหมู่
คุณสามารถรวมบางหมวดหมู่ไว้ และยกเว้นหมวดหมู่อื่นๆ ได้ ตัวอย่างต่อไปนี้
แสดงผล LANDSCAPES
และ LANDMARKS
แต่นำรายการสื่อที่มี
PEOPLE
หรือที่ SELFIES
:
REST
{ "filters": { "contentFilter": { "includedContentCategories": [ "LANDSCAPES", "LANDMARKS" ], "excludedContentCategories": [ "PEOPLE", "SELFIES" ] } } }
Java
// Create a content filter that excludes people and selfies and includes landmarks and landscapes ContentFilter contentFilter = ContentFilter.newBuilder() .addIncludedContentCategories(ContentCategory.LANDSCAPES) .addIncludedContentCategories(ContentCategory.LANDMARKS) .addExcludedContentCategories(ContentCategory.PEOPLE) .addExcludedContentCategories(ContentCategory.SELFIES) .build(); // Create a new Filters object Filters filters = Filters.newBuilder() .setContentFilter(contentFilter) .build(); // Specify the Filters object in the searchMediaItems call SearchMediaItemsPagedResponse response = photosLibraryClient.searchMediaItems(filters);
PHP
// Create a content filter that excludes people and selfies and includes landmarks and landscapes $filtersBuilder = new FiltersBuilder(); $filtersBuilder->addIncludedCategory(ContentCategory::LANDMARKS); $filtersBuilder->addIncludedCategory(ContentCategory::LANDSCAPES); $filtersBuilder->addExcludedCategory(ContentCategory::PEOPLE); $filtersBuilder->addExcludedCategory(ContentCategory::SELFIES); // Make a search call with the options set in the filters builder $response = $photosLibraryClient->searchMediaItems( ['filters' => $filtersBuilder->build()] );
วันที่และช่วงวันที่
ตัวกรองวันที่จะจำกัดวันที่ของผลลัพธ์ที่ปรากฏเฉพาะชุดของ วัน คุณสามารถระบุตัวกรองวันที่ได้ 2 วิธี ได้แก่ วันที่หรือช่วง วันที่และ และใช้ร่วมกันได้ รายการสื่อที่ตรงกับวันที่หรือวันที่ใดก็ได้ ผลลัพธ์จะเป็นช่วง ลำดับการจัดเรียงของผลลัพธ์ (ไม่บังคับ) แก้ไขได้
วันที่
วันที่จะประกอบด้วยปี เดือน และวัน เรายอมรับรูปแบบต่อไปนี้
- ปี
- ปี เดือน
- ปี เดือน วัน
- เดือน วัน
- เดือน
เมื่อองค์ประกอบของวันที่ว่างเปล่าหรือตั้งค่าเป็น 0 จะถือว่าองค์ประกอบของวันที่ ไวลด์การ์ด ตัวอย่างเช่น หากคุณตั้งค่าวันและเดือน แต่ไม่ได้กำหนดปี คุณจะ ที่ขอรายการจากวันและเดือนนั้นในปีใดๆ:
REST
{ "filters": { "dateFilter": { "dates": [ { "month": 2, "day": 15 } ] } } }
Java
// Create a new com.google.type.Date object using a builder // Note that there are different valid combinations as described above Date dayFebruary15 = Date.newBuilder() .setDay(15) .setMonth(2) .build(); // Create a new dateFilter. You can also set multiple dates here DateFilter dateFilter = DateFilter.newBuilder() .addDates(dayFebruary15) .build(); // Create a new Filters object Filters filters = Filters.newBuilder() .setDateFilter(dateFilter) .build(); // Specify the Filters object in the searchMediaItems call SearchMediaItemsPagedResponse response = photosLibraryClient.searchMediaItems(filters);
PHP
// Create a new Google\Type\Date object with a day and a month // Note that there are different valid combinations as described above $dateFebruary15 = new Date(); $dateFebruary15->setDay(15); $dateFebruary15->setMonth(2); $filtersBuilder = new FiltersBuilder(); // Add the date to the filter. You can also set multiple dates here $filtersBuilder->addDate($dateFebruary15); // Make a search call with the options set in the filters builder $response = $photosLibraryClient->searchMediaItems( ['filters' => $filtersBuilder->build()] );
ช่วงวันที่
ช่วงวันที่จะมีความยืดหยุ่นมากกว่าวันที่ ตัวอย่างเช่น แทนที่จะเพิ่ม หลายวัน คุณสามารถใช้ช่วงวันที่เพื่อดูชุดของวันภายใน 1 เดือนได้
ช่วงวันที่มี startDate
และ endDate
ซึ่งต้องตั้งค่าทั้ง 2 อย่าง ชิ้น
วันที่ในช่วงมีข้อจํากัดรูปแบบเดียวกันตามที่อธิบายไว้ใน
วันที่ วันที่ต้องอยู่ในรูปแบบเดียวกัน: หากวันที่เริ่มต้นเป็น
ปีและเดือน วันที่สิ้นสุดต้องเป็นปีและเดือนด้วย ช่วง ได้แก่
เมื่อรวม วันที่เริ่มต้นและวันที่สิ้นสุดจะรวมอยู่ในตัวกรองที่ใช้ ดังนี้
REST
{ "filters": { "dateFilter": { "ranges": [ { "startDate": { "year": 2014, "month": 6, "day": 12 }, "endDate": { "year": 2014, "month": 7, "day": 13 } } ] } } }
Java
// Create new com.google.type.Date objects for two dates Date day2014June12 = Date.newBuilder() .setDay(12) .setMonth(6) .setYear(2014) .build(); Date day2014July13 = Date.newBuilder() .setDay(13) .setMonth(7) .setYear(2014) .build(); // Create a DateRange from these two dates DateRange dateRange = DateRange.newBuilder() .setStartDate(day2014June12) .setEndDate(day2014July13) .build(); // Create a new dateFilter with the date range. You can also set multiple date ranges here DateFilter dateFilter = DateFilter.newBuilder() .addRanges(dateRange) .build(); // Create a new Filters object Filters filters = Filters.newBuilder() .setDateFilter(dateFilter) .build(); // Specify the Filters object in the searchMediaItems call SearchMediaItemsPagedResponse response = photosLibraryClient.searchMediaItems(filters);
PHP
// Create two new Google\Type\Date objects $date2014June12 = new Date(); $date2014June12->setDay(12); $date2014June12->setMonth(6); $date2014June12->setYear(2014); $date2014July13 = new Date(); $date2014July13->setDay(13); $date2014July13->setMonth(7); $date2014July13->setYear(2014); // Add the two dates as a date range to the filter // You can also set multiple date ranges here $filtersBuilder = new FiltersBuilder(); $filtersBuilder->addDateRange($date2014June12, $date2014July13); // Make a search call with the options set in the filters builder $response = $photosLibraryClient->searchMediaItems( ['filters' => $filtersBuilder->build()] );
การรวมวันที่และช่วงวันที่
คุณใส่วันที่หลายวันที่และหลายช่วงวันที่พร้อมกันได้ รายการที่ ในช่วงวันที่เหล่านี้จะรวมอยู่ในผลลัพธ์ แยกวันที่และ ช่วงวันที่ไม่จำเป็นต้องมีรูปแบบเดียวกัน แต่วันที่เริ่มต้นและวันที่สิ้นสุดของ แต่ละช่วงจะมีลักษณะดังนี้
REST
{ "filters": { "dateFilter": { "dates": [ { "year": 2013 }, { "year": 2011, "month": 11 } ], "ranges": [ { "startDate": { "month": 1 }, "endDate": { "month": 3 } }, { "startDate": { "month": 3, "day": 24 }, "endDate": { "month": 5, "day": 2 } } ] } } }
Java
// Create a new com.google.type.Date object for the year 2013 Date day2013 = Date.newBuilder() .setYear(2013) .build(); // Create a new com.google.type.Date object for November 2011 Date day2011November = Date.newBuilder() .setMonth(11) .setYear(2011) .build(); // Create a date range for January to March DateRange dateRangeJanuaryToMarch = DateRange.newBuilder() .setStartDate(Date.newBuilder().setMonth(1).build()) .setEndDate(Date.newBuilder().setMonth(3).build()) .build(); // Create a date range for March 24 to May 2 DateRange dateRangeMarch24toMay2 = DateRange.newBuilder() .setStartDate(Date.newBuilder().setMonth(3).setDay(24).build()) .setEndDate(Date.newBuilder().setMonth(5).setDay(2).build()) .build(); // Create a new dateFilter with the dates and date ranges DateFilter dateFilter = DateFilter.newBuilder() .addDates(day2013) .addDates(day2011November) .addRanges(dateRangeJanuaryToMarch) .addRanges(dateRangeMarch24toMay2) .build(); // Create a new Filters object Filters filters = Filters.newBuilder() .setDateFilter(dateFilter) .build(); // Specify the Filter object in the searchMediaItems call SearchMediaItemsPagedResponse response = photosLibraryClient.searchMediaItems(filters);
PHP
// Create a new Google\Type\Date object for the year 2013 $date2013 = new Date(); $date2013->setYear(2013); // Create a new Google\Type\Date object for November 2011 $dateNovember2011 = new Date(); $dateNovember2011->setMonth(11); $dateNovember2011->setYear(2011); $filtersBuilder = new FiltersBuilder(); // Create a date range for January to March $filtersBuilder->addDateRange((new Date())->setMonth(1), (new Date())->setMonth(3)); // Create a date range for March 24 to May 2 $filtersBuilder->addDateRange((new Date())->setMonth(3)->setDay(24), (new Date())->setMonth(5)->setDay(2)); $filtersBuilder->addDate($date2013); $filtersBuilder->addDate($dateNovember2011); // Make a search call with the options set in the filters builder $response = $photosLibraryClient->searchMediaItems( ['filters' => $filtersBuilder->build()] );
ฟีเจอร์รายการสื่อ
ตัวกรองฟีเจอร์จะจำกัดผลการค้นหาไว้เฉพาะรายการที่มีคุณลักษณะเฉพาะสำหรับ ตัวอย่างที่ทำเครื่องหมายเป็นรายการโปรดในแอปพลิเคชัน Google Photos
รายการโปรด
ใส่
FAVORITES
รายการ
ใน
FeatureFilter
เพื่อแสดงเฉพาะรายการสื่อที่ผู้ใช้ทำเครื่องหมายเป็นรายการโปรดเท่านั้น
REST
{ "filters" : { "featureFilter": { "includedFeatures": [ "FAVORITES" ] } } }
Java
// Create a new FeatureFilter for favorite media items FeatureFilter featureFilter = FeatureFilter.newBuilder() .addIncludedFeatures(Feature.FAVORITES) .build(); // Create a new Filters object Filters filters = Filters.newBuilder() .setFeatureFilter(featureFilter) .build(); // Specify the Filters object in the searchMediaItems call SearchMediaItemsPagedResponse response = photosLibraryClient.searchMediaItems(filters);
PHP
// Create a new FeatureFilter for favorite media items $filtersBuilder = new FiltersBuilder(); $filtersBuilder->addIncludedFeature(Feature::FAVORITES); // Make a search call with the options set in the filters builder $response = $photosLibraryClient->searchMediaItems( ['filters' => $filtersBuilder->build()] );
ประเภทสื่อ
คุณสามารถจำกัดผลการค้นหาให้เหลือเพียงประเภทสื่อแบบใดแบบหนึ่ง ได้แก่ photo หรือ วิดีโอ
รูปภาพ
PHOTO
อาจเป็นรูปภาพรูปแบบต่างๆ ดังนี้
BMP | JPG |
GIF | PNG |
HEIC | TIFF |
ICO | WebP |
นอกจากนี้ยังรวมถึงรูปภาพประเภทพิเศษ เช่น iOS Live Photos, ภาพเคลื่อนไหว ภาพพาโนรามา ภาพ 360 องศา และรูปภาพ VR
วิดีโอ
VIDEO
อาจเป็นวิดีโอรูปแบบต่างๆ ดังนี้
3GP | MMV |
3G2 | ม็อด |
ASF | MOV |
AVI | MP4 |
DIVX | MPG |
M2T | MTS |
M2TS | TOD |
M4V | WMV |
MKV |
VIDEO
ยังรวมรูปแบบวิดีโอพิเศษต่อไปนี้ไว้ด้วย ได้แก่ วิดีโอ VR
วิดีโอสโลว์โมชันและภาพเคลื่อนไหวที่สร้างใน Google Photos
แอปพลิเคชัน
ตัวอย่างต่อไปนี้กรองตาม PHOTO
REST
{ "filters": { "mediaTypeFilter": { "mediaTypes": [ "PHOTO" ] } } }
Java
// Create a new MediaTypeFilter for Photo media items MediaTypeFilter mediaType = MediaTypeFilter.newBuilder() .addMediaTypes(MediaType.PHOTO) .build(); // Create a new Filters object Filters filters = Filters.newBuilder() .setMediaTypeFilter(mediaType) .build(); // Specify the Filters object in the searchMediaItems call SearchMediaItemsPagedResponse response = photosLibraryClient.searchMediaItems(filters);
PHP
// Create a new MediaTypeFilter for Photo media items $filtersBuilder = new FiltersBuilder(); $filtersBuilder->setMediaType(MediaType::PHOTO); // Make a search call with the options set in the filters builder $response = $photosLibraryClient->searchMediaItems( ['filters' => $filtersBuilder->build()] );
ตัวกรองสื่อหลายประเภทรวมไม่ได้
ยกเว้นข้อมูลที่ไม่ได้สร้างแอป
หากต้องการยกเว้นรายการสื่อที่แอปไม่ได้สร้างขึ้น คุณสามารถตั้งค่า
ตัวกรอง excludeNonAppCreatedData
ดังที่แสดงในตัวอย่างต่อไปนี้
REST
{ "filters": { "excludeNonAppCreatedData": true } }
Java
// Create a new Filters object that excludes media not created by your app Filters filters = Filters.newBuilder() .setExcludeNonAppCreatedData(true) .build(); // Specify the Filters object in the searchMediaItems call SearchMediaItemsPagedResponse response = photosLibraryClient.searchMediaItems(filters);
PHP
// Create a new Filters object that excludes media not created by your app $filtersBuilder = new FiltersBuilder(); $filtersBuilder->setExcludeNonAppCreatedData(true); // Make a search call with the options set in the filters builder $response = $photosLibraryClient->searchMediaItems( ['filters' => $filtersBuilder->build()] );
โปรดทราบว่าหากคุณกำลังใช้
.readonly.appcreateddata
ตัวกรองนี้จะไม่มีผล
สถานะที่เก็บถาวร
ผู้ใช้อาจเก็บรูปภาพบางส่วนไว้ โดยค่าเริ่มต้น รูปภาพที่เก็บถาวร จะไม่ปรากฏในการค้นหา หากต้องการรวมรายการที่เก็บถาวรไว้ คุณสามารถตั้งค่าสถานะใน ตามที่แสดงในตัวอย่างต่อไปนี้
REST
{ "filters": { "includeArchivedMedia": true } }
Java
// Create a new Filters object that includes archived media Filters filters = Filters.newBuilder() .setIncludeArchivedMedia(true) .build(); // Specify the Filters object in the searchMediaItems call SearchMediaItemsPagedResponse response = photosLibraryClient.searchMediaItems(filters);
PHP
// Create a new Filters object that includes archived media $filtersBuilder = new FiltersBuilder(); $filtersBuilder->setIncludeArchivedMedia(true); // Make a search call with the options set in the filters builder $response = $photosLibraryClient->searchMediaItems( ['filters' => $filtersBuilder->build()] );
การใช้ตัวกรองร่วมกัน
รวมตัวกรองประเภทต่างๆ ได้ เฉพาะรายการที่ตรงกับ คุณลักษณะที่ขอจะแสดงผล
เมื่อรวมตัวกรอง ข้อจำกัดการจัดรูปแบบสำหรับตัวกรองแต่ละประเภทคือ
ไม่เท่ากันเมื่อใช้แยก ในตัวอย่างต่อไปนี้ รูปภาพเท่านั้น
ที่ได้รับการจัดหมวดหมู่เป็น SPORT
และมาจากปี 2014 หรือ 2010 จะ
ส่งคืนแล้ว:
REST
{ "filters": { "contentFilter": { "includedContentCategories": [ "SPORT" ] }, "dateFilter": { "dates": [ { "year": 2014 }, { "year": 2010 } ] }, "mediaTypeFilter": { "mediaTypes": [ "PHOTO" ] } } }
Java
// Create a new ContentFilter that only includes SPORT items ContentFilter contentFilter = ContentFilter.newBuilder() .addIncludedContentCategories(ContentCategory.SPORT) .build(); // Create a new media type filter that only includes PHOTO media items MediaTypeFilter mediaTypeFilter = MediaTypeFilter.newBuilder() .addMediaTypes(MediaType.PHOTO) .build(); // Create a new DateFilter that only includes items from 2010 or 2014 Date year2014 = Date.newBuilder().setYear(2014).build(); Date year2010 = Date.newBuilder().setYear(2010).build(); DateFilter dateFilter = DateFilter.newBuilder() .addDates(year2010) .addDates(year2014) .build(); // Create a new Filters object combining these filters Filters filters = Filters.newBuilder() .setDateFilter(dateFilter) .setMediaTypeFilter(mediaTypeFilter) .setContentFilter(contentFilter) .build(); // Specify the Filter object in the searchMediaItems call SearchMediaItemsPagedResponse response = photosLibraryClient.searchMediaItems(filters);
PHP
// Create a new ContentFilter $filtersBuilder = new FiltersBuilder(); // Only include SPORT items $filtersBuilder->addIncludedCategory(ContentCategory::SPORT); // Only include PHOTO media items $filtersBuilder->setMediaType(MediaType::PHOTO); // Only include items from 2010 or 2014 $year2014 = new Date(); $year2014->setYear(2014); $year2010 = new Date(); $year2010->setYear(2010); $filtersBuilder->addDateRange($year2010, $year2014); // Make a search call with the options set in the filters builder // Filters have been combined in the filter builder $response = $photosLibraryClient->searchMediaItems( ['filters' => $filtersBuilder->build()] );
กำลังจัดเรียงผลลัพธ์
จัดเรียงได้เฉพาะการค้นหาที่ใช้ตัวกรองวันที่
หากคุณไม่ระบุตัวเลือกการจัดเรียง ผลลัพธ์ของคุณจะถูกจัดเรียง ลำดับจากมากไปน้อย (จากใหม่สุดก่อน)
ตารางนี้แสดงตัวเลือกที่รองรับสําหรับพารามิเตอร์ orderBy
ได้แก่
พารามิเตอร์ orderBy รายการ |
|
---|---|
MediaMetadata.creation_time desc |
แสดงรายการสื่อตามลำดับจากมากไปน้อย (รายการใหม่ที่สุดก่อน) |
MediaMetadata.creation_time |
แสดงรายการสื่อตามลำดับจากน้อยไปมาก (รายการเก่าที่สุดก่อน) |
ตัวอย่างต่อไปนี้แสดงรายการสื่อทั้งหมดจากปี 2017 โดยแสดงรายการที่เก่าที่สุด ส่วนแรกและใหม่สุดเป็นอันสุดท้าย
REST
{ "filters": { "dateFilter": { "dates": [ { "year": 2017 } ] } }, "orderBy": "MediaMetadata.creation_time" }
Java
// Create a new dateFilter for the year 2017. DateFilter dateFilter = DateFilter.newBuilder() .addDates(Date.newBuilder().setYear(2017)) .build(); // Create a new Filters object Filters filters = Filters.newBuilder() .setDateFilter(dateFilter) .build(); // Sort results by oldest item first. final OrderBy newestFirstOrder = OrderBy.MEDIAMETADATA_CREATION_TIME; // Specify the filter and sort order in the searchMediaItems call. SearchMediaItemsPagedResponse response = photosLibraryClient.searchMediaItems(filters, newestFirstOrder);
PHP
// Create a new dateFilter for the year 2017. $filtersBuilder = new FiltersBuilder(); $filtersBuilder->addDate((new Date())->setYear(2017)); // Make a search call with the options set in the filters builder and sort // the results by oldest item first. $response = $photosLibraryClient->searchMediaItems( [ 'filters' => $filtersBuilder->build(), 'orderBy' => OrderBy::MEDIAMETADATA_CREATION_TIME ] );