電話による確認は、販売アカウントの電話番号の追加と確認に使用できる 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 フィールドで確認できます。
accounts.get メソッドを accountId と merchantId を指定して呼び出し、アカウントのビジネス情報を表示します。
GET https://www.googleapis.com/content/v2.1/v2.1/merchantId/accounts/accountId