Ressourcentyp contactcontact resource type

Ein Kontakt ist ein Element in Outlook, in dem Sie Informationen über die Personen und Organisationen, mit denen Sie kommunizieren, organisieren und speichern können. Kontakte sind in Kontaktordnern enthalten.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.

Diese Ressource unterstützt Folgendes:This resource supports:

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
Kontakt abrufenGet contact Kontaktcontact Dient zum Lesen der Eigenschaften und der Beziehungen des Kontaktobjekts.Read properties and relationships of contact object.
ErstellenCreate Kontaktcontact Dient zum Hinzufügen eines Kontakts zum Stammordner der Kontakte oder zum Kontaktendpunkt eines anderen Kontaktordners.Add a contact to the root Contacts folder or to the contacts endpoint of another contact folder.
AktualisierenUpdate Kontaktcontact Dient zum Aktualisieren des Kontaktobjekts.Update contact object.
LöschenDelete KeineNone Dient zum Löschen des Kontaktobjekts.Delete contact object.
deltadelta contact-Sammlungcontact collection Dient zum Abrufen eines Satzes von Kontakten, die einem bestimmten Ordner hinzugefügt bzw. daraus gelöscht oder darin aktualisiert wurden.Get a set of contacts that have been added, deleted, or updated in a specified folder.
Offene ErweiterungenOpen extensions
Offene Erweiterung erstellenCreate open extension openTypeExtensionopenTypeExtension Erstellt eine offene Erweiterung und fügt benutzerdefinierte Eigenschaften in einer neuen oder vorhandenen Instanz einer Ressource hinzu.Create an open extension and add custom properties in a new or existing instance of a resource.
Offene Erweiterung abrufenGet open extension openTypeExtension-SammlungopenTypeExtension collection Ruft ein offenes Erweiterungsobjekt oder Objekte basierend auf ihrem Namen oder vollqualifizierten Namen ab.Get an open extension object or objects identified by name or fully qualified name.
SchemaerweiterungenSchema extensions
Schemaerweiterungswerte hinzufügenAdd schema extension values Dient zum Erstellen einer Schemaerweiterungsdefinition und anschließenden Verwenden der Definition zum Hinzufügen benutzerdefinierter typisierter Daten zu einer Ressource.Create a schema extension definition and then use it to add custom typed data to a resource.
Erweiterte EigenschaftenExtended properties
Einwertige erweiterte Eigenschaft erstellenCreate single-value extended property Kontaktcontact Dient zum Erstellen einer oder mehrerer erweiterter einwertiger Eigenschaften in einem neuen oder vorhandenen Kontakt.Create one or more single-value extended properties in a new or existing contact.
Ereignis mit erweiterter einwertiger Eigenschaft abrufenGet contact with single-value extended property Kontaktcontact Ruft mithilfe von $expand oder $filter Kontakte mit einer bestimmten einwertigen erweiterten Eigenschaft ab.Get contacts that contain a single-value extended property by using $expand or $filter.
Erweiterte mehrwertige Eigenschaft erstellenCreate multi-value extended property Kontaktcontact Dient zum Erstellen einer oder mehrerer erweiterter mehrwertiger Eigenschaften in einem neuen oder vorhandenen Kontakt.Create one or more multi-value extended properties in a new or existing contact.
Ereignis mit erweiterter mehrwertiger Eigenschaft abrufenGet contact with multi-value extended property Kontaktcontact Dient zum Abrufen eines Kontakts mit einer erweiterten mehrwertigen Eigenschaft mithilfe von $expand.Get a contact that contains a multi-value extended property by using $expand.

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
assistantNameassistantName StringString Der Name des Assistenten des Kontakts.The name of the contact's assistant.
birthdaybirthday DateTimeOffsetDateTimeOffset Das Geburtsdatum des Kontakts. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Mitternacht UTC-Zeit am 1. Januar 2014 würde z. B. wie folgt aussehen: '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 Die Geschäftsadresse des Kontakts.The contact's business address.
businessHomePagebusinessHomePage StringString Die geschäftliche Homepage des Kontakts.The business home page of the contact.
businessPhonesbusinessPhones String collectionString collection Die geschäftlichen Telefonnummern des Kontakts.The contact's business phone numbers.
categoriescategories String collectionString collection Die Kategorien, die mit dem Kontakt verknüpft sind.The categories associated with the contact.
changeKeychangeKey StringString Gibt die Version des Kontakts an. Jedes Mal, wenn der Kontakt geändert wird, wird auch die Eigenschaft „changeKey“ geändert. Auf diese Weise kann Exchange Änderungen an der korrekten Version des Objekts vornehmen.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 Die Namen der Kinder des Kontakts.The names of the contact's children.
companyNamecompanyName StringString Der Name des Unternehmens des Kontakts.The name of the contact's company.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset Der Zeitpunkt, zu dem der Kontakt erstellt wurde. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Mitternacht UTC-Zeit am 1. Januar 2014 würde z. B. wie folgt aussehen: '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'
Abteilungdepartment StringString Die Abteilung des Kontakts.The contact's department.
displayNamedisplayName StringString Der Anzeigename des Kontakts.The contact's display name. Sie können den Anzeigenamen in einem Create- oder Update-Vorgang angeben.You can specify the display name in a create or update operation. Beachten Sie, dass spätere Aktualisierungen an anderen Eigenschaften dazu führen können, dass der von Ihnen angegebene displayName-Wert von einem automatisch generierten Wert überschrieben wird.Note that later updates to other properties may cause an automatically generated value to overwrite the displayName value you have specified. Um einen bereits vorhandenen Wert beizubehalten, fügen Sie diesen immer als displayName in einen Update-Vorgang ein.To preserve a pre-existing value, always include it as displayName in an update operation.
emailAddressesemailAddresses EmailAddress collectionEmailAddress collection Die E-Mail-Adressen des Kontakts.The contact's email addresses.
fileAsfileAs StringString Der Name, unter dem der Kontakt abgelegt ist.The name the contact is filed under.
generationgeneration StringString Die Generation des Kontakts.The contact's generation.
givenNamegivenName StringString Der Vorname des Kontakts.The contact's given name.
homeAddresshomeAddress PhysicalAddressPhysicalAddress Die Privatadresse des Kontakts.The contact's home address.
homePhoneshomePhones String collectionString collection Die privaten Telefonnummern des Kontakts.The contact's home phone numbers.
idid StringString Eindeutiger Bezeichner für den Kontakt. Schreibgeschützt.The contact's unique identifier. Read-only.
imAddressesimAddresses String collectionString collection Instant Messaging Chatadressen des Kontakts.The contact's instant messaging (IM) addresses.
initialsinitials StringString Die Initialen des Kontakts.The contact's initials.
jobTitlejobTitle StringString Die Position des Kontakts.The contact’s job title.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset Der Zeitpunkt, zu dem der Kontakt geändert wurde. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Mitternacht UTC-Zeit am 1. Januar 2014 würde z. B. wie folgt aussehen: '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 Der Name des Vorgesetzten des Kontakts.The name of the contact's manager.
middleNamemiddleName StringString Der zweite Vorname des Kontakts.The contact's middle name.
mobilePhonemobilePhone StringString Die Mobiltelefonnummer des Kontakts.The contact's mobile phone number.
nickNamenickName StringString Der Spitzname des Kontakts.The contact's nickname.
officeLocationofficeLocation StringString Der Bürostandort des Kontakts.The location of the contact's office.
otherAddressotherAddress PhysicalAddressPhysicalAddress Weitere Adressen für den Kontakt.Other addresses for the contact.
parentFolderIdparentFolderId StringString Die ID des übergeordneten Ordners des Kontakts.The ID of the contact's parent folder.
personalNotespersonalNotes StringString Die Notizen des Benutzers zu dem Kontakt.The user's notes about the contact.
professionprofession StringString Der Beruf des Kontakts.The contact's profession.
spouseNamespouseName ZeichenfolgeString Der Name des Ehepartners/Partners des KontaktsThe name of the contact's spouse/partner.
surnamesurname StringString Der Nachname des Kontakts.The contact's surname.
titletitle StringString Der Titel des Kontakts.The contact's title.
yomiCompanyNameyomiCompanyName StringString Der phonetische japanische Firmenname des Kontakts.The phonetic Japanese company name of the contact.
yomiGivenNameyomiGivenName StringString Der phonetische japanische Vorname des Kontakts.The phonetic Japanese given name (first name) of the contact.
yomiSurnameyomiSurname StringString Der phonetische japanische Nachname des Kontakts.The phonetic Japanese surname (last name) of the contact.

