Obiekty i błędy odpowiedzi

Na tej stronie znajdziesz informacje o różnych obiektach odpowiedzi JSON i błędów używanych przez interfejs Tenor API.

Obiekt odpowiedzi

W tabeli poniżej znajdziesz szczegółowe informacje o właściwościach obiektów odpowiedzi:

Właściwości
created	float Sygnatura czasowa w formacie czasu uniksowego, która określa, kiedy został utworzony ten post.
hasaudio	boolean Zwraca true, jeśli ten post zawiera dźwięk. Uwaga: dźwięk jest obsługiwany tylko w przypadku formatów wideo. Format pliku obrazu GIF nie może zawierać informacji o dźwięku.
id	string Identyfikator wyniku okresu
media_formats	{ CONTENT_FORMAT : MEDIA_OBJECT } Słownik, w którym kluczem jest format treści, a wartością obiekt multimedialny.
tags	string[] Tablica tagów posta.
title	string Tytuł posta
content_description	string Tekstowy opis treści. Zalecamy używanie content_description w przypadku funkcji ułatwień dostępu dla użytkowników.
itemurl	string Pełny adres URL, pod którym można wyświetlić posta na stronie tenor.com.
hascaption	boolean Zwraca wartość true, jeśli ten post zawiera napisy.
flags	string Lista rozdzielona przecinkami, która określa, czy treść jest naklejką, obrazem statycznym, zawiera dźwięk lub jest dowolną kombinacją tych elementów. Jeśli tagi sticker i static nie są obecne, treść jest GIF-em. Puste pole flags oznacza GIF-a bez dźwięku.
bg_color	string Najczęstszy kolor piksela tła treści
url	string Krótki URL, który umożliwia wyświetlenie posta na stronie tenor.com.

Obiekt kategorii

W tabeli poniżej znajdziesz szczegółowe informacje o właściwościach obiektów kategorii:

Właściwości
searchterm	string Wyszukiwane hasło odpowiadające kategorii. Wyszukiwane hasło jest tłumaczone tak, aby pasowało do locale odpowiedniego żądania.
path	string Adres URL wyszukiwania, o który należy poprosić, jeśli użytkownik wybierze kategorię
image	string Adres URL źródła multimediów przykładowego GIF-a w kategorii.
name	string Nazwa kategorii, która ma być wyświetlana na obrazie. Nazwa jest tłumaczona tak, aby pasowała do locale odpowiedniego żądania.

Obiekt multimedialny

W tabeli poniżej znajdziesz szczegółowe informacje o właściwościach obiektów multimedialnych:

Właściwości
url	string Adres URL źródła multimediów
dims	int[] Szerokość i wysokość multimediów w pikselach
duration	float Reprezentuje czas w sekundach potrzebny na odtworzenie treści w pętli. Jeśli treść jest statyczna, czas trwania jest ustawiony na 0.
size	int Rozmiar pliku w bajtach

Formaty treści

Interfejs API Tenora oferuje te 5 podstawowych formatów w różnych rozmiarach:

• GIF
• MP4
• WebM
• Przezroczysty WebP
• Przezroczysty GIF

Formaty MP4 i WebM odtwarzają klip tylko raz, z wyjątkiem formatu loopedmp4, który odtwarza klip kilka razy. Format GIF odtwarza klip w nieskończonej pętli. Formaty przezroczyste są przeznaczone dla naklejek i nie są dostępne w wynikach wyszukiwania GIF-ów.

Typy formatów

W tabeli poniżej znajdziesz szczegółowe informacje o dostępnych typach formatów multimediów w przypadku Tenora:

