Share via

Отправка запросов в Microsoft Store

  • Статья

Начиная с Windows 10 версии 1607 пакет Windows SDK содержит API для операций, связанных с Store (например, покупки из приложения) в пространстве имен Windows.Services.Store. Но хотя службы, поддерживающие работу с Магазином, постоянно обновляются, расширяются и улучшаются от одного выпуска ОС к другому, новые API обычно добавляются в пакет Windows SDK только во время основных выпусков ОС.

Мы предоставляем метод SendRequestAsync как гибкий способ сделать новые операции Магазина доступными для приложений универсальной платформы Windows (UWP) перед выпуском новой версии Windows SDK. Этот метод можно использовать для отправки запросов в Магазин для новых операций, у которых еще нет соответствующих API, доступных в последнем выпуске пакета Windows SDK.

Примечание

Метод SendRequestAsync доступен только для приложений, предназначенных для Windows 10 версии 1607 или выше. Некоторые запросы, поддерживаемые этим методом, поддерживаются только в выпусках, появившихся после Windows 10 версии 1607.

SendRequestAsync — это статический метод класса StoreRequestHelper. Для вызова этого метода необходимо передать ему указанную ниже информацию.

  • Объект StoreContext, предоставляющий информацию о пользователе, для которого выполняется операция. Дополнительные сведения об этом объекте см. в разделе Начало работы с классом StoreContext.
  • Целое число, определяющее запрос, который необходимо отправить в Магазин.
  • Если запрос поддерживает любые аргументы, можно также передавать строку формата JSON, содержащую аргументы, передаваемые вместе с запросом.

В следующем примере показано, как вызывается данный метод. В этом примере требуется использование операторов для пространств имен Windows.Services.Store и System.Threading.Tasks.

public async Task<bool> AddUserToFlightGroup()
{
    StoreSendRequestResult result = await StoreRequestHelper.SendRequestAsync(
        StoreContext.GetDefault(), 8,
        "{ \"type\": \"AddToFlightGroup\", \"parameters\": { \"flightGroupId\": \"your group ID\" } }");

    if (result.ExtendedError == null)
    {
        return true;
    }

    return false;
}

См. в следующих разделах сведения о запросах, которые в настоящее время доступны через метод SendRequestAsync. Мы обновим эту статью после добавления поддержки новых запросов.

Запрос оценок и отзывов в приложении

Можно программным образом показать пользователю диалоговое окно, где он может оставить оценку и отзыв, путем передачи запроса в виде целого числа 16 методу SendRequestAsync. Дополнительные сведения см. в разделе Показ диалогового окна оценки и отзыва в приложении.

Запросы для сценариев группы тестируемой возможности

Важно!

Все запросы группы тестируемой возможности, описанные в этом разделе, недоступны в настоящее время большинству учетных записей разработчика. Эти запросы не будут выполнены, если учетная запись разработчика не предоставлена специально корпорацией Майкрософт.

Метод SendRequestAsync поддерживает набор запросов для сценариев группы тестируемой возможности, например добавления пользователя или устройства в группу тестируемой возможности. Чтобы отправить эти запросы, передайте значение 7 или 8 в параметр requestKind, а также строку формата JSON в параметр parametersAsJson, указывающий запрос, который вы хотите отправить вместе с какими-либо связанными аргументами. Эти значения requestKind отличаются следующим образом.

Значение типа запроса Описание
7 Запросы выполняются в контексте текущего устройства. Это значение может использоваться только в Windows 10 версии 1703 или более поздней.
8 Запросы выполняются в контексте пользователя, который в данный момент вошел в Магазин. Это значение может использоваться в Windows 10 версии 1607 или более поздней.

В настоящее время реализованы перечисленные ниже запросы группы тестовой возможности.

Получение удаленных переменных для группы тестируемой возможности с самым высоким приоритетом.

Важно!

Этот запрос на данный момент недоступен для большинства учетных записей разработчиков. Этот запрос не будет выполнен, если учетная запись разработчика не предоставлена специально корпорацией Майкрософт.

Этот запрос извлекает удаленные переменные для группы тестируемой возможности с самым высоким приоритетом для текущего пользователя или устройства. Чтобы отправить этот запрос, передайте указанную ниже информацию в параметры requestKind и parametersAsJson метода SendRequestAsync.