BeziehungenRelationships

BeziehungRelationship TypType BeschreibungDescription
Erweiterungenextensions extension-Sammlungextension collection Die Sammlung der für den Kontakt definierten offenen Erweiterungen. Schreibgeschützt. Lässt NULL-Werte zu.The collection of open extensions defined for the contact. Read-only. Nullable.
multiValueExtendedPropertiesmultiValueExtendedProperties multiValueLegacyExtendedProperty-SammlungmultiValueLegacyExtendedProperty collection Die Sammlung erweiterter mehrwertiger Eigenschaften, die für den Kontakt definiert sind. Schreibgeschützt. Lässt NULL-Werte zu.The collection of multi-value extended properties defined for the contact. Read-only. Nullable.
Fotophoto profilePhotoprofilePhoto Optionales Kontaktbild. Sie können für einen Kontakt ein Foto abrufen oder einstellen.Optional contact picture. You can get or set a photo for a contact.
singleValueExtendedPropertiessingleValueExtendedProperties singleValueLegacyExtendedProperty-SammlungsingleValueLegacyExtendedProperty collection Die Sammlung erweiterter einwertiger Eigenschaften, die für den Kontakt definiert sind. Schreibgeschützt. Lässt NULL-Werte zu.The collection of single-value extended properties defined for the contact. Read-only. Nullable.

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung der Ressource.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" }
}

Siehe auchSee also