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.

LocalizedText

النص المترجَم باللغة المحدّدة

تمثيل 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 لإصدار أحدث.

CountryTargeting

مواصفات استهداف البلدان

تمثيل JSON
{
  "countries": [
    string
  ],
  "includeRestOfWorld": boolean
}
الحقول
countries[]

string

البلدان التي تريد استهدافها، ويتم تحديدها على أنّها رموز CLDR مكونة من حرفَين

includeRestOfWorld

boolean

يجب تضمين "بقية بُلدان العالم" بالإضافة إلى البلدان المستهدَفة صراحةً.

الطُرق

create

لإنشاء مقطع صوتي جديد

get

الحصول على مقطع صوتي

list

يسرد جميع الأغاني.

patch

تصحيح مقطع صوتي

update

تعديل مقطع صوتي