# Ad Exchange Buyer API II . accounts . creatives . dealAssociations

## Instance Methods

Associate an existing deal with a creative.

List all creative-deal associations.

Retrieves the next page of results.

Remove the association between a deal and a creative.

### Method Details

`add(accountId, creativeId, body, x__xgafv=None)`

    Associate an existing deal with a creative.

    Args:
      accountId: string, The account the creative belongs to. (required)
      creativeId: string, The ID of the creative associated with the deal. (required)
      body: object, The request body. (required)
        The object takes the form of:

    { # A request for associating a deal and a creative.
        "association": { # The association between a creative and a deal. # The association between a creative and a deal that should be added.
          "dealsId": "A String", # The externalDealId for the deal associated with the creative.
          "creativeId": "A String", # The ID of the creative associated with the deal.
          "accountId": "A String", # The account the creative belongs to.
        },
      }

      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # A generic empty message that you can re-use to avoid defining duplicated
          # empty messages in your APIs. A typical example is to use it as the request
          # or the response type of an API method. For instance:
          #
          #     service Foo {
          #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
          #     }
          #
          # The JSON representation for `Empty` is empty JSON object `{}`.
      }

`list(accountId, creativeId, pageSize=None, pageToken=None, x__xgafv=None, query=None)`

    List all creative-deal associations.

    Args:
      accountId: string, The account to list the associations from.
    Specify "-" to list all creatives the current user has access to. (required)
      creativeId: string, The creative ID to list the associations from.
    Specify "-" to list all creatives under the above account. (required)
      pageSize: integer, Requested page size. Server may return fewer associations than requested.
    If unspecified, server will pick an appropriate default.
      pageToken: string, A token identifying a page of results the server should return.
    Typically, this is the value of
    ListDealAssociationsResponse.next_page_token
    returned from the previous call to 'ListDealAssociations' method.
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format
      query: string, An optional query string to filter deal associations. If no filter is
    specified, all associations will be returned.
    Supported queries are:

    accountId=account_id_string
    creativeId=creative_id_string
    dealsId=deals_id_string
    dealsStatus:{approved, conditionally_approved, disapproved,
                      not_checked}
    openAuctionStatus:{approved, conditionally_approved, disapproved,
                             not_checked}

    Example: 'dealsId=12345 AND dealsStatus:disapproved'

    Returns:
      An object of the form:

        { # A response for listing creative and deal associations
        "associations": [ # The list of associations.
          { # The association between a creative and a deal.
            "dealsId": "A String", # The externalDealId for the deal associated with the creative.
            "creativeId": "A String", # The ID of the creative associated with the deal.
            "accountId": "A String", # The account the creative belongs to.
          },
        ],
        "nextPageToken": "A String", # A token to retrieve the next page of results.
            # Pass this value in the
            # ListDealAssociationsRequest.page_token
            # field in the subsequent call to 'ListDealAssociation' method to retrieve
            # the next page of results.
      }

`list_next(previous_request, previous_response)`

    Retrieves the next page of results.

    Args:
      previous_request: The request for the previous page. (required)
      previous_response: The response from the request for the previous page. (required)

    Returns:
      A request object that you can call 'execute()' on to request the next
      page. Returns None if there are no more items in the collection.

`remove(accountId, creativeId, body, x__xgafv=None)`

    Remove the association between a deal and a creative.

    Args:
      accountId: string, The account the creative belongs to. (required)
      creativeId: string, The ID of the creative associated with the deal. (required)
      body: object, The request body. (required)
        The object takes the form of:

    { # A request for removing the association between a deal and a creative.
        "association": { # The association between a creative and a deal. # The association between a creative and a deal that should be removed.
          "dealsId": "A String", # The externalDealId for the deal associated with the creative.
          "creativeId": "A String", # The ID of the creative associated with the deal.
          "accountId": "A String", # The account the creative belongs to.
        },
      }

      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # A generic empty message that you can re-use to avoid defining duplicated
          # empty messages in your APIs. A typical example is to use it as the request
          # or the response type of an API method. For instance:
          #
          #     service Foo {
          #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
          #     }
          #
          # The JSON representation for `Empty` is empty JSON object `{}`.
      }