contact リソース型
名前空間: microsoft.graph
連絡先は、連絡を取り合う人や組織に関する情報を編成および保存できる Outlook のアイテムです。 連絡先は連絡先フォルダーに格納されます。
このリソースは以下をサポートしています。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| 連絡先を取得する | contact | 連絡先オブジェクトのプロパティとリレーションシップを読み取ります。 |
| Create contact | contact | 連絡先をルート連絡先フォルダーまたは別の連絡先フォルダーの連絡先エンドポイントに追加します。 |
| 連絡先を更新する | contact | 連絡先オブジェクトを更新します。 |
| 連絡先を削除する | なし | 連絡先オブジェクトを削除します。 |
| 連絡先の差分を取得する | contactコレクション | 指定したフォルダーで追加、削除、更新された連絡先のセットを取得します。 |
| オープン拡張機能 | ||
| Create open extension | openTypeExtension | オープン拡張機能を作成し、リソースの新規または既存のインスタンスのカスタム プロパティを追加します。 |
| オープン拡張機能を取得する | openTypeExtension コレクション | 名前や完全修飾名によって識別されたオープン拡張機能オブジェクトを 1 つまたは複数取得します。 |
| 拡張プロパティ | ||
| 単一値のプロパティを作成する | contact | 新規または既存の連絡先に、1 つ以上の単一値の拡張プロパティを作成します。 |
| 単一値のプロパティを取得する | contact |
$expand または $filter を使用して、単一値の拡張プロパティを含む連絡先を取得します。 |
| 複数値のプロパティを作成する | contact | 新規または既存の連絡先に、1 つ以上の複数値の拡張プロパティを作成します。 |
| 複数値のプロパティを取得する | contact |
$expand を使用して、複数値の拡張プロパティを含む連絡先を取得します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| assistantName | String | 連絡先のアシスタントの名前。 |
| birthday | DateTimeOffset | 連絡先の誕生日です。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| businessAddress | PhysicalAddress | 連絡先の勤務先の住所。 |
| businessHomePage | String | 連絡先の勤務先のホーム ページ。 |
| businessPhones | String collection | 連絡先の勤務先の電話番号。 |
| categories | String collection | 連絡先に関連付けられたカテゴリ。 |
| changeKey | String | 連絡先のバージョンを識別します。 連絡先を変更するたびに ChangeKey も変更されます。 これにより、Exchange は正しいバージョンのオブジェクトに変更を適用できます。 |
| children | String collection | 連絡先の子供の名前。 |
| CompanyName | String | 連絡先の会社の名前。 |
| createdDateTime | DateTimeOffset | 連絡先が作成された時刻です。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| department | String | 連絡先の部署。 |
| displayName | String | 連絡先の表示名。 [作成] または [更新] の操作で表示名を指定できます。 後で他のプロパティを更新すると、指定した displayName 値が自動的に生成された値に上書きされますので、ご注意ください。 既存の値を保持するには、[更新] 操作で必ずその値を displayName として含めてください。 |
| emailAddresses | EmailAddress collection | 連絡先のメール アドレス。 |
| fileAs | String | 連絡先がファイルされる名前。 |
| generation | String | 連絡先のサフィックス。 |
| givenName | String | 連絡先の名。 |
| homeAddress | PhysicalAddress | 連絡先の自宅住所。 |
| homePhones | String collection | 連絡先の自宅の電話番号。 |
| id | String | 連絡先の一意の識別子。
既定では、この値は、アイテムをあるコンテナー (フォルダーや予定表など) から別のコンテナーに移動したときに変更されます。 この動作を変更するには、Prefer: IdType="ImmutableId" ヘッダーを使用します。 詳細については「Outlook リソースの不変識別子を取得する」を参照してください。 読み取り専用です。 |
| imAddresses | String collection | 連絡先のインスタント メッセージング (IM) アドレス。 |
| initials | String | 連絡先のイニシャル。 |
| jobTitle | String | 連絡先の役職。 |
| lastModifiedDateTime | DateTimeOffset | 連絡先が変更された時刻です。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| manager | String | 連絡先の上司の名前。 |
| middleName | String | 連絡先のミドル ネーム。 |
| mobilePhone | String | 連絡先の携帯電話番号。 |
| nickName | String | 連絡先のニックネーム。 |
| officeLocation | String | 連絡先のオフィスの所在地。 |
| otherAddress | PhysicalAddress | 連絡先の別の住所。 |
| parentFolderId | String | 連絡先の親フォルダーの ID。 |
| personalNotes | String | 連絡先に関するユーザーのメモ。 |
| profession | String | 連絡先の専門的職業。 |
| spouseName | String | 連絡先の配偶者/パートナーの名前。 |
| 姓 | String | 連絡先の姓。 |
| title | String | 連絡先の肩書。 |
| yomiCompanyName | String | 連絡先の会社名の読み仮名。 |
| yomiGivenName | String | 連絡先の名 (ファースト ネーム) の読み仮名。 |
| yomiSurname | String | 連絡先の発音の日本語の姓 (姓)。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| extensions | extension コレクション | 連絡先に対して定義されているオープン拡張機能のコレクション。 読み取り専用。 Null 許容型。 |
| multiValueExtendedProperties | multiValueLegacyExtendedProperty collection | 連絡先に定義された、複数値の拡張プロパティのコレクション。 読み取り専用。 Null 許容型。 |
| photo | profilePhoto | 連絡先の写真 (オプション)。 連絡先の写真を取得また設定することができます。 |
| singleValueExtendedProperties | singleValueLegacyExtendedProperty collection | 連絡先に定義された、単一値の拡張プロパティのコレクション。 読み取り専用。 Null 許容型。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"assistantName": "string",
"birthday": "String (timestamp)",
"businessAddress": {"@odata.type": "microsoft.graph.physicalAddress"},
"businessHomePage": "string",
"businessPhones": ["string"],
"categories": ["string"],
"changeKey": "string",
"children": ["string"],
"companyName": "string",
"createdDateTime": "String (timestamp)",
"department": "string",
"displayName": "string",
"emailAddresses": [{"@odata.type": "microsoft.graph.emailAddress"}],
"fileAs": "string",
"generation": "string",
"givenName": "string",
"homeAddress": {"@odata.type": "microsoft.graph.physicalAddress"},
"homePhones": ["string"],
"id": "string (identifier)",
"imAddresses": ["string"],
"initials": "string",
"jobTitle": "string",
"lastModifiedDateTime": "String (timestamp)",
"manager": "string",
"middleName": "string",
"mobilePhone": "string",
"nickName": "string",
"officeLocation": "string",
"otherAddress": {"@odata.type": "microsoft.graph.physicalAddress"},
"parentFolderId": "string",
"personalNotes": "string",
"photo": { "@odata.type": "microsoft.graph.profilePhoto" },
"profession": "string",
"spouseName": "string",
"surname": "string",
"title": "string",
"yomiCompanyName": "string",
"yomiGivenName": "string",
"yomiSurname": "string"
}