1 Nisan 2025'te Library API'deki bazı kapsamlar kaldırıldı. Ayrıntıları buradan okuyabilirsiniz.

Bu sayfa, Cloud Translation API ile çevrilmiştir.

Filtre arama ve uygulama
Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Gerekli yetkilendirme kapsamları

photoslibrary.readonly kapsamı, kullanıcının kitaplığındaki tüm medya öğelerine erişim sağlar.

Uygulama tarafından oluşturulan içerikleri aramak ve filtre uygulamak için photoslibrary.readonly.appcreateddata kapsamı gerekir. Kapsamlar hakkında daha fazla bilgi için Yetkilendirme kapsamları başlıklı makaleyi inceleyin.

Kullanılabilir filtreler

Kullanıcının uygulama tarafından oluşturulan medya öğeleri kitaplığında belirli medya türlerini arayabilirsiniz. Örneğin, yalnızca belirli bir günde çekilmiş hayvan fotoğraflarını görmek isteyebilir 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 göre beş filtre kullanılabilir:

İçerik kategorileri (includedContentCategories, excludedContentCategories)
Tarihler ve tarih aralıkları (dates, ranges)
Özellikler (featureFilter)
Medya türleri (mediaTypeFilter)
Arşivlenmiş durum (includeArchivedMedia)

albumId ayarlanmışsa mediaItems.search isteğinde filtreler kullanılmamalıdır. albumId ayarlanırken filtre kullanılırsa INVALID_ARGUMENT hatası (400) döndürülür.

Sonuçlar, medya öğesinin oluşturulma süresine göre sıralanır. Tarih filtreleri kullanılan sorgular için sıralama düzeni değiştirilebilir.

Yeni yüklenen medyaların aramalarınızda görünmesi biraz zaman alabilir. Medya, filtrelenmemiş aramalarda hemen görünür.

Tarihi gelecekte olan medya öğeleri filtrelenmiş aramalarda görünmez. Bu fotoğraflar, filtrelenmemiş aramalarda ve albüm aramalarında gösterilir.

Filtre uygulama

Filtre uygulamak için mediaItems.search işlevini çağırın ve filter mülkünü 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 başlıklı makaleyi inceleyin.

İçerik kategorileri

Tüm medya öğeleri işlenir ve etiketler atanır. Aşağıdaki kategorilerden herhangi birini dahil edebilir veya 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 medyaları kapsar. Bu kategori genellikle kullanıcının bir görevi gerçekleştirmek için yakaladığı ve bu görev tamamlandıktan sonra büyük olasılıkla istemeyeceği öğeleri içerir. Belgeler, makbuzlar, ekran görüntüleri, yapışkan notlar, menüler ve diğer benzer medya öğelerini içerir.

Kategorilerin doğruluğu, Google Fotoğraflar'daki eşdeğer etiketlerin doğruluğuyla aynıdır. Öğeler bazen yanlış etiketlenebileceğinden içerik kategorisi filtrelerinin doğruluğunu garanti edemeyiz.

Kategorileri dahil etme

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 edebilir ve bazılarını hariç tutabilirsiniz. Aşağıdaki örnek, LANDSCAPES ve LANDMARKS sonuçlarını döndürür ancak PEOPLE veya SELFIES içeren 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ırlandırır. Tarih filtresi 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ıralama ölçütü 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
Gün, ay
Ay

Tarihin bir bileşeni boşsa veya sıfır olarak ayarlanmışsa 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üne ve ayına ait öğ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ı, tarihlere kıyasla daha fazla esneklik sağlar. Örneğin, bir ay içindeki belirli günleri görmek için birden fazla tarih eklemek yerine tarih aralığı kullanabilirsiniz.

Tarih aralığı, startDate ve endDate değerlerine sahiptir. Her iki değer de ayarlanmalıdır. 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 bir ay ise bitiş tarihi de bir yıl ve bir ay olmalıdır. Aralıklar dahili olarak 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 fazla tarih ve birden fazla 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 her bir aralığın başlangıç ve bitiş tarihi ş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 (ör. Google Fotoğraflar uygulamasında favori olarak işaretlenmiş öğeler) sınırlandırır.

Favoriler

Yalnızca kullanıcı tarafından favori olarak işaretlenen medya öğelerini döndürmek için FeatureFilter parametresine 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üne göre (fotoğraf veya video) sınırlayabilirsiniz.

Fotoğraf

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

BMP	JPG
GIF	PNG
HEIC	TIFF
ICO	WEBP

iOS canlı fotoğraflar, hareketli fotoğraflar, panoramalar, fotoğraf küreleri ve VR fotoğraflar gibi özel fotoğraf türleri de bu kapsamdadır.

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çimlerini de içerir: sanal gerçeklik videoları, yavaş çekim videolar ve Google Fotoğraflar uygulamasında oluşturulan animasyonlar.

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.

Arşivlendi durumu

Kullanıcılarınız, fotoğraflarının bir kısmını arşivlemiş olabilir. Arşivlenen fotoğraflar varsayılan olarak aramalarda döndürülmez. Arşivlenen öğeleri dahil etmek için filtreye aşağıdaki örnekte gösterildiği gibi 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.

Filtreler birleştirilirken her filtre türü için biçimlendirme kısıtlamaları, tek tek kullanıldığındaki gibidir. Aşağıdaki örnekte yalnızca SPORT olarak sınıflandırılan ve 2014 ya da 2010 yılına ait olan 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 kullanılan sorgular sıralanabilir.

Sıralama seçeneği belirtmezseniz sonuçlarınız azalan düzende (en yeniler önce) sıralanır.

Bu 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 (en yeni öğeler önce)
`MediaMetadata.creation_time`	Medya öğelerini artan düzende döndürür (en eski öğeler önce gelir)

Aşağıdaki örnekte, 2017'deki tüm medya öğeleri döndürülür. En eski öğe önce, en yeni öğe ise en son gösterilir.

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

Filtre arama ve uygulama Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Gerekli yetkilendirme kapsamları

Kullanılabilir filtreler

Filtre uygulama

REST

Java

PHP

İçerik kategorileri

Kategorileri dahil etme

REST

Java

PHP

Kategorileri hariç tutma

REST

Java

PHP

Birden fazla kategoriyi dahil etme ve hariç tutma

REST

Java

PHP

Tarihler ve tarih aralıkları

Tarihler

REST

Java

PHP

Tarih aralıkları

REST

Java

PHP

Tarihleri ve tarih aralıklarını birleştirme

REST

Java

PHP

Medya öğesi özellikleri

Favoriler

REST

Java

PHP

Medya türleri

Fotoğraf

Video

REST

Java

PHP

Arşivlendi durumu

REST

Java

PHP

Filtreleri birleştirme

REST

Java

PHP

Sonuçları sıralama

REST

Java

PHP

Filtre arama ve uygulama
Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.