Yanıt nesneleri ve hataları

Bu sayfada, Tenor API tarafından kullanılan farklı JSON yanıtı ve hata nesneleri hakkında bilgi verilmektedir.

Yanıt nesnesi

Aşağıdaki tabloda, yanıt nesnelerinin özellikleri hakkında ayrıntılı bilgi verilmektedir:

Özellikler
created	float Bu gönderinin oluşturulduğu zamanı gösteren bir Unix zaman damgası.
hasaudio	boolean Bu yayında ses varsa true döndürür. Not: Yalnızca video biçimleri sesi destekler. GIF resim dosyası biçimi ses bilgisi içeremez.
id	string Tenor sonuç tanımlayıcısı
media_formats	{ CONTENT_FORMAT : MEDIA_OBJECT } Anahtar olarak içerik biçimi, değer olarak Medya Nesnesi içeren bir sözlük.
tags	string[] Yayınla ilgili etiket dizisi
title	string Yayının başlığı
content_description	string İçeriğin metin açıklaması. Kullanıcı erişilebilirlik özellikleri için content_description kullanmanızı öneririz.
itemurl	string Yayını tenor.com'da görüntülemek için kullanılan tam URL.
hascaption	boolean Bu yayında altyazı varsa true değerini döndürür.
flags	string İçeriğin çıkartma mı, statik resim mi olduğu, ses içerip içermediği veya bunların herhangi bir kombinasyonu olup olmadığını belirtmek için virgülle ayrılmış liste. sticker ve static yoksa içerik GIF'tir. Boş bir flags alanı, ses içermeyen bir GIF'i gösterir.
bg_color	string İçeriğin en yaygın arka plan piksel rengi
url	string Yayını tenor.com'da görüntülemek için kısa URL.

Kategori nesnesi

Aşağıdaki tabloda, Kategori Nesneleri'nin özellikleri hakkında ayrıntılı bilgi verilmektedir:

Özellikler
searchterm	string Kategoriye karşılık gelen arama terimi. Arama terimi, ilgili isteğin locale ile eşleşecek şekilde çevrilir.
path	string Kullanıcı kategoriyi seçerse istenilecek arama URL'si
image	string Kategorinin örnek GIF'inin medya kaynağı URL'si
name	string Resmin üzerine yerleştirilecek kategori adı. Ad, ilgili isteğin locale ile eşleşecek şekilde çevrilir.

Medya nesnesi

Aşağıdaki tabloda, Medya Nesneleri'nin özellikleri hakkında ayrıntılı bilgi verilmektedir:

Özellikler
url	string Medya kaynağının URL'si
dims	int[] Medyanın piksel cinsinden genişliği ve yüksekliği
duration	float İçeriğin bir döngüsünün saniye cinsinden süresini gösterir. İçerik statikse süre 0 olarak ayarlanır.
size	int Dosyanın bayt cinsinden boyutu

İçerik biçimleri

Tenor'un API'si, çeşitli boyutlarda aşağıdaki beş temel biçimi sunar:

• GIF
• MP4
• WebM
• Şeffaf WebP
• Saydam GIF

MP4 ve WebM biçimleri, klibi yalnızca bir kez oynatır. loopedmp4 biçimi ise klibi birkaç kez oynatır. GIF biçiminde klipler sürekli döngüde oynatılır. Şeffaf biçimler çıkartma içerikleri için kullanılır ve GIF arama sonuçlarında kullanılamaz.

Biçim türleri

Aşağıdaki tabloda, Tenor için kullanılabilen medya biçimi türleri hakkında ayrıntılı bilgi verilmektedir:

