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