Zasób playlist
reprezentuje playlistę w YouTube. Playlista to zbiór filmów, które można oglądać w określonej kolejności i udostępniać innym użytkownikom. Domyślnie playlisty są widoczne publicznie dla innych użytkowników, ale playlisty mogą być publiczne lub prywatne.
YouTube wykorzystuje też playlisty do identyfikowania specjalnych kolekcji filmów na kanale, na przykład:
- przesłane filmy
- pozytywnie oceniane (polubione) filmy
channel resource
dla danego kanału.Następnie możesz użyć metody
playlistItems.list
, aby pobrać te listy. Możesz też dodawać elementy do tych list lub je z nich usuwać, wywołując metody playlistItems.insert
i playlistItems.delete
.
Metody
Interfejs API obsługuje te metody zasobów playlists
:
- list
- Zwraca kolekcję playlist zgodnych z parametrami żądania do interfejsu API. Możesz na przykład pobrać wszystkie playlisty należące do uwierzytelnionych użytkowników albo jedną lub więcej playlist, podając ich unikalne identyfikatory. Wypróbuj teraz
- wstaw
- Tworzy playlistę. Wypróbuj teraz
- aktualizacja
- Modyfikuje playlistę. Możesz na przykład zmienić tytuł, opis lub stan prywatności playlisty. Wypróbuj teraz
- usuń
- Usuwa playlistę. Wypróbuj teraz
Reprezentacja zasobu
Poniższa struktura JSON pokazuje format zasobu playlists
:
{ "kind": "youtube#playlist", "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, "defaultLanguage": string, "localized": { "title": string, "description": string } }, "status": { "privacyStatus": string }, "contentDetails": { "itemCount": unsigned integer }, "player": { "embedHtml": string }, "localizations": { (key): { "title": string, "description": string } } }
Właściwości
Poniższa tabela przedstawia właściwości, które pojawiają się w tym zasobie:
Właściwości | |
---|---|
kind |
string Określa typ zasobu interfejsu API. Wartością będzie youtube#playlist . |
etag |
etag ETag tego zasobu. |
id |
string Identyfikator, którego YouTube używa do jednoznacznego zidentyfikowania playlisty. |
snippet |
object Obiekt snippet zawiera podstawowe informacje o playlistie, w tym tytuł i opis. |
snippet.publishedAt |
datetime Data i godzina utworzenia playlisty. Wartość należy podać w formacie ISO 8601. |
snippet.channelId |
string Identyfikator używany w YouTube do jednoznacznej identyfikacji kanału, który opublikował playlistę. |
snippet.title |
string Tytuł playlisty. |
snippet.description |
string Opis playlisty. |
snippet.thumbnails |
object Mapa miniatur obrazów powiązanych z playlistą. W przypadku każdego obiektu na mapie kluczem jest nazwa obrazu miniatury, a wartością jest obiekt zawierający inne informacje na temat miniatury. |
snippet.thumbnails.(key) |
object Prawidłowe pary klucz-wartość 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 film. |
snippet.tags[] |
list Ta usługa została wycofana. Tagi słów kluczowych powiązane z playlistą. |
snippet.defaultLanguage |
string Język tekstu we właściwościach snippet.title i snippet.description zasobu playlist . |
snippet.localized |
object Obiekt snippet.localized zawiera zlokalizowany tytuł i opis playlisty lub tytuł w domyślnym języku jej metadanych.
localizations . |
snippet.localized.title |
string Tytuł zlokalizowanej playlisty. |
snippet.localized.description |
string Opis zlokalizowanej playlisty. |
status |
object Obiekt status zawiera informacje o stanie playlisty. |
status.privacyStatus |
string Stan prywatności playlisty. Prawidłowe wartości w przypadku tej właściwości to:
|
contentDetails |
object Obiekt contentDetails zawiera informacje o zawartości playlisty, w tym o liczbie filmów na niej. |
contentDetails.itemCount |
unsigned integer Liczba filmów na playliście |
player |
object Obiekt player zawiera informacje, które pozwalają odtworzyć playlistę w umieszczonym odtwarzaczu. |
player.embedHtml |
string Tag <iframe> , który zawiera odtwarzacz, który odtworzy playlistę. |
localizations |
object Obiekt localizations zawiera tłumaczenia metadanych playlisty. |
localizations.(key) |
object Język zlokalizowanego tekstu powiązanego z parą kluczową. Wartość jest ciągiem znaków zawierającym kod języka BCP-47. |
localizations.(key).title |
string Tytuł zlokalizowanej playlisty. |
localizations.(key).description |
string Opis zlokalizowanej playlisty. |