REST Resource: applications.deviceTierConfigs

Ресурс: DeviceTierConfig

Настройки, описывающие критерии выбора устройств для показа контента приложения.

JSON-представление 
{
  "deviceTierConfigId": string,
  "deviceGroups": [
    {
      object (DeviceGroup)
    }
  ],
  "deviceTierSet": {
    object (DeviceTierSet)
  },
  "userCountrySets": [
    {
      object (UserCountrySet)
    }
  ]
}
Поля
deviceTierConfigId

string ( int64 format)

Только вывод. Идентификатор конфигурации уровня устройства.

deviceGroups[]

object ( DeviceGroup )

Определение групп устройств для приложения.

deviceTierSet

object ( DeviceTierSet )

Определение набора уровней устройств для приложения.

userCountrySets[]

object ( UserCountrySet )

Определение стран, используемых пользователями для приложения.

DeviceGroup

Группа устройств.

Группа определяется набором селекторов устройств. Устройство принадлежит к группе, если оно соответствует хотя бы одному из селекторов (логическое ИЛИ).

JSON-представление 
{
  "name": string,
  "deviceSelectors": [
    {
      object (DeviceSelector)
    }
  ]
}
Поля
name

string

Название группы.

deviceSelectors[]

object ( DeviceSelector )

Селекторы устройств для этой группы. Устройство, соответствующее любому из селекторов, входит в эту группу.

DeviceSelector

Селектор для группы устройств. Селектор представляет собой набор условий для устройства, которые должны совпадать (логическое И), чтобы определить соответствие группе устройств.

Например, если в селекторе указаны условия оперативной памяти, включение и исключение моделей устройств, устройство считается соответствующим, если: устройство соответствует условиям оперативной памяти И устройство соответствует одной из включенных моделей устройств И устройство не соответствует исключенным моделям устройств.

JSON-представление 
{
  "deviceRam": {
    object (DeviceRam)
  },
  "includedDeviceIds": [
    {
      object (DeviceId)
    }
  ],
  "excludedDeviceIds": [
    {
      object (DeviceId)
    }
  ],
  "requiredSystemFeatures": [
    {
      object (SystemFeature)
    }
  ],
  "forbiddenSystemFeatures": [
    {
      object (SystemFeature)
    }
  ],
  "systemOnChips": [
    {
      object (SystemOnChip)
    }
  ]
}
Поля
deviceRam

object ( DeviceRam )

Состояние оперативной памяти устройства.

includedDeviceIds[]

object ( DeviceId )

В этот список включены модели устройств.

excludedDeviceIds[]

object ( DeviceId )

Данный селектор исключает определенные модели устройств, даже если они соответствуют всем остальным условиям.

requiredSystemFeatures[]

object ( SystemFeature )

Для того чтобы устройство было включено в список рекомендуемых, оно должно обладать всеми этими системными функциями.

forbiddenSystemFeatures[]

object ( SystemFeature )

Устройство, обладающее хотя бы одной из этих системных характеристик, исключается из списка поддерживаемых устройств, даже если оно соответствует всем остальным условиям.

systemOnChips[]

object ( SystemOnChip )

Необязательно. В список поддерживаемых устройств входят процессоры SoC. Работает только с устройствами Android S+.

DeviceRam

Информация о возможностях оперативной памяти устройства.

JSON-представление 
{
  "minBytes": string,
  "maxBytes": string
}
Поля
minBytes

string ( int64 format)

Минимальный объем оперативной памяти в байтах (включая выделенный объем).

maxBytes

string ( int64 format)

Максимальный объем оперативной памяти в байтах (за исключением выделенной области).

Идентификатор устройства

Идентификатор устройства.

JSON-представление 
{
  "buildBrand": string,
  "buildDevice": string
}
Поля
buildBrand

string

Ценность Build.BRAND.

buildDevice

string

Значение Build.DEVICE.

Системная функция

Представление характеристики системы.

JSON-представление 
{
  "name": string
}
Поля
name

string

Название функции.

Система на чипе

Представление системы на кристалле (SoC) устройства Android. Может использоваться для устройств с прошивкой 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, например, "Tensor". Значение свойства сборки "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

 Возвращает созданные конфигурации уровней устройств, отсортированные по убыванию времени создания.

коды ошибок

При работе с этим ресурсом возвращаются следующие коды ошибок HTTP:

Код ошибки Причина Описание Разрешение
400 invalidValue В запросе было предоставлено недопустимое значение. Такая ошибка часто возникает при получении некорректного или недействительного токена покупки. Исправьте недопустимое значение поля в теле запроса или параметрах в соответствии со справочником API.
400 required В запросе отсутствует обязательное поле или параметр. Ознакомьтесь с документацией API, чтобы убедиться в наличии всех обязательных полей и параметров.
403 userInsufficientPermission У пользователя недостаточно прав для выполнения запрошенной операции. Убедитесь, что авторизованный пользователь имеет необходимые разрешения в консоли Google Play. Дополнительные сведения см. в разделе «Использование служебной учетной записи» .
404 notFound Запрошенный ресурс не найден. Убедитесь в правильности идентификаторов (например, токен покупки, название пакета, идентификатор продукта, идентификатор подписки).
409 concurrentUpdate Была предпринята попытка обновить объект, который обновляется одновременно с первым. Повторите запрос с экспоненциальной задержкой. Избегайте одновременных изменений одного и того же ресурса.
5xx Generic error Общая ошибка на сервере Google Play. Повторите запрос.

Если проблема не исчезнет, ​​обратитесь к своему менеджеру аккаунта Google Play или отправьте запрос в службу поддержки. Рекомендуем проверить панель состояния Play на наличие известных сбоев.