Zamawianie nowego konta klienta

Przed utworzeniem nowego konta 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 koncie nowego klienta utwórz konto 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 zmień domyślny język klienta.

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

  5. Powiadom klienta, że musi zalogować się w konsoli administracyjnej i podpisać umowę na korzystanie z Google Workspace w ramach 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 tworzyć 2 rodzaje klientów:

  • Klienci zweryfikowani za pomocą domeny. Tacy klienci potrzebują Gmaila i potrzebują pełnego dostępu administracyjnego. Podczas tworzenia klienta tego typu ustaw customerType na domain.
  • Klienci zweryfikowani za pomocą adresu e-mail. Tacy klienci nie są właścicielami domen ani nimi nie zarządzają. Podczas tworzenia klienta tego typu ustaw customerType na team. Tacy klienci mogą kupić wersje Essentials i Enterprise Essentials Google Workspace.

Oto przykład żądania 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 następujące elementy:

  • DOMAIN_NAME: domena Twojego klienta, na przykład example.com
  • NAME: nazwa klienta, na przykład Alex Cruz.
  • ORGANIZATION_NAME: nazwa organizacji klienta, np. Example Organization.
  • POSTAL_CODE: kod pocztowy Twojego klienta, na przykład 94043.
  • COUNTRY_CODE: kod ISO kraju klienta składający się z 2 znaków.
  • EMAIL_ADDRESS: adres e-mail klienta – na przykład 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"
}

Ta treść żądania JSON to przykład 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 jest stosowany do nowych użytkowników tylko po ich utworzeniu. Istniejący użytkownicy zachowują obecny język nawet po zmianie języka domyślnego. Dlatego zanim utworzysz użytkowników, musisz ustawić domyślny język klienta.

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

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

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

Uwzględnij tę treść żądania JSON:

{
  "language":"LANGUAGE_CODE"
}

Zastąp następujące elementy:

  • CUSTOMER_ID: unikalny identyfikator klienta, np. C0123456
  • LANGUAGE_CODE: akceptowany kod języka – na przykład es dla języka 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