Получить и усилить; обновить информацию об учетной записи клиента

Чтобы получить и обновить информацию о клиенте с помощью API реселлера, у вас есть два способа поиска информации о клиенте:

• Уникальный идентификатор клиента — например, C0123456
• Доменное имя клиента — например, example.com

Получить информацию об учетной записи клиента

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

GET https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID

Замените CUSTOMER_ID на уникальный идентификатор вашего клиента или доменное имя.

Ответ возвращается

При получении информации об учетной записи клиента вы можете получить один из следующих ответов:

• Возвращает полные настройки клиента. Этот клиент — один из ваших существующих клиентов. Используя Reseller API, вы можете управлять настройками учётной записи и подписки этого клиента.

• Возвращает минимальную информацию об учётной записи клиента. Если ответ возвращает только customerId , customerDomain и customerType , клиентом управляет либо Google, либо другой реселлер. Вы не можете создать для этого клиента ещё одного клиента с подтверждённым адресом электронной почты. Чтобы управлять этим клиентом, выполните следующие действия:

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

• Возвращает: Multiple teams exist on this domain . С этим доменом связаны один или несколько клиентов команды. Чтобы добавить в этот домен ещё одну команду, выполните следующие действия:

  1. Заказать счет клиента .
  2. Чтобы создать клиента с подтвержденным доменом, попросите его приобрести прямую подписку через Google и подтвердить свой домен, взять на себя управление существующими командами , а затем перенести подписку на вашу учетную запись .

• Возвращает ошибку HTTP 404 Клиент — новый пользователь Google и у него нет учётной записи. Чтобы управлять этим клиентом, выполните следующие действия:

  1. Убедитесь, что в ваших записях о клиентах не хранятся старые данные с возможным несовпадением основного доменного имени клиента и уникального идентификатора клиента Google. При восстановлении ранее удалённого аккаунта Google он рассматривается как новый и имеет новое значение customerId , даже если у него сохраняется прежнее значение customerDomain .
  2. Заказать новый клиентский аккаунт .
  3. Создайте подписку для этой новой учетной записи клиента.

Обновить настройки клиента

Используя API реселлера, вы не сможете обновить customerType , но вы можете проверить домен клиента team и стать клиентом domain .

Чтобы обновить настройки клиента, используйте следующий запрос PUT и включите уникальный идентификатор вашего клиента:

PUT https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID

Тело запроса JSON обновляет следующие настройки клиента:

{
  "customerId": "C0CUSTOMER_ID123456",
  "customerDomain": "DOMAIN_NAME",
  "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 : адрес электронной почты вашего клиента, например, [e-mail] .

Успешный ответ JSON возвращает код статуса HTTP 200 и обновленные настройки клиента:

{
  "kind": "reseller#customer",
  "customerId": "CUSTOMER_ID",
  "customerDomain": "DOMAIN_NAME",
  "postalAddress": {
    "kind": "customers#address",
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE",
  },
  "alternateEmail": "EMAIL_ADDRESS"
}