Adunits.customchannels: list

需要授权

列出指定广告单元所属的所有自定义渠道。立即尝试

请求

HTTP请求

GET https://www.googleapis.com/adsense/v1.4/adclients/adClientId/adunits/adUnitId/customchannels

参数

参数名称 说明
路径参数
adClientId string 包含广告单元的广告客户。
adUnitId string 要为其列出自定义渠道的广告单元。
可选查询参数
maxResults integer 此响应中可包含的自定义渠道数量上限,用于分页。可接受的值包括010000(含0和10000)。
pageToken string 用于对自定义渠道进行分页的延续令牌。要检索下一页,请将此参数设置为上一个响应中的“nextPageToken”的值。

授权

此请求至少需要获得下列其中一个范围的授权(详细了解身份验证和授权)。

范围
https://www.googleapis.com/auth/adsense
https://www.googleapis.com/auth/adsense.readonly

请求正文

不要使用此方法提供请求正文。

响应

如果成功,此方法将返回具有以下结构的响应正文:

{
  "kind": "adsense#customChannels",
  "etag": etag,
  "nextPageToken": string,
  "items": [
    {
      "kind": "adsense#customChannel",
      "id": string,
      "code": string,
      "name": string,
      "targetingInfo": {
        "adsAppearOn": string,
        "location": string,
        "description": string,
        "siteLanguage": string
      }
    }
  ]
}
属性名称 说明 备注
kind string 此列表的种类,在此示例中为adsense#customChannels。
etag etag 此响应的ETag,用于进行缓存。
nextPageToken string 用于对自定义渠道进行分页的延续令牌。要检索下一页结果,请将下一个请求的“pageToken”值设置为此值。
items[] list 此列表响应中返回的自定义渠道。
items[].kind string 此资源的种类,在此示例中为adsense#customChannel。
items[].id string 此自定义渠道的唯一标识符。它应该被视为一个不透明的标识符;如果使用任何特殊格式,则不能完全依靠它来进行标识。
items[].code string 此自定义渠道的代码,不必在多个广告客户之间保持唯一。
items[].name string 此自定义渠道的名称。
items[].targetingInfo object 此自定义渠道的定位信息(如果已启用)。
items[].targetingInfo.adsAppearOn string 用来从外部描述此渠道的名称。
items[].targetingInfo.location string 展示广告的位置(仅对内容广告和移动内容广告有效)。内容广告可接受的值为:TOP_LEFT、TOP_CENTER、TOP_RIGHT、MIDDLE_LEFT、MIDDLE_CENTER、MIDDLE_RIGHT、BOTTOM_LEFT、BOTTOM_CENTER、BOTTOM_RIGHT和MULTIPLE_LOCATIONS。移动内容广告可接受的值为:TOP、MIDDLE、BOTTOM和MULTIPLE_LOCATIONS。

可接受的值为:
  • "BOTTOM":
  • "BOTTOM_CENTER":
  • "BOTTOM_LEFT":
  • "BOTTOM_RIGHT":
  • "MIDDLE":
  • "MIDDLE_CENTER":
  • "MIDDLE_LEFT":
  • "MIDDLE_RIGHT":
  • "MULTIPLE_LOCATIONS":
  • "TOP":
  • "TOP_CENTER":
  • "TOP_LEFT":
  • "TOP_RIGHT":
items[].targetingInfo.description string 此渠道的外部说明。
items[].targetingInfo.siteLanguage string 展示广告的网站所使用的语言。

立即尝试!

请使用下面的API Explorer针对实际数据调用此方法并查看响应。

发送以下问题的反馈:

此网页
AdSense Management API
AdSense Management API