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, oznacza to, że 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 hasło lub poprosić klienta o jego podanie.

  5. Powiadom klienta, że musi zalogować się w konsoli administracyjnej i podpisać umowę Google Workspace za pomocą sprzedawcy, aby aktywować konto. Sprzedawcy nie mogą podpisywać w imieniu klienta Warunków korzystania z usługi.

Typy klientów

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

  • Klienci z potwierdzoną własnością domeny. Tacy klienci potrzebują Gmaila i potrzebują 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 ani nie zarządzają swoją domeną. Podczas tworzenia klienta tego typu ustaw customerType na team. Klienci tego typu mogą kupić wersje Essentials i Enterprise Essentials w ramach Google Workspace.

Ten przykładowy kod JSON to przykład 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 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, na przykład 94043.
  • COUNTRY_CODE: dwuznakowy kod kraju ISO klienta.
  • 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"
}

Ten tekst żądania JSON to przykład klienta weryfikowanego 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 tylko do nowych użytkowników podczas jego tworzenia. Dotychczasowi użytkownicy zachowają bieżący język, nawet jeśli zaktualizujesz język domyślny. W związku z tym 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ń punktu końcowego PATCH lub UPDATE interfejsu Directory API Klienci.

Przy użyciu interfejsu Directory API zaktualizuj 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, na przykład C0123456.
  • LANGUAGE_CODE: akceptowany kod języka, np. es w przypadku 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