Uwaga: interfejs YouTube Content ID API jest przeznaczony dla dostawców treści w YouTube i nie jest dostępny dla wszystkich deweloperów ani użytkowników YouTube. Jeśli nie widzisz interfejsu YouTube Content ID API na liście usług wymienionych w Konsoli interfejsów API Google, odwiedź Centrum pomocy YouTube, aby dowiedzieć się więcej o programie partnerskim YouTube.
Każdy obiekt w systemie zarządzania prawami YouTube jest powiązany z właścicielem treści. Właściciel treści to partner YouTube, który ma prawa do zbioru zasobów. Jeśli aplikacja korzysta z interfejsu YouTube Content ID API, musi mieć zgodę właściciela treści na wykorzystanie zasobów, zasad i roszczeń, które tworzy lub zmanipuluje. Otrzymuje tę autoryzację, gdy uwierzytelniony użytkownik aplikacji ma dostęp do konta właściciela treści. Jeśli uwierzytelniony użytkownik nie ma dostępu do konta właściciela treści, wywołania interfejsu Content ID API kończą się niepowodzeniem.
Pobieranie identyfikatora właściciela treści
Aby pobrać identyfikator właściciela treści, wywołaj metodę contentOwners.list interfejsu YouTube Content ID API. Odpowiedź interfejsu API zawiera listę zasobów contentOwner powiązanych z użytkownikiem, który autoryzował żądanie. W każdym zasobie właściwość id określa identyfikator właściciela treści.
Przykład pobierania identyfikatora właściciela treści w sposób zautomatyzowany znajdziesz w artykule Przesyłanie filmów i zgłaszanie do nich praw.
Wywoływanie interfejsów API YouTube w imieniu właściciela treści
YouTube Content ID API
Większość użytkowników ma dostęp do jednego konta właściciela treści, dlatego interfejs Content ID API może pośrednio określić właściciela treści, którego używa dany użytkownik. Dlatego w przypadku wywołań interfejsu Content ID API parametr onBehalfOfContentOwner jest opcjonalny.
Niektórzy użytkownicy mają jednak dostęp do wielu kont właścicieli treści. W przypadku tych użytkowników każde żądanie do interfejsu API musi zawierać parametr onBehalfOfContentOwner umożliwiający jednoznaczne określenie, którego konta właściciela treści należy użyć.
YouTube Data API (v3)
Wiele metod interfejsu YouTube Data API obsługuje też parametr onBehalfOfContentOwner. W metodach korzystających z tego parametru jest stosowane przekazywanie, które umożliwia aplikacji wykonywanie działań na kanałach zarządzanych przez właściciela treści, w przypadku filmów na tych zarządzanych kanałach lub innych zasobach API.
Jeśli w interfejsie YouTube Data API używasz przekazywania dostępu, parametr onBehalfOfContentOwner jest zawsze wymagany. Jego wartością jest unikalny identyfikator właściciela treści. Możesz pobrać identyfikator automatycznie, wywołując metodę contentOwners.list interfejsu YouTube Content ID API.
Niektóre wywołania interfejsu API wymagają też dodatkowego parametru przekazywania dostępu. Oto 2 przykłady:
- Metoda
videos.insert()wymaga ustawiania parametrówonBehalfOfContentOwnerionBehalfOfContentOwnerChannel, gdy użytkownik wykonuje działanie na kanale jako właściciel treści. Nowy film zostanie przesłany na kanał określony w parametrzeonBehalfOfContentOwnerChannel. - Metoda
search.list()wymaga ustawienia parametrówonBehalfOfContentOwneriforContentOwner. W tym przypadku parametrforContentOwnerpozwala użytkownikowi nakazać interfejsowi API zwracanie tylko zasobów należących do właściciela treści określonych w parametrzeonBehalfOfContentOwner.
Dokumentacja poszczególnych metod, które obsługują przekazywanie dostępu i czy musisz ustawić dodatkowy parametr poza onBehalfOfContentOwner.
YouTube Analytics API
Aby pobrać raport właściciela treści za pomocą interfejsu API YouTube Analytics, ustaw wartość parametru ids w żądaniu do interfejsu API na contentOwner==OWNER_ID, gdzie OWNER_ID określa identyfikator właściciela treści.