Cakupan otorisasi yang diperlukan
Google Photos Library API berisi beberapa cakupan yang digunakan untuk mengakses item dan album media. Item media yang ditampilkan dari berbagai panggilan berbeda berdasarkan cakupan yang telah diminta oleh developer.
Cakupan photoslibrary.readonly
memungkinkan akses ke semua item media di
library pengguna. Cakupan photoslibrary.readonly.appcreateddata
hanya memungkinkan akses
ke item media yang dibuat oleh aplikasi. Untuk informasi selengkapnya, lihat
Cakupan otorisasi.
Filter yang tersedia
Anda dapat menelusuri jenis media tertentu di koleksi pengguna. Misalnya, Anda mungkin hanya menginginkan item yang bergambar hewan, dari hari tertentu, atau Anda mungkin ingin mengecualikan foto tanda terima. Anda dapat mengecualikan atau menyertakan item tertentu dengan menerapkan filter ke album atau Ada lima filter yang tersedia berdasarkan properti item media:
- Kategori konten (
includedContentCategories
,excludedContentCategories
) - Tanggal dan rentang tanggal (
dates
,ranges
) - Fitur (
featureFilter
) - Jenis media (
mediaTypeFilter
) - Status diarsipkan (
includeArchivedMedia
)
Filter tidak boleh digunakan dalam permintaan mediaItems:search
jika albumId
ditetapkan. Jika filter digunakan saat ID album ditetapkan, error INVALID_ARGUMENT
(400) akan ditampilkan.
Hasil diurutkan sesuai dengan waktu pembuatan item media. Urutan penyortiran dapat diubah untuk kueri menggunakan filter tanggal.
Tunggu beberapa saat agar media yang baru diupload muncul di penelusuran Anda. Media akan segera muncul dalam penelusuran yang tidak difilter.
Item media yang memiliki tanggal di masa mendatang tidak akan muncul di penelusuran yang difilter. Foto muncul dalam penelusuran yang tidak difilter dan penelusuran album.
Menerapkan filter
Untuk menerapkan filter, panggil
mediaItems.search
dan
tentukan properti filter
.
REST
Berikut adalah permintaan POST:
POST https://photoslibrary.googleapis.com/v1/mediaItems:search
Content-type: application/json
Authorization: Bearer oauth2-token
{
"pageSize": "100",
"filters": {
...
}
}
Permintaan POST menampilkan respons berikut:
{ "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 }
Untuk mengetahui detailnya, lihat Mencantumkan konten library, album, dan item media.
Kategori konten
Semua item media diproses dan diberi label. Anda dapat menyertakan dan mengecualikan salah satu kategori berikut.
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 |
Foto utilitas mencakup berbagai media. Kategori ini umumnya mencakup item yang telah diambil pengguna untuk melakukan beberapa tugas dan mungkin tidak diinginkan setelah tugas tersebut selesai. Termasuk dokumen, tanda terima, tangkapan layar, catatan tempel, menu, dan item media serupa lainnya.
Kategori ini hanya seakurat label yang setara di Google Foto. Terkadang, item mungkin salah diberi label, jadi kami tidak menjamin akurasi filter kategori konten.
Menyertakan kategori
Jika Anda menyertakan beberapa kategori, item media yang cocok dengan salah satu
kategori akan disertakan. Maksimal 10 kategori dapat disertakan per permintaan.
Filter contoh ini menampilkan item apa pun dari LANDSCAPES
atau 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()] );
Mengecualikan kategori
Hanya item media yang tidak cocok dengan kategori yang dikecualikan yang ditampilkan. Serupa dengan kategori yang disertakan, Anda dapat mengecualikan maksimal 10 kategori per permintaan.
Filter ini menampilkan item apa pun yang bukan PEOPLE
atau 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()] );
Menyertakan dan mengecualikan beberapa kategori
Anda dapat menyertakan beberapa kategori dan mengecualikan yang lainnya. Contoh berikut
menampilkan LANDSCAPES
dan LANDMARKS
, tetapi menghapus item media apa pun yang berisi
PEOPLE
atau yang berupa 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()] );
Tanggal dan rentang tanggal
Filter tanggal membatasi tanggal hasil yang ditampilkan ke kumpulan hari yang ditentukan. Ada dua cara untuk menentukan filter tanggal: tanggal, atau rentang. Tanggal dan rentang dapat digunakan bersama. Item media yang cocok dengan salah satu tanggal atau rentang tanggal akan ditampilkan. Jika ingin, Anda dapat mengubah urutan penyortiran hasil.
Tanggal
Tanggal berisi tahun, bulan, dan hari. Format berikut dapat diterima:
- Tahun
- Tahun, bulan
- Tahun, bulan, tanggal
- Bulan, tanggal
- Bulan
Jika komponen tanggal kosong atau ditetapkan ke nol, komponen tanggal tersebut diperlakukan sebagai karakter pengganti. Misalnya, jika Anda menetapkan hari dan bulan, tetapi bukan tahun, Anda meminta item dari hari dan bulan tersebut dalam tahun apa pun:
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()] );
Rentang tanggal
Rentang tanggal memberikan fleksibilitas yang lebih besar daripada tanggal. Misalnya, daripada menambahkan beberapa tanggal, rentang tanggal dapat digunakan untuk melihat kumpulan hari dalam sebulan.
Rentang tanggal memiliki startDate
dan endDate
, yang keduanya harus ditetapkan. Setiap
tanggal dalam rentang memiliki batasan format yang sama seperti yang dijelaskan dalam
Tanggal. Tanggal harus memiliki format yang sama: jika tanggal mulai adalah
tahun dan bulan, tanggal akhir juga harus berupa tahun dan bulan. Rentang
diterapkan secara inklusif, tanggal mulai dan akhir disertakan dalam filter yang diterapkan:
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()] );
Menggabungkan tanggal dan rentang tanggal
Anda dapat menggunakan beberapa tanggal dan beberapa rentang tanggal secara bersamaan. Item yang termasuk dalam salah satu tanggal tersebut akan disertakan dalam hasil. Tanggal dan rentang tanggal yang terpisah tidak harus mengikuti format yang sama, tetapi tanggal mulai dan akhir rentang tanggal individual harus mengikuti:
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()] );
Fitur item media
Filter fitur membatasi hasil ke item yang memiliki fitur tertentu, misalnya yang telah ditandai sebagai favorit di aplikasi Google Foto.
Favorit
Sertakan
fitur item FAVORITES
di
FeatureFilter
untuk hanya menampilkan item media yang telah ditandai sebagai favorit oleh pengguna:
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()] );
Jenis media
Anda dapat membatasi hasil pada jenis media: foto atau video.
Foto
PHOTO
dapat berupa salah satu dari beberapa format gambar:
BMP | JPG |
GIF | PNG |
KESEHATAN | TIFF |
ICO | WEBP |
Ini juga mencakup jenis foto khusus seperti foto live iOS, foto motion, panorama, photo sphere, dan foto VR.
Video
VIDEO
dapat berupa berbagai format video:
3GP | MMV |
3G2 | MOD |
{i>ASF<i} | MOV |
AVI | MP4 |
{i>DIVX<i} | MPG |
M2T | MTS |
M2TS | TOD |
M4V | WMV |
MKV |
VIDEO
juga mencakup format video khusus seperti berikut: video VR,
video gerak lambat, dan animasi yang dibuat di aplikasi
Google Foto.
Contoh berikut memfilter menurut 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()] );
Filter beberapa jenis media tidak dapat digabungkan.
Mengecualikan data yang tidak dibuat aplikasi
Untuk mengecualikan item media yang belum dibuat oleh aplikasi, Anda dapat menyetel
filter excludeNonAppCreatedData
seperti ditunjukkan dalam contoh berikut:
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()] );
Perhatikan bahwa jika Anda menggunakan cakupan
.readonly.appcreateddata
, filter ini akan diabaikan.
Status yang diarsipkan
Pengguna Anda mungkin telah mengarsipkan beberapa foto mereka. Secara default, foto yang diarsipkan tidak akan ditampilkan di penelusuran. Untuk menyertakan item yang diarsipkan, Anda dapat menetapkan tanda di filter seperti yang ditunjukkan pada contoh berikut:
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()] );
Menggabungkan filter
Berbagai jenis filter dapat digabungkan. Hanya item yang cocok dengan semua fitur yang diminta yang ditampilkan.
Saat menggabungkan filter, batasan pemformatan untuk setiap jenis filter
sama seperti saat digunakan satu per satu. Dalam contoh berikut, hanya foto
yang telah dikategorikan sebagai SPORT
dan berasal dari tahun 2014 atau 2010
yang ditampilkan:
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()] );
Mengurutkan hasil
Hanya kueri yang menggunakan filter tanggal yang dapat diurutkan.
Jika Anda tidak menetapkan opsi pengurutan, hasil akan diurutkan dalam urutan menurun (yang terbaru terlebih dahulu).
Tabel ini menunjukkan opsi yang didukung untuk parameter orderBy
:
Parameter orderBy |
|
---|---|
MediaMetadata.creation_time desc |
Menampilkan item media dalam urutan menurun (item terbaru terlebih dahulu) |
MediaMetadata.creation_time |
Menampilkan item media dalam urutan menaik (item terlama terlebih dahulu) |
Contoh berikut menampilkan semua item media dari 2017, yang menampilkan yang terlama pertama dan terbaru.
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 ] );