Управление отправками приложенийManage app submissions

API отправки в Microsoft Store предоставляет методы, которые можно использовать для управления отправками ваших приложений, включая постепенные выпуски пакетов.The Microsoft Store submission API provides methods you can use to manage submissions for your apps, including gradual package rollouts. Введение в API отправки в Microsoft Store, включая необходимые условия для использования этого API, см. в разделе Создание отправок и управление ими с помощью служб Microsoft Store.For an introduction to the Microsoft Store submission API, including prerequisites for using the API, see Create and manage submissions using Microsoft Store services.

Важно!

Если для создания отправки приложения используется API отправки Microsoft Store, обязательно внесите дальнейшие изменения в отправку только с помощью API, а не из центра партнеров.If you use the Microsoft Store submission API to create a submission for an app, be sure to make further changes to the submission only by using the API, rather than Partner Center. Если вы используете Центр партнеров для изменения отправки, изначально созданной с помощью API, вы больше не сможете изменить или зафиксировать эту отправку с помощью API.If you use Partner Center to change a submission that you originally created by using the API, you will no longer be able to change or commit that submission by using the API. В некоторых случаях отправка может оставаться в состоянии ошибки, когда продолжить процесс отправки невозможно.In some cases, the submission could be left in an error state where it cannot proceed in the submission process. В этом случае необходимо удалить отправку и создать новую.If this occurs, you must delete the submission and create a new submission.

Важно!

Этот API нельзя использовать для публикации отправок для покупок в больших объемах через Microsoft Store для бизнеса и Microsoft Store для образования и для публикации отправок бизнес-приложений непосредственно для предприятий.You cannot use this API to publish submissions for volume purchases through the Microsoft Store for Business and Microsoft Store for Education or to publish submissions for LOB apps directly to enterprises. В обоих сценариях для публикации отправки необходимо использовать центр партнеров.For both of these scenarios, you must use Partner Center to publish the submission.

Методы для управления отправками приложенийMethods for managing app submissions

Используйте следующие методы для получения, создания, обновления, фиксации и удаления отправки приложения.Use the following methods to get, create, update, commit, or delete an app submission. Прежде чем использовать эти методы, приложение должно уже существовать в учетной записи центра партнеров, и сначала необходимо создать одну отправку для приложения в центре партнеров.Before you can use these methods, the app must already exist in your Partner Center account and you must first create one submission for the app in Partner Center. Дополнительные сведения см. в разделе Предварительные требования.For more information, see the prerequisites.

МетодMethod URIURI ОписаниеDescription
GETGET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId} Получение существующей отправки приложенияGet an existing app submission
GETGET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/status Получение состояния существующей отправки приложенияGet the status of an existing app submission
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions Создание новой отправки приложенияCreate a new app submission
ОТПРАВКАPUT https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId} Обновление существующей отправки приложенияUpdate an existing app submission
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/commit Фиксация новой или обновленной отправки приложенияCommit a new or updated app submission
DELETEDELETE https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId} Удаление отправки приложенияDelete an app submission

Создание отправки приложенияCreate an app submission

Чтобы создать отправку для приложения, выполните следующие действия.To create a submission for an app, follow this process.

  1. Если вы еще не сделали этого, выполните все необходимые условия для API отправки в Microsoft Store.If you have not done so already, complete all the prerequisites for the Microsoft Store submission API.

    Примечание

    Убедитесь, что приложение уже содержит не менее одной завершенной отправки, для которой указаны сведения возрастной категории.Make sure the app already has at least one completed submission with the age ratings information completed.

  2. Получите маркер доступа Azure AD.Obtain an Azure AD access token. Этот маркер доступа необходимо передавать методам из API отправки в Microsoft Store.You must pass this access token to the methods in the Microsoft Store submission API. После получения маркера доступа у вас будет 60 минут, чтобы использовать его до истечения срока действия.After you obtain an access token, you have 60 minutes to use it before it expires. После истечения срока действия маркера можно получить новый маркер.After the token expires, you can obtain a new one.

  3. Создание отправки приложения путем выполнения следующего метода в API отправки в Microsoft Store.Create an app submission by executing the following method in the Microsoft Store submission API. Этот метод создает новую выполняющуюся отправку, которая является копией последней опубликованной отправки.This method creates a new in-progress submission, which is a copy of your last published submission.

    POST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions
    

    Тело ответа содержит ресурс отправки приложения, включающий в себя идентификатор новой отправки, URI подписанного URL-адреса (Shared Access Signature, SAS) для передачи любых необходимых файлов для отправки в хранилище BLOB-объектов Azure (таких как пакеты приложения, изображения для описания и файлы трейлеров), а также все данные новой отправки (в том числе все описания и информацию о ценах).The response body contains an app submission resource that includes the ID of the new submission, the shared access signature (SAS) URI for uploading any related files for the submission to Azure Blob storage (such as app packages, listing images, and trailer files), and all of the data for the new submission (such as the listings and pricing information).

    Примечание

    URI SAS предоставляет доступ к защищенному ресурсу в хранилище Azure без необходимости в использовании ключей учетной записи.A SAS URI provides access to a secure resource in Azure storage without requiring account keys. Основные сведения об URI SAS и их использовании с хранилищем BLOB-объектов Azure см. в разделах Подписанные URL-адреса, часть 1. Общие сведения о модели SAS и Подписанные URL-адреса, часть 2. Создание и использование SAS с хранилищем BLOB-объектов.For background information about SAS URIs and their use with Azure Blob storage, see Shared Access Signatures, Part 1: Understanding the SAS model and Shared Access Signatures, Part 2: Create and use a SAS with Blob storage.

  4. При добавлении новых пакетов, изображений для описания и файлов трейлеров для отправки подготовьте пакеты приложения и подготовьте снимки экранов, изображения и трейлеры.If you are adding new packages, listing images, or trailer files for the submission, prepare the app packages and prepare the app screenshots, images, and trailers. Добавьте все эти файлы в ZIP-архив.Add all of these files to a ZIP archive.

  5. Проверьте отправку приложения, внеся все необходимые для новой отправки изменения, затем выполните следующий метод для обновления отправки приложения.Revise the app submission data with any required changes for the new submission, and execute the following method to update the app submission.

    PUT https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}
    

    Примечание

    Если в отправку добавляются новые файлы, обязательно обновите данные отправки, чтобы они ссылались на имя и относительный путь этих файлов в ZIP-архиве.If you are adding new files for the submission, make sure you update the submission data to refer to the name and relative path of these files in the ZIP archive.

  6. При добавлении новых пакетов, изображений описания и файлов трейлеров для отправки выложите ZIP-архив в хранилище BLOB-объектов Azure, используя URI SAS, полученный в теле ответа метода POST, вызов которого был выполнен ранее.If you are adding new packages, listing images, or trailer files for the submission, upload the ZIP archive to Azure Blob storage using the SAS URI that was provided in the response body of the POST method you called earlier. Существуют разные библиотеки Azure, которые можно использовать в этих целях на различных платформах, включая следующие.There are different Azure libraries you can use to do this on a variety of platforms, including:

    В следующем фрагменте кода на C# показано, как передать ZIP-архив в хранилище BLOB-объектов Azure с помощью класса CloudBlockBlob клиентской библиотеки службы хранилища Azure для .NET.The following C# code example demonstrates how to upload a ZIP archive to Azure Blob storage using the CloudBlockBlob class in the Azure Storage Client Library for .NET. В этом примере кода предполагается, что ZIP-архив уже был записан в потоковый объект.This example assumes that the ZIP archive has already been written to a stream object.

    string sasUrl = "https://productingestionbin1.blob.core.windows.net/ingestion/26920f66-b592-4439-9a9d-fb0f014902ec?sv=2014-02-14&sr=b&sig=usAN0kNFNnYE2tGQBI%2BARQWejX1Guiz7hdFtRhyK%2Bog%3D&se=2016-06-17T20:45:51Z&sp=rwl";
    Microsoft.WindowsAzure.Storage.Blob.CloudBlockBlob blockBob =
        new Microsoft.WindowsAzure.Storage.Blob.CloudBlockBlob(new System.Uri(sasUrl));
    await blockBob.UploadFromStreamAsync(stream);
    
  7. Подтвердите отправку приложения, выполнив следующий метод.Commit the app submission by executing the following method. В результате вы получите оповещение об этом центре партнеров, и теперь ваши обновления должны быть применены к вашей учетной записи.This will alert Partner Center that you are done with your submission and that your updates should now be applied to your account.

    POST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/commit
    
  8. Проверка состояния подтверждения путем выполнения следующего метода для получения сведений о состоянии отправки приложения.Check on the commit status by executing the following method to get the status of the app submission.

    GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/status
    

    Чтобы проверить состояние отправки, посмотрите значение поля status в теле ответа.To confirm the submission status, review the status value in the response body. Это значение должно измениться с CommitStarted на PreProcessing, если запрос выполнен успешно, или на CommitFailed, если в запросе возникли ошибки.This value should change from CommitStarted to either PreProcessing if the request succeeds or to CommitFailed if there are errors in the request. Если имеются ошибки, поле statusDetails содержит дополнительные сведения об ошибке.If there are errors, the statusDetails field contains further details about the error.

  9. После успешного завершения подтверждения отправки она отправляется в Магазин для внедрения.After the commit has successfully completed, the submission is sent to the Store for ingestion. Вы можете продолжить отслеживать ход отправки, используя предыдущий метод или посетив центр партнеров.You can continue to monitor the submission progress by using the previous method, or by visiting Partner Center.

