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:
|
|
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.