Method: references.insert

Crea un riferimento in uno dei seguenti modi:

  • Se la tua richiesta riguarda il caricamento di un file di riferimento, YouTube crea il riferimento dai contenuti forniti. Puoi fornire un file video/audio o un'impronta pregenerata. Se fornisci un'impronta pregenerata, imposta la proprietà fpDirect della risorsa reference su true nel corpo della richiesta. In questo flusso, puoi utilizzare i flussi di caricamento multipart o resumable per fornire i contenuti di riferimento.
  • Se vuoi creare un riferimento utilizzando un video rivendicato come contenuto di riferimento, utilizza il parametro claimId per identificare la rivendicazione.

Richiesta HTTP

  • URI di caricamento, per le richieste di caricamento di contenuti multimediali:
    POST https://youtubepartner.googleapis.com/upload/youtube/partner/v1/references
  • URI metadati, per richieste di soli metadati:
    POST https://youtubepartner.googleapis.com/youtube/partner/v1/references

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di ricerca

Parametri
claimId

string

Il parametro claimId specifica l'ID rivendicazione di YouTube di una rivendicazione esistente da cui deve essere creato un riferimento. Il video rivendicato viene utilizzato come contenuto di riferimento.
onBehalfOfContentOwner

string

Il parametro onBehalfOfContentOwner identifica il proprietario dei contenuti per conto del quale l'utente agisce. Questo parametro supporta gli utenti i cui account sono associati a più proprietari di contenuti.

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di Reference.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Reference.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.