Wymagane zakresy autoryzacji
Interfejs Google Photos Library API zawiera wiele zakresów używanych do uzyskiwania dostępu do elementów multimedialnych i albumów. Elementy multimedialne zwracane z różnych wywołań różnią się w zależności od zakresów zostały zażądane przez dewelopera.
Zakres photoslibrary.readonly
umożliwia dostęp do wszystkich elementów multimedialnych w
w bibliotece użytkownika. Zakres photoslibrary.readonly.appcreateddata
zezwala na dostęp
tylko w przypadku elementów multimedialnych utworzonych przez aplikację. Więcej informacji:
Zakresy autoryzacji.
Dostępne filtry
W bibliotece użytkownika możesz wyszukiwać określone rodzaje multimediów. Na przykład: mogą wybrać tylko zwierzęta z określonego dnia, , aby wykluczyć zdjęcia paragonów. Możesz uwzględnić lub wykluczyć określone elementy poprzez przez zastosowanie filtrów w informacjach o albumach lub bibliotekach. Dostępnych jest pięć filtry oparte na właściwościach elementu multimedialnego:
- Kategorie treści (
includedContentCategories
,excludedContentCategories
). - Daty i zakresy dat (
dates
,ranges
) - Funkcje (
featureFilter
) - Typy multimediów (
mediaTypeFilter
) - Stan archiwalny (
includeArchivedMedia
)
Nie należy używać filtrów w żądaniu mediaItems:search
, jeśli albumId
ma wartość
ustawiony. Jeśli używany jest filtr, gdy ustawiony jest identyfikator albumu, wystąpi błąd INVALID_ARGUMENT
(400) jest zwracana.
Wyniki są sortowane według czasu utworzenia elementu multimedialnego. można zmienić kolejność sortowania w przypadku zapytań za pomocą filtrów daty.
Poczekaj, aż nowo przesłane multimedia pojawią się w wynikach wyszukiwania. Media pojawia się od razu w niefiltrowanych wyszukiwaniach.
Elementy multimedialne z datą w przyszłości nie pojawiają się w filtrowanych wyszukiwaniach. Pojawiają się w niefiltrowanych wynikach wyszukiwania i wyszukiwaniu albumów.
Stosowanie filtra
Aby zastosować filtr, wywołaj
mediaItems.search
i
określ właściwość filter
.
REST
Oto żądanie POST:
POST https://photoslibrary.googleapis.com/v1/mediaItems:search Content-type: application/json Authorization: Bearer oauth2-token { "pageSize": "100", "filters": { ... } }
Żądanie POST zwraca następującą odpowiedź:
{ "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 }
Więcej informacji: Wyświetlanie zawartości biblioteki, albumów i elementów multimedialnych
Kategorie treści
Wszystkie elementy multimedialne zostały przetworzone i otrzymały przypisane etykiety. Możesz uwzględniać i wykluczać dowolnej z tych kategorii.
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 |
Zdjęcia użytkowe obejmują szeroką gamę nośników. Ta kategoria zwykle obejmuje elementy przechwycone przez użytkownika w celu wykonania jakiegoś zadania, które prawdopodobnie nie są Ci potrzebne po dane zadanie jest wykonane. Obejmuje dokumenty, rachunki, zrzuty ekranu, przyklejone notatki, menu i inne podobne elementy multimedialne.
Kategorie są dokładnie takie same, jak odpowiadające im etykiety w Zdjęcia Google. Czasami produkty mogą być nieprawidłowo oznaczone, więc nie gwarantujemy dokładności filtrów kategorii treści.
W tym kategorie
Jeśli uwzględnisz wiele kategorii, elementy multimedialne pasujące do dowolnej
i kategoriach. W każdym żądaniu można uwzględnić maksymalnie 10 kategorii.
Ten przykładowy filtr zwraca wszystkie elementy LANDSCAPES
lub 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()] );
Wykluczanie kategorii
Wyświetlane są tylko elementy multimedialne, które nie pasują do żadnej z wykluczonych kategorii. Podobnie jak w przypadku uwzględnionych kategorii, można wykluczyć maksymalnie 10 kategorii. na żądanie.
Ten filtr zwraca wszystkie elementy, które nie są typu PEOPLE
ani 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()] );
Uwzględnianie i wykluczanie wielu kategorii
Możesz uwzględnić niektóre kategorie i wykluczyć inne. Przykład poniżej
zwraca LANDSCAPES
i LANDMARKS
, ale usuwa wszystkie elementy multimedialne, które zawierają
PEOPLE
lub 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()] );
Daty i zakresy dat
Filtry dat ograniczają datę zwróconych wyników do określonego zestawu dni. Filtr dat można określić na 2 sposoby: wybierając daty lub zakresy. Daty zakresów można używać razem. Elementy multimedialne pasujące do dowolnej daty lub daty zakresy są zwracane. Opcjonalnie możesz sortować wyniki. można zmienić.
Daty
Data zawiera rok, miesiąc i dzień. Akceptowane są następujące formaty:
- Rok
- Rok, miesiąc
- Rok, miesiąc, dzień
- Miesiąc, dzień
- Miesiąc
Jeśli komponent daty jest pusty lub ma wartość 0, jest traktowany jako symbol zastępczy. Na przykład jeśli ustawisz dzień i miesiąc, ale nie rok, wysyłania żądań elementów z danego dnia i miesiąca w dowolnym roku:
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()] );
Zakresy dat
Zakresy dat dają większą elastyczność niż daty. Na przykład zamiast dodawać wielu dat, można użyć zakresu dat, aby wyświetlić zestaw dni w miesiącu.
Zakres dat obejmuje właściwości startDate
i endDate
– oba te elementy muszą być skonfigurowane. Każdy
data w zakresie ma takie same ograniczenia formatu, jak opisano w
Daty. Daty muszą mieć ten sam format: jeśli data rozpoczęcia jest
rok i miesiąc, data zakończenia musi też obejmować rok i miesiąc. Zakresy to
są stosowane włącznie, daty rozpoczęcia i zakończenia są uwzględnione w zastosowanym filtrze:
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()] );
Łączenie dat i zakresów dat
Możesz używać wielu dat i wielu zakresów dat jednocześnie. Elementy, które które należą do dowolnej z tych dat, są uwzględniane w wynikach. Oddzielne daty Zakresy dat nie muszą mieć tego samego formatu, ale data rozpoczęcia i zakończenia poszczególne zakresy pozwalają:
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()] );
Funkcje elementu multimedialnego
Filtry cech ograniczają wyniki do elementów o określonych cechach, na przykład które zostały oznaczone jako ulubione w aplikacji Zdjęcia Google.
Ulubione
Dołącz
FAVORITES
element
w sekcji
FeatureFilter
, aby zwracać tylko elementy multimedialne, które zostały oznaczone przez użytkownika jako ulubione:
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()] );
Typy multimediów
Możesz ograniczyć wyniki do typu multimediów: photo lub filmu.
Zdjęcie
Element PHOTO
może mieć dowolny z kilku formatów obrazu:
BMP | JPG |
GIF | PNG |
HEIC | TIFF |
ICO | WebP |
Obejmuje też specjalne typy zdjęć, takie jak zdjęcia Live Photo w iOS, zdjęcia ruchome, panoram, zdjęć sferycznych i zdjęć VR.
Wideo
Element VIDEO
może mieć różne formaty wideo:
protokół 3 GP | MMV |
sieć 3G2, | MOD |
ASF | MOV |
AVI | MP4 |
DIVX | Spalanie |
M2T | MTS |
M2TS | TOD |
M4V | WMV |
MKV |
VIDEO
zawiera też specjalne formaty filmów, takie jak: filmy VR,
filmy w zwolnionym tempie i animacje utworzone w Zdjęciach Google.
aplikacji.
Ten przykładowy filtr umożliwia filtrowanie według parametru 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()] );
Nie można łączyć wielu typów multimediów.
Wykluczaj dane nieutworzone przez aplikacje
Aby wykluczyć elementy multimedialne, które nie zostały utworzone przez aplikację, możesz ustawić
filtr excludeNonAppCreatedData
zgodnie z tym przykładem:
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()] );
Pamiętaj, że jeśli używasz tagu
.readonly.appcreateddata
zakres, ten filtr jest ignorowany.
Stan: zarchiwizowano
Użytkownicy mogli zarchiwizować niektóre swoje zdjęcia. Domyślnie zarchiwizowane zdjęcia nie są zwracane. Aby uwzględnić zarchiwizowane elementy, możesz ustawić flagę w jak w tym przykładzie:
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()] );
Łączenie filtrów
Można łączyć różne rodzaje filtrów. Tylko elementy spełniające wszystkie zwracane są żądane funkcje.
Przy łączeniu filtrów ograniczenia formatowania dla każdego typu filtra to
tak samo jak przy korzystaniu z nich pojedynczo. W poniższym przykładzie tylko zdjęcia
należące do kategorii SPORT
i pochodzące z 2014 lub 2010 roku,
zwrócone:
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()] );
Sortowanie wyników
Można sortować tylko zapytania korzystające z filtrów daty.
Jeśli nie określisz opcji sortowania, wyniki zostaną posortowane według malejąco (od najnowszych).
Ta tabela zawiera obsługiwane opcje parametru orderBy
:
Parametr orderBy |
|
---|---|
MediaMetadata.creation_time desc |
Zwraca elementy multimedialne w kolejności malejącej (najpierw najnowsze elementy) |
MediaMetadata.creation_time |
Zwraca elementy multimedialne w kolejności rosnącej (od najstarszych) |
Ten przykład zwraca wszystkie elementy multimedialne z 2017 r., przy czym najstarsze jako pierwszy, a najnowszy na końcu.
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 ] );