Sponsors
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Nota: questa risorsa è deprecata dal 31 marzo 2020. È stato sostituito dalla risorsa
member
. Puoi trovare informazioni sulla risorsa nella documentazione dell'API YouTube Data.
Nell'ambito di questo ritiro, il metodo
sponsors.list
non sarà più supportato a partire dal 30 settembre 2020. I client API devono aggiornare le chiamate al metodo
sponsors.list
per utilizzare il metodo
members.list
.
Una risorsa sponsor
rappresenta un abbonato al canale (in precedenza noto come "sponsor") di un canale YouTube.
Un membro fornisce un supporto monetario ricorrente a un creator e riceve vantaggi speciali. Ad esempio, gli abbonati possono chattare quando il creator attiva la modalità riservata agli abbonati per una chat.
Metodi
L'API supporta i seguenti metodi per le risorse di sponsors
:
- list
- Elenca gli sponsor di un canale. La richiesta API deve essere autorizzata dal proprietario del canale.
Prova subito.
Proprietà
La tabella seguente definisce le proprietà che vengono visualizzate in questa risorsa:
Proprietà |
kind |
string
Identifica il tipo di risorsa API. Il valore sarà youtube#sponsor . |
etag |
etag
L'Etag di questa risorsa. |
id |
string
L'ID assegnato da YouTube per identificare in modo univoco lo sponsor. |
snippet |
object
L'oggetto snippet contiene dettagli sullo sponsor. |
snippet.channelId |
string
Questo ID identifica il canale sponsorizzato. |
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2023-02-22 UTC.
[null,null,["Ultimo aggiornamento 2023-02-22 UTC."],[[["\u003cp\u003eThis \u003ccode\u003esponsors\u003c/code\u003e resource is deprecated as of March 31, 2020, and has been replaced by the \u003ccode\u003emember\u003c/code\u003e resource, with the \u003ccode\u003esponsors.list\u003c/code\u003e method no longer supported after September 30, 2020.\u003c/p\u003e\n"],["\u003cp\u003eA \u003ccode\u003esponsor\u003c/code\u003e resource represents a YouTube channel member who provides recurring monetary support and receives special benefits.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003esponsors.list\u003c/code\u003e method allowed API clients to list the sponsors for a channel, but now they should use \u003ccode\u003emembers.list\u003c/code\u003e instead.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003esponsors\u003c/code\u003e resource contains properties such as \u003ccode\u003ekind\u003c/code\u003e, \u003ccode\u003eetag\u003c/code\u003e, \u003ccode\u003eid\u003c/code\u003e, and \u003ccode\u003esnippet\u003c/code\u003e which includes detailed information like the channel ID, display name, profile image URL, and the date they became a sponsor.\u003c/p\u003e\n"]]],["The `sponsors` resource, representing channel members, was deprecated on March 31, 2020, and replaced by the `members` resource. The `sponsors.list` method will be unsupported after September 30, 2020, requiring API clients to use `members.list` instead. A sponsor provides recurring support and receives benefits. The resource contains properties such as `kind`, `etag`, `id`, and `snippet`. `snippet` include the channel's ID, details about the sponsor, and when the user became a sponsor.\n"],null,["# Sponsors\n\nNote: This resource is deprecated as of March 31, 2020. It has been replaced by the [member](/youtube/v3/docs/members) resource. You can find information about that resource in the YouTube Data API documentation. \n\nAs part of this deprecation, the `sponsors.list` method will no longer be supported on or after September 30, 2020. API clients should update calls to the `sponsors.list` method to use the [members.list](/youtube/v3/docs/members/list) method instead.\n\nA **sponsor** resource represents a channel member (formerly known as a \"sponsor\") for a YouTube channel.\nA member provides recurring monetary support to a creator and receives\nspecial benefits. For example, members are able to chat when the creator turns on members-only mode for a chat.\n\nMethods\n-------\n\nThe API supports the following methods for `sponsors` resources:\n\n[list](/youtube/v3/live/docs/sponsors/list)\n: Lists sponsors for a channel. The API request must be authorized by the channel owner.\n [Try it now](/youtube/v3/live/docs/sponsors/list#try-it).\n\nResource representation\n-----------------------\n\nThe following JSON structure shows the format of a `sponsors` resource: \n\n```text\n{\n \"kind\": \"youtube#sponsor\",\n \"etag\": etag,\n \"id\": string,\n \"snippet\": {\n \"channelId\": string,\n \"sponsorDetails\": {\n \"channelId\": string,\n \"channelUrl\": string,\n \"displayName\": string,\n \"profileImageUrl\": string\n },\n \"sponsorSince\": datetime\n }\n}\n```\n\n### Properties\n\nThe following table defines the properties that appear in this resource:\n\n| Properties ||\n|------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Identifies the API resource's type. The value will be `youtube#sponsor`. |\n| `etag` | `etag` The Etag of this resource. |\n| `id` | `string` The ID that YouTube assigns to uniquely identify the sponsor. |\n| `snippet` | `object` The `snippet` object contains details about the sponsor. |\n| snippet.`channelId` | `string` This ID identifies the channel being sponsored. |\n| snippet.`sponsorDetails` | `object` This object contains details about the sponsor. |\n| snippet.sponsorDetails.`channelId` | `string` The YouTube channel ID. |\n| snippet.sponsorDetails.`channelUrl` | `string` The channel's URL. |\n| snippet.sponsorDetails.`displayName` | `string` The channel's display name. |\n| snippet.sponsorDetails.`profileImageUrl` | `string` The channels's avatar URL. |\n| snippet.`sponsorSince` | `datetime` The date and time when the user became a sponsor. The value is specified in [ISO 8601](//www.w3.org/TR/NOTE-datetime) (`YYYY-MM-DDThh:mm:ss.sZ`) format. |"]]