Zamawianie nowego konta klienta

Zanim utworzysz nowe konto klienta, pamiętaj o tych kwestiach:

Tworzenie konta klienta

  1. Aby utworzyć konto klienta, użyj tego żądania POST i dołącz token autoryzacji:

    POST https://reseller.googleapis.com/apps/reseller/v1/customers

  2. Na nowym koncie klienta, utwórz użytkownika. Jeśli odpowiedź zwraca kod stanu HTTP 409 Conflict, oznacza to, że customerId już istnieje. Zanim zarejestrujesz konto klienta, musisz przenieść subskrypcje klienta.

  3. W razie potrzeby, zmień domyślny język klienta.

  4. Promuj użytkownika do roli superadministratora. Podczas tworzenia konta administratora możesz wygenerować tymczasowe losowe hasło lub poprosić klienta o podanie hasła.

  5. Poinformuj klienta, że aby aktywować konto, musi zalogować się w konsoli administracyjnej Google i podpisać umowę Google Workspace z odsprzedawcą. Sprzedawcy nie mogą podpisywać Warunków korzystania z usługi w imieniu klienta.

Typy klientów

W Google Workspace możesz utworzyć 2 rodzaje klientów:

  • Klienci weryfikowani za pomocą domeny: ci klienci potrzebują Gmaila i pełnego dostępu administratora. Gdy tworzysz tego typu klienta, ustaw customerType na domain.
  • Klienci weryfikowani za pomocą adresu e-mail: ci klienci nie są właścicielami domeny ani nią nie zarządzają. Gdy tworzysz tego typu klienta, ustaw customerType na team. Ci klienci mogą kupić Google Workspace w wersjach Google Workspace Essentials i Google Workspace Enterprise Essentials Google Workspace.

Ten przykład przedstawia treść żądania JSON dla klienta weryfikowanego za pomocą domeny:

{
  "customerDomain": "DOMAIN_NAME",
  "customerType": "domain",
  "postalAddress": {
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE"
  },
  "alternateEmail": "EMAIL_ADDRESS"
}

Zastąp te elementy:

  • DOMAIN_NAME: domena klienta, np. example.com.
  • NAME: imię i nazwisko klienta, np. Alex Cruz.
  • ORGANIZATION_NAME: nazwa organizacji klienta, np. Example Organization.
  • POSTAL_CODE: kod pocztowy klienta, np. 94043.
  • COUNTRY_CODE: 2-znakowy kod kraju ISO klienta.
  • EMAIL_ADDRESS: adres e-mail klienta, np. cruz@example.com.

Pomyślna odpowiedź zwraca kod stanu HTTP 200 i informacje o nowym kliencie:

{
  "kind": "reseller#customer",
  "customerId": "CUSTOMER_ID",
  "customerDomain": "DOMAIN_NAME",
  "customerType": "domain",
  "postalAddress": {
    "kind": "customers#address",
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE",
  },
  "alternateEmail": "EMAIL_ADDRESS"
}

Ten przykład przedstawia treść żądania JSON dla klienta weryfikowanego za pomocą adresu e-mail:

{
  "customerDomain": "DOMAIN_NAME",
  "customerType": "team",
  "primaryAdmin": {
    "primaryEmail": "EMAIL_ADDRESS"
  },
  "postalAddress": {
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE"
  },
 "alternateEmail": "EMAIL_ADDRESS"
}

Pomyślna odpowiedź zwraca kod stanu HTTP 200 i informacje o nowym kliencie:

{
  "kind": "reseller#customer",
  "customerId": "CUSTOMER_ID",
  "customerDomain": "DOMAIN_NAME,
  "customerType": "team",
  "primaryAdmin": {
    "primaryEmail": "EMAIL_ADDRESS"
  },
  "postalAddress": {
    "kind": "customers#address",
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE",
  },
  "alternateEmail": "EMAIL_ADDRESS"
}

Zmienianie domyślnego języka klienta

Domyślny język klienta dotyczy tylko nowych użytkowników. Po zaktualizowaniu domyślnego języka dotychczasowi użytkownicy zachowują swój język. Dlatego przed utworzeniem użytkowników ustaw domyślny język klienta.

Nowy klient ma domyślny język angielski. Aby zmienić domyślny język, użyj PATCH lub UPDATE metod z punktu końcowego Customers w interfejsie Directory API.

Użyj interfejsu Directory API, aby zaktualizować domyślną wartość language dla klienta:

PATCH https://reseller.googleapis.com/admin/directory/v1/customers/CUSTOMER_ID

Dołącz tę treść żądania JSON:

{
  "language":"LANGUAGE_CODE"
}

Zastąp te elementy:

  • CUSTOMER_ID: unikalny identyfikator klienta, np. C0123456.
  • LANGUAGE_CODE: akceptowany kod języka, np. es dla hiszpańskiego.

Pomyślna odpowiedź JSON zwraca kod stanu HTTP 200 i zaktualizowany zasób klienta:

{
  "alternateEmail": "EMAIL_ADDRESS",
  "customerCreationTime": "2022-12-12T23:04:10.620Z",
  "customerDomain": "DOMAIN_NAME",
  "id": "CUSTOMER_ID",
  "kind": "admin#directory#customer",
  "language": "LANGUAGE_CODE",
  "postalAddress": {
    "contactName": "NAME",
    "countryCode": "COUNTRY_CODE",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE"
  }
}

Dalsze kroki