Teilen über


Ressourcentyp contact

Namespace: microsoft.graph

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.

Diese Ressource unterstützt Folgendes:

Methoden

Methode Rückgabetyp Beschreibung
Kontakt abrufen Kontakt Dient zum Lesen der Eigenschaften und der Beziehungen des Kontaktobjekts.
Kontakt erstellen Kontakt Dient zum Hinzufügen eines Kontakts zum Stammordner der Kontakte oder zum Kontaktendpunkt eines anderen Kontaktordners.
Kontakt aktualisieren Kontakt Dient zum Aktualisieren des Kontaktobjekts.
Kontakt löschen Keine Dient zum Löschen des Kontaktobjekts.
Kontakt-Delta abrufen contact-Sammlung Dient zum Abrufen eines Satzes von Kontakten, die einem bestimmten Ordner hinzugefügt bzw. daraus gelöscht oder darin aktualisiert wurden.
Offene Erweiterungen
Offene Erweiterung erstellen openTypeExtension Erstellt eine offene Erweiterung und fügt benutzerdefinierte Eigenschaften in einer neuen oder vorhandenen Instanz einer Ressource hinzu.
Offene Erweiterung abrufen openTypeExtension-Sammlung Ruft ein offenes Erweiterungsobjekt oder Objekte basierend auf ihrem Namen oder vollqualifizierten Namen ab.
Erweiterte Eigenschaften
Einwertige Eigenschaft erstellen Kontakt Dient zum Erstellen einer oder mehrerer erweiterter einwertiger Eigenschaften in einem neuen oder vorhandenen Kontakt.
Einwertige Eigenschaft abrufen Kontakt Ruft mithilfe von $expand oder $filter Kontakte mit einer bestimmten einwertigen erweiterten Eigenschaft ab.
Erstellen einer mehrwertigen Eigenschaft Kontakt Dient zum Erstellen einer oder mehrerer erweiterter mehrwertiger Eigenschaften in einem neuen oder vorhandenen Kontakt.
Abrufen einer mehrwertigen Eigenschaft Kontakt Dient zum Abrufen eines Kontakts mit einer erweiterten mehrwertigen Eigenschaft mithilfe von $expand.

Eigenschaften

Eigenschaft Typ Beschreibung
assistantName String Der Name des Assistenten des Kontakts.
birthday DateTimeOffset 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. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z
businessAddress PhysicalAddress Die Geschäftsadresse des Kontakts.
businessHomePage String Die geschäftliche Homepage des Kontakts.
businessPhones String collection Die geschäftlichen Telefonnummern des Kontakts.
categories String collection Die Kategorien, die mit dem Kontakt verknüpft sind.
changeKey String 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.
children String collection Die Namen der Kinder des Kontakts.
CompanyName String Der Name des Unternehmens des Kontakts.
createdDateTime DateTimeOffset 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. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z
department String Die Abteilung des Kontakts.
displayName String Der Anzeigename des Kontakts. Sie können den Anzeigenamen in einem Create- oder Update-Vorgang angeben. 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. Um einen bereits vorhandenen Wert beizubehalten, fügen Sie diesen immer als displayName in einen Update-Vorgang ein.
emailAddresses EmailAddress collection Die E-Mail-Adressen des Kontakts.
fileAs String Der Name, unter dem der Kontakt abgelegt ist.
generation String Das Suffix des Kontakts.
givenName String Der Vorname des Kontakts.
homeAddress PhysicalAddress Die Privatadresse des Kontakts.
homePhones String collection Die privaten Telefonnummern des Kontakts.
id String Eindeutiger Bezeichner für den Kontakt. Standardmäßig ändert sich dieser Wert, wenn das Element von einem Container (z. B. einem Ordner oder Kalender) in einen anderen verschoben wird. Verwenden Sie den Prefer: IdType="ImmutableId"-Header, um dieses Verhalten zu ändern. Weitere Informationen finden Sie unter Abrufen unveränderlicher Bezeichner für Outlook-Ressourcen. Schreibgeschützt.
imAddresses String collection Instant Messaging Chatadressen des Kontakts.
initials String Die Initialen des Kontakts.
jobTitle String Die Position des Kontakts.
lastModifiedDateTime DateTimeOffset 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. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z
manager String Der Name des Vorgesetzten des Kontakts.
middleName String Der zweite Vorname des Kontakts.
mobilePhone String Die Mobiltelefonnummer des Kontakts.
nickName String Der Spitzname des Kontakts.
officeLocation String Der Bürostandort des Kontakts.
otherAddress PhysicalAddress Weitere Adressen für den Kontakt.
parentFolderId String Die ID des übergeordneten Ordners des Kontakts.
personalNotes String Die Notizen des Benutzers zu dem Kontakt.
profession String Der Beruf des Kontakts.
spouseName Zeichenfolge Der Name des Ehepartners/Partners des Kontakts
surname String Der Nachname des Kontakts.
title String Der Titel des Kontakts.
yomiCompanyName String Der phonetische japanische Firmenname des Kontakts.
yomiGivenName String Der phonetische japanische Vorname des Kontakts.
yomiSurname String Der phonetische japanische Nachname des Kontakts.

Beziehungen

Beziehung Typ Beschreibung
Erweiterungen extension-Sammlung Die Sammlung der für den Kontakt definierten offenen Erweiterungen. Schreibgeschützt. Nullwerte zulassend.
multiValueExtendedProperties multiValueLegacyExtendedProperty-Sammlung Die Sammlung erweiterter mehrwertiger Eigenschaften, die für den Kontakt definiert sind. Schreibgeschützt. Nullwerte zulassend.
Foto profilePhoto Optionales Kontaktbild. Sie können für einen Kontakt ein Foto abrufen oder einstellen.
singleValueExtendedProperties singleValueLegacyExtendedProperty-Sammlung Die Sammlung erweiterter einwertiger Eigenschaften, die für den Kontakt definiert sind. Schreibgeschützt. Nullwerte zulassend.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

{
  "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",
  "photo": { "@odata.type": "microsoft.graph.profilePhoto" },
  "profession": "string",
  "spouseName": "string",
  "surname": "string",
  "title": "string",
  "yomiCompanyName": "string",
  "yomiGivenName": "string",
  "yomiSurname": "string"
}