contact リソース型contact resource type

連絡先は、連絡を取り合う人や組織に関する情報を編成および保存できる 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:

メソッドMethods

メソッド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 in a new or existing instance of a resource.
オープン拡張機能を取得するGet open extension openTypeExtension コレクションopenTypeExtension collection 名前や完全修飾名によって識別されたオープン拡張機能オブジェクトを取得します。Get an open extension object or objects identified by name or fully qualified 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.

プロパティProperties

プロパティ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'
businessAddressbusinessAddress PhysicalAddressPhysicalAddress 連絡先の勤務先の住所。The contact's business address.
businessHomePagebusinessHomePage StringString 連絡先の勤務先のホーム ページ。The business home page of the contact.
businessPhonesbusinessPhones String collectionString collection 連絡先の勤務先の電話番号。The contact's business phone numbers.
categoriescategories String collectionString collection 連絡先に関連付けられたカテゴリ。The categories associated with the contact.
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 collectionString 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. 後で他のプロパティを更新すると、指定した displayName 値が自動的に生成された値に上書きされますので、ご注意ください。Note that later updates to other properties may cause an automatically generated value to overwrite the displayName value you have specified. 既存の値を保持するには、[更新] 操作で必ずその値を displayName として含めてください。To preserve a pre-existing value, always include it as displayName in an update operation.
emailAddressesemailAddresses EmailAddress collectionEmailAddress collection 連絡先のメール アドレス。The contact's email addresses.
fileAsfileAs StringString 連絡先がファイルされる名前。The name the contact is filed under.
generationgeneration StringString 連絡先の世代。The contact's generation.
givenNamegivenName StringString 連絡先の名。The contact's given name.
homeAddresshomeAddress PhysicalAddressPhysicalAddress 連絡先の自宅住所。The contact's home address.
homePhoneshomePhones String collectionString collection 連絡先の自宅の電話番号。The contact's home phone numbers.
idid StringString 連絡先の一意識別子。読み取り専用。The contact's unique identifier. Read-only.
imAddressesimAddresses String collectionString 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.
mobilePhonemobilePhone StringString 連絡先の携帯電話番号。The contact's mobile phone number.
nickNamenickName StringString 連絡先のニックネーム。The contact's nickname.
officeLocationofficeLocation StringString 連絡先のオフィスの所在地。The location of the contact's office.
otherAddressotherAddress PhysicalAddressPhysicalAddress 連絡先の別の住所。Other addresses for the contact.
parentFolderIdparentFolderId StringString 連絡先の親フォルダーの ID。The ID of the contact's parent folder.
personalNotespersonalNotes StringString 連絡先に関するユーザーのメモ。The user's notes about the contact.
professionprofession StringString 連絡先の専門的職業。The contact's profession.
spouseNamespouseName StringString 連絡先の配偶者/パートナーの名前。The name of the contact's spouse/partner.
surname StringString 連絡先の姓。The contact's surname.
titletitle StringString 連絡先の肩書。The contact's title.
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.

リレーションシップRelationships

リレーションシップRelationship Type 説明Description
extensionsextensions extension コレクションextension collection 連絡先に対して定義されているオープン拡張機能のコレクション。読み取り専用。Null 許容型。The collection of open extensions defined for the contact. Read-only. Nullable.
multiValueExtendedPropertiesmultiValueExtendedProperties multiValueLegacyExtendedProperty collectionmultiValueLegacyExtendedProperty collection 連絡先に定義された、複数値の拡張プロパティのコレクション。読み取り専用。Null 許容型。The collection of multi-value extended properties defined for the contact. Read-only. Nullable.
写真photo profilePhotoprofilePhoto 連絡先の写真 (オプション)。連絡先の写真を取得また設定することができます。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.

JSON 表記JSON representation

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

{
  "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",
  "profession": "string",
  "spouseName": "string",
  "surname": "string",
  "title": "string",
  "yomiCompanyName": "string",
  "yomiGivenName": "string",
  "yomiSurname": "string",

  "photo": { "@odata.type": "microsoft.graph.profilePhoto" }
}

関連項目See also