Method: mediaItems.search

Kullanıcının Google Fotoğraflar kitaplığındaki medya öğelerini arar. Hiçbir filtre ayarlanmamışsa kullanıcının kitaplığındaki tüm medya öğeleri döndürülür. Bir albüm ayarlanırsa belirtilen albümdeki tüm medya öğeleri döndürülür. Filtreler belirtilirse kullanıcının kitaplığındaki filtrelerle eşleşen medya öğeleri listelenir. Hem albümü hem de filtreleri ayarlarsanız istek hatayla sonuçlanır.

HTTP isteği

POST https://photoslibrary.googleapis.com/v1/mediaItems:search

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

İstek içeriği

İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:

JSON gösterimi 
{
  "albumId": string,
  "pageSize": integer,
  "pageToken": string,
  "filters": {
    object (Filters)
  },
  "orderBy": string
}
Alanlar
albumId

string

Albümün tanımlayıcısıdır. Doldurulması durumunda, belirtilen albümdeki tüm medya öğeleri listelenir. Herhangi bir filtreyle birlikte ayarlanamaz.
pageSize

integer

Yanıtta döndürülecek maksimum medya öğesi sayısı. Belirtilen sayıdan daha az medya öğesi döndürülebilir. Varsayılan pageSize değeri 25, maksimum değer 100'dür.
pageToken

string

Sonuçların bir sonraki sayfasını almak için bir devam jetonu. Bu değer isteğe eklendiğinde pageToken öğesinden sonraki satırlar döndürülür. pageToken, searchMediaItems isteğine verilen yanıtta nextPageToken parametresinde döndürülen değer olmalıdır.
filters

object (Filters)

İsteğe uygulanacak filtreler. albumId ile birlikte ayarlanamaz.
orderBy

string

Arama sonuçlarının sıralama sırasını belirtmek için isteğe bağlı bir alan. orderBy alanı yalnızca bir dateFilter kullanıldığında çalışır. Bu alan belirtilmediğinde sonuçlar, creationTime değerlerine göre önce en yeni, sonra en eski olacak şekilde gösterilir. MediaMetadata.creation_time belirtildiğinde arama sonuçları zıt yönde (en eskiden önce ve en yeniden sonra) ters sırada görüntülenir. Önce en yeni, sonra en eski sonuçları sondan görüntülemek için desc bağımsız değişkenini şu şekilde ekleyin: MediaMetadata.creation_time desc.

Bu parametreyle yalnızca includeArchivedMedia ve excludeNonAppCreatedData ek filtreleri kullanılabilecektir. Başka hiçbir filtre desteklenmez.

Yanıt gövdesi

Arama parametreleriyle eşleşen medya öğelerinin listesi.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "mediaItems": [
    {
      object (MediaItem)
    }
  ],
  "nextPageToken": string
}
Alanlar
mediaItems[]

object (MediaItem)

Yalnızca çıkış. Arama parametreleriyle eşleşen medya öğelerinin listesi.
nextPageToken

string

Yalnızca çıkış. Sonraki medya öğesi grubunu almak için bu jetonu kullanın. Özelliğin varlığı, bir sonraki istekte daha fazla medya öğesinin kullanılabilir olduğuna dair tek güvenilir göstergedir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.readonly
  • https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata
  • https://www.googleapis.com/auth/photoslibrary.readonly.originals

Filtreler

Medya öğesi aramalarına uygulanabilecek filtreler. Birden fazla filtre seçeneği belirtilirse bunlar birbiriyle VE olarak değerlendirilir.

JSON gösterimi 
{
  "dateFilter": {
    object (DateFilter)
  },
  "contentFilter": {
    object (ContentFilter)
  },
  "mediaTypeFilter": {
    object (MediaTypeFilter)
  },
  "featureFilter": {
    object (FeatureFilter)
  },
  "includeArchivedMedia": boolean,
  "excludeNonAppCreatedData": boolean
}
Alanlar
dateFilter

object (DateFilter)

Medya öğelerini oluşturuldukları tarihe göre filtreler.
contentFilter

object (ContentFilter)

Medya öğelerini içeriklerine göre filtreler.
mediaTypeFilter

object (MediaTypeFilter)

Medya öğelerini, medya türüne göre filtreler.
featureFilter

object (FeatureFilter)

Medya öğelerini özelliklerine göre filtreler.
includeArchivedMedia

boolean

Ayarlanırsa sonuçlar, kullanıcının arşivlediği medya öğelerini içerir. Varsayılan olarak false değerini alır (arşivlenen medya öğeleri dahil edilmez).
excludeNonAppCreatedData

