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 wynoszący 50 jednostek.

Częste zastosowania

Żądanie

Żądanie HTTP

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

Autoryzacja

To żądanie wymaga autoryzacji przy użyciu co najmniej 1 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 dwóm celom. Wskazuje właściwości, które ustawi operacja zapisu, oraz właściwości, które będzie zawierać odpowiedź interfejsu API.

Pamiętaj, że ta metoda zastępuje istniejące wartości właściwości zmiennych, które są zawarte w częściach określonych w treści żądania. Na przykład opis playlisty jest zawarty w części snippet, która musi być zawarta w treści żądania. Jeśli żądanie nie określa wartości właściwości snippet.description, bieżący opis playlisty zostanie usunięty.

Poniższa 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 dostawców treści w YouTube.

Parametr onBehalfOfContentOwner wskazuje, że dane uwierzytelniające żądania identyfikują użytkownika systemu zarządzania treścią YouTube, który działa w imieniu właściciela treści określonego w wartości parametru. Ten parametr jest przeznaczony dla dostawców treści w YouTube, którzy są właścicielami wielu różnych kanałów YouTube i nimi zarządzają. Dzięki niej właściciele treści mogą dokonać uwierzytelnienia raz i uzyskać dostęp do wszystkich danych dotyczących filmów i kanału bez konieczności podawania danych uwierzytelniających dla każdego kanału. Konto CMS, za pomocą którego użytkownik się uwierzytelnia, musi być połączone z określonym właścicielem treści YouTube.

Treść żądania

Udostępnij zasób playlisty w treści żądania. W przypadku tego zasobu:

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

    • id
    • snippet.title

  • Możesz ustawić wartości dla 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 prośbę o aktualizację, a nie określa ono wartości usługi, która ma już wartość, dotychczasowa wartość usługi zostanie usunięta.

Odpowiedź

Jeśli operacja się uda, 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 komunikatu o błędzie.

Typ błędu Szczegóły błędu Opis
badRequest (400) defaultLanguageNotSetError Pole defaultLanguage musi być ustawione na aktualizację 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. Zaktualizuj je zgodnie z wytycznymi podanymi w dokumentacji zasobów playlist.
forbidden (403) playlistForbidden Ta operacja jest zabroniona lub żądanie nie jest poprawnie autoryzowane.
invalidValue (400) invalidPlaylistSnippet Żądanie zawiera nieprawidłowy fragment playlisty.
notFound (404) playlistNotFound Nie można znaleźć playlisty wskazywanej przez parametr id żądania.
required (400) playlistTitleRequired W żądaniu musi być określony tytuł playlisty.
invalidValue (400) playlistOperationUnsupported Interfejs API nie obsługuje możliwości aktualizacji określonej playlisty. Na przykład nie możesz aktualizować właściwości playlisty z przesłanymi filmami.

Wypróbuj

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