Методы для управления постепенным выпуском пакетаMethods for managing a gradual package rollout

Вы можете постепенно выполнять выпуск обновленных пакетов в отправке приложения для части пользователей вашего приложения в Windows 10.You can gradually roll out the updated packages in an app submission to a percentage of your app’s customers on Windows 10. Это позволяет контролировать отзывы и аналитические данные для конкретных пакетов, чтобы вы могли убедиться в правильности обновления до его более широкого распространения.This allows you to monitor feedback and analytic data for the specific packages to make sure you’re confident about the update before rolling it out more broadly. Можно изменить процент выпуска (или остановить обновление) для опубликованной отправки без необходимости создания новой отправки.You can change the rollout percentage (or halt the update) for a published submission without having to create a new submission. Дополнительные сведения, в том числе инструкции по включению постепенного развертывания пакетов и управлению ими в центре партнеров, см. в этой статье.For more details, including instructions for how to enable and manage a gradual package rollout in Partner Center, see this article.

Чтобы программным образом включить постепенный выпуск пакета для отправки приложения, выполните следующие действия используя методы в API отправки в Microsoft Store.To programmatically enable a gradual package rollout for an app submission, follow this process using methods in the Microsoft Store submission API:

  1. Создайте отправку приложения или получите существующую отправку приложения.Create an app submission or get an existing app submission.
  2. В данных ответа найдите ресурс packageRollout, задайте в поле isPackageRollout значение true, а в поле packageRolloutPercentage задайте процент пользователей вашего приложения, которые должны получить обновленные пакеты.In the response data, locate the packageRollout resource, set the isPackageRollout field to true, and set the packageRolloutPercentage field to the percentage of your app's customers who should get the updated packages.
  3. Передайте обновленные данные отправки приложения методу обновления отправки приложения.Pass the updated app submission data to the update an app submission method.

После включения постепенного выпуска пакета для отправки приложения можно использовать следующие методы, чтобы программным образом получать, обновлять, останавливать или завершать постепенный выпуск.After a gradual package rollout is enabled for an app submission, you can use the following methods to programmatically get, update, halt, or finalize the gradual rollout.

МетодMethod URIURI ОписаниеDescription
GETGET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/packagerollout Получение сведений постепенного выпуска для отправки приложенияGet the gradual rollout info for an app submission
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/updatepackagerolloutpercentage Обновление процента постепенного выпуска для отправки приложенияUpdate the gradual rollout percentage for an app submission
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/haltpackagerollout Остановка постепенного выпуска для отправки приложенияHalt the gradual rollout for an app submission
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/finalizepackagerollout Завершение постепенного выпуска для отправки приложенияFinalize the gradual rollout for an app submission

Примеры кода для управления отправками приложенийCode examples for managing app submissions

Следующие статьи содержат подробные примеры кода на нескольких разных языках программирования, демонстрирующие процесс создания отправки приложения.The following articles provide detailed code examples that demonstrate how to create an app submission in several different programming languages:

Модуль StoreBroker PowerShellStoreBroker PowerShell module

В качестве альтернативы прямому вызову API отправки в Microsoft Store также предоставляется модуль PowerShell с открытым исходным кодом, в котором поверх API реализован интерфейс командной строки.As an alternative to calling the Microsoft Store submission API directly, we also provide an open-source PowerShell module which implements a command-line interface on top of the API. Этот модуль называется StoreBroker.This module is called StoreBroker. Этот модуль можно использовать для управления приложением, тестируемой возможностью и отправками надстроек из командной строки, вместо того чтобы вызывать API отправки в Microsoft Store напрямую. Кроме того, можно просмотреть дополнительные примеры вызова этого API, изучив исходный код.You can use this module to manage your app, flight, and add-on submissions from the command line instead of calling the Microsoft Store submission API directly, or you can simply browse the source to see more examples for how to call this API. Модуль StoreBroker активно используется Microsoft в качестве основного способа отправки многих собственных приложений компании в Магазин.The StoreBroker module is actively used within Microsoft as the primary way that many first-party applications are submitted to the Store.

Дополнительные сведения см. на нашей странице StoreBroker на сайте GitHub.For more information, see our StoreBroker page on GitHub.

Ресурсы данныхData resources

Для управления отправками приложений методы API отправки в Microsoft Store используют следующие ресурсы данных JSON.The Microsoft Store submission API methods for managing app submissions use the following JSON data resources.

Ресурс отправки приложенияApp submission resource

Этот ресурс описывает отправку приложения.This resource describes an app submission.

{
  "id": "1152921504621243540",
  "applicationCategory": "BooksAndReference_EReader",
  "pricing": {
    "trialPeriod": "FifteenDays",
    "marketSpecificPricings": {},
    "sales": [],
    "priceId": "Tier2",
    "isAdvancedPricingModel": true
  },
  "visibility": "Public",
  "targetPublishMode": "Manual",
  "targetPublishDate": "1601-01-01T00:00:00Z",
  "listings": {
    "en-us": {
      "baseListing": {
        "copyrightAndTrademarkInfo": "",
        "keywords": [
          "epub"
        ],
        "licenseTerms": "",
        "privacyPolicy": "",
        "supportContact": "",
        "websiteUrl": "",
        "description": "Description",
        "features": [
          "Free ebook reader"
        ],
        "releaseNotes": "",
        "images": [
          {
            "fileName": "contoso.png",
            "fileStatus": "Uploaded",
            "id": "1152921504672272757",
            "description": "Main page",
            "imageType": "Screenshot"
          }
        ],
        "recommendedHardware": [],
        "title": "Contoso ebook reader"
      },
      "platformOverrides": {
        "Windows81": {
          "description": "Ebook reader for Windows 8.1"
        }
      }
    }
  },
  "hardwarePreferences": [
    "Touch"
  ],
  "automaticBackupEnabled": false,
  "canInstallOnRemovableMedia": true,
  "isGameDvrEnabled": false,
  "gamingOptions": [],
  "hasExternalInAppProducts": false,
  "meetAccessibilityGuidelines": true,
  "notesForCertification": "",
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
  "fileUploadUrl": "https://productingestionbin1.blob.core.windows.net/ingestion/387a9ea8-a412-43a9-8fb3-a38d03eb483d?sv=2014-02-14&sr=b&sig=sdd12JmoaT6BhvC%2BZUrwRweA%2Fkvj%2BEBCY09C2SZZowg%3D&se=2016-06-17T18:32:26Z&sp=rwl",
  "applicationPackages": [
    {
      "fileName": "contoso_app.appx",
      "fileStatus": "Uploaded",
      "id": "1152921504620138797",
      "version": "1.0.0.0",
      "architecture": "ARM",
      "languages": [
        "en-US"
      ],
      "capabilities": [
        "ID_RESOLUTION_HD720P",
        "ID_RESOLUTION_WVGA",
        "ID_RESOLUTION_WXGA"
      ],
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None",
      "targetDeviceFamilies": [
        "Windows.Mobile min version 10.0.10240.0"
      ]
    }
  ],
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
  "enterpriseLicensing": "Online",
  "allowMicrosoftDecideAppAvailabilityToFutureDeviceFamilies": true,
  "allowTargetFutureDeviceFamilies": {
    "Desktop": false,
    "Mobile": true,
    "Holographic": true,
    "Xbox": false,
    "Team": true
  },
  "friendlyName": "Submission 2",
  "trailers": []
}

