Oggetti ed errori delle risposte

Questa pagina fornisce informazioni sui diversi oggetti di errore e risposta JSON utilizzati dall'API Tenor.

Oggetto Response

La seguente tabella fornisce dettagli sulle proprietà degli oggetti risposta:

Proprietà
created

float

Un timestamp Unix che rappresenta la data di creazione del post.
hasaudio

boolean

Restituisce true se questo post contiene audio.
id

string

Identificatore del risultato del periodo
media_formats

{ CONTENT_FORMAT : MEDIA_OBJECT }

Un dizionario con un formato dei contenuti come chiave e un oggetto multimediale come valore.
tags

string[]

Un array di tag per il post
title

string

Il titolo del post
content_description

string

Una descrizione testuale dei contenuti.

Ti consigliamo di utilizzare content_description per le funzionalità di accessibilità per gli utenti.
itemurl

string

L'URL completo per visualizzare il post su tenor.com.
hascaption

boolean

Restituisce true se questo post contiene sottotitoli codificati.
flags

string

Elenco separato da virgole per indicare se i contenuti sono un adesivo o un'immagine statica, se hanno audio o se sono una combinazione di questi elementi. Se sticker e static non sono presenti, il contenuto è una GIF. Un campo flags vuoto indica una GIF senza audio.
bg_color

string

Il colore dei pixel di sfondo più comune dei contenuti
url

string

Un URL breve per visualizzare il post su tenor.com.

Oggetto Categoria

La seguente tabella fornisce dettagli sulle proprietà degli oggetti categoria:

Proprietà
searchterm

string

Il termine di ricerca corrispondente alla categoria. Il termine di ricerca viene tradotto in modo che corrisponda al locale della richiesta corrispondente.
path

string

L'URL di ricerca da richiedere se l'utente seleziona la categoria
image

string

Un URL all'origine media per la GIF di esempio della categoria
name

string

Nome della categoria da sovrapporre all'immagine. Il nome viene tradotto in modo che corrisponda al locale della richiesta corrispondente.

Oggetto multimediale

La seguente tabella fornisce dettagli sulle proprietà degli oggetti multimediali:

Proprietà
url

string

Un URL dell'origine dei contenuti multimediali
dims

int[]

Larghezza e altezza del media in pixel
duration

float

Rappresenta il tempo in secondi per un ciclo dei contenuti. Se i contenuti sono statici, la durata è impostata su 0.
size

int

Dimensioni del file in byte

Formati dei contenuti

L'API di Tenor offre i seguenti cinque formati di base in varie dimensioni:

  • GIF
  • MP4
  • WebM
  • WebP trasparente
  • GIF trasparente

I formati MP4 e WebM riproducono il clip una sola volta, ad eccezione di loopedmp4, che lo riproduce alcune volte. Il formato GIF riproduce il clip in un loop continuo. I formati trasparenti sono per i contenuti degli adesivi e non sono disponibili nei risultati di ricerca delle GIF.

Tipi di formato

La seguente tabella fornisce dettagli sui tipi di formati multimediali disponibili per Tenor:

Tipi di formato
preview
  • Risoluzione e dimensioni: formato GIF a singolo frame di alta qualità; dimensioni inferiori rispetto al formato GIF
  • Dimensioni:dimensioni di caricamento originali (senza limiti)
  • Note sull'utilizzo: inserisci queste note nel primo frame del contenuto. È destinato all'uso come anteprima miniatura.

Questo formato è supportato per GIF e adesivi.
gif
  • Risoluzione e dimensioni: formato GIF di alta qualità; dimensioni del file più grandi disponibili
  • Dimensioni:dimensioni di caricamento originali (senza limiti)
  • Note sull'utilizzo:utilizza queste dimensioni per le condivisioni di GIF su computer.

