Table of contents
TOC
Inhaltsverzeichnis reduzieren
Inhaltsverzeichnis erweitern
Zuletzt aktualisiert: 20.06.2018

Outlook-Kontakte – REST-API-Referenz

Diese Dokumentation behandelt die Beta-Version der Kontakt-API in der Vorschauversion. Die Funktionen der Vorschauversion können vor der Fertigstellung geändert werden und können den Code, der sie verwendet, unterbrechen. Aus diesem Grund sollten Sie in der Regel nur eine Fertigungsversion einer API in Ihrem Produktivcode verwenden. Falls vorhanden, ist v2.0 derzeit die bevorzugte Version.

Version 1.0 der Outlook REST API ist veraltet. Ab 1. November 2018können Anwendungen die Standardauthentifizierung nicht mehr mit dem REST-Endpunkt v1.0 verwenden (https://outlook.office.com/api/v1.0)). Ab dem 1. November 2019wird der v1.0 REST-Endpunkt vollständig stillgelegt und die v1.0-Dokumentation kurz darauf entfernt. Starten Sie die Migration Ihrer Anwendung zur Verwendung der Outlook REST API in v1.0 von Microsoft Graph. Weitere Details finden Sie in unserer Ankündigung.

Gilt für: Exchange Online | Office 365 | Hotmail.com | Live.com | MSN.com | Outlook.com | Passport.com

Die Outlook-Kontakte-API bietet Zugriff auf die Kontakte und die Kontaktordner eines Benutzers, die durch Azure Active Directory auf Office 365 geschützt sind, sowie auf ähnliche Daten in Microsoft-Konten speziell in diesen Domänen: Hotmail.com, Live.com, MSN.com, Outlook.com und Passport.com.

Beachten Sie: Zur Vereinfachung der Referenz verwendet der Rest dieses Artikels "Outlook.com", um diese Microsoft-Konto-Domäneneinzuschließen.

Sie interessieren sich nicht für die Beta-Version der API? Verwenden Sie das Steuerelement in der oberen rechten Ecke, und wählen Sie die gewünschte Version aus.

Kein Interesse an v2.0 der API? Verwenden Sie das Steuerelement oben rechts und wählen Sie Ihre gewünschte Version.

Kein Interesse an v1.0 der API? Verwenden Sie das Steuerelement oben rechts und wählen Sie Ihre gewünschte Version.

Alle Kontakt-API-Operationen

Kontakt-Operationen Kontakte werden in Kontaktordnern gespeichert. Sie können Kontakte abrufen, erstellen, ändern und löschen.

Kontakte abrufen | Kontakte und Kontaktordner synchronisieren | Kontakte erstellen | Kontakte aktualisieren | Kontakte löschen

Kontaktordner-Operationen Kontaktordner können Kontakte und andere Kontaktordner enthalten. Sie können Kontaktordner abrufen und Kontakte in einem Kontaktordner erstellen.

Kontaktordner abrufen

Kontaktfoto-Operationen Jeder Kontakt kann ein optionales Kontaktbild haben. Sie können ein Foto für einen Kontakt abrufen oder einstellen.

Kontaktfoto abrufen | Kontaktfoto einstellen

Siehe auch:

REST API Kontakt-Ressource | REST API Kontaktordner-Ressource

Verwendung der Kontakte REST API

Authentifizierung

Wie andere Outlook REST API, sollten Sie für jede Anfrage an die Kontakte-API ein gültiges Zugriffstoken angeben. Um ein Zugangstoken zu erhalten, müssen Sie Ihre Anwendung registriert und identifiziert haben und die entsprechende Autorisierung erhalten haben. Sie können mehr über einige optimierte Registrierungs- und Autorisierungsoptionen für Sie herausfinden. Beachten Sie dies, wenn Sie mit den spezifischen Operationen in der Kontakte-API fortfahren.

Version von API

Die Kontakte REST API wird in allen Versionen der Outlook REST API unterstützt. Die Funktionalität kann je nach spezifischer Version unterschiedlich sein.

Ziel-Benutzer

Die Kontakt-API-Anfragen werden immer im Namen des aktuellen Benutzers ausgeführt.

Siehe Verwenden Sie die Outlook REST API für weitere Informationen, die allen Untergruppen von Outlook REST API gemeinsam sind.


Kontakte erhalten

Sie können eine Kontaktsammlung oder einen einzelnen Kontakt aus einem Kontaktordner erhalten.

Minimal benötigter Bereich: einer der folgenden:

Eine Kontaktsammlung erhalten

Erhalten Sie alle Kontakte im Postfach des angemeldeten Benutzers (.../me/contacts) oder aus dem angegebenen Kontaktordner.

GET https://outlook.office.com/api/beta/me/contacts
GET https://outlook.office.com/api/beta/me/contactfolders/{contact_folder_id}/contacts
Erforderlicher ParameterTypBeschreibung
URL-Parameter
contact_folder_idStringDie Kontaktordner-ID, wenn Sie Kontakte aus einem bestimmten Ordner erhalten.

Hinweis: Standardmäßig umfasst jeder Kontakt in der Antwort alle seine Eigenschaften. Verwenden Sie $select, um nur die Eigenschaften anzugeben, die Sie für die beste Leistung benötigen. Die ID-Eigenschaft wird immer zurückgegeben. Siehe OData Abfrage-Parameter für Filter-, Sortier- und Paging-Parameter.

Stichprobenanfrage

GET https://outlook.office.com/api/beta/me/contacts?$select=EmailAddresses,GivenName,Surname

Stichprobenantwort

Status code: 200

{
    "@odata.context": "https://outlook.office.com/api/beta/$metadata#Me/Contacts(EmailAddresses,GivenName,Surname)",
    "value": [
        {
            "@odata.id": "https://outlook.office.com/api/beta/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Contacts('AAMkAGI2THk3AAA=')",
            "@odata.etag": "W/\"EQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTIa7\"",
            "Id": "AAMkAGI2THk3AAA=",
            "GivenName": "Rob",
            "Surname": "Young",
            "EmailAddresses": [
                {
                    "Name": "roby@a830edad9050849NDA1.onmicrosoft.com",
                    "Address": "roby@a830edad9050849NDA1.onmicrosoft.com"
                }
            ]
        },
        {
            "@odata.id": "https://outlook.office.com/api/beta/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Contacts('AAMkAGI2THkzAAA=')",
            "@odata.etag": "W/\"EQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTIa3\"",
            "Id": "AAMkAGI2THkzAAA=",
            "GivenName": "Janet",
            "Surname": "Schorr",
            "EmailAddresses": [
                {
                    "Name": "janets@a830edad9050849NDA1.onmicrosoft.com",
                    "Address": "janets@a830edad9050849NDA1.onmicrosoft.com"
                }
            ]
        }
    ]
}

Antwort-Typ

Die gewünschte Kontakt Sammlung.


Erhalten Sie einen Kontakt

Minimal benötigter Bereich: einer der folgenden:

Erhalten Sie einen Kontakt durch die Verwendung einer Kontakt-ID.

GET https://outlook.office.com/api/beta/me/contacts/{contact_id}
Erforderlicher ParameterTypBeschreibung
URL-Parameter
contact_idStringDie Kontakt-ID.

Antwort-Typ

Der gewünschte Kontakt.

Stichprobenanfrage

GET https://outlook.office.com/api/beta/me/contacts/AAMkADlkAAAMRFUEAAA=

Stichprobenantwort

Status code: 200

{
    "@odata.context":"https://outlook.office365.com/api/beta/$metadata#Me/Contacts/$entity",
    "@odata.id":"https://outlook.office365.com/api/beta/Users('af183ae6-7efa-41e4-aa87-fe8790598625@9ac5b33f-49cf-45f7-9ef1-b581dce364d8')/Contacts('AAMkADlkAAAMRFUEAAA=')",
    "@odata.etag":"W/\"EQAAABYAAADDii8zlkFETIcBiRn8yAbgAAAMRdhl\"",
    "Id":"AAMkADlkAAAMRFUEAAA=",
    "CreatedDateTime":"2016-07-16T06:43:15Z",
    "LastModifiedDateTime":"2016-07-16T06:43:15Z",
    "ChangeKey":"EQAAABYAAADDii8zlkFETIcBiRn8yAbgAAAMRdhl",
    "Categories":[
    ],
    "ParentFolderId":"AAMkADlk8yAbgAAAAAAEkAAA=",
    "Birthday":null,
    "FileAs":"",
    "DisplayName":"Garret Vargas",
    "GivenName":"Garret",
    "Initials":null,
    "MiddleName":null,
    "NickName":null,
    "Surname":"Vargas",
    "Title":null,
    "YomiGivenName":null,
    "YomiSurname":null,
    "YomiCompanyName":null,
    "Generation":null,
    "EmailAddresses":[
        {
            "Name":"Garret Vargas",
            "Address":"GarretV@contoso.onmicrosoft.com"
        }
    ],
    "Websites":[
    ],
    "ImAddresses":[
        "sip:garretv@contoso.onmicrosoft.com"
    ],
    "JobTitle":"CVP Operations",
    "CompanyName":"",
    "Department":"Operations",
    "OfficeLocation":"36/2121",
    "Profession":null,
    "AssistantName":null,
    "Manager":null,
    "Phones":[
        {
            "Type":"Home",
            "Number":""
        },
        {
            "Type":"Business",
            "Number":"+1 206 555 0105"
        },
        {
            "Type":"Mobile",
            "Number":""
        }
    ],
    "PostalAddresses":[
        {
            "Type":"Business",
            "City":"Seattle"
        }
    ],
    "SpouseName":null,
    "PersonalNotes":null,
    "Children":[
    ],
    "Gender":null,
    "IsFavorite":null,
    "Flag":{
        "FlagStatus":"NotFlagged"
    }
}

Hinweis: Standardmäßig enthält die Antwort alle Eigenschaften des Kontakts. Verwenden Sie $select, um nur die Eigenschaften anzugeben, die Sie für die beste Leistung benötigen. Die ID-Eigenschaft wird immer zurückgegeben. Siehe OData Abfrage-Parameter für Filter-, Sortier- und Paging-Parameter.

Das folgende Beispiel zeigt, wie man $select verwendet, um nur die E-Mail-Adressen, Vornamen und Nachnamen als Eigenschaften des Kontakts in der Antwort anzugeben.

Stichprobenanfrage

GET https://outlook.office.com/api/beta/me/contacts/AAMkAGI2THk0AAA=?$select=EmailAddresses,GivenName,Surname

Stichprobenantwort

Status code: 200

{
    "@odata.context": "https://outlook.office.com/api/beta/$metadata#Me/Contacts(EmailAddresses,GivenName,Surname)/$entity",
    "@odata.id": "https://outlook.office.com/api/beta/Users('af183ae6-7efa-41e4-aa87-fe8790598625@9ac5b33f-49cf-45f7-9ef1-b581dce364d8')/Contacts('AAMkADlkAAAMRFUEAAA=')",
    "@odata.etag": "W/\"EQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTIa4\"",
    "Id": "AAMkADlkAAAMRFUEAAA=",
    "GivenName": "Garth",
    "Surname": "Vargas",
    "EmailAddresses": [
       {
            "Name":"Garret Vargas",
            "Address":"GarretV@contoso.onmicrosoft.com"
        }
    ]
}

Minimal benötigter Bereich: einer der folgenden:

Eine Kontaktsammlung erhalten

Erhalten Sie eine Kontaktsammlung aus dem Kontakteordner des angemeldeten Benutzers (.../me/contacts) oder aus dem angegebenen Kontaktordner.

GET https://outlook.office.com/api/v2.0/me/contacts
GET https://outlook.office.com/api/v2.0/me/contactfolders/{contact_folder_id}/contacts
Erforderlicher ParameterTypBeschreibung
URL-Parameter
contact_folder_idStringDie Kontaktordner-ID, wenn Sie Kontakte aus einem bestimmten Ordner erhalten.

Hinweis: Standardmäßig umfasst jeder Kontakt in der Antwort alle seine Eigenschaften. Verwenden Sie $select, um nur die Eigenschaften anzugeben, die Sie für die beste Leistung benötigen. Die ID-Eigenschaft wird immer zurückgegeben. Siehe OData Abfrage-Parameter für Filter-, Sortier- und Paging-Parameter.

Stichprobenanfrage

GET https://outlook.office.com/api/v2.0/me/contacts?$select=EmailAddresses,GivenName,Surname

Stichprobenantwort

Status code: 200

{
    "@odata.context": "https://outlook.office.com/api/v2.0/$metadata#Me/Contacts(EmailAddresses,GivenName,Surname)",
    "value": [
        {
            "@odata.id": "https://outlook.office.com/api/v2.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Contacts('AAMkAGI2THk3AAA=')",
            "@odata.etag": "W/\"EQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTIa7\"",
            "Id": "AAMkAGI2THk3AAA=",
            "GivenName": "Rob",
            "Surname": "Young",
            "EmailAddresses": [
                {
                    "Name": "roby@a830edad9050849NDA1.onmicrosoft.com",
                    "Address": "roby@a830edad9050849NDA1.onmicrosoft.com"
                }
            ]
        },
        {
            "@odata.id": "https://outlook.office.com/api/v2.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Contacts('AAMkAGI2THkzAAA=')",
            "@odata.etag": "W/\"EQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTIa3\"",
            "Id": "AAMkAGI2THkzAAA=",
            "GivenName": "Janet",
            "Surname": "Schorr",
            "EmailAddresses": [
                {
                    "Name": "janets@a830edad9050849NDA1.onmicrosoft.com",
                    "Address": "janets@a830edad9050849NDA1.onmicrosoft.com"
                }
            ]
        }
    ]
}

Antwort-Typ

Die gewünschte Kontakt Sammlung.


Erhalten Sie einen Kontakt

Minimal benötigter Bereich: einer der folgenden:

Erhalten Sie einen Kontakt durch die Verwendung einer Kontakt-ID.

GET https://outlook.office.com/api/v2.0/me/contacts/{contact_id}
Erforderlicher ParameterTypBeschreibung
URL-Parameter
contact_idStringDie Kontakt-ID.

Stichprobenanfrage

GET https://outlook.office.com/api/v2.0/me/contacts/AAMkAGI2THk0AAA=

Stichprobenantwort

Status code: 200

{
    "@odata.context": "https://outlook.office.com/api/v2.0/$metadata#Me/Contacts/$entity",
    "@odata.id": "https://outlook.office.com/api/v2.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Contacts('AAMkAGI2THk0AAA=')",
    "@odata.etag": "W/\"EQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTIa4\"",
    "Id": "AAMkAGI2THk0AAA=",
    "CreatedDateTime": "2014-10-19T23:08:24Z",
    "LastModifiedDateTime": "2014-10-19T23:08:24Z",
    "ChangeKey": "EQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTIa4",
    "Categories": [],
    "ParentFolderId": "AAMkAGI2AAEOAAA=",
    "Birthday": null,
    "FileAs": "Fort, Garth",
    "DisplayName": "Garth Fort",
    "GivenName": "Garth",
    "Initials": "G.F.",
    "MiddleName": null,
    "NickName": "Garth",
    "Surname": "Fort",
    "Title": null,
    "YomiGivenName": null,
    "YomiSurname": null,
    "YomiCompanyName": null,
    "Generation": null,
    "EmailAddresses": [
        {
            "Name": "Garth",
            "Address": "garthf@a830edad9050849NDA1.onmicrosoft.com"
        }
    ],
    "ImAddresses": [
        "sip:garthf@a830edad9050849nda1.onmicrosoft.com"
    ],
    "JobTitle": "Web Marketing Manager",
    "CompanyName": "Contoso, Inc.",
    "Department": "Sales & Marketing",
    "OfficeLocation": "20/1101",
    "Profession": null,
    "BusinessHomePage": "http://www.contoso.com",
    "AssistantName": null,
    "Manager": null,
    "HomePhones": [],
    "MobilePhone1": null,
    "BusinessPhones": [
        "+1 918 555 0101"
    ],
    "HomeAddress": {},
    "BusinessAddress": {
      "Street": "10 Contoso Way",
      "City": "Redmond",
      "State": "WA",
      "CountryOrRegion": "USA",
      "PostalCode": "98075"  
    },
    "OtherAddress": {},
    "SpouseName": null,
    "PersonalNotes": null,
    "Children": []
}

Antwort-Typ

Der gewünschte Kontakt.

Hinweis: Standardmäßig enthält die Antwort alle Eigenschaften des Kontakts. Verwenden Sie $select, um nur die Eigenschaften anzugeben, die Sie für die beste Leistung benötigen. Die ID-Eigenschaft wird immer zurückgegeben. Siehe OData Abfrage-Parameter für Filter-, Sortier- und Paging-Parameter.

Das folgende Beispiel zeigt, wie man $select verwendet, um nur die E-Mail-Adressen, Vornamen und Nachnamen als Eigenschaften des Kontakts in der Antwort anzugeben.

Stichprobenanfrage

GET https://outlook.office.com/api/v2.0/me/contacts/AAMkAGI2THk0AAA=?$select=EmailAddresses,GivenName,Surname

Stichprobenantwort

Status code: 200

{
    "@odata.context": "https://outlook.office.com/api/v2.0/$metadata#Me/Contacts(EmailAddresses,GivenName,Surname)/$entity",
    "@odata.id": "https://outlook.office.com/api/v2.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Contacts('AAMkAGI2THk0AAA=')",
    "@odata.etag": "W/\"EQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTIa4\"",
    "Id": "AAMkAGI2THk0AAA=",
    "GivenName": "Garth",
    "Surname": "Fort",
    "EmailAddresses": [
        {
            "Name": "garthf@a830edad9050849NDA1.onmicrosoft.com",
            "Address": "garthf@a830edad9050849NDA1.onmicrosoft.com"
        }
    ]
}

Eine Kontaktsammlung erhalten | Einen Kontakt erhalten

Eine Kontaktsammlung erhalten

Minimal benötigter Bereich: einer der folgenden:

Erhalten Sie eine Kontaktsammlung aus dem Kontakteordner des angemeldeten Benutzers (.../me/contacts) oder aus dem angegebenen Kontaktordner.

GET https://outlook.office.com/api/v1.0/me/contacts
GET https://outlook.office.com/api/v1.0/me/contactfolders/{contact_folder_id}/contacts
Erforderlicher ParameterTypBeschreibung
URL-Parameter
contact_folder_idStringDie Kontaktordner-ID, wenn Sie Kontakte aus einem bestimmten Ordner erhalten.

Hinweis: Standardmäßig umfasst jeder Kontakt in der Antwort alle seine Eigenschaften. Verwenden Sie $select, um nur die Eigenschaften anzugeben, die Sie für die beste Leistung benötigen. Die ID-Eigenschaft wird immer zurückgegeben. Siehe OData Abfrage-Parameter für Filter-, Sortier- und Paging-Parameter.

Das folgende Beispiel zeigt, wie man $select verwendet, um nur die E-Mail-Adressen, Vornamen und Nachnamen als Eigenschaften des Kontakts in der Antwort anzugeben. Lesen Sie die Stichprobenantwort Erhalten Sie einen Kontakt für eine vollständige Liste der Eigenschaften, die für einen Kontakt zurückgegeben würden, wenn Sie nicht $selectverwenden.

Stichprobenanfrage

GET https://outlook.office.com/api/v1.0/me/contacts?$select=EmailAddresses,GivenName,Surname

Stichprobenantwort

Statuscode: 200

{
    "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Contacts(EmailAddresses,GivenName,Surname)",
    "value": [
        {
            "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Contacts('AAMkAGI2THk0AAA=')",
    "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Contacts(EmailAddresses,GivenName,Surname)",
    "value": [
        {
            "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Contacts('AAMkAGI2THk0AAA=')",
            "@odata.etag": "W/\"EQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTIa7\"",
            "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEOAACd9nJ-tVysQos2hTfspaWRAAADTHk3AAA=",
            "GivenName": "Rob",
            "Surname": "Young",
            "EmailAddresses": [
                {
                    "Name": "roby@a830edad9050849NDA1.onmicrosoft.com",
                    "Address": "roby@a830edad9050849NDA1.onmicrosoft.com"
                }
            ]
        },
        {
            "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Contacts('AAMkAGI2THk0AAA=')",
            "@odata.etag": "W/\"EQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTIa6\"",
            "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEOAACd9nJ-tVysQos2hTfspaWRAAADTHk2AAA=",
            "GivenName": "Pavel",
            "Surname": "Bansky",
            "EmailAddresses": [
                {
                    "Name": "pavelb@a830edad9050849NDA1.onmicrosoft.com",
                    "Address": "pavelb@a830edad9050849NDA1.onmicrosoft.com"
                }
            ]
        },
        {
            "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Contacts('AAMkAGI2THk0AAA=')",
            "@odata.etag": "W/\"EQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTIa5\"",
            "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEOAACd9nJ-tVysQos2hTfspaWRAAADTHk1AAA=",
            "GivenName": "Katie",
            "Surname": "Jordan",
            "EmailAddresses": [
                {
                    "Name": "katiej@a830edad9050849NDA1.onmicrosoft.com",
                    "Address": "katiej@a830edad9050849NDA1.onmicrosoft.com"
                }
            ]
        },
        {
            "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Contacts('AAMkAGI2THk0AAA=')",
            "@odata.etag": "W/\"EQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTIa4\"",
            "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEOAACd9nJ-tVysQos2hTfspaWRAAADTHk0AAA=",
            "GivenName": "Garth",
            "Surname": "Fort",
            "EmailAddresses": [
                {
                    "Name": "garthf@a830edad9050849NDA1.onmicrosoft.com",
                    "Address": "garthf@a830edad9050849NDA1.onmicrosoft.com"
                }
            ]
        },
        {
            "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Contacts('AAMkAGI2THk0AAA=')",
            "@odata.etag": "W/\"EQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTIa3\"",
            "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEOAACd9nJ-tVysQos2hTfspaWRAAADTHkzAAA=",
            "GivenName": "Janet",
            "Surname": "Schorr",
            "EmailAddresses": [
                {
                    "Name": "janets@a830edad9050849NDA1.onmicrosoft.com",
                    "Address": "janets@a830edad9050849NDA1.onmicrosoft.com"
                }
            ]
        }
    ]
}
            "@odata.etag": "W/\"EQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTIa7\"",
            "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEOAACd9nJ-tVysQos2hTfspaWRAAADTHk3AAA=",
            "GivenName": "Rob",
            "Surname": "Young",
            "EmailAddresses": [
                {
                    "Name": "roby@a830edad9050849NDA1.onmicrosoft.com",
                    "Address": "roby@a830edad9050849NDA1.onmicrosoft.com"
                }
            ]
        },
        {
            "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Contacts('AAMkAGI2THk0AAA=')",
            "@odata.etag": "W/\"EQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTIa6\"",
            "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEOAACd9nJ-tVysQos2hTfspaWRAAADTHk2AAA=",
            "GivenName": "Pavel",
            "Surname": "Bansky",
            "EmailAddresses": [
                {
                    "Name": "pavelb@a830edad9050849NDA1.onmicrosoft.com",
                    "Address": "pavelb@a830edad9050849NDA1.onmicrosoft.com"
                }
            ]
        },
        {
            "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Contacts('AAMkAGI2THk0AAA=')",
            "@odata.etag": "W/\"EQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTIa5\"",
            "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEOAACd9nJ-tVysQos2hTfspaWRAAADTHk1AAA=",
            "GivenName": "Katie",
            "Surname": "Jordan",
            "EmailAddresses": [
                {
                    "Name": "katiej@a830edad9050849NDA1.onmicrosoft.com",
                    "Address": "katiej@a830edad9050849NDA1.onmicrosoft.com"
                }
            ]
        },
        {
            "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Contacts('AAMkAGI2THk0AAA=')",
            "@odata.etag": "W/\"EQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTIa4\"",
            "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEOAACd9nJ-tVysQos2hTfspaWRAAADTHk0AAA=",
            "GivenName": "Garth",
            "Surname": "Fort",
            "EmailAddresses": [
                {
                    "Name": "garthf@a830edad9050849NDA1.onmicrosoft.com",
                    "Address": "garthf@a830edad9050849NDA1.onmicrosoft.com"
                }
            ]
        },
        {
            "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Contacts('AAMkAGI2THk0AAA=')",
            "@odata.etag": "W/\"EQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTIa3\"",
            "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEOAACd9nJ-tVysQos2hTfspaWRAAADTHkzAAA=",
            "GivenName": "Janet",
            "Surname": "Schorr",
            "EmailAddresses": [
                {
                    "Name": "janets@a830edad9050849NDA1.onmicrosoft.com",
                    "Address": "janets@a830edad9050849NDA1.onmicrosoft.com"
                }
            ]
        }
    ]
}

