PlaylistImages: insert

Dodaje obraz do playlisty.

Ta metoda obsługuje przesyłanie multimediów. Przesyłane pliki muszą spełniać te ograniczenia:

  • Maksymalny rozmiar pliku: 2 MB
  • Akceptowany format obrazu: 1:1 (kwadrat).
  • Akceptowane typy MIME multimediów: image/jpeg, image/png

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

Żądanie

Żądanie HTTP

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

Autoryzacja

To żądanie wymaga autoryzacji z co najmniej jednym z tych zakresów (więcej informacji o uwierzytelnianiu i autoryzowaniu).

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 określa rozdzielana przecinkami lista co najmniej jednego zasobu playlistImage właściwości, które będzie zawierać odpowiedź interfejsu API.

Jeśli parametr identyfikuje usługę, która zawiera usługi podrzędne, zostaną uwzględnione w odpowiedzi.
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 żądania identyfikują użytkownika systemu zarządzania treścią YouTube, który działa w imieniu właściciela treści określonego w wartości parametru. Ten parametr jest przeznaczony dla dostawców treści w YouTube, którzy są właścicielami wielu różnych kanałów YouTube i nimi zarządzają. Dzięki niej właściciele treści mogą dokonać uwierzytelnienia raz i uzyskać dostęp do wszystkich danych dotyczących filmów i kanału 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 YouTube.
onBehalfOfContentOwnerChannel 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.

onBehalfOfContentOwnerChannel parametr określa identyfikator kanału YouTube, na którym jest umieszczony film – dodano. Ten parametr jest wymagany, gdy żądanie określa wartość dla onBehalfOfContentOwner i można go używać tylko w w połączeniu z tym parametrem. Ponadto żądanie musi być autoryzowane za pomocą konta CMS połączonego z właścicielem treści, Parametr onBehalfOfContentOwner określa wartość. Pamiętaj też, że kanał, w którym wartość parametru onBehalfOfContentOwnerChannel określa, że musi być powiązany z właścicielem treści, Parametr onBehalfOfContentOwner określa wartość.

To jest przeznaczony dla partnerów dostarczających treści YouTube, którzy są właścicielami wielu na różnych kanałach YouTube. Umożliwia właścicielom treści jednorazowe uwierzytelnianie i wykonywać działania w imieniu kanału określonego w parametrze bez konieczności podawania danych uwierzytelniających przy każdym oddzielnym kanale.

Treść żądania

Udostępnij zasób playlistImages w treści żądania.

W przypadku tego zasobu:

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

    • snippet.playlistId
    • snippet.type

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

    • snippet.width
    • snippet.height

Odpowiedź

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