Method: appstoreappsreview.updateappstorehostedapp

עדכון הפרטים של אפליקציה שמתארחת בחנות אפליקציות. אפשר להשתמש בטופס הזה כדי לספק פרטים על אפליקציה חדשה או לעדכן פרטים של אפליקציה קיימת. העדכון יישלח לבדיקה מיד אחרי היצירה.

בקשת HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/appstore/{appStorePackageName}/apps:update

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
appStorePackageName

string

חובה. שם החבילה של חנות האפליקציות של צד שלישי.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "packageName": string,
  "appDetails": {
    object (AppStoreAppDetails)
  },
  "activeLocalizedStoreListings": [
    {
      object (AppStoreAppStoreListing)
    }
  ],
  "activeApks": {
    object (AppStoreAppActiveApks)
  },
  "policyDeclarations": [
    {
      object (AppStoreAppPolicyDeclaration)
    }
  ]
}
שדות
packageName

string

חובה. שם החבילה של האפליקציה.
appDetails

object (AppStoreAppDetails)

חובה. פרטים כלליים על המפתח של האפליקציה.
activeLocalizedStoreListings[]

object (AppStoreAppStoreListing)

חובה. פרטים על העדכון של דף האפליקציה בחנות בשפות שונות.
activeApks

object (AppStoreAppActiveApks)

חובה. חבילות APK של האפליקציה שמופצות באופן פעיל.
policyDeclarations[]

object (AppStoreAppPolicyDeclaration)

חובה. הצהרות המדיניות שסופקו לגבי האפליקציה.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יהיה ריק.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/androidpublisher

AppStoreAppDetails

פרטים על האפליקציה.

ייצוג ב-JSON 
{
  "developerName": string,
  "contactEmail": string,
  "developerWebsite": string
}
שדות
developerName

string

חובה. שם מפתח האפליקציה.
contactEmail

string

חובה. כתובת האימייל ליצירת קשר עם מפתח האפליקציה.
developerWebsite

string

אופציונלי. קישור לאתר של המפתח או האפליקציה.

AppStoreAppStoreListing

דף אפליקציה בחנות שמותאם לשוק המקומי. אלה הפרטים על האפליקציה כפי שהם מוצגים בחנות האפליקציות.

ייצוג ב-JSON 
{
  "languageCode": string,
  "appName": string,
  "fullDescription": string,
  "shortDescription": string,
  "appIconId": string,
  "screenshotId": [
    string
  ],
  "videoLink": string
}
שדות
languageCode

string

חובה. קוד השפה (למשל, en-US) של כרטיס המוצר.
appName

string

חובה. שם האפליקציה.
fullDescription

string

חובה. טקסט תיאור מקיף של האפליקציה.
shortDescription

string

אופציונלי. סיכום מהיר על האפליקציה.
appIconId

string

חובה. מזהה התמונה שנוצר מ-appstoreappsreview.uploadimage עבור סמל האפליקציה הראשי.
screenshotId[]

string

חובה. מזהי תמונות מרובים לגלריות של צילומי מסך.

AppStoreAppActiveApks

מידע על קובצי APK פעילים של אפליקציה שמתארחת בחנות אפליקציות.

ייצוג ב-JSON 
{
  "activeApkSets": [
    {
      object (AppStoreAppActiveApkSet)
    }
  ]
}
שדות
activeApkSets[]

object (AppStoreAppActiveApkSet)

חובה. רשימה שמציינת אילו חבילות APK מופצות יחד. הרשימה הזו צריכה לכלול את כל חבילות ה-APK שאתם מפיצים עבור האפליקציה הזו. מוסיפים רשומה לכל קבוצה נפרדת של חבילות APK שניתנות להתקנה.

AppStoreAppActiveApkSet

קבוצה של קובצי APK פעילים שאפשר להתקין. קבוצת קובצי APK יכולה להכיל רק קובץ APK אחד אם האפליקציה הרלוונטית מתפרסמת באמצעות קובצי APK. אם האפליקציה משתמשת בחבילות אפליקציות (או בטכנולוגיה דומה), הקבוצה הזו צריכה לכלול את כל קובצי ה-APK (גם אלה שהם אופציונליים) שאפשר להתקין עבור האפליקציה הזו. אפשר להתקין קבוצה של קובצי APK ביחד. אם קובצי APK מסוימים הם בלעדיים זה לזה ואי אפשר להתקין אותם יחד, צריך ליצור AppStoreAppActiveApkSet נפרד.

