电话验证

电话验证由两种帐号方法组成,您可以使用这些方法为商家帐号添加和验证电话号码。通过电话验证提交的电话号码会替换您可能通过 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