rocket
Meet
Merchant API
- the official successor to Content API for Shopping.
update
Get the latest
on new Merchant API features, bug fixes, and updates.
add_alert
Note: Content API for Shopping will be sunset on August 18, 2026.
Method: accounts.requestphoneverification
Stay organized with collections
Save and categorize content based on your preferences.
Request verification code to start phone verification.
HTTP request
POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/requestphoneverification
Path parameters
Parameters |
merchantId |
string (int64 format)
Required. The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account.
|
accountId |
string (int64 format)
Required. The ID of the account.
|
Request body
The request body contains data with the following structure:
JSON representation |
{
"phoneRegionCode": string,
"phoneNumber": string,
"phoneVerificationMethod": enum (PhoneVerificationMethod ),
"languageCode": string
} |
Fields |
phoneRegionCode |
string
Required. Two letter country code for the phone number, for example CA for Canadian numbers. See the ISO 3166-1 alpha-2 officially assigned codes.
|
phoneNumber |
string
Phone number to be verified.
|
phoneVerificationMethod |
enum (PhoneVerificationMethod )
Verification method to receive verification code.
|
languageCode |
string
Language code IETF BCP 47 syntax (for example, en-US). Language code is used to provide localized SMS and PHONE_CALL . Default language used is en-US if not provided.
|
Response body
Response message for the accounts.requestphoneverification method.
If successful, the response body contains data with the following structure:
JSON representation |
{
"verificationId": string
} |
Fields |
verificationId |
string
The verification ID to use in subsequent calls to verifyphonenumber .
|
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/content
For more information, see the OAuth 2.0 Overview.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-02-25 UTC.
[null,null,["Last updated 2025-02-25 UTC."],[[["\u003cp\u003eThis page details how to request a phone verification code via the \u003ccode\u003eaccounts.requestphoneverification\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires specifying the phone number, region code, verification method, and optionally, the language code.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful requests will return a \u003ccode\u003everificationId\u003c/code\u003e to be used in subsequent verification steps.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is necessary using the \u003ccode\u003ehttps://www.googleapis.com/auth/content\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eThis process is part of the Shopping Content API for managing Merchant Center accounts.\u003c/p\u003e\n"]]],["This document details the process for requesting a phone verification code. A `POST` request is sent to a specified URL with `merchantId` and `accountId` as required path parameters. The request body, in JSON format, includes the `phoneRegionCode`, `phoneNumber`, `phoneVerificationMethod`, and optional `languageCode`. A successful response contains a `verificationId`, which is used for subsequent phone number verification. Authorization requires the `https://www.googleapis.com/auth/content` OAuth scope.\n"],null,["# Method: accounts.requestphoneverification\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.RequestPhoneVerificationResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nRequest verification code to start phone verification.\n\n### HTTP request\n\n`POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/requestphoneverification`\n\n### Path parameters\n\n| Parameters ||\n|--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `merchantId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account. |\n| `accountId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the account. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"phoneRegionCode\": string, \"phoneNumber\": string, \"phoneVerificationMethod\": enum (/shopping-content/reference/rest/v2.1/PhoneVerificationMethod), \"languageCode\": string } ``` |\n\n| Fields ||\n|---------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `phoneRegionCode` | `string` Required. Two letter country code for the phone number, for example `CA` for Canadian numbers. See the [ISO 3166-1 alpha-2](https://wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) officially assigned codes. |\n| `phoneNumber` | `string` Phone number to be verified. |\n| `phoneVerificationMethod` | `enum (`[PhoneVerificationMethod](/shopping-content/reference/rest/v2.1/PhoneVerificationMethod)`)` Verification method to receive verification code. |\n| `languageCode` | `string` Language code [IETF BCP 47 syntax](https://tools.ietf.org/html/bcp47) (for example, en-US). Language code is used to provide localized `SMS` and `PHONE_CALL`. Default language used is en-US if not provided. |\n\n### Response body\n\nResponse message for the accounts.requestphoneverification method.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------|\n| ``` { \"verificationId\": string } ``` |\n\n| Fields ||\n|------------------|---------------------------------------------------------------------------------|\n| `verificationId` | `string` The verification ID to use in subsequent calls to `verifyphonenumber`. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/content`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]