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: liasettings.requestgmbaccess
Stay organized with collections
Save and categorize content based on your preferences.
Requests access to a specified Business Profile.
HTTP request
POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/liasettings/{accountId}/requestgmbaccess
Path parameters
| Parameters |
merchantId |
string
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
The ID of the account for which Business Profile access is requested.
|
Query parameters
| Parameters |
gmbEmail |
string
The email of the Business Profile.
|
Request body
The request body must be empty.
Response body
If successful, the response body contains data with the following structure:
| JSON representation |
{
"kind": string
} |
| Fields |
kind |
string
Identifies what kind of resource this is. Value: the fixed string "content#liasettingsRequestGmbAccessResponse".
|
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 guide explains how to request access to a specified Business Profile using the \u003ccode\u003erequestgmbaccess\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eThe request is sent as an HTTP POST to a specific endpoint, including merchant and account IDs in the path.\u003c/p\u003e\n"],["\u003cp\u003eYou'll need to provide the Business Profile's email as a query parameter and leave the request body empty.\u003c/p\u003e\n"],["\u003cp\u003eA successful response will confirm the request with a specific JSON structure including a \u003ccode\u003ekind\u003c/code\u003e field.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires using the \u003ccode\u003ehttps://www.googleapis.com/auth/content\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["The core content outlines a process to request Business Profile access via an HTTP POST request to a specified endpoint. This request uses `merchantId` and `accountId` as path parameters, and `gmbEmail` as a query parameter. The request body should be empty. A successful response will include a JSON object with a `kind` field identifying the response type. This action requires the `https://www.googleapis.com/auth/content` authorization scope.\n"],null,["# Method: liasettings.requestgmbaccess\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.LiasettingsRequestGmbAccessResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nRequests access to a specified Business Profile.\n\n### HTTP request\n\n`POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/liasettings/{accountId}/requestgmbaccess`\n\n### Path parameters\n\n| Parameters ||\n|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `merchantId` | `string` The ID of the managing account. If this parameter is not the same as [accountId](#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` The ID of the account for which Business Profile access is requested. |\n\n### Query parameters\n\n| Parameters ||\n|------------|---------------------------------------------|\n| `gmbEmail` | `string` The email of the Business Profile. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------|\n| ``` { \"kind\": string } ``` |\n\n| Fields ||\n|--------|-----------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Identifies what kind of resource this is. Value: the fixed string \"`content#liasettingsRequestGmbAccessResponse`\". |\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)."]]