REST Resource: customers

Zasób: Klient

Gdy konto klienta Google jest zarejestrowane u sprzedawcy, zarządza nim klient usług Google. Klient to nazwa domeny podstawowej i adresu pocztowego.

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 w postaci unikalnego identyfikatora wygenerowanego przez Google. Ta prośba może być domeną podstawową lub unikalnym identyfikatorem wygenerowanym przez Google.
customerDomain

string

Ciąg nazwy domeny podstawowej klienta. Do utworzenia nowego klienta wymagany jest element customerDomain. Podczas dodawania klienta nie dodawaj prefiksu www w domenie.
postalAddress

object (Address)

Dane adresowe klienta. Każde pole może zawierać maksymalnie 255 znaków.
phoneNumber

string

kontaktowy numer telefonu klienta. Musi zaczynać się od ciągu "+", po którym następuje kod kraju. Pozostała część numeru może być przyległa do siebie lub przestrzegać konwencji formatu lokalnego telefonu, ale musi to być rzeczywisty numer telefonu, a nie np. "123". Jeśli to pole jest nieprawidłowe, jest ignorowane.
alternateEmail

string

Podobnie jak w przypadku „Adresu e-mail klienta”, w narzędziach sprzedawcy adres ten jest dodatkowym adresem e-mail używanym w przypadku problemów z usługą klienta, takich jak przerwa w działaniu usługi lub problem z zabezpieczeniami. Ta właściwość jest wymagana podczas tworzenia nowego domeny &klienta i nie powinna używać tej samej domeny co customerDomain. Pole alternateEmail nie jest wymagane do utworzenia klienta &zespołu.
resourceUiUrl

string

Adres URL panelu konsoli administracyjnej klienta. Adres URL tylko do odczytu jest generowany przez usługę API. Ten szablon jest potrzebny, jeśli aplikacja kliencka wymaga od klienta wykonania zadania w konsoli administracyjnej.
customerDomainVerified

boolean

Określa, czy domena podstawowa klienta została zweryfikowana.
kind

string

Wskazuje zasób jako klienta. Wartość: reseller#customer
customerType

enum (CustomerType)

Określa typ klienta. Akceptowane wartości to:

  • domain: oznacza klienta z potwierdzoną własnością domeny (domyślnie).
  • team: oznacza klienta potwierdzonego za pomocą adresu e-mail.

Więcej informacji znajdziesz w artykule Zarządzane zespoły.
primaryAdmin

object (PrimaryAdmin)

Pierwsze dane klienta podane klientowi w przypadku zespołu TEAM.

Adres

Szablon JSON adresu firmy.

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 o parametrze countryCode znajdziesz w artykule Elementy kodu kraju ISO 3166. Musisz potwierdzić, że kraj jest zatwierdzony na potrzeby sprzedaży usług Google. Ta właściwość jest wymagana podczas tworzenia nowego klienta.
kind

string

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

string

Przykład wartości region to CA w przypadku stanu Kalifornia.
addressLine2

string

Wiersz 2 adresu.
locality

string

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

string

Wiersz 3 adresu.
postalCode

string

Na przykład postalCode to kod pocztowy taki jak 94043. Ta właściwość jest wymagana podczas tworzenia nowego klienta.
addressLine1

string

Adres firmy klienta. Adres może się składać z jednego lub trzech wierszy. Właściwości 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.

Typ klienta

Typ klienta

Wartości w polu enum
customerTypeUnspecified Nieznany typ klienta
domain Klienci zarejestrowani w domenie lub należący do domeny
team Klienci weryfikowani za pomocą domeny lub adresu e-mail

Administrator główny

Szablon JSON dla administratora głównego w przypadku klientów TEAM

Zapis JSON 
{
  "primaryEmail": string
}
Pola
primaryEmail

string

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

Link do weryfikacji adresu e-mail jest wysyłany na ten adres w chwili utworzenia klienta. Główni administratorzy mają dostęp do konsoli administracyjnej klienta, w tym możliwość zapraszania i usuwania użytkowników oraz zarządzania potrzebami administracyjnymi klienta.

Metody

get

 Pobiera konto klienta.

insert

 Zamawia nowe konto klienta.

patch

 Aktualizuje konto klienta.

update

 Aktualizuje konto klienta.