ייצוג ב-JSON 
{
  "baseApkId": string,
  "splitApkId": [
    string
  ]
}
שדות
baseApkId

string

חובה. המזהה של מודול האפליקציה הראשי. דוגמה: base.apk או app.apk.
splitApkId[]

string

אופציונלי. מזהים של מודולים מפוצלים שאולי מותקנים בשילוב עם חבילת ה-APK הבסיסית. השדה יכול להיות ריק אם לא נעשה שימוש בחבילות אפליקציות (או בטכנולוגיה דומה). דוגמה: config.en.apk.

AppStoreAppPolicyDeclaration

הצהרת תאימות למדיניות עם התשובות שלה.

ייצוג ב-JSON 
{
  "declarationId": string,
  "responses": [
    {
      object (PolicyResponse)
    }
  ]
}
שדות
declarationId

string

חובה. המזהה של הצהרת התאימות למדיניות.
responses[]

object (PolicyResponse)

חובה. התשובות שסופקו להצהרה הזו.

PolicyResponse

תשובה לשאלה בנושא מדיניות לגבי אפליקציה.

ייצוג ב-JSON 
{
  "questionId": string,

  // Union field value can be only one of the following:
  "stringResponse": {
    object (PolicyStringResponse)
  },
  "singleChoiceResponse": {
    object (PolicySingleChoiceResponse)
  },
  "multipleChoiceResponse": {
    object (PolicyMultipleChoiceResponse)
  },
  "groupResponse": {
    object (PolicyGroupResponse)
  },
  "keyedGroupResponse": {
    object (PolicyKeyedGroupResponse)
  },
  "booleanResponse": {
    object (PolicyBooleanResponse)
  },
  "documentResponse": {
    object (PolicyDocumentResponse)
  }
  // End of list of possible types for union field value.
}
שדות
questionId

string

חובה. המזהה של השאלה שעליה עונים.
שדה איחוד value. ערך היענות ספציפי. הערך value יכול להיות רק אחד מהבאים:
stringResponse

object (PolicyStringResponse)

אופציונלי. תשובה מסוג מחרוזת.
singleChoiceResponse

object (PolicySingleChoiceResponse)

אופציונלי. תשובה עם בחירה יחידה.
multipleChoiceResponse

object (PolicyMultipleChoiceResponse)

אופציונלי. תשובה לשאלה אמריקאית.
groupResponse

object (PolicyGroupResponse)

אופציונלי. תשובה קבוצתית.
keyedGroupResponse

object (PolicyKeyedGroupResponse)

אופציונלי. תשובה קבוצתית עם מפתח.
booleanResponse

object (PolicyBooleanResponse)

אופציונלי. תשובה בוליאנית.
documentResponse

object (PolicyDocumentResponse)

אופציונלי. תשובה למסמך.

PolicyStringResponse

כל תגובה שמוצפנת בצורה הטובה ביותר כמחרוזת. כולל כתובות URL ושדות טקסט עם כמה שורות.

ייצוג ב-JSON 
{
  "value": string
}
שדות
value

string

חובה. ערך המחרוזת שצוין.

PolicySingleChoiceResponse

כל תשובה שבה בוחרים אפשרות אחת מתוך כמה אפשרויות.

ייצוג ב-JSON 
{
  "value": string
}
שדות
value

string

חובה. הערך שצוין.

PolicyMultipleChoiceResponse

כל תשובה שבה אפשר לבחור כמה אפשרויות מתוך כמה אפשרויות.

ייצוג ב-JSON 
{
  "values": [
    string
  ]
}
שדות
values[]

string

אופציונלי. הערכים שצוינו.

PolicyGroupResponse

קבוצה של תשובות שחוזרת על עצמה.

ייצוג ב-JSON 
{
  "groups": [
    {
      object (Group)
    }
  ]
}
שדות
groups[]

object (Group)

אופציונלי. קבוצות של תשובות לשאלות.

קבוצה

קבוצת תשובות.

ייצוג ב-JSON 
{
  "responses": [
    {
      object (NestedPolicyResponse)
    }
  ]
}
שדות
responses[]

object (NestedPolicyResponse)

חובה. תשובות בתוך קבוצה.

NestedPolicyResponse

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

