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

一组设备。

设备组由一组设备选择器定义。如果某个设备匹配某设备组中的任一选择器（逻辑“或”），则该设备就属于此设备组。

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

string

群组的名称。
deviceSelectors[]

object (DeviceSelector)

相应群组的设备选择器。匹配该设备组中任一选择器的设备均会纳入该设备组。

DeviceSelector

设备组的选择器。选择器包括一组条件，设备必须匹配所有条件（逻辑“与”）方可纳入相应设备组。

例如，如果选择器指定 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

设备的标识符。

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 的设计者，例如build 属性“ro.soc.manufacturer”的“Google”值 https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER 必需。
model

string

必需。SoC 的型号，例如 build 属性“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 作为该设备的层级。不得在此配置中显式定义级别 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）是否正确。
409 concurrentUpdate 尝试更新正在并发更新的对象。 使用指数退避算法重试请求。避免同时修改同一资源。
5xx Generic error Google Play 服务器中的一般错误。 请重试您的请求。

如果问题仍然存在，请与您的 Google Play 客户经理联系，或提交支持请求。不妨查看 Play 状态信息中心，了解是否存在任何已知的服务中断。