Starts the execution of a query to retrieve invalid traffic viewability metrics for the DV360 platform. The results will be written to the specified BigQuery destination table. The returned operation name can be used to poll for query completion status.
HTTP request
POST https://adsdatahub.googleapis.com/v1/{customer=customers/*}:generateDv360IvtVideoViewabilityReport
Destination BigQuery table for query results with the format 'project.dataset.table_name'. If specified, the project must be explicitly whitelisted for the customer's ADH account. If project is not specified, uses default project for the provided customer. If neither project nor dataset is specified, uses the default project and dataset.
Response body
If successful, the response body contains an instance of Operation.
[[["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\u003eStarts the execution of a query to retrieve invalid traffic viewability metrics for the DV360 platform and writes results to a specified BigQuery destination table.\u003c/p\u003e\n"],["\u003cp\u003eThe request body requires specifying the Ads Data Hub customer ID, start and end dates, time zone, line item IDs, and the destination BigQuery table.\u003c/p\u003e\n"],["\u003cp\u003eUsers can poll for query completion status using the returned operation name.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/adsdatahub\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This outlines how to initiate a query for DV360 invalid traffic viewability metrics. A `POST` request is sent to `https://adsdatahub.googleapis.com/v1/{customer=customers/*}:generateDv360IvtVideoViewabilityReport`. The request body specifies parameters like `adsDataCustomerId`, `startDate`, `endDate`, `timeZone`, `lineItemIds`, and `destTable` for BigQuery output. A successful query returns an `Operation` instance, and the request requires the `https://www.googleapis.com/auth/adsdatahub` OAuth scope.\n"],null,["# Method: customers.generateDv360IvtVideoViewabilityReport\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- [Authorization scopes](#body.aspect)\n\nStarts the execution of a query to retrieve invalid traffic viewability metrics for the DV360 platform. The results will be written to the specified BigQuery destination table. The returned operation name can be used to poll for query completion status.\n\n### HTTP request\n\n`POST https://adsdatahub.googleapis.com/v1/{customer=customers/*}:generateDv360IvtVideoViewabilityReport`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|-----------------------------------------------------------------------------------------------------------------------------|\n| `customer` | `string` Ads Data Hub customer making the request. This is in the form of 'customers/\\[customerId\\]'. 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, \"startDate\": { object (/ads-data-hub/marketers/reference/rest/v1/Date) }, \"endDate\": { object (/ads-data-hub/marketers/reference/rest/v1/Date) }, \"timeZone\": string, \"lineItemIds\": [ string ], \"destTable\": string } ``` |\n\n| Fields ||\n|---------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `adsDataCustomerId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Linked Ads Data Hub customer ID that owns the ads data. |\n| `startDate` | `object (`[Date](/ads-data-hub/marketers/reference/rest/v1/Date)`)` The first day of the generated report. |\n| `endDate` | `object (`[Date](/ads-data-hub/marketers/reference/rest/v1/Date)`)` The last day of the generated report, inclusive. |\n| `timeZone` | `string` The time zone for the report start and end dates. If not specified, defaults to 'UTC'. |\n| `lineItemIds[]` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Line item ids to report on. |\n| `destTable` | `string` Destination BigQuery table for query results with the format 'project.dataset.table_name'. If specified, the project must be explicitly whitelisted for the customer's ADH account. If project is not specified, uses default project for the provided customer. If neither project nor dataset is specified, uses the default project and dataset. |\n\n### Response body\n\nIf successful, the response body contains an instance of [Operation](/ads-data-hub/marketers/reference/rest/v1/operations#Operation).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/adsdatahub`"]]