Playlists: update

Modyfikuje playlistę. Możesz na przykład zmienić tytuł, opis lub ustawienia prywatności playlisty.

Wpływ na limit: wywołanie tej metody ma koszt związany z limitem wynoszący 50 jednostek.

Typowe zastosowania

Żądanie

Żądanie HTTP

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

Autoryzacja

To żądanie wymaga autoryzacji z co najmniej jednym z tych zakresów. Więcej informacji o uwierzytelnianiu i autoryzowaniu znajdziesz w artykule Wdrażanie autoryzacji OAuth 2.0.

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
Parametry part służą w tej operacji do dwóch celów. Określa ona właściwości, które zostaną ustawione przez operację zapisu, a także właściwości, które będą zawierać odpowiedź API.

Pamiętaj, że ta metoda zastąpi dotychczasowe wartości właściwości, które można zmienić i które są zawarte w dowolnych częściach określonych w ciele żądania. Opis playlisty znajduje się na przykład w części snippet, która musi być uwzględniona w treści żądania. Jeśli żądanie nie określa wartości właściwości snippet.description, istniejący opis playlisty zostanie usunięty.

Następująca lista zawiera nazwy part, które możesz uwzględnić w wartości parametru:
  • contentDetails
  • id
  • localizations
  • player
  • snippet
  • status
Parametry opcjonalne
onBehalfOfContentOwner string
Tego parametru można używać tylko w prawidłowo autoryzowanym żądaniu.

Uwaga: ten parametr jest przeznaczony wyłącznie dla partnerów treści YouTube.

Parametr onBehalfOfContentOwner wskazuje, że dane uwierzytelniające autoryzacji żądania identyfikują użytkownika systemu CMS YouTube, który działa w imieniu właściciela treści określonego w wartości parametru. Ten parametr jest przeznaczony dla partnerów treści w YouTube, którzy są właścicielami wielu kanałów YouTube i nimi zarządzają. Umożliwia ona właścicielom treści jednorazową weryfikację i uzyskanie dostępu do wszystkich danych o filmach i kanałach bez konieczności podawania danych logowania do każdego kanału. Konto CMS, za pomocą którego użytkownik się uwierzytelnia, musi być powiązane z określonym właścicielem treści w YouTube.

Treść żądania

W treści żądania podaj zasób playlist.

W przypadku tego zasobu:

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

    • id
    • snippet.title

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

    • snippet.title
    • snippet.description
    • status.privacyStatus
    • status.podcastStatus
    • snippet.defaultLanguage
    • localizations.(key)
    • localizations.(key).title
    • localizations.(key).description

    Jeśli przesyłasz żądanie aktualizacji, a w prośbie nie ma 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ę powiedzie, zwróci ona w treści odpowiedzi zasób playlist.

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 artykule Błędy w interfejsie YouTube Data API.

Typ błędu Szczegóły błędu Opis
badRequest (400) defaultLanguageNotSetError Ustawienie defaultLanguage musi być ustawione na aktualizację localizations.
badRequest (400) localizationValidationError Jedna z wartości w obiekcie localizations nie przeszła walidacji. Aby pobrać prawidłowe wartości, użyj metody playlists.list i pamiętaj, aby je zaktualizować zgodnie ze wskazówkami podanymi w dokumentacji zasobu playlists.
forbidden (403) playlistForbidden Ta operacja jest zabroniona lub żądanie nie jest prawidłowo autoryzowane.
invalidValue (400) invalidPlaylistSnippet Żądanie zawiera nieprawidłowy fragment playlisty.
notFound (404) playlistNotFound Nie udało się znaleźć playlisty zidentyfikowanej za pomocą parametru id żądania.
required (400) playlistTitleRequired W żądaniu musisz podać tytuł playlisty.
invalidValue (400) playlistOperationUnsupported Interfejs API nie obsługuje możliwości aktualizowania określonej playlisty. Nie możesz na przykład zaktualizować właściwości playlisty przesłanych filmów.

Wypróbuj

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