Method: customers.generateDv360IvtVideoViewabilityReport

  • This method starts a query to get invalid traffic viewability metrics for DV360, with results saved to a BigQuery table.

  • The request uses an HTTP POST method with a specific URL format including the customer ID.

  • The request body includes parameters like customer ID, start and end dates, time zone, line item IDs, and the destination BigQuery table.

  • A successful response contains an Operation instance, and authorization requires the https://www.googleapis.com/auth/adsdatahub OAuth 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

string

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 (Date)
  },
  "endDate": {
    object (Date)
  },
  "timeZone": string,
  "lineItemIds": [
    string
  ],
  "destTable": string
}
Fields
adsDataCustomerId

string (int64 format)

Linked Ads Data Hub customer ID that owns the ads data.
startDate

object (Date)

The first day of the generated report.
endDate

object (Date)

The last day of the generated report, inclusive.
timeZone

string

The time zone for the report start and end dates. If not specified, defaults to 'UTC'.
lineItemIds[]

string (int64 format)

Line item ids to report on.
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.

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