Version v2 of the Content API is scheduled for sunset on September 30th, 2021. Onboarding to v2 ended on April 30, 2021. To avoid disruptions with your integration, please migrate to v2.1 as soon as possible.

For more information, see Migrating to v2.1 and this blog post.

Account Phone Verification

Phone Verification consists of two Accounts methods that let you add and verify phone numbers for a merchant account. Phone numbers submitted through Phone Verification replace phone numbers you may have submitted through accounts.accountbusinessinformation.

There are two required steps to verify a phone number:

  1. Call accounts.requestphoneverification to start a phone verification request.
    Enter your two-letter region code.
    Enter your phone number.
    Choose a verification method (SMS or PHONE_CALL).
  2. Call accounts.verifyphonenumber to verify the phone number.
    Enter the verificationId from Step 1.
    Enter the 6 digit verificationCode sent to your phone.
    Enter the phoneVerificationMethod used.
    This call returns a verifiedPhoneNumber. This phone number is now verified.

requestphoneverification

Start the phone number verification process by passing the phoneRegionCode, phoneNumber and phoneVerificationMethod into accounts.requestphoneverification. This call returns averificationId.

You can use the optional languageCode field to verify in a language other than the default (US English).

You can try to verify the same phone number a maximum of five times every four hours.

POST https://www.googleapis.com/content/v2.1/merchantId/accounts/accountId/requestphoneverification

Here's a sample call:

{
  "phoneRegionCode": "US",
  "phoneNumber": "phoneNumber",
  "phoneVerificationMethod": "SMS",
  "languageCode": "en-US"
}

Here's a sample response:

{
  "verificationId": "2-47b7ef80ff494daf8079f4808e750dcb-1626331725036"
}

verifyphonenumber

Verify the phone number for the account by passing the verificationId from accounts.requestphoneverification, the six-digit verificationCode sent to your phone, and the phoneVerificationMethod you used, for example SMS, into accounts.verifyphonenumber. This call returns the verified phone number in a standard fomat for your region.

POST https://www.googleapis.com/content/v2.1/merchantId/accounts/accountId/verifyphonenumber

Here's a sample call:

{
  "verificationId": "verificationId",
  "verificationCode": "verificationCode",
  "phoneVerificationMethod": "SMS"
}

Here's a sample response:

{
  "verifiedPhoneNumber": "(123) 456-7890"
}