Feedback Bearbeiten

Ressourcentyp contact

  • Artikel
  • 5 Minuten Lesedauer

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

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.
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.
delta 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.
Schemaerweiterungen
Schemaerweiterungswerte hinzufügen Dient zum Erstellen einer Schemaerweiterungsdefinition und anschließenden Verwenden der Definition zum Hinzufügen benutzerdefinierter typisierter Daten zu einer Ressource.
Erweiterte Eigenschaften
Einwertige erweiterte Eigenschaft erstellen Kontakt Dient zum Erstellen einer oder mehrerer erweiterter einwertiger Eigenschaften in einem neuen oder vorhandenen Kontakt.
Ereignis mit erweiterter einwertiger 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.
Ereignis mit erweiterter mehrwertiger 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. Mitternacht UTC-Zeit am 1. Januar 2014 ist beispielsweise 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, 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. Mitternacht UTC-Zeit am 1. Januar 2014 ist beispielsweise 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 typedEmailAddress-Sammlung Die E-Mail-Adressen des Kontakts.
fileAs String Der Name, unter dem der Kontakt abgelegt ist.
Flag followupFlag Der Kennzeichenwert, der den Status, das Startdatum, das Fälligkeitsdatum oder das Abschlussdatum für den Kontakt angibt.
gender Zeichenfolge Das Geschlecht des Kontakts.
generation String Die Generation des Kontakts.
givenName String Der Vorname des Kontakts.
id Zeichenfolge 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. Mitternacht UTC-Zeit am 1. Januar 2014 ist beispielsweise 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 Telefon dem Kontakt zugeordnete Nummern, z. B. Privattelefon, Mobiltelefon und Geschäftstelefon.
postalAddresses physicalAddress-Sammlung Dem Kontakt zugeordnete Adressen, z. B. Privat- 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.
vegasAnniversary Datum Jahrestag 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. Lässt NULL-Werte zu.
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. Lässt NULL-Werte zu.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

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

Siehe auch