Method: appstoreappsreview.updateappstorehostedapp

تعديل تفاصيل تطبيق مستضاف على متجر تطبيقات استخدِم هذه الطريقة لتقديم تفاصيل تطبيق جديد أو لتعديل تفاصيل تطبيق حالي. سيتم إرسال التعديل للمراجعة فور إنشائه.

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات المسار

المعلمات
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 النشطة هذه منشورة على "متجر Google Play" (أو مشتقة من حِزمة تطبيق منشورة على "متجر Google 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

اختياريّ. صحيح إذا تم التأكّد من أنّ المستند لا يتضمّن تاريخ انتهاء صلاحية.
نهاية الحقول التي يستبعد كلّ منها الآخر

PolicyKeyedGroupResponse

مجموعة من الردود يتم تحديد كل منها بمفتاح مميز ضمن مجموعة مسموح بها

تمثيل JSON 
{
  "groups": [
    {
      object (KeyedGroup)
    }
  ]
}
الحقول
groups[]

object (KeyedGroup)

اختياريّ. مجموعات الردود على الأسئلة يجب أن يكون كل KeyedGroup.key فريدًا في هذه القائمة.

KeyedGroup

مجموعة من الردود، مع مفتاح

تمثيل JSON 
{
  "key": string,
  "responses": [
    {
      object (NestedPolicyResponse)
    }
  ]
}
الحقول
key

string

الحقل مطلوب. مفتاح هذه المجموعة
responses[]

object (NestedPolicyResponse)

الحقل مطلوب. الردود في هذه المجموعة