REST Resource: applications.deviceTierConfigs

資源：DeviceTierConfig

描述應用程式內容裝置指定條件的設定。

JSON 表示法 
{
  "deviceTierConfigId": string,
  "deviceGroups": [
    {
      object (DeviceGroup)
    }
  ],
  "deviceTierSet": {
    object (DeviceTierSet)
  },
  "userCountrySets": [
    {
      object (UserCountrySet)
    }
  ]
}
欄位
deviceTierConfigId

string (int64 format)

僅供輸出。裝置層級設定 ID。
deviceGroups[]

object (DeviceGroup)

應用程式的裝置群組定義。
deviceTierSet

object (DeviceTierSet)

定義應用程式適用的裝置層級組合。
userCountrySets[]

object (UserCountrySet)

定義應用程式的使用者國家/地區組合。

DeviceGroup

一組裝置。

群組是由一組裝置選取條件定義。如果裝置符合任一選取條件 (OR 邏輯)，就屬於該群組。

JSON 表示法 
{
  "name": string,
  "deviceSelectors": [
    {
      object (DeviceSelector)
    }
  ]
}
欄位
name

string

群組名稱。
deviceSelectors[]

object (DeviceSelector)

這個群組的裝置選取器。這個群組會納入符合任一選取條件的裝置。

DeviceSelector

裝置群組的選取器。選取條件包含一組裝置條件，這些條件都必須相符 (AND 邏輯)，才能判斷裝置群組是否符合資格。

舉例來說，如果選取條件指定 RAM 條件、要納入的裝置型號和要排除的裝置型號，則裝置必須符合以下條件，才會被視為相符：裝置符合 RAM 條件 AND 裝置符合其中一個納入的裝置型號 AND 裝置不符合排除的裝置型號

JSON 表示法 
{
  "deviceRam": {
    object (DeviceRam)
  },
  "includedDeviceIds": [
    {
      object (DeviceId)
    }
  ],
  "excludedDeviceIds": [
    {
      object (DeviceId)
    }
  ],
  "requiredSystemFeatures": [
    {
      object (SystemFeature)
    }
  ],
  "forbiddenSystemFeatures": [
    {
      object (SystemFeature)
    }
  ],
  "systemOnChips": [
    {
      object (SystemOnChip)
    }
  ]
}
欄位
deviceRam

object (DeviceRam)

裝置 RAM 的條件。
includedDeviceIds[]

object (DeviceId)

這個選取器所納入的裝置型號。
excludedDeviceIds[]

object (DeviceId)

這個選取條件排除的裝置型號，即使符合所有其他條件也一樣。
requiredSystemFeatures[]

object (SystemFeature)

裝置必須具備所有這些系統功能，才能納入選取器。
forbiddenSystemFeatures[]

object (SystemFeature)

即使裝置符合所有其他條件，只要具有這些系統功能，就會遭到這個選取條件排除。
systemOnChips[]

object (SystemOnChip)

(非必要) 這個選取器包含的 SoC。僅適用於 Android S+ 裝置。

DeviceRam

裝置 RAM 功能的條件。

JSON 表示法 
{
  "minBytes": string,
  "maxBytes": string
}
欄位
minBytes

string (int64 format)

以位元組為單位的最低 RAM (包含已繫結的 RAM)。
maxBytes

string (int64 format)

以位元組為單位的 RAM 上限 (已排除已綁定 RAM)。

DeviceId

裝置 ID。

JSON 表示法 
{
  "buildBrand": string,
  "buildDevice": string
}
欄位
buildBrand

string

Build.BRAND 的值。
buildDevice

string

Build.DEVICE 的值。

SystemFeature

系統功能的表示法。

JSON 表示法 
{
  "name": string
}
欄位
name

string

功能名稱。

SystemOnChip

Android 裝置的晶片系統 (SoC) 表示法。可用於指定 S+ 裝置。

JSON 表示法 
{
  "manufacturer": string,
  "model": string
}
欄位
manufacturer

string

必要欄位。SoC 的設計者，例如「Google」的「ro.soc.manufacturer」建構資源屬性值 https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER 為必填屬性。
model

string

必要欄位。SoC 型號，例如建構屬性「ro.soc.model」的值「Tensor」https://developer.android.com/reference/android/os/Build#SOC_MODEL 為必要屬性。

DeviceTierSet

一組裝置等級。

針對裝置指定的內容，層級集會決定要向特定裝置提供哪種應用程式內容。

您應為各個層級指派優先順序，以便 Play 評估時決定其順序。詳情請參閱 DeviceTier.level 的說明文件。

JSON 表示法 
{
  "deviceTiers": [
    {
      object (DeviceTier)
    }
  ]
}
欄位
deviceTiers[]

object (DeviceTier)

屬於該組的裝置階層。

DeviceTier

單一裝置層級。

系統會將符合 deviceGroupNames 中任一裝置群組的裝置視為符合該階層。

JSON 表示法 
{
  "deviceGroupNames": [
    string
  ],
  "level": integer
}
欄位
deviceGroupNames[]

string

這個層級包含的裝置群組。這些群組必須明確定義在該設定的 deviceGroups 下。
level

integer

等級的優先程度。

系統會依層級遞減順序評估等級：最高層級的等級優先順序最高。系統會為特定裝置選取與該裝置相符的最高等級。

在階層組合中，您應使用連續的等級範圍，且階層組合中的階層等級必須不重複。舉例來說，如果層級組合有 4 個層級 (包括全域預設值)，您應在這個設定中定義第 1、第 2 和第 3 層級。

注意：系統會隱含定義層級 0 為全域備用值，並選取與這裡明確定義的任何層級不相符的裝置。請勿在這個設定中明確定義層級 0。

UserCountrySet

一組使用者國家/地區。

國家/地區組合會決定要向特定地區提供哪種應用程式內容。

JSON 表示法 
{
  "name": string,
  "countryCodes": [
    string
  ]
}
欄位
name

string

國家/地區組合名稱。
countryCodes[]

string

代表國家/地區的國家/地區代碼清單。國家/地區代碼採用 ISO 3166 alpha-2 格式。例如：義大利為「IT」、喬治亞為「GE」。

方法

create

 為應用程式建立新的裝置階層設定。

get

 傳回特定裝置層級設定。

list

 傳回已建立的裝置層級設定，並依建立時間遞減排序。