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 Brand Safety score file. This is called by the vendor to trigger ADH to import the scores.
HTTP request
POST https://adsdatahub.googleapis.com/v1/{customer=customers/*}:submitBrandSafetyScores
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 scores 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\u003eStarts ADH import of a specified BigQuery table populated with the vendor's Brand Safety score file, triggered by the vendor.\u003c/p\u003e\n"],["\u003cp\u003eThe request body requires the date, source BigQuery table, and optionally, the submission feed instance name.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful responses return an Operation object indicating the status of the import.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/adsdatahub\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eUses gRPC Transcoding syntax for the request URL with a required \u003ccode\u003ecustomer\u003c/code\u003e path parameter specifying the Ads Data Hub customer ID.\u003c/p\u003e\n"]]],["The vendor triggers ADH to import Brand Safety scores via a `POST` request to `https://adsdatahub.googleapis.com/v1/{customer=customers/*}:submitBrandSafetyScores`. The request requires a customer ID as a path parameter. The request body, in JSON format, mandates a `date` object and `sourceTable` string, while `instance` is optional. Successful requests yield an `Operation` instance in the response. The vendor need to authorize with the `https://www.googleapis.com/auth/adsdatahub` OAuth scope.\n"],null,["# Method: customers.submitBrandSafetyScores\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 Brand Safety score file. This is called by the vendor to trigger ADH to import the scores.\n\n### HTTP request\n\n`POST https://adsdatahub.googleapis.com/v1/{customer=customers/*}:submitBrandSafetyScores`\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) }, \"sourceTable\": string, \"instance\": string } ``` |\n\n| Fields ||\n|---------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `date` | `object (`[Date](/ads-data-hub/reference/rest/v1/Date)`)` Required. Date for the score file. |\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 scores 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`"]]
