List YouTube channel subscriptions
youtube.x.youtube-subscriptions-listsubscriptions.list — Retrieves a list of resources, possibly filtered.
- 价格
- free按供应商原价
- 成功率
- —暂无成功率数据暂无成功率数据
- 延迟 p50
- ——
- 最后验证
- —尚未验证
GEThttps://toolswitch.dev/v1/tools/youtube.x.youtube-subscriptions-list预览- 可用平台额度调用
- 同步返回
- 读取公开数据
参数
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| 查询参数 | ||||
id | 字符串 | 可选 | Return the subscriptions with the given IDs for Stubby or Apiary. | |
mine | 布尔 | 可选 | Flag for returning the subscriptions of the authenticated user. | |
part | 字符串 | 必填 | 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 | 字符串 | 可选 | The order of the returned subscriptions | |
channelId | 字符串 | 可选 | Return the subscriptions of the given channel owner. | |
pageToken | 字符串 | 可选 | 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 | 整数 | 可选 | The *maxResults* parameter specifies the maximum number of items that should be returned in the result set. | |
forChannelId | 字符串 | 可选 | Return the subscriptions to the subset of these channels that the authenticated user is subscribed to. | |
mySubscribers | 布尔 | 可选 | Return the subscribers of the given channel owner. | |
myRecentSubscribers | 布尔 | 可选 | ||
onBehalfOfContentOwner | 字符串 | 可选 | *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 | 字符串 | 可选 | 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 | |
- 查询参数
id字符串可选Return the subscriptions with the given IDs for Stubby or Apiary.
mine布尔可选Flag for returning the subscriptions of the authenticated user.
part字符串必填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字符串可选The order of the returned subscriptions
channelId字符串可选Return the subscriptions of the given channel owner.
pageToken字符串可选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整数可选The *maxResults* parameter specifies the maximum number of items that should be returned in the result set.
forChannelId字符串可选Return the subscriptions to the subset of these channels that the authenticated user is subscribed to.
mySubscribers布尔可选Return the subscribers of the given channel owner.
myRecentSubscribers布尔可选onBehalfOfContentOwner字符串可选*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字符串可选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
代码示例
将 $TOOLSWITCH_KEY 替换为你在控制台创建的密钥。
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());网关接口为预览版,地址与鉴权方式可能调整。 示例参数仅为样例数据。 调用按 free 计费,已含服务费。