Thumbnails: set

Przesyła niestandardową miniaturę filmu do YouTube i ustawia ją dla filmu.

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

  • Maksymalny rozmiar pliku: 50 MB
  • Akceptowane typy MIME multimediów: image/jpeg, image/png, application/octet-stream

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

Częste zastosowania

Żądanie

Żądanie HTTP

POST https://www.googleapis.com/upload/youtube/v3/thumbnails/set

Autoryzacja

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

Zakres
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube.upload
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
videoId string
Parametr videoId określa identyfikator filmu w YouTube, dla którego podawana jest niestandardowa miniatura.
Parametry opcjonalne
onBehalfOfContentOwner string
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 CMS 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 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. Rzeczywiste 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

Treść żądania zawiera przesyłany obraz miniatury. Treść żądania nie zawiera zasobu thumbnail.

Odpowiedź

Jeśli operacja się uda, ta metoda zwróci treść odpowiedzi o tej strukturze:

{
  "kind": "youtube#thumbnailSetResponse",
  "etag": etag,
  "items": [
    thumbnail resource
  ]
}

Właściwości

W tabeli poniżej znajdziesz definicje właściwości, które pojawiają się w tym zasobie:

Właściwości
kind string
Określa typ zasobu interfejsu API. Wartość to youtube#thumbnailSetResponse.
etag etag
Etag tego zasobu.
items[] list
Lista miniatur.

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
badRequest (400) invalidImage Podana treść obrazu jest nieprawidłowa.
badRequest (400) mediaBodyRequired Żądanie nie zawiera treści obrazu.
forbidden (403) forbidden Nie można ustawić miniatury dla określonego filmu. Żądanie może nie być prawidłowo autoryzowane.
forbidden (403) forbidden Uwierzytelniony użytkownik nie ma uprawnień do przesyłania i ustawiania niestandardowych miniatur filmów.
notFound (404) videoNotFound Nie można znaleźć filmu, do którego próbujesz wstawić miniaturę. Sprawdź wartość parametru videoId w żądaniu, aby upewnić się, że jest prawidłowa.
tooManyRequests (429) uploadRateLimitExceeded Kanał przesłał ostatnio zbyt wiele miniatur. Spróbuj ponownie później.

Wypróbuj

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