Aktualizujemy interfejs Data API, aby był zgodny ze sposobem zliczania przez YouTube wyświetleń filmów Short.
Więcej informacji
PlaylistImages: insert
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
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:
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2024-08-16 UTC.
[null,null,["Ostatnia aktualizacja: 2024-08-16 UTC."],[[["\u003cp\u003eThis API method adds an image to a playlist, supporting media uploads with a maximum file size of 2MB and a 1:1 aspect ratio, and only accepts \u003ccode\u003eimage/jpeg\u003c/code\u003e and \u003ccode\u003eimage/png\u003c/code\u003e MIME types.\u003c/p\u003e\n"],["\u003cp\u003eUsing this method requires authorization with scopes such as \u003ccode\u003ehttps://www.googleapis.com/auth/youtubepartner\u003c/code\u003e, \u003ccode\u003ehttps://www.googleapis.com/auth/youtube\u003c/code\u003e, or \u003ccode\u003ehttps://www.googleapis.com/auth/youtube.force-ssl\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003epart\u003c/code\u003e parameter is required to specify the \u003ccode\u003eplaylistImage\u003c/code\u003e resource properties to be included in the API response.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eonBehalfOfContentOwner\u003c/code\u003e and \u003ccode\u003eonBehalfOfContentOwnerChannel\u003c/code\u003e parameters are available for YouTube content partners managing multiple channels to authenticate once and access data across all channels.\u003c/p\u003e\n"],["\u003cp\u003eThe request body requires a \u003ccode\u003eplaylistImages\u003c/code\u003e resource with \u003ccode\u003esnippet.playlistId\u003c/code\u003e and \u003ccode\u003esnippet.type\u003c/code\u003e, and it can include optional \u003ccode\u003esnippet.width\u003c/code\u003e and \u003ccode\u003esnippet.height\u003c/code\u003e properties.\u003c/p\u003e\n"]]],["To add an image to a playlist, send a POST request to `https://www.googleapis.com/youtube/v3/playlistImages`, ensuring authorization with appropriate scopes. Uploaded images must be square (1:1 aspect ratio), under 2MB, and be either JPEG or PNG. The request requires the `part` parameter, and the request body must include `snippet.playlistId` and `snippet.type`. Optional parameters include `onBehalfOfContentOwner` and `onBehalfOfContentOwnerChannel`. A successful call returns a `playlistImages` resource and has a quota cost of 50 units.\n"],null,["# PlaylistImages: insert\n\nAdds an image to a playlist.\n\nThis method supports media upload. Uploaded files must conform to these constraints:\n\n- **Maximum file size:** 2MB\n- **Accepted aspect ratio:** 1:1 (square)\n- **Accepted Media MIME types:** `image/jpeg`, `image/png`\n\n**Quota impact:** A call to this method has a [quota cost](/youtube/v3/getting-started#quota) of 50 units.\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/youtube/v3/playlistImages\n```\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes ([read more about authentication and authorization](/youtube/v3/guides/authentication)).\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/youtubepartner` |\n| `https://www.googleapis.com/auth/youtube` |\n| `https://www.googleapis.com/auth/youtube.force-ssl` |\n\n### Parameters\n\nThe following table lists the parameters that this query supports. All of the parameters listed are query parameters.\n\n| Parameters ||\n|---------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| **Required parameters** |||\n| `part` | `string` The **part** parameter specifies a comma-separated list of one or more `playlistImage` resource properties that the API response will include. If the parameter identifies a property that contains child properties, the child properties will be included in the response. |\n| **Optional parameters** |||\n| `onBehalfOfContentOwner` | `string` This parameter can only be used in a properly [authorized request](/youtube/v3/guides/authentication). **Note:** This parameter is intended exclusively for YouTube content partners. The **onBehalfOfContentOwner** parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner. |\n| `onBehalfOfContentOwnerChannel` | `string` This parameter can only be used in a properly [authorized request](/youtube/v3/guides/authentication). **Note:** This parameter is intended exclusively for YouTube content partners. \u003cbr /\u003e The **onBehalfOfContentOwnerChannel** parameter specifies the YouTube channel ID of the channel to which a video is being added. This parameter is required when a request specifies a value for the `onBehalfOfContentOwner` parameter, and it can only be used in conjunction with that parameter. In addition, the request must be authorized using a CMS account that is linked to the content owner that the `onBehalfOfContentOwner` parameter specifies. Finally, the channel that the `onBehalfOfContentOwnerChannel` parameter value specifies must be linked to the content owner that the `onBehalfOfContentOwner` parameter specifies. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and perform actions on behalf of the channel specified in the parameter value, without having to provide authentication credentials for each separate channel. |\n\n### Request body\n\nProvide a [playlistImages resource](/youtube/v3/docs/playlistImages#resource) in the request body.\n\nFor that resource:\n\n- You must specify a value for these properties:\n\n - `snippet.playlistId`\n - `snippet.type`\n- You can set values for these properties:\n\n - `snippet.width`\n - `snippet.height`\n\nResponse\n--------\n\nIf successful, this method returns a [playlistImages resource](/youtube/v3/docs/playlistImages#resource) in the response body."]]
