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, 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. Przyznaj 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 aby aktywować 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.

Rodzaje klientów

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

  • Klienci z potwierdzoną domeną Ci klienci potrzebują Gmaila i pełnego dostępu administratora. Podczas tworzenia tego typu klienta ustaw wartość 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. Tacy klienci mogą kupić wersje Google Workspace Essentials i Enterprise Essentials.

Poniżej znajdziesz przykładową treść żą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 klienta zgodny z normą ISO.
  • EMAIL_ADDRESS: adres e-mail klienta, np. cruz@example.com.

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

Odpowiedź zakończona powodzeniem 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 tylko w przypadku nowych użytkowników w momencie ich tworzenia. Dotychczasowi użytkownicy zachowają swój obecny 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ślny język angielski. Aby zmienić język domyślny, użyj wywołań PATCH lub UPDATE z interfejsu Directory API w punkcie końcowym Customers.

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

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.

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