커스텀 앱에서 Vimeo API를 사용하거나 동영상 섬네일의 URL을 캐싱하는 경우, 섬네일이 동영상 플레이어에 나타나지 않을 수 있습니다. 특히, 섬네일 URL이 앱이나 사이트에서 하드 코딩된 경우에도 이러한 문제가 발생할 수 있습니다. 이는 링크 구조가 자동으로 업데이트되지 않기 때문입니다.
이러한 사용 사례의 섬네일을 수정하려면 Vimeo 서버에서 동영상의 섬네일을 가져오는 API 호출을 시작해야 합니다. 동영상 섬네일 URL을 캐싱하는 대신 정기적으로 구현하는 것이 좋습니다. 또한 가능한 경우 이러한 호출을 일괄 처리하는 것이 더 효율적입니다.
Vimeo의 개발 사이트인 Vimeo 개발자: 특정 동영상 섬네일 가져오기에서 Vimeo API를 통해 섬네일 URL을 검색하는 방법에 대한 추가 도움말을 찾을 수 있습니다.
다음은 동영상 섬네일 URL을 검색하는 단계별 안내입니다.
-
- Vimeo 계정에 로그인하고 https://developer.vimeo.com으로 이동합니다.
-
앱이 아직 없는 경우, 새 앱을 클릭합니다.
- 앱에 이름과 설명을 지정합니다.
- No를 선택합니다.
- Creat app을 선택합니다.
-
앱 설정 페이지에서 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
'Vimeo API를 사용하여 동영상 섬네일 URL 검색하기' 동영상 튜토리얼을 시청하여 프로세스를 살펴보세요.