Playlists

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

Uściślając, listy te są powiązane z kanałem, który jest zbiorem filmów, playlist i innych informacji z YouTube należących do osoby, grupy lub firmy. Identyfikatory playlist dla każdej z tych list znajdziesz w 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: default – domyślny obraz miniatury. Domyślna miniatura filmu lub zasobu nawiązującego do filmu, np. elementu playlisty czy wyniku wyszukiwania – ma 120 pikseli szerokości i 90 pikseli wysokości. Domyślna miniatura kanału ma 88 pikseli szerokości i 88 pikseli wysokości. medium – wersja obrazu miniatury w wyższej rozdzielczości. W przypadku filmu (lub zasobu, który odnosi się do filmu) obraz ten ma 320 pikseli szerokości i 180 pikseli wysokości. W przypadku kanału obraz ma 240 pikseli szerokości i 240 pikseli wysokości. high – wersja obrazu miniatury w wysokiej rozdzielczości. W przypadku filmu (lub zasobu, który odnosi się do filmu) obraz ten ma 480 pikseli szerokości i 360 pikseli wysokości. W przypadku kanału obraz ma 800 pikseli szerokości i 800 pikseli wysokości. standard – wersja obrazu miniatury w jeszcze wyższej rozdzielczości niż obraz w rozdzielczości high. Ten obraz jest dostępny w przypadku niektórych filmów i innych zasobów odnoszących się do filmów, takich jak elementy playlist czy wyniki wyszukiwania. Ten obraz ma 640 pikseli szerokości i 480 pikseli wysokości. maxres – wersja obrazu miniatury w najwyższej rozdzielczości. Ten rozmiar obrazu jest dostępny w przypadku niektórych filmów i innych zasobów dotyczących filmów, takich jak elementy playlist czy wyniki wyszukiwania. Ten obraz ma 1280 pikseli szerokości i 720 pikseli wysokości.
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. Zlokalizowany tekst jest zwracany we fragmencie kodu zasobu, jeśli żądanie playlists.list używa parametru hl do określenia języka, dla którego ma być zwracany przetłumaczony tekst oraz dostępny jest w nim tekst zlokalizowany. Metadane dla języka domyślnego są zwracane, jeśli wartość parametru hl nie została określona lub określono wartość, ale zlokalizowane metadane nie są dostępne dla wybranego języka. Właściwość zawiera wartość tylko do odczytu. Aby dodawać, aktualizować i usuwać zlokalizowane tytuły, używaj obiektu 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: private public unlisted
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.