We've updated our documentation with the latest features and updates introduced by Ads Data Hub's
two new experiences.
Advertisers, agencies, and publishers, refer to the
Marketers site.
Vendors and partners, refer to the
Measurement Partners site.
Method: customers.exportJobHistory
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
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-09-18 UTC.
[null,null,["Last updated 2024-09-18 UTC."],[[["Exports a customer account's job history to their chosen BigQuery dataset."],["Users need to specify the project ID, dataset, start and end dates, and optionally the time zone for the export."],["The API uses a POST request to `https://adsdatahub.googleapis.com/v1/{customer=customers/*}:exportJobHistory` with the customer ID as a path parameter."],["Successful responses return an Operation object, indicating the status of the export job."],["Authorization requires the `https://www.googleapis.com/auth/adsdatahub` OAuth scope."]]],["This document details the process for exporting a customer's job history to a BigQuery dataset using an HTTP POST request. The request, sent to `https://adsdatahub.googleapis.com/v1/{customer=customers/*}:exportJobHistory`, requires a customer ID as a path parameter. The request body must include the `projectId` and `dataset` for BigQuery, as well as the `startDate` and `endDate` for the export, along with an optional `timeZone`. Successful requests return an Operation instance, and the process needs `https://www.googleapis.com/auth/adsdatahub` authorization scope.\n"]]
