Thumbnails: set

Przesyła niestandardową miniaturę do filmu w YouTube i ustawia ją jako film.

Ta metoda obsługuje przesyłanie multimediów. Przesłane pliki muszą być zgodne z tymi ograniczeniami:

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

Wpływ na limit: wywołanie tej metody ma koszt wynoszący około 50 jednostek.

Typowe przypadki użycia

Prośba

Żądanie HTTP

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

Upoważnienie

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 parametry obsługiwane 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 ma zostać podana niestandardowa miniatura filmu.
Parametry opcjonalne
onBehalfOfContentOwner string
Uwaga: ten parametr jest przeznaczony wyłącznie dla dostawców treści w YouTube.

Parametr onBehalfOfContentOwner wskazuje, że dane uwierzytelniające żądanie identyfikują użytkownika YouTube CMS działającego w imieniu właściciela treści określonego w wartości parametru. Jest on przeznaczony dla dostawców treści w YouTube, którzy mają wiele różnych kanałów w YouTube i nimi zarządzają. Dzięki niej właściciele treści mogą jednorazowo uwierzytelnić się i uzyskiwać dostęp do wszystkich swoich filmów oraz danych dotyczących kanałów bez konieczności podawania danych uwierzytelniających dla każdego kanału z osobna. Konto CMS, za pomocą którego użytkownik uwierzytelnia się, musi być powiązane z określonym właścicielem treści YouTube.

Treść żądania

Treść żądania zawiera przesyłaną miniaturę. Treść żądania nie zawiera zasobu thumbnail.

Odpowiedź

Jeśli operacja się uda, metoda zwróci odpowiedź o następującej strukturze:

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

Właściwości

Poniższa tabela przedstawia właściwości, które pojawiają się w tym zasobie:

Właściwości
kind string
Określa typ zasobu interfejsu API. Wartością będzie 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 szczegółów znajdziesz w dokumentacji komunikatów o błędach.

Typ błędu Szczegóły błędu Opis
badRequest (400) invalidImage Zawartość przesłanego obrazu jest nieprawidłowa.
badRequest (400) mediaBodyRequired Żądanie nie zawiera obrazów.
forbidden (403) forbidden Nie można ustawić miniatury dla określonego filmu. Żądanie może nie być poprawnie autoryzowane.
forbidden (403) forbidden Uwierzytelniony użytkownik nie ma uprawnień do przesyłania ani ustawiania niestandardowych miniatur filmów.
notFound (404) videoNotFound Nie można znaleźć filmu, dla którego próbujesz wstawić miniaturę. Sprawdź, czy wartość parametru videoId żądania jest prawidłowa.
tooManyRequests (429) uploadRateLimitExceeded Na kanał przesłano ostatnio zbyt wiele miniatur. Spróbuj przesłać prośbę ponownie później.

Wypróbuj

Użyj interfejsu APIs Explorer, aby wywołać ten interfejs API i wyświetlić żądanie oraz odpowiedź interfejsu API.