Questo formato è supportato per GIF e adesivi.
mediumgif
  • Risoluzione e dimensioni:piccola riduzione delle dimensioni del formato GIF
  • Dimensioni: dimensioni di caricamento originali (senza limiti), ma con un tasso di compressione molto più elevato
  • Note sull'utilizzo: utilizza queste dimensioni per le anteprime delle GIF su computer.

Questo formato è supportato per GIF e adesivi.
tinygif
  • Risoluzione e dimensioni:dimensioni ridotte del formato GIF
  • Dimensioni: larghezza massima di 220 pixel. Altezza scalata per preservare le proporzioni.
  • Note sull'utilizzo: utilizza queste dimensioni per le anteprime e le condivisioni di GIF sui dispositivi mobili.

Questo formato è supportato per GIF e adesivi.
nanogif
  • Risoluzione e dimensioni:dimensioni più piccole del formato GIF
  • Dimensioni: fino a 90 pixel di altezza. Larghezza scalata per preservare le proporzioni.
  • Note sull'utilizzo:utilizza queste dimensioni per le anteprime delle GIF sui dispositivi mobili.

Questo formato è supportato per GIF e adesivi.
mp4
  • Risoluzione e dimensioni: formato video di massima qualità; il più grande dei formati video, ma più piccolo della GIF
  • Dimensioni:simili alle GIF, ma con spaziatura interna per adattarsi alle specifiche del contenitore video, che di solito sono incrementi di 8 pixel.
  • Note sull'utilizzo:utilizza queste dimensioni per le anteprime e le condivisioni MP4 su computer.

Questo formato è supportato per GIF e adesivi.
loopedmp4
  • Risoluzione e dimensioni:formato video di massima qualità; dimensioni maggiori rispetto a MP4
  • Dimensioni:simili alle GIF, ma con spaziatura interna per adattarsi alle specifiche del contenitore video, che di solito sono incrementi di 8 pixel.
  • Note sull'utilizzo:utilizza queste dimensioni per le condivisioni MP4 quando vuoi che il video clip venga riprodotto più volte anziché una sola volta.

Questo formato è supportato per GIF e adesivi.
tinymp4
  • Risoluzione e dimensioni:dimensioni ridotte del formato MP4
  • Dimensioni: larghezza e altezza variabili, con un riquadro di delimitazione massimo di 320 x 320 pixel
  • Note sull'utilizzo:utilizza queste dimensioni per le anteprime e le condivisioni MP4 sui dispositivi mobili.

Questo formato è supportato per GIF e adesivi.
nanomp4
  • Risoluzione e dimensioni:dimensioni più piccole del formato MP4
  • Dimensioni: larghezza e altezza variabili, con un riquadro di delimitazione massimo di 150x150 pixel
  • Note sull'utilizzo:utilizza queste dimensioni per le anteprime MP4 sui dispositivi mobili.

Questo formato è supportato per GIF e adesivi.
webm
  • Risoluzione e dimensioni:formato video di qualità inferiore; dimensioni inferiori rispetto a MP4
  • Dimensioni:simili alle GIF, ma con spaziatura interna per adattarsi alle specifiche del contenitore video, che di solito sono incrementi di 8 pixel.
  • Note sull'utilizzo:utilizza questa dimensione per le anteprime e le condivisioni WebM su computer.

Questo formato è supportato per GIF e adesivi.
tinywebm
  • Risoluzione e dimensioni:dimensioni ridotte del formato WebM
  • Dimensioni: larghezza e altezza variabili, con un riquadro di delimitazione massimo di 320x320 pixel
  • Note sull'utilizzo:utilizza queste dimensioni per le condivisioni di GIF sui dispositivi mobili.

Questo formato è supportato per GIF e adesivi.
nanowebm
  • Risoluzione e dimensioni: dimensioni più piccole del formato WebM
  • Dimensioni: larghezza e altezza variabili, con un riquadro di delimitazione massimo di 150x150 pixel
  • Note sull'utilizzo:utilizza queste dimensioni per le anteprime delle GIF sui dispositivi mobili.

