PlaylistItems: update

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

Wpływ na limit: wywołanie tej metody ma koszt limitu wynoszący 50 jednostek.

Typowe przypadki użycia

Prośba

Żądanie HTTP

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

Upoważnienie

To żądanie wymaga autoryzacji z użyciem co najmniej jednego 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 parametry obsługiwane przez to zapytanie. Wszystkie wymienione parametry są parametrami zapytania.

Parametry
Parametry wymagane
part string
Parametr part służy w tej operacji do 2 celów. Określa właściwości, które ustawi operacja zapisu, a także właściwości uwzględnione w odpowiedzi interfejsu API.

Ta metoda zastąpi obecne wartości w przypadku wszystkich właściwości zmiennych, które znajdują się we wszystkich częściach określonych w wartości parametru. Na przykład element playlisty może określać czas rozpoczęcia i zakończenia, które określają czas odtwarzania danego filmu znajdującego się na playliście. Jeśli Twoje żą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ą zmienione na dowolną wartość określoną w treści żądania. Jeśli treść żądania nie określa wartości, obecne godziny rozpoczęcia i zakończenia zostaną usunięte i zastąpione ustawieniami domyślnymi.

Na poniższej liście znajdziesz nazwy typu 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 w zakresie treści w YouTube i można go używać tylko w przypadku prawidłowo autoryzowanych żądań.

Ten parametr jest przeznaczony dla partnerów w zakresie treści 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 się, a później uzyskiwanie dostępu do wszystkich filmów i danych kanału właściciela treści oraz zarządzanie nimi bez konieczności podawania danych uwierzytelniających dla każdego kanału.

Gdy ten parametr jest obecny, jego wartość określa właściciela treści, a dane logowania do autoryzacji żądania wskazują użytkownika YouTube upoważnionego do działania w imieniu tego właściciela treści. Konto, na którym użytkownik się uwierzytelnia, musi być połączone z określonym właścicielem treści w ustawieniach YouTube Studio.

Treść żądania

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

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

    • id
    • snippet.playlistId
    • snippet.resourceId

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

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

    Jeśli przesyłasz prośbę o aktualizację usługi, która ma już wartość, ale nie jest w niej określona, obecna wartość usługi zostanie usunięta.

Odpowiedź

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

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 szczegółów znajdziesz w dokumentacji komunikatów o błędach.

Typ błędu Szczegóły błędu Opis
forbidden (403) playlistItemsNotAccessible Żądanie nie jest poprawnie autoryzowane do aktualizacji wskazanego 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 parametrze snippet zasobu.
invalidValue (400) invalidResourceType Wartość type określona dla identyfikatora 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 W żądaniu jest ustalona pozycja elementu playlisty, ale sortowanie playlisty nie jest wykonywane ręcznie. (na przykład elementy playlist mogą być sortowane według daty lub popularności). Możesz naprawić ten błąd, usuwając element snippet.position z zasobu wstawianego przez żądanie. Jeśli chcesz, aby element playlisty miał określoną pozycję na liście, musisz najpierw zmienić opcję Kolejność na Ręczna w jej ustawieniach. Te ustawienia można dostosować w Menedżerze filmów YouTube.
notFound (404) playlistItemNotFound Nie udało się znaleźć elementu playlisty wskazanego we właściwości id żądania.
notFound (404) playlistNotFound Nie udało się znaleźć playlisty określonej za pomocą parametru 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 playlisty określony w żądaniu musi używać właściwości id do identyfikowania aktualizowanych elementów 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 aktualizować filmu na playliście z przesłanymi filmami.

Wypróbuj

Użyj interfejsu APIs Explorer, aby wywołać ten interfejs API i wyświetlić żądanie oraz odpowiedź interfejsu API.