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 進行確認。

重試要求。