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 ZeichenfolgeString 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 ZeichenfolgeString Die geschäftliche Homepage des Kontakts.The business home page of the contact.
businessPhonesbusinessPhones ZeichenfolgenauflistungString collection Die geschäftlichen Telefonnummern des Kontakts.The contact's business phone numbers.
categoriescategories ZeichenfolgenauflistungString collection Die Kategorien, die mit dem Kontakt verknüpft sind.The categories associated with the contact.
changeKeychangeKey ZeichenfolgeString 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 ZeichenfolgenauflistungString collection Die Namen der Kinder des Kontakts.The names of the contact's children.
companyNamecompanyName ZeichenfolgeString 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 ZeichenfolgeString Die Abteilung des Kontakts.The contact's department.
displayNamedisplayName ZeichenfolgeString Der Anzeigename des Kontakts.The contact's display name. Sie können den Anzeigenamen in einem Vorgang Erstellen oder Aktualisieren angeben.You can specify the display name in a create or update operation. Beachten Sie, dass es sich bei spätere Aktualisierungen mit anderen Eigenschaften verursachen einen automatisch generierten Wert den Wert DisplayName überschrieben, den Sie angegeben haben.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 zu erhalten, immer als schließen Sie DisplayName in einem Vorgang zu aktualisieren 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 ZeichenfolgeString Der Name, unter dem der Kontakt abgelegt ist.The name the contact is filed under.
generationgeneration ZeichenfolgeString Die Generation des Kontakts.The contact's generation.
givenNamegivenName ZeichenfolgeString Der Vorname des Kontakts.The contact's given name.
homeAddresshomeAddress PhysicalAddressPhysicalAddress Die Privatadresse des Kontakts.The contact's home address.
homePhoneshomePhones ZeichenfolgenauflistungString collection Die privaten Telefonnummern des Kontakts.The contact's home phone numbers.
idid ZeichenfolgeString Eindeutiger Bezeichner für den Kontakt. Schreibgeschützt.The contact's unique identifier. Read-only.
imAddressesimAddresses ZeichenfolgenauflistungString collection Instant Messaging Chatadressen des Kontakts.The contact's instant messaging (IM) addresses.
initialsinitials ZeichenfolgeString Die Initialen des Kontakts.The contact's initials.
jobTitlejobTitle ZeichenfolgeString 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 ZeichenfolgeString Der Name des Vorgesetzten des Kontakts.The name of the contact's manager.
middleNamemiddleName ZeichenfolgeString Der zweite Vorname des Kontakts.The contact's middle name.
mobilePhonemobilePhone ZeichenfolgeString Die Mobiltelefonnummer des Kontakts.The contact's mobile phone number.
nickNamenickName ZeichenfolgeString Der Spitzname des Kontakts.The contact's nickname.
officeLocationofficeLocation ZeichenfolgeString 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 ZeichenfolgeString Die ID des übergeordneten Ordners des Kontakts.The ID of the contact's parent folder.
personalNotespersonalNotes ZeichenfolgeString Die Notizen des Benutzers zu dem Kontakt.The user's notes about the contact.
professionprofession ZeichenfolgeString 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 ZeichenfolgeString Der Nachname des Kontakts.The contact's surname.
titletitle ZeichenfolgeString Der Titel des Kontakts.The contact's title.
yomiCompanyNameyomiCompanyName ZeichenfolgeString Der phonetische japanische Firmenname des Kontakts.The phonetic Japanese company name of the contact.
yomiGivenNameyomiGivenName ZeichenfolgeString Der phonetische japanische Vorname des Kontakts.The phonetic Japanese given name (first name) of the contact.
yomiSurnameyomiSurname ZeichenfolgeString 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" }
}

Weitere ArtikelSee also