Method: accounts.mediationGroups.list

列出指定 AdMob 账号下的中介组。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。要列出其中介组的账号的资源名称。示例:accounts/pub-9876543210987654

查询参数

参数
pageSize

integer

要返回的中介组数量上限。如果未指定或 0,最多返回 10,000 个中介组。最大值为 20,000;高于 20,000 的值将被强制转换为 20,000。

pageToken

string

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

filter

string

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

  • "AD_SOURCE_IDS"
  • "AD_UNIT_IDS"
  • “APP_IDS”
  • “DISPLAY_NAME”
  • “FORMAT”
  • MEDIATION_GROUP_ID
  • "PLATFORM"
  • STATE
  • TARGETED_REGION_CODES

可能的过滤函数包括:

  • IN:用于过滤表示单例的字段,包括“MEDIATION_GROUP_ID”、“DISPLAY_NAME”、“STATE”、“PLATFORM”和“FORMAT”。
  • CONTAINS_ANY:用于过滤表示集合的字段,包括“AD_SOURCE_IDS”“AD_UNIT_IDS”“APP_IDS”和“TARGETED_REGION_CODES”。

您可以使用 AND 将这些过滤条件函数组合在一起。不支持 OR 功能。

示例:

过滤器:IN(DISPLAY_NAME, "Test Group 1", "Test Group 2") AND IN(PLATFORM, "ANDROID") AND CONTAINS_ANY(AD_SOURCE_IDS, "5450213213286189855")

请求正文

请求正文必须为空。

响应正文

对中介组列表请求的响应。

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

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

object (MediationGroup)

为所请求账号生成的中介组。

nextPageToken

string

如果不为空,则表示该请求可能还有更多中介组;此值应该在新的 ListMediationGroupsRequest 中传递。

授权范围

需要以下 OAuth 范围之一:

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

如需了解详情,请参阅 OAuth 2.0 概览