Questo formato è supportato per GIF e adesivi.
webp_transparent
  • Risoluzione e dimensioni: formato adesivo WebP di alta qualità; dimensioni del file più grandi disponibili
  • Dimensioni:dimensioni di caricamento originali (senza limiti)
  • Note sull'utilizzo:utilizza queste dimensioni per le condivisioni di adesivi per gli utenti con larghezza di banda elevata.

Questo formato è supportato per gli adesivi.
tinywebp_transparent
  • Risoluzione e dimensioni: dimensioni ridotte del formato adesivo WebP; dimensione massima di 500 KB
  • Dimensioni: fino a 220 x 220 pixel, altezza scalata per mantenere le proporzioni.
  • Note sull'utilizzo: utilizza queste dimensioni per le anteprime degli adesivi per gli utenti con larghezza di banda elevata e per le condivisioni per gli utenti con larghezza di banda ridotta.

Questo formato è supportato per gli adesivi.
nanowebp_transparent
  • Risoluzione e dimensioni: dimensioni più piccole del formato adesivo WebP; dimensioni massime di 100 KB
  • Dimensioni: fino a 90 x 90 pixel, con la larghezza scalata per preservare le proporzioni.
  • Note sull'utilizzo:utilizza queste dimensioni per le anteprime degli adesivi per gli utenti con larghezza di banda ridotta.

Questo formato è supportato per gli adesivi.
gif_transparent
  • Risoluzione e dimensioni:formato adesivo GIF di alta qualità; dimensione file più grande disponibile
  • Dimensioni:dimensioni di caricamento originali (senza limiti)
  • Note sull'utilizzo:utilizza queste dimensioni per le condivisioni di adesivi per gli utenti con larghezza di banda elevata.

Questo formato è supportato per gli adesivi.
tinygif_transparent
  • Risoluzione e dimensioni: dimensioni ridotte del formato adesivo GIF; dimensioni massime di 500 KB
  • Dimensioni: fino a 220 x 220 pixel, con l'altezza scalata per preservare le proporzioni.
  • Note sull'utilizzo: utilizza queste dimensioni per le anteprime degli adesivi per gli utenti con larghezza di banda elevata e per le condivisioni per gli utenti con larghezza di banda ridotta.

Questo formato è supportato per gli adesivi.
nanogif_transparent
  • Risoluzione e dimensioni: dimensioni più piccole del formato adesivo GIF; dimensioni massime di 100 KB
  • Dimensioni: fino a 90 x 90 pixel, con la larghezza scalata per preservare le proporzioni.
  • Note sull'utilizzo:utilizza queste dimensioni per le anteprime degli adesivi per gli utenti con larghezza di banda ridotta.

Questo formato è supportato per gli adesivi.

Best practice

  • Per il mobile, utilizza i file di dimensioni nano o minuscole per le anteprime e i file di dimensioni minuscole per le condivisioni.
  • Imposta il parametro media_filter sui formati che intendi utilizzare. Ciò può ridurre le dimensioni della risposta dell'API del 70%.

Dimensioni dei formati

Le dimensioni del file per ogni formato dei contenuti dipendono dalle dimensioni e dalla durata della GIF specifica selezionata. Pertanto, considera le medie e le mediane fornite nella tabella seguente come linee guida generali piuttosto che come valori esatti.

Formato file Dimensioni medie dei file (KB) Dimensioni mediane del file (KB)
gif 3356 956
mediumgif 2548 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

Codici di risposta

La seguente tabella fornisce i codici di risposta dello stato HTTP utilizzati per indicare una richiesta riuscita:

Codice di stato HTTP
200 o 202 OK o accettato

Errori

L'API di Tenor restituisce errori con i codici di risposta HTTP 4xx o 5xx e nel formato di errore standard delle API di Google. Per maggiori dettagli, vedi Errori.