电话号码验证包含两种账号方法,您可以使用这些方法为商家账号添加和验证电话号码。通过电话验证提交的电话号码会取代您可能通过 accounts.AccountBusinessInformation
提交的电话号码。
我们强烈建议所有新商家和现有商家完成电话验证。否则,您的账号可能会被中止,并出现账号状态问题 PENDING_PHONE_VERIFICATION
,直到您验证电话号码。
验证电话号码需要完成以下两个步骤:
- 调用
accounts.requestphoneverification
以发起电话验证请求。 - 输入您的双字母地区代码。
- 输入您的电话号码。
- 选择验证方法(
SMS
或PHONE_CALL
)。
- 调用
- 请拨打
accounts.verifyphonenumber
验证电话号码。 - 输入第 1 步中的
verificationId
。 - 输入发送到您手机的 6 位数
verificationCode
。 - 输入所用的
phoneVerificationMethod
。 - 此调用会返回
verifiedPhoneNumber
。此电话号码现已通过验证。
- 请拨打
您可以在 AccountBusinessInformation.phoneVerificationStatus
中查看账号的电话号码验证状态。
accounts.requestphoneverification
将 phoneRegionCode
、phoneNumber
和 phoneVerificationMethod
传入 accounts.requestphoneverification
以启动电话号码验证流程。此调用会返回 verificationId
。
您可以使用可选的 languageCode
字段以默认语言(美国英语)以外的语言进行验证。
每 4 小时内,您最多只能尝试验证同一电话号码 5 次。
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" }
accounts.verifyphonenumber
将 accounts.requestphoneverification
中的 verificationId
、发送到您手机的 6 位数 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": "(123) 456-7890" }
AccountBusinessInformation.phoneVerificationStatus
您可以在 AccountBusinessInformation.phoneVerificationStatus
字段中查看账号的电话验证状态。
使用 accountId
和 merchantId
调用 accounts.get
方法,以查看账号的商家信息:
GET https://www.googleapis.com/content/v2.1/v2.1/merchantId/accounts/accountId