Ta strona została przetłumaczona przez Cloud Translation API.

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, ale mogą być publiczne lub prywatne.

YouTube wykorzystuje też playlisty do identyfikowania specjalnych kolekcji filmów na kanale, takich jak:

przesłane filmy
filmy oceniane pozytywnie (polubienia)

. Te listy są bardziej powiązane z kanałem, czyli zbiorem filmów, playlist lub innych informacji o YouTube dotyczących osoby, grupy lub firmy. Identyfikatory playlist dla każdej z tych list możesz pobrać z channel resource konkretnego kanału.

Możesz użyć metody playlistItems.list, aby pobrać dowolną z tych list. Możesz też dodawać pozycje do tych list lub je z nich usuwać, wywołując metody playlistItems.insert i playlistItems.delete.

Metody

Interfejs API obsługuje następujące metody w przypadku zasobów playlists:

list: Zwraca kolekcję playlist 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, albo pobrać jedną lub więcej playlist według ich unikalnych identyfikatorów. Wypróbuj teraz
wstaw: Tworzy playlistę. Wypróbuj teraz
zaktualizuj: Modyfikuje playlistę. Możesz na przykład zmienić tytuł, opis lub stan prywatności playlisty. Wypróbuj teraz
usuń: Usuwa playlistę. Wypróbuj teraz

Reprezentowanie zasobów

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
    }
  }
}

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#playlist`.
`etag`	`etag` Otagowanie tego zasobu.
`id`	`string` Identyfikator, który jest używany przez YouTube do jednoznacznego identyfikowania playlisty.
`snippet`	`object` Obiekt `snippet` zawiera podstawowe informacje o playliście, takie jak tytuł i opis.
`snippet.publishedAt`	`datetime` Data i godzina utworzenia playlisty. Wartość ma format ISO 8601.
`snippet.channelId`	`string` Identyfikator, który jest używany przez YouTube do jednoznacznego identyfikowania kanału, który opublikował playlistę.
`snippet.title`	`string` Tytuł playlisty.
`snippet.description`	`string` Opis playlisty.
`snippet.thumbnails`	`object` Mapa miniaturek powiązanych z playlistą. Kluczem jest nazwa obrazu miniatury, a wartość to obiekt zawierający inne informacje o miniaturze.
`snippet.thumbnails.(key)`	`object` Prawidłowe wartości to: `default` – domyślny obraz miniatury. Domyślna miniatura filmu – lub zasób, który odnosi się do filmu – na przykład element playlisty lub wynik wyszukiwania – to 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` – wyższa wersja miniatury obrazu. W przypadku filmu (lub zasobu, który odnosi się do filmu), obraz ma szerokość 320 pikseli i wysokość 180 pikseli. W przypadku kanału obraz ma szerokość 240 pikseli i wysokość 240 pikseli. `high` – wersja miniatury w wysokiej rozdzielczości. W przypadku filmu (lub zasobu, który odnosi się do filmu), obraz ma szerokość 480 i wysokość 360 pikseli. W przypadku kanału obraz ma szerokość 800 i wysokość 800 pikseli. `standard` – jeszcze wyższa wersja miniatury obrazu niż `high`. Ten obraz jest dostępny w przypadku niektórych filmów i innych zasobów, które odnoszą się do filmów, takich jak elementy playlisty czy wyniki wyszukiwania. Obraz ma szerokość 640 i wysokość 480 pikseli. `maxres` – wyższa wersja miniatury obrazu. Ten rozmiar jest dostępny w przypadku niektórych filmów i innych zasobów, które odnoszą się do filmów, takich jak elementy playlisty czy wyniki wyszukiwania. 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 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 tekst i opis playlisty lub tytuł w domyślnym języku jej metadanych. Zlokalizowany tekst zostanie zwrócony we fragmencie kodu zasobu, jeśli żądanie `playlists.list` używa parametru `hl` do określenia języka, w którym ma się wyświetlać zlokalizowany tekst oraz zlokalizowany tekst. Metadane dla domyślnego języka są zwracane, jeśli wartość parametru `hl` nie została określona lub jest określona, ale zlokalizowane metadane są niedostępne. Właściwość zawiera wartość tylko do odczytu. Aby dodać, zaktualizować lub usunąć przetłumaczone tytuły, użyj obiektu `localizations`.
`snippet.localized.title`	`string` Zlokalizowany tytuł playlisty.
`snippet.localized.description`	`string` Zlokalizowany opis playlisty.
`status`	`object` Obiekt `status` zawiera informacje o stanie playlisty.
`status.privacyStatus`	`string` Stan prywatności playlisty. Prawidłowe wartości tej właściwości to: `private` `public` `unlisted`
`contentDetails`	`object` Obiekt `contentDetails` zawiera informacje o treściach playlisty, w tym liczbę filmów na niej.
`contentDetails.itemCount`	`unsigned integer` Liczba filmów na playliście.
`player`	`object` Obiekt `player` zawiera informacje, których możesz użyć do odtworzenia playlisty w odtwarzaczu umieszczonym na stronie internetowej.
`player.embedHtml`	`string` Tag `<iframe>`, który zawiera odtwarzacz, który będzie odtwarzać playlistę
`localizations`	`object` Obiekt `localizations` zawiera tłumaczenia metadanych playlisty.
`localizations.(key)`	`object` Język zlokalizowanego tekstu powiązanego z parą klucz-wartość. Wartość jest ciągiem znaków zawierającym kod języka BCP-47.
`localizations.(key).title`	`string` Zlokalizowany tytuł playlisty.
`localizations.(key).description`	`string` Zlokalizowany opis playlisty.