Method: references.insert

Cria uma referência por meio de uma das seguintes maneiras:

  • Se sua solicitação estiver enviando um arquivo de referência, o YouTube criará a referência a partir do conteúdo fornecido. Você pode fornecer um arquivo de vídeo/áudio ou uma impressão digital pré-gerada. Se você estiver fornecendo uma impressão digital pré-gerada, defina a propriedade fpDirect do recurso reference como true no corpo da solicitação. Nesse fluxo, você pode usar os fluxos de upload multipart ou retomável para fornecer o conteúdo de referência.
  • Se você quiser criar uma referência usando um vídeo reivindicado como conteúdo de referência, use o parâmetro claimId para identificar a reivindicação.

Solicitação HTTP

  • URI de upload, para solicitações de upload de mídia:
    POST https://youtubepartner.googleapis.com/upload/youtube/partner/v1/references
  • URI de metadados, para solicitações somente de metadados:
    POST https://youtubepartner.googleapis.com/youtube/partner/v1/references

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de consulta

Parâmetros
claimId

string

O parâmetro claimId especifica o ID da reivindicação do YouTube de uma reivindicação existente para a qual uma referência precisa ser criada. O vídeo reivindicado é usado como conteúdo de referência.
onBehalfOfContentOwner

string

O parâmetro onBehalfOfContentOwner identifica o proprietário do conteúdo em nome de quem o usuário está agindo. Esse parâmetro é compatível com usuários que têm contas associadas a vários proprietários de conteúdo.

Corpo da solicitação

O corpo da solicitação contém uma instância de Reference.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Reference.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte OAuth 2.0 Overview.