電話番号の確認は、販売者アカウントの電話番号を追加して確認するために使用できる 2 つの Accounts メソッドで構成されています。電話番号確認で送信された電話番号は、accounts.AccountBusinessInformation で送信された電話番号に置き換わります。
電話による確認は、新規および既存のすべての販売者に対して強く推奨されます。電話番号を確認するまで、アカウントは アカウント ステータスの問題 PENDING_PHONE_VERIFICATION により一時停止されることがあります。
電話番号を確認するには、次の 2 つの手順が必要です。
accounts.requestphoneverificationを呼び出して、電話確認リクエストを開始します。- 2 文字の地域コードを入力します。
- 電話番号を入力します。
- 確認方法（
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