커스텀 앱에서 Vimeo API를 사용하거나 동영상 섬네일의 URL을 캐싱하는 경우, 섬네일이 동영상 플레이어에 나타나지 않을 수 있습니다. 특히, 섬네일 URL이 앱이나 사이트에서 하드 코딩된 경우에도 이러한 문제가 발생할 수 있습니다. 이는 링크 구조가 자동으로 업데이트되지 않기 때문입니다.
이러한 사용 사례에서 섬네일을 수정하려면 Vimeo 서버에서 동영상의 섬네일을 가져오는 API 호출을 시작해야 합니다. 동영상 섬네일 URL을 캐싱하는 대신 이 작업을 정기적으로 시행하는 것이 좋습니다. 가능하다면, 이러한 호출을 일괄 처리하면 더 효율적입니다.
Vimeo의 개발 사이트 여기에서 Vimeo API를 통해 섬네일 URL을 검색하는 방법에 대한 추가 도움말을 찾을 수 있습니다.
다음은 동영상 섬네일 URL 검색에 대한 단계별 가이드입니다.
-
- Vimeo 계정에 로그인하고 https://developer.vimeo.com으로 이동합니다.
-
앱이 아직 없는 경우, 새 앱을 클릭합니다.
- 앱에 이름과 설명을 지정하고 아니요를 선택한 다음 앱 만들기를 선택합니다.
-
앱 설정 페이지에서 API 호출을 인증하기 위해 액세스 토큰을 생성해야 합니다.
- Authentication > General에서 Authenticated를 선택합니다.
- Scope에서 Private을 선택합니다.
- Generate을 클릭합니다.
- 생성된 토큰을 복사하여 텍스트 편집기에 저장합니다. 이후 단계에서 필요합니다.
-
API 클라이언트 애플리케이션(예: Postman)에서 'GET' 요청을 하고 다음 URL을 입력합니다.
- https://api.vimeo.com/me/videos
- 토큰이 인증에 필요하므로 GET 요청( https://developer.vimeo.com/api/authentication)의 헤더에 토큰이 포함되어 있는지 확인하세요. Postman을 사용하는 경우, Authorization 탭으로 이동한 다음 Type 드롭다운에서 'Bearer token'을 선택하고 토큰을 토큰 텍스트 필드에 붙여넣습니다.
- 요청을 보냅니다.
-
페이로드에는 동영상에 대한 많은 정보가 포함됩니다. Vimeo의 개발자 페이지에 나열된 추가 매개변수를 사용하여 필요한 결과를 지정할 수 있습니다.
-
예: https://api.vimeo.com/me/videos?fields=uri,name,pictures&per_page=100&page=1
- 여기에는 동영상 ID, 동영상 제목, 섬네일 URL이 포함되며 첫 100개의 동영상이 포함됩니다.
- 섬네일 URL은 각 동영상의 '사진' 아래에 나열됩니다.
-
예: https://api.vimeo.com/me/videos?fields=uri,name,pictures&per_page=100&page=1
다음은 이 프로세스를 진행하는 엔지니어 중 한 명이 제공한 동영상 튜토리얼입니다.