連絡先を一覧表示する

サインイン中のユーザーの既定の連絡先フォルダーから連絡先のコレクションを取得する (.../me/contacts) か、指定した連絡先フォルダーから取得します。

前提条件

この API を実行するには、以下のいずれかのスコープが必要です。Contacts.Read、Contacts.ReadWrite

HTTP 要求

GET /me/contacts
GET /users/{id | userPrincipalName}/contacts

GET /me/contactFolders/{id}/contacts
GET /users/{id | userPrincipalName}/contactFolders/{id}/contacts

オプションのクエリ パラメーター

このメソッドは、応答をカスタマイズするための OData クエリ パラメーターをサポートします。

要求ヘッダー

名前 説明
Authorization string Bearer . Required.

要求本文

このメソッドには、要求本文を指定しません。

応答

成功した場合、このメソッドは 200 OK 応答コードと、応答本文で Contact オブジェクトのコレクションを返します。

要求

以下は、要求の例です。

GET https://graph.microsoft.com/v1.0/me/contactFolders/{id}/contacts
応答

以下は、応答の例です。注:簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。すべてのプロパティは実際の呼び出しから返されます。

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 263

{
  "value": [
    {
      "parentFolderId": "parentFolderId-value",
      "birthday": "datetime-value",
      "fileAs": "fileAs-value",
      "displayName": "displayName-value",
      "givenName": "givenName-value",
      "initials": "initials-value"
    }
  ]
}