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. אפשר להגדיר את הערך הזה רק כשהסטטוס הוא inProgress או halted.
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

הטקסט בשפה הנתונה.

סטטוס

הסטטוס של פריט התוכן.

טיפוסים בני מנייה (enum)
statusUnspecified הסטטוס לא צוין.
draft חבילות ה-APK של הגרסה לא מוצגות למשתמשים.
inProgress קובצי ה-APK של הגרסה מוצגים לחלק מהמשתמשים, בהתאם לערך של userFraction.
halted חבילות ה-APK של הגרסה לא יוצגו יותר למשתמשים. השינוי לא ישפיע על משתמשים שכבר יש להם את קובצי ה-APK האלה.
completed לא יבוצעו שינויים נוספים בגרסה. חבילות ה-APK שלה מוצגות לכל המשתמשים, אלא אם הם עומדים בדרישות לשימוש בחבילות APK של גרסה עדכנית יותר.

CountryTargeting

הגדרה של טירגוט לפי מדינה.

ייצוג ב-JSON 
{
  "countries": [
    string
  ],
  "includeRestOfWorld": boolean
}
שדות
countries[]

string

המדינות לטירגוט, שמוגדרות כקודי CLDR בני שתי אותיות.
includeRestOfWorld

boolean

צריך לכלול את האפשרות 'שאר העולם' וגם מדינות מטורגטות באופן מפורש.

Methods

create

 יצירת רצועה חדשה.

get

 מקבל טראק.

list

 מוצגת רשימה של כל הטראקים.

patch

 תיקון של טראק.

update

 עדכון של טראק.

קודי שגיאה

הפעולות של המשאב הזה מחזירות את קודי שגיאות ה-HTTP הבאים:

קוד שגיאה סיבה תיאור רזולוציה