Этот ресурс содержит следующие значения.This resource has the following values.

ЗначениеValue ТипType ОписаниеDescription
идентификаторid строкаstring Идентификатор отправки.The ID of the submission. Этот идентификатор доступен в данных ответа на запросы на создание отправки приложения, получение всех приложений и получение определенного приложения.This ID is available in the response data for requests to create an app submission, get all apps, and get an app. Для отправки, созданной в центре партнеров, этот идентификатор также доступен в URL-адресе страницы отправки в центре партнеров.For a submission that was created in Partner Center, this ID is also available in the URL for the submission page in Partner Center.
applicationCategoryapplicationCategory строкаstring Строка, указывающая категорию или подкатегорию для вашего приложения.A string that specifies the category and/or subcategory for your app. Категории и подкатегории объединяются в одну строку с помощью символа подчеркивания "", например BooksAndReference_EReader.Categories and subcategories are combined into a single string with the underscore '' character, such as BooksAndReference_EReader.
ценыpricing объектobject Ресурс цены, содержащий сведения о цене приложения.A pricing resource that contains pricing info for the app.
видимостьvisibility строкаstring Видимость приложения.The visibility of the app. Может иметь одно из следующих значений:This can be one of the following values:
  • СкрытыйHidden
  • ОбщедоступныеPublic
  • ЛичныеPrivate
  • NotSetNotSet
targetPublishModetargetPublishMode строкаstring Режим публикации для отправки.The publish mode for the submission. Может иметь одно из следующих значений:This can be one of the following values:
  • НемедленноImmediate
  • ВручнуюManual
  • SpecificDate (Указанная дата)SpecificDate
targetPublishDatetargetPublishDate строкаstring Дата публикации отправки в формате ISO 8601, если для targetPublishMode задано значение SpecificDate.The publish date for the submission in ISO 8601 format, if the targetPublishMode is set to SpecificDate.
listingslistings объектobject Словарь пар "ключ-значение", где каждый ключ является кодом страны, а каждое значение — объектом ресурса описания, содержащим данные описания приложения.A dictionary of key and value pairs, where each key is a country code and each value is a listing resource that contains listing info for the app.
hardwarePreferenceshardwarePreferences массивеarray Массив строк, определяющих предпочтения оборудования для приложения.An array of strings that define the hardware preferences for your app. Может иметь одно из следующих значений:This can be one of the following values:
  • TouchTouch
  • КлавиатураKeyboard
  • МышьMouse
  • КамераCamera
  • NfcHceNfcHce
  • NfcNfc
  • BluetoothLEBluetoothLE
  • Telephony (Телефония)Telephony
automaticBackupEnabledautomaticBackupEnabled Логическоеboolean Указывает, может ли Windows включать данные этого приложения в автоматические резервные копии, записываемые в OneDrive.Indicates whether Windows can include your app's data in automatic backups to OneDrive. Подробные сведения см. в разделе Объявления приложений.For more information, see App declarations.
canInstallOnRemovableMediacanInstallOnRemovableMedia Логическоеboolean Указывает, могут ли клиенты устанавливать приложение на съемный носитель.Indicates whether customers can install your app to removable storage. Подробные сведения см. в разделе Объявления приложений.For more information, see App declarations.
isGameDvrEnabledisGameDvrEnabled Логическоеboolean Указывает, включена ли для приложения функция DVR для игр.Indicates whether game DVR is enabled for the app.
gamingOptionsgamingOptions массивеarray Массив, содержащий один ресурс параметров игры, который определяет относящиеся к игре параметры для приложения.An array that contains one gaming options resource that defines game-related settings for the app.
hasExternalInAppProductshasExternalInAppProducts Логическоеboolean Указывает, позволяет ли приложение пользователям делать покупки без использования коммерческой системы Microsoft Store.Indicates whether your app allows users to make purchase outside the Microsoft Store commerce system. Подробные сведения см. в разделе Объявления приложений.For more information, see App declarations.
meetAccessibilityGuidelinesmeetAccessibilityGuidelines Логическоеboolean Указывает, проверено ли приложение на соответствие рекомендациям по специальным возможностям.Indicates whether your app has been tested to meet accessibility guidelines. Подробные сведения см. в разделе Объявления приложений.For more information, see App declarations.
notesForCertificationnotesForCertification строкаstring Содержит заметки по сертификации приложения.Contains notes for certification for your app.
statusstatus строкаstring Состояние отправки.The status of the submission. Может иметь одно из следующих значений:This can be one of the following values:
  • НетNone
  • ОтмененоCanceled
  • PendingCommit (Ожидание фиксации)PendingCommit
  • CommitStarted (Фиксация запущена)CommitStarted
  • CommitFailed (Сбой фиксации)CommitFailed
  • PendingPublication (Ожидание публикации)PendingPublication
  • ПубликацияPublishing
  • ОпубликованPublished
  • PublishFailed (Сбой публикации)PublishFailed
  • PreProcessing (Предварительная обработка)PreProcessing
  • PreProcessingFailed (Сбой предварительной обработки)PreProcessingFailed
  • СертификацияCertification
  • CertificationFailed (Сбой сертификации)CertificationFailed
  • ВыпускRelease
  • ReleaseFailed (Сбой выпуска)ReleaseFailed
statusDetailsstatusDetails объектobject Ресурс сведений о состоянии, который содержит дополнительные сведения о состоянии отправки, включая сведения об ошибках.A status details resource that contains additional details about the status of the submission, including information about any errors.
fileUploadUrlfileUploadUrl строкаstring URI подписанного URL-адреса (SAS) для передачи пакетов для отправки.The shared access signature (SAS) URI for uploading any packages for the submission. При добавлении новых пакетов, изображений описания или файлов трейлеров для отправки выложите ZIP-архив, содержащий пакеты и изображения, по этому URI.If you are adding new packages, listing images, or trailer files for the submission, upload the ZIP archive that contains the packages and images to this URI. Дополнительную информацию см. в разделе Создание отправки приложения.For more information, see Create an app submission.
applicationPackagesapplicationPackages массивеarray Массив ресурсов пакета приложения, предоставляющий сведения о каждом пакете в отправкеAn array of application package resources that provide details about each package in the submission.
packageDeliveryOptionspackageDeliveryOptions объектobject Ресурс параметров доставки пакета, который содержит постепенный выпуск пакета и обязательные параметры обновления для отправки.A package delivery options resource that contains gradual package rollout and mandatory update settings for the submission.
enterpriseLicensingenterpriseLicensing строкаstring Одно из значений, связанных с корпоративным лицензированием, задающих поведение приложения в отношении корпоративного лицензирования.One of the enterprise licensing values values that indicate the enterprise licensing behavior for the app.
allowMicrosoftDecideAppAvailabilityToFutureDeviceFamiliesallowMicrosoftDecideAppAvailabilityToFutureDeviceFamilies Логическоеboolean Указывает, разрешено ли Майкрософт делать приложение доступным для будущих семейств устройств Windows 10..Indicates whether Microsoft is allowed to make the app available to future Windows 10 device families.
allowTargetFutureDeviceFamiliesallowTargetFutureDeviceFamilies объектobject Словарь пар "ключ-значение", в котором каждый ключ представляет собой семейство устройств Windows 10, а каждое значение является логическим значением, которое указывает, разрешено ли нацеливание приложения на указанное семейство устройств.A dictionary of key and value pairs, where each key is a Windows 10 device family and each value is a boolean that indicates whether your app is allowed to target the specified device family.
friendlyNamefriendlyName строкаstring Понятное имя отправки, как показано в центре партнеров.The friendly name of the submission, as shown in Partner Center. Это значение создается при создании отправки.This value is generated for you when you create the submission.
trailerstrailers массивеarray Массив, содержащий до 15 ресурсов трейлеров, представляющие видеотрейлеры для описания приложения.An array that contains up to 15 trailer resources that represent video trailers for the app listing.

