Jak przeprowadzić migrację z interfejsu Tenor API w wersji 1

W przypadku dotychczasowych integracji, które korzystają z interfejsu Tenor API w wersji 1, wykonaj czynności opisane na tej stronie, aby przejść na wersję 2.

Uzyskiwanie klucza interfejsu API w wersji 2

Postępuj zgodnie z instrukcjami w kroku konfiguracji krótkiego przewodnika, aby uzyskać klucz interfejsu API w wersji 2 i zastąpić nim klucz w wersji 1.

Aktualizacja domen do wersji 2

Zaktualizuj domenę interfejsu API na https://tenor.googleapis.com/v2/. Interfejs API V2 Tenora obsługuje tylko połączenia HTTPS. W przypadku treści upewnij się, że aplikacja obsługuje pobieranie treści z https://media.tenor.com i https://c.tenor.com.

Załóżmy na przykład, że wywołasz interfejs API w jednej z tych domen V1:

• https://api.tenor.com/v1/search?<parameters>
• https://g.tenor.com/v1/search?<parameters>

Aby zaktualizować wywołania do wersji 2, zmień je na https://tenor.googleapis.com/v2/search?<parameters>.

Zmiany punktów końcowych

Większość parametrów punktów końcowych interfejsu API nie zmieniła się w porównaniu z dokumentacją interfejsu API w wersji 1. Istnieje kilka ważnych wyjątków:

1. Punkt końcowy wyszukiwania Tenora obsługuje teraz wyszukiwanie naklejek za pomocą parametru searchfilter.
2. W wywołaniach interfejsu API uwzględnij parametry client_key i country.
3. Parametr media_filter przyjmuje teraz rozdzieloną przecinkami listę żądanych formatów zamiast wstępnie zdefiniowanych wyliczeń.
4. Punkt końcowy Categories obsługuje teraz wartości featured i trending parametru type.
5. Interfejs API nie obsługuje już parametru anon_id.
6. Gdy nie ma już więcej stron z wynikami do przesłania, pole next w odpowiedziach interfejsu API jest teraz pustym ciągiem znaków, a nie "0".

Wprowadziliśmy te zmiany w dostępnych punktach końcowych:

1. Punkt końcowy Trending nie jest już obsługiwany. Zamiast tego zalecamy używanie wyróżnionego punktu końcowego.
2. Punkt końcowy GIF został przekształcony w punkt końcowy Posty.
3. Punkt końcowy losowego GIF-a został włączony do punktu końcowego wyszukiwania za pomocą parametru random.

Zmiany w obiektach odpowiedzi i błędach

• Obiekt GIF został przekształcony w obiekt odpowiedzi.
• W obiekcie odpowiedzi pole media zostało zmienione na media_formats. Wartość media_formats jest teraz mapą { CONTENT_FORMAT : MEDIA_OBJECT }, a nie tablicą map.
• Podglądy miniatur treści zostały przeniesione z obiektu multimedialnego dla każdego formatu treści do osobnego formatu. Są one dostępne w polu media_formats w obiekcie odpowiedzi.
• Gdy w obiekcie odpowiedzi nie ma już wyników, pole next jest pustym ciągiem znaków "", a nie "0".
• Kody błędów interfejsu Tenor API zostały przeniesione do standardowych kodów błędów interfejsu API Google.