Tenor의 V1 API를 사용하는 기존 통합의 경우 이 페이지의 단계에 따라 V2로 이전하세요.
V2 API 키 가져오기
빠른 시작 가이드의 설정 단계에 따라 V1 버전을 대체할 V2 API 키를 가져옵니다.
V2 도메인으로 업데이트
API 도메인을 https://tenor.googleapis.com/v2/로 업데이트합니다. Tenor의 V2 API는 HTTPS 연결만 지원합니다. 콘텐츠의 경우 애플리케이션이 https://media.tenor.com 및 https://c.tenor.com에서 콘텐츠 다운로드를 지원해야 합니다.
예를 들어 다음 V1 도메인 중 하나에 API 호출을 했다고 가정해 보겠습니다.
https://api.tenor.com/v1/search?<parameters>https://g.tenor.com/v1/search?<parameters>
V2 호출을 업데이트하려면 https://tenor.googleapis.com/v2/search?<parameters>로 변경합니다.
엔드포인트 변경사항
대부분의 API 엔드포인트 매개변수는 V1에 문서화된 내용과 동일합니다. 몇 가지 주목할 만한 예외가 있습니다.
- 이제 Tenor의 검색 엔드포인트는
searchfilter매개변수를 통해 스티커 검색을 지원합니다. - API 호출에
client_key및country매개변수를 포함합니다. - 이제
media_filter매개변수는 미리 설정된 열거형이 아닌 원하는 형식의 쉼표로 구분된 목록을 사용합니다. - 이제 카테고리 엔드포인트에서
type매개변수에featured및trending를 지원합니다. - API에서 더 이상
anon_id매개변수를 지원하지 않습니다. - 요청할 결과 페이지가 더 이상 없는 경우 API 응답의
next필드가 이제"0"이 아닌 빈 문자열입니다.
사용 가능한 엔드포인트가 다음과 같이 변경되었습니다.
- 트렌드 엔드포인트는 더 이상 지원되지 않습니다. 대신 추천 엔드포인트를 사용하는 것이 좋습니다.
- GIF 엔드포인트의 이름이 게시물 엔드포인트로 변경되었습니다.
- 무작위 GIF 엔드포인트는
random매개변수를 통해 검색 엔드포인트에 통합되었습니다.
응답 객체 및 오류 변경사항
- GIF 객체의 브랜드가 응답 객체로 변경되었습니다.
- 응답 객체에서
media필드가media_formats로 리브랜딩되었습니다.media_formats값이 이제 지도 배열이 아닌{ CONTENT_FORMAT : MEDIA_OBJECT }지도입니다. - 콘텐츠 썸네일 미리보기가 각 콘텐츠 형식의 미디어 객체에서 자체 형식으로 이동되었습니다. 응답 객체의
media_formats필드에 제공됩니다. - 응답 객체에 더 이상 결과가 없으면
next필드는"0"이 아닌 빈 문자열""입니다. - Tenor API 오류 코드가 Google의 표준 API 오류 코드로 이전되었습니다.