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