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

PlaylistItems

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: `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 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`.