Typy formatów
preview	Rozdzielczość i rozmiar: wysokiej jakości format GIF z jedną klatką; mniejszy niż format GIF. Wymiary: wymiary pierwotnego przesłanego pliku (bez ograniczeń). Zastosowanie: ustaw tę klatkę jako pierwszą klatkę treści. Jest on przeznaczony do użycia jako miniatura podglądu. Ten format jest obsługiwany w przypadku GIF-ów i naklejek.
gif	Rozdzielczość i rozmiar: wysokiej jakości format GIF, największy dostępny rozmiar pliku. Wymiary: wymiary pierwotnego przesłanego pliku (bez ograniczeń). Uwagi dotyczące użycia: używaj tego rozmiaru do udostępniania GIF-ów na komputerze. Ten format jest obsługiwany w przypadku GIF-ów i naklejek.
mediumgif	Rozdzielczość i rozmiar: niewielkie zmniejszenie rozmiaru formatu GIF. Wymiary: oryginalne wymiary przesyłanego pliku (bez ograniczeń), ale znacznie wyższy współczynnik kompresji Uwagi dotyczące użycia: używaj tego rozmiaru w przypadku podglądów GIF-ów na komputerach. Ten format jest obsługiwany w przypadku GIF-ów i naklejek.
tinygif	Rozdzielczość i rozmiar: zmniejszony rozmiar formatu GIF Wymiary: do 220 pikseli szerokości. Wysokość została przeskalowana, aby zachować współczynnik proporcji. Uwagi dotyczące użycia: używaj tego rozmiaru w przypadku podglądów i udostępniania GIF-ów na urządzeniach mobilnych. Ten format jest obsługiwany w przypadku GIF-ów i naklejek.
nanogif	Rozdzielczość i rozmiar: najmniejszy rozmiar formatu GIF. Wymiary: do 90 pikseli wysokości. Szerokość została przeskalowana, aby zachować współczynnik proporcji. Uwagi dotyczące użycia: używaj tego rozmiaru w przypadku podglądów GIF-ów na urządzeniach mobilnych. Ten format jest obsługiwany w przypadku GIF-ów i naklejek.
mp4	Rozdzielczość i rozmiar: format wideo o najwyższej jakości; największy z formatów wideo, ale mniejszy niż GIF. Wymiary: podobne do GIF-a, ale z dodatkowym wypełnieniem, aby dopasować się do specyfikacji kontenera wideo, które zwykle są wielokrotnością 8 pikseli. Uwagi dotyczące użycia: używaj tego rozmiaru w przypadku podglądów MP4 i udostępniania na komputerze. Ten format jest obsługiwany w przypadku GIF-ów i naklejek.
loopedmp4	Rozdzielczość i rozmiar: format wideo o najwyższej jakości, większy niż MP4. Wymiary: podobne do GIF-a, ale z dodatkowym wypełnieniem, aby dopasować się do specyfikacji kontenera wideo, które zwykle są wielokrotnością 8 pikseli. Uwagi dotyczące użycia: użyj tego rozmiaru w przypadku udostępniania plików MP4, gdy chcesz, aby klip wideo był odtwarzany kilka razy, a nie tylko raz. Ten format jest obsługiwany w przypadku GIF-ów i naklejek.
tinymp4	Rozdzielczość i rozmiar: zmniejszony rozmiar formatu MP4. Wymiary: zmienna szerokość i wysokość, maksymalna ramka ograniczająca 320 x 320 pikseli Uwagi dotyczące użycia: używaj tego rozmiaru w przypadku podglądów i udostępniania plików MP4 na urządzeniach mobilnych. Ten format jest obsługiwany w przypadku GIF-ów i naklejek.
nanomp4	Rozdzielczość i rozmiar: najmniejszy rozmiar formatu MP4 Wymiary: zmienna szerokość i wysokość, maksymalna ramka ograniczająca 150 x 150 pikseli Uwagi dotyczące użycia: używaj tego rozmiaru w przypadku podglądów MP4 na urządzeniach mobilnych. Ten format jest obsługiwany w przypadku GIF-ów i naklejek.
webm	Rozdzielczość i rozmiar: format wideo o niższej jakości, mniejszy niż MP4. Wymiary: podobne do GIF-a, ale z dodatkowym wypełnieniem, aby dopasować się do specyfikacji kontenera wideo, które zwykle są wielokrotnością 8 pikseli. Uwagi dotyczące użycia: używaj tego rozmiaru w przypadku podglądów i udostępniania plików WebM na komputerach. Ten format jest obsługiwany w przypadku GIF-ów i naklejek.
tinywebm	Rozdzielczość i rozmiar: zmniejszony rozmiar formatu WebM Wymiary: zmienna szerokość i wysokość, maksymalna ramka ograniczająca 320 x 320 pikseli Uwagi dotyczące użycia: używaj tego rozmiaru w przypadku udostępniania GIF-ów na urządzeniach mobilnych. Ten format jest obsługiwany w przypadku GIF-ów i naklejek.
nanowebm	Rozdzielczość i rozmiar: najmniejszy rozmiar formatu WebM Wymiary: zmienna szerokość i wysokość, maksymalna ramka ograniczająca 150 x 150 pikseli Uwagi dotyczące użycia: używaj tego rozmiaru w przypadku podglądów GIF-ów na urządzeniach mobilnych. Ten format jest obsługiwany w przypadku GIF-ów i naklejek.
webp_transparent	Rozdzielczość i rozmiar: wysokiej jakości format naklejki WebP; największy dostępny rozmiar pliku. Wymiary: wymiary pierwotnego przesłanego pliku (bez ograniczeń). Uwagi dotyczące użycia: używaj tego rozmiaru do udostępniania naklejek użytkownikom z dużą przepustowością. Ten format jest obsługiwany w przypadku naklejek.
tinywebp_transparent	Rozdzielczość i rozmiar: zmniejszony rozmiar formatu naklejki WebP; maksymalny rozmiar 500 KB Wymiary: do 220 x 220 pikseli, wysokość skalowana w celu zachowania współczynnika proporcji. Uwagi dotyczące użycia: używaj tego rozmiaru w przypadku podglądów naklejek dla użytkowników o dużej przepustowości i udostępniania dla użytkowników o małej przepustowości. Ten format jest obsługiwany w przypadku naklejek.
nanowebp_transparent	Rozdzielczość i rozmiar: najmniejszy rozmiar formatu naklejki WebP; maksymalny rozmiar 100 KB Wymiary: do 90 x 90 pikseli, przy czym szerokość jest skalowana w celu zachowania współczynnika proporcji. Uwagi dotyczące użycia: używaj tego rozmiaru w przypadku podglądów naklejek dla użytkowników z wolnym połączeniem internetowym. Ten format jest obsługiwany w przypadku naklejek.
gif_transparent	Rozdzielczość i rozmiar: wysokiej jakości format naklejki GIF; największy dostępny rozmiar pliku Wymiary: wymiary pierwotnego przesłanego pliku (bez ograniczeń). Uwagi dotyczące użycia: używaj tego rozmiaru do udostępniania naklejek użytkownikom z dużą przepustowością. Ten format jest obsługiwany w przypadku naklejek.
tinygif_transparent	Rozdzielczość i rozmiar: zmniejszony rozmiar formatu naklejki GIF; maksymalny rozmiar 500 KB Wymiary: maksymalnie 220 x 220 pikseli, przy czym wysokość jest skalowana w celu zachowania współczynnika proporcji. Uwagi dotyczące użycia: używaj tego rozmiaru w przypadku podglądów naklejek dla użytkowników o dużej przepustowości i udostępniania dla użytkowników o małej przepustowości. Ten format jest obsługiwany w przypadku naklejek.
nanogif_transparent	Rozdzielczość i rozmiar: najmniejszy rozmiar formatu naklejki GIF; maksymalny rozmiar 100 KB Wymiary: do 90 x 90 pikseli, przy czym szerokość jest skalowana w celu zachowania współczynnika proporcji. Uwagi dotyczące użycia: używaj tego rozmiaru w przypadku podglądów naklejek dla użytkowników z wolnym połączeniem internetowym. Ten format jest obsługiwany w przypadku naklejek.

Sprawdzone metody

• W przypadku urządzeń mobilnych używaj plików w rozmiarze nano lub tiny do podglądu, a plików w rozmiarze tiny do udostępniania.
• Ustaw parametr media_filter na formaty, których chcesz używać. Może to zmniejszyć rozmiar odpowiedzi z interfejsu API o 70%.

Formatowanie rozmiarów

Rozmiar pliku każdego formatu treści zależy od wymiarów i długości wybranego pliku GIF. Dlatego wartości średnie i mediany podane w tabeli poniżej traktuj jako ogólne wskazówki, a nie dokładne wartości.

Format pliku	Średni rozmiar pliku (KB)	Mediana rozmiaru pliku (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

Kody odpowiedzi

W tej tabeli znajdziesz kody stanu odpowiedzi HTTP, które wskazują, że żądanie zostało zrealizowane:

Kod stanu HTTP
200 lub 202	OK lub zaakceptowano

Błędy

Interfejs API Tenora zwraca błędy z kodami odpowiedzi HTTP 4xx lub 5xx oraz w standardowym formacie błędów interfejsu API Google. Więcej informacji znajdziesz w sekcji Błędy.