This is legacy documentation, and may not be complete. To see the latest documentation, if you are a marketer, refer to the Marketers site. If you are a measurement partner, refer to the Measurement Partners site.
Required. DV360 Partner ID whose Advertiser Ids are requested e.g. 1234 Note that this partner must be linked to the ADH customer speciified by adsDataCustomerId
pageSize
integer
Maximum number of items to return. If 0, the server will determine the number of linked customers to return.
pageToken
string
Page token, returned by a previous call, used to request the next page of results, if any.
Response body
Response to DescribeValidDV360AdvertiserIdsRequest
If successful, the response body contains data with the following structure:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-09-18 UTC."],[[["\u003cp\u003eDescribes valid DV360 Advertiser IDs for a given Ads Data Hub customer and DV360 partner.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires Ads Data Hub customer ID, DV360 partner ID, and optional pagination parameters.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes a list of entities, each representing a DV360 Advertiser, and a token for pagination.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/adsdatahub\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This content outlines the process to retrieve valid DV360 Advertiser IDs. A `POST` request is sent to the specified URL, including the required customer resource name as a path parameter. The request body must include the Ads Data customer ID, DV360 Partner ID, and optional page size and page token. The response contains a list of `entities`, each representing a DV360 Advertiser, along with a `nextPageToken` for pagination. Authorization requires the `https://www.googleapis.com/auth/adsdatahub` OAuth scope.\n"],null,["# Method: customers.describeValidDv360AdvertiserIds\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.DescribeValidDv360AdvertiserIdsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n\nDescribes the valid DV360 AdvertiserIds\n\n### HTTP request\n\n`POST https://adsdatahub.googleapis.com/v1/{customer=customers/*}:describeValidDv360AdvertiserIds`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|------------------------------------------------------------------|\n| `customer` | `string` Required. Customer resource name, e.g. 'customers/123'. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------|\n| ``` { \"adsDataCustomerId\": string, \"dv360PartnerId\": string, \"pageSize\": integer, \"pageToken\": string } ``` |\n\n| Fields ||\n|---------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `adsDataCustomerId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. Ads Data Owning customer's ID, e.g. 456. |\n| `dv360PartnerId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. DV360 Partner ID whose Advertiser Ids are requested e.g. 1234 Note that this partner must be linked to the ADH customer speciified by adsDataCustomerId |\n| `pageSize` | `integer` Maximum number of items to return. If 0, the server will determine the number of linked customers to return. |\n| `pageToken` | `string` Page token, returned by a previous call, used to request the next page of results, if any. |\n\n### Response body\n\nResponse to DescribeValidDV360AdvertiserIdsRequest\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"entities\": [ { object (/ads-data-hub/reference/rest/v1/customers.adsDataLinks#Entity) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------|\n| `entities[]` | `object (`[Entity](/ads-data-hub/reference/rest/v1/customers.adsDataLinks#Entity)`)` List of entities, each describing a DV360 Advertiser |\n| `nextPageToken` | `string` A token that can be used to request the next results page. This field is empty if there are no additional results. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/adsdatahub`"]]