Przed utworzeniem nowego konta klienta weź pod uwagę te kwestie:
- Mogą obowiązywać ograniczenia związane z kodem kraju. Aby sprawdzić, czy kraj klienta jest zatwierdzony do sprzedaży, otwórz konsolę sprzedaży partnerskiej.
- Jeśli konto zostanie utworzone przez przejście z konta Gmail dla użytkowników indywidualnych na firmowe konto e-mail z nazwą domeny, sprawdź, czy są na nim odblokowane dodatkowe ustawienia Google Workspace. Więcej informacji znajdziesz w artykułach Tworzenie firmowych kont e-mail dla zespołu i Tworzenie aliasu firmowego konta e-mail.
Tworzenie konta klienta
Aby utworzyć konto klienta, użyj tego żądania
POST
i dołącz token autoryzacji:POST https://reseller.googleapis.com/apps/reseller/v1/customers
Na koncie nowego klienta utwórz konto użytkownika. Jeśli odpowiedź zwraca kod stanu HTTP
409 Conflict
, elementcustomerId
już istnieje. Zanim zarejestrujesz konto klienta, musisz przenieść jego subskrypcje.W razie potrzeby zmień domyślny język klienta.
Zmień rolę użytkownika na superadministratora. Podczas tworzenia konta administratora możesz wygenerować tymczasowe hasło losowe lub poprosić klienta o podanie hasła.
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
nadomain
. - 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
nateam
. 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ładexample.com
NAME
: nazwa klienta, na przykładAlex Cruz
.ORGANIZATION_NAME
: nazwa organizacji klienta, np.Example Organization
.POSTAL_CODE
: kod pocztowy Twojego klienta, na przykład94043
.COUNTRY_CODE
: kod ISO kraju klienta składający się z 2 znaków.EMAIL_ADDRESS
: adres e-mail klienta – na przykładcruz@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łades
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" } }