Playlists

playlist reprezentuje playlistę w YouTube. Playlista to zbiór filmów, które można oglądać po kolei i udostępniać innym użytkownikom. Domyślnie playlisty są widoczne publicznie dla innych użytkowników, ale mogą być publiczne lub prywatne.

YouTube używa też playlist do identyfikowania specjalnych kolekcji filmów na kanale, takich jak:

  • przesłane filmy,
  • filmy ocenione pozytywnie (polubione);
 Mówiąc dokładniej, te listy są powiązane z kanałem, czyli zbiorem filmów, playlist i innych informacji w YouTube należących do osoby, grupy lub firmy. Identyfikatory playlist dla każdej z tych list możesz pobrać z channel resource danego kanału.

 Następnie możesz użyć metody playlistItems.list, aby pobrać dowolną z tych list. 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 w przypadku zasobów playlists:

list
Zwraca zbiór list odtwarzania pasujących do parametrów żądania do interfejsu API. Możesz na przykład pobrać wszystkie playlisty, których właścicielem jest uwierzytelniony użytkownik, lub pobrać co najmniej jedną playlistę, podając jej unikalne identyfikatory. Wypróbuj teraz
wstaw
Tworzy playlistę. Wypróbuj teraz
aktualizować
Modyfikuje playlistę. Możesz na przykład zmienić tytuł, opis lub stan prywatności playlisty. Wypróbuj teraz
usuń
Usuwa playlistę. Wypróbuj teraz

Prezentacja zasobów

Poniższa struktura JSON przedstawia 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,
    "podcastStatus": enum
  },
  "contentDetails": {
    "itemCount": unsigned integer
  },
  "player": {
    "embedHtml": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

Właściwości

Poniższa tabela zawiera definicje właściwości, które pojawiają się w tym zasobie:

Właściwości
kind string
Określa typ zasobu interfejsu API. Wartość będzie wynosić youtube#playlist.
etag etag
Tag ETag tego zasobu.
id string
Identyfikator, którego YouTube używa do jednoznacznej identyfikacji playlisty.
snippet object
Obiekt snippet zawiera podstawowe informacje o playliście, takie jak jej tytuł i opis.
snippet.publishedAt datetime
Data i godzina utworzenia playlisty. Wartość jest podana w formacie ISO 8601.
snippet.channelId string
Identyfikator, którego YouTube używa do jednoznacznej identyfikacji kanału, który opublikował playlistę.
snippet.title string
Tytuł playlisty.
snippet.description string
Opis playlisty.
snippet.thumbnails object
Mapa miniatur powiązanych z playlistą. W przypadku każdego obiektu na mapie kluczem jest nazwa miniatury, a wartością jest obiekt zawierający inne informacje o miniaturze.
snippet.thumbnails.(key) object
Prawidłowe wartości klucza to:
  • default – domyślna miniatura. Domyślna miniatura filmu lub zasobu, który odnosi się do filmu, np. elementu playlisty lub wyniku wyszukiwania, ma szerokość 120 pikseli i wysokość 90 pikseli. Domyślna miniatura kanału ma 88 pikseli szerokości i 88 pikseli wysokości.
  • medium – wersja miniatury w wyższej rozdzielczości. W przypadku filmu (lub zasobu, który odwołuje się do filmu) ten obraz ma szerokość 320 pikseli i wysokość 180 pikseli. W przypadku kanału obraz ten ma szerokość 240 pikseli i wysokość 240 pikseli.
  • high – wersja miniatury w wysokiej rozdzielczości. W przypadku filmu (lub zasobu, który odwołuje się do filmu) obraz ma szerokość 480 pikseli i wysokość 360 pikseli. W przypadku kanału obraz ten ma szerokość i wysokość 800 pikseli.
  • standard – wersja miniatury w jeszcze wyższej rozdzielczości niż obraz w rozdzielczości high. Jest ona dostępna w przypadku niektórych filmów i innych zasobów, które się do nich odnoszą, np. elementów playlisty czy wyników wyszukiwania. Ten obraz ma szerokość 640 pikseli i wysokość 480 pikseli.
  • maxres – wersja miniatury w najwyższej rozdzielczości. Ten rozmiar obrazu jest dostępny w przypadku niektórych filmów i innych zasobów, które odwołują się do filmów, takich jak elementy playlisty czy wyniki wyszukiwania. Ten obraz ma szerokość 1280 pikseli i wysokość 720 pikseli.
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 właściwość 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 metadanych playlisty.
  • Zlokalizowany tekst jest zwracany we fragmencie zasobu, jeśli w żądaniu playlists.list użyto parametru hl do określenia języka, w którym ma być zwracany zlokalizowany tekst i zlokalizowany tekst jest dostępny w tym języku.
  • Metadane dla języka domyślnego są zwracane, jeśli nie określono wartości parametru hl lub określono wartość, ale zlokalizowane metadane nie są dostępne dla wybranego języka.
 Właściwość zawiera wartość tylko do odczytu. Użyj obiektu localizations, aby dodać, zaktualizować lub usunąć zlokalizowane tytuły.
snippet.localized.title string
Zlokalizowany tytuł playlisty.
snippet.localized.description string
Zlokalizowany opis playlisty.
status object
Obiekt status zawiera informacje o stanie listy odtwarzania.
status.privacyStatus string
Stan prywatności playlisty.

Prawidłowe wartości tego pola to:
  • private
  • public
  • unlisted
status.podcastStatus string
Stan playlisty jako podcastu. Jeśli wartość to enabled, playlista jest oznaczona jako podcast. Aby ustawić stan podcastu na enabled, playlista musi mieć obraz.

Prawidłowe wartości tej właściwości to:
  • enabled
  • disabled
  • unspecified
contentDetails object
Obiekt contentDetails zawiera informacje o zawartości playlisty, w tym liczbę filmów na playliście.
contentDetails.itemCount unsigned integer
Liczba filmów na playliście.
player object
Obiekt player zawiera informacje, które umożliwiają odtwarzanie playlisty w odtwarzaczu umieszczonym na stronie.
player.embedHtml string
Tag <iframe>, który osadza odtwarzacz odtwarzający playlistę.
localizations object
localizations obiekt zawiera tłumaczenia metadanych playlisty.
localizations.(key) object
Język zlokalizowanego tekstu powiązanego z wartością klucza. Wartość to ciąg znaków zawierający kod języka BCP-47.
localizations.(key).title string
Zlokalizowany tytuł playlisty.
localizations.(key).description string
Zlokalizowany opis playlisty.