Erstellen von Adressen
Namespace: microsoft.graph
Erstellen Sie ein neues itemAddress-Objekt im Profil eines Benutzers.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Berechtigungen
Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
---|---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | User.ReadWrite | User.ReadWrite.All |
Delegiert (persönliches Microsoft-Konto) | User.ReadWrite | Nicht verfügbar. |
Anwendung | Nicht unterstützt | Nicht unterstützt |
HTTP-Anforderung
POST /me/profile/addresses
POST /users/{id | userPrincipalName}/profile/addresses
Anforderungsheader
Name | Beschreibung |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Content-Type | application/json. Erforderlich. |
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung des itemAddress-Objekts an.
Die folgende Tabelle zeigt die Eigenschaften, die beim Erstellen eines neuen itemAddress-Objekts im Profil eines Benutzers festgelegt werden können.
Eigenschaft | Typ | Beschreibung |
---|---|---|
allowedAudiences | String | Die Zielgruppen, die die in der Entität enthaltenen Werte sehen können. Geerbt von itemFacet. Mögliche Werte: me , family , contacts , groupMembers , organization , federatedOrganizations , everyone , unknownFutureValue . |
Detail | physicalAddress | Details zur Adresse selbst. |
displayName | String | Anzeigename, den der Benutzer dieser Adresse zugewiesen hat. |
geoCoordinates | geoCoordinates | Die geokoordinaten der Adresse. |
Ableitung | inferenceData | Enthält Rückschlussdetails, wenn die Entität von der erstellenden oder ändernden Anwendung abgeleitet wird. Geerbt von itemFacet. |
source | personDataSource | Woher die Werte stammen, wenn sie von einem anderen Dienst synchronisiert werden. Geerbt von itemFacet. |
Antwort
Wenn die Methode erfolgreich verläuft, werden der 201 Created
Antwortcode und ein itemAddress-Objekt im Antworttext zurückgegeben.
Beispiele
POST https://graph.microsoft.com/beta/me/profile/addresses
Content-Type: application/json
{
"displayName": "Home",
"detail": {
"type": "home",
"postOfficeBox": null,
"street": "221B Baker Street",
"city": "London",
"state": null,
"countryOrRegion": "United Kingdom",
"postalCode": "E14 3TD"
}
}
Antwort
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 201 Created
Content-Type: application/json
{
"id": "0fb4c1e3-c1e3-0fb4-e3c1-b40fe3c1b40f",
"allowedAudiences": "organization",
"inference": null,
"createdDateTime": "2020-07-06T06:34:12.2294868Z",
"createdBy": {
"application": null,
"device": null,
"user": {
"displayName": "Innocenty Popov",
"id": "db789417-4ccb-41d1-a0a9-47b01a09ea49"
}
},
"lastModifiedDateTime": "2020-07-06T06:34:12.2294868Z",
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"displayName": "Innocenty Popov",
"id": "db789417-4ccb-41d1-a0a9-47b01a09ea49"
}
},
"source": null,
"displayName": "Home",
"detail": {
"type": "home",
"postOfficeBox": null,
"street": "221B Baker Street",
"city": "London",
"state": null,
"countryOrRegion": "United Kingdom",
"postalCode": "E14 3TD"
},
"geoCoordinates": null
}
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für