Method: appstoreappsreview.updateappstorehostedapp

جزئیات به‌روزرسانی برنامه‌ای که در یک فروشگاه برنامه قرار دارد را نشان می‌دهد. از این برای ارائه جزئیات یک برنامه جدید یا به‌روزرسانی جزئیات یک برنامه موجود استفاده کنید. به‌روزرسانی بلافاصله پس از ایجاد برای بررسی ارسال می‌شود.

درخواست HTTP

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

این URL از سینتکس Transcoding در 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

جزئیات برنامه اپ استور

جزئیات مربوط به برنامه.

نمایش JSON 
{
  "developerName": string,
  "contactEmail": string,
  "developerWebsite": string
}
فیلدها
developerName

string

الزامی. نام توسعه‌دهنده برنامه.

contactEmail

string

الزامی. آدرس ایمیل تماس توسعه‌دهنده برنامه.

developerWebsite

string

اختیاری. لینک وب‌سایت توسعه‌دهنده یا برنامه.

اپ‌استورلیست اپ‌استور

فهرست فروشگاه محلی. اینها جزئیات مربوط به برنامه هستند که در فروشگاه برنامه شما نشان داده شده است.

نمایش 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

الزامی. چندین شناسه تصویر برای گالری‌های اسکرین‌شات.

اپ‌استوراپ‌اکتیوآپکس

اطلاعات مربوط به APK های فعال یک برنامه میزبانی شده در اپ استور.

نمایش JSON 
{
  "activeApkSets": [
    {
      object (AppStoreAppActiveApkSet)
    }
  ]
}
فیلدها
activeApkSets[]

object ( AppStoreAppActiveApkSet )

الزامی. فهرستی که مشخص می‌کند کدام مجموعه‌های APK با هم توزیع شده‌اند. این فهرست باید شامل تمام APKهایی باشد که برای این برنامه توزیع می‌کنید. برای هر مجموعه APK قابل نصب، یک ورودی اضافه کنید.

اپ‌استور، اپ‌اکتیو، اپک‌ست

مجموعه‌ای از 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.

اعلامیه سیاست اپ استور

یک اعلامیه سیاستگذاری به همراه پاسخ‌های آن.

نمایش JSON 
{
  "declarationId": string,
  "responses": [
    {
      object (PolicyResponse)
    }
  ]
}
فیلدها
declarationId

string

الزامی. شناسه‌ی اعلامیه‌ی بیمه‌نامه.

responses[]

object ( 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

الزامی. مقدار رشته‌ای ارائه شده.

سیاستپاسخ تک گزینه‌ای

هر پاسخی که در آن یک گزینه از بین چندین گزینه انتخاب شود.

نمایش JSON 
{
  "value": string
}
فیلدها
value

string

الزامی. مقدار ارائه شده.

سیاستپاسخ چندگزینه‌ای

هر پاسخی که در آن بتوان چندین گزینه را از بین چندین امکان انتخاب کرد.

نمایش JSON 
{
  "values": [
    string
  ]
}
فیلدها
values[]

string

اختیاری. مقادیر ارائه شده.

سیاستگروهپاسخ

گروهی تکراری از پاسخ‌ها.

نمایش JSON 
{
  "groups": [
    {
      object (Group)
    }
  ]
}
فیلدها
groups[]

object ( Group )

اختیاری. گروه‌هایی از پاسخ‌ها به سوالات.

گروه

گروهی از پاسخ‌ها.

نمایش JSON 
{
  "responses": [
    {
      object (NestedPolicyResponse)
    }
  ]
}
فیلدها
responses[]

object ( NestedPolicyResponse )

الزامی. پاسخ‌ها در یک گروه.

پاسخ NestedPolicy

یک پاسخ تو در تو به یک سوال مربوط به سیاست‌گذاری در مورد یک برنامه. پاسخ‌های تو در تو مانند پاسخ‌های معمولی هستند اما بدون گروه.

نمایش 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 )

اختیاری. پاسخ مستند.

سیاستپاسخ بولی

پاسخ‌هایی که همیشه فقط از نوع بولی خواهند بود.

نمایش JSON 
{
  "value": boolean
}
فیلدها
value

boolean

الزامی. مقدار بولی ارائه شده.

سیاستسندپاسخ

یک سند آپلود شده. باید یک سند منطقی واحد باشد (مثلاً یک مجوز مالی).

نمایش 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 فیلد Union. اطلاعات انقضا برای سند. expiry فقط می‌تواند یکی از موارد زیر باشد:
expiryDate

object ( Date )

اختیاری. تاریخ انقضای سند.

nonExpiring

boolean

اختیاری. اگر تأیید شود که سند تاریخ انقضا ندارد، صحیح است.

تاریخ

نشان دهنده یک تاریخ تقویمی کامل یا جزئی، مانند تاریخ تولد است. زمان روز و منطقه زمانی یا در جای دیگری مشخص شده‌اند یا اهمیت چندانی ندارند. تاریخ نسبت به تقویم میلادی است. این می‌تواند یکی از موارد زیر را نشان دهد:

  • یک تاریخ کامل، با مقادیر سال، ماه و روز غیر صفر.
  • یک ماه و یک روز، با یک سال صفر (مثلاً یک سالگرد).
  • یک سال به تنهایی، با یک ماه صفر و یک روز صفر.
  • یک سال و یک ماه، با یک روز صفر (برای مثال، تاریخ انقضای کارت اعتباری).

انواع مرتبط:

نمایش JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
فیلدها
year

integer

سال تاریخ. باید از ۱ تا ۹۹۹۹ باشد، یا برای مشخص کردن تاریخ بدون سال، ۰ باشد.

month

integer

ماه سال. باید از ۱ تا ۱۲ باشد، یا برای مشخص کردن سال بدون ماه و روز، ۰ باشد.

day

integer

روز ماه. باید از ۱ تا ۳۱ باشد و برای سال و ماه معتبر باشد، یا ۰ برای مشخص کردن یک سال به تنهایی یا یک سال و ماه که روز در آن مهم نیست.

PolicyKeyedGroupResponse

گروهی از پاسخ‌ها که هر کدام با یک کلید مجزا در یک مجموعه مجاز مشخص می‌شوند.

نمایش JSON 
{
  "groups": [
    {
      object (KeyedGroup)
    }
  ]
}
فیلدها
groups[]

object ( KeyedGroup )

اختیاری. گروه‌هایی از پاسخ‌ها به سوالات. هر KeyedGroup.key باید در این لیست منحصر به فرد باشد.

گروه کلیددار

گروهی از پاسخ‌ها، به همراه یک کلید.

نمایش JSON 
{
  "key": string,
  "responses": [
    {
      object (NestedPolicyResponse)
    }
  ]
}
فیلدها
key

string

الزامی. کلید این گروه.

responses[]

object ( NestedPolicyResponse )

الزامی. پاسخ‌ها در این گروه.