Playlists: update

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

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/playlists

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łaściwości zmiennych, które znajdują się we wszystkich częściach określonych w treści żądania. Na przykład opis playlisty znajduje się w części snippet, która musi być zawarta w treści żądania. Jeśli w żądaniu nie określono wartości właściwości snippet.description, obecny opis playlisty zostanie usunięty.

Na poniższej liście znajdziesz nazwy funkcji 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 żądanie identyfikują użytkownika YouTube CMS działającego w imieniu właściciela treści określonego w wartości parametru. Jest on przeznaczony dla dostawców treści w YouTube, którzy mają wiele różnych kanałów w YouTube i nimi zarządzają. Dzięki niej właściciele treści mogą jednorazowo uwierzytelnić się i uzyskiwać dostęp do wszystkich swoich filmów oraz danych dotyczących kanałów bez konieczności podawania danych uwierzytelniających dla każdego kanału z osobna. Konto CMS, za pomocą którego użytkownik uwierzytelnia się, musi być powiązane z określonym właścicielem treści YouTube.

Treść żądania

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

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

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

Typ błędu Szczegóły błędu Opis
badRequest (400) defaultLanguageNotSetError defaultLanguage musi być skonfigurowany do aktualizowania localizations.
badRequest (400) localizationValidationError Jedna z wartości obiektu localizations nie przeszła weryfikacji. Aby pobrać prawidłowe wartości, użyj metody playlists.list i pamiętaj o ich zaktualizowaniu zgodnie ze wskazówkami podanymi w dokumentacji dotyczącej 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 kodu playlisty.
notFound (404) playlistNotFound Nie udało się znaleźć playlisty określonej za pomocą parametru id żądania.
required (400) playlistTitleRequired Prośba musi zawierać tytuł playlisty.
invalidValue (400) playlistOperationUnsupported Interfejs API nie obsługuje możliwości aktualizowania określonej playlisty. Nie można na przykład 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 oraz odpowiedź interfejsu API.