Method: customers.exportJobHistory

  • This page describes how to export job history of a customer account to a selected BigQuery dataset.

  • The request uses a POST method with a specific URL format that includes the customer ID.

  • The request body requires parameters such as project ID, dataset, start date, and end date for the export.

  • The response body will contain an instance of Operation if the request is successful.

  • Authorization requires the https://www.googleapis.com/auth/adsdatahub OAuth scope.

Exports job history of a customer account to customer-selected BigQuery dataset.

HTTP request

POST https://adsdatahub.googleapis.com/v1/{customer=customers/*}:exportJobHistory

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
customer

string

Required. ADH customer ID to fetch jobs for, with the format 'customers/123'.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "projectId": string,
  "dataset": string,
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  },
  "timeZone": string
}
Fields
projectId

string

Required. Customer project ID that the query audit log will be written to.
dataset

string

Required. Customer dataset that the query audit log will be written to.
startDate

object (Date)

Required. Job history will be exported for jobs started on or after startDate but before endDate. startDate cannot be more than 30 days from the current date.
endDate

object (Date)

Required. End date for date range for job history export, exclusive. Currently, only a single day's worth of query job history can be exported.
timeZone

string

Optional. The time zone for the start date. If not specified, defaults to 'UTC'.

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