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 錯誤碼：

錯誤代碼 原因 說明 解析度
400 invalidValue 要求中提供的值無效。如果購買權杖格式有誤或無效，通常會傳回這個錯誤。 根據 API 參考資料，更正要求主體或參數中的無效欄位值。
400 required 要求缺少必要欄位或參數。 請參閱 API 說明文件，確認已包含所有必填欄位和參數。
403 userInsufficientPermission 使用者沒有足夠的權限可執行要求作業。 確認已驗證的使用者在 Google Play 管理中心具備必要權限。詳情請參閱「 使用服務帳戶」。
404 notFound 找不到要求的資源。 確認 ID (例如購買憑證、套件名稱、產品 ID、訂閱 ID) 正確無誤。
409 concurrentUpdate 嘗試更新正在同步更新的物件。 以指數輪詢方式重試要求。請避免同時修改相同資源。
5xx Generic error Google Play 伺服器發生一般錯誤。 請重試要求。

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