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))

這個中介服務群組用於放送廣告的中介服務線。

Key 是中介服務群組行的 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)

這個參數可用於根據廣告識別碼的提供狀況指定廣告請求。如果設為「全部」，中介服務群組適用於所有廣告請求 (無論是否包含廣告識別碼)。如果設為「可用」，中介服務群組適用於包含廣告識別碼的廣告請求。如果設為 NOT_AVAILABLE，中介服務群組適用於沒有廣告識別碼的廣告請求。不需要為 Android 裝置指定。

IdfaTargeting

iOS 裝置廣告識別碼的可用性。

列舉
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 帳戶下的指定中介服務群組。