PlaylistImages: insert

Dodaje obraz do playlisty.

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

  • Maksymalny rozmiar pliku: 50 MB
  • Dopuszczalny format obrazu: 1:1 (kwadrat)
  • Dopuszczalne typy MIME multimediów: image/jpeg, image/png

Wpływ na limit: wywołanie tej metody kosztuje 50 jednostek limitu.

Żą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 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 określa rozdzieloną przecinkami listę co najmniej 1 właściwości zasobu playlistImage które zostaną uwzględnione w odpowiedzi interfejsu API.

Jeśli parametr identyfikuje właściwość, która zawiera właściwości podrzędne, te właściwości podrzędne zostaną uwzględnione w odpowiedzi.
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.

Parametr onBehalfOfContentOwner wskazuje, że dane uwierzytelniające autoryzację żądania identyfikują użytkownika systemu CMS YouTube, który działa w imieniu właściciela treści określonego w wartości parametru. Parametr `**onBehalfOfContentOwner**` wskazuje, że dane logowania autoryzacji żądania identyfikują użytkownika systemu zarządzania treścią w YouTube, który działa w imieniu właściciela treści określonego w wartości parametru. Umożliwia to właścicielom treści jednokrotne uwierzytelnienie i uzyskanie dostępu do wszystkich danych dotyczących ich filmów i kanałów bez konieczności podawania danych uwierzytelniających dla każdego pojedynczego kanału. Konto CMS, za pomocą którego uwierzytelnia się użytkownik, musi być połączone z określonym właścicielem treści w YouTube.
onBehalfOfContentOwnerChannel string
Ten parametr może być używany tylko w prawidłowo autoryzowanym żądaniu. `string` Uwaga: Ten parametr może być używany tylko w prawidłowo autoryzowanym żądaniu.

Parametr onBehalfOfContentOwnerChannel określa identyfikator kanału YouTube, do którego dodawany jest film. Ten parametr jest wymagany, gdy żądanie określa wartość parametru onBehalfOfContentOwner, i może być używany tylko w połączeniu z tym parametrem. Ponadto żądanie musi być autoryzowane przy użyciu konta CMS połączonego z właścicielem treści określonym w parametrze onBehalfOfContentOwner. Ponadto żądanie musi być autoryzowane za pomocą konta CMS połączonego z właścicielem treści określonym w parametrze onBehalfOfContentOwnerChannelonBehalfOfContentOwner.

Umożliwia to właścicielom treści jednokrotne uwierzytelnienie i wykonywanie działań w imieniu kanału określonego w wartości parametru, bez konieczności podawania danych uwierzytelniających dla każdego oddzielnego kanału.

Umożliwia on właścicielom treści jednorazowe uwierzytelnienie i wykonywanie działań w imieniu kanału określonego w wartości parametru bez konieczności podawania danych logowania do każdego kanału.

Treść żądania zawiera zasób playlistImages.

W treści żądania podaj zasób playlistImages.

  • W przypadku tego zasobu:

    • snippet.playlistId
    • snippet.type

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

    • snippet.width
    • snippet.height

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

Jeśli operacja się powiedzie, ta metoda zwraca zasób playlistImages w treści odpowiedzi.