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 حصرية لبعضها البعض ولا يمكن تثبيتها معًا، يجب إنشاء 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

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

التاريخ

تمثّل هذه السمة تاريخ تقويم كاملاً أو جزئيًا، مثل تاريخ الميلاد. يتم تحديد الوقت من اليوم والمنطقة الزمنية في مكان آخر أو لا أهمية لهما. التاريخ نسبي بالنسبة إلى التقويم الغريغوري. يمكن أن يمثّل ذلك أحد ما يلي:

  • تاريخ كامل، مع قيم غير صفرية للسنة والشهر واليوم
  • الشهر واليوم، مع سنة صفر (على سبيل المثال، ذكرى سنوية)
  • سنة بمفردها، مع شهر ويوم بقيمة صفر
  • سنة وشهر، مع يوم صفر (على سبيل المثال، تاريخ انتهاء صلاحية بطاقة ائتمان).

الأنواع ذات الصلة:

تمثيل 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)

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