Antwort-Typ

Die gewünschte Kontakt Sammlung.


Erhalten Sie einen Kontakt

Minimal benötigter Bereich: einer der folgenden:

Erhalten Sie einen Kontakt durch die Verwendung einer Kontakt-ID.

GET https://outlook.office.com/api/{version}/me/contacts/{contact_id}
Erforderlicher ParameterTypBeschreibung
URL-Parameter
VersionStringDie Version der API.
contact_idStringDie Kontakt-ID.

Stichprobenanfrage

GET https://outlook.office.com/api/v1.0/me/contacts/AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop

Stichprobenantwort

Statuscode: 200

{
    "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Contacts/$entity",
    "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Contacts('AAMkAGI2THk0AAA=')",
    "@odata.etag": "W/\"EQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTIa4\"",
    "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEOAACd9nJ-tVysQos2hTfspaWRAAADTHk0AAA=",
    "DateTimeCreated": "2014-10-19T23:08:24Z",
    "DateTimeLastModified": "2014-10-19T23:08:24Z",
    "ChangeKey": "EQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTIa4",
    "Categories": [],
    "ParentFolderId": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEOAAA=",
    "Birthday": null,
    "FileAs": "Fort, Garth",
    "DisplayName": "Garth Fort",
    "GivenName": "Garth",
    "Initials": null,
    "MiddleName": null,
    "NickName": null,
    "Surname": "Fort",
    "Title": null,
    "YomiGivenName": null,
    "YomiSurname": null,
    "YomiCompanyName": null,
    "Generation": null,
    "EmailAddresses": [
        {
            "Name": "garthf@a830edad9050849NDA1.onmicrosoft.com",
            "Address": "garthf@a830edad9050849NDA1.onmicrosoft.com"
        }
    ],
    "ImAddresses": [
        "sip:garthf@a830edad9050849nda1.onmicrosoft.com"
    ],
    "JobTitle": "Web Marketing Manager",
    "CompanyName": null,
    "Department": "Sales & Marketing",
    "OfficeLocation": "20/1101",
    "Profession": null,
    "BusinessHomePage": null,
    "AssistantName": null,
    "Manager": null,
    "HomePhones": [],
    "MobilePhone1": null,
    "BusinessPhones": [
        "+1 918 555 0101"
    ],
    "HomeAddress": {},
    "BusinessAddress": {},
    "OtherAddress": {},
    "SpouseName": null,
    "PersonalNotes": null,
    "Children": []
}

