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)

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

IdfaTargeting

iOS 裝置的廣告識別碼提供狀況。

列舉
IDFA_TARGETING_UNSPECIFIED 預設值。這個值未使用。
ALL 不論廣告識別碼提供狀況為何，系統都會指定所有裝置。
AVAILABLE 只會指定提供廣告識別碼提供狀況的裝置。
NOT_AVAILABLE 系統只會指定沒有廣告識別碼提供狀況的裝置。

狀態

中介服務群組可用的狀態類型。

列舉
STATE_UNSPECIFIED 未設定欄位的預設值。請勿使用。
ENABLED 中介服務群組有效，可供放送廣告或收集統計資料。
DISABLED 中介服務群組已停用，不再放送廣告或收集統計資料。已停用的中介服務群組可重新啟用。

ExperimentState

中介服務群組的中介服務 A/B 實驗狀態。

列舉
EXPERIMENT_STATE_UNSPECIFIED 未設定欄位的預設值。請勿使用。
RUNNING 中介服務群組有處於「執行中」狀態的實驗。
NOT_RUNNING 中介服務群組中沒有任何處於「執行中」狀態的實驗。

方法

create

 在特定 AdMob 帳戶下建立中介服務群組。

list

 列出指定 AdMob 帳戶下的中介服務群組。

patch

 更新指定 AdMob 帳戶下的指定中介服務群組。