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

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

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

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

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

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

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

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

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

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

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

  • Клиенты, прошедшие проверку домена . Эти клиенты должны иметь доступ к Gmail и полные права администратора. При создании такого типа клиента установите для customerType domain .
  • Клиенты с подтвержденным адресом электронной почты . Эти клиенты не владеют своим доменом и не управляют им. При создании такого типа клиента установите для customerType team . Такие клиенты могут приобрести версии Google Workspace Essentials и 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"
  }
}

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