Получение данных аудитории

Статья
07/08/2024

Используйте следующий метод в API оборудования Майкрософт, чтобы получить аудиторию, применимую к вашей организации. Аудитории позволяют ограничить публикацию компьютерами с определенной конфигурацией. Например, тестовое развертывание может быть доставлено только клиентам с установленным определенным разделом реестра.

https://manage.devcenter.microsoft.com/v2.0/my/hardware/audiences

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

Description	Method	URI
Получите список аудиторий, применимых к вашей организации.	GET	`https://manage.devcenter.microsoft.com/v2.0/my/hardware/audiences`

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

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

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

Методы API оборудования Майкрософт для получения данных меток доставки используют следующие ресурсы данных JSON.

Ресурс аудитории

Этот ресурс представляет аудиторию, которая применима к вашей организации.

{
  "id": "9f4f44d8-bfec-48c6-a02c-2d9ea220f6e2",
  "name": "My Custom Audience",
  "description": "Matches machines that have the following registry key: HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows\\FOO-BAR",
  "audienceName": "Sample_Audience_Key"
}

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

Значение	Тип	Описание
id	строка	Идентификатор аудитории. Это значение, которое будет получено или отправлено в метке доставки.
name	строка	Понятное имя аудитории
описание	строка	Описание аудитории
audienceName	строка	Имя аудитории

Запросить

Этот метод имеет следующий синтаксис.

Способ	URI запроса
GET	`https://manage.devcenter.microsoft.com/v2.0/my/hardware/audience`

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

Верхний колонтитул	Тип	Описание
Авторизация	строка	Обязательный. Маркер доступа идентификатора Microsoft Entra в маркере> носителя < формы.
accept	строка	Необязательно. Указывает тип содержимого. Допустимое значение — application/json

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

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

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

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

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

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

GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/audience HTTP/1.1
Authorization: Bearer <your access token>

Response

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

{
  "value": [
    {
      "id": "9f4f44d8-bfec-48c6-a02c-2d9ea220f6e2",
      "name": "Test Registry Key",
      "description": "Matches machines that have the following registry key: HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows\\Test Drivers - use at own risk",
      "audienceName": "Test_Registry_Key"
    },
    {
      "id": "10415bba-3572-421b-a3de-d0d347bace5f",
      "name": "Test Audience 2",
      "description": "Additional Audience",
      "audienceName": "Test_Audeince_2"
    }
  ],
  "links": [
    {
      "href": "https://manage.devcenter..microsoft.com/api/v1/hardware/audiences",
      "rel": "self",
      "method": "GET"
    }
  ]
}