Method: references.insert

Tạo tệp đối chiếu theo một trong các cách sau:

  • Nếu yêu cầu của bạn đang tải tệp đối chiếu lên, YouTube sẽ tạo tệp đối chiếu từ nội dung mà bạn cung cấp. Bạn có thể cung cấp tệp video/âm thanh hoặc vân tay được tạo sẵn. Nếu bạn đang cung cấp vân tay số được tạo trước, hãy đặt thuộc tính fpDirect của tài nguyên reference thành true trong nội dung yêu cầu. Trong quy trình này, bạn có thể sử dụng quy trình tải lên nhiều phần hoặc resumable để cung cấp nội dung đối chiếu.
  • Nếu bạn muốn tạo tệp đối chiếu bằng một video đã được xác nhận quyền sở hữu làm nội dung đối chiếu, hãy dùng tham số claimId để xác định thông báo xác nhận quyền sở hữu.

Yêu cầu HTTP

  • URI tải lên, đối với các yêu cầu tải nội dung nghe nhìn lên:
    POST https://youtubepartner.googleapis.com/upload/youtube/partner/v1/references
  • URI siêu dữ liệu, đối với các yêu cầu chỉ siêu dữ liệu:
    POST https://youtubepartner.googleapis.com/youtube/partner/v1/references

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số truy vấn

Các tham số
claimId

string

Tham số claimId chỉ định mã xác nhận quyền sở hữu trên YouTube của một thông báo xác nhận quyền sở hữu hiện có để tạo tệp đối chiếu. (Video đã được xác nhận quyền sở hữu sẽ được dùng làm nội dung đối chiếu.)
onBehalfOfContentOwner

string

Tham số onBehalfOfContentOwner xác định chủ sở hữu nội dung mà người dùng đang đại diện. Thông số này hỗ trợ người dùng có tài khoản được liên kết với nhiều chủ sở hữu nội dung.

Nội dung yêu cầu

Nội dung yêu cầu chứa một bản sao của Reference.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của Reference.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.