Filtre arama ve uygulama

Gerekli yetkilendirme kapsamları

Google Photos Library API, 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, hangi kapsamlara bağlı olarak farklılık gösterir? için istekte bulunuldu.

photoslibrary.readonly kapsamı, şuradaki tüm medya öğelerine erişim izni verir: kullanıcının kitaplığı. photoslibrary.readonly.appcreateddata kapsamı erişime izin verir yalnızca uygulama tarafından oluşturulan medya öğeleriyle uyumludur. Daha fazla bilgi için bkz. Yetkilendirme kapsamları.

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 ya da başlıklı makaleyi inceleyin. Belirli öğeleri hariç tutmak veya dahil etmek için bir albüme veya kitaplık listesine filtre uygulama. Beş kullanılabilir filtre uygulayabilirsiniz:

mediaItems:search isteklerinde albumId özelliği geçerliyse filtreler kullanılmamalıdır ayarlandı. Albüm kimliği ayarlanırken filtre kullanılıyorsa INVALID_ARGUMENT hatası oluşuyor. (400) hatası döndürülür.

Sonuçlar, medya öğesi oluşturma zamanına göre sıralanır. İlgili içeriği oluşturmak için kullanılan Tarih filtreleri kullanan sorgular için sıralama sırası değiştirilebilir.

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

Gelecekteki bir tarihi olan 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 şu numarayı arayın: mediaItems.search ve filter özelliğini belirtin.

REST

Bir POST isteği şu şekildedir:

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 bkz. Kitaplık içeriklerini, albümleri ve medya öğelerini listeleyin.

İçerik kategorileri

Tüm medya öğeleri işlendi ve etiketler atandı. Dahil edebilir ve hariç tutabilirsiniz aşağıdaki kategorilerden herhangi birini seçebilirsiniz.

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 medyaları kapsar. Bu kategori genellikle Kullanıcının bir görevi gerçekleştirmek için yakaladığı ve sonrasında istemediği öğeler görevin tamamlandığına işaret eder. Dokümanlar, makbuzlar, ekran görüntüleri, yapışkan yazılar menüleri ve diğer benzer medya öğelerini içerir.

Kategoriler yalnızca, bu bölümdeki eşdeğer etiketler kadar doğrudur Google Fotoğraflar. Öğeler bazen yanlış etiketlenebilir. Bu nedenle garanti veremeyiz. içerik kategorisi filtrelerinin doğruluğu.

Kategorileri dahil etme

Birden fazla kategori eklediğinizde, 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 en fazla 10 kategori hariç tutulabilir ekleyebilirsiniz.

Bu filtre, PEOPLE veya SELFIES olmayan öğ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 kategori dahil etme ve hariç tutma

Bazı kategorileri dahil edebilir ve bazılarını hariç tutabilirsiniz. Aşağıdaki örnek LANDSCAPES ve LANDMARKS değerlerini döndürür, ancak aşağıdakileri içeren medya öğelerini kaldırır: PEOPLE veya SELFIES olan:

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 gün. Tarih filtresi belirtmenin iki yolu vardır: tarihler veya aralıklar. Tarihler ve birlikte kullanılabilir. Tarih veya tarihlerden herhangi biriyle eşleşen medya öğeleri aralığı döndürülür. İsteğe bağlı olarak, sonuçların sıralamasını değiştirilebilir.

Tarihler

Bir tarih bir 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
  • Gün, ay
  • Ay

Tarihin bir bileşeni boş olduğunda veya sıfıra ayarlandığında joker karakter. Örneğin, günü ve ayı ayarlayıp yıl ayarlamazsanız herhangi bir yılın söz konusu gününde ve ayında öğe isteme:

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, Arkadaş Bitkiler projesinin birden fazla tarih içeriyorsa, tarih aralığı bir ay içindeki bir dizi günü görmek için kullanılabilir.

Tarih aralığı, her ikisinin de ayarlanması gereken bir startDate ve endDate içeriyor. Her biri aralıktaki tarih, Tarihler. Tarihler aynı biçimde olmalıdır: başlangıç tarihi yıl ve ay; bitiş tarihi de yıl ve ay olmalıdır. Aralıklar: 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. Şu öğeler: bu tarihler arasında olması durumunda da sonuçlara dahil edilir. Ayrı tarihler ve aynı formatta olması gerekmez ancak bu tarih aralığının başlangıç ve bitiş tarihleri bağımsız aralıklar ş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, fotoğraf uygulamasında favori olarak işaretlenen örnek bir fotoğraf veya video yükleyin.

Favoriler

Şunu dahil et: FAVORITES öğe özelliğini FeatureFilter (yalnızca kullanıcı tarafından favori olarak işaretlenen medya öğelerini döndürmek için):

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: photo veya video değerleridir.

Fotoğraf

PHOTO, birkaç resim biçiminden herhangi biri olabilir:

BMP JPG
GIF PNG
HEIC TIFF
ICO WEBP

Ayrıca iOS canlı yayın fotoğrafları, hareketli fotoğraflar ve panoramalar, fotoğraf küreleri ve VR fotoğrafları.

Video

VIDEO, çeşitli video biçimlerinde olabilir:

3G MMV
3G2 MOD
ASF MOV
AVI MP4
DIVX MPG
M2T MTS
M2TS TOD
M4V WMV
MKV  

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

Aşağıdaki örnek PHOTO ölçütüne göre filtreleme yapar:

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 fazla medya türü filtresi birleştirilemez.

Uygulama tarafından oluşturulmayan verileri hariç tutma

Uygulamanız tarafından oluşturulmamış medya öğelerini hariç tutmak için excludeNonAppCreatedData filtresini kullanın:

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 bu filtre yoksayılır.

Arşivlendi durumu

Kullanıcılarınız, bazı fotoğraflarını arşivlemiş olabilir. Varsayılan olarak, arşivlenmiş fotoğraflar arama sonuçlarında döndürülmez. Arşivlenen öğeleri dahil etmek için aşağıdaki örnekte gösterildiği gibidir:

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 ve istenen özellikler döndürülür.

Filtreleri birleştirirken her filtre türünün biçimlendirme kısıtlamaları şu şekildedir: kullanımlarına kıyasla farklılık gösterebilir. Aşağıdaki örnekte yalnızca fotoğraflar SPORT olarak sınıflandırılan ve 2014 ya da 2010 yılına ait olanlar şunu döndürdü:

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ıralanıyor

Yalnızca tarih filtreleri kullanan sorgular sıralanabilir.

Bir sıralama seçeneği belirtmezseniz sonuçlarınız şuna göre sıralanır: azalan düzende (önce en yeniler).

Aşağıdaki 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 (en yeni öğeler önce)
MediaMetadata.creation_time Medya öğelerini artan düzende döndürür (en eski öğeler önce)

Aşağıdaki örnek, 2017'deki tüm medya öğelerini döndürerek en eski sonuncusu olacak.

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
    ]
);