Udostępnij za pośrednictwem


Accounts - Get Teams Civic Address

Uzyskaj adres obywatelski aplikacji Teams.
Uzyskaj szczegółowe informacje o określonym adresie obywatelskim usługi Teams przy użyciu jego identyfikatora.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
accountName
path True

string

Nazwa konta.

Wzorzec wyrażenia regularnego: ^([A-Za-z0-9_-]+)$

civicAddressId
path True

string

Identyfikator adresu obywatelskiego.

api-version
query True

string

Wersja interfejsu API do użycia dla tej operacji.

Nagłówek żądania

Nazwa Wymagane Typ Opis
If-Match

string

Żądanie powinno być kontynuowane tylko wtedy, gdy jednostka jest zgodna z tym ciągiem.

If-None-Match

string

Żądanie powinno być kontynuowane tylko wtedy, gdy żadna jednostka nie pasuje do tego ciągu.

If-Unmodified-Since

string

date-time

Żądanie powinno być kontynuowane tylko wtedy, gdy jednostka nie została zmodyfikowana po tym czasie.

If-Modified-Since

string

date-time

Żądanie powinno być kontynuowane tylko wtedy, gdy jednostka została zmodyfikowana po tym czasie.

x-ms-client-request-id

string

uuid

Nieprzezroczysty, unikatowy globalnie, wygenerowany przez klienta identyfikator ciągu dla żądania.

Odpowiedzi

Nazwa Typ Opis
200 OK

TeamsCivicAddressResource

Żądanie zakończyło się pomyślnie.

Nagłówki

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

Azure.Core.Foundations.ErrorResponse

Nieoczekiwana odpowiedź na błąd.

Nagłówki

x-ms-error-code: string

Zabezpieczenia

OAuth2Auth

Typ: oauth2
Flow: application
Adres URL tokenu: https://login.microsoftonline.com/common/oauth2/v2.0/token

Zakresy

Nazwa Opis
https://func-voiceservice-rp-prod-eastuseuap.azurewebsites.net/.default

Przykłady

Get a Civic Address.

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Definicje

Nazwa Opis
Azure.Core.Foundations.Error

Obiekt error.

Azure.Core.Foundations.ErrorResponse

Odpowiedź zawierająca szczegóły błędu.

Azure.Core.Foundations.InnerError

Obiekt zawierający bardziej szczegółowe informacje o błędzie. Zgodnie z wytycznymi interfejsu MICROSOFT One API — https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Location

Lokalizacja używana przez program Team Operator Connect lub Telefon w Teams numery telefonów komórkowych.

TeamsCivicAddressResource

Adres obywatelski dostępny dla użytkowników usługi Teams Operator Connect lub Telefon w Teams Użytkowników mobilnych.

ValidationStatus

Możliwy stan weryfikacji adresów obywatelskich usługi Teams.

Azure.Core.Foundations.Error

Obiekt error.

Nazwa Typ Opis
code

string

Jeden z zdefiniowanych przez serwer zestaw kodów błędów.

details

Azure.Core.Foundations.Error[]

Tablica szczegółów dotyczących określonych błędów, które doprowadziły do tego zgłoszonego błędu.

innererror

Azure.Core.Foundations.InnerError

Obiekt zawierający bardziej szczegółowe informacje niż bieżący obiekt o błędzie.

message

string

Czytelna dla człowieka reprezentacja błędu.

target

string

Element docelowy błędu.

Azure.Core.Foundations.ErrorResponse

Odpowiedź zawierająca szczegóły błędu.

Nazwa Typ Opis
error

Azure.Core.Foundations.Error

Obiekt error.

Azure.Core.Foundations.InnerError

Obiekt zawierający bardziej szczegółowe informacje o błędzie. Zgodnie z wytycznymi interfejsu MICROSOFT One API — https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Nazwa Typ Opis
code

string

Jeden z zdefiniowanych przez serwer zestaw kodów błędów.

innererror

Azure.Core.Foundations.InnerError

Błąd wewnętrzny.

Location

Lokalizacja używana przez program Team Operator Connect lub Telefon w Teams numery telefonów komórkowych.

Nazwa Typ Opis
additionalInfo

string

Dodatkowe informacje o lokalizacji.

civicAddressId

string

Identyfikator adresu obywatelskiego lokalizacji.

description

string

Opis lokalizacji.

elin

string

Elin (numer identyfikacyjny lokalizacji awaryjnej) lokalizacji.

id

string

Identyfikator lokalizacji.

isDefault

boolean

Flaga wskazująca, czy lokalizacja jest domyślna, czy nie.

TeamsCivicAddressResource

Adres obywatelski dostępny dla użytkowników usługi Teams Operator Connect lub Telefon w Teams Użytkowników mobilnych.

Nazwa Typ Opis
cityOrTown

string

Miasto lub miasto adresu obywatelskiego.

cityOrTownAlias

string

Miasto lub miasto alias adresu obywatelskiego.

companyId

string

Identyfikator firmy adresu obywatelskiego.

companyName

string

Nazwa firmy adresu obywatelskiego.

country

string

Kraj przemówienia obywatelskiego.

countyOrDistrict

string

Powiat lub powiat adresu obywatelskiego.

defaultLocationId

string

Domyślny identyfikator lokalizacji adresu obywatelskiego.

description

string

Opis adresu obywatelskiego.

houseNumber

string

Numer domu adresu obywatelskiego.

houseNumberSuffix

string

Sufiks numeru domu adresu obywatelskiego.

id

string

Identyfikator adresu obywatelskiego.

latitude

string

Szerokość geograficzna adresu obywatelskiego.

locations

Location[]

Lista lokalizacji skojarzonych z adresem obywatelskim.

longitude

string

Długość geograficzna adresu obywatelskiego.

partnerId

string

Identyfikator partnera adresu obywatelskiego.

postDirectional

string

Po kierunkowym przemówieniu obywatelskim.

postalOrZipCode

string

Kod pocztowy adresu obywatelskiego.

preDirectional

string

Pre kierunkowy przemówienia obywatelskiego.

stateOrProvince

string

Stan lub prowincja adresu obywatelskiego.

streetName

string

Nazwa ulicy adresu obywatelskiego.

streetSuffix

string

Sufiks ulicy adresu obywatelskiego.

tenantId

string

Identyfikator dzierżawy klienta adresu obywatelskiego.

validationStatus

ValidationStatus

Stan weryfikacji adresu obywatelskiego.

ValidationStatus

Możliwy stan weryfikacji adresów obywatelskich usługi Teams.

Nazwa Typ Opis
notValidated

string

Adres obywatelski nie jest weryfikowany.

validated

string

Adres obywatelski jest weryfikowany.