Zamawianie nowego konta klienta

Zanim utworzysz nowe konto klienta, zapoznaj się z tymi informacjami:

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 element customerId już istnieje. Przed zarejestrowaniem konta klienta musisz przenieść subskrypcje klienta.

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

  4. Awansuj 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 musi zalogować się w konsoli administracyjnej Google i podpisać umowę Google Workspace z odsprzedawcą, aby aktywować konto. Sprzedawcy nie mogą podpisywać Warunków korzystania z usługi w imieniu klienta.

Rodzaje klientów

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

  • Klienci weryfikowani za pomocą domeny: ci klienci potrzebują Gmaila i pełnego dostępu administratora. Podczas tworzenia tego typu klienta ustaw wartość customerType na domain.
  • Klienci zweryfikowani 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. Ci klienci mogą kupić wersje Google Workspace Google Workspace Essentials i Google Workspace Enterprise Essentials.

Poniżej znajdziesz przykład treści żądania w formacie JSON w przypadku klienta zweryfikowanego 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: 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 treści żą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"
}

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. Istniejący użytkownicy zachowają swój język po zaktualizowaniu języka domyślnego. Dlatego przed utworzeniem użytkowników ustaw domyślny język klienta.

Nowy klient ma domyślny język angielski. Aby zmienić język domyślny, użyj metod 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

Umieść w treści żądania JSON ten kod:

{
  "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.

Odpowiedź JSON zakończona powodzeniem 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