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.
A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".
A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".
SubmitVendorReportIdMappingRequest
Request to submit a Customer Defined Report ID Mapping file.
Required. Date that the daily report ID mapping is for.
sourceTable
string
Required. Source BigQuery table for query results in the format 'project.dataset.table_name'. The project, dataset, and table_name must all be provided explicitly. Table must have the following columns: date report_date, string vendorClientId, string vendor_reporting_id, string entity_type, int entityId. For more details, see Report ID Mapping Schema on ADH Dev Site: https://developers.google.com/ads-data-hub/confidential/brandmeasurement/reach/report_id_mapping_schema
instance
string
Optional. The name of the submission feed instance. This shouldn't be populated for the production ID mapping 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.
[[["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\u003eSubmitVendorReportIdMappingMetadata contains the request for Report ID Mapping submission, import start time, and import end time.\u003c/p\u003e\n"],["\u003cp\u003eSubmitVendorReportIdMappingRequest enables submission of a Customer Defined Report ID Mapping file, specifying details like customer, date, source table, instance, and metric.\u003c/p\u003e\n"],["\u003cp\u003eSource BigQuery table for SubmitVendorReportIdMappingRequest must adhere to a specific schema with columns for date, vendorClientId, vendor_reporting_id, entity_type, and entityId.\u003c/p\u003e\n"]]],["The core content outlines the process for submitting Customer Report ID Mapping requests. A request includes a `request` object, `startTime`, and `endTime`, with timestamps in RFC3339 UTC format. The `SubmitVendorReportIdMappingRequest` object requires `customer` ID, `date`, and the `sourceTable` (BigQuery) details. Optionally, it can include an `instance` name for testing and a `metric` type, which defaults to REACH. The source table must contain specific columns like `report_date`, `vendorClientId`, and `entityId`.\n"],null,["- [JSON representation](#SCHEMA_REPRESENTATION)\n- [SubmitVendorReportIdMappingRequest](#SubmitVendorReportIdMappingRequest)\n - [JSON representation](#SubmitVendorReportIdMappingRequest.SCHEMA_REPRESENTATION)\n\nMetadata for Customer Report ID Mapping submission request associated with each operation.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"request\": { object (/ads-data-hub/reference/rest/v1/SubmitVendorReportIdMappingMetadata#SubmitVendorReportIdMappingRequest) }, \"startTime\": string, \"endTime\": string } ``` |\n\n| Fields ||\n|-------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `request` | `object (`[SubmitVendorReportIdMappingRequest](/ads-data-hub/reference/rest/v1/SubmitVendorReportIdMappingMetadata#SubmitVendorReportIdMappingRequest)`)` Request for Report Id Mapping submission. |\n| `startTime` | `string (`[Timestamp](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp)` format)` Import start time. A timestamp in RFC3339 UTC \"Zulu\" format, with nanosecond resolution and up to nine fractional digits. Examples: `\"2014-10-02T15:01:23Z\"` and `\"2014-10-02T15:01:23.045123456Z\"`. |\n| `endTime` | `string (`[Timestamp](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp)` format)` Import end time. A timestamp in RFC3339 UTC \"Zulu\" format, with nanosecond resolution and up to nine fractional digits. Examples: `\"2014-10-02T15:01:23Z\"` and `\"2014-10-02T15:01:23.045123456Z\"`. |\n\nSubmitVendorReportIdMappingRequest Request to submit a Customer Defined Report ID Mapping file.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"customer\": string, \"date\": { object (/ads-data-hub/reference/rest/v1/Date) }, \"sourceTable\": string, \"instance\": string, \"metric\": enum (/ads-data-hub/reference/rest/v1/customers.adsDataLinks#Metric) } ``` |\n\n| Fields ||\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| `date` | `object (`[Date](/ads-data-hub/reference/rest/v1/Date)`)` Required. Date that the daily report ID mapping is for. |\n| `sourceTable` | `string` Required. Source BigQuery table for query results in the format 'project.dataset.table_name'. The project, dataset, and table_name must all be provided explicitly. Table must have the following columns: date report_date, string vendorClientId, string vendor_reporting_id, string entity_type, int entityId. For more details, see Report ID Mapping Schema on ADH Dev Site: \u003chttps://developers.google.com/ads-data-hub/confidential/brandmeasurement/reach/report_id_mapping_schema\u003e |\n| `instance` | `string` Optional. The name of the submission feed instance. This shouldn't be populated for the production ID mapping 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| `metric` | `enum (`[Metric](/ads-data-hub/reference/rest/v1/customers.adsDataLinks#Metric)`)` Optional. Metric which the table is reporting. Defaults to [REACH](/ads-data-hub/reference/rest/v1/customers.adsDataLinks#Metric.ENUM_VALUES.REACH) if not populated. |"]]