Biçim türleri
preview	Çözünürlük ve boyut: Yüksek kaliteli tek kareli GIF biçimi; GIF biçiminden daha küçüktür. Boyutlar: Yüklemenin orijinal boyutları (sınırlama yok) Kullanım notları: İçeriğin ilk karesi olarak kullanın. Küçük resim önizlemesi olarak kullanılmak üzere tasarlanmıştır. Bu biçim, GIF'ler ve çıkartmalar için desteklenir.
gif	Çözünürlük ve boyut: Yüksek kaliteli GIF biçimi; mevcut en büyük dosya boyutu Boyutlar: Yüklemenin orijinal boyutları (sınırlama yok) Kullanım notları: Bu boyutu, masaüstünde GIF paylaşımları için kullanın. Bu biçim, GIF'ler ve çıkartmalar için desteklenir.
mediumgif	Çözünürlük ve boyut: GIF biçiminin boyutunda küçük bir azalma Boyutlar: Orijinal yükleme boyutları (sınırsız) ancak çok daha yüksek sıkıştırma oranı Kullanım notları: Masaüstünde GIF önizlemeleri için bu boyutu kullanın. Bu biçim, GIF'ler ve çıkartmalar için desteklenir.
tinygif	Çözünürlük ve boyut: GIF biçiminin boyutu küçültülür. Boyutlar: 220 piksele kadar genişlik. En boy oranını korumak için yükseklik ölçeklendirilir. Kullanım notları: Bu boyutu, mobil cihazlarda GIF önizlemeleri ve paylaşımları için kullanın. Bu biçim, GIF'ler ve çıkartmalar için desteklenir.
nanogif	Çözünürlük ve boyut: GIF biçiminin en küçük boyutu Boyutlar: 90 piksele kadar yükseklik. En boy oranını korumak için genişlik ölçeklendirilir. Kullanım notları: Mobil cihazlarda GIF önizlemeleri için bu boyutu kullanın. Bu biçim, GIF'ler ve çıkartmalar için desteklenir.
mp4	Çözünürlük ve boyut: En yüksek kaliteli video biçimi; video biçimleri arasında en büyük olanıdır ancak GIF'ten küçüktür. Boyutlar: GIF'e benzer ancak genellikle 8 piksellik artışlarla video kapsayıcı özelliklerine uyacak şekilde doldurulur. Kullanım notları: Masaüstünde MP4 önizlemeleri ve paylaşımları için bu boyutu kullanın. Bu biçim, GIF'ler ve çıkartmalar için desteklenir.
loopedmp4	Çözünürlük ve boyut: En yüksek kaliteli video biçimi; MP4'ten daha büyük boyutlu Boyutlar: GIF'e benzer ancak genellikle 8 piksellik artışlarla video kapsayıcı özelliklerine uyacak şekilde doldurulur. Kullanım notları: Video klibin yalnızca bir kez değil birkaç kez oynatılmasını istediğinizde MP4 paylaşımları için bu boyutu kullanın. Bu biçim, GIF'ler ve çıkartmalar için desteklenir.
tinymp4	Çözünürlük ve boyut: MP4 biçiminin boyutu küçültülmüş olmalıdır. Boyutlar: Değişken genişlik ve yükseklik, maksimum sınırlayıcı kutu boyutu 320x320 pikseldir. Kullanım notları: Bu boyutu, mobil cihazlarda MP4 önizlemeleri ve paylaşımları için kullanın. Bu biçim, GIF'ler ve çıkartmalar için desteklenir.
nanomp4	Çözünürlük ve boyut: MP4 biçiminin en küçük boyutu Boyutlar: Değişken genişlik ve yükseklik, maksimum sınırlayıcı kutu boyutu 150x150 piksel Kullanım notları: Mobil cihazlarda MP4 önizlemeleri için bu boyutu kullanın. Bu biçim, GIF'ler ve çıkartmalar için desteklenir.
webm	Çözünürlük ve boyut: Daha düşük kaliteli video biçimi; MP4'ten daha küçük boyutlu Boyutlar: GIF'e benzer ancak genellikle 8 piksellik artışlarla video kapsayıcı özelliklerine uyacak şekilde doldurulur. Kullanım notları: Masaüstünde WebM önizlemeleri ve paylaşımları için bu boyutu kullanın. Bu biçim, GIF'ler ve çıkartmalar için desteklenir.
tinywebm	Çözünürlük ve boyut: WebM biçiminin boyutu küçültülür. Boyutlar: Değişken genişlik ve yükseklik, maksimum sınırlayıcı kutu boyutu 320x320 pikseldir. Kullanım notları: Mobil cihazlarda GIF paylaşımları için bu boyutu kullanın. Bu biçim, GIF'ler ve çıkartmalar için desteklenir.
nanowebm	Çözünürlük ve boyut: WebM biçiminin en küçük boyutu Boyutlar: Değişken genişlik ve yükseklik, maksimum sınırlayıcı kutu boyutu 150x150 piksel Kullanım notları: Mobil cihazlarda GIF önizlemeleri için bu boyutu kullanın. Bu biçim, GIF'ler ve çıkartmalar için desteklenir.
webp_transparent	Çözünürlük ve boyut: Yüksek kaliteli WebP çıkartma biçimi; mevcut en büyük dosya boyutu Boyutlar: Yüklemenin orijinal boyutları (sınırlama yok) Kullanım notları: Yüksek bant genişliğine sahip kullanıcılar için çıkartma paylaşımlarında bu boyutu kullanın. Bu biçim, çıkartmalar için desteklenir.
tinywebp_transparent	Çözünürlük ve boyut: WebP çıkartma biçiminin boyutu küçültülmüş olup maksimum boyut 500 KB'tır. Boyutlar: En fazla 220x220 piksel, en boy oranını korumak için yükseklik ölçeklendirilir. Kullanım notları: Yüksek bant genişliğine sahip kullanıcılar için çıkartma önizlemelerinde, düşük bant genişliğine sahip kullanıcılar için paylaşımlarda bu boyutu kullanın. Bu biçim, çıkartmalar için desteklenir.
nanowebp_transparent	Çözünürlük ve boyut: WebP çıkartma biçiminin en küçük boyutu; maksimum boyut 100 KB Boyutlar: En boy oranını korumak için genişlik ölçeklendirilerek 90x90 piksele kadar. Kullanım notları: Bu boyutu, bant genişliği düşük olan kullanıcılar için çıkartma önizlemelerinde kullanın. Bu biçim, çıkartmalar için desteklenir.
gif_transparent	Çözünürlük ve boyut: Yüksek kaliteli GIF çıkartma biçimi; mevcut en büyük dosya boyutu Boyutlar: Yüklemenin orijinal boyutları (sınırlama yok) Kullanım notları: Yüksek bant genişliğine sahip kullanıcılar için çıkartma paylaşımlarında bu boyutu kullanın. Bu biçim, çıkartmalar için desteklenir.
tinygif_transparent	Çözünürlük ve boyut: GIF çıkartma biçiminin boyutu küçültülmüştür. Maksimum boyut 500 KB'tır. Boyutlar: En boy oranını korumak için yükseklik ölçeklendirilerek 220x220 piksele kadar. Kullanım notları: Yüksek bant genişliğine sahip kullanıcılar için çıkartma önizlemelerinde, düşük bant genişliğine sahip kullanıcılar için paylaşımlarda bu boyutu kullanın. Bu biçim, çıkartmalar için desteklenir.
nanogif_transparent	Çözünürlük ve boyut: GIF çıkartma biçiminin en küçük boyutu; maksimum 100 KB boyut Boyutlar: En boy oranını korumak için genişlik ölçeklendirilerek 90x90 piksele kadar. Kullanım notları: Bu boyutu, bant genişliği düşük olan kullanıcılar için çıkartma önizlemelerinde kullanın. Bu biçim, çıkartmalar için desteklenir.