Antwort-Typ

Der gewünschte Kontakt.

Hinweis: Standardmäßig enthält die Antwort alle Eigenschaften des Kontakts. Verwenden Sie $select, um nur die Eigenschaften anzugeben, die Sie für die beste Leistung benötigen. Die ID-Eigenschaft wird immer zurückgegeben. Siehe OData Abfrage-Parameter für Filter-, Sortier- und Paging-Parameter.

Das folgende Beispiel zeigt, wie man $select verwendet, um nur die E-Mail-Adressen, Vornamen und Nachnamen als Eigenschaften des Kontakts in der Antwort anzugeben.

Stichprobenanfrage

GET https://outlook.office.com/api/v1.0/me/contacts/AAMkAGI2THk0AAA=?$select=EmailAddresses,GivenName,Surname

Stichprobenantwort

Status cdoe: 200

{
    "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Contacts(EmailAddresses,GivenName,Surname)/$entity",
    "@odata.id": "https://outlook.office.com/api/v2.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Contacts('AAMkAGI2THk0AAA=')",
    "@odata.etag": "W/\"EQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTIa4\"",
    "Id": "AAMkAGI2THk0AAA=",
    "GivenName": "Garth",
    "Surname": "Fort",
    "EmailAddresses": [
        {
            "Name": "garthf@a830edad9050849NDA1.onmicrosoft.com",
            "Address": "garthf@a830edad9050849NDA1.onmicrosoft.com"
        }
    ]
}

Kontakte und Kontaktordner synchronisieren

Sie können Ihre lokale Kontaktliste mit den Kontakten auf dem Server synchronisieren. Die Kontaktsynchronisation ist ein Vorgang pro Ordner, z.B. können Sie alle Kontakte in Ihrem Stammordner Kontakte synchronisieren. Wenn Sie zusätzliche Kontaktordner haben, müssen Sie jeden Ordner einzeln synchronisieren.

Die Synchronisation unterstützt nur die vollständige Synchronisation; alle Kontakte im angegebenen Ordner werden bei jeder Anfrage zurückgegeben.

Die Synchronisation eines Kontaktordners erfordert in der Regel zwei oder mehr GET-Anforderungen. Sie machen die GET-Anforderung ähnlich wie die Art und Weise, wie Sie Kontakte erhalten, außer dass Sie die folgenden Anforderungs-Header hinzufügen.

  • Sie müssen den Header Präferenz: odata.track-changes in allen Ihren Synchronisierungs-Anforderungen angeben.
  • Sie können den Header Prefer: odata.maxpages={n} angeben, um die maximale Anzahl der in jeder Anfrage zurückgegebenen Kontakte festzulegen.

    Die zweite und nachfolgende GET-Anfrage unterscheiden sich von der ersten GET-Anfrage, indem sie entweder einen deltaToken oder einen skipToken enthalten, der in einer früheren Antwort empfangen wurde.

    Die erste Antwort auf eine Sync-Anforderung liefert immer einen deltaToken. Sie sollten immer eine zweite GET-Anfrage mit deltaToken stellen, um festzustellen, ob zusätzliche Kontakte vorhanden sind. Die zweite Anfrage liefert zusätzliche Kontakte und entweder ein skipToken wenn mehr Kontakte verfügbar sind, oder ein deltaToken wenn der letzte Kontakt gesendet wurde.

Minimal benötigter Bereich: einer der folgenden:

GET https://outlook.office.com/api/beta/me/Contacts
GET https://outlook.office.com/api/beta/me/ContactFolders/{folderName}
Erforderlicher ParameterTypBeschreibung
Header-Parameter
Bevorzugtodata.track-ÄnderungenZeigt an, dass es sich bei der Anforderung um eine Synchronisations-Anforderung handelt.
Bevorzugtodata.maxpagesizeLegt die Anzahl der in jeder Antwort zurückgegebenen Kontakte fest.
URL-Parameter
OrdnernameStringDer Name des zu synchronisierenden Ordners.
odata.deltaLinkZeichenfolgeDas Token, das das letzte Mal anzeigt, dass der Ordner synchronisiert wurde.
odata.skiptokenZeichenfolgeDas Token, das anzeigt, dass mehr Nachrichten heruntergeladen werden müssen.

Antwort-Typ

