contact リソース型contact resource type

重要: Microsoft Graph のベータ版 (/beta) の API はプレビュー中であるため、変更されることがあります。Important: APIs under the /beta version in Microsoft Graph are in preview and are subject to change. 実稼働アプリケーションでの、これらの API の使用はサポートされていません。Use of these APIs in production applications is not supported.

連絡先は、連絡を取り合う人や組織に関する情報を編成および保存できる Outlook のアイテムです。連絡先は連絡先フォルダーに格納されます。A contact is an item in Outlook where you can organize and save information about the people and organizations you communicate with. Contacts are contained in contact folders.

このリソースは以下をサポートしています。This resource supports:

JSON 表記JSON representation

以下は、リソースの JSON 表記ですHere is a JSON representation of the resource

  "assistantName": "string",
  "birthday": "String (timestamp)",
  "categories": ["string"],
  "changeKey": "string",
  "children": ["string"],
  "companyName": "string",
  "createdDateTime": "String (timestamp)",
  "department": "string",
  "displayName": "string",
  "emailAddresses": [{"@odata.type": "microsoft.graph.typedEmailAddress"}],
  "fileAs": "string",
  "flag": {"@odata.type": "microsoft.graph.followupFlag"},
  "gender": "string",
  "generation": "string",
  "givenName": "string",
  "id": "string (identifier)",
  "imAddresses": ["string"],
  "initials": "string",
  "jobTitle": "string",
  "lastModifiedDateTime": "String (timestamp)",
  "manager": "string",
  "middleName": "string",
  "nickName": "string",
  "officeLocation": "string",
  "parentFolderId": "string",
  "personalNotes": "string",
  "phones": [{"@odata.type": ""}],
  "postalAddresses": [{"@odata.type": "microsoft.graph.physicalAddress"}],
  "profession": "string",
  "spouseName": "string",
  "surname": "string",
  "title": "string",
  "websites": [{"@odata.type": ""}],
  "weddingAnniversary": "date",
  "yomiCompanyName": "string",
  "yomiGivenName": "string",
  "yomiSurname": "string"


プロパティProperty Type 説明Description
assistantNameassistantName StringString 連絡先のアシスタントの名前。The name of the contact's assistant.
birthdaybirthday DateTimeOffsetDateTimeOffset 連絡先の誕生日です。Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、必ず UTC 時間です。たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、次のようになります。'2014-01-01T00:00:00Z'The contact's birthday. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
categoriescategories String コレクションString collection 連絡先に関連付けられたカテゴリ。The categories associated with the contact. 各カテゴリは、ユーザーに対して定義されているoutlookCategory表示名のプロパティに対応します。Each category corresponds to the displayName property of an outlookCategory defined for the user.
changeKeychangeKey StringString 連絡先のバージョンを識別します。連絡先を変更するたびに ChangeKey も変更されます。これにより、Exchange は正しいバージョンのオブジェクトに変更を適用できます。Identifies the version of the contact. Every time the contact is changed, ChangeKey changes as well. This allows Exchange to apply changes to the correct version of the object.
childrenchildren String コレクションString collection 連絡先の子供の名前。The names of the contact's children.
companyNamecompanyName StringString 連絡先の会社の名前。The name of the contact's company.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset 連絡先が作成された時刻です。Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、必ず UTC 時間です。たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、次のようになります。'2014-01-01T00:00:00Z'The time the contact was created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
departmentdepartment StringString 連絡先の部署。The contact's department.
displayNamedisplayName StringString 連絡先の表示名。The contact's display name. 作成または更新操作では、表示名を指定できます。You can specify the display name in a create or update operation. その他のプロパティを後で更新プログラムが原因で、自動的に生成された値を指定した表示名の値を上書きすることに注意します。Note that later updates to other properties may cause an automatically generated value to overwrite the displayName value you have specified. 既存の値を保持するには、必ず、更新操作の表示名としてです。To preserve a pre-existing value, always include it as displayName in an update operation.
emailAddressesemailAddresses typedEmailAddressコレクションtypedEmailAddress collection 連絡先のメール アドレス。The contact's email addresses.
fileAsfileAs StringString 連絡先がファイルされる名前。The name the contact is filed under.
flagflag followupFlagfollowupFlag ステータス、開始日、期日、または取引先担当者の終了日を示すフラグ値です。The flag value that indicates the status, start date, due date, or completion date for the contact.
gendergender StringString 連絡先の性別。The contact's gender.
generationgeneration StringString 連絡先の世代。The contact's generation.
givenNamegivenName StringString 連絡先の名。The contact's given name.
idid StringString 連絡先の一意識別子。読み取り専用。The contact's unique identifier. Read-only.
imAddressesimAddresses String コレクションString collection 連絡先のインスタント メッセージング (IM) アドレス。The contact's instant messaging (IM) addresses.
initialsinitials StringString 連絡先のイニシャル。The contact's initials.
jobTitlejobTitle StringString 連絡先の役職。The contact’s job title.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset 連絡先が変更された時刻です。Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、必ず UTC 時間です。たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、次のようになります。'2014-01-01T00:00:00Z'The time the contact was modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
managermanager StringString 連絡先の上司の名前。The name of the contact's manager.
middleNamemiddleName StringString 連絡先のミドル ネーム。The contact's middle name.
nickNamenickName StringString 連絡先のニックネーム。The contact's nickname.
officeLocationofficeLocation StringString 連絡先のオフィスの所在地。The location of the contact's office.
parentFolderIdparentFolderId StringString 連絡先の親フォルダーの ID。The ID of the contact's parent folder.
personalNotespersonalNotes StringString 連絡先に関するユーザーのメモ。The user's notes about the contact.
phonesphones phone コレクションphone collection 自宅電話、携帯電話、勤務先電話など、連絡先に関連付けられた電話番号。Phone numbers associated with the contact, for example, home phone, mobile phone, and business phone.
postalAddressespostalAddresses physicalAddressコレクションphysicalAddress collection 自宅住所や勤務先住所など、連絡先に関連付けられた住所。Addresses associated with the contact, for example, home address and business address.
professionprofession StringString 連絡先の専門的職業。The contact's profession.
spouseNamespouseName StringString 連絡先の配偶者/パートナーの名前。The name of the contact's spouse/partner.
surname StringString 連絡先の姓。The contact's surname.
タイトルtitle StringString 連絡先の肩書。The contact's title.
websiteswebsites website コレクションwebsite collection 連絡先に関連付けられた Web サイト。Web sites associated with the contact.
weddingAnniversaryweddingAnniversary 日付Date 連絡先の結婚記念日。The contact's wedding anniversary.
yomiCompanyNameyomiCompanyName StringString 連絡先の会社名の読み仮名。The phonetic Japanese company name of the contact.
yomiGivenNameyomiGivenName StringString 連絡先の名 (ファースト ネーム) の読み仮名。The phonetic Japanese given name (first name) of the contact.
yomiSurnameyomiSurname StringString 連絡先の姓 (ラスト ネーム) の読み仮名。The phonetic Japanese surname (last name) of the contact.


