Method: references.insert

Crée une référence de l'une des manières suivantes :

  • Si votre requête met en ligne un fichier de référence, YouTube crée la référence à partir du contenu fourni. Vous pouvez fournir un fichier vidéo/audio ou une empreinte pré-générée. Si vous fournissez une empreinte pré-générée, définissez la propriété fpDirect de la ressource reference sur true dans le corps de la requête. Dans ce flux, vous pouvez utiliser le flux de mise en ligne en plusieurs parties ou le flux de mise en ligne pouvant être reprise pour fournir le contenu de référence.
  • Si vous souhaitez créer une référence à l'aide d'une vidéo revendiquée comme contenu de référence, utilisez le paramètre claimId pour identifier la revendication.

Requête HTTP

  • URI de mise en ligne pour les requêtes de mise en ligne de médias :
    POST https://youtubepartner.googleapis.com/upload/youtube/partner/v1/references
  • URI des métadonnées pour les requêtes ne contenant que des métadonnées :
    POST https://youtubepartner.googleapis.com/youtube/partner/v1/references

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
claimId

string

Le paramètre claimId spécifie l'ID de revendication YouTube d'une revendication existante à partir de laquelle une référence doit être créée. (La vidéo revendiquée est utilisée comme contenu de référence.)
onBehalfOfContentOwner

string

Le paramètre onBehalfOfContentOwner identifie le propriétaire du contenu au nom duquel l'utilisateur agit. Ce paramètre est compatible avec les utilisateurs dont les comptes sont associés à plusieurs propriétaires de contenu.

Corps de la requête

Le corps de la requête contient une instance de Reference.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Reference.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour plus d'informations, consultez la OAuth 2.0 Overview.