Eine Sammlung mit den angeforderten Kontakten und einem deltaToken , mit dem Sie zusätzliche Seiten mit Kontaktdaten vom Server anfordern und eine inkrementelle Synchronisation anfordern können. Ist die Anzahl der zurückgegebenen Kontakte größer als der im odata.maxpagesize -Header angegebene Wert, wird die Antwort auf mehreren Seiten zurückgegeben.

Die Antwort wird einen Header Präferenz Angewendet: odata-trackchanges enthalten. Wenn Sie versuchen, eine Ressource zu synchronisieren, die nicht unterstützt wird, wird dieser Header in der Antwort nicht zurückgegeben. Überprüfen Sie diesen Header, bevor Sie die Antwort bearbeiten, um Fehler zu vermeiden.

Hinweis: Standardmäßig enthält die Antwort alle Eigenschaften der angegebenen Kontakte. Verwenden Sie $select , um nur die Eigenschaften anzugeben, die Sie für die beste Leistung benötigen. Die ID-Eigenschaft wird immer zurückgegeben. Verwenden Sie nicht $filter, $orderby, $search oder $top, da diese nicht für die Synchronisation von Kontakten oder Kontaktordnern unterstützt werden. Siehe ODaten-Abfrageparameter für weitere Details.

** Beispiele **

Initiale Anforderung für eine Vollsynchronisation

GET https://outlook.office.com/api/beta/Me/Contacts

Fügen Sie die folgenden Header ein.

  • Bevorzugt: odata.track-changes
  • Bevorzugt: odata.maxpagesize=100

Zweite Anforderung an den Server nach einer vollständigen Synchronisationsanforderung.

https://outlook.office.com/api/beta/Me/Contacts/?%24deltatoken=169ca50467d34d9fb8adb664961b9836

Fügen Sie die folgenden Header ein.

  • Bevorzugt: odata.track-changes
  • Bevorzugt: odata.maxpagesize=100

Zweite Antwort vom Server mit zusätzlichen Seiten verfügbar.

Header

Präferenz-Anwendung: odata.track-changes

Text

@odata.deltaLink=https://outlook.office.com/api/beta/me/Contacts/messages/?%24skiptoken=169ca50467d34d9fb8adb664961b9836

Nutzlast-Nachrichten

Zweite oder nachfolgende Antwort vom Server, wenn alle Kontakte gesendet wurden.

Header

Präferenz-Anwendung: odata.track-changes

Text

@odata.deltaLink=https://outlook.office.com/api/beta/me/Contacts/?%24deltatoken=169ca50467d34d9fb8adb664961b9836

Nutzlast-Nachrichten

Anfrage an den Server, wann zusätzliche Seiten verfügbar sind.

https://outlook.office.com/api/beta/Me/Contacts/?%24skiptoken=169ca50467d34d9fb8adb664961b9836

Fügen Sie die folgenden Header ein.

  • Bevorzugt: odata.track-changes
  • Bevorzugt: odata.maxpagesize=100

Minimal benötigter Bereich: einer der folgenden:

GET https://outlook.office.com/api/v2.0/me/Contacts
GET https://outlook.office.com/api/v2.0/me/ContactFolders/{folderName}
Erforderlicher ParameterTypBeschreibung
Header-Parameter
Bevorzugtodata.track-ÄnderungenZeigt an, dass es sich bei der Anforderung um eine Synchronisations-Anforderung handelt.
Bevorzugtodata.maxpagesizeLegt die Anzahl der in jeder Antwort zurückgegebenen Kontakte fest.
URL-Parameter
OrdnernameStringDer Name des zu synchronisierenden Ordners.
odata.deltaLinkZeichenfolgeDas Token, das das letzte Mal anzeigt, dass der Ordner synchronisiert wurde.
odata.skiptokenZeichenfolgeDas Token, das anzeigt, dass mehr Nachrichten heruntergeladen werden müssen.

Antwort-Typ

Eine Sammlung mit den angeforderten Kontakten und einem deltaToken , mit dem Sie zusätzliche Seiten mit Kontaktdaten vom Server anfordern und eine inkrementelle Synchronisation anfordern können. Ist die Anzahl der zurückgegebenen Kontakte größer als der im odata.maxpagesize -Header angegebene Wert, wird die Antwort auf mehreren Seiten zurückgegeben.

Die Antwort wird einen Header Präferenz Angewendet: odata-trackchanges enthalten. Wenn Sie versuchen, eine Ressource zu synchronisieren, die nicht unterstützt wird, wird dieser Header in der Antwort nicht zurückgegeben. Überprüfen Sie diesen Header, bevor Sie die Antwort bearbeiten, um Fehler zu vermeiden.

Hinweis: Standardmäßig enthält die Antwort alle Eigenschaften der angegebenen Kontakte. Verwenden Sie $select , um nur die Eigenschaften anzugeben, die Sie für die beste Leistung benötigen. Die ID-Eigenschaft wird immer zurückgegeben. Verwenden Sie nicht $filter, $orderby, $search oder $top, da diese nicht für die Synchronisation von Kontakten oder Kontaktordnern unterstützt werden. Siehe ODaten-Abfrageparameter für weitere Details.

** Beispiele **

Initiale Anforderung für eine Vollsynchronisation

GET https://outlook.office.com/api/v2.0/Me/Contacts

Fügen Sie die folgenden Header ein.

  • Bevorzugt: odata.track-changes
  • Bevorzugt: odata.maxpagesize=100

Zweite Anforderung an den Server nach einer vollständigen Synchronisationsanforderung.

https://outlook.office.com/api/v2.0/Me/Contacts/?%24deltatoken=169ca50467d34d9fb8adb664961b9836

Fügen Sie die folgenden Header ein.

  • Bevorzugt: odata.track-changes
  • Bevorzugt: odata.maxpagesize=100

Zweite Antwort vom Server mit zusätzlichen Seiten verfügbar.

Header

Präferenz-Anwendung: odata.track-changes

Text

@odata.deltaLink=https://outlook.office.com/api/v2.0/me/Contacts/messages/?%24skiptoken=169ca50467d34d9fb8adb664961b9836

Nutzlast-Nachrichten

Zweite oder nachfolgende Antwort vom Server, wenn alle Kontakte gesendet wurden.

Header

Präferenz-Anwendung: odata.track-changes

Text

@odata.deltaLink=https://outlook.office.com/api/v2.0/me/Contacts/?%24deltatoken=169ca50467d34d9fb8adb664961b9836

Nutzlast-Nachrichten

Anfrage an den Server, wann zusätzliche Seiten verfügbar sind.

https://outlook.office.com/api/v2.0/Me/Contacts/?%24skiptoken=169ca50467d34d9fb8adb664961b9836

Fügen Sie die folgenden Header ein.

  • Bevorzugt: odata.track-changes
  • Bevorzugt: odata.maxpagesize=100

Minimal benötigter Bereich: einer der folgenden:

GET https://outlook.office.com/api/v1.0/me/Contacts
GET https://outlook.office.com/api/v1.0/me/ContactFolders/{folderName}
Erforderlicher ParameterTypBeschreibung
Header-Parameter
Bevorzugtodata.track-ÄnderungenZeigt an, dass es sich bei der Anforderung um eine Synchronisations-Anforderung handelt.
Bevorzugtodata.maxpagesizeLegt die Anzahl der in jeder Antwort zurückgegebenen Kontakte fest.
URL-Parameter
OrdnernameStringDer Name des zu synchronisierenden Ordners.
odata.deltaLinkZeichenfolgeDas Token, das das letzte Mal anzeigt, dass der Ordner synchronisiert wurde.
odata.skiptokenZeichenfolgeDas Token, das anzeigt, dass mehr Nachrichten heruntergeladen werden müssen.

Antwort-Typ

Eine Sammlung mit den angeforderten Kontakten und einem deltaToken , mit dem Sie zusätzliche Seiten mit Kontaktdaten vom Server anfordern und eine inkrementelle Synchronisation anfordern können. Ist die Anzahl der zurückgegebenen Kontakte größer als der im odata.maxpagesize -Header angegebene Wert, wird die Antwort auf mehreren Seiten zurückgegeben.

Die Antwort wird einen Header Präferenz Angewendet: odata-trackchanges enthalten. Wenn Sie versuchen, eine Ressource zu synchronisieren, die nicht unterstützt wird, wird dieser Header in der Antwort nicht zurückgegeben. Überprüfen Sie diesen Header, bevor Sie die Antwort bearbeiten, um Fehler zu vermeiden.

Hinweis: Standardmäßig enthält die Antwort alle Eigenschaften der angegebenen Kontakte. Verwenden Sie $select , um nur die Eigenschaften anzugeben, die Sie für die beste Leistung benötigen. Die ID-Eigenschaft wird immer zurückgegeben. Verwenden Sie nicht $filter, $orderby, $search oder $top, da diese nicht für die Synchronisation von Kontakten oder Kontaktordnern unterstützt werden. Siehe ODaten-Abfrageparameter für weitere Details.

** Beispiele **

Initiale Anforderung für eine Vollsynchronisation

GET https://outlook.office.com/api/v1.0/Me/Contacts

Fügen Sie die folgenden Header ein.

  • Bevorzugt: odata.track-changes
  • Bevorzugt: odata.maxpagesize=100

Zweite Anforderung an den Server nach einer vollständigen Synchronisationsanforderung.

https://outlook.office.com/api/v1.0/Me/Contacts/?%24deltatoken=169ca50467d34d9fb8adb664961b9836

Fügen Sie die folgenden Header ein.

  • Bevorzugt: odata.track-changes
  • Bevorzugt: odata.maxpagesize=100

Zweite Antwort vom Server mit zusätzlichen Seiten verfügbar.

Header

Präferenz-Anwendung: odata.track-changes

Text

@odata.deltaLink=https://outlook.office.com/api/v1.0/me/Contacts/messages/?%24skiptoken=169ca50467d34d9fb8adb664961b9836

Nutzlast-Nachrichten

Zweite oder nachfolgende Antwort vom Server, wenn alle Kontakte gesendet wurden.

Header

Präferenz-Anwendung: odata.track-changes

Text

@odata.deltaLink=https://outlook.office.com/api/v1.0/me/Contacts/?%24deltatoken=169ca50467d34d9fb8adb664961b9836

Nutzlast-Nachrichten

Anfrage an den Server, wann zusätzliche Seiten verfügbar sind.

https://outlook.office.com/api/v1.0/Me/Contacts/?%24skiptoken=169ca50467d34d9fb8adb664961b9836

Fügen Sie die folgenden Header ein.

  • Bevorzugt: odata.track-changes
  • Bevorzugt: odata.maxpagesize=100

Kontakte erstellen

