Method: accounts.adUnits.adUnitMappings.list

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

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。拥有此广告单元映射集合的父级。格式:accounts/{publisherId}/adUnits/{adUnitId}

查询参数

参数
pageSize

integer

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

pageToken

string

从之前的 adUnitMappings.list 调用接收的页面令牌。利用其进行后续页面检索。

filter

string

使用 EBNF 语法语法的过滤条件字符串。要作为过滤条件的可能字段为:

  • “DISPLAY_NAME”

可能的过滤函数如下:

  • IN:用于过滤表示单例(包括“DISPLAY_NAME”)的字段。

您可以使用 AND 将过滤函数组合在一起。不支持“OR”功能。

例如:

过滤条件:IN(DISPLAY_NAME, "测试广告单元映射 1", "测试广告单元映射 2")

请求正文

请求正文必须为空。

响应正文

ListAdUnitMappingsRequest 的响应。

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

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

object (AdUnitMapping)

从指定帐号和广告单元映射的广告单元。

nextPageToken

string

用于在 ListAdUnitMappingsRequest 中设置 pageToken 以检索下一页。如果省略此字段,则不存在后续页面。

授权范围

需要以下 OAuth 范围之一:

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

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