ユーザーを一覧表示する
名前空間: microsoft.graph
ユーザーとの関連 (ユーザーのコミュニケーションとコラボレーション パターン、およびビジネスのリレーションシップによって決まる) によって配列された人物オブジェクトのコレクションを取得します。
この情報は、People API を使用して取得できます。 例については、「例」セクションと記事「People API を使用して最も関連性の高いユーザーに関する情報を取得する」を参照してください。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、 アクセス許可のリファレンスを参照してください。
| アクセス許可の種類 | 最小特権アクセス許可 | 特権の高いアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | People.Read | People.Read.All |
| 委任 (個人用 Microsoft アカウント) | People.Read | 注意事項なし。 |
| アプリケーション | People.Read.All | 注意事項なし。 |
HTTP 要求
GET /me/people
GET /users/{id | userPrincipalName}/people
オプションのクエリ パラメーター
このメソッドは、応答をカスタマイズするための OData クエリ パラメーターをサポートします。
| 名前 | 値 | 説明 |
|---|---|---|
| $filter | string | 応答を、指定した条件に等しいレコードを持つ人物のみに制限します。 |
| $orderby | string | 既定では、応答に含まれる人物は、クエリとの関連性で並べ替えられます。 応答に含まれる人物の順序は、$orderby パラメーターを使用することで変更できます。 |
| $search | string | 名またはエイリアスで人物を検索します。 ファジー マッチをサポートします。 パラメーターは、サインインしたユーザーの関連人物を検索するためにのみ機能し、他のユーザーに関連する人物を検索するためには機能しません。 その人とのメール会話から抽出されたトピックに基づいて人を見つける topic キーワードもサポートします。 詳細と例については、「People API を使用して最も関連性の高いユーザーに関する情報を取得する」の「あいまい検索の実行」セクションを参照してください。 |
| $select | string | 応答に含めるプロパティを示すコンマ区切りのリスト。 最適なパフォーマンスを得るには、必要なプロパティのサブセットのみを選択します。 |
| $skip | int | ページングに役立つ最初の n 個の結果をスキップします。 これは、$searchを使用する場合はサポートされません。 |
| $top | int | 結果ページで返される結果の最大数。 詳細については、top パラメーターに関する ページを参照してください。 |
要求ヘッダー
| 名前 | 説明 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。 |
| 承諾 | application/json |
要求本文
このメソッドには、要求本文を指定しません。
応答
成功した場合、このメソッドは 200 OK 応答コードと、応答本文の person オブジェクトのコレクションを返します。 応答には、1 人のユーザー オブジェクトまたは person オブジェクトのコレクションを含めることができます。
例
要求
次の例は要求を示しています。
GET https://graph.microsoft.com/v1.0/me/people
応答
次の例は応答を示しています。
HTTP/1.1 200 OK
Content-type: application/json
{
"value": [
{
"id": "33b43a5b-87d6-41ec-91f8-a2610048105f",
"displayName": "Marketing",
"givenName": null,
"surname": null,
"birthday": "",
"personNotes": "",
"isFavorite": false,
"jobTitle": null,
"companyName": null,
"yomiCompany": "",
"department": null,
"officeLocation": null,
"profession": "",
"userPrincipalName": "",
"imAddress": null,
"scoredEmailAddresses": [
{
"address": "Marketing@contoso.com",
"relevanceScore": 30.0
}
],
"phones": [],
"postalAddresses": [],
"websites": [],
"personType": {
"class": "Group",
"subclass": "UnifiedGroup"
}
},
{
"id": "e3d0513b-449e-4198-ba6f-bd97ae7cae85",
"displayName": "Isaiah Langer",
"givenName": "Isaiah",
"surname": "Langer",
"birthday": "",
"personNotes": "",
"isFavorite": false,
"jobTitle": "Web Marketing Manager",
"companyName": null,
"yomiCompany": "",
"department": "Sales & Marketing",
"officeLocation": "20/1101",
"profession": "",
"userPrincipalName": "IsaiahL@contoso.com",
"imAddress": "sip:isaiahl@contoso.com",
"scoredEmailAddresses": [
{
"address": "IsaiahL@contoso.com",
"relevanceScore": 20.0
}
],
"phones": [
{
"type": "business",
"number": "+1 918 555 0101"
}
],
"postalAddresses": [],
"websites": [],
"personType": {
"class": "Person",
"subclass": "OrganizationUser"
}
}
]
}
関連コンテンツ
- People API とその他の例の詳細については、「People API を使用して最も関連性の高いユーザーに関する情報を取得する」を参照してください。