REST Resource: customers

Zasób: klient

Gdy konto klienta Google jest zarejestrowane u sprzedawcy, jego subskrypcjami usług Google jest zarządzane przez tego sprzedawcę. Klient jest opisany za pomocą nazwy domeny podstawowej i adresu fizycznego.

Zapis JSON
{
  "customerId": string,
  "customerDomain": string,
  "postalAddress": {
    object (Address)
  },
  "phoneNumber": string,
  "alternateEmail": string,
  "resourceUiUrl": string,
  "customerDomainVerified": boolean,
  "kind": string,
  "customerType": enum (CustomerType),
  "primaryAdmin": {
    object (PrimaryAdmin)
  }
}
Pola
customerId

string

Ta właściwość będzie zawsze zwracana w odpowiedzi jako unikalny identyfikator wygenerowany przez Google. W żądaniu tą usługą może być domena podstawowa lub unikalny identyfikator wygenerowany przez Google.

customerDomain

string

Ciąg znaków nazwy domeny podstawowej klienta. Pole customerDomain jest wymagane podczas tworzenia nowego klienta. Podczas dodawania klienta nie podawaj w domenie prefiksu www.

postalAddress

object (Address)

Informacje adresowe klienta. Każde pole może mieć maksymalnie 255 znaków.

phoneNumber

string

Kontaktowy numer telefonu klienta. Musi zaczynać się od „+” a po nim kod kraju. Pozostała część numeru może być numerami stałymi lub musi być zgodna z lokalnymi konwencjami formatowania telefonu, ale musi to być prawdziwy numer telefonu, a nie na przykład „123”. Jeśli to pole jest nieprawidłowe, zostanie dyskretnie ignorowane.

alternateEmail

string

Np. pole „Adres e-mail klienta”. w narzędziach sprzedawcy ten adres e-mail jest drugorzędną osobą kontaktową używaną w przypadku problemów z usługą klienta, takich jak przerwa w działaniu usługi lub problem z bezpieczeństwem. Ta usługa jest wymagana podczas tworzenia nowej „domeny” klienta i nie powinni używać tej samej domeny co customerDomain. Pole alternateEmail nie jest konieczne do utworzenia „zespołu”. klienta.

resourceUiUrl

string

Adres URL panelu konsoli administracyjnej klienta. Adres URL tylko do odczytu jest generowany przez usługę API. Jest ona używana, gdy aplikacja kliencka wymaga od klienta wykonania zadania w konsoli administracyjnej.

customerDomainVerified

boolean

Wskazuje, czy domena podstawowa klienta została zweryfikowana.

kind

string

Identyfikuje zasób jako klient. Wartość: reseller#customer

customerType

enum (CustomerType)

Określa typ klienta. Akceptowane wartości:

  • domain: oznacza klienta zweryfikowanego za pomocą domeny (domyślnie).
  • team: oznacza, że klient ma zweryfikowany adres e-mail.

Więcej informacji znajdziesz w artykule o zarządzanych zespołach.

primaryAdmin

object (PrimaryAdmin)

Pierwsze dane administratora klienta, widoczne w przypadku klienta team.

Adres

Szablon JSON adresu klienta.

Zapis JSON
{
  "countryCode": string,
  "kind": string,
  "region": string,
  "addressLine2": string,
  "locality": string,
  "addressLine3": string,
  "postalCode": string,
  "addressLine1": string,
  "organizationName": string,
  "contactName": string
}
Pola
countryCode

string

Informacje na temat countryCode znajdziesz w artykule o elementach kodu kraju w formacie ISO 3166. Sprawdź, czy kraj jest zatwierdzony do sprzedaży usług Google. Ta usługa jest wymagana podczas tworzenia nowego klienta.

kind

string

Wskazuje zasób jako adres klienta. Wartość: customers#address

region

string

Przykładem wartości region jest CA dla stanu Kalifornia.

addressLine2

string

Drugi wiersz adresu.

locality

string

Przykładem wartości locality jest miasto San Francisco.

addressLine3

string

Wiersz 3 adresu.

postalCode

string

Przykładowy element postalCode to kod pocztowy, taki jak 94043. Ta usługa jest wymagana podczas tworzenia nowego klienta.

addressLine1

string

Fizyczny adres klienta. Adres może się składać z 1–3 wierszy. Uprawnienia addressline2 i addressLine3 są opcjonalne.

organizationName

string

Nazwa firmy lub oddziału firmy. Jest ono wymagane.

contactName

string

Imię i nazwisko osoby do kontaktu po stronie klienta. Jest ono wymagane.

CustomerType

Typ klienta

Wartości w polu enum
customerTypeUnspecified Nieznany typ klienta
domain Klienci korzystający z domeny lub tylko w domenie
team Klienci bez domeny lub zweryfikowani za pomocą adresu e-mail

PrimaryAdmin

Szablon JSON dla administratora głównego w przypadku klientów należących do zespołu TEAM

Zapis JSON
{
  "primaryEmail": string
}
Pola
primaryEmail

string

Firmowy adres e-mail głównego administratora klienta.

Link weryfikacyjny e-mail został wysłany na ten adres w chwili tworzenia klienta. Główni administratorzy mają dostęp do konsoli administracyjnej klienta, w tym mogą zapraszać i usuwać użytkowników oraz zarządzać potrzebami administracyjnymi klienta.

Metody

get

Pobiera konto klienta.

insert

Zamawia nowe konto klienta.

patch

Aktualizuje ustawienia konta klienta.

update

Aktualizuje ustawienia konta klienta.