Ресурс ценыPricing resource

Этот ресурс содержит сведения о ценах для приложения.This resource contains pricing info for the app. Этот ресурс содержит следующие значения.This resource has the following values.

ЗначениеValue ТипType ОписаниеDescription
trialPeriodtrialPeriod строкаstring Строка, указывающая срок действия пробной версии приложения.A string that specifies the trial period for the app. Может иметь одно из следующих значений:This can be one of the following values:
  • NoFreeTrial (Нет пробного периода)NoFreeTrial
  • OneDay (Один день)OneDay
  • TrialNeverExpires (Бессрочный пробный период)TrialNeverExpires
  • SevenDays (7 дней)SevenDays
  • FifteenDays (15 дней)FifteenDays
  • ThirtyDays (30 дней)ThirtyDays
marketSpecificPricingsmarketSpecificPricings объектobject Словарь пар "ключ-значение", где каждый ключ представляет собой код страны ISO 3166-1 alpha-2 из двух букв, а каждое значение — ценовую категорию.A dictionary of key and value pairs, where each key is a two-letter ISO 3166-1 alpha-2 country code and each value is a price tier. Эти элементы представляют особые цены на ваше приложение для определенных рынков.These items represent the custom prices for your app in specific markets. Любые элементы этого словаря переопределяют базовую цену, заданную значением priceId для указанного рынка.Any items in this dictionary override the base price specified by the priceId value for the specified market.
salessales массивеarray Устаревшее.Deprecated. Массив ресурсов продажи, содержащих сведения о продажах для приложения.An array of sale resources that contain sales information for the app.
priceIdpriceId строкаstring Ценовая категория, указывающая базовую цену для приложения.A price tier that specifies the base price for the app.
isAdvancedPricingModelisAdvancedPricingModel Логическоеboolean Если true, ваша учетная запись разработчика имеет доступ к расширенному набору ценовых категорий от 0,99 долл. США до 1999,99 долл. США.If true, your developer account has access to the expanded set of price tiers from .99 USD to 1999.99 USD. Если false, ваша учетная запись разработчика имеет доступ к стандартному набору ценовых категорий от 0,99 долл. США до 999,99 долл. США.If false, your developer account has access to the original set of price tiers from .99 USD to 999.99 USD. Дополнительные сведения о разных категориях см. в разделе Ценовые категории.For more information about the different tiers, see price tiers.

Примечание.     Это поле доступно только для чтения.Note  This field is read-only.

Ресурс продажиSale resource

Этот ресурс содержит сведения о продажах для приложения.This resources contains sale info for an app.

Важно!

Ресурс продажи больше не поддерживается, и в настоящее время невозможно получить или изменить данные продажи для отправки приложения с помощью API отправки в Microsoft Store.The Sale resource is no longer supported, and currently you cannot get or modify the sale data for an app submission using the Microsoft Store submission API. В дальнейшем мы обновим API отправки в Microsoft Store, чтобы предложить пользователям новый способ программного доступа к информации о продажах для отправок приложений.In the future, we will update the Microsoft Store submission API to introduce a new way to programmatically access sales information for app submissions.

Этот ресурс содержит следующие значения.This resource has the following values.

ЗначениеValue ТипType ОписаниеDescription
namename строкаstring Имя продажи.The name of the sale.
basePriceIdbasePriceId строкаstring Ценовая категория, используемая для базовой цены продажи.The price tier to use for the base price of the sale.
startDatestartDate строкаstring Дата начала для продажи в формате ISO 8601.The start date for the sale in ISO 8601 format.
endDateendDate строкаstring Дата окончания для продажи в формате ISO 8601.The end date for the sale in ISO 8601 format.
marketSpecificPricingsmarketSpecificPricings объектobject Словарь пар "ключ-значение", где каждый ключ представляет собой код страны ISO 3166-1 alpha-2 из двух букв, а каждое значение — ценовую категорию.A dictionary of key and value pairs, where each key is a two-letter ISO 3166-1 alpha-2 country code and each value is a price tier. Эти элементы представляют особые цены на ваше приложение для определенных рынков.These items represent the custom prices for your app in specific markets. Любые элементы этого словаря переопределяют базовую цену, заданную значением basePriceId для указанного рынка.Any items in this dictionary override the base price specified by the basePriceId value for the specified market.

Ресурс описанияListing resource

Этот ресурс содержит информацию описания для приложения.This resource contains listing info for an app. Этот ресурс содержит следующие значения.This resource has the following values.

ЗначениеValue ТипType ОписаниеDescription
baseListingbaseListing объектobject Информация базового описания для приложения, которая определяет описание по умолчанию на всех платформах.The base listing info for the app, which defines the default listing info for all platforms.
platformOverridesplatformOverrides объектobject Словарь пар "ключ-значение", где каждый ключ является строкой, идентифицирующей платформу, для которой необходимо переопределить информацию в описании, а каждое значение является ресурсом базового описания (содержащим только значения от описания до заголовка), определяющим информацию для переопределения описания для указанной платформы.A dictionary of key and value pairs, where each key is string that identifies a platform for which to override the listing info, and each value is a base listing resource (containing only the values from description to title) that specifies the listing info to override for the specified platform. Ключи могут иметь следующие значения:The keys can have the following values:
  • НеизвестноUnknown
  • Windows80Windows80
  • Windows81Windows81
  • WindowsPhone71WindowsPhone71
  • WindowsPhone80WindowsPhone80
  • WindowsPhone81WindowsPhone81

Ресурс базового описанияBase listing resource

Этот ресурс содержит базовую информацию описания для приложения.This resource contains base listing info for an app. Этот ресурс содержит следующие значения.This resource has the following values.

