Crear direcciones

Espacio de nombres: microsoft.graph

Cree un nuevo objeto itemAddress en el perfil de un usuario.

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado por 21Vianet

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) User.ReadWrite AgentIdUser.ReadWrite.All, AgentIdUser.ReadWrite.IdentityParentedBy, User.ReadWrite.All
Delegado (cuenta personal de Microsoft) User.ReadWrite No disponible.
Aplicación No admitida. No admitida.

Solicitud HTTP

POST /me/profile/addresses
POST /users/{id | userPrincipalName}/profile/addresses

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización.
Content-Type application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON del objeto itemAddress .

En la tabla siguiente se muestran las propiedades que se pueden establecer al crear un nuevo objeto itemAddress en el perfil de un usuario.

Propiedad Tipo Descripción
allowedAudiences Cadena Las audiencias que pueden ver los valores contenidos dentro de la entidad. Heredado de itemFacet. Los valores posibles son: me, family, contacts, groupMembersorganization, federatedOrganizations, , everyone, , . unknownFutureValue
Detalle physicalAddress Detalles sobre la propia dirección.
displayName Cadena Nombre descriptivo que el usuario ha asignado a esta dirección.
geocoordenadas geoCoordinates Las coordenadas geográficas de la dirección.
de inferencia inferenciaData Contiene detalles de inferencia si la entidad se deduce mediante la aplicación de creación o modificación. Heredado de itemFacet.
source personDataSource Dónde se originaron los valores si se sincronizaron desde otro servicio. Heredado de itemFacet.

Respuesta

Si tiene éxito, este método devuelve un 201 Created código de respuesta y un objeto itemAddress en el cuerpo de la respuesta.

Ejemplos

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

Respuesta

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

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
}