Oggetti ed errori delle risposte

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

Oggetto della risposta

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

Proprietà
created

float

Timestamp Unix che rappresenta la data di creazione del post.
hasaudio

boolean

Restituisce true se questo post contiene audio.
id

string

Identificatore di risultato di Tenor
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 funzioni di accessibilità dell'utente.
itemurl

string

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

boolean

Restituisce true se questo post contiene sottotitoli.
flags

string

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

string

Il colore 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 i dettagli sulle proprietà per gli oggetti Categoria:

Proprietà
searchterm

string

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

string

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

string

Un URL dell'origine multimediale della GIF di esempio della categoria
name

string

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

Oggetto multimediale

La tabella che segue fornisce dettagli sulle proprietà degli oggetti multimediali:

Proprietà
url

string

Un URL che rimanda all'origine di contenuti multimediali
dims

int[]

Larghezza e altezza dei contenuti multimediali in pixel
duration

float

Rappresenta il tempo in secondi per un loop di 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 diverse dimensioni:

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

I formati MP4 e WebM riproducono il clip solo una volta, ad eccezione di loopedmp4, che riproduce il clip alcune volte. Il formato GIF riproduce il clip in loop. I formati trasparenti sono adatti ai contenuti adesivi e non sono disponibili nei risultati di ricerca delle GIF.

Tipi di formati

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

Tipi di formati
preview
  • Risoluzione e dimensioni: formato GIF a frame singolo di alta qualità; di dimensioni inferiori rispetto al formato GIF.
  • Dimensioni: dimensioni di caricamento originali (senza limiti)
  • Note sull'utilizzo: impostalo come primo frame dei contenuti. Da utilizzare come anteprima delle miniature.

Questo formato è supportato per GIF e adesivi.
gif
  • Risoluzione e dimensioni: formato GIF di alta qualità; dimensione del file maggiore
  • Dimensioni: dimensioni di caricamento originali (senza limiti)
  • Note di utilizzo:utilizza queste dimensioni per le condivisioni di GIF sul desktop.

Questo formato è supportato per GIF e adesivi.
mediumgif
  • Risoluzione e dimensioni: riduzione ridotta delle dimensioni del formato GIF
  • Dimensioni: dimensioni di caricamento originali (senza limiti) ma frequenza di compressione di gran lunga maggiore
  • Note di 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: fino a 220 pixel di larghezza. Ridimensionate in altezza per mantenere le proporzioni.
  • Note di utilizzo:utilizza queste dimensioni per le anteprime e le condivisioni di GIF su dispositivo mobile.

Questo formato è supportato per GIF e adesivi.
nanogif
  • Risoluzione e dimensioni: le dimensioni ridotte del formato GIF
  • Dimensioni: fino a 90 pixel di altezza. Larghezza in scala per mantenere le proporzioni.
  • Note di 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 della massima qualità; i più grandi tra i formati video, ma più piccolo dei file GIF
  • Dimensioni: simili alle GIF, ma imbottite per adattarsi alle specifiche dei container video, di solito con incrementi di 8 pixel.
  • Note sull'utilizzo:utilizza questo formato per le anteprime e le condivisioni MP4 sul desktop.

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

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

Questo formato è supportato per GIF e adesivi.
nanomp4
  • Risoluzione e dimensioni: le dimensioni ridotte del formato MP4
  • Dimensioni: larghezza e altezza variabili, con un riquadro di delimitazione massimo di 150x150 pixel
  • Note sull'utilizzo:utilizza questo formato per le anteprime di file 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 imbottite per adattarsi alle specifiche dei container video, di solito con incrementi di 8 pixel.
  • Note di utilizzo: utilizza questo formato per le anteprime e le condivisioni di WebM su computer.

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

Questo formato è supportato per GIF e adesivi.
nanowebm
  • Risoluzione e dimensioni: le dimensioni ridotte del formato WebM
  • Dimensioni: larghezza e altezza variabili, con un riquadro di delimitazione massimo di 150 x 150 pixel
  • Note di 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 di adesivo WebP di alta qualità; dimensioni file più grandi disponibili
  • Dimensioni: dimensioni di caricamento originali (senza limiti)
  • Note sull'utilizzo:utilizza questa dimensione 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, scalate in altezza per mantenere le proporzioni.
  • Note di utilizzo: utilizza questa dimensione per le anteprime degli adesivi per gli utenti con larghezza di banda elevata e le condivisioni per gli utenti con larghezza di banda ridotta.

Questo formato è supportato per gli adesivi.
nanowebp_transparent
  • Risoluzione e dimensioni: le dimensioni minime del formato dell'adesivo WebP; dimensione massima 100 kB
  • Dimensioni: fino a 90 x 90 pixel, con la larghezza ridimensionata per mantenere le proporzioni.
  • Note sull'utilizzo:utilizza queste dimensioni per le anteprime di adesivi per gli utenti con larghezza di banda ridotta.

Questo formato è supportato per gli adesivi.
gif_transparent
  • Risoluzione e dimensioni: formato di adesivi GIF di alta qualità; dimensioni file più grandi disponibili
  • Dimensioni: dimensioni di caricamento originali (senza limiti)
  • Note sull'utilizzo:utilizza questa dimensione 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 dell'adesivo GIF; dimensione massima: 500 kB
  • Dimensioni: fino a 220 x 220 pixel, con un'altezza ridimensionata per mantenere le proporzioni.
  • Note di utilizzo: utilizza questa dimensione per le anteprime degli adesivi per gli utenti con larghezza di banda elevata e le condivisioni per gli utenti con larghezza di banda ridotta.

Questo formato è supportato per gli adesivi.
nanogif_transparent
  • Risoluzione e dimensioni: le dimensioni minime del formato dell'adesivo GIF; dimensione massima 100 kB
  • Dimensioni: fino a 90 x 90 pixel, con la larghezza ridimensionata per mantenere le proporzioni.
  • Note sull'utilizzo:utilizza queste dimensioni per le anteprime di adesivi per gli utenti con larghezza di banda ridotta.

Questo formato è supportato per gli adesivi.

Best practice

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

Dimensioni dei formati

Le dimensioni di file per ogni formato di contenuti dipendono dalle dimensioni e dalla lunghezza della GIF specifica selezionata. Pertanto, considera i mezzi e le mediane forniti nella seguente tabella come linee guida generali anziché valori rigidi.

Formato file Dimensioni file medie (kB) Dimensioni file medie (kB)
gif 3356 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

Codici di risposta

La seguente tabella fornisce i codici di risposta di 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 dell'API di Google. Per maggiori dettagli, vedi Errori.