Method: references.insert

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

  • Si votre demande concerne la mise en ligne d'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 digitale générée à l'avance. 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 d'importation en plusieurs parties ou resumable pour fournir le contenu de référence.
  • Si vous souhaitez créer une référence en utilisant une vidéo revendiquée comme contenu de référence, utilisez le paramètre claimId pour identifier la revendication.

Requête HTTP

  • URI d'importation, pour les requêtes d'importation de médias:
    POST https://youtubepartner.googleapis.com/upload/youtube/partner/v1/references
  • URI de 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 indique 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 accepte 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 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 en savoir plus, consultez la présentation d'OAuth 2.0.