Обновление отправки приложения

Статья
07/05/2024

Используйте этот метод в API отправки Microsoft Store для обновления существующей отправки приложения. После успешного обновления отправки с помощью этого метода необходимо зафиксировать отправку для приема и публикации.

Дополнительные сведения о том, как этот метод вписывается в процесс создания отправки приложения с помощью API отправки в Microsoft Store, см. в разделе "Управление отправкой приложений".

Необходимые компоненты

Чтобы использовать этот метод, сначала необходимо выполнить следующие действия:

Если вы этого еще не сделали, выполните все предварительные требования для API отправки Microsoft Store.
Получите маркер доступа Azure AD для использования в заголовке запроса для этого метода. После получения маркера доступа у вас будет 60 минут, чтобы использовать его до истечения срока действия. После истечения срока действия маркера можно получить новый.
Создайте отправку для одного из приложений. Это можно сделать в Центре партнеров или сделать это с помощью метода отправки приложения.

Запросить

Этот метод имеет следующий синтаксис. В следующих разделах приведены примеры использования и описания текста заголовка и запроса.

Способ	URI запроса
PUT	`https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}`

Заголовок запроса

Верхний колонтитул	Тип	Описание
Авторизация	строка	Обязательный. Маркер доступа Azure AD в маркере> носителя<формы.

Параметры запроса

Имя.	Тип	Описание
applicationId	строка	Обязательный. Идентификатор магазина приложения, для которого требуется обновить отправку. Дополнительные сведения об идентификаторе Магазина см. в разделе "Просмотр сведений об удостоверении приложения".
submissionId	строка	Обязательный. Идентификатор обновляемой отправки. Этот идентификатор доступен в данных ответа для запросов на создание отправки приложения. Для отправки, созданной в Центре партнеров, этот идентификатор также доступен в URL-адресе страницы отправки в Центре партнеров.

Текст запроса

Текст запроса имеет следующие параметры.

Значение	Тип	Описание
applicationCategory	строка	Строка, указывающая категорию и (или) подкатегорию для приложения. Категории и подкатегории объединяются в одну строку с символом подчеркивания "_", например BooksAndReference_EReader.
цены	объект	Объект, содержащий сведения о ценах для приложения. Дополнительные сведения см. в разделе "Ценовые ресурсы ".
видимость	строка	Видимость приложения. Это может быть одно из следующих значений: Скрыт Общедоступные Личные NotSet
targetPublishMode	строка	Режим публикации для отправки. Это может быть одно из следующих значений: Интерпретация Руководство SpecificDate
targetPublishDate	строка	Дата публикации для отправки в формате ISO 8601, если targetPublishMode имеет значение SpecificDate.
Предложения	объект	Словарь пар "ключ" и "значение", где каждый ключ является кодом страны, а каждое значение — это объект ресурса "Перечисление", содержащий сведения о списке для приложения.
hardwarePreferences	array	Массив строк, определяющих параметры оборудования для приложения. Это может быть одно из следующих значений: Сенсорный ввод Клавиатура Мышь Камера NfcHce Nfc BluetoothLE Телефония
automaticBackupEnabled	boolean	Указывает, могут ли Windows включать данные приложения в автоматические резервные копии в OneDrive. Дополнительные сведения см . в объявлениях приложений.
canInstallOnRemovableMedia	boolean	Указывает, могут ли клиенты устанавливать приложение в съемный хранилище. Дополнительные сведения см . в объявлениях приложений.
isGameDvrEnabled	boolean	Указывает, включена ли dvR игры для приложения.
Игровыеoptions	объект	Массив, содержащий один ресурс игровых параметров, определяющий параметры, связанные с игрой, для приложения.
hasExternalInAppProducts	boolean	Указывает, позволяет ли ваше приложение совершать покупки за пределами коммерческой системы Microsoft Store. Дополнительные сведения см . в объявлениях приложений.
meetAccessibilityGuidelines	boolean	Указывает, проверено ли ваше приложение в соответствии с рекомендациями по специальным возможностям. Дополнительные сведения см . в объявлениях приложений.
notesForCertification	строка	Содержит заметки о сертификации для приложения.
applicationPackages	array	Содержит объекты, предоставляющие сведения о каждом пакете в отправке. Дополнительные сведения см. в разделе "Пакет приложения". При вызове этого метода для обновления отправки приложения в тексте запроса требуются только значения fileName, fileStatus, minimumDirectXVersion и minimumSystemRam этих объектов. Остальные значения заполняются Центром партнеров.
packageDeliveryOptions	объект	Содержит постепенное развертывание пакета и обязательные параметры обновления для отправки. Дополнительные сведения см. в разделе "Параметры доставки пакетов".
enterpriseLicensing	строка	Одно из значений корпоративного лицензирования, указывающее поведение корпоративного лицензирования для приложения.
allowMicrosftDecideAppAvailabilityToFutureDeviceFamilies	boolean	Указывает, разрешено ли майкрософт сделать приложение доступным для будущих семейств устройств Windows 10 и Windows 11.
allowTargetFutureDeviceFamilies	boolean	Указывает, разрешено ли приложению использовать будущие семейства устройств Windows 10 и Windows 11.
Прицепы	array	Массив, содержащий до ресурсов трейлера, представляющих видео трейлеры для описания приложения.

Пример запроса

В следующем примере показано, как обновить отправку приложения.

PUT https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/submissions/1152921504621230023 HTTP/1.1
Authorization: Bearer <your access token>
Content-Type: application/json
{
  "applicationCategory": "BooksAndReference_EReader",
  "pricing": {
    "trialPeriod": "FifteenDays",
    "marketSpecificPricings": {},
    "sales": [],
    "priceId": "Tier2"
  },
  "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",
            "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": "",
  "applicationPackages": [
    {
      "fileName": "contoso_app.appx",
      "fileStatus": "PendingUpload",
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None"
    }
  ],
  "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
  },
  "trailers": []
}

Response

В следующем примере показан текст ответа JSON для успешного вызова этого метода. Текст ответа содержит сведения об обновленной отправке. Дополнительные сведения о значениях в тексте ответа см. в ресурсе отправки приложений.

{
  "id": "1152921504621243540",
  "applicationCategory": "BooksAndReference_EReader",
  "pricing": {
    "trialPeriod": "FifteenDays",
    "marketSpecificPricings": {},
    "sales": [],
    "priceId": "Tier2"
  },
  "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",
            "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": "PendingUpload",
      "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": []
}

Коды ошибок

Если запрос не может быть выполнен успешно, ответ будет содержать один из следующих кодов ошибок HTTP.

Код ошибки	Описание:
400	Не удалось обновить отправку, так как запрос недопустим.
409	Не удалось обновить отправку из-за текущего состояния приложения или приложение использует функцию Центра партнеров, которая в настоящее время не поддерживается API отправки в Microsoft Store.

Поделиться через

Обновление отправки приложения

Необходимые компоненты

Запросить

Заголовок запроса

Параметры запроса

Текст запроса

Пример запроса

Response

Коды ошибок

Обратная связь

Дополнительные ресурсы

Поделиться через

Обновление отправки приложения

Необходимые компоненты

Запросить

Заголовок запроса

Параметры запроса

Текст запроса

Пример запроса

Response

Коды ошибок

См. также

Обратная связь

Дополнительные ресурсы