ЗначениеValue ТипType ОписаниеDescription
copyrightAndTrademarkInfocopyrightAndTrademarkInfo строкаstring Необязательные сведения об авторских правах и (или) товарных знаках.Optional copyright and/or trademark info.
keywordskeywords массивеarray Массив ключевых слов, способствующих появлению вашего приложения в результатах поиска.An array of keyword to help your app appear in search results.
licenseTermslicenseTerms строкаstring Необязательные условия лицензионного соглашения для вашего приложения.The optional license terms for your app.
privacyPolicyprivacyPolicy строкаstring Это значение устарело.This value is obsolete. Чтобы задать или изменить URL-адрес политики конфиденциальности для приложения, необходимо сделать это на странице свойств в центре партнеров.To set or change the privacy policy URL for your app, you must do this on the Properties page in Partner Center. Это значение можно исключить из вызовов к API отправки.You can omit this value from your calls to the submission API. Если это значение задано, оно будет игнорироваться.If you set this value, it will be ignored.
supportContactsupportContact строкаstring Это значение устарело.This value is obsolete. Чтобы задать или изменить URL-адрес или адрес электронной почты службы поддержки для приложения, необходимо сделать это на странице свойств в центре партнеров.To set or change the support contact URL or email address for your app, you must do this on the Properties page in Partner Center. Это значение можно исключить из вызовов к API отправки.You can omit this value from your calls to the submission API. Если это значение задано, оно будет игнорироваться.If you set this value, it will be ignored.
websiteUrlwebsiteUrl строкаstring Это значение устарело.This value is obsolete. Чтобы задать или изменить URL-адрес веб страницы для приложения, необходимо сделать это на странице свойств в центре партнеров.To set or change the URL of the web page for your app, you must do this on the Properties page in Partner Center. Это значение можно исключить из вызовов к API отправки.You can omit this value from your calls to the submission API. Если это значение задано, оно будет игнорироваться.If you set this value, it will be ignored.
descriptiondescription строкаstring Описание для описания приложения.The description for the app listing.
featuresfeatures массивеarray Массив размером до 20 строк со списком функций вашего приложения.An array of up to 20 strings that list the features for your app.
releaseNotesreleaseNotes строкаstring Заметки о выпуске для вашего приложения.The release notes for your app.
imagesimages массивеarray Массив ресурсов изображений и значков для описания приложения.An array of image and icon resources for the app listing.
recommendedHardwarerecommendedHardware массивеarray Массив размером до 11 строк со списком рекомендуемой конфигурации оборудования для вашего приложения.An array of up to 11 strings that list the recommended hardware configurations for your app.
minimumHardwareminimumHardware строкаstring Массив размером до 11 строк со списком минимальной конфигурации оборудования для вашего приложения.An array of up to 11 strings that list the minimum hardware configurations for your app.
titletitle строкаstring Название для описания приложения.The title for the app listing.
shortDescriptionshortDescription строкаstring Используется только для игр.Only used for games. Это описание отображается в информационном разделе игрового центра в Xbox One и помогает клиентам узнать больше о вашей игре.This description appears in the Information section of the Game Hub on Xbox One, and helps customers understand more about your game.
shortTitleshortTitle строкаstring Краткая версия названия вашего продукта.A shorter version of your product’s name. Если оно указывается, это короткое название может отображаться в различных местах на Xbox One (во время установки, при получении достижения т. д.) вместо полного названия продукта.If provided, this shorter name may appear in various places on Xbox One (during installation, in Achievements, etc.) in place of the full title of your product.
sortTitlesortTitle строкаstring Если ваш продукт можно добавить в алфавитный список разными способами, вы можете ввести другую версию названия в этом поле.If your product could be alphabetized in different ways, you can enter another version here. Это может помочь пользователям быстрее найти продукт при поиске.This may help customers find the product more quickly when searching.
voiceTitlevoiceTitle строкаstring Альтернативное имя вашего продукта, которое, если возможно, можно использовать с голосовыми функциями Xbox One при использовании Kinect или гарнитуры.An alternate name for your product that, if provided, may be used in the audio experience on Xbox One when using Kinect or a headset.
devStudiodevStudio строкаstring Задайте это значение, если хотите включить поле Developed by в описание.Specify this value if you want to include a Developed by field in the listing. (В поле Published by будет указываться отображаемое имя издателя, связанное с вашей учетной записью, независимо от того, указали ли вы значение devStudio.)(The Published by field will list the publisher display name associated with your account, whether or not you provide a devStudio value.)

Ресурс изображенийImage resource

Этот ресурс содержит данные изображений и значков для описания приложения.This resource contains image and icon data for an app listing. Дополнительные сведения об изображениях и значках для описания приложения см. в разделе Снимки экранов приложения и изображения.For more information about images and icons for an app listing, see App screenshots and images. Этот ресурс содержит следующие значения.This resource has the following values.

ЗначениеValue ТипType ОписаниеDescription
fileNamefileName строкаstring Имя файла изображения в ZIP-архиве, который был передан для отправки.The name of the image file in the ZIP archive that you uploaded for the submission.
fileStatusfileStatus строкаstring Состояние файла изображения.The status of the image file. Может иметь одно из следующих значений:This can be one of the following values:
  • НетNone
  • PendingUpload (Ожидает передачи)PendingUpload
  • ОтправкаUploaded
  • PendingDelete (Ожидает удаления)PendingDelete
идентификаторid строкаstring Идентификатор для изображения.The ID for the image. Это значение предоставляется центром партнеров.This value is supplied by Partner Center.
descriptiondescription строкаstring Описание изображения.The description for the image.
imageTypeimageType строкаstring Указывает тип изображения.Indicates the type of the image. В настоящее время поддерживаются перечисленные ниже строки.The following strings are currently supported.

Изображения снимков экрана:Screenshot images:

  • Screenshot (используйте это значение для снимка экрана рабочего стола)Screenshot (use this value for the desktop screenshot)
  • MobileScreenshot (Снимок экрана мобильного устройства)MobileScreenshot
  • XboxScreenshot (Снимок экрана Xbox)XboxScreenshot
  • SurfaceHubScreenshot (Снимок экрана SurfaceHub)SurfaceHubScreenshot
  • HoloLensScreenshot (Снимок экрана HoloLens)HoloLensScreenshot

Логотипы магазина:Store logos:

  • StoreLogo9x16StoreLogo9x16
  • StoreLogoSquareStoreLogoSquare
  • Icon (используйте это значение для логотипа 1:1 300 x 300 пикселей)Icon (use this value for the 1:1 300 x 300 pixels logo)

Рекламные изображения:Promotional images:

  • PromotionalArt16x9PromotionalArt16x9
  • PromotionalArtwork2400X1200PromotionalArtwork2400X1200

Изображения для Xbox:Xbox images:

  • XboxBrandedKeyArtXboxBrandedKeyArt
  • XboxTitledHeroArtXboxTitledHeroArt
  • XboxFeaturedPromotionalArtXboxFeaturedPromotionalArt

Необязательные рекламные изображения:Optional promotional images:

  • SquareIcon358X358SquareIcon358X358
  • BackgroundImage1000X800BackgroundImage1000X800
  • PromotionalArtwork414X180PromotionalArtwork414X180

Ресурс параметров игрыGaming options resource

Этот ресурс содержит относящиеся к игре параметры для приложения.This resource contains game-related settings for the app. Значения в этом ресурсе соответствуют параметрам игры для отправки в центре партнеров.The values in this resource correspond to the game settings for submissions in Partner Center.

{
  "gamingOptions": [
    {
      "genres": [
        "Games_ActionAndAdventure",
        "Games_Casino"
      ],
      "isLocalMultiplayer": true,
      "isLocalCooperative": true,
      "isOnlineMultiplayer": false,
      "isOnlineCooperative": false,
      "localMultiplayerMinPlayers": 2,
      "localMultiplayerMaxPlayers": 12,
      "localCooperativeMinPlayers": 2,
      "localCooperativeMaxPlayers": 12,
      "isBroadcastingPrivilegeGranted": true,
      "isCrossPlayEnabled": false,
      "kinectDataForExternal": "Enabled"
    }
  ],
}

Этот ресурс содержит следующие значения.This resource has the following values.

ЗначениеValue ТипType ОписаниеDescription
Жанрыgenres массивеarray Массив из одной или нескольких приведенных ниже строк, которые описывают жанры игры:An array of one or more of the following strings that describe the genres of the game:
  • Games_ActionAndAdventureGames_ActionAndAdventure
  • Games_CardAndBoardGames_CardAndBoard
  • Games_CasinoGames_Casino
  • Games_EducationalGames_Educational
  • Games_FamilyAndKidsGames_FamilyAndKids
  • Games_FightingGames_Fighting
  • Games_MusicGames_Music
  • Games_PlatformerGames_Platformer
  • Games_PuzzleAndTriviaGames_PuzzleAndTrivia
  • Games_RacingAndFlyingGames_RacingAndFlying
  • Games_RolePlayingGames_RolePlaying
  • Games_ShooterGames_Shooter
  • Games_SimulationGames_Simulation
  • Games_SportsGames_Sports
  • Games_StrategyGames_Strategy
  • Games_WordGames_Word
