BusinessInfo

Zbieranie informacji o firmie.

Zapis JSON 
{
  "name": string,
  "address": {
    object (PostalAddress)
  },
  "phone": {
    object (PhoneNumber)
  },
  "phoneVerificationState": enum (PhoneVerificationState),
  "customerService": {
    object (CustomerService)
  },
  "koreanBusinessRegistrationNumber": string
}
Pola
name

string

Identyfikator. Nazwa zasobu informacji o firmie. Format: accounts/{account}/businessInfo
address

object (PostalAddress)

Opcjonalnie: Adres firmy.
phone

object (PhoneNumber)

Tylko dane wyjściowe. Numer telefonu firmy.
phoneVerificationState

enum (PhoneVerificationState)

Tylko dane wyjściowe. Stan weryfikacji telefonicznej firmy.
customerService

object (CustomerService)

Opcjonalnie: Obsługa klienta w firmie.
koreanBusinessRegistrationNumber

string

Opcjonalnie: 10-cyfrowy koreański numer rejestracyjny firmy rozdzielony myślnikami w formacie: XXX-XX-XXXXX.

PostalAddress

Reprezentuje adres pocztowy, np. adresów dostawy lub płatności. Jeśli podasz adres pocztowy, firma pocztowa może dostarczyć przesyłki do placówki Twojej firmy. Box lub podobnego. Nie służy on do modelowania lokalizacji geograficznych (dróg, miast, gór).

W większości przypadków adres jest tworzony na podstawie danych wejściowych użytkownika lub importowanych istniejących danych, w zależności od typu procesu.

Porady dotyczące wpisywania / edytowania adresu: – skorzystaj z widżetu z adresem do internacjonalizacji, np. https://github.com/google/libaddressinput – nie należy wyświetlać użytkownikom elementów interfejsu do wprowadzania lub edytowania pól spoza krajów, w których takie pole jest używane.

Więcej wskazówek dotyczących korzystania z tego schematu znajdziesz na stronie https://support.google.com/business/answer/6397478

Zapis JSON 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
Pola
revision

integer

Wersja schematu tabeli PostalAddress. Wartość ta musi wynosić 0, co oznacza najnowszą wersję.

Wszystkie nowe wersje muszą być zgodne wstecznie ze starymi.
regionCode

string

Wymagane. Kod regionu CLDR kraju lub regionu adresu. Nigdy nie jest to ustalane. To użytkownik musi upewnić się, że wartość jest prawidłowa. Szczegółowe informacje można znaleźć na stronach https://cldr.unicode.org/ i https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Przykład: „CH”. dla Szwajcarii.
languageCode

string

Opcjonalnie: Kod języka BCP-47 zawartości tego adresu (jeśli jest znany). Często jest to język interfejsu formularza wejściowego lub prawdopodobnie jeden z języków używanych w adresie kraj/region lub ich transliterowane odpowiedniki. Może to wpłynąć na formatowanie w niektórych krajach, ale nie ma wpływu na prawidłowość danych i nigdy nie wpływa na weryfikację ani inne operacje związane z nieformatowaniem.

Jeśli ta wartość nie jest znana, należy ją pominąć (zamiast określać potencjalnie nieprawidłową wartość domyślną).

Przykłady: „zh-Hant”, „ja”, „ja-Latn”, „pl”.
postalCode

string

Opcjonalnie: Kod pocztowy adresu. Nie wszystkie kraje używają kodów pocztowych lub ich wymagają, ale tam, gdzie są używane, mogą powodować dodatkową weryfikację innych części adresu (np. stan lub kod pocztowy w Stanach Zjednoczonych).
sortingCode

string

Opcjonalnie: Dodatkowy kod sortowniczy specyficzny dla kraju. Nie jest on używany w większości regionów. Ta wartość jest ciągiem znaków takim jak „CEDEX”, po którym może występować liczba (np. „CEDEX 7”), lub samej liczby reprezentującej „kod sektora” (Jamajka), „wskaźnik obszaru dostawy” (Malawi) lub „wskaźnik urzędu pocztowego” (np. Wybrzeże Kości Słoniowej).
administrativeArea

