PlaylistItems: update

Modyfikuje element playlisty. Możesz na przykład zaktualizować pozycję elementu na playliście.

Wpływ na limit: wywołanie tej metody kosztuje 50 jednostek limitu.

Częste zastosowania

Żądanie

Żądanie HTTP

PUT https://www.googleapis.com/youtube/v3/playlistItems

Autoryzacja

To żądanie wymaga autoryzacji z co najmniej jednym z tych zakresów (więcej informacji o uwierzytelnianiu i autoryzacji).

Zakres
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Parametry

W tabeli poniżej znajdziesz listę parametrów obsługiwanych przez to zapytanie. Wszystkie wymienione parametry są parametrami zapytania.

Parametry
Parametry wymagane
part string
Parametr part pełni w tej operacji 2 funkcje. Określa właściwości, które zostaną ustawione przez operację zapisu, oraz właściwości, które będą uwzględnione w odpowiedzi interfejsu API.

Pamiętaj, że ta metoda zastąpi dotychczasowe wartości wszystkich właściwości, które można zmieniać i które są zawarte w częściach określonych przez wartość parametru. Element playlisty może na przykład określać czas rozpoczęcia i zakończenia, które wskazują, jaka część filmu ma być odtwarzana, gdy użytkownicy oglądają film na playliście. Jeśli żądanie aktualizuje element playlisty, który ustawia te wartości, a wartość parametru part żądania zawiera część contentDetails, czasy rozpoczęcia i zakończenia elementu playlisty zostaną zaktualizowane do wartości określonych w treści żądania. Jeśli treść żądania nie określa wartości, dotychczasowe czasy rozpoczęcia i zakończenia zostaną usunięte i zastąpione ustawieniami domyślnymi.

Poniżej znajdziesz listę nazw part, które możesz uwzględnić w wartości parametru:
  • contentDetails
  • id
  • snippet
  • status
Parametry opcjonalne
onBehalfOfContentOwner string
Uwaga: parametr onBehalfOfContentOwner jest przeznaczony wyłącznie dla partnerów YouTube i może być używany tylko w prawidłowo autoryzowanym żądaniu.

Ten parametr jest przeznaczony dla partnerów YouTube, którzy są właścicielami wielu różnych kanałów YouTube i zarządzają nimi. Umożliwia on użytkownikom powiązanym z właścicielem treści jednorazowe uwierzytelnienie, a następnie dostęp do wszystkich danych dotyczących filmów i kanałów właściciela treści oraz zarządzanie nimi bez konieczności podawania danych uwierzytelniających dla każdego kanału.

Gdy parametr jest obecny, jego wartość identyfikuje właściciela treści, a dane uwierzytelniające żądania identyfikują użytkownika YouTube, który jest upoważniony do działania w imieniu tego właściciela treści. Konto, za pomocą którego użytkownik się uwierzytelnia, musi być powiązane z określonym właścicielem treści w ustawieniach YouTube Studio.

Treść żądania

W treści żądania podaj zasób playlistItem. W przypadku tego zasobu:

  • Musisz określić wartość tych właściwości:

    • id
    • snippet.playlistId
    • snippet.resourceId

  • Możesz ustawić wartości tych właściwości:

    • snippet.position
    • contentDetails.note
    • contentDetails.startAt
    • contentDetails.endAt

    Jeśli przesyłasz żądanie aktualizacji i nie określisz w nim wartości właściwości, która już ma wartość, dotychczasowa wartość właściwości zostanie usunięta.

Odpowiedź

Jeśli operacja się uda, ta metoda zwróci w treści odpowiedzi zasób playlistItem.

Błędy

W tabeli poniżej znajdziesz komunikaty o błędach, które interfejs API może zwrócić w odpowiedzi na wywołanie tej metody. Więcej informacji znajdziesz w dokumentacji komunikatów o błędach.

Typ błędu Szczegóły błędu Opis
forbidden (403) playlistItemsNotAccessible Żądanie nie jest prawidłowo autoryzowane do aktualizowania określonego elementu playlisty.
invalidValue (400) invalidPlaylistItemPosition Żądanie próbuje ustawić pozycję elementu playlisty na nieprawidłową lub nieobsługiwaną wartość. Sprawdź wartość właściwości position w snippet zasobu.
invalidValue (400) invalidResourceType Wartość type określona w identyfikatorze zasobu nie jest obsługiwana w tej operacji. Identyfikator zasobu określa element dodawany do playlisty, np. youtube#video.
invalidValue (400) invalidSnippet Żądanie nie określa prawidłowej właściwości snippet.
invalidValue (400) manualSortRequired Żądanie próbuje ustawić pozycję elementu playlisty, ale playlista nie używa sortowania ręcznego. (Elementy playlisty mogą być na przykład sortowane według daty lub popularności). Aby rozwiązać ten problem, usuń element snippet.position z zasobu, który jest wstawiany przez żądanie. Jeśli chcesz, aby element playlisty miał określoną pozycję na liście, musisz najpierw zaktualizować w ustawieniach playlisty opcję Kolejność na Ręczna. Te ustawienia można zmienić w Menedżerze filmów na YouTube.
notFound (404) playlistItemNotFound Nie można znaleźć elementu playlisty określonego we właściwości id żądania.
notFound (404) playlistNotFound Nie można znaleźć playlisty określonej w parametrze playlistId żądania.
required (400) channelIdRequired Żądanie nie określa wartości wymaganej właściwości channelId.
required (400) playlistIdRequired Żądanie nie określa wartości wymaganej właściwości playlistId.
required (400) playlistItemIdRequired Zasób elementu playlisty określony w żądaniu musi używać właściwości id do identyfikowania aktualizowanego elementu playlisty.
invalidValue (400) playlistOperationUnsupported Interfejs API nie obsługuje możliwości aktualizowania filmów na określonej playliście. Nie możesz na przykład zaktualizować filmu na playliście przesłanych filmów.

Wypróbuj

Aby wywołać ten interfejs API i zobaczyć żądanie do interfejsu API oraz odpowiedź, użyj APIs Explorer.