Method: customers.submitVendorAggregatesReport

  • The purpose of this process is to import a vendor's summary report from a BigQuery table into ADH and trigger the generation of a discrepancy report.

  • The import is initiated via a POST request to a specific Google Ads Data Hub API endpoint.

  • The request requires a customer path parameter identifying the Ads Data Hub customer making the request.

  • The request body must include the date, metric, and sourceTable for the report, with an optional instance field.

  • A successful response will return an Operation instance.

Starts ADH import of a specified BigQuery table populated with the vendor's summary report for a given metric. This is called by the vendor to trigger ADH to generate a discrepancy report based on the Google-computed version of the same data, which will be written to a discrepancy status table.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
customer

string

Required. 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 
{
  "date": {
    object (Date)
  },
  "metric": enum (Metric),
  "sourceTable": string,
  "instance": string
}
Fields
date

object (Date)

Required. Date (either in vendor-wide time zone or per-row time zone) for the report.
metric

enum (Metric)

Required. Metric which the table is reporting.
sourceTable

string

Required. Source BigQuery table for query results in the format 'project.dataset.table_name'.
instance

string

Optional. The name of the submission feed instance. This shouldn't be populated for the production aggregates feed, but can be filled out with a prearranged instance name when a vendor works with Google to test a new or alternate version of their submission feed.

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