Method: platforms.accounts.lookup
Stay organized with collections
Save and categorize content based on your preferences.
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-07-04 UTC.
[null,null,["Last updated 2025-07-04 UTC."],[[["\u003cp\u003eThis documentation details the process for looking up information about a sub-account using the \u003ccode\u003elookup\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eThe request is made using an HTTP GET request with specific path and optional query parameters.\u003c/p\u003e\n"],["\u003cp\u003eAn empty request body is required, and the response provides the sub-account's name if found, otherwise returning a 404 error.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is necessary using specific OAuth scopes for either read or read-write access.\u003c/p\u003e\n"]]],["This document details the process for looking up a sub-account. A `GET` request is sent to `https://adsenseplatform.googleapis.com/v1/{parent=platforms/*}/accounts:lookup`. The required `parent` path parameter specifies the platform. An optional `creationRequestId` query parameter identifies the account. The request body is empty. A successful response returns a JSON object containing the `name` of the account, formatted as `platforms/{platform}/accounts/{account_id}`. Authorization requires either the `adsense` or `adsense.readonly` OAuth scope. A 404 error is returned if the account does not exist.\n"],null,["# Method: platforms.accounts.lookup\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.LookupAccountResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLooks up information about a sub-account for a specified creationRequestId. If no account exists for the given creationRequestId, returns 404.\n\n### HTTP request\n\n`GET https://adsenseplatform.googleapis.com/v1/{parent=platforms/*}/accounts:lookup`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-----------------------------------------------------------------------------------|\n| `parent` | `string` Required. Platform who parents the account. Format: platforms/{platform} |\n\n### Query parameters\n\n| Parameters ||\n|---------------------|-------------------------------------------------------------------------------|\n| `creationRequestId` | `string` Optional. The creationRequestId provided when calling createAccount. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse definition for the lookup account rpc.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------|\n| ``` { \"name\": string } ``` |\n\n| Fields ||\n|--------|-------------------------------------------------------------------------------------|\n| `name` | `string` The name of the Account Format: platforms/{platform}/accounts/{account_id} |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/adsense`\n- `\n https://www.googleapis.com/auth/adsense.readonly`"]]
