이 기능을 사용하려면 Standard, Advanced, Pro, Business, Premium 또는 Enterprise 요금제가 필요합니다.
귀하는 API를 사용하여 계정에서 동영상 파일에 대한 직접 링크 를 얻을 수 있습니다. 동영상 응답 개체에는 재생, 파일및 다운로드 를 비롯하여 이러한 파일에 액세스하기 위한 여러 필드가 포함될 수 있습니다. 이 문서에서는 이러한 필드가 무엇인지와 그 사용 방법을 설명합니다.
이 도움말에 포함된 내용:
시작하기 전에 알아야 할 사항
- 직접 동영상 파일 링크를 얻으려면 공개, 비공개 및 video_files 스코프가 포함된 인증 토큰을 사용하여 동영상의 엔드포인트로 요청을 보내야 합니다.
- 동영상 응답 에는 파일 및 다운로드 링크 필드가 포함됩니다.
- 이 모든 필드에 반환되는 링크는 당사 CDN 중 하나의 실제 동영상 파일 위치로 연결되는 HTTP 302 리디렉션입니다.
- 이러한 파일의 CDN 위치에는 수명 이 있으며 몇 시간마다 만료되므로 리디렉션 링크를 항상 정확히 사용해야 합니다.
- 업로드된 비디오(라이브 비디오 제외)의 HLS 파일은 영상이 최적화되고 트랜스코딩된 후에 다운로드할 수 있습니다.
'재생', '파일', 및 '다운로드' 필드를 이해하기
귀하가 동영상의 메타데이터를 요청할 때, 응답에는 동영상 파일에 접근하기 위한 세 가지의 개별 필드가 포함될 수 있습니다. 각각은 다른 목적을 가지고 있습니다.
-
재생: 이 링크는 재생에 최적화되어 있으며 24시간 후 만료되어 보안이 한층 강화됩니다.
- 타사 플레이어를 위해 플레이 필드를 사용하는 것을 권장합니다.
-
파일: 파일 필드에는 링크와 관련 메타데이터(예: 동영상의 크기 및 파일 크기)가 포함되어 있습니다. 이 링크들은 만료되지 않습니다.
- 이 링크는 만료되지 않으므로 타사 플레이어와 함께 사용을 권장하지 않습니다.
- 다운로드: 다운로드 필드에는 비디오 파일에 대한 만료 링크(24시간 동안 유효)와 각 링크의 만료 시간 및 관련 메타데이터가 포함되어 있습니다. 이 링크에는 웹 브라우저가 파일을 재생하는 대신 다운로드하도록 지시하는 헤더가 포함되어 있습니다.
다음 단계 제안
개발자 가이드에서 자세한 내용을 보려면 Vimeo API: 특정 비디오 가져오기, Vimeo API: 재생 응답, Vimeo API: 비디오 응답를 참조하십시오.