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 下限 (包含已綁定記憶體)。

maxBytes

string (int64 format)

以位元組為單位的 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

傳回已建立的裝置層級設定,並依建立時間由晚至早排序。