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 條件，且符合其中一個要納入的裝置型號，且不符合要排除的裝置型號

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

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

錯誤代碼

這項資源的作業會傳回下列 HTTP 錯誤碼：

錯誤代碼 原因 解析度
5xx Google Play 伺服器發生一般錯誤。 重試要求。

如果問題持續發生，請與 Google Play 帳戶管理員聯絡，或提交支援要求。 建議查看 Play 狀態資訊主頁，瞭解是否有已知服務中斷情形。
409 並行更新錯誤。

嘗試更新正在更新的物件。舉例來說，購買交易同時透過呼叫 Play 帳款服務程式庫的 acknowledgePurchase() 方法和 Play Developer API 的 purchases.products.acknowledge 進行確認。

 重試要求。