isLocalMultiplayerisLocalMultiplayer Логическоеboolean Указывает, поддерживает ли игра локальный многопользовательский режим.Indicates whether the game supports local multiplayer.
isLocalCooperativeisLocalCooperative Логическоеboolean Указывает, поддерживает ли игра локальный совместный режим.Indicates whether the game supports local co-op.
isOnlineMultiplayerisOnlineMultiplayer Логическоеboolean Указывает, поддерживает ли игра онлайн-многопользовательский режим.Indicates whether the game supports online multiplayer.
isOnlineCooperativeisOnlineCooperative Логическоеboolean Указывает, поддерживает ли игра онлайн-совместный режим.Indicates whether the game supports online co-op.
localMultiplayerMinPlayerslocalMultiplayerMinPlayers INTint Определяет минимальное поддерживаемое число игроков, поддерживаемое игрой в локальном многопользовательском режиме.Specifies the minimum number of players the game supports for local multiplayer.
localMultiplayerMaxPlayerslocalMultiplayerMaxPlayers INTint Определяет максимальное поддерживаемое число игроков, поддерживаемое игрой в локальном многопользовательском режиме.Specifies the maximum number of players the game supports for local multiplayer.
localCooperativeMinPlayerslocalCooperativeMinPlayers INTint Определяет минимальное поддерживаемое число игроков, поддерживаемое игрой в локальном совместном режиме.Specifies the minimum number of players the game supports for local co-op.
localCooperativeMaxPlayerslocalCooperativeMaxPlayers INTint Определяет максимальное поддерживаемое число игроков, поддерживаемое игрой в локальном совместном режиме.Specifies the maximum number of players the game supports for local co-op.
isBroadcastingPrivilegeGrantedisBroadcastingPrivilegeGranted Логическоеboolean Указывает, поддерживает ли игра трансляции.Indicates whether the game supports broadcasting.
isCrossPlayEnabledisCrossPlayEnabled Логическоеboolean Указывает, поддерживает ли игра многопользовательские сеансы между игроками, использующими компьютеры под управлением ОС Windows 10 и устройства Xbox.Indicates whether the game supports multiplayer sessions between players on Windows 10 PCs and Xbox.
kinectDataForExternalkinectDataForExternal строкаstring Одно из следующих строковых значений, указывающее, может ли игра получать данные Kinect и отправлять их внешним службам:One of the following string values that indicates whether the game can collect Kinect data and send it to external services:
  • NotSetNotSet
  • НеизвестноUnknown
  • АктивированоEnabled
  • ВыключеноDisabled

Примечание

Ресурс gamingOptions был добавлен в мае 2017 г. после первого выпуска API отправки в Microsoft Store для разработчиков.The gamingOptions resource was added in May 2017, after the Microsoft Store submission API was first released to developers. Если вы создали отправку для приложения с помощью API отправки до появления этого ресурса и эта отправка все еще выполняется, этот ресурс будет иметь значение null для отправок приложения, пока вы успешно не выполните отправку или не удалите ее.If you created a submission for an app via the submission API before this resource was introduced and this submission is still in progress, this resource will be null for submissions for the app until you successfully commit the submission or you delete it. Если ресурс gamingOptions недоступен для отправок приложения, поле hasAdvancedListingPermission в ресурсе Application, возвращаемом методом получения приложения, будет иметь значение false.If the gamingOptions resource is not available for submissions for an app, the hasAdvancedListingPermission field of the Application resource returned by the get an app method is false.

Ресурс сведений о состоянииStatus details resource

Этот ресурс содержит дополнительные сведения о состоянии отправки.This resource contains additional details about the status of a submission. Этот ресурс содержит следующие значения.This resource has the following values.

ЗначениеValue ТипType ОписаниеDescription
ошибкиerrors объектobject Массив ресурсов сведений о состоянии, который содержит информацию об ошибках для отправки.An array of status detail resources that contain error details for the submission.
warningswarnings объектobject Массив ресурсов сведений о состоянии, который содержит информацию о предупреждениях для отправки.An array of status detail resources that contain warning details for the submission.
certificationReportscertificationReports объектobject Массив ресурсов отчета сертификации, который предоставляет доступ к данным отчета о сертификации для отправки.An array of certification report resources that provide access to the certification report data for the submission. В случае сбоя сертификации можно проверить эти отчеты для получения дополнительной информации.You can examine these reports for more information if the certification fails.

Ресурс сведений о состоянииStatus detail resource

Этот ресурс содержит дополнительные сведения обо всех связанных ошибках или предупреждениях для отправки.This resource contains additional information about any related errors or warnings for a submission. Этот ресурс содержит следующие значения.This resource has the following values.

ЗначениеValue ТипType ОписаниеDescription
codecode строкаstring Код состояния отправки, описывающий тип ошибки или предупреждения.A submission status code that describes the type of error or warning.
подробностиdetails строкаstring Сообщение с дополнительными сведениями о проблеме.A message with more details about the issue.

Ресурс пакета приложенияApplication package resource

Этот ресурс содержит сведения о пакете приложения для отправки.This resource contains details about an app package for the submission.

{
  "applicationPackages": [
    {
      "fileName": "contoso_app.appx",
      "fileStatus": "Uploaded",
      "id": "1152921504620138797",
      "version": "1.0.0.0",
      "architecture": "ARM",
      "languages": [
        "en-US"
      ],
      "capabilities": [
        "ID_RESOLUTION_HD720P",
        "ID_RESOLUTION_WVGA",
        "ID_RESOLUTION_WXGA"
      ],
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None",
      "targetDeviceFamilies": [
        "Windows.Mobile min version 10.0.10240.0"
      ]
    }
  ],
}

Этот ресурс содержит следующие значения.This resource has the following values.

Примечание

При вызове метода для обновления отправки приложения в тексте запроса требуются только значения fileName, fileStatus, minimumDirectXVersion и minimumSystemRam этого объекта.When calling the update an app submission method, only the fileName, fileStatus, minimumDirectXVersion, and minimumSystemRam values of this object are required in the request body. Другие значения заполняются центром партнеров.The other values are populated by Partner Center.

ЗначениеValue ТипType ОписаниеDescription
fileNamefileName строкаstring Имя пакета.The name of the package.
fileStatusfileStatus строкаstring Состояние пакета.The status of the package. Может иметь одно из следующих значений:This can be one of the following values:
  • НетNone
  • PendingUpload (Ожидает передачи)PendingUpload
  • ОтправкаUploaded
  • PendingDelete (Ожидает удаления)PendingDelete
идентификаторid строкаstring Идентификатор, который уникально идентифицирует пакет.An ID that uniquely identifies the package. Это значение предоставляется центром партнеров.This value is provided by Partner Center.
versionversion строкаstring Версия пакета приложения.The version of the app package. Дополнительные сведения см. в разделе Нумерация версий пакета.For more information, see Package version numbering.
архитектураarchitecture строкаstring Архитектура пакета (например, ARM).The architecture of the package (for example, ARM).
языкиlanguages массивеarray Массив кодов языков, которые поддерживает приложение.An array of language codes for the languages the app supports. Дополнительные сведения см. в списке поддерживаемых языков.For more information, see Supported languages.
capabilitiescapabilities массивеarray Массив возможностей, необходимых для этого пакета.An array of capabilities required by the package. Дополнительные сведения о возможностях см. в разделе Объявления возможностей приложения.For more information about capabilities, see App capability declarations.
minimumDirectXVersionminimumDirectXVersion строкаstring Минимальная версия DirectX, поддерживаемая пакетом приложения.The minimum DirectX version that is supported by the app package. Может задаваться только для приложений, предназначенных для Windows 8.x.This can be set only for apps that target Windows 8.x. Для приложений, предназначенных для других версий ОС, это значение должно присутствовать при вызове метода обновления отправки приложения, но указанное значение игнорируется.For apps that target other OS versions, this value must be present when calling the update an app submission method but the value you specify is ignored. Может иметь одно из следующих значений:This can be one of the following values:
  • НетNone
  • DirectX93DirectX93
  • DirectX100DirectX100
minimumSystemRamminimumSystemRam строкаstring Минимальный объем ОЗУ, необходимый для пакета приложения.The minimum RAM that is required by the app package. Может задаваться только для приложений, предназначенных для Windows 8.x.This can be set only for apps that target Windows 8.x. Для приложений, предназначенных для других версий ОС, это значение должно присутствовать при вызове метода обновления отправки приложения, но указанное значение игнорируется.For apps that target other OS versions, this value must be present when calling the update an app submission method but the value you specify is ignored. Может иметь одно из следующих значений:This can be one of the following values:
  • НетNone
  • Memory2GBMemory2GB
