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

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

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

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

Описание	Метод	УРИ
Получите список аудиторий, применимых к вашей организации.	ПОЛУЧАЙ	`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	струна	Идентификатор аудитории. Значение, которое будет указано или передано на транспортировочной этикетке.
имя	струна	Дружественное имя аудитории
описание	струна	Описание аудитории
название аудитории	струна	Имя аудитории

Просьба

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

Метод	Запрос URI
ПОЛУЧАЙ	`https://manage.devcenter.microsoft.com/v2.0/my/hardware/audience`

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

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

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

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

Основное содержание запроса

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

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

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

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

Ответ

В следующем примере показан текст ответа 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"
    }
  ]
}