REST Resource: accounts.mediationGroups

资源：MediationGroup

描述 AdMob 中介组。

JSON 表示法 
{
  "name": string,
  "mediationGroupId": string,
  "displayName": string,
  "targeting": {
    object (MediationGroupTargeting)
  },
  "state": enum (State),
  "mediationGroupLines": {
    string: {
      object (MediationGroupLine)
    },
    ...
  },
  "mediationAbExperimentState": enum (ExperimentState)
}
字段
name

string

相应中介组的资源名称。格式为：accounts/{publisherId}/mediationGroups/{mediationGroupId} 示例：accounts/pub-9876543210987654/mediationGroups/0123456789
mediationGroupId

string

中介组的 ID。示例：“0123456789”。此属性为只读属性。
displayName

string

用户为中介组提供的名称。允许的最大长度为 120 个字符。
targeting

object (MediationGroupTargeting)

相应中介组定位的一组条件，例如广告单元和地理位置。
state

enum (State)

中介组的状态。系统只会投放已启用的中介组。
mediationGroupLines

map (key: string, value: object (MediationGroupLine))

用于为此中介组投放广告的中介广告资源。

键是中介组行的 ID。对于创建，请使用不同的负值作为占位符。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
mediationAbExperimentState

enum (ExperimentState)

仅限输出。相应中介组所属的中介 A/B 实验的状态。

MediationGroupTargeting

相应中介组定位到的一组条件。例如，中介组可以定位到特定的广告单元 ID、平台、广告格式和地理位置。

JSON 表示法 
{
  "platform": string,
  "format": string,
  "adUnitIds": [
    string
  ],
  "targetedRegionCodes": [
    string
  ],
  "excludedRegionCodes": [
    string
  ],
  "idfaTargeting": enum (IdfaTargeting)
}
字段
platform

string

描述应用的平台。示例：“IOS”“ANDROID”。
format

string

相应中介组定位的广告格式。示例：“banner”“native”。
adUnitIds[]

string

相应中介组定位的广告单元。示例：“ca-app-pub-1234/8790”。
targetedRegionCodes[]

string

位置的 Unicode 国家/地区代码 (CLDR)，例如“US”。如果此中介组面向所有可用地区，则不设置。如需了解详情，请参阅 http://www.unicode.org/reports/tr35/#unicode_region_subtag。
excludedRegionCodes[]

string

位置的 Unicode 国家/地区代码 (CLDR)，例如“US”。如果相应中介组未排除任何地区，则不设置。
idfaTargeting

enum (IdfaTargeting)

该参数可用于根据是否带有 IDFA 来定位广告请求。如果设置为 ALL，则该中介组会应用于所有广告请求（无论是否带有 IDFA）。如果设置为 AVAILABLE，该中介组将应用于带有 IDFA 的广告请求。如果设置为 NOT_AVAILABLE，则该中介组将应用于不带 IDFA 的广告请求。无需为 Android 设备指定。

IdfaTargeting

iOS 设备的 IDFA 可用性。

枚举
IDFA_TARGETING_UNSPECIFIED 默认值。此值未使用。
ALL 无论 IDFA 是否可用，所有设备都是定位目标。
AVAILABLE 系统只会定位 IDFA 可用的设备。
NOT_AVAILABLE 仅定位无法获取 IDFA 的设备。

州

中介组可用的状态类型。

枚举
STATE_UNSPECIFIED 这是未设置字段的默认值。请勿使用。
ENABLED 中介组处于有效状态，用于投放广告或收集统计信息。
DISABLED 中介组已停用，不再投放广告或收集统计信息。已停用的中介组可以重新启用。

ExperimentState

中介组的中介 A/B 实验状态。

枚举
EXPERIMENT_STATE_UNSPECIFIED 这是未设置字段的默认值。请勿使用。
RUNNING 中介组有处于 RUNNING 状态的实验。
NOT_RUNNING 中介组中没有处于“正在运行”状态的实验。

方法

create

 在特定 AdMob 账号下创建中介组。

list

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

patch

 更新指定 AdMob 账号下的指定中介组。