REST Resource: edits.tracks

منبع: آهنگ

پیکربندی مسیر. منبعی برای TracksService.

نمایش JSON 
{
  "track": string,
  "releases": [
    {
      object (Release)
    }
  ]
}
فیلدها
track

string

شناسه مسیر.

آهنگ‌های فاکتور فرم یک پیشوند ویژه به عنوان شناسه دارند، برای مثال wear:production ، automotive:production .

اطلاعات بیشتر در مورد نام آهنگ

releases[]

object ( Release )

در یک درخواست خواندن، نشان دهنده تمام نسخه‌های فعال در مسیر است. در یک درخواست به‌روزرسانی، نشان دهنده تغییرات مورد نظر است.

انتشار

انتشار درون یک قطعه.

نمایش JSON 
{
  "name": string,
  "versionCodes": [
    string
  ],
  "releaseNotes": [
    {
      object (LocalizedText)
    }
  ],
  "status": enum (Status),
  "userFraction": number,
  "countryTargeting": {
    object (CountryTargeting)
  },
  "inAppUpdatePriority": integer
}
فیلدها
name

string

نام انتشار. لازم نیست منحصر به فرد باشد. اگر تنظیم نشود، نام از versionName فایل APK تولید می‌شود. اگر انتشار شامل چندین APK باشد، نام از تاریخ تولید می‌شود.

versionCodes[]

string ( int64 format)

کدهای نسخه همه APK های موجود در نسخه. باید شامل کدهای نسخه برای حفظ از نسخه‌های قبلی باشد.

releaseNotes[]

object ( LocalizedText )

شرحی از موارد جدید در این نسخه.

status

enum ( Status )

وضعیت انتشار.

userFraction

number

کسری از کاربرانی که واجد شرایط انتشار مرحله‌ای هستند. 0 < کسری < 1. فقط زمانی می‌توان آن را تنظیم کرد که وضعیت "در حال انجام" یا "متوقف" باشد.

countryTargeting

object ( CountryTargeting )

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

inAppUpdatePriority

integer

اولویت به‌روزرسانی درون‌برنامه‌ایِ نسخه. همه فایل‌های APK جدید اضافه شده در نسخه با این اولویت در نظر گرفته می‌شوند. می‌تواند مقادیری در محدوده [0، 5] را بپذیرد، که 5 بالاترین اولویت را دارد. پیش‌فرض 0 است. inAppUpdatePriority پس از انتشار، قابل به‌روزرسانی نیست. به https://developer.android.com/guide/playcore/in-app-updates مراجعه کنید.

متن محلی‌شده

متن محلی‌سازی شده به زبان داده شده.

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

string

کد محلی‌سازی زبان (یک برچسب زبانی BCP-47؛ برای مثال، "de-AT" برای آلمانی اتریشی).

text

string

متن به زبان داده شده.

وضعیت

وضعیت انتشار.

انوم‌ها
statusUnspecified وضعیت نامشخص.
draft فایل‌های APK این نسخه به کاربران ارائه نمی‌شود.
inProgress فایل‌های APK این نسخه به کسری از کاربران که توسط «userFraction» تعیین می‌شوند، ارائه می‌شود.
halted فایل‌های APK این نسخه دیگر به کاربران ارائه نخواهد شد. کاربرانی که از قبل این فایل‌های APK را دارند، تحت تأثیر قرار نمی‌گیرند.
completed این نسخه هیچ تغییر دیگری نخواهد داشت. فایل‌های APK آن برای همه کاربران ارائه می‌شود، مگر اینکه واجد شرایط دریافت فایل‌های APK نسخه جدیدتر باشند.

هدف‌گیری کشوری

مشخصات هدف‌گذاری کشوری.

نمایش JSON 
{
  "countries": [
    string
  ],
  "includeRestOfWorld": boolean
}
فیلدها
countries[]

string

کشورهای مورد هدف، که با کدهای دو حرفی CLDR مشخص شده‌اند.

includeRestOfWorld

boolean

«بقیه جهان» و همچنین کشورهای هدف را نیز در نظر بگیرید.

روش‌ها

create

 یک مسیر جدید ایجاد می‌کند.

get

 یک آهنگ دریافت می‌کند.

list

 تمام آهنگ‌ها را فهرست می‌کند.

patch

 یک آهنگ را وصله می‌کند.

update

 یک آهنگ را به‌روزرسانی می‌کند.

کدهای خطا

عملیات این منبع، کدهای خطای HTTP زیر را برمی‌گرداند:

کد خطا دلیل توضیحات وضوح تصویر
400 invalidValue مقدار نامعتبری در درخواست ارائه شده است. این اغلب به عنوان یک توکن خرید ناقص یا نامعتبر برگردانده می‌شود. مقدار فیلد نامعتبر را در بدنه درخواست یا پارامترها بر اساس مرجع API اصلاح کنید.
400 required یک فیلد یا پارامتر الزامی در درخواست وجود ندارد. برای اطمینان از وجود تمام فیلدها و پارامترهای اجباری، به مستندات API مراجعه کنید.
403 userInsufficientPermission کاربر مجوز کافی برای انجام عملیات درخواستی را ندارد. مطمئن شوید که کاربر احراز هویت شده مجوزهای لازم را در کنسول گوگل پلی دارد. برای جزئیات بیشتر به بخش «استفاده از حساب کاربری سرویس» مراجعه کنید.
404 notFound منبع مورد نظر یافت نشد. تأیید کنید که شناسه‌ها (مثلاً توکن خرید، نام بسته، شناسه محصول، شناسه اشتراک) صحیح باشند.
409 concurrentUpdate تلاشی برای به‌روزرسانی شیء‌ای که به‌طور همزمان به‌روزرسانی می‌شود، صورت گرفته است. درخواست را با backoff نمایی دوباره امتحان کنید. از تغییرات همزمان در همان منبع خودداری کنید.
5xx Generic error خطای عمومی در سرور گوگل پلی. درخواست خود را دوباره امتحان کنید.

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