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 הבאים:

קוד שגיאה סיבה רזולוציה
5xx שגיאה כללית בשרת של Google Play. מנסים לשלוח את הבקשה שוב.

אם הבעיה נמשכת, אפשר לפנות למנהל החשבון שלכם ב-Google Play או לשלוח בקשת תמיכה. כדאי לבדוק בלוח הבקרה של סטטוס Play אם יש הפסקות זמניות ידועות בשירות.
409 שגיאה בעדכון של מספר החיבורים בו-זמנית.

היה ניסיון לעדכן אובייקט שנמצא בתהליך עדכון. לדוגמה, רכישה מאושרת על ידי הפעלת המתודה acknowledgePurchase() של Play Billing Library והפעלת המתודה purchases.products.acknowledge של Play Developer API בו-זמנית.

 מנסים לשלוח את הבקשה שוב.