Thumbnails: set

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

Ta metoda obsługuje przesyłanie multimediów. Przesył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 limitu: koszt limitu wywołania tej metody wynosi około 50 jednostek.

Typowe przypadki użycia

Żądanie

Żądanie HTTP

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

Upoważnienie

To żądanie wymaga autoryzacji przy użyciu 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

Tabela poniżej zawiera 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 filmu.
Parametry opcjonalne
onBehalfOfContentOwner string
Uwaga: ten parametr jest przeznaczony wyłącznie dla partnerów dostarczających treści do YouTube.

Parametr onBehalfOfContentOwner wskazuje, że dane logowania żądania autoryzacji wskazują użytkownika YouTube CMS, który działa w imieniu właściciela treści określonego w wartości parametru. Ten parametr jest przeznaczony dla partnerów w YouTube, którzy mają wiele różnych kanałów YouTube i nimi zarządzają. Umożliwia właścicielom treści uwierzytelnianie raz i uzyskiwanie dostępu do wszystkich danych dotyczących filmów oraz kanałów bez konieczności podawania danych uwierzytelniających dla każdego kanału. Faktyczne konto CMS, z którym użytkownik się uwierzytelnia, musi być połączone z określonym właścicielem treści w YouTube.

Treść żądania

Treść żądania zawiera miniaturę, którą przesyłasz. Treść żądania nie zawiera zasobu thumbnail.

Odpowiedź

Jeśli operacja się uda, metoda zwróci odpowiedź w następującym formacie:

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

Właściwości

Tabela poniżej określa właściwości wyświetlane w tym zasobie:

Właściwości
kind string
Określa typ zasobu interfejsu API. Wartość będzie wynosić 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 Dostarczona treść obrazu jest nieprawidłowa.
badRequest (400) mediaBodyRequired Żądanie nie zawiera treści graficznych.
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, 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 ponownie wysłać żądanie później.

Wypróbuj

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