Заказать новую учетную запись клиента

Перед созданием новой учетной записи клиента обратите внимание на следующее:

Создать учетную запись клиента

  1. Для создания учетной записи клиента используйте следующий POST запрос и укажите токен авторизации:

    POST https://reseller.googleapis.com/apps/reseller/v1/customers

  2. В учетной записи нового клиента создайте пользователя . Если в ответе возвращается код состояния HTTP 409 Conflict , значит, customerId уже существует. Перед регистрацией учетной записи клиента необходимо перенести его подписки .

  3. При необходимости измените язык по умолчанию для клиента .

  4. Повысьте права пользователя до роли суперадминистратора . При создании учетной записи администратора вы можете либо сгенерировать временный случайный пароль, либо предложить клиенту ввести пароль.

  5. Уведомите клиента о том, что для активации своей учетной записи ему необходимо войти в консоль администратора Google и подписать соглашение Google Workspace, используя права реселлера. Реселлерам запрещено подписывать Условия предоставления услуг от имени клиента.

Типы клиентов

В Google Workspace можно создать два типа клиентов:

  • Клиенты с подтвержденным доменом : этим клиентам необходимы учетная запись Gmail и полные права администратора. При создании такого типа клиента установите для customerType domain .
  • Клиенты с подтвержденным адресом электронной почты : Эти клиенты не владеют своим доменом и не управляют им. При создании такого типа клиента установите для customerType team . Эти клиенты могут приобрести версии Google Workspace Essentials и Google Workspace Enterprise Essentials .

Приведенный ниже JSON-запрос является примером запроса от клиента, прошедшего проверку домена:

{
  "customerDomain": "DOMAIN_NAME",
  "customerType": "domain",
  "postalAddress": {
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE"
  },
  "alternateEmail": "EMAIL_ADDRESS"
}

Замените следующее:

  • DOMAIN_NAME : Домен клиента — например, example.com .
  • NAME : Имя клиента — например, Alex Cruz .
  • ORGANIZATION_NAME : Название организации клиента — например, Example Organization .
  • POSTAL_CODE : Почтовый индекс клиента — например, 94043 .
  • COUNTRY_CODE : Двухсимвольный код страны ISO клиента.
  • EMAIL_ADDRESS : Адрес электронной почты клиента — например, cruz@example.com .

В случае успешного ответа возвращается код состояния HTTP 200 и информация о новом клиенте:

{
  "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"
}

Приведенный ниже JSON-запрос является примером запроса от клиента, подтвердившего свой адрес электронной почты:

{
  "customerDomain": "DOMAIN_NAME",
  "customerType": "team",
  "primaryAdmin": {
    "primaryEmail": "EMAIL_ADDRESS"
  },
  "postalAddress": {
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE"
  },
 "alternateEmail": "EMAIL_ADDRESS"
}

В случае успешного ответа возвращается код состояния HTTP 200 и информация о новом клиенте:

{
  "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"
}

Изменить язык по умолчанию для клиента

Язык по умолчанию для клиента применяется только к новым пользователям. Существующие пользователи сохраняют свой язык после обновления языка по умолчанию. Поэтому установите язык по умолчанию для клиента до создания новых пользователей.

Для новых клиентов по умолчанию установлен английский язык. Чтобы изменить язык по умолчанию, используйте методы PATCH или UPDATE из конечной точки Directory API Customers .

Используйте API каталога для обновления значения language по умолчанию для клиента:

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

Включите в запрос следующий JSON-объект:

{
  "language":"LANGUAGE_CODE"
}

Замените следующее:

  • CUSTOMER_ID : Уникальный идентификатор клиента — например, C0123456 .
  • LANGUAGE_CODE : Допустимый код языка — например, es для испанского.

В случае успешного ответа в формате JSON возвращается код состояния HTTP 200 и обновленный ресурс клиента:

{
  "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"
  }
}

Следующие шаги