Erstellen Sie einen Kontakt im angegebenen Ordner Kontakte.

Erstellen Sie einen Kontakt

Erstellen Sie einen Kontakt

Minimal benötigter Bereich: einer der folgenden:

Dient zum Hinzufügen eines Kontakts zum Stammordner der Kontakte oder zum Endpunkt contacts eines anderen Kontaktordners.

POST https://outlook.office.com/api/beta/me/contacts
POST https://outlook.office.com/api/beta/me/contactfolders/{contact_folder_id}/contacts
Erforderlicher ParameterTypBeschreibung
URL-Parameter
contact_folder_idStringDie Kontaktordner-ID, wenn Sie einen Kontakt in einem bestimmten Kontaktordner erstellen.
Text-Parameter
VornameStringDer Vorname des Kontakts.

Geben Sie den Parameter GivenName und alle beschreibbaren Kontakt Eigenschaften im Anfragetext an.

Stichprobenanfrage

POST https://outlook.office.com/api/beta/me/contacts
Content-Type: application/json

{
  "GivenName": "Pavel",
  "Surname": "Bansky",
  "EmailAddresses": [
    {
      "Address": "pavelb@contoso.onmicrosoft.com",
      "Name": "Pavel Bansky"
    }
  ],
  "Phones": [
    {
      "Type": "Business",
      "Number": "+1 732 555 0102"
    }
  ]
}

Stichprobenantwort

Status code: 201

{
  "@odata.context":"https://outlook.office365.com/api/beta/$metadata#Me/Contacts/$entity",
  "@odata.id":"https://outlook.office365.com/api/beta/Users('af183ae6-7efa-41e4-aa87-fe8790598625@9ac5b33f-49cf-45f7-9ef1-b581dce364d8')/Contacts('AAMkADlkAAARKMK7AAA=')",
  "@odata.etag":"W/\"EQAAABYAAADDii8zlkFETIcBiRn8yAbgAAARKpia\"",
  "Id":"AAMkADlkAAARKMK7AAA=",
  "CreatedDateTime":"2016-07-20T23:59:37Z",
  "LastModifiedDateTime":"2016-07-20T23:59:38Z",
  "ChangeKey":"EQAAABYAAADDii8zlkFETIcBiRn8yAbgAAARKpia",
  "Categories":[
  ],
  "ParentFolderId":"AAMkADlk8yAbgAAAAAAEOAAA=",
  "Birthday":null,
  "FileAs":"",
  "DisplayName":"Pavel Bansky",
  "GivenName":"Pavel",
  "Initials":null,
  "MiddleName":null,
  "NickName":null,
  "Surname":"Bansky",
  "Title":null,
  "YomiGivenName":null,
  "YomiSurname":null,
  "YomiCompanyName":null,
  "Generation":null,
  "EmailAddresses":[
    {
      "Name":"Pavel Bansky",
      "Address":"pavelb@contoso.onmicrosoft.com"
    }
  ],
  "Websites":[
  ],
  "ImAddresses":[
  ],
  "JobTitle":null,
  "CompanyName":null,
  "Department":null,
  "OfficeLocation":null,
  "Profession":null,
  "AssistantName":null,
  "Manager":null,
  "Phones":[
    {
      "Type":"Business",
      "Number":"+1 732 555 0102"
    }
  ],
  "PostalAddresses":[
  ],
  "SpouseName":null,
  "PersonalNotes":null,
  "Children":[
  ],
  "Gender":null,
  "IsFavorite":null,
  "Flag":{
    "FlagStatus":"NotFlagged"
  }
}

Antwort-Typ

Der neue Kontakt.

Minimal benötigter Bereich: einer der folgenden:

Dient zum Hinzufügen eines Kontakts zum Stammordner der Kontakte oder zum Endpunkt contacts eines anderen Kontaktordners.

POST https://outlook.office.com/api/v2.0/me/contacts
POST https://outlook.office.com/api/v2.0/me/contactfolders/{contact_folder_id}/contacts
Erforderlicher ParameterTypBeschreibung
URL-Parameter
contact_folder_idStringDie Kontaktordner-ID, wenn Sie einen Kontakt in einem bestimmten Kontaktordner erstellen.
Text-Parameter
VornameStringDer Vorname des Kontakts.

Geben Sie den Parameter GivenName und alle beschreibbaren Kontakt Eigenschaften im Anfragetext an.

Stichprobenanfrage

POST https://outlook.office.com/api/v2.0/me/contacts
Content-Type: application/json

{
  "GivenName": "Pavel",
  "Surname": "Bansky",
  "EmailAddresses": [
    {
      "Address": "pavelb@a830edad9050849NDA1.onmicrosoft.com",
      "Name": "Pavel Bansky"
    }
  ],
  "BusinessPhones": [
    "+1 732 555 0102"
  ]
}

Stichprobenantwort

Status code: 201

{
  "@odata.context": "https://outlook.office.com/api/v2.0/$metadata#Me/Contacts/$entity",
  "@odata.id": "https://outlook.office.com/api/v2.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Contacts('AAMkAGE0M4xqVAAA=')",
  "@odata.etag": "W/\"EQAAABYAAAAmP1Ln1wcHRariNdTMGAO9AAAV41eC\"",
  "Id": "AAMkAGE0M4xqVAAA=",
  "ChangeKey": "EQAAABYAAAAmP1Ln1wcHRariNdTMGAO9AAAV41eC",
  "Categories": [],
  "CreatedDateTime": "2014-10-22T20:38:18Z",
  "LastModifiedDateTime": "2014-10-22T20:38:19Z",
  "ParentFolderId": "AAMkAGE0MAAEOAAA=",
  "Birthday": null,
  "FileAs": "",
  "DisplayName": "Pavel Bansky",
  "GivenName": "Pavel",
  "Initials": null,
  "MiddleName": null,
  "NickName": null,
  "Surname": "Bansky",
  "Title": null,
  "Generation": null,
  "EmailAddresses": [
    {
      "Address": "pavelb@a830edad9050849NDA1.onmicrosoft.com",
      "Name": "Pavel Bansky"
    },
    null,
    null
  ],
  "ImAddresses": [
    null,
    null,
    null
  ],
  "JobTitle": null,
  "CompanyName": null,
  "Department": null,
  "OfficeLocation": null,
  "Profession": null,
  "BusinessHomePage": null,
  "AssistantName": null,
  "Manager": null,
  "HomePhones": [
    null,
    null
  ],
  "BusinessPhones": [
    "+1 732 555 0102",
    null
  ],
  "MobilePhone1": null,
  "HomeAddress": {
    "Street": null,
    "City": null,
    "State": null,
    "CountryOrRegion": null,
    "PostalCode": null
  },
  "BusinessAddress": {
    "Street": null,
    "City": null,
    "State": null,
    "CountryOrRegion": null,
    "PostalCode": null
  },
  "OtherAddress": {
    "Street": null,
    "City": null,
    "State": null,
    "CountryOrRegion": null,
    "PostalCode": null
  },
  "SpouseName": null,
  "PersonalNotes": null,
  "Children": [],
  "YomiSurname": null,
  "YomiGivenName": null,
  "YomiCompanyName": null
}

Antwort-Typ

Der neue Kontakt.

Minimal benötigter Bereich: einer der folgenden:

Dient zum Hinzufügen eines Kontakts zum Stammordner der Kontakte oder zum Endpunkt contacts eines anderen Kontaktordners.

POST https://outlook.office.com/api/v1.0/me/contacts
POST https://outlook.office.com/api/v1.0/me/contactfolders/{contact_folder_id}/contacts
Erforderlicher ParameterTypBeschreibung
URL-Parameter
contact_folder_idStringDie Kontaktordner-ID, wenn Sie einen Kontakt in einem bestimmten Kontaktordner erstellen.
Text-Parameter
VornameStringDer Vorname des Kontakts.

Geben Sie den Parameter GivenName und alle beschreibbaren Kontakt Eigenschaften im Anfragetext an.

Stichprobenanfrage

POST https://outlook.office.com/api/v1.0/me/contacts
Content-Type: application/json
{
  "GivenName": "Pavel",
  "Surname": "Bansky",
  "EmailAddresses": [
    {
      "Address": "pavelb@a830edad9050849NDA1.onmicrosoft.com",
      "Name": "Pavel Bansky"
    }
  ],
  "BusinessPhones": [
    "+1 732 555 0102"
  ]
}

Stichprobenantwort

Statuscode: 201

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Contacts/$entity",
  "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
  "@odata.etag": "W/\"EQAAABYAAAAmP1Ln1wcHRariNdTMGAO9AAAV41eC\"",
  "Id": "AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MABGAAAAAAC_0WfqSjt_SqLtNkuO-bj1BwAmP1Ln1wcHRariNdTMGAO9AAAAAAEOAAAmP1Ln1wcHRariNdTMGAO9AAAV4xqVAAA=",
  "ChangeKey": "EQAAABYAAAAmP1Ln1wcHRariNdTMGAO9AAAV41eC",
  "Categories": [],
  "DateTimeCreated": "2014-10-22T20:38:18Z",
  "DateTimeLastModified": "2014-10-22T20:38:19Z",
  "ParentFolderId": "AAMkAGE0MGM1Y2M5LWEzMmUtNGVlNy05MjRlLTk0YmJjYzVkN2I5MAAuAAAAAAC_0WfqSjt_SqLtNkuO-bj1AQAmP1Ln1wcHRariNdTMGAO9AAAAAAEOAAA=",
  "Birthday": null,
  "FileAs": "",
  "DisplayName": "Pavel Bansky",
  "GivenName": "Pavel",
  "Initials": null,
  "MiddleName": null,
  "NickName": null,
  "Surname": "Bansky",
  "Title": null,
  "Generation": null,
  "EmailAddresses": [
    {
      "Address": "pavelb@a830edad9050849NDA1.onmicrosoft.com",
      "Name": "Pavel Bansky"
    },
    null,
    null
  ],
  "ImAddresses": [
    null,
    null,
    null
  ],
  "JobTitle": null,
  "CompanyName": null,
  "Department": null,
  "OfficeLocation": null,
  "Profession": null,
  "BusinessHomePage": null,
  "AssistantName": null,
  "Manager": null,
  "HomePhones": [
    null,
    null
  ],
  "BusinessPhones": [
    "+1 732 555 0102",
    null
  ],
  "MobilePhone1": null,
  "HomeAddress": {
    "Street": null,
    "City": null,
    "State": null,
    "CountryOrRegion": null,
    "PostalCode": null
  },
  "BusinessAddress": {
    "Street": null,
    "City": null,
    "State": null,
    "CountryOrRegion": null,
    "PostalCode": null
  },
  "OtherAddress": {
    "Street": null,
    "City": null,
    "State": null,
    "CountryOrRegion": null,
    "PostalCode": null
  },
  "YomiSurname": null,
  "YomiGivenName": null,
  "YomiCompanyName": null
}

