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

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

Получение пакетов для приложения

  • Статья

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

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

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

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

Запросить

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

Способ URI запроса
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listflights

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

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

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

Имя. Тип Описание Обязательное поле
applicationId строка Идентификатор магазина приложения, для которого требуется получить рейсы пакетов. Дополнительные сведения об идентификаторе Магазина см. в разделе "Просмотр сведений об удостоверении приложения". Да
популярное INT Количество элементов, возвращаемых в запросе (т. е. количество возвращаемых пакетов). Если у вашей учетной записи больше пакетов, чем указанное в запросе значение, текст ответа содержит относительный URI-путь, который можно добавить к URI метода, чтобы запросить следующую страницу данных. No
skip INT Количество элементов, которые нужно обойти в запросе, прежде чем возвращать остальные элементы. Используйте этот параметр для страницы с помощью наборов данных. Например, top=10 и skip=0 извлекает элементы от 1 до 10, top=10 и skip=10 извлекает элементы 11–20 и т. д. No

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

Не предоставляйте текст запроса для этого метода.

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

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

JSON 
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/listflights HTTP/1.1
Authorization: Bearer <your access token>

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

JSON 
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/listflights?top=1 HTTP/1.1
Authorization: Bearer <your access token>

Response

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

JSON 
{
  "value": [
    {
      "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"
    }
  ],
  "totalCount": 3
}

Текст ответа

Значение Тип Описание:
@nextLink строка Если есть дополнительные страницы данных, эта строка содержит относительный путь, который можно добавить к URI базового https://manage.devcenter.microsoft.com/v1.0/my/ запроса, чтобы запросить следующую страницу данных. Например, если для основного параметра исходного текста запроса задано значение 2, но для приложения есть 4 рейса пакетов, текст ответа будет содержать @nextLink значение applications/{applicationid}/listflights/?skip=2&top=2, указывающее, что можно вызвать следующие https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationid}/listflights/?skip=2&top=2 2 рейсы пакетов.
значение array Массив объектов, предоставляющих сведения о рейсах пакетов для указанного приложения. Дополнительные сведения о данных в каждом объекте см. в разделе "Ресурс Flight".
totalCount INT Общее количество строк в результатах данных для запроса (то есть общее количество рейсов пакетов для указанного приложения).

Коды ошибок

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

Код ошибки Description
404 Рейсы пакета не найдены.
409 Приложение использует функцию Центра партнеров, которая в настоящее время не поддерживается API отправки Microsoft Store.