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 ביחד. אם קובצי APK מסוימים הם בלעדיים אחד לשני ואי אפשר להתקין אותם יחד, צריך ליצור AppStoreAppActiveApkSet נפרד.

ייצוג JSON 
{
  "baseApkId": string,
  "splitApkId": [
    string
  ],
  "versionCode": string,
  "alreadyPublishedOnPlay": boolean
}
שדות
baseApkId

string

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

string

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

string (int64 format)

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

boolean

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

AppStoreAppPolicyDeclaration

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

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

string

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

object (PolicyResponse)

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

PolicyResponse

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "stringResponse": {
    object (PolicyStringResponse)
  },
  "singleChoiceResponse": {
    object (PolicySingleChoiceResponse)
  },
  "multipleChoiceResponse": {
    object (PolicyMultipleChoiceResponse)
  },
  "groupResponse": {
    object (PolicyGroupResponse)
  },
  "keyedGroupResponse": {
    object (PolicyKeyedGroupResponse)
  },
  "booleanResponse": {
    object (PolicyBooleanResponse)
  },
  "documentResponse": {
    object (PolicyDocumentResponse)
  }
  // End of mutually exclusive fields.
}
שדות
questionId

string

חובה. המזהה של השאלה שעליה עונים.
ערך היענות ספציפי. בהמשך מפורטת רשימה של שדות שאי אפשר להשתמש בהם בו-זמנית. בכל תשובה יוגדר לכל היותר אחד מהשדות הבאים:
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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "stringResponse": {
    object (PolicyStringResponse)
  },
  "singleChoiceResponse": {
    object (PolicySingleChoiceResponse)
  },
  "multipleChoiceResponse": {
    object (PolicyMultipleChoiceResponse)
  },
  "booleanResponse": {
    object (PolicyBooleanResponse)
  },
  "documentResponse": {
    object (PolicyDocumentResponse)
  }
  // End of mutually exclusive fields.
}
שדות
questionId

string

חובה. המזהה של השאלה שעליה עונים.
ערך היענות ספציפי. בהמשך מפורטת רשימה של שדות שאי אפשר להשתמש בהם בו-זמנית. בכל תשובה יוגדר לכל היותר אחד מהשדות הבאים:
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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "expiryDate": {
    object (Date)
  },
  "nonExpiring": boolean
  // End of mutually exclusive fields.
}
שדות
documentId

string

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

object (Date)

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

boolean

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

PolicyKeyedGroupResponse

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

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

object (KeyedGroup)

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

KeyedGroup

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

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

string

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

object (NestedPolicyResponse)

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