在 Microsoft Graph 中按 ID 批量獲取聯系人

Question

我有一個 ID 列表，我想從 Microsoft Graph 中提取相應的聯系人。 我嘗試使用https://graph.microsoft.com/v1.0/me/contacts?$filter=Id eq 'my-id-here' or Id eq 'other-id-here'過濾，但它說

ErrorInvalidProperty 屬性“Id”不支持過濾。

我知道我可以通過調用https://graph.microsoft.com/v1.0/me/contacts/my-id-here進行查詢，但我想一次請求多個以盡量減少往返。

Answer 1

您可以使用批處理來執行多個請求。 對於每個請求，您需要提供一個請求 ID、一個 http 方法和一個請求 url。 樣品請求：

URL: https://graph.microsoft.com/v1.0/$batch
Http Method: POST
Request Body: 

{
      "requests": [
        {
          "id": "1",
          "method": "GET",
          "url": "/me/contacts/firstId"
        },
        {
          "id": "2",
          "method": "GET",
          "url": "/me/contacts/secondId"
        }
     ]
}

Graph 將發送一個響應，例如：

{
    "responses": [
        {
            "id": "1",
            "status": 200,
            "headers": {
                ...
            },
            "body": {
                ...
            }
        },
        {
            "id": "2",
            "status": 200,
            "headers": {
                ...
            },
            "body": {
                ...
            }
        }
    ]
}

確保您檢查請求的 id，因為請求可能不會按順序返回，您將它們發送到 Graph。 有關批處理的 Microsoft 文檔提供了更多信息：此處。