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

  • Статья

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

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

Метод URI Описание
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.

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

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

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

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

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

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

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

{
    "inAppProductId": "9WZDNCRD7DLK"
}

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

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

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

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

{
    "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 object Ресурс отправки, который предоставляет сведения о последней опубликованной отправке для тестового пакета.
pendingFlightSubmission object Ресурс отправки, который предоставляет сведения о текущей ожидающей отправке для тестового пакета.
groupIds array Массив строк, содержащий идентификаторы тестовых групп, которые связаны с тестовым пакетом. Дополнительные сведения о тестовых группах см. в разделе Тестовые пакеты.
rankHigherThan строка Понятное имя тестового пакета, приоритет которого на единицу ниже приоритета текущего тестового пакета. Дополнительные сведения о задании приоритетов тестовых групп см. в разделе Тестовые пакеты.

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

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

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

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

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