Important
Windows People アプリは 2024 年 12 月 31 日にサポートを終了し、Windows 11 バージョン 24H2 以降から削除されました。 このページに記載されている ms-people: URI スキームは、最新のWindows 11インストールでは機能しなくなりました。 アプリケーションの連絡先管理については、 新しい Outlook for Windows を参照してください。
このドキュメントは、以前のバージョンの Windows を使用する開発者向けの参照目的で管理されています。
このトピックでは、 ms-people: URI スキームについて説明します。 WinUI、UWP、およびその他の Windows デスクトップ アプリでは、この URI スキームを使用して、特定のアクションに対して People アプリを起動できます。
ms-people: URI スキーム リファレンス
| 結果 | URI スキーム |
|---|---|
| 他のアプリが People アプリのメイン ページを起動できるようにします。 | ms-people: |
| 他のアプリが People アプリの [設定] ページを起動できるようにします。 | ms-people:設定 |
| 他のアプリが検索の結果ページで People アプリを起動する検索文字列を提供できるようにします。
パラメーターは大文字と小文字を区別します。 構文を正しく入力しない場合、または検索文字列の値がない場合、既定の動作では、フィルター処理なしで連絡先の完全な一覧が返されます。 |
ms-people:search?SearchString=contactsearchinfo |
| 連絡先が見つかった場合は、既存の連絡先カードを起動します。 または、連絡先が見つからない場合は、一時的な連絡先カードを起動します。 入力パラメーターが指定されていない場合は、連絡先リストを含む People アプリを起動します。
パラメーターでは大文字と小文字が区別されます。 パラメーターの順序は関係ありません。 複数の連絡先に一致する場合は、最初の一致した連絡先を返します。 |
ms-people:viewcontact?ContactId=contactid&AggregatedId=aggid&PhoneNumber=phonenum&Email=email&ContactName=name&Contact=contactobj |
| 連絡先アプリ内の [連絡先の保存] ページを起動し、指定した連絡先を指定した電話番号またはメール アドレスで保存します。
パラメータは大文字と小文字を区別します。 パラメーターの順序は関係ありません。 |
ms-people:savetocontact?PhoneNumber=phonenum&Email=email&ContactName=name |
| People アプリ内の [新しい連絡先の追加] ページを起動して、指定された連絡先を保存します。
LaunchUriForResultsAsync を使用して、新しい連絡先の保存ページを開きます。 LaunchUriAsync を使用すると、People アプリのメイン ページのみが起動します。 パラメーターでは大文字と小文字が区別されます。 パラメーターの順序は関係ありません。 サポートされているパラメーターの任意の組み合わせを使用できます。 |
ms-people:savecontacttask?PhoneNumber= phonenum&Email=email&ContactName=name |
ms-people:search: パラメーター リファレンス
| パラメーター | 説明 | 例 |
|---|---|---|
| 検索文字列 | このフィールドは省略可能です。 連絡先情報の検索文字列。 電話番号または連絡先名。 |
ms-people:search?SearchString=Smith |
ms-people:viewcontact: パラメーターリファレンス
| パラメーター | 説明 | 例 |
|---|---|---|
| 連絡先 ID | このフィールドは省略可能です。 連絡先 ID。 |
ms-people:viewcontact?ContactId={ContactId} |
| 電話番号 | このフィールドは省略可能です。 連絡先の電話番号。 |
ms-people:viewcontact?PhoneNumber=%2014257069326 |
| 電子メール | このフィールドは省略可能です。 連絡先の電子メール。 |
ms-people:viewcontact?Email= |
| 連絡先名 | このフィールドは省略可能です。 連絡先の名前。 |
ms-people:viewcontact?ContactName=ジョン%20%20スミス |
| 連絡先 | このフィールドは省略可能です。 コンタクトオブジェクト。 |
ms-people:viewcontact?Contact={Serialized Contact} |
ms-people:savetocontact: パラメーター参照
| パラメーター | 説明 | 例 |
|---|---|---|
| 電話番号 | このフィールドは省略可能です。 連絡先の電話番号。 |
ms-people:savetocontact?PhoneNumber=%2014257069326 |
| 電子メール | このフィールドは省略可能です。 連絡先の電子メール。 |
ms-people:連絡先に保存?Email= |
| 連絡先名 | このフィールドは省略可能です。 連絡先の名前。 |
ms-people:savetocontact?Email=>ContactName= John%20%Smith |
ms-people:savecontacttask: パラメーターリファレンス
| パラメーター | 説明 |
|---|---|
| 会社 | このフィールドは省略可能です。 連絡先の会社名。 |
| FirstName | このフィールドは省略可能です。 連絡先の名前。 |
| ホームアドレス市 | このフィールドは省略可能です。 自宅の住所の市区町村。 |
| 自宅住所の国名 | このフィールドは省略可能です。 自宅の住所の国。 |
| 自宅住所の州 | このフィールドは省略可能です。 自宅の住所の状態。 |
| 自宅住所の通り | このフィールドは省略可能です。 自宅住所の通り。 |
| 住所郵便番号 | このフィールドは省略可能です。 自宅の住所の郵便番号。 |
| 自宅電話 | このフィールドは省略可能です。 連絡先の自宅電話。 |
| JobTitle | このフィールドは省略可能です。 連絡先の役職。 |
| LastName | このフィールドは省略可能です。 連絡先の姓。 |
| ミドルネーム | このフィールドは省略可能です。 連絡先のミドル ネーム。 |
| 携帯電話 | このフィールドは省略可能です。 連絡先の携帯電話番号。 |
| ニックネーム | このフィールドは省略可能です。 連絡先のニックネーム。 |
| メモ | このフィールドは省略可能です。 連絡先に関するメモ。 |
| 他のメール | このフィールドは省略可能です。 連絡先のその他の電子メール。 |
| 個人用メール | このフィールドは省略可能です。 連絡先の個人用電子メール。 |
| 接尾辞 | このフィールドは省略可能です。 連絡先のサフィックス。 |
| タイトル | このフィールドは省略可能です。 連絡先のタイトル。 |
| ウェブサイト | このフィールドは省略可能です。 連絡先の Web サイト。 |
| WorkAddressCity | このフィールドは省略可能です。 勤務先住所の市区町村。 |
| WorkAddressCountry | このフィールドは省略可能です。 勤務先住所の国。 |
| WorkAddressState | このフィールドは省略可能です。 作業アドレスの状態。 |
| WorkAddressStreet | このフィールドは省略可能です。 勤務先住所の番地。 |
| 勤務先郵便番号 | このフィールドは省略可能です。 勤務先住所の郵便番号。 |
| 勤務メール | このフィールドは省略可能です。 連絡先の職場の電子メール。 |
| 職場用電話 | このフィールドは省略可能です。 連絡先の勤務先電話番号。 |
関連するコンテンツ
URI の既定のアプリを起動する
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
Windows developer