电话验证包括两种帐号方法,可用于为商家帐号添加和验证电话号码。通过电话验证提交的电话号码会取代您通过 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
、发送到您手机的六位数 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