Gerekli yetkilendirme kapsamları
Google Photos Library API, medya öğelerine ve albümlere erişmek için kullanılan birden çok kapsam içerir. Çeşitli çağrılardan döndürülen medya öğeleri, geliştirici tarafından istenen kapsamlara göre farklılık gösterir.
photoslibrary.readonly
kapsamı, kullanıcının kitaplığındaki tüm medya öğelerine erişim sağlar. photoslibrary.readonly.appcreateddata
kapsamı, yalnızca uygulama tarafından oluşturulan medya öğelerine erişim sağlar. Daha fazla bilgi için Yetkilendirme kapsamları bölümüne bakın.
Kullanılabilir filtreler
Bir kullanıcının kitaplığında belirli medya türlerini arayabilirsiniz. Örneğin, sadece belirli bir güne ait hayvanlara ait eşyaları istiyor ya da makbuz fotoğraflarını hariç tutmak isteyebilirsiniz. Bir albüm veya kitaplık girişine filtreler uygulayarak belirli öğeleri hariç tutabilir ya da dahil edebilirsiniz. Medya öğesi özelliklerine dayalı beş filtre vardır:
- İçerik kategorileri (
includedContentCategories
,excludedContentCategories
) - Tarihler ve tarih aralıkları (
dates
,ranges
) - Özellikler (
featureFilter
) - Medya türleri (
mediaTypeFilter
) - Arşivlendi durumu (
includeArchivedMedia
)
albumId
ayarlanmışsa mediaItems:search
isteğinde filtreler kullanılmamalıdır. Albüm kimliği ayarlandığında filtre kullanılıyorsa INVALID_ARGUMENT
hatası (400) döndürülür.
Sonuçlar medya öğesi oluşturma zamanına göre sıralanır. Tarih filtreleri kullanılarak sorgular için sıralama düzeni değiştirilebilir.
Yeni yüklenen medyaların aramalarınızda görünmesi için biraz zaman tanıyın. Medya, filtrelenmemiş aramalarda hemen görünür.
Gelecek tarihli bir medya öğeleri, filtrelenen aramalarda görünmez. Bunlar, filtrelenmemiş aramalarda ve albüm aramalarında görünür.
Filtre uygulama
Filtre uygulamak için mediaItems.search
yöntemini çağırın ve filter
özelliğini belirtin.
REST
Aşağıda bir POST isteği verilmiştir:
POST https://photoslibrary.googleapis.com/v1/mediaItems:search
Content-type: application/json
Authorization: Bearer oauth2-token
{
"pageSize": "100",
"filters": {
...
}
}
POST isteği aşağıdaki yanıtı döndürür:
{ "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 }
Ayrıntılar için Kitaplık içeriklerini, albümleri ve medya öğelerini listeleme bölümüne bakın.
İçerik kategorileri
Tüm medya öğeleri işlenip etiketlere atanır. Aşağıdaki kategorilerin herhangi birini dahil edebilir ve hariç tutabilirsiniz.
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 |
Yardımcı fotoğraflar çok çeşitli medya öğelerini kapsar. Bu kategori genellikle kullanıcının bir görevi yerine getirmek için yakaladığı ve görev tamamlandıktan sonra bunu isteme olasılığı olmayan öğeleri içerir. Buna belgeler, makbuzlar, ekran görüntüleri, yapışkan notlar, menüler ve diğer benzer medya öğeleri dahildir.
Kategoriler yalnızca Google Fotoğraflar'daki eşdeğer etiketler kadar doğrudur. Bazen öğeler yanlış etiketlenebilir. Bu nedenle, içerik kategorisi filtrelerinin doğruluğunu garanti etmeyiz.
Kategorileri dahil etme
Birden çok kategori eklediğinizde, kategorilerin herhangi biriyle eşleşen medya öğeleri dahil edilir. İstek başına en fazla 10 kategori dahil edilebilir.
Bu örnek filtre, LANDSCAPES
veya LANDMARKS
öğelerini döndürür.
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()] );
Kategorileri hariç tutma
Yalnızca hariç tutulan kategorilerin hiçbiriyle eşleşmeyen medya öğeleri gösterilir. Dahil edilen kategorilere benzer şekilde, istek başına en fazla 10 kategori hariç tutulabilir.
Bu filtre, PEOPLE
veya SELFIES
olmayan tüm öğeleri döndürür:
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()] );
Birden fazla kategoriyi dahil etme ve hariç tutma
Bazı kategorileri dahil edip bazılarını hariç tutabilirsiniz. Aşağıdaki örnek, LANDSCAPES
ve LANDMARKS
değerlerini döndürür, ancak PEOPLE
içeren veya SELFIES
olan tüm medya öğelerini kaldırır:
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()] );
Tarihler ve tarih aralıkları
Tarih filtreleri, döndürülen sonuçların tarihini belirli bir gün grubuyla kısıtlar. İki şekilde tarih filtresi belirlenebilir: tarihler veya aralıklar. Tarihler ve aralıklar birlikte kullanılabilir. Tarihlerin veya tarih aralıklarından herhangi biriyle eşleşen medya öğeleri döndürülür. İsteğe bağlı olarak, sonuçların sıralama sırası değiştirilebilir.
Tarihler
Tarih yıl, ay ve gün içerir. Aşağıdaki biçimler kabul edilir:
- Yıl
- Yıl, ay
- Yıl, ay, gün
- Ay, gün
- Ay
Tarihin bir bileşeni boş olduğunda veya sıfıra ayarlandığında joker karakter olarak değerlendirilir. Örneğin, yılı değil de günü ve ayı ayarlarsanız herhangi bir yılın o gününden ve ayından öğeler istemiş olursunuz:
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()] );
Tarih aralıkları
Tarih aralıkları, tarihlere göre daha fazla esneklik sağlar. Örneğin, bir ay içindeki bir grup günü görmek için, birden fazla tarih eklemek yerine tarih aralığı kullanabilirsiniz.
Tarih aralığı, her ikisinin de ayarlanması gereken startDate
ve endDate
değerlerini içerir. Aralıktaki her tarih, Tarihler bölümünde açıklananlarla aynı biçim kısıtlamalarına sahiptir. Tarihler aynı biçimde olmalıdır: Başlangıç tarihi yıl ve ay ise bitiş tarihi de yıl ve ay olmalıdır. Aralıklar dahil olacak şekilde uygulanır, başlangıç ve bitiş tarihleri uygulanan filtreye dahil edilir:
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()] );
Tarihleri ve tarih aralıklarını birleştirme
Aynı anda birden çok tarih ve birden çok tarih aralığı kullanabilirsiniz. Bu tarihlerden herhangi birine denk gelen öğeler sonuçlara dahil edilir. Ayrı tarihlerin ve tarih aralıklarının aynı biçime sahip olması gerekmez ancak bağımsız aralıkların başlangıç ve bitiş tarihleri şunları yapar:
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()] );
Medya öğesi özellikleri
Özellik filtreleri, sonuçları belirli özelliklere sahip öğelerle kısıtlar. Örneğin, Google Fotoğraflar uygulamasında favori olarak işaretlenmiş öğeler.
Favoriler
Yalnızca kullanıcı tarafından favori olarak işaretlenen medya öğelerini döndürmek için FeatureFilter
öğesine FAVORITES
öğe özelliğini ekleyin:
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()] );
Medya türleri
Sonuçları medya türüyle sınırlandırabilirsiniz: fotoğraf veya video.
Fotoğraf
PHOTO
, birkaç resim biçiminden herhangi biri olabilir:
BMP | JPG |
GIF | PNG |
HEIC | TIFF |
ICO | WEBP |
Ayrıca iOS canlı fotoğrafları, hareketli fotoğraflar, panoramalar, fotoğraf küreleri ve VR fotoğrafları gibi özel fotoğraf türlerini de içerir.
Video
VIDEO
, çeşitli video biçimlerinde olabilir:
3. sırada | MMV |
3G | MOD |
ASF | MOV |
AVI | MP4 |
BİTİŞ | MPG |
M2T | MTS |
M2TS | TO |
M4V | WMV |
MKV |
VIDEO
ayrıca şunlar gibi özel video biçimlerini de içerir: VR videoları, ağır çekim videolar ve Google Fotoğraflar uygulamasında oluşturulan animasyonlar.
Aşağıdaki örnek, PHOTO
ölçütüne göre filtrelenmektedir:
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()] );
Birden çok medya türü filtresi birleştirilemez.
Uygulama tarafından oluşturulmayan verileri hariç tut
Uygulamanız tarafından oluşturulmayan medya öğelerini hariç tutmak için excludeNonAppCreatedData
filtresini aşağıdaki örnekte gösterildiği gibi ayarlayabilirsiniz:
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
kapsamını kullanıyorsanız bu filtrenin yoksayılacağını unutmayın.
Arşivlendi durumu
Kullanıcılarınız, bazı fotoğraflarını arşivlemiş olabilir. Varsayılan olarak, arşivlenen fotoğraflar aramalarda döndürülmez. Arşivlenmiş öğeleri dahil etmek için aşağıdaki örnekte gösterildiği gibi filtrede bir işaret ayarlayabilirsiniz:
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()] );
Filtreleri birleştirme
Farklı filtre türleri birleştirilebilir. Yalnızca istenen tüm özelliklerle eşleşen öğeler döndürülür.
Filtreleri birleştirirken, her filtre türünün biçimlendirme kısıtlamaları, tek tek kullanıldıklarında uygulananla aynıdır. Aşağıdaki örnekte yalnızca SPORT
olarak sınıflandırılan ve 2014 veya 2010 yılına ait fotoğraflar iade edilir:
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()] );
Sonuçları sıralama
Yalnızca tarih filtreleri kullanan sorgular sıralanabilir.
Bir sıralama seçeneği belirtmezseniz sonuçlarınız azalan düzende (önce en yeni) sıralanır.
Aşağıdaki tabloda orderBy
parametresi için desteklenen seçenekler gösterilmektedir:
orderBy parametresi |
|
---|---|
MediaMetadata.creation_time desc |
Medya öğelerini azalan sırada döndürür (önce en yeni öğeler) |
MediaMetadata.creation_time |
Medya öğelerini artan düzende döndürür (önce en eski öğeler) |
Aşağıdaki örnek, önce en eski ve en yeni olanı gösterecek şekilde 2017'deki tüm medya öğelerini döndürür.
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 ] );