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

デバイスの識別子。

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 の設計者(例: ビルド プロパティ「ro.soc.manufacturer」の値「Google」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

デバイス階層のセット。

階層セットは、デバイスをターゲットにしたコンテンツの提供を目的として、デバイスごとに配信されるアプリ コンテンツのバリエーションを決定します。

各層に優先度を割り当てる必要があります。優先度によって、Google 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 アカウント マネージャーにお問い合わせいただくか、サポート リクエストを送信してください。Google Play ステータス ダッシュボードで、既知のサービス停止がないか確認してください。

409 同時実行更新エラー。

更新中のオブジェクトを更新しようとしました。たとえば、Play Billing Library の acknowledgePurchase() メソッドを呼び出すと同時に、Play Developer API の purchases.products.acknowledge を呼び出すことで、購入が承認されます。

リクエストを再試行してください。