電話による確認には、販売アカウントの電話番号の追加と確認に使用できる 2 つのアカウント メソッドがあります。電話確認を通じて送信された電話番号は、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