boolean

Ayarlanırsa sonuçlarda bu uygulama tarafından oluşturulmayan medya öğeleri hariç tutulur. Varsayılan olarak yanlış değerine ayarlanır (tüm medya öğeleri döndürülür). photoslibrary.readonly.appcreateddata kapsamı kullanılırsa bu alan yoksayılır.

DateFilter

Bu filtre, döndürülen medya için izin verilen tarihleri veya tarih aralıklarını tanımlar. Belirli tarihler ve tarih aralıkları grubu seçebilirsiniz. Medya öğesinin yakalandığı tarihi belirten meta veriler olmadan yüklenen medya öğeleri, tarih filtreleri kullanan sorgularda döndürülmez. Bu durumda Google Fotoğraflar sunucusu yükleme zamanı yedek olarak kullanılmaz.

JSON gösterimi 
{
  "dates": [
    {
      object (Date)
    }
  ],
  "ranges": [
    {
      object (DateRange)
    }
  ]
}
Alanlar
dates[]

object (Date)

Medya öğelerinin oluşturulma tarihiyle eşleşen tarihlerin listesi. İstek başına en fazla 5 tarih eklenebilir.
ranges[]

object (DateRange)

Medya öğeleriyle eşleşen tarih aralıklarının listesi oluşturulma tarihi. İstek başına en fazla 5 tarih aralığı eklenebilir.

Tarih

Tüm takvim tarihini temsil eder. Yalnızca ay ve yıl önemli olduğunda (ör. Aralık 2018'in tamamı) day değerini 0 olarak ayarlayın. Yalnızca yıl önemliyse (örneğin, 2018'in tamamı) day ve month değerlerini 0 olarak ayarlayın. Yalnızca gün ve ay önemli olduğunda (ör. yıl dönümü veya doğum günü) year değerini 0 olarak ayarlayın.

Desteklenmiyor: Tüm değerler 0, yalnızca month 0 olarak veya aynı anda hem day hem de year 0 olarak ayarlanıyor.

JSON gösterimi 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Alanlar
year

integer

Tarihin yılı. 1 ile 9999 arasında veya yıl içermeyen bir tarihi belirtmek için 0 arasında olmalıdır.
month

integer

Bir yılın ayı. 1 ile 12 arasında veya ay ve gün içermeyen bir yılı belirtmek için 0 arasında olmalıdır.
day

integer

Ayın günü. 1 ile 31 arasında olmalı ve yıl ile ay için geçerlidir. Günün önemli olmadığı bir yıl/ay belirtiyorsa bu değer 0 olmalıdır.

DateRange

Bir tarih aralığını tanımlar. Her iki tarih de aynı biçimde olmalıdır. Daha fazla bilgi için Date başlıklı makaleyi inceleyin.

