PlaylistItems

Zasób playlistItem identyfikuje inny zasób, np. film, który jest częścią playlisty. Dodatkowo zasób playlistItem zawiera szczegóły dotyczące dołączonego zasobu, które odnoszą się konkretnie do sposobu, w jaki jest on wykorzystywany w danej playliście.

YouTube używa też playlisty do identyfikowania listy przesłanych filmów na kanale. Każdy playlistItem na tej liście reprezentuje jeden przesłany film. Identyfikator playlisty możesz pobrać z zasobu channel dla danego kanału. Następnie możesz użyć metody playlistItems.list, aby dodać element do listy.

Metody

Interfejs API obsługuje te metody dla zasobów playlistItems:

list
Zwraca kolekcję elementów playlisty, które pasują do parametrów żądania do interfejsu API. Możesz pobrać wszystkie elementy z określonej playlisty lub pobrać co najmniej 1 element playlisty na podstawie jego unikalnego identyfikatora. Wypróbuj teraz
wstaw
Dodaje zasób do playlisty. Wypróbuj teraz
aktualizować
Modyfikuje element playlisty. Możesz na przykład zmienić pozycję elementu na playliście. Wypróbuj teraz
usuń
Usuwa element z playlisty. Wypróbuj teraz

Prezentacja zasobów

Poniższa struktura JSON przedstawia 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
  }
}

Właściwości

W tej tabeli znajdziesz 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#playlistItem.
etag etag
Etag tego zasobu.
id string
Identyfikator, którego YouTube używa do jednoznacznego identyfikowania elementu playlisty.
snippet object
Obiekt snippet zawiera podstawowe informacje o elemencie playlisty, takie jak tytuł i pozycja na playliście.
snippet.publishedAt datetime
Data i godzina dodania elementu do playlisty. Wartość jest podana w formacie ISO 8601.
snippet.channelId string
Identyfikator, którego YouTube używa do jednoznacznego określenia użytkownika, który dodał element do playlisty.
snippet.title string
Nazwa produktu.
snippet.description string
Opis produktu.
snippet.thumbnails object
Mapa miniatur powiązanych z elementem playlisty. 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) 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) ten obraz ma szerokość 480 pikseli i wysokość 360 pikseli. W przypadku kanału obraz ten ma szerokość i wysokość 800 pikseli.
  • standard – wersja miniatury o jeszcze wyższej rozdzielczości niż obraz o rozdzielczości high. Ten obraz jest dostępny 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 wysokiej 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.
  • fhd – wersja miniatury w pełnej rozdzielczości HD (1080p). Ten rozmiar obrazu jest dostępny w przypadku niektórych filmów. Ten obraz ma szerokość 1920 pikseli i wysokość 1080 pikseli.
  • qhd – miniatura w rozdzielczości Quad HD (1440p / 2K). Ten rozmiar obrazu jest dostępny w przypadku niektórych filmów. Ten obraz ma szerokość 2560 pikseli i wysokość 1440 pikseli.
  • uhd – miniatura w ultrawysokiej rozdzielczości (4K). Ten rozmiar obrazu jest dostępny w przypadku niektórych filmów. Ten obraz ma szerokość 3840 pikseli i wysokość 2160 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, na który przesłano ten film.
snippet.videoOwnerChannelId string
Identyfikator kanału, na który przesłano ten film.
snippet.playlistId string
Identyfikator, którego YouTube używa do jednoznacznego określenia playlisty, na której znajduje się element playlisty.
snippet.position unsigned integer
Kolejność, w jakiej element pojawia się na playliście. Wartość używa indeksu opartego na zerze, więc pierwszy element ma pozycję 0, drugi – 1 itd.
snippet.resourceId object
Obiekt id zawiera informacje, które można wykorzystać do jednoznacznego zidentyfikowania zasobu uwzględnionego na playliście jako elementu playlisty.
snippet.resourceId.kind string
Rodzaj lub typ zasobu, do którego odnosi się link.
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
Obiekt contentDetails jest uwzględniany w zasobie, jeśli dołączony element to film na YouTube. Obiekt zawiera dodatkowe informacje o filmie.
contentDetails.videoId string
Identyfikator, którego YouTube używa do jednoznacznej identyfikacji filmu. Aby pobrać zasób video, w żądaniu do interfejsu API ustaw parametr zapytania id na tę wartość.
contentDetails.startAt string
Uwaga: ta właściwość została wycofana i jeśli jest ustawiona, jej wartość jest ignorowana.

Czas w sekundach od początku filmu, w którym ma się rozpocząć odtwarzanie. (Właściciel playlisty może określić, kiedy film ma się rozpocząć i zakończyć, gdy jest odtwarzany w kontekście playlisty). Wartością domyślną jest 0.
contentDetails.endAt string
Uwaga: ta właściwość została wycofana i jeśli jest ustawiona, jej wartość jest ignorowana.

Czas w sekundach od początku filmu, w którym odtwarzanie powinno się zatrzymać. (Właściciel playlisty może określić, kiedy film ma się rozpocząć i zakończyć, gdy jest odtwarzany w kontekście playlisty). Domyślnie przyjmujemy, że video.endTime to koniec filmu.
contentDetails.note string
Notatka użytkownika dotycząca tego produktu. Wartość właściwości może mieć maksymalnie 280 znaków.
contentDetails.videoPublishedAt datetime
Data i godzina opublikowania filmu w YouTube. Wartość jest podana w formacie 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 przesłał film reprezentowany przez element playlisty, może ustawić tę wartość za pomocą metody videos.insert lub videos.update.