电话验证

电话验证包括两种帐号方法,可用于为商家帐号添加和验证电话号码。通过电话验证提交的电话号码会取代您通过 accounts.AccountBusinessInformation 提交的电话号码。

强烈建议所有新商家和现有商家进行电话验证。除非您验证了电话号码,否则您的帐号可能会被暂停,并且帐号状态会显示 PENDING_PHONE_VERIFICATION 问题。

要验证电话号码,您有两个必需步骤:

  1. 调用 accounts.requestphoneverification 以开始电话验证请求。
    输入由两个字母组成的区域代码
    输入您的电话号码。
    选择验证方法(SMSPHONE_CALL)。
  2. 致电 accounts.verifyphonenumber 以验证电话号码。
    输入第 1 步中的 verificationId
    输入发送到您手机上的 6 位数 verificationCode
    输入使用的 phoneVerificationMethod
    此调用会返回 verifiedPhoneNumber。此电话号码现已通过验证。

您可以在 AccountBusinessInformation.phoneVerificationStatus 中查看帐号的电话验证状态。

accounts.requestphoneverification

phoneRegionCodephoneNumberphoneVerificationMethod 传递到 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 字段中查看帐号的电话验证状态。

使用 accountIdmerchantId 调用 accounts.get 方法,以查看您帐号的商家信息

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