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 how to look up information about a sub-account using the \u003ccode\u003elookupAccount\u003c/code\u003e RPC.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires specifying the parent platform and optionally a \u003ccode\u003ecreationRequestId\u003c/code\u003e as parameters.\u003c/p\u003e\n"],["\u003cp\u003eIf successful, the response provides the name of the account in the specified format.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is required using specific OAuth scopes, including 'adsense' or 'adsense.readonly'.\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/v1alpha/{parent=platforms/*}/accounts:lookup`. The `parent` path parameter specifies the platform. An optional `creationRequestId` query parameter is used to find specific sub accounts. The request body must be empty. A successful response includes a JSON body with the sub-account's `name`, using the format `platforms/{platform}/accounts/{account_id}`. Authorization requires either `adsense` or `adsense.readonly` OAuth scopes.\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/v1alpha/{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`"]]
