[외부 API 연동] Tenor API로 관련된 gif 이미지 불러오기

https://developers.google.com/tenor/guides/quickstart?hl=ko

빠른 시작 | Tenor | Google for Developers

Tenor API는 Tenor GIF 검색을 애플리케이션에 통합하는 데 필요한 도구를 제공합니다.

developers.google.com

위의 가이드에 따라, Google Login 후, Project 생성 후 빠르게 API 활성화 및 Key 복사까지 가능하다.

Key 제한을 위해 API Console에서 웹사이트 제한이 필요하다.(API Console)
localhost:5500과 도메인을 등록해주자.

API 제한을 설정하고 "Tenor API"를 설정해주자.

Tenor API: GIF 검색과 통합을 위한 완벽 가이드

Tenor API는 애플리케이션이나 웹 서비스에 GIF 검색 및 공유 기능을 손쉽게 통합할 수 있도록 지원하는 강력한 도구입니다. 이 가이드는 Tenor API를 시작하는 데 필요한 모든 단계를 상세히 안내합니다.

1. Tenor API 키 발급받기

Tenor API를 사용하려면 먼저 Google Cloud Platform (GCP)을 통해 API 키를 발급받아야 합니다.

절차:

Google Cloud Console 접속: Google Cloud Console에 접속하여 로그인합니다.
프로젝트 선택 또는 생성: 기존 프로젝트를 선택하거나 새 프로젝트를 생성합니다.
API 및 서비스 활성화:
- 왼쪽 상단의 탐색 메뉴에서 'API 및 서비스' > '라이브러리'로 이동합니다.
- 검색창에 "Tenor API"를 입력하고 검색 결과에서 'Tenor API'를 선택합니다.
- '사용' 버튼을 클릭하여 API를 활성화합니다.
API 키 생성:
- 'API 및 서비스' > '사용자 인증 정보'로 이동합니다.
- 상단의 '+ 사용자 인증 정보 만들기'를 클릭하고 'API 키'를 선택합니다.
- 생성된 API 키를 복사하여 안전한 곳에 보관합니다. 이 키는 API 요청 시 본인을 인증하는 데 사용됩니다.

2. 주요 API 엔드포인트

Tenor API v2는 다양한 기능을 제공하는 여러 엔드포인트를 지원합니다. 주요 엔드포인트는 다음과 같습니다.

엔드포인트	설명
/v2/search	특정 키워드로 GIF를 검색합니다.
/v2/featured	현재 인기 있는(추천) GIF 목록을 가져옵니다. (v1의 trending 대체)
/v2/categories	'happy', 'sad' 등과 같은 GIF 카테고리 목록을 가져옵니다.
/v2/posts	특정 GIF ID에 대한 상세 정보를 가져옵니다. (v1의 gif 대체)
/v2/autocomplete	사용자가 입력하는 검색어에 대한 추천 검색어를 제공합니다.
/v2/registershare	사용자가 GIF를 공유했을 때 이를 등록하여 검색 결과 개선에 도움을 줍니다.

Sheets로 내보내기

기본 URL: 모든 API 요청의 기본 URL은 https://tenor.googleapis.com 입니다.

3. API 요청 보내기: 검색 예제

가장 일반적으로 사용되는 search 엔드포인트를 예로 들어 API 요청 방법을 알아보겠습니다. "excited"라는 키워드로 GIF를 검색하는 예제입니다.

요청 URL:

https://tenor.googleapis.com/v2/search?q=excited&key=YOUR_API_KEY&limit=8

주요 파라미터:

key: 발급받은 API 키를 입력합니다.
q: 검색할 키워드를 입력합니다.
limit: 받아올 GIF의 최대 개수를 지정합니다. (기본값: 20, 최대값: 50)
pos: 다음 페이지의 결과를 가져오기 위한 위치 값입니다. 이전 응답의 next 값으로 설정합니다.
contentfilter: 콘텐츠 등급을 설정합니다. (off, low, medium, high 중 선택 가능)
media_filter: 받아올 미디어 포맷을 지정합니다. (gif, tinygif, mp4 등)

응답 (Response):

요청이 성공하면 JSON 형식의 응답을 받게 됩니다. 응답에는 results 배열이 포함되며, 각 요소는 개별 GIF에 대한 정보를 담고 있습니다.

JSON

