Playlists: update

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

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

Typowe przypadki użycia

Żądanie

Żądanie HTTP

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

Upoważnienie

To żądanie wymaga autoryzacji z co najmniej jednym z poniższych 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 poniższej tabeli podano parametry obsługiwane przez to zapytanie. Wszystkie wymienione parametry są parametrami zapytania.

Parametry
Parametry wymagane
part string
Parametr part spełnia 2 cele w tej operacji. Wskazuje on właściwości, które ustawi operacja zapisu, a także właściwości uwzględnione przez odpowiedź interfejsu API.

Pamiętaj, że ta metoda zastępuje istniejące wartości właściwości zmiennych, które znajdują się w dowolnych częściach określonego w żądaniu. Na przykład opis playlisty znajduje się w sekcji 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, dotychczasowy opis playlisty zostanie usunięty.

Ta lista zawiera nazwy part, które możesz uwzględnić w wartości parametru:
  • contentDetails
  • id
  • localizations
  • player
  • snippet
  • status
Parametry opcjonalne
onBehalfOfContentOwner string
Ten parametr może być używany tylko w poprawnie autoryzowanym żądaniu. Uwaga: ten parametr jest przeznaczony wyłącznie dla partnerów w sieci reklamowej YouTube.

Parametr onBehalfOfContentOwner wskazuje, że dane logowania żądania autoryzacji to użytkownik 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 w sieci reklamowej YouTube, którzy mają wiele kanałów YouTube i zarządzają nimi. Umożliwia właścicielom treści uwierzytelnianie tylko raz oraz dostęp do wszystkich filmów i kanałów bez konieczności podawania danych uwierzytelniających dla każdego kanału z osobna. Konto CMS, za pomocą którego użytkownik się uwierzytelni, musi być połączone z określonym właścicielem treści w YouTube.

Treść żądania

Zasoby playlisty w treści żądania. Dla tego zasobu:

  • Musisz określić 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
    • snippet.defaultLanguage
    • localizations.(key)
    • localizations.(key).title
    • localizations.(key).description

    Jeśli przesyłasz prośbę o aktualizację, ale nie określa ona wartości właściwości, która już ma wartość, obecna wartość usługi zostanie usunięta.

Odpowiedź

Jeśli operacja się uda, ta metoda zwróci zasób playlisty 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 informacji znajdziesz w dokumentacji komunikatów o błędach.

Typ błędu Szczegóły błędu Opis
badRequest (400) defaultLanguageNotSetError Musisz skonfigurować właściwość defaultLanguage, aby zaktualizować localizations.
badRequest (400) localizationValidationError Jedna z wartości w obiekcie lokalizacji nie przeszła weryfikacji. Użyj metody playlists.list, aby pobrać prawidłowe wartości i zaktualizować je zgodnie ze wskazówkami w dokumentacji zasobów playlist.
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 można znaleźć playlisty zidentyfikowanej za pomocą parametru id żądania.
required (400) playlistTitleRequired Żądanie musi określać tytuł playlisty.
invalidValue (400) playlistOperationUnsupported Interfejs API nie obsługuje aktualizowania określonej playlisty. Nie możesz na przykład zmieniać właściwości przesłanej playlisty.

Wypróbuj

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