Прочитать на английском

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

Получение данных приложения

  • Статья

Используйте следующие методы в API отправки Microsoft Store, чтобы получить данные для существующих приложений в учетной записи Центра партнеров. Общие сведения об API отправки Microsoft Store, включая предварительные требования для использования API, см. в статье "Создание отправки и управление ими с помощью служб Microsoft Store".

Прежде чем использовать эти методы, приложение должно уже существовать в учетной записи Центра партнеров. Сведения о создании и управлении отправками для приложений см. в статье "Управление отправками приложений".

Method URI Description
GET https://manage.devcenter.microsoft.com/v1.0/my/applications Получение данных для всех приложений
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId} Получение данных для конкретного приложения
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listinappproducts Получение надстроек для приложения
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listflights Получение пакетов для приложения

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

Если это еще не сделано, выполните все предварительные требования для API отправки Microsoft Store, прежде чем пытаться использовать любой из этих методов.

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

Методы API отправки Microsoft Store для получения данных приложения используют следующие ресурсы данных JSON.

ресурс приложения.

Этот ресурс представляет приложение, зарегистрированное в вашей учетной записи.

JSON 
{
  "id": "9NBLGGH4R315",
  "primaryName": "ApiTestApp",
  "packageFamilyName": "30481DevCenterAPITester.ApiTestAppForDevbox_ng6try80pwt52",
  "packageIdentityName": "30481DevCenterAPITester.ApiTestAppForDevbox",
  "publisherName": "CN=…",
  "firstPublishedDate": "1601-01-01T00:00:00Z",
  "lastPublishedApplicationSubmission": {
    "id": "1152921504621086517",
    "resourceLocation": "applications/9NBLGGH4R315/submissions/1152921504621086517"
  },
  "pendingApplicationSubmission": {
    "id": "1152921504621243487",
    "resourceLocation": "applications/9NBLGGH4R315/submissions/1152921504621243487"
  },
  "hasAdvancedListingPermission": true
}

Этот ресурс имеет следующие значения.

Значение Тип Описание
id строка Идентификатор магазина приложения. Дополнительные сведения об идентификаторе Магазина см. в разделе "Просмотр сведений об удостоверении приложения".
primaryName строка Основное имя приложения.
packageFamilyName строка Имя семейства пакетов приложения.
packageIdentityName строка Имя удостоверения пакета приложения.
publisherName строка Идентификатор издателя Windows, связанный с приложением. Это соответствует значению пакета, удостоверения или издателя , которое отображается на странице удостоверений приложения для приложения в Центре партнеров.
firstPublishedDate строка Дата публикации приложения в формате ISO 8601.
lastPublishedApplicationSubmission объект Ресурс отправки, предоставляющий сведения о последней опубликованной отправке приложения.
pendingApplicationSubmission объект Ресурс отправки, предоставляющий сведения о текущей ожидающей отправке приложения.
hasAdvancedListingPermission boolean Указывает, можно ли настроить gamingOptions или трейлеры для отправки приложения. Это значение верно для отправки, созданных после мая 2017 года.

Ресурс надстройки

Этот ресурс содержит сведения о надстройке.

JSON 
{
    "inAppProductId": "9WZDNCRD7DLK"
}

Этот ресурс имеет следующие значения.

Значение Тип Описание
inAppProductId строка Идентификатор магазина надстройки. Это значение предоставляется Магазином. Пример идентификатора магазина — 9NBLGGH4TNMP.

Тестовый ресурс

Этот ресурс содержит сведения о тестовом пакете для приложения.

JSON 
{
    "flightId": "7bfc11d5-f710-47c5-8a98-e04bb5aad310",
    "friendlyName": "myflight",
    "lastPublishedFlightSubmission": {
        "id": "1152921504621086517",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621086517"
    },
    "pendingFlightSubmission": {
        "id": "1152921504621215786",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621215786"
    },
    "groupIds": [
        "1152921504606962205"
    ],
    "rankHigherThan": "Non-flighted submission"
}

Этот ресурс имеет следующие значения.

Значение Тип Описание
flightId строка Идентификатор для тестового пакета. Это значение предоставляется Центром партнеров.
friendlyName строка Имя тестового пакета, указанное разработчиком.
lastPublishedFlightSubmission объект Ресурс отправки, предоставляющий сведения о последней опубликованной отправке для тестового пакета.
pendingFlightSubmission объект Ресурс отправки, предоставляющий сведения о текущей ожидающей отправке для тестового пакета.
groupIds array Массив строк, содержащих идентификаторы групп полетов, связанных с полетом пакета. Дополнительные сведения о группах полетов см. в разделе "Пакеты полетов".
rankHigherThan строка Понятное имя тестового пакета, которое ранжируется сразу же ниже текущего тестового пакета. Дополнительные сведения о ранжировании групп полетов см. в разделе "Пакеты полетов".

Ресурс отправки

Этот ресурс содержит сведения о отправке. В следующем примере показан формат этого ресурса.

JSON 
{
  "pendingApplicationSubmission": {
    "id": "1152921504621243487",
    "resourceLocation": "applications/9WZDNCRD9MMD/submissions/1152921504621243487"
  }
}

Этот ресурс имеет следующие значения.

Значение Тип Описание
id строка Идентификатор отправки.
resourceLocation строка Относительный путь, который можно добавить к URI базового https://manage.devcenter.microsoft.com/v1.0/my/ запроса, чтобы получить полные данные для отправки.