- HTTP isteği
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- Filtreler
- DateFilter
- Tarih
- DateRange
- ContentFilter
- ContentCategory
- MediaTypeFilter
- MediaType
- FeatureFilter
- Özellik
- Deneyin.
Kullanıcının Google Fotoğraflar kitaplığındaki medya öğelerini arar. Hiçbir filtre ayarlanmazsa 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
İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:
JSON gösterimi |
---|
{
"albumId": string,
"pageSize": integer,
"pageToken": string,
"filters": {
object ( |
Alanlar | |
---|---|
albumId |
Bir albümün tanımlayıcısı. Doldurulduğunda, belirtilen albümdeki tüm medya öğelerini listeler. Herhangi bir filtreyle birlikte ayarlanamaz. |
pageSize |
Yanıtta döndürülecek maksimum medya öğesi sayısı. Belirtilen sayıdan daha az medya öğesi döndürülebilir. Varsayılan |
pageToken |
Sonuçların sonraki sayfasını almak için bir devam jetonu. İsteğe bu dizenin eklenmesi, |
filters |
İsteğe uygulanacak filtreler. |
orderBy |
Arama sonuçlarının sıralama düzenini belirtmek için kullanılan isteğe bağlı bir alan. Bu parametreyle kullanılabilecek ek filtreler yalnızca |
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 ( |
Alanlar | |
---|---|
mediaItems[] |
Yalnızca çıkış. Arama parametreleriyle eşleşen medya öğelerinin listesi. |
nextPageToken |
Yalnızca çıkış. Bir sonraki medya öğesi grubunu almak için bu jetonu kullanın. Bu öğenin 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
Filtreler
Medya öğesi aramasına uygulanabilecek filtreler. Birden çok filtre seçeneği belirtilirse, bunlar birbiriyle VE olarak ele alınır.
JSON gösterimi |
---|
{ "dateFilter": { object ( |
Alanlar | |
---|---|
dateFilter |
Medya öğelerini oluşturulma tarihlerine göre filtreler. |
contentFilter |
Medya öğelerini içeriklerine göre filtreler. |
mediaTypeFilter |
Medya öğelerini medya türüne göre filtreler. |
featureFilter |
Medya öğelerini özelliklerine göre filtreler. |
includeArchivedMedia |
Ayarlanırsa sonuçlar, kullanıcının arşivlediği medya öğelerini içerir. Varsayılan olarak yanlış değerine ayarlanır (arşivlenen medya öğeleri dahil edilmez). |
excludeNonAppCreatedData |
Politika 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ı kümesi 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 sunucu yükleme saati yedek olarak kullanılmaz.
JSON gösterimi |
---|
{ "dates": [ { object ( |
Alanlar | |
---|---|
dates[] |
Medya öğelerinin oluşturulma tarihiyle eşleşen tarihlerin listesi. İstek başına en fazla 5 tarih eklenebilir. |
ranges[] |
Medya öğelerinin oluşturulma tarihiyle eşleşen tarih aralıklarının listesi. İstek başına en fazla 5 tarih aralığı eklenebilir. |
Tarih
Tüm takvim tarihini temsil eder. Yalnızca ay ve yıl önemliyse (ö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 önemliyse (ör. yıl dönümü veya doğum günü) year
değerini 0 olarak ayarlayın.
Desteklenmez: Tüm değerlerin 0, yalnızca month
değerinin 0 veya hem day
hem de year
değerlerinin aynı anda 0 olarak ayarlanması.
JSON gösterimi |
---|
{ "year": integer, "month": integer, "day": integer } |
Alanlar | |
---|---|
year |
Tarihin yılı. 1 ile 9999 arasında veya yıl içermeyen bir tarih belirtmek için 0 olmalıdır. |
month |
Yılın ayı. 1 ile 12 arasında veya ay ve gün içermeyen bir yılı belirtmek için 0 olmalıdır. |
day |
Ayın günü. 1 ile 31 arasında olup yıl ve ay için geçerli olmalıdır veya günün önemli olmadığı bir yıl/ay belirtiyorsa 0 olmalıdır. |
DateRange
Tarih aralığı 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 ( |
Alanlar | |
---|---|
startDate |
Açıklanan biçimlerden birindeki başlangıç tarihi (aralığın bir parçası olarak dahildir). |
endDate |
Bitiş tarihi (aralığın bir parçası olarak dahildir). Bu değer, başlangıç tarihiyle aynı biçimde belirtilmelidir. |
ContentFilter
Bu filtre, içerik türüne göre medya öğelerini döndürmenizi sağlar.
Dahil edilecek kategorilerin ve/veya hariç tutulacak kategorilerin listesini belirtebilirsiniz. Her listede, kategoriler bir VEYA ifadesiyle birleştirilir.
includedContentCategories
içerik filtresi: [c1, c2, c3], (c1 OR c2 OR c3) içeren medya öğelerini alır.
excludedContentCategories
içerik filtresi: [c1, c2, c3], (c1 VEYA c2 VEYA c3) içeren medya öğelerini ALMAZ.
Ayrıca, şu örnekte olduğu gibi bazı kategorileri hariç tutarken bazılarını dahil edebilirsiniz: includedContentCategories
: [c1, c2], excludedContentCategories
: [c3, c4]
Önceki örnek, (c1 OR c2) AND NOT (c3 OR c4) içeren medya öğelerini alır. includedContentategories
içinde görünen bir kategori excludedContentCategories
içinde görünmemelidir.
JSON gösterimi |
---|
{ "includedContentCategories": [ enum ( |
Alanlar | |
---|---|
includedContentCategories[] |
Medya öğesi arama sonuçlarına dahil edilecek kategori kümesi. Kümedeki öğelerde OR işlemi uygulanır. İstek başına en fazla 10 |
excludedContentCategories[] |
Medya öğesi arama sonuçlarına dahil edilmeyecek kategori kümesi. Kümedeki öğelerde OR işlemi uygulanır. İstek başına en fazla 10 |
ContentCategory
Bu, filtre uygulayabileceğiniz önceden tanımlanmış bir içerik kategorileri kümesidir.
Sıralamalar | |
---|---|
NONE |
Varsayılan içerik kategorisi. Filtrede başka bir kategori kullanılıyorsa bu kategori yoksayılır. |
LANDSCAPES |
Yatay içeren medya öğeleri. |
RECEIPTS |
Makbuzları 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şileri içeren medya öğeleri. |
PETS |
Evcil hayvan içeren medya öğeleri. |
WEDDINGS |
Düğünlerden medya öğeleri. |
BIRTHDAYS |
Doğum günlerinden medya öğeleri. |
DOCUMENTS |
Doküman içeren medya öğeleri. |
TRAVEL |
Seyahat sırasında alınan medya öğeleri. |
ANIMALS |
Hayvan içeren medya öğeleri. |
FOOD |
Yiyecek içeren medya öğeleri. |
SPORT |
Spor etkinliklerine ait medya öğeleri. |
NIGHT |
Gece alınan medya öğeleri. |
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. Bu görüntülere dokümanlar, ekran görüntüleri, beyaz tahtalar vb. dahildir, ancak bunlarla sınırlı değildir. |
ARTS |
Sanat eseri içeren medya öğeleri. |
CRAFTS |
El işi içeren medya öğeleri. |
FASHION |
Modayla ilgili medya öğeleri. |
HOUSES |
Ev içeren medya öğeleri. |
GARDENS |
Bahçe içeren medya öğeleri. |
FLOWERS |
Çiçek içeren medya öğeleri. |
HOLIDAYS |
Tatil dönemlerinde alınan medya öğeleri. |
MediaTypeFilter
Bu filtre, döndürülecek medya öğelerinin (ör. videolar veya fotoğraflar) türünü tanımlar. Yalnızca bir medya türü desteklenir.
JSON gösterimi |
---|
{
"mediaTypes": [
enum ( |
Alanlar | |
---|---|
mediaTypes[] |
Dahil edilecek medya öğelerinin türleri. Bu alan yalnızca bir medya türüyle doldurulmalıdır. Birden çok medya türü belirtirseniz hata oluşur. |
MediaType
Aranabilecek medya türleri kümesi.
Sıralamalar | |
---|---|
ALL_MEDIA |
Hiçbir filtre uygulanmamış gibi işlenir. 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. Bunlara .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 öğelerinde sahip olması gereken özellikleri tanımlar.
JSON gösterimi |
---|
{
"includedFeatures": [
enum ( |
Alanlar | |
---|---|
includedFeatures[] |
Medya öğesi arama sonuçlarına dahil edilecek özellik kümesi. Kümedeki öğeler OR'dedir ve belirtilen özelliklerin herhangi biriyle eşleşebilir. |
Öne Çıkarın
Filtre uygulayabileceğiniz özellik grubu.
Sıralamalar | |
---|---|
NONE |
Hiçbir filtre uygulanmamış gibi işlenir. Tüm özellikler dahildir. |
FAVORITES |
Kullanıcının Google Fotoğraflar uygulamasında favori olarak işaretlediği medya öğeleri. |