Zasób playlistItem
określa inny zasób, taki jak film, który znajduje się na playliście. Dodatkowo zasób playlistItem
zawiera szczegółowe informacje o dołączeniu zasobu, który odnosi się do sposobu wykorzystania tego zasobu na tej playliście.
YouTube używa też playlisty do wskazywania listy filmów na kanale, przy czym każdy symbol playlistItem
na tej liście reprezentuje 1 film. Identyfikator playlisty tej listy możesz pobrać z channel resource
konkretnego kanału. Następnie możesz użyć metody playlistItems.list
na liście.
Metody
Interfejs API obsługuje następujące metody w przypadku zasobów playlistItems
:
- list
- Zwraca kolekcję elementów playlisty pasujących do parametrów żądania do interfejsu API. Możesz pobrać wszystkie elementy playlisty z tej playlisty lub jej elementy według unikalnych identyfikatorów. Wypróbuj teraz
- wstaw
- Dodaje zasób do playlisty. Wypróbuj teraz
- zaktualizuj
- Modyfikuje element playlisty. Możesz na przykład zaktualizować pozycję elementu na playliście. Wypróbuj teraz
- usuń
- Usuwa element playlisty. Wypróbuj teraz
Reprezentowanie zasobów
Poniższa struktura JSON pokazuje format zasobu playlistItems
:
{ "kind": "youtube#playlistItem", "etag": etag, "id": string, "snippet": { "publishedAt": datetime, "channelId": string, "title": string, "description": string, "thumbnails": { (key): { "url": string, "width": unsigned integer, "height": unsigned integer } }, "channelTitle": string, "videoOwnerChannelTitle": string, "videoOwnerChannelId": string, "playlistId": string, "position": unsigned integer, "resourceId": { "kind": string, "videoId": string, } }, "contentDetails": { "videoId": string, "startAt": string, "endAt": string, "note": string, "videoPublishedAt": datetime }, "status": { "privacyStatus": string } }
Usługi
Poniższa tabela określa właściwości, które pojawiają się w tym zasobie:
Usługi | |
---|---|
kind |
string Określa typ zasobu interfejsu API. Wartość będzie wynosić youtube#playlistItem . |
etag |
etag Otagowanie tego zasobu. |
id |
string Identyfikator, który YouTube wykorzystuje do jednoznacznego zidentyfikowania elementu playlisty. |
snippet |
object Obiekt snippet zawiera podstawowe informacje o elemencie playlisty, takie jak tytuł i pozycja na tej playliście. |
snippet.publishedAt |
datetime Data i godzina dodania elementu do playlisty. Wartość ma format ISO 8601. |
snippet.channelId |
string Identyfikator, który YouTube jednoznacznie identyfikuje użytkownika, który dodał dany element do playlisty. |
snippet.title |
string Tytuł elementu. |
snippet.description |
string Opis elementu. |
snippet.thumbnails |
object Mapa miniaturek powiązanych z elementem playlisty. Kluczem jest nazwa obrazu miniatury, a wartość to obiekt zawierający inne informacje o miniaturze. |
snippet.thumbnails.(key) |
object Prawidłowe wartości to:
|
snippet.thumbnails.(key).url |
string Adres URL obrazu. |
snippet.thumbnails.(key).width |
unsigned integer Szerokość obrazu. |
snippet.thumbnails.(key).height |
unsigned integer Wysokość obrazu. |
snippet.channelTitle |
string Tytuł kanału, do którego należy element playlisty. |
snippet.videoOwnerChannelTitle |
string Tytuł kanału, który przesłał film. |
snippet.videoOwnerChannelId |
string Identyfikator kanału, który przesłał ten film. |
snippet.playlistId |
string Identyfikator, którego YouTube używa do jednoznacznego zidentyfikowania playlisty, na której znajduje się element playlisty. |
snippet.position |
unsigned integer Kolejność wyświetlania elementu na playliście. Indeks korzysta z zerowego indeksu, więc pierwszy element ma pozycję 0 , a drugi – 1 itd. |
snippet.resourceId |
object Obiekt id zawiera informacje, które mogą posłużyć do jednoznacznego zidentyfikowania zasobu na playliście. |
snippet.resourceId.kind |
string Rodzaj lub typ wspomnianego zasobu. |
snippet.resourceId.videoId |
string Jeśli wartość właściwości snippet.resourceId.kind to youtube#video , ta właściwość będzie obecna, a jej wartość będzie zawierać identyfikator, którego YouTube używa do jednoznacznego identyfikowania filmu na playliście. |
contentDetails |
object Jeśli dołączony element to film w YouTube, zasób contentDetails jest w nim zawarty. Obiekt zawiera dodatkowe informacje o filmie. |
contentDetails.videoId |
string Identyfikator, który YouTube wykorzystuje do jednoznacznego identyfikowania filmu. Aby pobrać zasób video , ustaw w zapytaniu API tę wartość parametru zapytania id . |
contentDetails.startAt |
string Uwaga: ta właściwość została wycofana, a jeśli została skonfigurowana, jej wartość jest ignorowana. Czas (w sekundach) liczony od momentu rozpoczęcia odtwarzania filmu. (Właściciel playlisty może określić czas rozpoczęcia i zakończenia odtwarzania filmu, gdy jest on możliwy w kontekście playlisty). Wartością domyślną jest 0 . |
contentDetails.endAt |
string Uwaga: ta właściwość została wycofana, a jeśli została skonfigurowana, jej wartość jest ignorowana. Czas, w jakim wyrażono w sekundach od rozpoczęcia filmu, kiedy ma on przestać być odtwarzany. (Właściciel playlisty może określić czas rozpoczęcia i zakończenia odtwarzania filmu, gdy jest on możliwy w kontekście playlisty). Domyślnie zakładaj, że video.endTime to koniec filmu. |
contentDetails.note |
string Wygenerowana przez użytkownika notatka na temat tego elementu. Wartość właściwości może mieć maksymalnie 280 znaków. |
contentDetails.videoPublishedAt |
datetime Data i godzina opublikowania filmu w YouTube. Wartość ma format ISO 8601. |
status |
object Obiekt status zawiera informacje o stanie prywatności elementu playlisty. |
status.privacyStatus |
string Stan prywatności elementu playlisty. Kanał, który reprezentuje film na playliście, może ustawić tę wartość za pomocą metody videos.insert lub videos.update . |