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

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

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

Метод УРИ Описание
ПОЛУЧАЙ https://manage.devcenter.microsoft.com/v1.0/my/applications Получение данных для всех приложений
ПОЛУЧАЙ https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId} Получение данных для конкретного приложения
ПОЛУЧАЙ https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listinappproducts Получение дополнений для приложения
ПОЛУЧАЙ 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
}

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

Ценность Тип Описание
идентификатор струна Идентификатор магазина приложения. Подробнее об идентификаторе Магазина см. в разделе Просмотр идентификации приложения.
основное имя струна Основное имя приложения.
имя семейства пакетов струна Имя семейства пакетов приложения.
имя идентификации пакета струна Имя идентификатора пакета приложения.
Имя издателя струна Идентификатор издателя Windows, связанный с приложением. Это соответствует значению Пакет/Идентификатор/Издатель, которое отображается на странице идентификации приложения для приложения в Центре партнеров.
первая_дата_публикации струна Дата публикации приложения в формате ISO 8601.
последнее опубликованное приложение объект Ресурс публикации, предоставляющий сведения о последнем опубликованном релизе приложения.
Ожидающая отправка заявки объект Ресурс отправки , предоставляющий сведения о текущей ожидающей отправке приложения.
имеет расширенные права на размещение булевый Указывает, можно ли настроить gamingOptions или трейлеры для отправки приложения. Это значение верно для отправки, созданных после мая 2017 года.

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

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

{
    "inAppProductId": "9WZDNCRD7DLK"
}

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

Ценность Тип Описание
ИдентификаторПродуктаВПриложении струна Идентификатор магазина для дополнения. Это значение предоставляется Магазином. Пример идентификатора магазина — 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 струна Идентификатор для пакетного полета. Это значение предоставляется Центром партнеров.
дружественноеИмя струна Имя пакета полета, указанное разработчиком.
последняя опубликованная отправка рейса объект Ресурс заявки , предоставляющий информацию о последней опубликованной заявке для полета пакета.
Отправка рейса в процессе ожидания объект ресурс отправки , который содержит информацию о текущей ожидающей отправке для пакета рейса.
идентификаторы групп массив Массив строк, содержащих идентификаторы групп полетов, связанных с пакетным полетом. Дополнительные сведения о группах полетов см. в разделе "Пакеты полетов".
имеет более высокий ранг, чем струна Дружелюбное имя пакета-полета, которое занимает сразу следующую позицию ниже текущего пакета-полета. Дополнительные сведения о ранжировании групп полетов см. в разделе "Пакеты полетов".

Ресурс представления

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

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

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

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

 

  • Last updated on