Agissant au nom d'un propriétaire de contenu

Dans le système de gestion des droits de YouTube, chaque objet est associé à un propriétaire de contenu. Un propriétaire de contenu est un partenaire YouTube qui dispose des droits sur une collection d'éléments. Lorsqu'une application utilise l'API YouTube Content ID, elle doit obtenir l'autorisation du propriétaire du contenu pour les éléments, les règles et les revendications créés ou manipulés. Il reçoit cette autorisation lorsque l'utilisateur authentifié de l'application a accès à un compte de propriétaire de contenu. Si l'utilisateur authentifié n'a pas accès à un compte de propriétaire de contenu, les appels à l'API Content ID échoueront.

Récupérer l'ID d'un propriétaire de contenu

Pour récupérer l'ID d'un propriétaire de contenu, appelez la méthode contentOwners.list de l'API YouTube Content ID. La réponse de l'API contient une liste de ressources contentOwner associées à l'utilisateur qui a autorisé la requête. Dans chaque ressource, la propriété id spécifie l'ID du propriétaire de contenu.

Pour obtenir un exemple de récupération programmatique de l'ID de propriétaire de contenu, consultez l'article Mettre en ligne et revendiquer une vidéo.

Appeler les API YouTube au nom d'un propriétaire de contenu

API YouTube Content ID

Étant donné que la plupart des utilisateurs ont accès à un seul compte de propriétaire de contenu, l'API Content ID peut déterminer implicitement le propriétaire du contenu en question. Par conséquent, le paramètre onBehalfOfContentOwner est facultatif pour les appels d'API Content ID.

Cependant, certains utilisateurs ont accès à plusieurs comptes de propriétaire de contenu. Pour ces utilisateurs, chaque requête API doit inclure le paramètre onBehalfOfContentOwner afin d'identifier explicitement le compte de propriétaire de contenu à utiliser.

API YouTube Data (v3)

De nombreuses méthodes de l'API YouTube Data sont également compatibles avec le paramètre onBehalfOfContentOwner. Les méthodes qui utilisent ce paramètre font appel à la délégation. Ainsi, une application peut effectuer des actions sur les chaînes gérées par le propriétaire de contenu, sur les vidéos de ces chaînes gérées ou sur d'autres ressources d'API.

Lorsque vous utilisez la délégation dans l'API YouTube Data, le paramètre onBehalfOfContentOwner est toujours obligatoire. La valeur de ce paramètre est un identifiant qui identifie de manière unique le propriétaire du contenu. Vous pouvez récupérer l'ID par programmation en appelant la méthode contentOwners.list de l'API YouTube Content ID.

Certains appels d'API nécessitent également un paramètre de délégation supplémentaire. La liste ci-dessous décrit deux exemples:

• La méthode videos.insert() nécessite que les paramètres onBehalfOfContentOwner et onBehalfOfContentOwnerChannel soient définis lorsque l'utilisateur effectue une action sur une chaîne en tant que propriétaire de contenu. La nouvelle vidéo est mise en ligne sur la chaîne spécifiée par le paramètre onBehalfOfContentOwnerChannel.
• La méthode search.list() nécessite de définir les paramètres onBehalfOfContentOwner et forContentOwner. Dans ce cas, le paramètre forContentOwner permet à l'utilisateur de demander à l'API de ne renvoyer que les ressources appartenant au propriétaire de contenu et spécifiées par le paramètre onBehalfOfContentOwner.

La documentation de chaque méthode spécifique indique quand elle est compatible avec la délégation et si vous devez définir un paramètre supplémentaire en plus de onBehalfOfContentOwner.

L'API YouTube Analytics

Pour récupérer un rapport sur le propriétaire de contenu à l'aide de l'API YouTube Analytics, définissez la valeur du paramètre ids dans votre requête API sur contentOwner==OWNER_ID, où OWNER_ID indique l'ID du propriétaire de contenu.