{
  "results": [
    {
      "id": "8776030",
      "title": "Happy Dance GIF",
      "media_formats": {
        "gif": {
          "url": "https://media.tenor.com/...",
          "dims": [498, 498],
          "size": 123456
        },
        "tinygif": {
          "url": "https://media.tenor.com/...",
          "dims": [220, 220],
          "size": 45678
        }
      },
      "created": 1501018987.123456,
      ...
    }
  ],
  "next": "10"
}

results: GIF 정보 객체의 배열입니다.
id: 각 GIF의 고유 ID입니다.
media_formats: 다양한 크기와 포맷의 미디어 파일 URL을 포함합니다. 일반적으로 미리보기에는 tinygif을, 실제 공유 시에는 gif나 mp4를 사용합니다.
next: 다음 페이지의 결과를 요청할 때 pos 파라미터에 사용할 값입니다.

4. 중요 고려사항

콘텐츠 필터링 (contentfilter): 애플리케이션의 사용자 연령대에 맞게 적절한 콘텐츠 등급을 설정하는 것이 매우 중요합니다.
미리보기와 원본 사용: 사용자 경험과 데이터 사용량을 최적화하기 위해, 초기 목록에는 tinygif과 같은 작은 크기의 파일을 로드하고, 사용자가 선택하여 공유할 때 gif나 mp4와 같은 고화질 버전을 로드하는 것을 권장합니다.
결과 페이지 처리 (pos & next): 한 번에 모든 결과를 가져오는 대신, limit과 pos 파라미터를 사용하여 필요한 만큼의 결과만 요청하고 사용자가 스크롤할 때 추가 결과를 로드하는 '무한 스크롤' 방식을 구현하는 것이 효율적입니다.
저작권 및 표시: Tenor API를 통해 제공되는 콘텐츠를 사용할 때는 Tenor의 서비스 약관 및 저작권 정책을 준수해야 합니다.

이 가이드를 통해 Tenor API를 성공적으로 연동하여 사용자에게 풍부한 GIF 경험을 제공해 보시기 바랍니다. 더 자세한 정보는 Tenor API 공식 문서에서 확인하실 수 있습니다.

Tenor API: GIF 검색과 통합을 위한 완벽 가이드

1. Tenor API 키 발급받기

Tenor API를 사용하려면 먼저 Google Cloud Platform (GCP)을 통해 API 키를 발급받아야 합니다.

절차:

Google Cloud Console 접속: Google Cloud Console에 접속하여 로그인합니다.
프로젝트 선택 또는 생성: 기존 프로젝트를 선택하거나 새 프로젝트를 생성합니다.
API 및 서비스 활성화:
- 왼쪽 상단의 탐색 메뉴에서 'API 및 서비스' > '라이브러리'로 이동합니다.
- 검색창에 "Tenor API"를 입력하고 검색 결과에서 'Tenor API'를 선택합니다.
- '사용' 버튼을 클릭하여 API를 활성화합니다.
API 키 생성:
- 'API 및 서비스' > '사용자 인증 정보'로 이동합니다.
- 상단의 '+ 사용자 인증 정보 만들기'를 클릭하고 'API 키'를 선택합니다.
- 생성된 API 키를 복사하여 안전한 곳에 보관합니다. 이 키는 API 요청 시 본인을 인증하는 데 사용됩니다.

2. 주요 API 엔드포인트

Tenor API v2는 다양한 기능을 제공하는 여러 엔드포인트를 지원합니다. 주요 엔드포인트는 다음과 같습니다.

엔드포인트	설명
/v2/search	특정 키워드로 GIF를 검색합니다.
/v2/featured	현재 인기 있는(추천) GIF 목록을 가져옵니다. (v1의 trending 대체)
/v2/categories	'happy', 'sad' 등과 같은 GIF 카테고리 목록을 가져옵니다.
/v2/posts	특정 GIF ID에 대한 상세 정보를 가져옵니다. (v1의 gif 대체)
/v2/autocomplete	사용자가 입력하는 검색어에 대한 추천 검색어를 제공합니다.
/v2/registershare	사용자가 GIF를 공유했을 때 이를 등록하여 검색 결과 개선에 도움을 줍니다.

Sheets로 내보내기

기본 URL: 모든 API 요청의 기본 URL은 https://tenor.googleapis.com 입니다.

3. API 요청 보내기: 검색 예제

가장 일반적으로 사용되는 search 엔드포인트를 예로 들어 API 요청 방법을 알아보겠습니다. "excited"라는 키워드로 GIF를 검색하는 예제입니다.

