Aktualizujemy interfejs Data API, aby był zgodny ze sposobem zliczania przez YouTube wyświetleń filmów Short.
Więcej informacji
PlaylistImages: update
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Modyfikuje obraz playlisty.
Wpływ limitu: wywołanie tej metody ma limit wynoszący 50 jednostek.
Żądanie
Żądanie HTTP
PUT 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,
Uwaga: parametr onBehalfOfContentOwner jest przeznaczony wyłącznie dla dostawców treści w YouTube i można go użyć tylko w przypadku odpowiednio autoryzowanego żądania.
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ą. Umożliwia użytkownikom powiązanym z właścicielem treści jednorazowe uwierzytelnienie się, dzięki czemu mogą uzyskać dostęp do wszystkich danych filmów i kanałów właściciela treści oraz nimi zarządzać bez konieczności podawania danych uwierzytelniających każdego kanału.
Gdy jest dostępny parametr, jego wartość identyfikuje właściciela treści, a dane autoryzacji żądania identyfikują użytkownika YouTube, który jest upoważniony do działania w imieniu właściciela treści. Konto, za pomocą którego użytkownik się uwierzytelnia, musi być powiązane z określonym właścicielem treści w ustawieniach YouTube Studio. |
Treść żądania
Udostępnij zasób playlistImages w treści żądania.
W przypadku tego zasobu:
Odpowiedź
Jeśli operacja się uda, metoda zwróci zasób playlistItem w treści odpowiedzi.
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 method allows modification of a playlist image via the YouTube API.\u003c/p\u003e\n"],["\u003cp\u003eUtilizing this method incurs a quota cost of 50 units per call.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is required, 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 being necessary.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003epart\u003c/code\u003e parameter is required, while \u003ccode\u003eonBehalfOfContentOwner\u003c/code\u003e is an optional parameter intended for YouTube content partners.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must contain a \u003ccode\u003eplaylistImages\u003c/code\u003e resource with specified values for \u003ccode\u003esnippet.playlistId\u003c/code\u003e and \u003ccode\u003esnippet.type\u003c/code\u003e, and can optionally include \u003ccode\u003esnippet.width\u003c/code\u003e and \u003ccode\u003esnippet.height\u003c/code\u003e.\u003c/p\u003e\n"]]],["This outlines how to modify a playlist image via the YouTube API. A `PUT` request is sent to `playlistImages`, costing 50 quota units. Authorization is required, utilizing scopes like `youtubepartner`. The request needs the `part` parameter and can optionally include `onBehalfOfContentOwner`. The request body requires `snippet.playlistId` and `snippet.type` properties and can optionally have `snippet.width` and `snippet.height` set. A successful request returns a `playlistItem` resource.\n"],null,["# PlaylistImages: update\n\nModifies a playlist image.\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```\nPUT 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` **Note:** The **onBehalfOfContentOwner** parameter is intended exclusively for YouTube content partners and can only be used in a properly [authorized request](/youtube/v3/guides/authentication). This parameter is designed for YouTube content partners that own and manage many different YouTube channels. It enables users affiliated with the content owner to authenticate once and then be able to access and manage all of the content owner's video and channel data, without having to provide authentication credentials for each individual channel. When the parameter is present, its value identifies a content owner, and the request's authorization credentials identify a YouTube user who is authorized to act on behalf of that content owner. The account that the user authenticates with must be [linked to the specified content owner](https://support.google.com/youtube/answer/4524878) in the YouTube Creator Studio settings. |\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 [playlistItem resource](/youtube/v3/docs/playlistImages#resource) in the response body."]]
