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

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

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

  1. Чтобы создать учетную запись клиента, используйте следующий запрос POST и включите токен авторизации:

    POST https://reseller.googleapis.com/apps/reseller/v1/customers
    
  2. В учетной записи нового клиента создайте пользователя . Если ответ возвращает код состояния 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"
  }
}

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