Method: references.insert

Crea un riferimento in uno dei seguenti modi:

  • Se la richiesta prevede il caricamento di un file di riferimento, YouTube crea il riferimento dai contenuti forniti. Puoi fornire un file video/audio o un'impronta digitale pregenerata. Se fornisci un'impronta digitale pregenerata, imposta la proprietà fpDirect della risorsa reference su true nel corpo della richiesta. In questo flusso, puoi utilizzare i flussi di caricamento in più parti o ripristinabile per fornire i contenuti di riferimento.
  • Se vuoi creare un riferimento utilizzando un video rivendicato come contenuti 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 dei metadati, per le richieste solo con 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 della rivendicazione di YouTube di una rivendicazione esistente da cui deve essere creato un riferimento. (Il video rivendicato viene utilizzato come contenuti di riferimento.)

onBehalfOfContentOwner

string

Il parametro onBehalfOfContentOwner identifica il proprietario dei contenuti per conto del quale agisce l'utente. Questo parametro supporta gli utenti i cui account sono associati a più proprietari dei 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 saperne di più, consulta la OAuth 2.0 Overview.