PlaylistItems: insert

Dodaje zasób do playlisty.

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

Typowe przypadki użycia

Prośba

Żądanie HTTP

POST https://www.googleapis.com/youtube/v3/playlistItems

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.

Na poniższej liście znajdziesz nazwy typu part, które możesz uwzględnić w wartości parametru:
  • contentDetails
  • id
  • 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

Podaj zasób playlistItem w treści żądania. W przypadku tego zasobu:

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

    • snippet.playlistId
    • snippet.resourceId

  • Możesz ustawić wartości dla tych właściwości:

    • snippet.playlistId
    • snippet.position
    • snippet.resourceId
    • contentDetails.note
    • contentDetails.startAt
    • contentDetails.endAt

Odpowiedź

Jeśli operacja się uda, metoda zwróci zasób playlistItem 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
forbidden (403) playlistContainsMaximumNumberOfVideos Playlista zawiera już maksymalną dozwoloną liczbę elementów.
forbidden (403) playlistItemsNotAccessible Żądanie nie ma prawidłowej autoryzacji do wstawienia określonego elementu playlisty.
invalidValue (400) invalidContentDetails Właściwość contentDetails w żądaniu jest nieprawidłowa. Możliwe, że pole contentDetails.note ma więcej niż 280 znaków.
invalidValue (400) invalidPlaylistItemPosition Żądanie próbuje ustawić pozycję elementu playlisty na nieprawidłową lub nieobsługiwaną wartość. Sprawdź wartość właściwości position w parametrze snippet zasobu.
invalidValue (400) invalidResourceType Wartość type określona dla identyfikatora zasobu nie jest obsługiwana w tej operacji. Identyfikator zasobu określa element dodawany do playlisty, np. youtube#video.
invalidValue (400) manualSortRequired W żądaniu jest ustalona pozycja elementu playlisty, ale sortowanie playlisty nie jest wykonywane ręcznie. (na przykład elementy playlist mogą być sortowane według daty lub popularności). Możesz naprawić ten błąd, usuwając element snippet.position z zasobu wstawianego przez żądanie. Jeśli chcesz, aby element playlisty miał określoną pozycję na liście, musisz najpierw zmienić opcję Kolejność na Ręczna w jej ustawieniach. Te ustawienia można dostosować w Menedżerze filmów YouTube.
invalidValue (400) videoAlreadyInAnotherSeriesPlaylist Film, który próbujesz dodać do playlisty, jest już na innej playliście serialu.
notFound (404) playlistNotFound Nie udało się znaleźć playlisty określonej za pomocą parametru playlistId żądania.
notFound (404) videoNotFound Nie można znaleźć filmu, który próbujesz dodać do playlisty. Sprawdź, czy wartość właściwości videoId jest prawidłowa.
required (400) channelIdRequired Żądanie nie określa wartości wymaganej właściwości channelId.
required (400) playlistIdRequired Żądanie nie określa wartości wymaganej właściwości playlistId.
required (400) resourceIdRequired Żądanie musi zawierać zasób, w którym obiekt snippet określa resourceId.
invalidValue (400) playlistOperationUnsupported Interfejs API nie obsługuje funkcji wstawiania filmów do wskazanej playlisty. Nie możesz na przykład wstawić filmu do playlisty przesłanych filmów.

Wypróbuj

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