요청 URL:

https://tenor.googleapis.com/v2/search?q=excited&key=YOUR_API_KEY&limit=8

주요 파라미터:

key: 발급받은 API 키를 입력합니다.
q: 검색할 키워드를 입력합니다.
limit: 받아올 GIF의 최대 개수를 지정합니다. (기본값: 20, 최대값: 50)
pos: 다음 페이지의 결과를 가져오기 위한 위치 값입니다. 이전 응답의 next 값으로 설정합니다.
contentfilter: 콘텐츠 등급을 설정합니다. (off, low, medium, high 중 선택 가능)
media_filter: 받아올 미디어 포맷을 지정합니다. (gif, tinygif, mp4 등)

응답 (Response):

요청이 성공하면 JSON 형식의 응답을 받게 됩니다. 응답에는 results 배열이 포함되며, 각 요소는 개별 GIF에 대한 정보를 담고 있습니다.

JSON

{
  "results": [
    {
      "id": "8776030",
      "title": "Happy Dance GIF",
      "media_formats": {
        "gif": {
          "url": "https://media.tenor.com/...",
          "dims": [498, 498],
          "size": 123456
        },
        "tinygif": {
          "url": "https://media.tenor.com/...",
          "dims": [220, 220],
          "size": 45678
        }
      },
      "created": 1501018987.123456,
      ...
    }
  ],
  "next": "10"
}

results: GIF 정보 객체의 배열입니다.
id: 각 GIF의 고유 ID입니다.
media_formats: 다양한 크기와 포맷의 미디어 파일 URL을 포함합니다. 일반적으로 미리보기에는 tinygif을, 실제 공유 시에는 gif나 mp4를 사용합니다.
next: 다음 페이지의 결과를 요청할 때 pos 파라미터에 사용할 값입니다.

4. 중요 고려사항

콘텐츠 필터링 (contentfilter): 애플리케이션의 사용자 연령대에 맞게 적절한 콘텐츠 등급을 설정하는 것이 매우 중요합니다.
미리보기와 원본 사용: 사용자 경험과 데이터 사용량을 최적화하기 위해, 초기 목록에는 tinygif과 같은 작은 크기의 파일을 로드하고, 사용자가 선택하여 공유할 때 gif나 mp4와 같은 고화질 버전을 로드하는 것을 권장합니다.
결과 페이지 처리 (pos & next): 한 번에 모든 결과를 가져오는 대신, limit과 pos 파라미터를 사용하여 필요한 만큼의 결과만 요청하고 사용자가 스크롤할 때 추가 결과를 로드하는 '무한 스크롤' 방식을 구현하는 것이 효율적입니다.

저작자표시 (새창열림)

'웹 개발 > 외부 API 연동' 카테고리의 다른 글

[외부 API 연동] TossPayments를 통한 원화 결제 연동하기 (2)	2025.08.06
[외부 API 연동] Adsense 연동으로, 수익화하기 (2)	2025.08.04
[외부 API 연동] 카카오 API 연동해서 Map 정보 조회하기 (0)	2025.08.04

[외부 API 연동] Tenor API로 관련된 gif 이미지 불러오기

Tenor API: GIF 검색과 통합을 위한 완벽 가이드

1. Tenor API 키 발급받기

2. 주요 API 엔드포인트

3. API 요청 보내기: 검색 예제

4. 중요 고려사항

Tenor API: GIF 검색과 통합을 위한 완벽 가이드

1. Tenor API 키 발급받기

2. 주요 API 엔드포인트

3. API 요청 보내기: 검색 예제

4. 중요 고려사항

'웹 개발 > 외부 API 연동' 카테고리의 다른 글

전체 카테고리

태그

전체 방문자

블로그 인기글

티스토리툴바

Tenor API: GIF 검색과 통합을 위한 완벽 가이드

1. Tenor API 키 발급받기

2. 주요 API 엔드포인트

3. API 요청 보내기: 검색 예제

4. 중요 고려사항

Tenor API: GIF 검색과 통합을 위한 완벽 가이드

1. Tenor API 키 발급받기

2. 주요 API 엔드포인트

3. API 요청 보내기: 검색 예제

4. 중요 고려사항

'웹 개발 > 외부 API 연동' 카테고리의 다른 글

전체 카테고리

최근 글

최근댓글

태그

전체 방문자

블로그 인기글

티스토리툴바