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

Обновление отправки надстройки

  • Статья

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

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

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

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

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

Запросить

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

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

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

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

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

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

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

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

Значение Тип Описание
contentType строка Тип содержимого , предоставленного в надстройке. Это может быть одно из следующих значений:
  • NotSet
  • BookDownload
  • EMagazine
  • ENewspaper
  • MusicDownload
  • MusicStream
  • OnlineDataStorage
  • VideoDownload
  • VideoStream
  • Гадюка
  • OnlineDownload
ключевые слова array Массив строк, содержащих до 10 ключевых слов для надстройки. Приложение может запрашивать надстройки с помощью этих ключевых слов.
lifetime строка Время существования надстройки. Это может быть одно из следующих значений:
  • Постоянно
  • OneDay
  • ThreeDays
  • FiveDays
  • OneWeek
  • TwoWeeks
  • OneMonth
  • TwoMonths
  • ТриMonths
  • ШестьMonths
  • OneYear
Предложения объект Объект, содержащий сведения о списке для надстройки. Дополнительные сведения см. в разделе "Список ресурсов".
цены объект Объект, содержащий сведения о ценах для надстройки. Дополнительные сведения см. в разделе "Ценовые ресурсы".
targetPublishMode строка Режим публикации для отправки. Это может быть одно из следующих значений:
  • Интерпретация
  • Руководство
  • SpecificDate
targetPublishDate строка Дата публикации для отправки в формате ISO 8601, если targetPublishMode имеет значение SpecificDate.
тег строка Пользовательские данные разработчика для надстройки (эта информация ранее называлась тегом).
видимость строка Видимость надстройки. Это может быть одно из следующих значений:
  • Скрыт
  • Общедоступные
  • Личные
  • NotSet

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

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

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",
}

Response

В следующем примере показан текст ответа 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.