AgentEarth
登录

Ae · Youtube · Channels · List

1.00积分/次
ae_youtube_channels_list

通过用户名、句柄或 ID 查找 YouTube 频道详情。

社交视频娱乐
1.00积分/次

价格说明

1.00积分/次

API 调用

通过统一工具网关发起同步请求，鉴权和计费由 AgentEarth 处理。

cURL
curl --request POST \
  --url 'https://api.agentearth.ai/v1/tools/run' \
  --header 'Authorization: Bearer $AGENTEARTH_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "tool": "ae_youtube_channels_list",
  "input": {
    "hl": "xxx",
    "id": "xxx",
    "mine": "xxx",
    "part": "xxx",
    "forHandle": "xxx",
    "pageToken": "xxx",
    "categoryId": "xxx",
    "maxResults": "xxx",
    "forUsername": "xxx",
    "managedByMe": "xxx",
    "mySubscribers": "xxx",
    "onBehalfOfContentOwner": "xxx"
  }
}'
请求方式
POST
接口地址
/v1/tools/run
鉴权方式
Bearer Token
超时时间
60 秒
当前版本
—
响应示例
{
  "error_no": 0,
  "error_msg": "",
  "result": [
    {
      "type": "text",
      "text": "xxx"
    }
  ],
  "platform_annotations": {
    "source": "AgentEarth",
    "platform_note": "xxx",
    "platform_suggestion": "xxx"
  }
}

工具参数

未传入的可选参数将使用平台默认值。

参数类型必填说明默认值
hlstring否Stands for "host language". Specifies the localization language of the metadata to be filled into snippet.localized. The field is filled with the default metadata if there is no localization in the specified language. The parameter value must be a language code included in the list returned by the i18nLanguages.list method (e.g. en_US, es_MX).—
idstring否Return the channels with the specified IDs.—
mineboolean否Return the ids of channels owned by the authenticated user.—
partstring是The *part* parameter specifies a comma-separated list of one or more channel 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 channel resource, the contentDetails property contains other properties, such as the uploads properties. As such, if you set *part=contentDetails*, the API response will also contain all of those nested properties.—
forHandlestring否Return the channel associated with a YouTube handle.—
pageTokenstring否Optional opaque pagination token. Omit on the first request. To fetch the next page, copy nextPageToken exactly from the previous response into pageToken and call this same endpoint again, keeping the playlist/channel/video identifiers, filters, part and other query settings unchanged. Use prevPageToken to go back when provided. Do not invent tokens or use a token from another query. Stop when nextPageToken is absent; no nextPageToken means no further page is advertised, even if a page contains fewer items than maxResults.—
categoryIdstring否Return the channels within the specified guide category ID.—
maxResultsinteger否Maximum number of items requested per page, not a limit on the total query results. Use nextPageToken as pageToken to retrieve subsequent pages when available. Official documentation lists 0 to 50. Direct API tests with a single channel id accepted 0 through 200; that lookup does not establish the maximum page size for multi-channel results.—
forUsernamestring否Return the channel associated with a YouTube username.—
managedByMeboolean否Return the channels managed by the authenticated user.—
mySubscribersboolean否Return the channels subscribed to the authenticated user—
onBehalfOfContentOwnerstring否*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.—