Ressourcentyp contactcontact resource type

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

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:

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung der Ressource.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": "microsoft.graph.phone"}],
  "postalAddresses": [{"@odata.type": "microsoft.graph.physicalAddress"}],
  "profession": "string",
  "spouseName": "string",
  "surname": "string",
  "title": "string",
  "websites": [{"@odata.type": "microsoft.graph.website"}],
  "weddingAnniversary": "date",
  "yomiCompanyName": "string",
  "yomiGivenName": "string",
  "yomiSurname": "string"
}

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'
categoriescategories ZeichenfolgenauflistungString collection Die Kategorien, die mit dem Kontakt verknüpft sind.The categories associated with the contact. Jeder Kategorie entspricht der displayName-Eigenschaft einer für den Benutzer definierten outlookCategory.Each category corresponds to the displayName property of an outlookCategory defined for the user.
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 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 typedEmailAddress -SammlungtypedEmailAddress 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.
Flagflag followupFlagfollowupFlag Der Flag-Wert, der den Status, das Startdatum, das Fälligkeitsdatum oder das Fertigstellungsdatum für den Kontakt angibt.The flag value that indicates the status, start date, due date, or completion date for the contact.
gendergender StringString Das Geschlecht des Kontakts.The contact's gender.
generationgeneration StringString Die Generation des Kontakts.The contact's generation.
givenNamegivenName StringString Der Vorname des Kontakts.The contact's given name.
idid ZeichenfolgeString Eindeutiger Bezeichner für den Kontakt.Unique identifier for the contact. Dieser Wert wird standardmäßig geändert, wenn das Element von einem Container (wie einem Ordner oder Kalender) in einen anderen verschoben wird.By default, this value changes when the item is moved from one container (such as a folder or calendar) to another. Um dieses Verhalten zu ändern, verwenden Prefer: IdType="ImmutableId" Sie die Kopfzeile.To change this behavior, use the Prefer: IdType="ImmutableId" header. Weitere Informationen finden Sie unter Abrufen von unveränderlichen Bezeichnern für Outlook-Ressourcen .See Get immutable identifiers for Outlook resources for more information.Schreibgeschützt.Dieser Wert wird standardmäßig geändert, wenn das Element von einem Container (wie einem Ordner oder Kalender) in einen anderen verschoben wird.By default, this value changes when the item is moved from one container (such as a folder or calendar) to another. Um dieses Verhalten zu ändern, verwenden Prefer: IdType="ImmutableId" Sie die Kopfzeile.To change this behavior, use the Prefer: IdType="ImmutableId" header. Weitere Informationen finden Sie unter Abrufen von unveränderlichen Bezeichnern für Outlook-Ressourcen .See Get immutable identifiers for Outlook resources for more information. 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.
nickNamenickName StringString Der Spitzname des Kontakts.The contact's nickname.
officeLocationofficeLocation StringString Der Bürostandort des Kontakts.The location of the contact's office.
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.
phonesphones phone-Sammlungphone collection Telefonnummern, die dem Kontakt zugeordnet sind, beispielsweise "privat Telefon", "Mobiltelefon" und "geschäftliche Telefonnummer".Phone numbers associated with the contact, for example, home phone, mobile phone, and business phone.
postalAddressespostalAddresses physicalAddress -SammlungphysicalAddress collection Dem Kontakt zugeordnete Adressen, beispielsweise Privatadresse und Geschäftsadresse.Addresses associated with the contact, for example, home address and business address.
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.
websiteswebsites website-Sammlungwebsite collection Dem Kontakt zugeordnete Websites.Web sites associated with the contact.
weddingAnniversaryweddingAnniversary DatumDate Hochzeitsjubiläum des Kontakts.The contact's wedding anniversary.
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.The collection of open extensions defined for the contact. Nullwerte zulassend.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 photophoto 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.

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
Kontakt abrufenGet contact contactcontact Dient zum Lesen der Eigenschaften und der Beziehungen des Kontaktobjekts.Read properties and relationships of contact object.
ErstellenCreate contactcontact 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 contactcontact 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 zu einer neuen oder vorhandenen Ressource hinzu.Create an open extension and add custom properties to a new or existing resource.
Offene Erweiterung abrufenGet open extension openTypeExtension-SammlungopenTypeExtension collection Dient zum Abrufen einer offenen Erweiterung, die durch den Erweiterungsnamen identifiziert wird.Get an open extension identified by the extension 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 contactcontact 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 contactcontact 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.

Siehe auchSee also