Проверка телефона

Мы хотели бы представить бета-версию Merchant API . Это новая версия Content API для покупок и будущего.

Информацию о том, как Merchant API может улучшить вашу интеграцию и как вы можете помочь сформировать будущее, см. в разделе «Анонс бета-версии Merchant API» .

Устарело: проверка номера телефона больше не требуется, и мы рекомендуем вам не использовать эту функцию. Эта функция не будет доступна в Merchant API, и мы рекомендуем заранее спланировать это изменение.

Проверка телефона состоит из двух методов учетных записей , которые вы можете использовать для добавления и проверки номеров телефонов для учетной записи продавца. Номера телефонов, отправленные через проверку телефона, заменяют номера телефонов, которые вы, возможно, отправили через accounts.AccountBusinessInformation .

Проверка телефона настоятельно рекомендуется всем новым и существующим продавцам. В противном случае ваша учетная запись может быть заблокирована из-за проблемы со статусом учетной записи PENDING_PHONE_VERIFICATION пока вы не подтвердите номер телефона.

Чтобы подтвердить номер телефона, необходимо выполнить два шага:

1. accounts.requestphoneverification , чтобы отправить запрос на проверку телефона.

   Введите двухбуквенный код региона .

   Введите свой номер телефона.

   Выберите способ подтверждения ( SMS или PHONE_CALL ).

2. Вызовите accounts.verifyphonenumber чтобы подтвердить номер телефона.

   Введите verificationId из шага 1.

   Введите 6-значный verificationCode отправленный на ваш телефон.

   Введите используемый метод phoneVerificationMethod .

   Этот вызов возвращает verifiedPhoneNumber номер телефона. Этот номер телефона теперь подтвержден.

Вы можете проверить статус проверки телефона вашей учетной записи в AccountBusinessInformation.phoneVerificationStatus .

account.requestphoneverification

Запустите процесс проверки номера телефона, передав phoneRegionCode , phoneNumber и phoneVerificationMethod accounts.requestphoneverification . Этот вызов возвращает verificationId .

Вы можете использовать необязательное поле languageCode для подтверждения на языке, отличном от языка по умолчанию (английский (США).

Вы можете попытаться подтвердить один и тот же номер телефона максимум пять раз каждые четыре часа.

POST https://www.googleapis.com/content/v2.1/merchantId/accounts/accountId/requestphoneverification

Вот пример звонка:

{
  "phoneRegionCode": "US",
  "phoneNumber": "phoneNumber",
  "phoneVerificationMethod": "SMS",
  "languageCode": "en-US"
}

Вот пример ответа:

{
  "verificationId": "2-47b7ef80ff494daf8079f4808e750dcb-1626331725036"
}

Важно! В ходе этого звонка на ваш номер телефона также будет отправлен код подтверждения. Этот код понадобится вам для следующего шага.

account.verifyphonenumber

Подтвердите номер телефона учетной записи, передав verificationId accounts.requestphoneverification , шестизначный verificationCode отправленный на ваш телефон, и использованный вами phoneVerificationMethod , например SMS , accounts.verifyphonenumber . Этот вызов возвращает подтвержденный номер телефона в стандартном для вашего региона формате.

Срок действия вашего первоначального запроса на проверку истекает через 15 минут. После этого вам необходимо инициировать новый запрос на проверку телефона, прежде чем звонить по accounts.verifyphonenumber .

POST https://www.googleapis.com/content/v2.1/merchantId/accounts/accountId/verifyphonenumber

Вот пример звонка:

{
  "verificationId": "verificationId",
  "verificationCode": "verificationCode",
  "phoneVerificationMethod": "SMS"
}

Вот пример ответа:

{
  "verifiedPhoneNumber": "[phone]"
}

AccountBusinessInformation.phoneVerificationStatus

Вы можете проверить статус проверки телефона вашей учетной записи в поле AccountBusinessInformation.phoneVerificationStatus .

Вызовите метод accounts.get с идентификаторами accountId и merchantId чтобы просмотреть бизнес-информацию вашей учетной записи:

GET https://www.googleapis.com/content/v2.1/v2.1/merchantId/accounts/accountId