List YouTube channel subscriptions
youtube.x.youtube-subscriptions-listsubscriptions.list — Retrieves a list of resources, possibly filtered.
- Price
- freePelo preço do provedor
- Success rate
- —Ainda não há dados da taxa de sucessoAinda não há dados da taxa de sucesso
- Latency p50
- ——
- Last verified
- —Not verified yet
GEThttps://toolswitch.dev/v1/tools/youtube.x.youtube-subscriptions-listPreview- Uses platform quota
- Synchronous response
- Reads public data
Parâmetros
| Parâmetro | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| Parâmetros de consulta | ||||
id | string | Opcional | Return the subscriptions with the given IDs for Stubby or Apiary. | |
mine | booleano | Opcional | Flag for returning the subscriptions of the authenticated user. | |
part | string | Obrigatório | The *part* parameter specifies a comma-separated list of one or more subscription 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. For example, in a subscription resou | |
order | string | Opcional | The order of the returned subscriptions | |
channelId | string | Opcional | Return the subscriptions of the given channel owner. | |
pageToken | string | Opcional | The *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved. | |
maxResults | inteiro | Opcional | The *maxResults* parameter specifies the maximum number of items that should be returned in the result set. | |
forChannelId | string | Opcional | Return the subscriptions to the subset of these channels that the authenticated user is subscribed to. | |
mySubscribers | booleano | Opcional | Return the subscribers of the given channel owner. | |
myRecentSubscribers | booleano | Opcional | ||
onBehalfOfContentOwner | string | Opcional | *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 inte | |
onBehalfOfContentOwnerChannel | string | Opcional | This parameter can only be used in a properly authorized request. *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwnerChannel* parameter specifies the YouTube channel ID of the channel to which a video is being added. This parameter is required whe | |
- Parâmetros de consulta
idstringOpcionalReturn the subscriptions with the given IDs for Stubby or Apiary.
minebooleanoOpcionalFlag for returning the subscriptions of the authenticated user.
partstringObrigatórioThe *part* parameter specifies a comma-separated list of one or more subscription 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. For example, in a subscription resou
orderstringOpcionalThe order of the returned subscriptions
channelIdstringOpcionalReturn the subscriptions of the given channel owner.
pageTokenstringOpcionalThe *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved.
maxResultsinteiroOpcionalThe *maxResults* parameter specifies the maximum number of items that should be returned in the result set.
forChannelIdstringOpcionalReturn the subscriptions to the subset of these channels that the authenticated user is subscribed to.
mySubscribersbooleanoOpcionalReturn the subscribers of the given channel owner.
myRecentSubscribersbooleanoOpcionalonBehalfOfContentOwnerstringOpcional*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 inte
onBehalfOfContentOwnerChannelstringOpcionalThis parameter can only be used in a properly authorized request. *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwnerChannel* parameter specifies the YouTube channel ID of the channel to which a video is being added. This parameter is required whe
Exemplos de código
Substitua $TOOLSWITCH_KEY pela chave criada no console.
curl -X GET 'https://toolswitch.dev/v1/tools/youtube.x.youtube-subscriptions-list' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"GET",
"https://toolswitch.dev/v1/tools/youtube.x.youtube-subscriptions-list",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/youtube.x.youtube-subscriptions-list", {
method: "GET",
headers: {
"X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
},
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());Esta API de gateway está em prévia; a URL e a autenticação podem mudar. Os parâmetros do exemplo são dados de amostra. As chamadas são cobradas a free, incluindo a taxa de serviço.