電話驗證

電話驗證包含兩種帳戶方法，可用於新增及驗證商家帳戶的電話號碼。透過電話驗證功能提交的電話號碼，會取代您可能透過 accounts.AccountBusinessInformation 提交的電話號碼。

強烈建議所有新舊商家進行電話驗證。否則，您的帳戶可能會遭到停權，帳戶狀態會顯示為 PENDING_PHONE_VERIFICATION，直到您驗證電話號碼為止。

驗證電話號碼需要完成兩個步驟：

  1. 撥打 accounts.requestphoneverification 即可開始電話驗證要求。
    輸入兩個字母區域代碼。
    輸入電話號碼。
    選擇驗證方法 (SMS 或 PHONE_CALL)。
  2. 撥打 accounts.verifyphonenumber 驗證電話號碼。
    請輸入步驟 1 中的 verificationId。
    請輸入傳送至手機的 6 位數 verificationCode。
    輸入所用的 phoneVerificationMethod。
    這個呼叫會傳回 verifiedPhoneNumber。這個電話號碼已通過驗證。

您可以在 AccountBusinessInformation.phoneVerificationStatus 中查看帳戶電話驗證狀態。

accounts.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"
}

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