AI-generated Key Takeaways
-
Initiates a query to retrieve invalid traffic viewability metrics for DV360, writing results to a specified BigQuery table.
-
Users specify the Ads Data Hub customer, start and end dates, time zone, relevant line item IDs, and the destination table for the report.
-
The request body requires details like Ads Data Hub customer ID, date range, time zone, line item IDs, and the BigQuery destination table.
-
Upon successful execution, the API returns an Operation object which can be used to track the query's status.
-
Authorization requires the
https://www.googleapis.com/auth/adsdatahub
scope.
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
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
customer |
Ads Data Hub customer making the request. This is in the form of 'customers/[customerId]'. e.g. 'customers/123'. |
Request body
The request body contains data with the following structure:
JSON representation |
---|
{ "adsDataCustomerId": string, "startDate": { object ( |
Fields | |
---|---|
adsDataCustomerId |
Linked Ads Data Hub customer ID that owns the ads data. |
startDate |
The first day of the generated report. |
endDate |
The last day of the generated report, inclusive. |
timeZone |
The time zone for the report start and end dates. If not specified, defaults to 'UTC'. |
lineItemIds[] |
Line item ids to report on. |
destTable |
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
.
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/adsdatahub