string

Opcjonalnie: Najwyższy podział administracyjny stosowany w przypadku adresów pocztowych kraju lub regionu. Na przykład stan, prowincja, obwód lub prefektura. W przypadku Hiszpanii jest to prowincja, a nie wspólnota autonomiczna (np. „Barcelona”, nie „Katalonia”). Wiele krajów nie używa regionu w adresach pocztowych. Na przykład: w Szwajcarii pole musi być puste.
locality

string

Opcjonalnie: Zasadniczo odnosi się do części miejscowości lub miejscowości. Przykłady: USA, gmina IT, poczta polska. W regionach, w których miejscowości nie są dobrze zdefiniowane lub nie pasują do tej struktury, zostaw pole Rejon puste, a następnie użyj addressLines.
sublocality

string

Opcjonalnie: Dzielnica adresu. Na przykład mogą to być dzielnice, dystrykty, okręgi.
addressLines[]

string

Nieuporządkowane wiersze adresu opisujące dolne poziomy adresu.

Wartości w addressLine nie mają informacji o typie i czasami mogą zawierać wiele wartości w jednym polu (np. „Austin, TX”), ważne jest, aby kolejność wierszy była jasna. Kolejność wierszy adresu powinna być określona jako „kolejność danych koperty”. zgodnie z krajem/regionem adresu. Tam, gdzie może być to inne (np. w Japonii), słowo address_language jest używane do jednoznacznego określenia (np. „ja” dla sortowania w dużym i małym porządku oraz „ja-Latn” lub „en” dla małych i dużych). Dzięki temu można wybrać najbardziej precyzyjny wiersz adresu na podstawie języka.

Minimalna dozwolona reprezentacja strukturalna adresu składa się z kodu regionu RegionCode, a wszystkie pozostałe informacje są umieszczane w elemencie addressLines. Sformatowanie takiego adresu w przybliżeniu bez geokodowania byłoby możliwe, ale semantyczne rozumowanie nie byłoby możliwe w odniesieniu do żadnego ze składników adresu, dopóki nie zostanie przynajmniej częściowo rozpatrzone.

Zalecanym sposobem obsługi adresów całkowicie nieuporządkowanych
recipients[]

string

Opcjonalnie: Adresat pod adresem. W pewnych okolicznościach to pole może zawierać informacje obejmujące wiele wierszy. Może to na przykład zawierać hasło „opieka” i informacjami o nich.
organization

string

Opcjonalnie: Nazwa organizacji pod adresem.

Numer telefonu

Obiekt reprezentujący numer telefonu, odpowiedni jako format przewodu do interfejsu API.

Reprezentacja:

  • nie powinien być używany do formatowania numeru telefonu zależnego od języka, np. „+1 (650) 253-0000 wew. 123 cale

  • nie została zaprojektowana z myślą o wydajnym miejscu na dane

  • może nie być odpowiedni do dzwonienia – do analizy tego numeru należy używać specjalistycznych bibliotek (patrz materiały referencyjne)

Aby użyć tej liczby, aby wykonać z niej wartości, na przykład sformatować ją na potrzeby różnych przypadków użycia, przekonwertuj ją na obiekt i18n.phonenumbers.PhoneNumber.

Na przykład w Javie będzie to:

