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