Antwort-Typ

Der neue Kontakt.


Kontakte aktualisieren

Ändern Sie die Eigenschaften eines Kontakts.

Einen Kontakt aktualisieren

Einen Kontakt aktualisieren

Minimal benötigter Bereich: einer der folgenden:

Geben Sie alle beschreibbaren Kontakt- Eigenschaften im Anfragetext an. Nur die Eigenschaften, die Sie angeben, werden geändert.

PATCH https://outlook.office.com/api/beta/me/contacts/{contact_id}
Erforderlicher ParameterTypBeschreibung
URL-Parameter
contact_idStringDie Kontakt-ID.

Stichprobenanfrage

Im folgenden Beispiel werden die Kontaktadresse und ein Nachverfolgungskennzeichen festgelegt.

Hinweis: Wenn das Flag.FlagStatus auf Flaggedgesetzt ist, kann ein Flag.CompletedDate nicht gesetzt werden.

PATCH https://outlook.office.com/api/beta/me/contacts/AAMkADlkAAARKMK7AAA=
Content-Type: application/json

{
  "PostalAddresses": [
    {
      "Type": "Business",
      "Street": "Some street",
      "City": "Seattle",
      "State": "WA",
      "PostalCode": "98121"
    }
  ],
  "Birthday": "1974-07-22",
  "Flag": {
    "FlagStatus": "Flagged",
       "DueDateTime": {
            "DateTime": "2017-12-22T08:00:00.0000000",
            "TimeZone": "UTC"
        },
        "StartDateTime": {
            "DateTime": "2017-12-18T08:00:00.0000000",
            "TimeZone": "UTC"
        }
    }
}

Stichprobenantwort

Status code: 200

{
  "@odata.context":"https://outlook.office365.com/api/beta/$metadata#Me/Contacts/$entity",
  "@odata.id":"https://outlook.office365.com/api/beta/Users('af183ae6-7efa-41e4-aa87-fe8790598625@9ac5b33f-49cf-45f7-9ef1-b581dce364d8')/Contacts('AAMkADlkAAARKMK7AAA=')",
  "@odata.etag":"W/\"EQAAABYAAADDii8zlkFETIcBiRn8yAbgAAARKpia\"",
  "Id":"AAMkADlkAAARKMK7AAA=",
  "CreatedDateTime":"2016-07-20T23:59:37Z",
  "LastModifiedDateTime":"2016-07-20T23:59:38Z",
  "ChangeKey":"EQAAABYAAADDii8zlkFETIcBiRn8yAbgAAARKpia",
  "Categories":[
  ],
  "ParentFolderId":"AAMkADlk8yAbgAAAAAAEOAAA=",
  "Birthday":"1974-07-22T00:00:00Z",
  "FileAs":"",
  "DisplayName":"Pavel Bansky",
  "GivenName":"Pavel",
  "Initials":null,
  "MiddleName":null,
  "NickName":null,
  "Surname":"Bansky",
  "Title":null,
  "YomiGivenName":null,
  "YomiSurname":null,
  "YomiCompanyName":null,
  "Generation":null,
  "EmailAddresses":[
    {
      "Name":"Pavel Bansky",
      "Address":"pavelb@contoso.onmicrosoft.com"
    }
  ],
  "Websites":[
  ],
  "ImAddresses":[
  ],
  "JobTitle":null,
  "CompanyName":null,
  "Department":null,
  "OfficeLocation":null,
  "Profession":null,
  "AssistantName":null,
  "Manager":null,
  "Phones":[
    {
      "Type":"Business",
      "Number":"+1 732 555 0102"
    }
  ],
  "PostalAddresses":[
    {
      "Type": "Business",
      "Street": "Some street",
      "City": "Seattle",
      "State": "WA",
      "PostalCode": "98121"
    }
  ],
  "SpouseName":null,
  "PersonalNotes":null,
  "Children":[
  ],
  "Gender":null,
  "IsFavorite":null,
  "Flag": {
        "FlagStatus": "Flagged",
        "DueDateTime": {
            "DateTime": "2017-12-22T08:00:00.0000000",
            "TimeZone": "UTC"
        },
        "StartDateTime": {
            "DateTime": "2017-12-18T08:00:00.0000000",
            "TimeZone": "UTC"
        }
  }
}

Stichprobenanfrage

Das folgende Beispiel setzt einen zuvor gekennzeichneten Kontakt auf Complete.

PATCH https://outlook.office.com/api/beta/me/contacts/AAMkADlkAAARKMK7AAA=
Content-Type: application/json

{
  "Flag": {
    "CompletedDateTime":{
      "DateTime": "2018-02-05T18:00:00",
      "TimeZone": "Pacific Standard Time"
    },
    "FlagStatus": "Complete"
  }
}

Stichprobenantwort

Status code: 200

{
  "@odata.context":"https://outlook.office365.com/api/beta/$metadata#Me/Contacts/$entity",
  "@odata.id":"https://outlook.office365.com/api/beta/Users('af183ae6-7efa-41e4-aa87-fe8790598625@9ac5b33f-49cf-45f7-9ef1-b581dce364d8')/Contacts('AAMkADlkAAARKMK7AAA=')",
  "@odata.etag":"W/\"EQAAABYAAADDii8zlkFETIcBiRn8yAbgAAARKpia\"",
  "Id":"AAMkADlkAAARKMK7AAA=",
  "CreatedDateTime":"2016-07-20T23:59:37Z",
  "LastModifiedDateTime":"2016-07-20T23:59:38Z",
  "ChangeKey":"EQAAABYAAABmngqUDhbeSLkRkXbBznTvAAEw/xwn",
  "Categories":[
  ],
  "ParentFolderId":"AAMkADlk8yAbgAAAAAAEOAAA=",
  "Birthday":"1974-07-22T00:00:00Z",
  "FileAs":"",
  "DisplayName":"Pavel Bansky",
  "GivenName":"Pavel",
  "Initials":null,
  "MiddleName":null,
  "NickName":null,
  "Surname":"Bansky",
  "Title":null,
  "YomiGivenName":null,
  "YomiSurname":null,
  "YomiCompanyName":null,
  "Generation":null,
  "EmailAddresses":[
    {
      "Name":"Pavel Bansky",
      "Address":"pavelb@contoso.onmicrosoft.com"
    }
  ],
  "Websites":[
  ],
  "ImAddresses":[
  ],
  "JobTitle":null,
  "CompanyName":null,
  "Department":null,
  "OfficeLocation":null,
  "Profession":null,
  "AssistantName":null,
  "Manager":null,
  "Phones":[
    {
      "Type":"Business",
      "Number":"+1 732 555 0102"
    }
  ],
  "PostalAddresses":[
    {
      "Type": "Business",
      "Street": "Some street",
      "City": "Seattle",
      "State": "WA",
      "PostalCode": "98121"
    }
  ],
  "SpouseName":null,
  "PersonalNotes":null,
  "Children":[
  ],
  "Gender":null,
  "IsFavorite":null,
  "Flag": {
    "FlagStatus": "Complete",
    "CompletedDateTime": {
        "DateTime": "2018-02-06T00:00:00.0000000",
        "TimeZone": "UTC"
    }
  }
}

Antwort-Typ

Der aktualisierte Kontakt.

Minimal benötigter Bereich: einer der folgenden:

Geben Sie alle beschreibbaren Kontakt- Eigenschaften im Anfragetext an. Nur die Eigenschaften, die Sie angeben, werden geändert.

PATCH https://outlook.office.com/api/v2.0/me/contacts/{contact_id}
Erforderlicher ParameterTypBeschreibung
URL-Parameter
contact_idStringDie Kontakt-ID.

Stichprobenanfrage

PATCH https://outlook.office.com/api/v2.0/me/contacts/AAMkAGI2THkzAAA=
Content-Type: application/json

{
  "HomeAddress": {
    "Street": "Some street",
    "City": "Seattle",
    "State": "WA",
    "PostalCode": "98121"
  },
  "Birthday": "1974-07-22"
}

Stichprobenantwort

Status code: 200

{
  "@odata.context": "https://outlook.office.com/api/v2.0/$metadata#Me/Contacts/$entity",
  "@odata.id": "https://outlook.office.com/api/v2.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Contacts('AAMkAGI2THkzAAA=')",
  "@odata.etag": "W/\"EQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTIa3\"",
  "Id": "AAMkAGI2THkzAAA=",
  "ChangeKey": "EQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTIa3",
  "Categories": [],
  "CreatedDateTime": "2014-10-19T23:08:18Z",
  "LastModifiedDateTime": "2014-10-19T23:08:18Z",
  "ParentFolderId": "AAMkAGI2AAEOAAA=",
  "Birthday": "1974-07-22T00:00:00Z",
  "FileAs": "Schorr, Janet",
  "DisplayName": "Janet Schorr",
  "GivenName": "Janet",
  "Initials": null,
  "MiddleName": null,
  "NickName": null,
  "Surname": "Schorr",
  "Title": null,
  "Generation": null,
  "EmailAddresses": [
    {
      "Address": "janets@a830edad9050849NDA1.onmicrosoft.com",
      "Name": "janets@a830edad9050849NDA1.onmicrosoft.com"
    },
    null,
    null
  ],
  "ImAddresses": [
    "sip:janets@a830edad9050849nda1.onmicrosoft.com",
    null,
    null
  ],
  "JobTitle": "Product Marketing Manager",
  "CompanyName": null,
  "Department": "Sales & Marketing",
  "OfficeLocation": "18/2111",
  "Profession": null,
  "BusinessHomePage": null,
  "AssistantName": null,
  "Manager": null,
  "HomePhones": [
    null,
    null
  ],
  "BusinessPhones": [
    "+1 425 555 0109",
    null
  ],
  "MobilePhone1": null,
  "HomeAddress": {
    "Street": "Some street",
    "City": "Seattle",
    "State": "WA",
    "CountryOrRegion": null,
    "PostalCode": "98121"
  },
  "BusinessAddress": {
    "Street": null,
    "City": null,
    "State": null,
    "CountryOrRegion": null,
    "PostalCode": null
  },
  "OtherAddress": {
    "Street": null,
    "City": null,
    "State": null,
    "CountryOrRegion": null,
    "PostalCode": null
  },
  "SpouseName": null,
  "PersonalNotes": null,
  "Children": [],
  "YomiSurname": null,
  "YomiGivenName": null,
  "YomiCompanyName": null
}

