共用方式為

取得對象數據

使用Microsoft 硬體 API中的下列方法，取得適用於您組織的受眾。 受眾可讓您將出版物限制為特定配置的電腦。 例如，測試部署只能傳遞至已安裝特定登錄機碼的用戶端。

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

在您使用這些方法之前，產品和提交必須已經存在於您的開發人員中心帳戶中。 若要建立或管理產品的提交，請參閱 管理產品提交中的方法。

說明 方法 URI（統一資源識別碼）
取得適用於您組織的受眾清單。 GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/audiences

先決條件

如果您尚未這麼做，請先完成所有 Microsoft 硬體 API 的 前置條件，再嘗試使用這些方法。

數據資源

Microsoft 硬體 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"
}

此資源具有下列值

價值 類型 說明
識別碼 字串 受眾的識別碼。 這是在出貨標籤中接收或傳送的數值。
名稱 字串 受眾的易記名稱
說明 字串 受眾的描述
觀眾名稱 字串 觀眾名稱

請求

此方法具有下列語法。

方法 請求網址識別碼 (URI)
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/audience

請求標頭

頁首 類型 說明
授權 字串 必須的。 Microsoft Entra ID 存取令牌的格式為 Bearer<token>。
接受 字串 選擇性。 指定內容類型。 允許的值為 “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"
    }
  ]
}

此資源具有下列值

價值 類型 說明
價值 陣列 每個受眾相關信息的物件陣列。 如需每個物件中數據的詳細資訊，請參閱 對象資源。
連結 陣列 一組物件，其中包含與該實體相關的實用連結。 如需詳細資訊，請參閱 Link物件 。

另請參閱

  • Last updated on