Обновление заявки на надстройку

Статья
2025-03-29

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

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

Необходимые условия

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

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

Просьба

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

Метод	URI запроса
КЛАСТЬ	`https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}/submissions/{submissionId}`

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

Заголовок	Тип	Описание
Авторизация	струна	Обязательно. Токен доступа Azure AD в формате токен Bearer<токена>.

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

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

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

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

Ценность	Тип	Описание
тип контента	струна	Тип содержимого, предоставляемый в надстройке. Это может быть одно из следующих значений: Не установлено ЗагрузкаКниг EMagazine ЕГазета ЗагрузкаМузыки MusicStream OnlineDataStorage ЗагрузкаВидео VideoStream Гадюка ОнлайнЗагрузка
Ключевые слова	массив	Массив строк, содержащих до 10 ключевых слов для дополнения. Приложение может запрашивать надстройки с помощью этих ключевых слов.
продолжительность жизни	струна	Срок службы надстройки. Это может быть одно из следующих значений: Навсегда OneDay ThreeDays FiveDays OneWeek TwoWeeks ОдинМесяц ДваМесяца ТриМесяца Шесть месяцев Один год
Объявления	объект	Объект, содержащий информацию о списке для надстройки. Дополнительные сведения см. в разделе «Перечисление ресурсов».
ценообразование	объект	Объект, содержащий сведения о ценах для дополнения. Дополнительные сведения см. в ресурсах по ценообразованию .
режим публикации цели	струна	Режим публикации для отправки. Это может быть одно из следующих значений: Немедленный Вручную КонкретнаяДата
целеваяДатаПубликации	струна	Дата публикации для отправки в формате ISO 8601, если targetPublishMode установлен на SpecificDate.
ярлык	струна	Настраиваемые данные разработчика для плагина (эта информация ранее называлась тегом ).
видимость	струна	Видимость надстройки. Это может быть одно из следующих значений: Скрытый Публичный Частный Не установлено

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

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

PUT https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/9NBLGGH4TNMP/submissions/1152921504621230023 HTTP/1.1
Authorization: Bearer <your access token>
Content-Type: application/json
{
  "contentType": "EMagazine",
  "keywords": [
    "books"
  ],
  "lifetime": "FiveDays",
  "listings": {
    "en": {
      "description": "English add-on description",
      "icon": {
        "fileName": "add-on-en-us-listing2.png",
        "fileStatus": "Uploaded"
      },
      "title": "Add-on Title (English)"
    },
    "ru": {
      "description": "Russian add-on description",
      "icon": {
        "fileName": "add-on-ru-listing.png",
        "fileStatus": "Uploaded"
      },
      "title": "Add-on Title (Russian)"
    }
  },
  "pricing": {
    "marketSpecificPricings": {
      "RU": "Tier3",
      "US": "Tier4",
    },
    "sales": [],
    "priceId": "Free"
  },
  "targetPublishDate": "2016-03-15T05:10:58.047Z",
  "targetPublishMode": "Immediate",
  "tag": "SampleTag",
  "visibility": "Public",
}

Ответ

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

{
  "id": "1152921504621243680",
  "contentType": "EMagazine",
  "keywords": [
    "books"
  ],
  "lifetime": "FiveDays",
  "listings": {
    "en": {
      "description": "English add-on description",
      "icon": {
        "fileName": "add-on-en-us-listing2.png",
        "fileStatus": "Uploaded"
      },
      "title": "Add-on Title (English)"
    },
    "ru": {
      "description": "Russian add-on description",
      "icon": {
        "fileName": "add-on-ru-listing.png",
        "fileStatus": "Uploaded"
      },
      "title": "Add-on Title (Russian)"
    }
  },
  "pricing": {
    "marketSpecificPricings": {
      "RU": "Tier3",
      "US": "Tier4",
    },
    "sales": [],
    "priceId": "Free"
  },
  "targetPublishDate": "2016-03-15T05:10:58.047Z",
  "targetPublishMode": "Immediate",
  "tag": "SampleTag",
  "visibility": "Public",
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [
      {
        "code": "None",
        "details": "string"
      }
    ],
    "warnings": [
      {
        "code": "ListingOptOutWarning",
        "details": "You have removed listing language(s): []"
      }
    ],
    "certificationReports": [
      {
      }
    ]
  },
  "fileUploadUrl": "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",
  "friendlyName": "Submission 2"
}

Коды ошибок

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

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