Method: references.insert

Crea una referencia de una de las siguientes formas:

  • Si tu solicitud implica subir un archivo de referencia, YouTube crea la referencia a partir del contenido proporcionado. Puedes proporcionar un archivo de audio o video, o bien una huella digital generada previamente. Si proporcionas una huella digital generada previamente, establece la propiedad fpDirect del recurso reference en true en el cuerpo de la solicitud. En este flujo, puedes usar los flujos de carga multipart o reanudable para proporcionar el contenido de referencia.
  • Si quieres crear una referencia con un video reclamado como contenido de referencia, usa el parámetro claimId para identificar el reclamo.

Solicitud HTTP

  • URI de carga para las solicitudes de carga de medios:
    POST https://youtubepartner.googleapis.com/upload/youtube/partner/v1/references
  • URI de metadatos para las solicitudes de metadatos únicamente:
    POST https://youtubepartner.googleapis.com/youtube/partner/v1/references

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de consulta

Parámetros
claimId

string

El parámetro claimId especifica el ID de reclamo de YouTube de un reclamo existente a partir del cual se debe crear una referencia. (El video reclamado se usa como contenido de referencia).
onBehalfOfContentOwner

string

El parámetro onBehalfOfContentOwner identifica al propietario del contenido en cuyo nombre actúa el usuario. Este parámetro admite usuarios cuyas cuentas están asociadas con varios propietarios de contenido.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de Reference.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Reference.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta OAuth 2.0 Overview.