/beta/me/peopleエンドポイントは、現在のユーザーに関連する連絡先の一覧を返します。この「関係」は、電子メール、電話、文書などに基づいています。これは、どのユーザがログインしているかによって変わるのです。私の場合、マネージャは結果の一番上に表示されますが、インタラクトしていない会社の人はそうではありません。
特定のユーザー(Outlookの連絡先)の連絡先の純粋なリストを探している場合は、/me/contactsエンドポイントを使用できます。これは、Outlook/Exchangeの現在のユーザーの既定の連絡先フォルダから連絡先レコードの一覧を返します。
内部ユーザー(ユーザーアカウント)のプロフィール情報を探している場合は、/usersエンドポイントを使用してこれを行うことができます。これにより、組織内のすべてのユーザーが返されます。
単一のユーザーアカウントのプロファイル情報を取得する場合は、/users/{id | userPrincipalName}を使用して取得できます。 一般的には、デバッグやログの見直しを人間が読めるようにするため、userPrincipalName
を使用することをお勧めします。
ユーザーの連絡先フォルダから1つの連絡先を取得する場合は、$filterクエリパラメータを使用します。例:me/contacts?$filter=emailAddresses/any(a:a/address eq '@domain.com')
。
あなたは/me/peopleエンドポイントから一人をつかむために探しているなら、あなたは単にパスにそのユーザーのid
を追加することによってそれを行うことができます:/me/people/{id}
beta
エンドポイントの缶を使用していることに注意してください予期しない動作が発生します。これらのエンドポイントはテスト用に用意されていますが、本番ワークロードには絶対に不適切です。