リレーションシップRelationship Type 説明Description
extensionsextensions extension コレクションextension collection 連絡先に対して定義されている、開いている拡張機能のコレクションです。The collection of open extensions defined for the contact. Null 許容型。Nullable.
multiValueExtendedPropertiesmultiValueExtendedProperties multiValueLegacyExtendedProperty collectionmultiValueLegacyExtendedProperty collection 連絡先に定義された、複数値の拡張プロパティのコレクション。読み取り専用。Null 許容型。The collection of multi-value extended properties defined for the contact. Read-only. Nullable.
写真photo photophoto 連絡先の写真 (オプション)。連絡先の写真を取得また設定することができます。Optional contact picture. You can get or set a photo for a contact.
singleValueExtendedPropertiessingleValueExtendedProperties singleValueLegacyExtendedProperty collectionsingleValueLegacyExtendedProperty collection 連絡先に定義された、単一値の拡張プロパティのコレクション。読み取り専用。Null 許容型。The collection of single-value extended properties defined for the contact. Read-only. Nullable.


メソッドMethod 戻り値の型Return Type 説明Description
連絡先を取得するGet contact contactcontact 連絡先オブジェクトのプロパティとリレーションシップを読み取ります。Read properties and relationships of contact object.
作成Create contactcontact 連絡先をルート連絡先フォルダーまたは別の連絡先フォルダーの連絡先エンドポイントに追加します。Add a contact to the root Contacts folder or to the contacts endpoint of another contact folder.
更新するUpdate contactcontact 連絡先オブジェクトを更新します。Update contact object.
削除Delete なしNone 連絡先オブジェクトを削除します。Delete contact object.
deltadelta contactコレクションcontact collection 指定したフォルダーで追加、削除、更新された連絡先のセットを取得します。Get a set of contacts that have been added, deleted, or updated in a specified folder.
オープン拡張機能Open extensions
オープン拡張機能を作成するCreate open extension openTypeExtensionopenTypeExtension オープン拡張機能を作成し、新規または既存のリソースにカスタム プロパティを追加します。Create an open extension and add custom properties to a new or existing resource.
オープン拡張機能を取得するGet open extension openTypeExtension コレクションopenTypeExtension collection 拡張機能の名前で識別されるオープン拡張機能を取得します。Get an open extension identified by the extension name.
スキーマ拡張機能Schema extensions
スキーマ拡張機能の値を追加するAdd schema extension values スキーマ拡張機能の定義を作成し、それを使用してカスタマイズされた種類のデータをリソースに追加します。Create a schema extension definition and then use it to add custom typed data to a resource.
拡張プロパティExtended properties
単一値の拡張プロパティを作成するCreate single-value extended property contactcontact 新規または既存の連絡先に、1 つ以上の単一値の拡張プロパティを作成します。Create one or more single-value extended properties in a new or existing contact.
単一値の拡張プロパティを持つ連絡先を取得するGet contact with single-value extended property contactcontact $expand または $filter を使用して、単一値の拡張プロパティを含む連絡先を取得します。Get contacts that contain a single-value extended property by using $expand or $filter.
複数値の拡張プロパティを作成するCreate multi-value extended property contactcontact 新規または既存の連絡先に、1 つ以上の複数値の拡張プロパティを作成します。Create one or more multi-value extended properties in a new or existing contact.
複数値の拡張プロパティを持つ連絡先を取得するGet contact with multi-value extended property contactcontact $expand を使用して、複数値の拡張プロパティを含む連絡先を取得します。Get a contact that contains a multi-value extended property by using $expand.

関連項目See also