Method: accounts.creatives.dealAssociations.add
Stay organized with collections
Save and categorize content based on your preferences.
Associate an existing deal with a creative.
HTTP request
POST https://adexchangebuyer.googleapis.com/v2beta1/accounts/{association.accountId}/creatives/{association.creativeId}/dealAssociations:add
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
association.accountId |
string
The account the creative belongs to.
|
association.creativeId |
string
The ID of the creative associated with the deal.
|
Request body
The request body contains data with the following structure:
| JSON representation |
{
"association": {
"accountId": string,
"creativeId": string,
"dealsId": string
}
} |
| Fields |
association.dealsId |
string
The externalDealId for the deal associated with the creative.
|
Response body
If successful, the response body is empty.
Authorization Scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/adexchange.buyer
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."],[[["\u003cp\u003eAssociate an existing deal with a creative using the provided endpoint and HTTP POST request.\u003c/p\u003e\n"],["\u003cp\u003eSpecify the account and creative IDs as path parameters in the request URL.\u003c/p\u003e\n"],["\u003cp\u003eInclude the deal's external ID within the request body's association object for linking.\u003c/p\u003e\n"],["\u003cp\u003eUpon successful association, an empty response body will be returned, indicating completion.\u003c/p\u003e\n"],["\u003cp\u003eEnsure authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/adexchange.buyer\u003c/code\u003e scope for access.\u003c/p\u003e\n"]]],["This document details how to associate a deal with a creative using an HTTP POST request. The core action involves sending a request to a specific URL, `https://adexchangebuyer.googleapis.com/v2beta1/accounts/{association.accountId}/creatives/{association.creativeId}/dealAssociations:add`, along with the `association.dealsId` in the request body. This URL uses `accountId` and `creativeId` as path parameters. The request body requires a JSON structure containing the account ID, creative ID, and the deal ID. A successful request yields an empty response. The authorization scope `https://www.googleapis.com/auth/adexchange.buyer` is mandatory.\n"],null,["# Method: accounts.creatives.dealAssociations.add\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- [Try it!](#try-it)\n\nAssociate an existing deal with a creative.\n\n### HTTP request\n\n`POST https://adexchangebuyer.googleapis.com/v2beta1/accounts/{association.accountId}/creatives/{association.creativeId}/dealAssociations:add`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------------------------|-----------------------------------------------------------|\n| `association.accountId` | `string` The account the creative belongs to. |\n| `association.creativeId` | `string` The ID of the creative associated with the deal. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation ||\n|---------------------------------------------------------------------------------------------|---|\n| ``` { \"association\": { \"accountId\": string, \"creativeId\": string, \"dealsId\": string } } ``` |\n\n| Fields ||\n|-----------------------|------------------------------------------------------------------------|\n| `association.dealsId` | `string` The externalDealId for the deal associated with the creative. |\n\n### Response body\n\nIf successful, the response body is empty.\n\n### Authorization Scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/adexchange.buyer`"]]
