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

此中介组定位的广告格式。示例：“横幅广告”、“原生”。
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

广告标识符 (IDFA) 是否适用于 iOS 设备。

枚举
IDFA_TARGETING_UNSPECIFIED 默认值。此值未使用。
ALL 所有设备都已定位，无论有无广告标识符 (IDFA)。
AVAILABLE 仅定位具有 IDFA 适用范围的设备。
NOT_AVAILABLE 仅定位无法提供 IDFA 的设备。

状态

中介组可用的状态类型。

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

ExperimentState

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

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

方法

create

 在特定 AdMob 帐号下创建一个中介组。

list

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

patch

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