targetDeviceFamiliestargetDeviceFamilies массивеarray Массив строк, представляющих семейства устройств, для которых предназначен пакет.An array of strings that represent the device families that the package targets. Это значение используется только для пакетов, предназначенных для Windows 10; для пакетов, предназначенных для предыдущих выпусков, это значение равно None.This value is used only for packages that target Windows 10; for packages that target earlier releases, this value has the value None. В настоящее время в пакетах Windows 10 поддерживаются следующие строки семейства устройств, где {0} — это строка версии Windows 10, например 10.0.10240.0, 10.0.10586.0 или 10.0.14393.0:The following device family strings are currently supported for Windows 10 packages, where {0} is a Windows 10 version string such as 10.0.10240.0, 10.0.10586.0 or 10.0.14393.0:
  • Windows. Универсальная минимальная версия {0}Windows.Universal min version {0}
  • Минимальная версия Windows. Desktop {0}Windows.Desktop min version {0}
  • Минимальная версия Windows. Mobile {0}Windows.Mobile min version {0}
  • Версия Windows. Xbox min {0}Windows.Xbox min version {0}
  • Минимальная версия Windows. holographic {0}Windows.Holographic min version {0}

Ресурс отчета о сертификацииCertification report resource

Этот ресурс предоставляет доступ к данным отчета о сертификации для отправки.This resource provides access to the certification report data for a submission. Этот ресурс содержит следующие значения.This resource has the following values.

ЗначениеValue ТипType ОписаниеDescription
Датаdate строкаstring Дата и время создания отчета в формате ISO 8601.The date and time the report was generated, in ISO 8601 format.
reportUrlreportUrl строкаstring URL-адрес, по которому можно получить доступ к отчету.The URL at which you can access the report.

Ресурс параметров доставки пакетаPackage delivery options resource

Этот ресурс содержит постепенный выпуск пакета и обязательные параметры обновления для отправки.This resource contains gradual package rollout and mandatory update settings for the submission.

{
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
}

Этот ресурс содержит следующие значения.This resource has the following values.

ЗначениеValue ТипType ОписаниеDescription
packageRolloutpackageRollout объектobject Ресурс выпуска пакета, который содержит параметры постепенного выпуска пакета для отправки.A package rollout resource that contains gradual package rollout settings for the submission.
isMandatoryUpdateisMandatoryUpdate Логическоеboolean Указывает, следует ли рассматривать пакеты в этой отправке как обязательные для самоустанавливающихся обновлений приложений.Indicates whether you want to treat the packages in this submission as mandatory for self-installing app updates. Дополнительные сведения об обязательных пакетах самоустанавливаемых обновлений приложений см. в разделе Загрузка и установка обновлений пакетов для приложения.For more information about mandatory packages for self-installing app updates, see Download and install package updates for your app.
mandatoryUpdateEffectiveDatemandatoryUpdateEffectiveDate Датаdate Дата и время, когда пакеты в этой отправке станут обязательными, в формате ISO 8601 и по часовому поясу UTC.The date and time when the packages in this submission become mandatory, in ISO 8601 format and UTC time zone.

Ресурс выпуска пакетаPackage rollout resource

Этот ресурс содержит параметры постепенного выпуска пакета для отправки.This resource contains gradual package rollout settings for the submission. Этот ресурс содержит следующие значения.This resource has the following values.

ЗначениеValue ТипType ОписаниеDescription
isPackageRolloutisPackageRollout Логическоеboolean Указывает, включен ли постепенный выпуск пакета для этой отправки.Indicates whether gradual package rollout is enabled for the submission.
packageRolloutPercentagepackageRolloutPercentage FLOATfloat Процент пользователей, которые будут получать пакеты при постепенном выпуске.The percentage of users who will receive the packages in the gradual rollout.
packageRolloutStatuspackageRolloutStatus строкаstring Одна из следующих строк, указывающая состояние постепенного выпуска пакета:One of the following strings that indicates the status of the gradual package rollout:
  • PackageRolloutNotStartedPackageRolloutNotStarted
  • PackageRolloutInProgressPackageRolloutInProgress
  • PackageRolloutCompletePackageRolloutComplete
  • PackageRolloutStoppedPackageRolloutStopped
fallbackSubmissionIdfallbackSubmissionId строкаstring ИД отправки, который будет поступать от пользователей, не получающих пакеты постепенного выпуска.The ID of the submission that will be received by customers who do not get the gradual rollout packages.

Примечание

Значения паккажероллаутстатус и Фаллбакксубмиссионид назначаются центром партнеров и не предназначены для установки разработчиком.The packageRolloutStatus and fallbackSubmissionId values are assigned by Partner Center, and are not intended to be set by the developer. Если эти значения содержатся в теле запроса, они будут проигнорированы.If you include these values in a request body, these values will be ignored.

Ресурс трейлеровTrailers resource

Этот ресурс представляет видеотрейлер для описания приложения.This resource represents a video trailer for the app listing. Значения в этом ресурсе соответствуют параметрам трейлеров для отправки в центре партнеров.The values in this resource correspond to the trailers options for submissions in Partner Center.

Можно добавить до 15 ресурсов трейлеров в массив trailers в ресурсе отправки приложения.You can add up to 15 trailer resources to the trailers array in an app submission resource. Для отправки видеофайлов трейлеров и эскизов изображений для отправки поместите эти файлы в ZIP-архив, содержащий пакеты и изображения для описания для этой отправки, а затем передайте этот ZIP-архив URI подписанного URL-адреса (SAS) для отправки.To upload trailer video files and thumbnail images for a submission, add these files to the same ZIP archive that contains the packages and listing images for the submission, and then upload this ZIP archive to the shared access signature (SAS) URI for the submission. Дополнительные сведения по передаче ZIP-архива URI подписанного URL-адреса (SAS) см. в разделе Создание отправки приложения.For more information uploading the ZIP archive to the SAS URI, see Create an app submission.

{
  "trailers": [
    {
      "id": "1158943556954955699",
      "videoFileName": "Trailers\\ContosoGameTrailer.mp4",
      "videoFileId": "1159761554639123258",
      "trailerAssets": {
        "en-us": {
          "title": "Contoso Game",
          "imageList": [
            {
              "fileName": "Images\\ContosoGame-Thumbnail.png",
              "id": "1155546904097346923",
              "description": "This is a still image from the video."
            }
          ]
        }
      }
    }
  ]
}

Этот ресурс содержит следующие значения.This resource has the following values.

ЗначениеValue ТипType ОписаниеDescription
идентификаторid строкаstring Идентификатор для трейлера.The ID for the trailer. Это значение предоставляется центром партнеров.This value is provided by Partner Center.
videoFileNamevideoFileName строкаstring Имя файла видеотрейлера в ZIP-архиве, который содержит файлы для отправки.The name of the trailer video file in the ZIP archive that contains files for the submission.
videoFileIdvideoFileId строкаstring Идентификатор файла видеотрейлера.The ID for the trailer video file. Это значение предоставляется центром партнеров.This value is provided by Partner Center.
trailerAssetstrailerAssets объектobject Словарь пар "ключ-значение", где каждый ключ является кодом языка, а каждое значение — набором ресурсов трейлера, содержащим относящиеся к языковым стандартам ресурсы для трейлера.A dictionary of key and value pairs, where each key is a language code and each value is a trailer assets resource that contains additional locale-specific assets for the trailer. Дополнительные сведения о кодах поддерживаемых языков см. в разделе Поддерживаемые языки.For more information about the supported language codes, see Supported languages.

Примечание

Ресурс trailers был добавлен в мае 2017 г. после первого выпуска API отправки в Microsoft Store для разработчиков.The trailers resource was added in May 2017, after the Microsoft Store submission API was first released to developers. Если вы создали отправку для приложения с помощью API отправки до появления этого ресурса и эта отправка все еще выполняется, этот ресурс будет иметь значение null для отправок приложения, пока вы успешно не выполните отправку или не удалите ее.If you created a submission for an app via the submission API before this resource was introduced and this submission is still in progress, this resource will be null for submissions for the app until you successfully commit the submission or you delete it. Если ресурс trailers недоступен для отправок приложения, поле hasAdvancedListingPermission в ресурсе Application, возвращаемом методом получения приложения, будет иметь значение false.If the trailers resource is not available for submissions for an app, the hasAdvancedListingPermission field of the Application resource returned by the get an app method is false.

