Modyfikuje element playlisty. Możesz na przykład zaktualizować pozycję elementu na playliście.
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/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 zawierać odpowiedź interfejsu API.Pamiętaj, że ta metoda zastąpi istniejące wartości dla wszystkich właściwości zmiennych, które są zawarte w dowolnych częściach określonych w wartości parametru. Na przykład element playlisty może określać czas rozpoczęcia i zakończenia określający czas odtwarzania filmu. Jeśli w ramach żądania zaktualizujesz element playlisty, który ustawia te wartości, a jego wartość parametru part zawiera część contentDetails , czas rozpoczęcia i zakończenia playlisty zostanie zaktualizowany do dowolnej wartości określonej w treści żądania. Jeśli treść żądania nie określa wartości, istniejące czasy rozpoczęcia i zakończenia zostaną usunięte i zastąpione ustawieniami domyślnymi.Ta lista zawiera nazwy part , które możesz uwzględnić w wartości parametru:
|
|
Parametry opcjonalne | ||
onBehalfOfContentOwner |
string Uwaga: parametr onBehalfOfContentOwner jest przeznaczony wyłącznie dla partnerów w zakresie treści w YouTube i może być używany tylko w przypadku odpowiednio autoryzowanego żądania.Ten parametr jest przeznaczony dla partnerów w sieci reklamowej YouTube, którzy mają wiele kanałów YouTube i zarządzają nimi. Umożliwia użytkownikom powiązanym z właścicielem treści uwierzytelnianie raz, a następnie może uzyskiwać dostęp do wszystkich filmów i kanału właściciela treści oraz zarządzać nimi bez konieczności podawania danych uwierzytelniających dla każdego kanału. Gdy ten parametr jest obecny, jego wartość identyfikuje właściciela treści, a w żądaniach autoryzacji znajduje się użytkownik YouTube, który jest upoważniony do występowania w imieniu właściciela treści. Konto, z którego użytkownik się uwierzytelnia, musi być połączone z określonym właścicielem treści w ustawieniach YouTube Studio. |
Treść żądania
Podaj zasób playlistyItem w treści żądania. Dla tego zasobu:
-
Musisz określić wartość tych właściwości:
id
snippet.playlistId
snippet.resourceId
-
Możesz ustawić wartości tych właściwości:
snippet.position
contentDetails.note
contentDetails.startAt
contentDetails.endAt
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, 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) |
playlistItemsNotAccessible |
Prośba nie jest prawidłowo autoryzowana do aktualizowania wskazanego elementu playlisty. |
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) |
invalidSnippet |
Żądanie nie określa prawidłowej właściwości snippet . |
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. |
notFound (404) |
playlistItemNotFound |
Nie można znaleźć playlisty z właściwością id żądania. |
notFound (404) |
playlistNotFound |
Nie można znaleźć playlisty zidentyfikowanej za pomocą parametru playlistId żądania. |
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) |
playlistItemIdRequired |
Aby wskazać element, który jest aktualizowany, playlista musi zawierać właściwość id . |
invalidValue (400) |
playlistOperationUnsupported |
Interfejs API nie obsługuje aktualizowania filmów na określonej playliście. Na przykład nie możesz zaktualizować filmu na przesłanej playliście. |
Wypróbuj
Użyj APIs Explorer, aby wywołać ten interfejs API i wyświetlić żądanie oraz odpowiedź interfejsu API.