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)

您可以使用這個參數，根據廣告識別碼的提供狀況指定廣告請求。如果設為「ALL」，中介服務群組會套用至所有廣告請求 (無論是否包含廣告識別碼)。如果設為 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 帳戶下的指定中介服務群組。