PlaylistItems: insert

Dodaje zasób do playlisty.

Wpływ na limit: wywołanie tej metody wiąże się z kosztem limitu wynoszącym 50 jednostek.

Częste zastosowania

Żądanie

Żądanie HTTP

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

Autoryzacja

To żądanie wymaga autoryzacji z co najmniej jednym 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 listę parametrów obsługiwanych przez to zapytanie. Wszystkie wymienione parametry są parametrami zapytania.

Parametry
Parametry wymagane
part string
Parametr part pełni w tej operacji 2 funkcje. Określa właściwości, które zostaną ustawione przez operację zapisu, oraz właściwości, które będą uwzględnione w odpowiedzi interfejsu API.

Poniżej znajdziesz listę part nazw, które możesz uwzględnić w wartości parametru:
  • contentDetails
  • id
  • snippet
  • status
Parametry opcjonalne
onBehalfOfContentOwner string
Ten parametr może być używany tylko w prawidłowo autoryzowanym żądaniu. Uwaga: ten parametr jest przeznaczony wyłącznie dla partnerów YouTube zajmujących się treściami.

Parametr onBehalfOfContentOwner wskazuje, że dane uwierzytelniające żądania identyfikują użytkownika systemu YouTube CMS, który działa w imieniu właściciela treści określonego w wartości parametru. Ten parametr jest przeznaczony dla partnerów YouTube zajmujących się treściami, którzy są właścicielami wielu różnych kanałów YouTube i nimi zarządzają. Umożliwia on właścicielom treści jednorazowe uwierzytelnienie i uzyskanie dostępu do wszystkich danych dotyczących filmów i kanałów 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 w YouTube.

Treść żądania

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

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

    • snippet.playlistId
    • snippet.resourceId

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

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

Odpowiedź

Jeśli operacja się uda, ta metoda zwróci w treści odpowiedzi zasób playlistItem.

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
forbidden (403) playlistContainsMaximumNumberOfVideos Playlista zawiera już maksymalną dozwoloną liczbę elementów.
forbidden (403) playlistItemsNotAccessible Żądanie nie jest prawidłowo autoryzowane do wstawienia określonego elementu playlisty.
invalidValue (400) invalidContentDetails Właściwość contentDetails w żądaniu jest nieprawidłowa. Może to być spowodowane tym, ż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 snippet zasobu.
invalidValue (400) invalidResourceType Wartość type określona w identyfikatorze zasobu nie jest obsługiwana w tej operacji. Identyfikator zasobu określa element dodawany do playlisty, np. youtube#video.
invalidValue (400) manualSortRequired Żądanie próbuje ustawić pozycję elementu playlisty, ale playlista nie używa sortowania ręcznego. (Na przykład elementy playlisty mogą być sortowane według daty lub popularności). Aby rozwiązać ten problem, usuń element snippet.position z zasobu, który jest wstawiany przez żądanie. Jeśli chcesz, aby element playlisty miał określoną pozycję na liście, musisz najpierw zaktualizować ustawienie Kolejność playlisty na Ręczna. To ustawienie można zmienić w Menedżerze filmów w YouTube.
invalidValue (400) videoAlreadyInAnotherSeriesPlaylist Film, który próbujesz dodać do playlisty, znajduje się już na innej playliście serialu.
notFound (404) playlistNotFound Nie można znaleźć playlisty zidentyfikowanej za pomocą parametru playlistId w żądaniu.
notFound (404) videoNotFound Nie można znaleźć filmu, który próbujesz dodać do playlisty. Sprawdź wartość właściwości videoId, aby upewnić się, że jest prawidłowa.
required (400) channelIdRequired Żądanie nie zawiera wartości wymaganej właściwości channelId.
required (400) playlistIdRequired Żądanie nie zawiera 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 możliwości wstawiania filmów do określonej playlisty. Na przykład nie możesz wstawić filmu do playlisty przesłanych filmów.

Wypróbuj

Aby wywołać ten interfejs API i zobaczyć żądanie do interfejsu API oraz odpowiedź, użyj APIs Explorer.