Zamawianie nowego konta klienta

Zanim utworzysz nowe konto klienta, weź pod uwagę te kwestie:

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, element customerId już istnieje. Zanim zarejestrujesz konto klienta, musisz przenieść jego subskrypcje.

  3. W razie potrzeby zmieniać domyślny język klienta.

  4. Przypisz użytkownikowi rolę superadministratora. Podczas tworzenia konta administratora możesz wygenerować tymczasowe losowe hasło lub poprosić klienta o podanie hasła.

  5. Poinformuj klienta, że musi zalogować się w konsoli administracyjnej i podpisać umowę Google Workspace za pomocą umowy sprzedawcy, aby aktywować swoje konto. 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 ze zweryfikowaną domeną. Ci klienci potrzebują Gmaila i pełnego dostępu administratora. Podczas tworzenia tego typu klienta ustaw parametr customerType na domain.
  • Klienci weryfikowani za pomocą adresu e-mail. Ci klienci nie są właścicielami domeny ani nią nie zarządzają. Podczas tworzenia tego typu klienta ustaw wartość customerType na team. Klienci tego typu mogą kupować wersje Essentials i Enterprise Essentials Google Workspace.

Ten przykładowy tekst żądania w formacie JSON przedstawia klienta z weryfikacją 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 następujące elementy:

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

W odpowiedzi na pomyślne wywołanie zwracany jest 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ładowy tekst żądania w formacie JSON przedstawia klienta zweryfikowanego 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"
}

W odpowiedzi na pomyślne wywołanie zwracany jest 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 jest stosowany tylko w przypadku nowych użytkowników, gdy są tworzeni. Istniejący użytkownicy zachowają aktualny język nawet po zaktualizowaniu języka domyślnego. Dlatego przed utworzeniem użytkowników musisz ustawić domyślny język klienta.

Nowo utworzony klient ma domyślnie ustawiony język angielski. Aby zmienić język domyślny, użyj wywołań PATCH lub UPDATE z punktu końcowego Customers interfejsu Directory API.

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

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

Dołącz ten tekst JSON:

{
  "language":"LANGUAGE_CODE"
}

Zastąp następujące elementy:

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

Pomyślna odpowiedź JSON zwraca kod stanu HTTP 200 oraz 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