Method: accounts.adUnits.list

列出指定 AdMob 帐号下的广告单元。

HTTP 请求

GET https://admob.googleapis.com/v1beta/{parent=accounts/*}/adUnits

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。要列出其广告单元的帐号的资源名称。示例:accounts/pub-9876543210987654

查询参数

参数
pageSize

integer

要返回的广告单元数量上限。如果未指定或值为 0,则最多返回 10,000 个广告单元。最大值为 20,000;大于 20,000 的值将被强制转换为 20,000。

pageToken

string

最后一个 ListAdUnitsResponse 返回的值;表示这是先前 adUnits.list 调用的延续,并且系统应返回下一页数据。

请求正文

请求正文必须为空。

响应正文

对广告单元列表请求的响应。

如果成功,响应正文将包含结构如下的数据:

JSON 表示法
{
  "adUnits": [
    {
      object (AdUnit)
    }
  ],
  "nextPageToken": string
}
字段
adUnits[]

object (AdUnit)

为所请求帐号生成的广告单元。

nextPageToken

string

如果不为空,则表示可能有更多广告单元可满足相应请求;此值应在新的 ListAdUnitsRequest 中传递。

授权范围

需要以下 OAuth 范围之一:

  • https://www.googleapis.com/auth/admob.monetization
  • https://www.googleapis.com/auth/admob.readonly

有关详情,请参阅 OAuth 2.0 概览