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 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. Przypisz użytkownikowi rolę superadministratora. Podczas tworzenia konta administratora możesz wygenerować tymczasowe losowe hasło lub poprosić klienta o podanie hasła.

  5. Powiadom klienta, że aby aktywować swoje konto, musi zalogować się w konsoli administracyjnej i podpisać umowę Google Workspace za pośrednictwem sprzedawcy. 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 pełnego dostępu administratora. Podczas tworzenia klienta tego typu ustaw customerType na domain.
  • Klienci weryfikowani za pomocą adresu e-mail. Tacy klienci nie są właścicielami domeny ani nie zarządzają nią. Gdy tworzysz tego typu klienta, ustaw customerType na team. Tacy klienci mogą kupić Google Workspace w wersji Essentials i Enterprise Essentials.

Następująca treść żądania JSON to przykład klienta ze zweryfikowanym domeną:

{
  "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, na przykład example.com
  • NAME: nazwa klienta, na przykład Alex Cruz.
  • ORGANIZATION_NAME: nazwa organizacji klienta, na przykład Example Organization.
  • POSTAL_CODE: kod pocztowy klienta, np. 94043.
  • COUNTRY_CODE: dwuznakowy kod ISO kraju 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"
}

Następująca 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 kont użytkowników tylko podczas ich tworzenia. Istniejący użytkownicy zachowują obecny język nawet po zaktualizowaniu domyślnego języka. 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ć domyślny język, użyj wywołań PATCH lub UPDATE z punktu końcowego interfejsu Directory API dla klientów.

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 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