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.
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.