Ressourcentyp contact

  • Artikel

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

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
Get Kontakt Dient zum Lesen der Eigenschaften und der Beziehungen des Kontaktobjekts.
Erstellen Kontakt Dient zum Hinzufügen eines Kontakts zum Stammordner der Kontakte oder zum Kontaktendpunkt eines anderen Kontaktordners.
Aktualisieren Kontakt Dient zum Aktualisieren des Kontaktobjekts.
Löschen Keine Dient zum Löschen des Kontaktobjekts.
Endgültig löschen Keine Löschen Sie einen Kontakt endgültig, und platzieren Sie ihn im Ordner "Löschvorgänge" im Ordner "Wiederherstellbare Elemente" im Postfach des Benutzers.
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 zu einer neuen oder vorhandenen Ressource hinzu.
Offene Erweiterung abrufen openTypeExtension-Sammlung Dient zum Abrufen einer offenen Erweiterung, die durch den Erweiterungsnamen identifiziert wird.
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.
Erweiterte mehrwertige Eigenschaft erstellen Kontakt Dient zum Erstellen einer oder mehrerer erweiterter mehrwertiger Eigenschaften in einem neuen oder vorhandenen Kontakt.
Erweiterte mehrwertige Eigenschaft abrufen 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
categories String collection Die Kategorien, die mit dem Kontakt verknüpft sind. Jeder Kategorie entspricht der displayName-Eigenschaft einer für den Benutzer definierten outlookCategory.
changeKey String Gibt die Version des Kontakts an. Jedes Mal, wenn der Kontakt geändert wird, ändert sich auch changeKey , sodass Exchange Änderungen auf die richtige Version des Objekts anwenden kann.
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. Spätere Aktualisierungen anderer Eigenschaften können dazu führen, dass ein automatisch generierter Wert den von Ihnen angegebenen displayName-Wert überschreibt. Um einen bereits vorhandenen Wert beizubehalten, fügen Sie diesen immer als displayName in einen Update-Vorgang ein.
emailAddresses typedEmailAddress-Sammlung Die E-Mail-Adressen des Kontakts.
fileAs String Der Name, unter dem der Kontakt abgelegt ist.
Flag followupFlag Der Flagwert, der den Status, das Startdatum, das Fälligkeitsdatum oder das Abschlussdatum des Kontakts angibt.
gender String Das Geschlecht des Kontakts.
generation String Das Suffix des Kontakts.
givenName String Der Vorname 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.
nickName String Der Spitzname des Kontakts.
officeLocation String Der Bürostandort des Kontakts.
parentFolderId String Die ID des übergeordneten Ordners des Kontakts.
personalNotes String Die Notizen des Benutzers zu dem Kontakt.
phones phone-Sammlung Telefonnummern, die dem Kontakt zugeordnet sind, z. B. Privattelefon, Mobiltelefon und Geschäftstelefon.
postalAddresses physicalAddress-Sammlung Dem Kontakt zugeordnete Adressen, z. B. Privatadresse und Geschäftsadresse.
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.
websites website-Sammlung Websites, die dem Kontakt zugeordnet sind.
weddingAnniversary Datum Der Hochzeitstag 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. Nullwerte zulassend.
multiValueExtendedProperties multiValueLegacyExtendedProperty-Sammlung Die Sammlung erweiterter mehrwertiger Eigenschaften, die für den Kontakt definiert sind. Schreibgeschützt. Nullwerte zulassend.
Foto photo 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 veranschaulicht den Ressourcentyp.

{
  "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"
}

Verwandte Inhalte