This is legacy documentation, and may not be complete. To see the latest documentation, if you are a marketer, refer to the Marketers site. If you are a measurement partner, refer to the Measurement Partners site.
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
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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-09-18 UTC."],[[["\u003cp\u003eInitiates the ADH import process for a vendor's summary report from a specified BigQuery table to generate a discrepancy report.\u003c/p\u003e\n"],["\u003cp\u003eRequires a POST request to the specified endpoint with the customer ID as a path parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must include the report date, metric, source BigQuery table, and optionally, the submission feed instance name.\u003c/p\u003e\n"],["\u003cp\u003eA successful response returns an Operation object, indicating the status of the import process.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/adsdatahub\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["The vendor initiates an ADH import by sending a `POST` request to `https://adsdatahub.googleapis.com/v1/{customer=customers/*}:submitVendorAggregatesReport`. The request requires a customer ID path parameter. The request body must include the report's `date`, `metric`, and `sourceTable` in the format 'project.dataset.table_name' as well as an optional `instance`. A successful operation returns an `Operation` object. This action triggers ADH to generate a discrepancy report. Authorization requires the `https://www.googleapis.com/auth/adsdatahub` OAuth scope.\n"],null,["# Method: customers.submitVendorAggregatesReport\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n\nStarts 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.\n\n### HTTP request\n\n`POST https://adsdatahub.googleapis.com/v1/{customer=customers/*}:submitVendorAggregatesReport`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|---------------------------------------------------------------------------------------------------------------------------------------|\n| `customer` | `string` Required. Ads Data Hub customer making the request. This is in the form of 'customers/\\[customerId\\]'. e.g. 'customers/123'. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"date\": { object (/ads-data-hub/reference/rest/v1/Date) }, \"metric\": enum (/ads-data-hub/reference/rest/v1/customers.adsDataLinks#Metric), \"sourceTable\": string, \"instance\": string } ``` |\n\n| Fields ||\n|---------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `date` | `object (`[Date](/ads-data-hub/reference/rest/v1/Date)`)` Required. Date (either in vendor-wide time zone or per-row time zone) for the report. |\n| `metric` | `enum (`[Metric](/ads-data-hub/reference/rest/v1/customers.adsDataLinks#Metric)`)` Required. Metric which the table is reporting. |\n| `sourceTable` | `string` Required. Source BigQuery table for query results in the format 'project.dataset.table_name'. |\n| `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. |\n\n### Response body\n\nIf successful, the response body contains an instance of [Operation](/ads-data-hub/reference/rest/v1/operations#Operation).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/adsdatahub`"]]