Compartir a través de


Accounts - Get Teams Civic Address

Obtenga la dirección civic de Teams.
Obtenga detalles de una dirección civic de Teams específica con su identificador.

GET https:///accounts/{accountName}/teamsCivicAddresses/{civicAddressId}?api-version=2024-02-29-preview

Parámetros de identificador URI

Nombre En Requerido Tipo Description
accountName
path True

string

Nombre de la cuenta.

Patrón de Regex: ^([A-Za-z0-9_-]+)$

civicAddressId
path True

string

Identificador de la dirección postal.

api-version
query True

string

Versión de API que se usará para la operación.

Encabezado de la solicitud

Nombre Requerido Tipo Description
If-Match

string

La solicitud solo debe continuar si una entidad coincide con esta cadena.

If-None-Match

string

La solicitud solo debe continuar si ninguna entidad coincide con esta cadena.

If-Unmodified-Since

string

date-time

La solicitud solo debe continuar si la entidad no se modificó después de este tiempo.

If-Modified-Since

string

date-time

La solicitud solo debe continuar si la entidad se modificó después de este tiempo.

x-ms-client-request-id

string

uuid

Identificador de cadena globalmente único y generado por el cliente para la solicitud.

Respuestas

Nombre Tipo Description
200 OK

TeamsCivicAddressResource

La solicitud se ha realizado correctamente.

Encabezados

  • ETag: string
  • x-ms-client-request-id: string
Other Status Codes

Azure.Core.Foundations.ErrorResponse

Respuesta de error inesperada.

Encabezados

x-ms-error-code: string

Seguridad

OAuth2Auth

Tipo: oauth2
Flujo: application
Dirección URL del token: https://login.microsoftonline.com/common/oauth2/v2.0/token

Ámbitos

Nombre Description
https://func-voiceservice-rp-prod-eastuseuap.azurewebsites.net/.default

Ejemplos

Get a Civic Address.

Solicitud de ejemplo

GET https:///accounts/contoso/teamsCivicAddresses/ebfee340-a791-11ed-9bfa-ed8bb5c41be4?api-version=2024-02-29-preview

Respuesta de muestra

{
  "id": "ebfee340-a791-11ed-9bfa-ed8bb5c41be4",
  "country": "US",
  "houseNumber": "11600",
  "streetName": "Sunrise Valley",
  "stateOrProvince": "VA",
  "cityOrTown": "Reston",
  "postalOrZipCode": "20191",
  "companyName": "contoso",
  "defaultLocationId": "653c9fed-f8a7-4a6c-917b-b5b1ad4d45f7",
  "validationStatus": "validated",
  "tenantId": "a7f4bd5c-cc01-40f4-8baa-2b6bdb272b8a",
  "locations": [
    {
      "id": "653c9fed-f8a7-4a6c-917b-b5b1ad4d45f7",
      "civicAddressId": "ebfee340-a791-11ed-9bfa-ed8bb5c41be4",
      "isDefault": true,
      "description": "911"
    }
  ]
}

Definiciones

Nombre Description
Azure.Core.Foundations.Error

Objeto de error.

Azure.Core.Foundations.ErrorResponse

Una respuesta que contiene los detalles del error.

Azure.Core.Foundations.InnerError

Objeto que contiene información más específica sobre el error. Según las directrices de la API de Microsoft One: https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Location

Una ubicación que usa el operador de equipo Connect o Teléfono Teams números de teléfono móvil.

TeamsCivicAddressResource

Una dirección postal disponible para el operador de Teams Connect o Teléfono Teams usuarios móviles.

ValidationStatus

El posible estado de validación de las direcciones civiles de Teams.

Azure.Core.Foundations.Error

Objeto de error.

Nombre Tipo Description
code

string

Uno de los conjuntos de códigos de error definidos por el servidor.

details

Azure.Core.Foundations.Error[]

Matriz de detalles sobre errores específicos que llevaron a este error notificado.

innererror

Azure.Core.Foundations.InnerError

Objeto que contiene información más específica que el objeto actual sobre el error.

message

string

Representación legible del error.

target

string

Destino del error.

Azure.Core.Foundations.ErrorResponse

Una respuesta que contiene los detalles del error.

Nombre Tipo Description
error

Azure.Core.Foundations.Error

Objeto de error.

Azure.Core.Foundations.InnerError

Objeto que contiene información más específica sobre el error. Según las directrices de la API de Microsoft One: https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Nombre Tipo Description
code

string

Uno de los conjuntos de códigos de error definidos por el servidor.

innererror

Azure.Core.Foundations.InnerError

Error interno.

Location

Una ubicación que usa el operador de equipo Connect o Teléfono Teams números de teléfono móvil.

Nombre Tipo Description
additionalInfo

string

Información adicional de la ubicación.

civicAddressId

string

Identificador de dirección civil de la ubicación.

description

string

Descripción de la ubicación.

elin

string

El elin (número de identificación de ubicación de emergencia) de la ubicación.

id

string

Identificador de la ubicación.

isDefault

boolean

Marca que indica si la ubicación es predeterminada o no.

TeamsCivicAddressResource

Una dirección postal disponible para el operador de Teams Connect o Teléfono Teams usuarios móviles.

Nombre Tipo Description
cityOrTown

string

La ciudad o la ciudad de la dirección civil.

cityOrTownAlias

string

Alias de ciudad o ciudad de la dirección civil.

companyId

string

Identificador de la compañía de la dirección postal.

companyName

string

Nombre de la empresa de la dirección postal.

country

string

El país de la dirección civil.

countyOrDistrict

string

El condado o distrito de la dirección postal.

defaultLocationId

string

El identificador de ubicación predeterminado de la dirección postal.

description

string

Descripción de la dirección civil.

houseNumber

string

Número de casa de la dirección postal.

houseNumberSuffix

string

Sufijo de número de casa de la dirección postal.

id

string

Identificador de la dirección postal.

latitude

string

Latitud de la dirección civil.

locations

Location[]

La lista de ubicaciones asociadas a la dirección postal.

longitude

string

Longitud de la dirección postal.

partnerId

string

Id. de socio de la dirección postal.

postDirectional

string

Dirección postal de la dirección civil.

postalOrZipCode

string

El código postal o postal de la dirección postal.

preDirectional

string

La dirección predireccional de la dirección civil.

stateOrProvince

string

El estado o provincia de la dirección civil.

streetName

string

El nombre de la calle de la dirección postal.

streetSuffix

string

Sufijo de calle de la dirección postal.

tenantId

string

Identificador de inquilino del cliente de la dirección postal.

validationStatus

ValidationStatus

El estado de validación de la dirección civil.

ValidationStatus

El posible estado de validación de las direcciones civiles de Teams.

Nombre Tipo Description
notValidated

string

No se valida la dirección postal.

validated

string

Se valida la dirección postal.