ייצוג ב-JSON 
{
  "questionId": string,

  // Union field value can be only one of the following:
  "stringResponse": {
    object (PolicyStringResponse)
  },
  "singleChoiceResponse": {
    object (PolicySingleChoiceResponse)
  },
  "multipleChoiceResponse": {
    object (PolicyMultipleChoiceResponse)
  },
  "booleanResponse": {
    object (PolicyBooleanResponse)
  },
  "documentResponse": {
    object (PolicyDocumentResponse)
  }
  // End of list of possible types for union field value.
}
שדות
questionId

string

חובה. המזהה של השאלה שעליה עונים.
שדה איחוד value. ערך היענות ספציפי. הערך value יכול להיות רק אחד מהבאים:
stringResponse

object (PolicyStringResponse)

אופציונלי. תשובה מסוג מחרוזת.
singleChoiceResponse

object (PolicySingleChoiceResponse)

אופציונלי. תשובה עם בחירה יחידה.
multipleChoiceResponse

object (PolicyMultipleChoiceResponse)

אופציונלי. תשובה לשאלה אמריקאית.
booleanResponse

object (PolicyBooleanResponse)

אופציונלי. תשובה בוליאנית.
documentResponse

object (PolicyDocumentResponse)

אופציונלי. תשובה למסמך.

PolicyBooleanResponse

תשובות שיהיו תמיד בוליאניות.

ייצוג ב-JSON 
{
  "value": boolean
}
שדות
value

boolean

חובה. הערך הבוליאני שצוין.

PolicyDocumentResponse

מסמך שהועלה. חייב להיות מסמך לוגי יחיד (למשל רישיון פיננסי).

ייצוג ב-JSON 
{
  "documentId": string,

  // Union field expiry can be only one of the following:
  "expiryDate": {
    object (Date)
  },
  "nonExpiring": boolean
  // End of list of possible types for union field expiry.
}
שדות
documentId

string

חובה. המזהה של המסמך שהועלה.
שדה איחוד expiry. מידע על התפוגה של המסמך. הערך expiry יכול להיות רק אחד מהבאים:
expiryDate

object (Date)

אופציונלי. תאריך התפוגה של המסמך.
nonExpiring

boolean

אופציונלי. הערך הוא True אם אושר שלמסמך אין תאריך תפוגה.

תאריך

מייצג תאריך מלא או חלקי ביומן, כמו יום הולדת. השעה ביום ואזור הזמן מצוינים במקום אחר או שהם לא משמעותיים. התאריך הוא ביחס ללוח השנה הגרגוריאני. הערך הזה יכול לייצג את אחת מהאפשרויות הבאות:

  • תאריך מלא, עם ערכים שאינם אפס לשנה, לחודש וליום.
  • חודש ויום, עם שנה אפסית (לדוגמה, יום נישואין).
  • שנה לבד, עם חודש אפס ויום אפס.
  • שנה וחודש, עם יום אפס (לדוגמה, תאריך התפוגה של כרטיס אשראי).

סוגים קשורים:

ייצוג ב-JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
שדות
year

integer

השנה של התאריך. חייב להיות בין 1 ל-9999, או 0 כדי לציין תאריך ללא שנה.
month

integer

החודש בשנה. הערך חייב להיות בין 1 ל-12, או 0 כדי לציין שנה בלי חודש ויום.
day

integer

יום בחודש. הערך צריך להיות בין 1 ל-31, והוא צריך להיות תקף לשנה ולחודש, או 0 כדי לציין רק שנה או שנה וחודש שבהם היום לא משמעותי.

PolicyKeyedGroupResponse

קבוצה של תשובות שכל אחת מהן מזוהה על ידי מפתח ייחודי בתוך קבוצה מותרת.

ייצוג ב-JSON 
{
  "groups": [
    {
      object (KeyedGroup)
    }
  ]
}
שדות
groups[]

object (KeyedGroup)

אופציונלי. קבוצות של תשובות לשאלות. כל KeyedGroup.key חייב להיות ייחודי ברשימה הזו.

KeyedGroup

קבוצה של תשובות, עם מפתח.

ייצוג ב-JSON 
{
  "key": string,
  "responses": [
    {
      object (NestedPolicyResponse)
    }
  ]
}
שדות
key

string

חובה. המפתח של הקבוצה הזו.
responses[]

object (NestedPolicyResponse)

חובה. תשובות בקבוצה הזו.