Параметр Описание
requestKind Укажите 7 для возврата группы тестируемой возможности с самым высоким приоритетом для устройства или 8 для возврата группы тестируемой возможности с самым высоким приоритетом для текущего пользователя и устройства. Рекомендуется использовать значение 8 для параметра requestKind, поскольку это значение будет возвращать группу тестируемой возможности с самым высоким приоритетом через членство и для текущего пользователя, и для устройства.
parametersAsJson Передайте строку формата JSON, содержащую данные, как показано в примере ниже.

В следующем примере показан формат данных JSON для передачи в parametersAsJson. Поле type должно быть назначено строке GetRemoteVariables. Назначьте поле projectId идентификатору проекта, в котором определены удаленные переменные в Центре партнеров.

{ 
    "type": "GetRemoteVariables", 
    "parameters": "{ \"projectId\": \"your project ID\" }" 
}

После отправки этого запроса свойство Response возвращаемого значения StoreSendRequestResult содержит строку формата JSON со следующими полями.

Поле Описание
анонимное Логическое значение, где true указывает, что удостоверение пользователя или устройства не было представлено в запросе, а false указывает, что удостоверение пользователя или устройства было представлено в запросе.
name Строка, содержащая имя группы тестируемой возможности с самым высоким приоритетом, к которой принадлежит устройство или пользователь.
параметры Словарь пар "ключ — значение", содержащий имя и значение удаленных переменных, которые разработчик настроил для группы тестируемой возможности.

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

{ 
  "anonymous": false, 
  "name": "Insider Slow",
  "settings":
  {
      "Audience": "Slow"
      ...
  }
}

Добавление текущего устройства или пользователя в группу тестируемой возможности

Важно!

Этот запрос на данный момент недоступен для большинства учетных записей разработчиков. Этот запрос не будет выполнен, если учетная запись разработчика не предоставлена специально корпорацией Майкрософт.

Чтобы отправить этот запрос, передайте указанную ниже информацию в параметры requestKind и parametersAsJson метода SendRequestAsync.

Параметр Описание
requestKind Укажите 7, чтобы добавить устройство в группу тестируемой возможности, или 8, чтобы добавить в эту группу пользователя, который в данный момент вошел в Магазин.
parametersAsJson Передайте строку формата JSON, содержащую данные, как показано в примере ниже.

В следующем примере показан формат данных JSON для передачи в parametersAsJson. Поле type должно быть назначено строке AddToFlightGroup. Назначьте поле flightGroupId идентификатору группы тестируемой возможности, к которому вы хотите добавить устройство или пользователя.

{ 
    "type": "AddToFlightGroup", 
    "parameters": "{ \"flightGroupId\": \"your group ID\" }" 
}

Если возникает ошибка с запросом, свойство HttpStatusCode возвращаемого значения StoreSendRequestResult содержит код ответа.

Удаление текущего устройства или пользователя из группы тестируемой возможности

Важно!

Этот запрос на данный момент недоступен для большинства учетных записей разработчиков. Этот запрос не будет выполнен, если учетная запись разработчика не предоставлена специально корпорацией Майкрософт.

Чтобы отправить этот запрос, передайте указанную ниже информацию в параметры requestKind и parametersAsJson метода SendRequestAsync.

Параметр Описание
requestKind Укажите 7, чтобы удалить устройство из группы тестируемой возможности, или 8, чтобы удалить из этой группы пользователя, который в данный момент вошел в Магазин.
parametersAsJson Передайте строку формата JSON, содержащую данные, как показано в примере ниже.

В следующем примере показан формат данных JSON для передачи в parametersAsJson. Поле type должно быть назначено строке RemoveFromFlightGroup. Назначьте поле flightGroupId идентификатору группы тестируемой возможности, из которой вы хотите удалить устройство или пользователя.

{ 
    "type": "RemoveFromFlightGroup", 
    "parameters": "{ \"flightGroupId\": \"your group ID\" }" 
}

Если возникает ошибка с запросом, свойство HttpStatusCode возвращаемого значения StoreSendRequestResult содержит код ответа.