com.google.type.PhoneNumber wireProto = com.google.type.PhoneNumber.newBuilder().build(); com.google.i18n.phonenumbers.Phonenumber.PhoneNumber phoneNumber = PhoneNumberUtil.getInstance().parse(wireProto.getE164Number(), "ZZ"); if (!wireProto.getExtension().isEmpty()) { phoneNumber.setExtension(wireProto.getExtension());

Materiały referencyjne: https://github.com/google/libphonenumber

Zapis JSON 
{
  "extension": string,

  // Union field kind can be only one of the following:
  "e164Number": string,
  "shortCode": {
    object (ShortCode)
  }
  // End of list of possible types for union field kind.
}
Pola
extension

string

Rozszerzenie numeru telefonu. Rozszerzenie nie jest ustandaryzowane w rekomendacjach ITU z wyjątkiem serii liczb o maksymalnej długości 40 cyfr. Inne niż cyfry i niektóre inne znaki wybierania numeru, np. „,” (oznacza czas oczekiwania) lub „#” mogą być przechowywane tutaj.

Pamiętaj, że w żadnym regionie nie są obecnie używane rozszerzenia z krótkimi kodami, więc w tym polu ustawia się zwykle tylko połączenie z numerem E.164. Jest przechowywany oddzielnie od numeru E.164, aby w przyszłości umożliwić stosowanie krótkich rozszerzeń kodu.
Pole sumy kind. Wymagane. Może to być zwykły numer lub krótki kod. W przyszłości będzie można dodawać do jednego z poniższych pól, dlatego klienci powinni ignorować numery telefonów, dla których nie ustawiono żadnych zakodowanych pól. kind może mieć tylko jedną z tych wartości:
e164Number

string

Numer telefonu na początkowym znaku plusa („+”), po którym następuje numer telefonu w prostym formacie ITU E.164, składający się z kodu krajowego (od 1 do 3 cyfr) i numeru abonenckiego bez dodatkowych spacji i formatowania, np.: – prawidłowo: „+15552220123” – nieprawidłowa: „+1 (555) 222-01234 x123”.

Format ITU E.164 ogranicza ten ostatni do 12 cyfr, ale w praktyce nie wszystkie kraje to przestrzegają, więc to ograniczenie jest złagodzone. Numery krajowe są niedozwolone.

Źródła: https://www.itu.int/rec/T-REC-E.164-201011-I - https://en.wikipedia.org/wiki/E.164. – https://en.wikipedia.org/wiki/List_of_country_calling_codes
shortCode

object (ShortCode)

Krótki kod.

Materiały: https://en.wikipedia.org/wiki/Short_code

ShortCode

Obiekt reprezentujący krótki kod, czyli numer telefonu, który jest zwykle znacznie krótszy niż zwykłe numery telefonów. Może być używany do adresowania wiadomości w systemach MMS i SMS, a także do obsługi skrótów dzwonienia (np. „Wyślij SMS-a pod numer 611, aby sprawdzić, ile minut pozostało do końca Twojego abonamentu”).

Krótkie kody są ograniczone do regionu i nie można ich dzwonić za granicę.Oznacza to, że ten sam krótki kod może istnieć w różnych regionach, o odmiennym wykorzystaniu i cenach, nawet jeśli w poszczególnych regionach jest używany ten sam numer kierunkowy kraju (np. w Stanach Zjednoczonych i Kanadzie).

Zapis JSON 
{
  "regionCode": string,
  "number": string
}
Pola
regionCode

string

Wymagane. Kod regionu BCP-47 lokalizacji, w której można wykonywać połączenia z tym krótkim kodem (np. „PL”). i „BB”.

Materiały referencyjne: http://www.unicode.org/reports/tr35/#unicode_region_subtag
number

string

Wymagane. Krótkie cyfry bez poprzedzającego znaku plusa („+”) ani numeru kierunkowego kraju, np. „611”.

PhoneVerificationState

Stan weryfikacji telefonicznej.

Wartości w polu enum
PHONE_VERIFICATION_STATE_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
PHONE_VERIFICATION_STATE_VERIFIED Telefon jest zweryfikowany.
PHONE_VERIFICATION_STATE_UNVERIFIED Telefon jest niezweryfikowany

CustomerService

Informacje o obsłudze klienta.

Zapis JSON 
{
  "uri": string,
  "email": string,
  "phone": {
    object (PhoneNumber)
  }
}
Pola
uri

string

Opcjonalnie: Identyfikator URI, pod którym można znaleźć obsługę klienta.
email

string

Opcjonalnie: Adres e-mail, pod którym można skontaktować się z obsługą klienta.
phone

object (PhoneNumber)

Opcjonalnie: Numer telefonu, pod którym można zadzwonić do obsługi klienta.