Набор ресурсов трейлераTrailer assets resource

Этот ресурс содержит дополнительные данные, относящиеся к языковым стандартам, для трейлера, который определен в ресурсе трейлера.This resource contains additional locale-specific assets for a trailer that is defined in a trailer resource. Этот ресурс содержит следующие значения.This resource has the following values.

ЗначениеValue ТипType ОписаниеDescription
titletitle строкаstring Локализованное название трейлера.The localized title of the trailer. Заголовок отображается, когда пользователь воспроизводит трейлер в полноэкранном режиме.The title is displayed when the user plays the trailer in full screen mode.
imageListimageList массивеarray Массив, содержащий один ресурс image, который предоставляет эскиз для трейлера.An array that contains one image resource that provides the thumbnail image for the trailer. В этот массив можно включать только один ресурс image.You can only include one image resource in this array.

Ресурс изображения (для трейлера)Image resource (for a trailer)

Этот ресурс описывает эскиз для трейлера.This resource describes the thumbnail image for a trailer. Этот ресурс содержит следующие значения.This resource has the following values.

ЗначениеValue ТипType ОписаниеDescription
fileNamefileName строкаstring Имя файла эскиза в ZIP-архиве, который был передан для отправки.The name of the thumbnail image file in the ZIP archive that you uploaded for the submission.
идентификаторid строкаstring Идентификатор для эскиза.The ID for the thumbnail image. Это значение предоставляется центром партнеров.This value is provided by Partner Center.
descriptiondescription строкаstring Описание эскиза.The description for the thumbnail image. Это значение представляет собой лишь метаданные и не отображается пользователям.This value is metadata only, and is not displayed to users.

ПеречисленияEnums

Эти методы используют следующие перечисления.These methods use the following enums.

Ценовые категорииPrice tiers

Следующие значения представляют доступные ценовые категории в ресурсе ценовой ресурс для отправки приложения.The following values represent available price tiers in the pricing resource resource for an app submission.

ЗначениеValue ОписаниеDescription
ОсновнойBase Ценовая категория не задана; используется базовая цена для приложения.The price tier is not set; use the base price for the app.
NotAvailableNotAvailable Приложение недоступно в указанном регионе.The app is not available in the specified region.
FreeFree Это бесплатное приложение.The app is free.
TierxxxTierxxx Строка, указывающая ценовую категорию приложения в формате Tierxxxx.A string that specifies the price tier for the app, in the format Tierxxxx. В настоящее время поддерживаются следующие ценовые категории.Currently, the following ranges of price tiers are supported:

  • Если значение isAdvancedPricingModelценового ресурсаtrue, для вашей учетной записи доступны такие ценовые категории: Tier1012 - Tier1424.If the isAdvancedPricingModel value of the pricing resource is true, the available price tier values for your account are Tier1012 - Tier1424.
  • Если значение isAdvancedPricingModelценового ресурсаfalse, для вашей учетной записи доступны такие ценовые категории: Tier2 - Tier96.If the isAdvancedPricingModel value of the pricing resource is false, the available price tier values for your account are Tier2 - Tier96.
Чтобы просмотреть полную таблицу ценовых уровней, доступных для вашей учетной записи разработчика, включая цены, связанные с каждым из уровней рынка, перейдите на страницу цены и доступности для всех отправок приложения в центре партнеров и щелкните ссылку Просмотреть таблицу в разделе " рынки и настраиваемые цены " (для некоторых учетных записей разработчиков эта ссылка находится в разделе " цены ").To see the complete table of price tiers that are available for your developer account, including the market-specific prices that are associated with each tier, go to the Pricing and availability page for any of your app submissions in Partner Center and click the view table link in the Markets and custom prices section (for some developer accounts, this link is in the Pricing section).

Значения корпоративного лицензированияEnterprise licensing values

Следующие значения представляют поведение корпоративного лицензирования для приложения.The following values represent the organizational licensing behavior for the app. Дополнительные сведения об этих параметрах см. в разделе Параметры корпоративного лицензирования.For more information about these options, see Organizational licensing options.

Примечание

Хотя параметры корпоративного лицензирования можно настроить для отправки приложения с помощью API отправки, этот API нельзя использовать для публикации отправок для приобретения в больших объемах через Microsoft Store для бизнеса и Microsoft Store для образования.Although you can configure the organizational licensing options for an app submission via the submission API, you cannot use this API to publish submissions for volume purchases through the Microsoft Store for Business and Microsoft Store for Education. Чтобы опубликовать отправку в Microsoft Store для бизнеса и Microsoft Store для образовательных учреждений, необходимо использовать центр партнеров.To publish submissions to the Microsoft Store for Business and Microsoft Store for Education, you must use Partner Center.

ЗначениеValue ОписаниеDescription
NoneNone Приложение недоступно организациям путем корпоративного лицензирования от Магазина (в режиме онлайн).Do not make your app available to enterprises with Store-managed (online) volume licensing.
Миграция по сетиOnline Приложение доступно организациям путем корпоративного лицензирования от Магазина (в режиме онлайн).Make your app available to enterprises with Store-managed (online) volume licensing.
OnlineAndOfflineOnlineAndOffline Приложение доступно организациям путем корпоративного лицензирования от Магазина (в режиме онлайн); кроме того, приложение доступно организациям путем лицензирования без подключения (в автономном режиме).Make your app available to enterprises with Store-managed (online) volume licensing, and make your app available to enterprises via disconnected (offline) licensing.

Код состояния отправкиSubmission status code

Следующие значения представляют код состояния отправки.The following values represent the status code of a submission.

ЗначениеValue ОписаниеDescription
NoneNone Код не указан.No code was specified.
InvalidArchiveInvalidArchive ZIP-архив, содержащий пакет, является недопустимым или имеет неизвестный формат архива.The ZIP archive containing the package is invalid or has an unrecognized archive format.
MissingFilesMissingFiles В ZIP-архиве отсутствуют файлы, перечисленные в данных отправки, или они находятся в неправильном месте в архиве.The ZIP archive does not have all files which were listed in your submission data, or they are in the wrong location in the archive.
PackageValidationFailedPackageValidationFailed Один или несколько пакетов в вашей отправке не прошли проверку.One or more packages in your submission failed to validate.
InvalidParameterValueInvalidParameterValue Один из параметров в теле запроса не является допустимым.One of the parameters in the request body is invalid.
InvalidOperationInvalidOperation Операция, которую вы пытались выполнить, является недопустимой.The operation you attempted is invalid.
InvalidStateInvalidState Операция, которую вы пытались выполнить, является недопустимой для текущего состояния тестового пакета.The operation you attempted is not valid for the current state of the package flight.
ResourceNotFoundResourceNotFound Не удалось найти указанный тестовый пакет.The specified package flight could not be found.
ServiceErrorServiceError Запрос не был успешно выполнен из-за внутренней ошибки службы.An internal service error prevented the request from succeeding. Попробуйте повторить запрос.Try the request again.
ListingOptOutWarningListingOptOutWarning Разработчик удалил описание из предыдущей отправки или не включил данные описания, которые поддерживаются пакетом.The developer removed a listing from a previous submission, or did not include listing information that is supported by the package.
ListingOptInWarningListingOptInWarning Разработчик добавил описание.The developer added a listing.
UpdateOnlyWarningUpdateOnlyWarning Разработчик пытается вставить какой-то элемент, который имеет только поддержку обновления.The developer is trying to insert something that only has update support.
ДругоеOther Отправка находится в неизвестном состоянии или состоянии, не отнесенном ни к одной из категорий.The submission is in an unrecognized or uncategorized state.
PackageValidationWarningPackageValidationWarning В процессе проверки пакета создано предупреждение.The package validation process resulted in a warning.