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 的型号,例如“Tensor”build 属性“ro.soc.model”的值 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

返回所创建的设备层级配置,按创建时间降序排列。