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

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

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

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

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