Method: references.insert

다음 방법 중 하나로 참조를 만듭니다.

  • 요청이 참조 파일을 업로드하는 경우 YouTube는 제공된 콘텐츠를 사용하여 참조를 만듭니다. 동영상/오디오 파일 또는 사전 생성된 지문을 제공할 수 있습니다. 사전 생성된 디지털 지문을 제공하는 경우, 요청 본문에서 reference 리소스의 fpDirect 속성을 true로 설정합니다. 이 절차에서는 여러 부분 또는 resumable 업로드 흐름을 사용하여 참조 콘텐츠를 제공할 수 있습니다.
  • 소유권 주장이 제기된 동영상을 참조 콘텐츠로 사용하여 참조를 만들려면 claimId 매개변수를 사용하여 소유권 주장을 식별합니다.

HTTP 요청

  • 미디어 업로드 요청의 업로드 URI:
    POST https://youtubepartner.googleapis.com/upload/youtube/partner/v1/references
  • 메타데이터 전용 요청용 메타데이터 URI:
    POST https://youtubepartner.googleapis.com/youtube/partner/v1/references

URL은 gRPC 트랜스코딩 구문을 사용합니다.

쿼리 매개변수

매개변수
claimId

string

claimId 매개변수는 참조를 만들어야 하는 기존 소유권 주장의 YouTube 소유권 주장 ID를 지정합니다. (소유권 주장이 제기된 동영상은 참조 콘텐츠로 사용됨)
onBehalfOfContentOwner

string

onBehalfOfContentOwner 매개변수는 사용자가 대리하는 콘텐츠 소유자를 식별합니다. 이 매개변수는 계정이 여러 콘텐츠 소유자와 연결된 사용자를 지원합니다.

요청 본문

요청 본문에는 Reference의 인스턴스가 포함됩니다.

응답 본문

성공한 경우 응답 본문에 Reference의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/youtubepartner

자세한 내용은 OAuth 2.0 개요를 참고하세요.