Filtre arama ve uygulama

Gerekli yetkilendirme kapsamları

Google Fotoğraflar Kitaplığı API'si, medya öğelerine ve albümlere erişmek için kullanılan birden fazla kapsam içerir. Çeşitli çağrılardan döndürülen medya öğeleri, geliştirici tarafından istenen kapsamlara bağlı olarak farklılık gösterir.

photoslibrary.readonly kapsamı, kullanıcının kitaplığındaki tüm medya öğelerine erişim izni verir. photoslibrary.readonly.appcreateddata kapsamı, yalnızca uygulama tarafından oluşturulan medya öğelerine erişim izni verir. 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, yalnızca belirli bir güne ait hayvanlara ait öğeleri veya makbuz fotoğraflarını hariç tutmak isteyebilirsiniz. Bir albüme veya kitaplık girişine filtre uygulayarak belirli öğeleri hariç tutabilir ya da dahil edebilirsiniz. Medya öğesi özelliklerine dayalı olarak beş filtre bulunur:

albumId ayarlanırsa mediaItems:search isteğinde filtre kullanılmamalıdır. albüm kimliği ayarlandığında bir filtre kullanılırsa INVALID_ARGUMENT hatası (400) döndürülür.

Sonuçlar, medya öğesi oluşturma zamanına göre sıralanır. Tarih filtrelerini kullanan sorgular için sıralama düzeni değiştirilebilir.

Yeni yüklenen medyanın aramalarınızda görünmesi için biraz zaman tanıyın. Medya, filtrelenmemiş aramalarda hemen görünür.

Tarihi olan medya öğeleri, filtrelenmiş aramalarda görünmez. Filtreler, 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

POST isteği:

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çeriğini, albümleri ve medya öğelerini listeleme bölümünü inceleyin.

İçerik kategorileri

Tüm medya öğeleri işlenir ve etiketler 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 geniş bir medya aralığını kapsar. Bu kategori genellikle kullanıcının bir görevi gerçekleştirmek için yakaladığı öğeleri içerir ve bu görev tamamlandıktan sonra isteme olasılığı düşük olan öğelerdir. Dokümanlar, makbuzlar, ekran görüntüleri, yapışkan notlar, menüler ve diğer benzer medya öğeleri içerir.

Kategoriler, Google Fotoğraflar'daki eşdeğer etiketler kadar doğrudur. Bazı durumlarda öğeler yanlış etiketlenmiş olabilir. Bu nedenle, içerik kategorisi filtrelerinin doğruluğunu garanti etmeyiz.

Kategorilerin dahil edilmesi

Birden fazla kategori eklediğinizde, kategorilerden herhangi biriyle eşleşen medya öğeleri dahil edilir. İstek başına en fazla 10 kategori eklenebilir. 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 kategorilerden 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 ederken bazılarını hariç tutabilirsiniz. Aşağıdaki örnek, LANDSCAPES ve LANDMARKS değerini 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 sınırlar. Tarih filtresini belirtmenin iki yolu vardır: tarihler veya aralıklar. Tarihler ve aralıklar birlikte kullanılabilir. Tarihlerden 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ıralaması değiştirilebilir.

Tarihler

Tarih yıl, ay ve günü içerir. Aşağıdaki biçimler kabul edilebilir:

  • Yıl
  • Yıl, ay
  • Yıl, ay, gün
  • Ay, gün
  • Ay

Tarihin bir bileşeni boş veya sıfır olarak ayarlandığında, joker karakter olarak ele alınır. Örneğin, günü ve ayı ama yılı ayarlamadıysanız herhangi bir yılın günü ve ayındaki öğeleri istersiniz:

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ı, tarihlerden daha fazla esneklik sağlar. Örneğin, bir tarih aralığı birden fazla tarih eklemek yerine bir ay içindeki gün grubunu görmek için kullanılabilir.

Tarih aralığında startDate ve endDate bulunur. Her ikisinin de ayarlanması gerekir. Aralıktaki her tarih, Tarihler bölümünde açıklanan biçim kısıtlamalarına sahiptir. Tarihler aynı biçimde olmalıdır: Başlangıç tarihi bir yıl ve ay ise bitiş tarihi de bir yıl ve ay olmalıdır. Aralıklar kapsayıcı ş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 fazla tarih aralığı kullanabilirsiniz. Bu tarihlerden herhangi birine dahil olan öğeler sonuçlara dahil edilir. Ayrı tarihler ve tarih aralıkları aynı biçimde olmak zorunda değildir, ancak tek tek 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 (örneğin, Google Fotoğraflar uygulamasında favori olarak işaretlenmiş) sahip öğelerle kısıtlar.

Favoriler

Yalnızca kullanıcı tarafından favori olarak işaretlenen medya öğelerini döndürmek için FeatureFilter FAVORITES öğesi ö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 çeşitli resim biçimlerinden herhangi biri olabilir:

BMP JPG
GIF PNG
HEIC TIFF
ICO WEBP

Ayrıca iOS canlı fotoğrafları, hareketli fotoğraflar, panoramik fotoğraflar, fotoğraf küreleri ve VR fotoğrafları gibi özel fotoğraf türleri de dahildir.

Video

VIDEO çeşitli video biçimleri olabilir:

3GP MMV
3. Mevki MOD
ASF MOV
AVI MP4
DAHA FAZLA MPG
M2T MTS
M2TS TOD
M4V WMV
MKV  

VIDEO, aşağıdakiler gibi özel video biçimleri de içerir: VR videoları, ağır çekim videolar ve Google Fotoğraflar uygulamasında oluşturulan animasyonlar.

Aşağıdaki örnek, PHOTO etiketine göre filtreler:

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şivlenmiş durum

Kullanıcılarınız fotoğraflarından bazıları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 özelliklerin tümüyle eşleşen öğeler döndürülür.

Filtreleri birleştirirken, her bir filtre türünün biçimlendirme kısıtlamaları ayrı ayrı kullanıldığında uygulananlarla aynıdır. Aşağıdaki örnekte yalnızca SPORT olarak sınıflandırılan ve 2014 veya 2010'a ait fotoğraflar döndürülür:

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.

Bu tabloda, orderBy parametresi için desteklenen seçenekler gösterilmektedir:

orderBy parametresi
MediaMetadata.creation_time desc Medya öğelerini azalan düzende döndürür (önce en yeni öğeler)
MediaMetadata.creation_time Medya öğelerini artan düzende döndürür (önce en eski öğeleri)

Aşağıdaki örnek, 2017'den en eski ve en yeni olan 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
    ]
);