Antwort-Typ

Der aktualisierte Kontakt.

Minimal benötigter Bereich: einer der folgenden:

Geben Sie alle beschreibbaren Kontakt- Eigenschaften im Anfragetext an. Nur die Eigenschaften, die Sie angeben, werden geändert.

PATCH https://outlook.office.com/api/v1.0/me/contacts/{contact_id}
Erforderlicher ParameterTypBeschreibung
URL-Parameter
contact_idStringDie Kontakt-ID.

Stichprobenanfrage

PATCH https://outlook.office.com/api/v1.0/me/contacts/AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEOAACd9nJ-tVysQos2hTfspaWRAAADTHkzAAA=
Content-Type: application/json
{
  "HomeAddress": {
    "Street": "Some street",
    "City": "Seattle",
    "State": "WA",
    "PostalCode": "98121"
  },
  "Birthday": "1974-07-22"
}

Stichprobenantwort

Statuscode: 200

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/Contacts/$entity",
  "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
  "@odata.etag": "W/\"EQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTIa3\"",
  "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQBGAAAAAADUuTJK1K9aTpCdqXop_4NaBwCd9nJ-tVysQos2hTfspaWRAAAAAAEOAACd9nJ-tVysQos2hTfspaWRAAADTHkzAAA=",
  "ChangeKey": "EQAAABYAAACd9nJ/tVysQos2hTfspaWRAAADTIa3",
  "Categories": [],
  "DateTimeCreated": "2014-10-19T23:08:18Z",
  "DateTimeLastModified": "2014-10-19T23:08:18Z",
  "ParentFolderId": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEOAAA=",
  "Birthday": "1974-07-22T00:00:00Z",
  "FileAs": "Schorr, Janet",
  "DisplayName": "Janet Schorr",
  "GivenName": "Janet",
  "Initials": null,
  "MiddleName": null,
  "NickName": null,
  "Surname": "Schorr",
  "Title": null,
  "Generation": null,
  "EmailAddresses": [
    {
      "Address": "janets@a830edad9050849NDA1.onmicrosoft.com",
      "Name": "janets@a830edad9050849NDA1.onmicrosoft.com"
    },
    null,
    null
  ],
  "ImAddresses": [
    "sip:janets@a830edad9050849nda1.onmicrosoft.com",
    null,
    null
  ],
  "JobTitle": "Product Marketing Manager",
  "CompanyName": null,
  "Department": "Sales & Marketing",
  "OfficeLocation": "18/2111",
  "Profession": null,
  "BusinessHomePage": null,
  "AssistantName": null,
  "Manager": null,
  "HomePhones": [
    null,
    null
  ],
  "BusinessPhones": [
    "+1 425 555 0109",
    null
  ],
  "MobilePhone1": null,
  "HomeAddress": {
    "Street": "Some street",
    "City": "Seattle",
    "State": "WA",
    "CountryOrRegion": null,
    "PostalCode": "98121"
  },
  "BusinessAddress": {
    "Street": null,
    "City": null,
    "State": null,
    "CountryOrRegion": null,
    "PostalCode": null
  },
  "OtherAddress": {
    "Street": null,
    "City": null,
    "State": null,
    "CountryOrRegion": null,
    "PostalCode": null
  },
  "YomiSurname": null,
  "YomiGivenName": null,
  "YomiCompanyName": null
}

Antwort-Typ

Der aktualisierte Kontakt.


Kontakte löschen

Einen Kontakt löschen. Gelöschte Inhalte können möglicherweise nicht wiederhergestellt werden. Weitere Informationen finden Sie unter Einträge löschen.

Einen Kontakt löschen

Einen Kontakt löschen

Minimal benötigter Bereich: einer der folgenden:

DELETE https://outlook.office.com/api/beta/me/contacts/{contact_id}
Erforderlicher ParameterTypBeschreibung
URL-Parameter
contact_idStringDie Kontakt-ID.

Stichprobenanfrage

DELETE https://outlook.office.com/api/beta/me/contacts/AAMkAGE0Myy2hAAA=

Stichprobenantwort

Status code: 204

Minimal benötigter Bereich: einer der folgenden:

DELETE https://outlook.office.com/api/v2.0/me/contacts/{contact_id}
Erforderlicher ParameterTypBeschreibung
URL-Parameter
contact_idStringDie Kontakt-ID.

Stichprobenanfrage

DELETE https://outlook.office.com/api/v2.0/me/contacts/AAMkAGE0Myy2hAAA=

Stichprobenantwort

Status code: 204

Minimal benötigter Bereich: einer der folgenden:

DELETE https://outlook.office.com/api/v1.0/me/contacts/{contact_id}
Erforderlicher ParameterTypBeschreibung
URL-Parameter
contact_idStringDie Kontakt-ID.

Stichprobenanfrage

DELETE https://outlook.office.com/api/v1.0/me/contacts/AAMkAGE0Myy2hAAA=

Stichprobenantwort

Status code: 204

Kontaktordner abrufen

Sie können eine Sammlung von Kontaktordnern oder einen Kontaktordner erhalten.

Eine Kontaktordner-Sammlung erhalten | Kontaktordner erhalten

Eine Kontaktordner-Sammlung erhalten

Minimal benötigter Bereich: einer der folgenden:

Holen Sie sich alle Kontaktordner im Postfach des angemeldeten Benutzers (.../me/contactfolders) oder unter dem angegebenen Kontaktordner.

GET https://outlook.office.com/api/beta/me/contactfolders
GET https://outlook.office.com/api/beta/me/contactfolders/{contact_folder_id}/childfolders

Hinweis: Siehe OData Abfrageparameter zum Filtern, Sortieren und Paging von Parametern.

Erforderlicher ParameterTypBeschreibung
URL-Parameter
contact_folder_idStringDie Kontaktordner-ID, wenn Sie Kontaktordner aus einem bestimmten Kontaktordner erhalten.

Stichprobenanfrage

GET https://outlook.office.com/api/beta/me/contactfolders

Stichprobenantwort

Statuscode: 200

{
    "@odata.context": "https://outlook.office.com/api/beta/$metadata#Me/ContactFolders",
    "value": [
        {
            "@odata.id": "https://outlook.office.com/api/beta/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/ContactFolders('AAMkAGI2TKI5AAA=')",
            "Id": "AAMkAGI2TKI5AAA=",
            "ParentFolderId": "AAMkAGI2AAEOAAA=",
            "DisplayName": "Finance",
            "WellKnownName": null
        },
        {
            "@odata.id": "https://outlook.office.com/api/beta/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/ContactFolders('AQMkADA1MTgAAAA==')",
            "Id": "AQMkADA1MTgAAAA==",
            "ParentFolderId": "AAMkAGI2AAEOAAA=",
            "DisplayName": "Contacts",
            "WellKnownName": "contacts"
        }
    ]
}

Antwort-Typ

Die gewünschte Kontakt-Ordner Sammlung.


Einen Kontaktordner erhalten

Minimal benötigter Bereich: einer der folgenden:

Dient zum Abrufen eines Kontaktordners anhand der Kontaktordner-ID.

GET https://outlook.office.com/api/beta/me/contactfolders/{contact_folder_id}

Hinweis: Siehe OData Abfrageparameter zum Filtern, Sortieren und Paging von Parametern.

Erforderlicher ParameterTypBeschreibung
URL-Parameter
contact_folder_idStringDie Kontaktordner-ID.

Stichprobenanfrage

GET https://outlook.office.com/api/beta/me/contactfolders/AAMkAGI2TKI5AAA=

Stichprobenantwort

Statuscode: 200

{
    "@odata.context": "https://outlook.office.com/api/beta/$metadata#Me/ContactFolders/$entity",
    "@odata.id": "https://outlook.office.com/api/beta/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/ContactFolders('AAMkAGI2TKI5AAA=')",
    "Id": "AAMkAGI2TKI5AAA=",
    "ParentFolderId": "AAMkAGI2AAEOAAA=",
    "DisplayName": "Finance",
    "WellKnownName": null
}

Antwort-Typ

Der gewünschte Kontakt-Ordner.

Eine Kontaktordner-Sammlung erhalten

Minimal benötigter Bereich: einer der folgenden:

Holen Sie sich die Kontaktordner-Sammlung unter dem Standardordner Kontakte des angemeldeten Benutzers (.../me/contactfolders) oder unter dem angegebenen Kontaktordner.

GET https://outlook.office.com/api/v2.0/me/contactfolders
GET https://outlook.office.com/api/v2.0/me/contactfolders/{contact_folder_id}/childfolders

Hinweis: Siehe OData Abfrageparameter zum Filtern, Sortieren und Paging von Parametern.

Erforderlicher ParameterTypBeschreibung
URL-Parameter
contact_folder_idStringDie Kontaktordner-ID, wenn Sie Kontaktordner aus einem bestimmten Kontaktordner erhalten.

Stichprobenanfrage

GET https://outlook.office.com/api/v2.0/me/contactfolders

Stichprobenantwort

Statuscode: 200

{
    "@odata.context": "https://outlook.office.com/api/v2.0/$metadata#Me/ContactFolders",
    "value": [
        {
            "@odata.id": "https://outlook.office.com/api/v2.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/ContactFolders('AAMkAGI2TKI5AAA=')",
            "Id": "AAMkAGI2TKI5AAA=",
            "ParentFolderId": "AAMkAGI2AAEOAAA=",
            "DisplayName": "Finance"
        }
    ]
}

Antwort-Typ

Die gewünschte Kontakt-Ordner Sammlung.


Einen Kontaktordner erhalten

Minimal benötigter Bereich: einer der folgenden:

Dient zum Abrufen eines Kontaktordners anhand der Kontaktordner-ID.

GET https://outlook.office.com/api/v2.0/me/contactfolders/{contact_folder_id}

Hinweis: Siehe OData Abfrageparameter zum Filtern, Sortieren und Paging von Parametern.

Erforderlicher ParameterTypBeschreibung
URL-Parameter
contact_folder_idStringDie Kontaktordner-ID.

Stichprobenanfrage

GET https://outlook.office.com/api/v2.0/me/contactfolders/AAMkAGI2TKI5AAA=

Stichprobenantwort

Status code: 200

{
    "@odata.context": "https://outlook.office.com/api/v2.0/$metadata#Me/ContactFolders/$entity",
    "@odata.id": "https://outlook.office.com/api/v2.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/ContactFolders('AAMkAGI2TKI5AAA=')",
    "Id": "AAMkAGI2TKI5AAA=",
    "ParentFolderId": "AAMkAGI2AAEOAAA=",
    "DisplayName": "Finance"
}