JSON gösterimi 
{
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
Alanlar
startDate

object (Date)

Açıklanan biçimlerden birindeki başlangıç tarihi (aralığın bir parçası olarak dahil edilir).
endDate

object (Date)

Bitiş tarihi (aralığın bir parçası olarak dahil edilir). Bitiş tarihi, başlangıç tarihiyle aynı biçimde belirtilmelidir.

ContentFilter

Bu filtre, medya öğelerini içerik türüne göre döndürmenizi sağlar.

Dahil edilecek bir kategori ve/veya hariç tutulacak kategorilerin listesi belirtilebilir. Her listede, kategoriler bir VEYA ile birleştirilir.

includedContentCategories içerik filtresi, [c1, c2, c3] şunları içeren medya öğelerini alır (c1 VEYA c2 VEYA c3).

excludedContentCategories içerik filtresi: [c1, c2, c3], (c1 VEYA c2 VEYA c3) içeren medya öğelerini ALMAZ.

Bazı kategorileri hariç tutarken diğerlerini de dahil edebilirsiniz. Örnek: includedContentCategories: [c1, c2], excludedContentCategories: [c3, c4]

Önceki örnek, (c1 VEYA c2) VE DEĞİL (c3 VEYA c4) içeren medya öğelerini alır. includedContentategories içinde görünen bir kategori, excludedContentCategories içinde görüntülenmemelidir.

JSON gösterimi 
{
  "includedContentCategories": [
    enum (ContentCategory)
  ],
  "excludedContentCategories": [
    enum (ContentCategory)
  ]
}
Alanlar
includedContentCategories[]

enum (ContentCategory)

Medya öğesi arama sonuçlarına dahil edilecek kategori kümesi. Kümedeki öğelere OR (VEYA) uygulanır. İstek başına en fazla 10 includedContentCategories sınırı vardır.
excludedContentCategories[]

enum (ContentCategory)

Medya öğesi arama sonuçlarına dahil edilmeyecek kategori grubu. Kümedeki öğelere OR (VEYA) uygulanır. İstek başına en fazla 10 excludedContentCategories sınırı vardır.

ContentCategory

Bu, filtre uygulayabileceğiniz, önceden tanımlanmış bir içerik kategorileri kümesidir.

Sıralamalar
NONE Varsayılan içerik kategorisi. Bu kategori, filtrede başka bir kategori kullanıldığında yoksayılır.
LANDSCAPES Manzaralar içeren medya öğeleri.
RECEIPTS Makbuz içeren medya öğeleri.
CITYSCAPES Şehir manzaraları içeren medya öğeleri.
LANDMARKS Önemli noktalar içeren medya öğeleri.
SELFIES Selfie olan medya öğeleri.
PEOPLE Kişi içeren medya öğeleri.
PETS Evcil hayvan içeren medya öğeleri.
WEDDINGS Düğünlerden medya öğeleri.
BIRTHDAYS Doğum günlerinden medya öğeleri.
DOCUMENTS Belge içeren medya öğeleri.
TRAVEL Seyahat sırasında çekilen medya öğeleri.
ANIMALS Hayvan içeren medya öğeleri.
FOOD Yiyecek içeren medya öğeleri
SPORT Spor etkinliklerinden medya öğeleri.
NIGHT Medya öğeleri gece çekilmiş.
PERFORMANCES Performanslardan medya öğeleri.
WHITEBOARDS Beyaz tahta içeren medya öğeleri.
SCREENSHOTS Ekran görüntüsü olan medya öğeleri.
UTILITY Yardımcı olarak kabul edilen medya öğeleri. Bunlarla sınırlı olmamak üzere belgeler, ekran görüntüleri, beyaz tahtalar vb. bu kapsamda değerlendirilir.
ARTS Sanat eseri içeren medya öğeleri.
CRAFTS El işleri içeren medya öğeleri.
FASHION Moda ile ilgili medya öğeleri.
HOUSES Ev içeren medya öğeleri.
GARDENS Bahçeler içeren medya öğeleri.
FLOWERS Çiçek içeren medya öğeleri.
HOLIDAYS Tatil günlerinde alınan medya öğeleri.

MediaTypeFilter

Bu filtre, döndürülecek medya öğelerinin türünü (ör. videolar veya fotoğraflar) tanımlar. Yalnızca bir medya türü desteklenir.

JSON gösterimi 
{
  "mediaTypes": [
    enum (MediaType)
  ]
}
Alanlar
mediaTypes[]

enum (MediaType)

Dahil edilecek medya öğesi türleri. Bu alan yalnızca bir medya türüyle doldurulmalıdır. Birden fazla medya türü belirtirseniz hatayla karşılaşırsınız.

MediaType

Aranabilecek medya türleri grubu.

Sıralamalar
ALL_MEDIA Filtre uygulanmamış gibi değerlendirilir. Tüm medya türleri dahildir.
VIDEO Video olarak kabul edilen tüm medya öğeleri. Buna, kullanıcının Google Fotoğraflar uygulamasını kullanarak oluşturduğu filmler de dahildir.
PHOTO Fotoğraf olarak kabul edilen tüm medya öğeleri. Buna .bmp, .gif, .ico, .jpg (ve diğer yazımlar), .tiff, .webp ve iOS canlı fotoğrafları, Android hareketli fotoğrafları, panoramalar, fotoğraf küreleri gibi özel fotoğraf türleri dahildir.

FeatureFilter

Bu filtre, medya öğelerinin sahip olması gereken özellikleri tanımlar.

JSON gösterimi 
{
  "includedFeatures": [
    enum (Feature)
  ]
}
Alanlar
includedFeatures[]

enum (Feature)

Medya öğesi arama sonuçlarına dahil edilecek özellik kümesi. Kümedeki öğeler VEYA operatörüyle birleştirilir ve belirtilen özelliklerden herhangi biriyle eşleşebilir.

Özellik

Filtre uygulayabileceğiniz özellik grubu.

Sıralamalar
NONE Herhangi bir filtre uygulanmamış gibi işlem yapılır. Tüm özellikler dahildir.
FAVORITES Kullanıcının Google Fotoğraflar uygulamasında favori olarak işaretlediği medya öğeleri.