REST Resource: customers

Zasób: Customer

Gdy konto klienta Google jest zarejestrowane u sprzedawcy, ten sprzedawca zarządza jego subskrypcjami usług Google. Klient jest opisywany 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 niepowtarzalny identyfikator wygenerowany przez Google. W żądaniu ta usługa może być domeną główną lub unikatowym identyfikatorem wygenerowanym przez Google.
customerDomain

string

ciąg znaków nazwy domeny podstawowej klienta, customerDomain jest wymagany podczas tworzenia nowego klienta. Podczas dodawania klienta nie dołączaj prefiksu www w domenie.
postalAddress

object (Address)

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

string

Numer telefonu do kontaktu z klientem. Musi się zaczynać od znaku „+”, po którym następuje kod kraju. Pozostała część numeru może składać się z ciągłych cyfr lub być zgodna z lokalnymi konwencjami formatowania, ale musi to być prawdziwy numer telefonu, a nie na przykład „123”. Jeśli to pole jest nieprawidłowe, jest ono ignorowane.
alternateEmail

string

Podobnie jak „Adres e-mail klienta” w narzędziach sprzedawcy, ten adres e-mail jest używany jako dodatkowy kontakt, jeśli coś stanie się z usługą klienta, np. wystąpi przerwa w działaniu usługi lub problem z bezpieczeństwem. Ta właściwość jest wymagana podczas tworzenia nowego klienta „domain” i nie powinna używać tej samej domeny co customerDomain. Aby utworzyć klienta należącego do „zespołu”, nie musisz wypełniać pola alternateEmail.
resourceUiUrl

string

Adres URL panelu konsoli administracyjnej klienta. Adres URL tylko do odczytu jest generowany przez usługę interfejsu API. Jest to używane, jeśli aplikacja klienta wymaga, aby klient wykonał zadanie w konsoli administracyjnej.
customerDomainVerified

boolean

Czy została potwierdzona własność domeny podstawowej klienta.
kind

string

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

enum (CustomerType)

Określa typ klienta. Akceptowane wartości:

  • domain: oznacza klienta zweryfikowanego za pomocą domeny (domyślnie).
  • team: oznacza klienta zweryfikowanego za pomocą adresu e-mail.

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

object (PrimaryAdmin)

Dane pierwszego administratora klienta, dostępne w przypadku klienta typu ZESPÓŁ.

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 o countryCode znajdziesz w elementach kodu kraju w formacie ISO 3166. Sprawdź, czy kraj jest zatwierdzony do odsprzedaży produktów Google. Ta usługa jest wymagana podczas tworzenia nowego klienta.
kind

string

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

string

Przykład wartości region to CA w przypadku 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ładem postalCode jest kod pocztowy, np. 94043. Ta usługa jest wymagana podczas tworzenia nowego klienta.
addressLine1

string

Adres pocztowy klienta. Adres może składać się z 1–3 wierszy. Funkcje addressline2 i addressLine3 są opcjonalne.
organizationName

string

Nazwa firmy lub jej działu. Jest ono wymagane.
contactName

string

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

CustomerType

Typ klienta

Wartości w polu enum
customerTypeUnspecified Nieznany typ klienta
domain Klienci zweryfikowani przy użyciu domeny lub właściciele domeny
team Klienci bez domeny lub zweryfikowani za pomocą adresu e-mail

PrimaryAdmin

Szablon kodu JSON dla głównego administratora w przypadku klientów korzystających z TEAM

Zapis JSON 
{
  "primaryEmail": string
}
Pola
primaryEmail

string

Adres e-mail służbowy głównego administratora konta klienta.

Link weryfikacyjny e-maila jest wysyłany na ten adres e-mail w momencie tworzenia klienta. Administratorzy główni 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 konto nowego klienta.

patch

 Zmienia ustawienia konta klienta.

update

 Zmienia ustawienia konta klienta.