En iyi uygulamalar

• Mobil cihazlarda önizlemeler için nano veya tiny boyutlu dosyaları, paylaşımlar için ise tiny boyutlu dosyaları kullanın.
• media_filter parametresini kullanmayı planladığınız biçimlere ayarlayın. Bu, API yanıt boyutunu %70 oranında azaltabilir.

Biçim boyutları

Her içerik biçiminin dosya boyutu, seçilen GIF'in boyutlarına ve uzunluğuna bağlıdır. Bu nedenle, aşağıdaki tabloda verilen ortalama ve medyan değerleri kesin değerler olarak değil genel yönergeler olarak değerlendirin.

Dosya biçimi	Ortalama dosya boyutu (KB)	Ortalama dosya boyutu (KB)
gif	3.356	956
mediumgif	2.548	574
tinygif	521	101
nanogif	175	56
mp4	207	91
loopedmp4	515	228
tinymp4	84	81
nanomp4	37	28
webm	76	61
tinywebm	57	45
nanowebm	35	25
webp_transparent	530	95
tinywebp_transparent	249	60
nanowebp_transparent	107	25
gif_transparent	643	35
tinygif_transparent	349	20
nanogif_transparent	116	10

Yanıt kodları

Aşağıdaki tabloda, başarılı bir isteği belirtmek için kullanılan HTTP durum yanıt kodları verilmiştir:

HTTP durum kodu
200 veya 202	Tamam veya kabul edildi

Hatalar

Tenor'un API'si, 4xx veya 5xx HTTP yanıt kodlarıyla ve standart Google API hata biçiminde hatalar döndürür. Ayrıntılar için Hatalar bölümünü inceleyin.