Abrufen von Outlook-Kontakten in einem freigegebenen Ordner

  • Artikel

In Outlook können Kunden Ordner für andere freigeben und den Zugriff zum Lesen, Erstellen oder Ändern auf einzelne Kontaktordner erteilen. Outlook ermöglicht es einem Kunden auch, einen anderen Benutzer zu delegieren, im Namen des Kunden zu handeln und auf bestimmte Ordner oder das gesamte Postfach des Kunden zuzugreifen. Dies wird in Outlook auch als Delegierung bezeichnet.

Programmgesteuert unterstützt Microsoft Graph das Abrufen von Kontakten in Kontaktordnern, die andere Benutzer freigegeben haben, sowie das Abrufen der freigegebenen Ordner selbst. Die Unterstützung gilt auch für Ordner in einem delegierten Postfach.

Beispielsweise hat Adrian für John einen benutzerdefinierten Kontaktordner freigegeben und John Lesezugriff erteilt. Wenn John sich bei Ihrer App angemeldet und delegierte Berechtigungen (Contacts.Read.Shared oder Contacts.ReadWrite.Shared) bereitgestellt hat, kann Ihre App auf den benutzerdefinierten Kontaktordner von Garth und die Kontakte in diesem Ordner zugreifen. Weitere Informationen finden Sie in den folgenden Abschnitten.

Hinweis

Mit den Freigabeberechtigungen (Contacts.Read.Shared oder Contacts.ReadWrite.Shared) können Sie Kontakte in einem freigegebenen oder delegierten Ordner lesen oder schreiben. Das Abonnieren von Änderungsbenachrichtigungen wird für Elemente in solchen Ordnern nicht unterstützt. Verwenden Sie zum Einrichten von Änderungsbenachrichtigungsabonnements für Kontakte in einem freigegebenen, delegierten oder einem Kontaktordner eines anderen Benutzers im Mandanten die Berechtigung „Contacts.Read“.

Abrufen eines Kontakts im freigegebenen Ordner

Sie können einen bestimmten Kontakt im benutzerdefinierten Kontaktordner abrufen, den Adrian für John freigegeben hat:

GET users/{Garth-userId | Garth-userPrincipalName}/contactFolders/{folder-id}/contacts/{id}

Nach erfolgreichem Abschluss erhalten Sie "HTTP 200 OK" und die contact-Instanz mit der ID {id} aus Adrians freigegebenem Kontaktordner.

Abrufen aller Kontakte im freigegebenen Ordner

Abrufen aller Kontakte in Adrians freigegebenem Kontaktordner:

GET users/{Garth-userId | Garth-userPrincipalName}/contactFolders/{folder-id}/contacts

Nach erfolgreichem Abschluss erhalten Sie "HTTP 200 OK" und eine Sammlung der contact-Instanzen in Adrians freigegebenem Kontaktordner.

Abrufen des freigegebenen Ordners

Abrufen des Kontaktordners, den Adrian für John freigegeben hat.

GET users/{Garth-userId | Garth-userPrincipalName}/contactFolders/{folder-id}

Nach erfolgreichem Abschluss erhalten Sie "HTTP 200 OK" und eine contactFolder-Instanz, die Adrians freigegebenen Kontaktordner darstellt.

Die gleichen GET-Funktionen würden ebenfalls gelten, wenn Adrian sein gesamtes Postfach an John delegiert hätte.

Wenn Garth den Kontaktordner weder für John freigegeben noch sein Postfach an John delegiert hat, gibt die Angabe von Garths Benutzer-ID oder Benutzerprinzipalnamen in diesen GET-Vorgängen einen Fehler zurück.

Nächste Schritte

Weitere Informationen: