Dodaje zasób do playlisty.
Wpływ limitu: wywołanie tej metody ma limit kosztów wynoszący 50 jednostek.
Typowe przypadki użycia
Żądanie
Żądanie HTTP
POST https://www.googleapis.com/youtube/v3/playlistItems
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. Określa właściwości, które ustawi operacja zapisu, oraz właściwości, które będzie uwzględniać odpowiedź interfejsu API.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
Podaj zasób playlistyItem w treści żądania. Dla tego zasobu:
-
Musisz określić 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, metoda zwróci zasób playlistyItem 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 |
---|---|---|
forbidden (403) |
playlistContainsMaximumNumberOfVideos |
Playlista zawiera już maksymalną dozwoloną liczbę elementów. |
forbidden (403) |
playlistItemsNotAccessible |
Żądanie nie ma uprawnień do wstawienia określonego elementu playlisty. |
invalidValue (400) |
invalidContentDetails |
Właściwość contentDetails w żądaniu jest nieprawidłowa. Prawdopodobna przyczyna jest to, ż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 polu snippet zasobu. |
invalidValue (400) |
invalidResourceType |
Parametr type podany dla identyfikatora zasobu nie jest obsługiwany w tej operacji. Identyfikator zasobu określa element dodawany do playlisty, np. youtube#video . |
invalidValue (400) |
manualSortRequired |
Żądanie próbuje określić pozycję elementu playlisty, ale playlista nie jest sortowana ręcznie. (Na przykład elementy na playliście 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 pozycja z playlisty miała określoną pozycję, najpierw musisz w jej ustawieniach zmienić opcję Kolejność na Ręcznie. Te ustawienia możesz dostosować 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. |
notFound (404) |
playlistNotFound |
Nie można znaleźć playlisty zidentyfikowanej za pomocą parametru playlistId żądania. |
notFound (404) |
videoNotFound |
Nie można znaleźć filmu, który chcesz 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 właściwość resourceId . |
invalidValue (400) |
playlistOperationUnsupported |
Interfejs API nie obsługuje funkcji wstawiania filmów na określonej playliście. Na przykład nie możesz wstawić filmu do przesłanej playlisty. |
Wypróbuj
Użyj APIs Explorer, aby wywołać ten interfejs API i wyświetlić żądanie oraz odpowiedź interfejsu API.