Playlists: insert

Tworzy playlistę.

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

Typowe zastosowania

Żądanie

Żądanie HTTP

POST 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 właściwości, które zostaną ustawione przez operację zapisu, a także właściwości, które będą uwzględnione w odpowiedzi interfejsu API.

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 w YouTube.


Parametr onBehalfOfContentOwner wskazuje, że dane logowania autoryzujące prośbę 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.
onBehalfOfContentOwnerChannel 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 w YouTube.


Parametr onBehalfOfContentOwnerChannel określa identyfikator kanału YouTube, do którego jest dodawany film. Ten parametr jest wymagany, gdy żądanie określa wartość parametru onBehalfOfContentOwner, i może być używany tylko w połączeniu z tym parametrem. Ponadto żądanie musi być autoryzowane za pomocą konta CMS powiązanego z właścicielem treści, którego określa parametr onBehalfOfContentOwner. Na koniec kanał określony przez wartość parametru onBehalfOfContentOwnerChannel musi być powiązany z właścicielem treści określonym przez parametr onBehalfOfContentOwner.

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 właścicielom treści jednorazowe uwierzytelnianie się i wykonywanie działań w imieniu kanału określonego w wartości parametru bez konieczności podawania danych uwierzytelniających dla każdego osobnego kanału.

Treść żądania

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

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

    • 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

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 zaktualizować je zgodnie ze wskazówkami podanymi w dokumentacji zasobu playlist.
badRequest (400) maxPlaylistExceeded Nie można utworzyć playlisty, ponieważ kanał ma już maksymalną liczbę playlist.
forbidden (403) playlistForbidden Ta operacja jest zabroniona lub żądanie nie jest prawidłowo autoryzowane.
invalidValue (400) invalidPlaylistSnippet Żądanie zawiera nieprawidłowy fragment playlisty.
required (400) playlistTitleRequired W żądaniu musisz podać tytuł playlisty.

Wypróbuj

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