Antwort-Typ

Der gewünschte Kontakt-Ordner.

Eine Kontaktordner-Sammlung erhalten

Minimal benötigter Bereich: einer der folgenden:

Holen Sie sich die Kontaktordner-Sammlung unter dem Standardordner Kontakte des angemeldeten Benutzers (.../me/contactfolders) oder unter dem angegebenen Kontaktordner.

GET https://outlook.office.com/api/v1.0/me/contactfolders
GET https://outlook.office.com/api/v1.0/me/contactfolders/{contact_folder_id}/childfolders

Hinweis: Siehe OData Abfrageparameter zum Filtern, Sortieren und Paging von Parametern.

Erforderlicher ParameterTypBeschreibung
URL-Parameter
contact_folder_idStringDie Kontaktordner-ID, wenn Sie Kontaktordner aus einem bestimmten Kontaktordner erhalten.

Stichprobenanfrage

GET https://outlook.office.com/api/v1.0/me/contactfolders

Stichprobenantwort

Statuscode: 200

{
  "@odata.context": "https://outlook.office.com/api/v1.0/$metadata#Me/ContactFolders",
  "value": [
    {
      "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
      "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAADTKI5AAA=",
      "ParentFolderId": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEOAAA=",
      "DisplayName": "Finance"
    }
  ]
}

Antwort-Typ

Die gewünschte Kontakt-Ordner Sammlung.


Einen Kontaktordner erhalten

Minimal benötigter Bereich: einer der folgenden:

Dient zum Abrufen eines Kontaktordners anhand der Kontaktordner-ID.

GET https://outlook.office.com/api/v1.0/me/contactfolders/{contact_folder_id}

Hinweis: Siehe OData Abfrageparameter zum Filtern, Sortieren und Paging von Parametern.

Erforderlicher ParameterTypBeschreibung
URL-Parameter
contact_folder_idStringDie Kontaktordner-ID.

Stichprobenanfrage

GET https://outlook.office.com/api/v1.0/me/contactfolders/AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAADTKI5AAA=

Stichprobenantwort

Statuscode: 200

{
  "@odata.id": "https://outlook.office.com/api/v1.0/Users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/Events('AAMkAGE4v1RAAA=')",
  "Id": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAADTKI5AAA=",
  "ParentFolderId": "AAMkAGI2NGVhZTVlLTI1OGMtNDI4My1iZmE5LTA5OGJiZGEzMTc0YQAuAAAAAADUuTJK1K9aTpCdqXop_4NaAQCd9nJ-tVysQos2hTfspaWRAAAAAAEOAAA=",
  "DisplayName": "Finance"
}

Antwort-Typ

Der gewünschte Kontakt-Ordner.


Kontaktfoto und Metadaten erhalten

Kontaktfoto erhalten | Kontaktfoto-Metadaten erhalten

Kontaktfoto erhalten

Minimal benötigter Bereich: einer der folgenden:

Erhalten Sie das Foto des angegebenen Kontaktes des angemeldeten Benutzers.

GET https://outlook.office.com/api/beta/me/contacts('{contact_id}')/photo/$value
Erforderlicher ParameterTypBeschreibung
URL-Parameter
contact_idStringDie ID, die den jeweiligen Kontakt des angemeldeten Benutzers angibt.

Stichprobenanfrage

GET https://outlook.office.com/api/beta/me/contacts('AAMkAGE1M2IyNGNm===')/photo/$value
Content-Type: image/jpg

Antwortdaten

Enthält die binären Daten des angeforderten Fotos. Der HTTP-Antwortcode ist 200.

Die Operation gibt HTTP 404 zurück, wenn der Kontakt noch kein Kontaktfoto auf Exchange Online hat.


Kontaktfoto-Metadaten erhalten

Minimal benötigter Bereich: einer der folgenden:

Erhalten Sie die Metadaten eines Kontaktfotos, die den Inhaltstyp, die Breite und die Höhe in Pixeln enthalten.

GET https://outlook.office.com/api/beta/me/contacts('{contact_id}')/photo
Erforderlicher ParameterTypBeschreibung
URL-Parameter
contact_idStringDie ID, die den jeweiligen Kontakt des angemeldeten Benutzers angibt.

Stichprobenanfrage

GET https://outlook.office.com/api/beta/me/contacts('AAMkAGE1M2IyNGNm')/photo

Daten der Stichprobenantwort

Eine erfolgreiche Anfrage gibt HTTP 200 zurück.

{
    "@odata.context": "https://outlook.office.com/api/beta/$metadata#Me/Contacts('AAMkAGE1M2IyNGNm')/photo/$entity",
    "@odata.id": "https://outlook.office.com/api/beta/Users('ddfcd489-b826-40d7-b48b-57002df800e5@1717622f-49d1-4d0c-9d74-709fad664b77')/contacts('AAMkAGE1M2IyNGNm')/photo",
    "@odata.readLink": "https://outlook.office.com/api/beta/Users('ddfcd489-b826-40d7-b48b-57002df800e5@1717622f-49d1-4d0c-9d74-709fad664b77')/contacts('AAMkAGE1M2IyNGNm')/photo",
    "@odata.mediaContentType": "image/jpeg",
    "Id": "103X77",
    "Width": 103,
    "Height": 77
}

Kontaktfoto erhalten | Kontaktfoto-Metadaten erhalten

Kontaktfoto erhalten

Minimal benötigter Bereich: einer der folgenden:

Erhalten Sie das Foto des angegebenen Kontaktes des angemeldeten Benutzers.

GET https://outlook.office.com/api/v2.0/me/contacts('{contact_id}')/photo/$value
Erforderlicher ParameterTypBeschreibung
URL-Parameter
contact_idStringDie ID, die den jeweiligen Kontakt des angemeldeten Benutzers angibt.

Stichprobenanfrage

GET https://outlook.office.com/api/v2.0/me/contacts('AAMkAGE1M2IyNGNm===')/photo/$value
Content-Type: image/jpg

Antwortdaten

Enthält die binären Daten des angeforderten Fotos. Der HTTP-Antwortcode ist 200.

Die Operation gibt HTTP 404 zurück, wenn der Kontakt noch kein Kontaktfoto auf Exchange Online hat.


Kontaktfoto-Metadaten erhalten

Minimal benötigter Bereich: einer der folgenden:

Erhalten Sie die Metadaten eines Kontaktfotos, die den Inhaltstyp, die Breite und die Höhe in Pixeln enthalten.

GET https://outlook.office.com/api/v2.0/me/contacts('{contact_id}')/photo
Erforderlicher ParameterTypBeschreibung
URL-Parameter
contact_idStringDie ID, die den jeweiligen Kontakt des angemeldeten Benutzers angibt.

Stichprobenanfrage

GET https://outlook.office.com/api/v2.0/me/contacts('AAMkAGE1M2IyNGNm')/photo

Daten der Stichprobenantwort

Eine erfolgreiche Anfrage gibt HTTP 200 zurück.

{
    "@odata.context": "https://outlook.office.com/api/v2.0/$metadata#Me/Contacts('AAMkAGE1M2IyNGNm')/photo/$entity",
    "@odata.id": "https://outlook.office.com/api/v2.0/Users('ddfcd489-b826-40d7-b48b-57002df800e5@1717622f-49d1-4d0c-9d74-709fad664b77')/contacts('AAMkAGE1M2IyNGNm')/photo",
    "@odata.readLink": "https://outlook.office.com/api/v2.0/Users('ddfcd489-b826-40d7-b48b-57002df800e5@1717622f-49d1-4d0c-9d74-709fad664b77')/contacts('AAMkAGE1M2IyNGNm')/photo",
    "@odata.mediaContentType": "image/jpeg",
    "Id": "103X77",
    "Width": 103,
    "Height": 77
}

Dieses Feature ist in v2.0 und beta verfügbar. Um mehr zu erfahren, verwenden Sie das Steuerelement in der oberen rechten Ecke des Artikels und wählen Sie eine dieser Versionen aus.


Ein Kontaktfoto festlegen

Minimal benötigter Bereich: einer der folgenden:

Weisen Sie dem angegebenen Kontakt des angemeldeten Benutzers ein Foto zu. Das Foto sollte binär sein. Es ersetzt jedes vorhandene Foto für diesen
Kontakt.

Verwenden Sie für diesen Vorgang nur PUT in der Betaversion.

PUT https://outlook.office.com/api/beta/me/contacts('{contact_id}')/photo/$value
Erforderlicher ParameterTypBeschreibung
URL-Parameter
contact_idStringDie ID, die den jeweiligen Kontakt des angemeldeten Benutzers angibt.

Stichprobenanfrage

PUT https://outlook.office.com/api/beta/me/contacts('AAMkAGE1M2IyNGNm===')/photo/$value
Content-Type: image/jpeg

Fügen Sie die Binärdaten des Fotos in den Text der Anfrage ein.

Antwortdaten

Eine erfolgreiche Anfrage gibt HTTP 200 zurück.

Minimal benötigter Bereich: einer der folgenden:

Weisen Sie dem angegebenen Kontakt des angemeldeten Benutzers ein Foto zu. Das Foto sollte binär sein. Es ersetzt jedes vorhandene Foto für diesen
Kontakt.

In Version 2.0 können Sie PATCH oder PUT für diesen Vorgang verwenden.

PATCH https://outlook.office.com/api/v2.0/me/contacts('{contact_id}')/photo/$value

PUT https://outlook.office.com/api/v2.0/me/contacts('{contact_id}')/photo/$value
Erforderlicher ParameterTypBeschreibung
URL-Parameter
contact_idStringDie ID, die den jeweiligen Kontakt des angemeldeten Benutzers angibt.

Stichprobenanfrage

PUT https://outlook.office.com/api/v2.0/me/contacts('AAMkAGE1M2IyNGNm===')/photo/$value
Content-Type: image/jpeg

Fügen Sie die Binärdaten des Fotos in den Text der Anfrage ein.

Antwortdaten

Eine erfolgreiche Anfrage gibt HTTP 200 zurück.

Dieses Feature ist in v2.0 und beta verfügbar. Um mehr zu erfahren, verwenden Sie das Steuerelement in der oberen rechten Ecke des Artikels und wählen Sie eine dieser Versionen aus.


Nächste Schritte

Egal, ob Sie bereit sind, eine App zu erstellen oder einfach nur mehr darüber erfahren möchten, wir haben alles im Griff.

Oder erfahren Sie mehr über die Verwendung der Office 365-Plattform:

© 2018 Microsoft