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 )

تعریف مجموعه‌های کشور کاربر برای برنامه.

گروه دستگاه

گروهی از دستگاه‌ها.

یک گروه توسط مجموعه‌ای از انتخابگرهای دستگاه تعریف می‌شود. یک دستگاه در صورتی به گروه تعلق دارد که با هر انتخابگری (یا منطقی) مطابقت داشته باشد.

نمایش JSON 
{
  "name": string,
  "deviceSelectors": [
    {
      object (DeviceSelector)
    }
  ]
}
فیلدها
name

string

نام گروه.

deviceSelectors[]

object ( 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 )

شرایط مربوط به رم دستگاه.

includedDeviceIds[]

object ( DeviceId )

مدل‌های دستگاهی که توسط این انتخابگر لحاظ شده‌اند.

excludedDeviceIds[]

object ( DeviceId )

مدل‌های دستگاه توسط این انتخابگر مستثنی شده‌اند، حتی اگر با تمام شرایط دیگر مطابقت داشته باشند.

requiredSystemFeatures[]

object ( SystemFeature )

یک دستگاه باید تمام این ویژگی‌های سیستمی را داشته باشد تا توسط انتخابگر لحاظ شود.

forbiddenSystemFeatures[]

object ( SystemFeature )

دستگاهی که هر یک از این ویژگی‌های سیستم را داشته باشد، حتی اگر با تمام شرایط دیگر مطابقت داشته باشد، توسط این انتخابگر مستثنی می‌شود.

systemOnChips[]

object ( SystemOnChip )

اختیاری. SoC های موجود در این انتخابگر. فقط برای دستگاه‌های اندروید S+ کار می‌کند.

دستگاه رم

شرایط مربوط به قابلیت‌های رم یک دستگاه.

نمایش JSON 
{
  "minBytes": string,
  "maxBytes": string
}
فیلدها
minBytes

string ( int64 format)

حداقل رم (به بایت) (شامل محدودیت).

maxBytes

string ( int64 format)

حداکثر حافظه رم (به بایت) (بدون احتساب محدودیت‌ها).

شناسه دستگاه

شناسه یک دستگاه.

نمایش JSON 
{
  "buildBrand": string,
  "buildDevice": string
}
فیلدها
buildBrand

string

ارزش ساخت.برند.

buildDevice

string

مقدار Build.DEVICE.

ویژگی سیستم

نمایش یک ویژگی سیستم.

نمایش JSON 
{
  "name": string
}
فیلدها
name

string

نام ویژگی.

سیستم روی تراشه

نمایش یک سیستم روی تراشه (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، مثلاً "Tensor" مقدار ویژگی ساخت "ro.soc.model" https://developer.android.com/reference/android/os/Build#SOC_MODEL الزامی.

تنظیم سطح دستگاه

مجموعه‌ای از سطوح دستگاه.

یک مجموعه سطح (tier set) تعیین می‌کند که چه نوع محتوای برنامه برای یک دستگاه خاص، برای محتوای هدفمند برای دستگاه، ارائه شود.

شما باید به هر ردیف یک سطح اولویت اختصاص دهید، که ترتیب ارزیابی آنها توسط Play را تعیین می‌کند. برای جزئیات بیشتر به مستندات DeviceTier.level مراجعه کنید.

نمایش JSON 
{
  "deviceTiers": [
    {
      object (DeviceTier)
    }
  ]
}
فیلدها
deviceTiers[]

object ( DeviceTier )

رده‌های دستگاه متعلق به مجموعه.

دستگاه لایه

یک لایه دستگاه واحد.

دستگاه‌هایی که با هر یک از گروه‌های دستگاه در deviceGroupNames مطابقت داشته باشند، با آن لایه مطابقت داده می‌شوند.

نمایش JSON 
{
  "deviceGroupNames": [
    string
  ],
  "level": integer
}
فیلدها
deviceGroupNames[]

string

گروه‌هایی از دستگاه‌های موجود در این لایه. این گروه‌ها باید به صراحت در زیر deviceGroups در این پیکربندی تعریف شوند.

level

integer

سطح اولویت لایه.

لایه‌ها به ترتیب نزولی سطح ارزیابی می‌شوند: بالاترین سطح، بالاترین اولویت را دارد. بالاترین لایه‌ای که با یک دستگاه مشخص مطابقت دارد، برای آن دستگاه انتخاب می‌شود.

شما باید از یک محدوده پیوسته از سطوح برای سطوح خود در یک مجموعه سطوح استفاده کنید؛ سطوح سطوح در یک مجموعه سطوح باید منحصر به فرد باشند. به عنوان مثال، اگر مجموعه سطوح شما دارای 4 سطح (شامل پشتیبان سراسری) است، باید سطوح 1، 2 و 3 را در این پیکربندی تعریف کنید.

توجه: سطح ۰ به طور ضمنی به عنوان یک جایگزین سراسری تعریف شده و برای دستگاه‌هایی انتخاب می‌شود که با هیچ یک از سطوح تعریف شده در اینجا مطابقت ندارند. شما نباید سطح ۰ را به طور صریح در این پیکربندی تعریف کنید.

مجموعه کشور کاربر

مجموعه‌ای از کشورهای کاربر.

مجموعه‌ی کشورها تعیین می‌کند که چه نوع محتوایی از برنامه به یک مکان خاص ارائه شود.

نمایش 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 کاربر مجوز کافی برای انجام عملیات درخواستی را ندارد. مطمئن شوید که کاربر احراز هویت شده مجوزهای لازم را در کنسول گوگل پلی دارد. برای جزئیات بیشتر به بخش «استفاده از حساب کاربری سرویس» مراجعه کنید.
404 notFound منبع مورد نظر یافت نشد. تأیید کنید که شناسه‌ها (مثلاً توکن خرید، نام بسته، شناسه محصول، شناسه اشتراک) صحیح باشند.
409 concurrentUpdate تلاشی برای به‌روزرسانی شیء‌ای که به‌طور همزمان به‌روزرسانی می‌شود، صورت گرفته است. درخواست را با backoff نمایی دوباره امتحان کنید. از تغییرات همزمان در همان منبع خودداری کنید.
5xx Generic error خطای عمومی در سرور گوگل پلی. درخواست خود را دوباره امتحان کنید.

اگر مشکل همچنان ادامه داشت، با مدیر حساب Google Play خود تماس بگیرید یا درخواست پشتیبانی ارسال کنید. داشبورد وضعیت Play را برای هرگونه قطعی شناخته شده بررسی کنید.