# Ad Exchange Buyer API . negotiations

## Instance Methods

Gets the requested negotiation.

Creates or updates the requested negotiation.

Lists all negotiations the authenticated user has access to.

### Method Details

`get(negotiationId)`

    Gets the requested negotiation.

    Args:
      negotiationId: string, A parameter (required)

    Returns:
      An object of the form:

        {
        "status": "A String", # The status of this negotiation.
        "buyerEmailContacts": [ # The buyer party's contact email.
          "A String",
        ],
        "labelNames": [ # A list of label names applicable to this negotiation.
          "A String",
        ],
        "billedBuyer": { # The billed buyer; Specified by a buyer buying through an intermediary.
          "buyer": {
            "enabledForPreferredDeals": True or False,
            "displayName": "A String",
            "customerId": 42,
            "enabledForInterestTargetingDeals": True or False,
            "sponsorAccountId": 42,
            "id": 42,
            "accountId": 42,
          },
          "webProperty": {
            "enabledForPreferredDeals": True or False,
            "name": "A String",
            "syndicationProduct": "A String",
            "allowInterestTargetedAds": True or False,
            "siteUrls": [
              "A String",
            ],
            "propertyCode": "A String",
            "id": 42,
          },
          "customerId": 42,
          "name": "A String",
          "buyerSellerRole": "A String",
        },
        "kind": "adexchangebuyer#negotiation",
        "offerId": "A String", # The ID of this negotiation's original offer.
        "negotiationRounds": [ # The series of negotiation rounds for this negotiation.
          {
            "kind": "adexchangebuyer#negotiationRound",
            "terms": { # The detailed terms proposed in this negotiation round.
              "finalizeAutomatically": True or False, # If true, the offer will finalize automatically when accepted.
              "inventorySegmentTargeting": { # The inventory segment targeting for the offer.
                "positiveIcmInterests": [
                  "A String",
                ],
                "positiveInventorySlots": [
                  "A String",
                ],
                "negativeSiteUrls": [
                  "A String",
                ],
                "positiveIcmBrands": [
                  "A String",
                ],
                "negativeXfpPlacements": [
                  "A String",
                ],
                "positiveVideoAdPositionSegments": [
                  "A String",
                ],
                "negativeIcmInterests": [
                  "A String",
                ],
                "negativeAudienceSegments": [
                  "A String",
                ],
                "positiveOperatingSystems": [
                  "A String",
                ],
                "negativeOperatingSystems": [
                  "A String",
                ],
                "negativeIcmBrands": [
                  "A String",
                ],
                "positiveLocations": [
                  "A String",
                ],
                "negativeMobileApps": [
                  "A String",
                ],
                "positiveDeviceCategories": [
                  "A String",
                ],
                "negativeAdSizes": [
                  {
                    "width": 42,
                    "height": 42,
                  },
                ],
                "negativeInventorySlots": [
                  "A String",
                ],
                "negativeVideoAdPositionSegments": [
                  "A String",
                ],
                "negativeVideoDurationSegments": [
                  "A String",
                ],
                "positiveSizes": [
                  "A String",
                ],
                "positiveXfpAdSlots": [
                  "A String",
                ],
                "positiveKeyValues": [
                  {
                    "keyName": "A String",
                    "value": "A String",
                  },
                ],
                "positiveSiteUrls": [
                  "A String",
                ],
                "positiveMobileApps": [
                  "A String",
                ],
                "negativeKeyValues": [
                  {
                    "keyName": "A String",
                    "value": "A String",
                  },
                ],
                "negativeSizes": [
                  "A String",
                ],
                "positiveOperatingSystemVersions": [
                  "A String",
                ],
                "negativeLocations": [
                  "A String",
                ],
                "positiveAdSizes": [
                  {
                    "width": 42,
                    "height": 42,
                  },
                ],
                "negativeOperatingSystemVersions": [
                  "A String",
                ],
                "positiveXfpPlacements": [
                  "A String",
                ],
                "negativeXfpAdSlots": [
                  "A String",
                ],
                "positiveVideoDurationSegments": [
                  "A String",
                ],
                "positiveAudienceSegments": [
                  "A String",
                ],
                "negativeDeviceCategories": [
                  "A String",
                ],
                "positiveAdTypeSegments": [
                  "A String",
                ],
                "negativeAdTypeSegments": [
                  "A String",
                ],
              },
              "endDate": { # The end date for the offer.
                "timeZoneId": "A String",
                "hour": 42,
                "month": 42,
                "second": 42,
                "year": 42,
                "day": 42,
                "minute": 42,
              },
              "termsAttributes": [ # A list of terms attributes.
                "A String",
              ],
              "startDate": { # The start date for the offer.
                "timeZoneId": "A String",
                "hour": 42,
                "month": 42,
                "second": 42,
                "year": 42,
                "day": 42,
                "minute": 42,
              },
              "buyerBillingType": "A String", # The buyer billing type.
              "estimatedImpressionsPerDay": "A String", # The estimated daily impressions for the offer.
              "monetizerType": "A String", # The monetizer type.
              "targetByDealId": True or False, # Whether to target by deal id.
              "adSlots": [ # The particular ad slots targeted by the offer.
                {
                  "name": "A String",
                  "description": "A String",
                  "channelId": 42,
                  "channelCode": "A String",
                  "webPropertyId": 42,
                  "size": "A String",
                },
              ],
              "advertisers": [ # A list of advertisers for this offer.
                {
                  "brands": [
                    {
                      "advertiserId": "A String",
                      "id": "A String",
                      "name": "A String",
                    },
                  ],
                  "status": "A String",
                  "id": "A String",
                  "name": "A String",
                },
              ],
              "minimumSpendMicros": "A String", # The minimum spend for the offer.
              "targetingAllAdSlots": True or False, # If true, the offer targets all ad slots.
              "creativeReviewPolicy": "A String", # Whether to use publisher review policy or AdX review policy.
              "audienceSegmentDescription": "A String", # A description of the audience segment for the offer.
              "dealPremium": { # The premium terms.
                "micros": "A String",
                "currencyCode": "A String",
              },
              "creativeBlockingLevel": "A String", # Whether to use or ignore publisher blocking rules.
              "audienceSegment": { # The audience segment for the offer.
                "numCookies": "A String",
                "description": "A String",
                "name": "A String",
                "id": "A String",
              },
              "description": "A String", # A description for these terms.
              "billingTerms": "A String", # The billing terms.
              "semiTransparent": True or False, # Whether this offer is semi-transparent.
              "minimumTrueLooks": "A String", # The minimum true looks for the offer.
              "cpm": { # The cpm terms.
                "micros": "A String",
                "currencyCode": "A String",
              },
              "isReservation": True or False, # Whether the offer is a reservation.
              "descriptiveName": "A String", # A descriptive name for these terms.
              "urls": [ # The urls applicable to the offer.
                "A String",
              ],
              "estimatedSpend": { # The estimated spend for the offer.
                "micros": "A String",
                "currencyCode": "A String",
              },
            },
            "negotiationId": "A String", # The ID of the negotiation to which this negotiation round applies.
            "roundNumber": "A String", # The number of this negotiation round, in sequence.
            "notes": "A String", # Notes regarding this negotiation round.
            "originatorRole": "A String", # The role, either buyer or seller, initiating this negotiation round.
            "dbmPartnerId": "A String", # Stores DBM partner ID for use by DBM
            "editHistory": { # The edit history of this negotiation round.
              "createdTimeStamp": "A String",
              "createdByLoginName": "A String",
              "lastUpdatedByLoginName": "A String",
              "lastUpdateTimeStamp": "A String",
            },
            "action": "A String", # The action performed by this negotiation round.
          },
        ],
        "negotiationId": "A String", # The unique ID of this negotiation.
        "negotiationState": "A String", # The state of this negotiation.
        "buyer": { # Details of the buyer party in this negotiation.
          "buyer": {
            "enabledForPreferredDeals": True or False,
            "displayName": "A String",
            "customerId": 42,
            "enabledForInterestTargetingDeals": True or False,
            "sponsorAccountId": 42,
            "id": 42,
            "accountId": 42,
          },
          "webProperty": {
            "enabledForPreferredDeals": True or False,
            "name": "A String",
            "syndicationProduct": "A String",
            "allowInterestTargetedAds": True or False,
            "siteUrls": [
              "A String",
            ],
            "propertyCode": "A String",
            "id": 42,
          },
          "customerId": 42,
          "name": "A String",
          "buyerSellerRole": "A String",
        },
        "stats": { # The stats for this negotiation.
          "revenue": {
            "micros": "A String",
            "currencyCode": "A String",
          },
          "bids": "A String",
          "impressions": "A String",
          "requests": "A String",
          "goodBids": "A String",
          "spend": {
            "micros": "A String",
            "currencyCode": "A String",
          },
        },
        "externalDealId": "A String", # For finalized negotiations, the ID of the finalized deal.
        "seller": { # Details of the seller party in this negotiation.
          "buyer": {
            "enabledForPreferredDeals": True or False,
            "displayName": "A String",
            "customerId": 42,
            "enabledForInterestTargetingDeals": True or False,
            "sponsorAccountId": 42,
            "id": 42,
            "accountId": 42,
          },
          "webProperty": {
            "enabledForPreferredDeals": True or False,
            "name": "A String",
            "syndicationProduct": "A String",
            "allowInterestTargetedAds": True or False,
            "siteUrls": [
              "A String",
            ],
            "propertyCode": "A String",
            "id": 42,
          },
          "customerId": 42,
          "name": "A String",
          "buyerSellerRole": "A String",
        },
        "dealType": "A String", # The type of this deal.
        "sellerEmailContacts": [ # The seller party's contact email.
          "A String",
        ],
      }

`insert(body)`

    Creates or updates the requested negotiation.

    Args:
      body: object, The request body. (required)
        The object takes the form of:

    {
      "status": "A String", # The status of this negotiation.
      "buyerEmailContacts": [ # The buyer party's contact email.
        "A String",
      ],
      "labelNames": [ # A list of label names applicable to this negotiation.
        "A String",
      ],
      "billedBuyer": { # The billed buyer; Specified by a buyer buying through an intermediary.
        "buyer": {
          "enabledForPreferredDeals": True or False,
          "displayName": "A String",
          "customerId": 42,
          "enabledForInterestTargetingDeals": True or False,
          "sponsorAccountId": 42,
          "id": 42,
          "accountId": 42,
        },
        "webProperty": {
          "enabledForPreferredDeals": True or False,
          "name": "A String",
          "syndicationProduct": "A String",
          "allowInterestTargetedAds": True or False,
          "siteUrls": [
            "A String",
          ],
          "propertyCode": "A String",
          "id": 42,
        },
        "customerId": 42,
        "name": "A String",
        "buyerSellerRole": "A String",
      },
      "kind": "adexchangebuyer#negotiation",
      "offerId": "A String", # The ID of this negotiation's original offer.
      "negotiationRounds": [ # The series of negotiation rounds for this negotiation.
        {
          "kind": "adexchangebuyer#negotiationRound",
          "terms": { # The detailed terms proposed in this negotiation round.
            "finalizeAutomatically": True or False, # If true, the offer will finalize automatically when accepted.
            "inventorySegmentTargeting": { # The inventory segment targeting for the offer.
              "positiveIcmInterests": [
                "A String",
              ],
              "positiveInventorySlots": [
                "A String",
              ],
              "negativeSiteUrls": [
                "A String",
              ],
              "positiveIcmBrands": [
                "A String",
              ],
              "negativeXfpPlacements": [
                "A String",
              ],
              "positiveVideoAdPositionSegments": [
                "A String",
              ],
              "negativeIcmInterests": [
                "A String",
              ],
              "negativeAudienceSegments": [
                "A String",
              ],
              "positiveOperatingSystems": [
                "A String",
              ],
              "negativeOperatingSystems": [
                "A String",
              ],
              "negativeIcmBrands": [
                "A String",
              ],
              "positiveLocations": [
                "A String",
              ],
              "negativeMobileApps": [
                "A String",
              ],
              "positiveDeviceCategories": [
                "A String",
              ],
              "negativeAdSizes": [
                {
                  "width": 42,
                  "height": 42,
                },
              ],
              "negativeInventorySlots": [
                "A String",
              ],
              "negativeVideoAdPositionSegments": [
                "A String",
              ],
              "negativeVideoDurationSegments": [
                "A String",
              ],
              "positiveSizes": [
                "A String",
              ],
              "positiveXfpAdSlots": [
                "A String",
              ],
              "positiveKeyValues": [
                {
                  "keyName": "A String",
                  "value": "A String",
                },
              ],
              "positiveSiteUrls": [
                "A String",
              ],
              "positiveMobileApps": [
                "A String",
              ],
              "negativeKeyValues": [
                {
                  "keyName": "A String",
                  "value": "A String",
                },
              ],
              "negativeSizes": [
                "A String",
              ],
              "positiveOperatingSystemVersions": [
                "A String",
              ],
              "negativeLocations": [
                "A String",
              ],
              "positiveAdSizes": [
                {
                  "width": 42,
                  "height": 42,
                },
              ],
              "negativeOperatingSystemVersions": [
                "A String",
              ],
              "positiveXfpPlacements": [
                "A String",
              ],
              "negativeXfpAdSlots": [
                "A String",
              ],
              "positiveVideoDurationSegments": [
                "A String",
              ],
              "positiveAudienceSegments": [
                "A String",
              ],
              "negativeDeviceCategories": [
                "A String",
              ],
              "positiveAdTypeSegments": [
                "A String",
              ],
              "negativeAdTypeSegments": [
                "A String",
              ],
            },
            "endDate": { # The end date for the offer.
              "timeZoneId": "A String",
              "hour": 42,
              "month": 42,
              "second": 42,
              "year": 42,
              "day": 42,
              "minute": 42,
            },
            "termsAttributes": [ # A list of terms attributes.
              "A String",
            ],
            "startDate": { # The start date for the offer.
              "timeZoneId": "A String",
              "hour": 42,
              "month": 42,
              "second": 42,
              "year": 42,
              "day": 42,
              "minute": 42,
            },
            "buyerBillingType": "A String", # The buyer billing type.
            "estimatedImpressionsPerDay": "A String", # The estimated daily impressions for the offer.
            "monetizerType": "A String", # The monetizer type.
            "targetByDealId": True or False, # Whether to target by deal id.
            "adSlots": [ # The particular ad slots targeted by the offer.
              {
                "name": "A String",
                "description": "A String",
                "channelId": 42,
                "channelCode": "A String",
                "webPropertyId": 42,
                "size": "A String",
              },
            ],
            "advertisers": [ # A list of advertisers for this offer.
              {
                "brands": [
                  {
                    "advertiserId": "A String",
                    "id": "A String",
                    "name": "A String",
                  },
                ],
                "status": "A String",
                "id": "A String",
                "name": "A String",
              },
            ],
            "minimumSpendMicros": "A String", # The minimum spend for the offer.
            "targetingAllAdSlots": True or False, # If true, the offer targets all ad slots.
            "creativeReviewPolicy": "A String", # Whether to use publisher review policy or AdX review policy.
            "audienceSegmentDescription": "A String", # A description of the audience segment for the offer.
            "dealPremium": { # The premium terms.
              "micros": "A String",
              "currencyCode": "A String",
            },
            "creativeBlockingLevel": "A String", # Whether to use or ignore publisher blocking rules.
            "audienceSegment": { # The audience segment for the offer.
              "numCookies": "A String",
              "description": "A String",
              "name": "A String",
              "id": "A String",
            },
            "description": "A String", # A description for these terms.
            "billingTerms": "A String", # The billing terms.
            "semiTransparent": True or False, # Whether this offer is semi-transparent.
            "minimumTrueLooks": "A String", # The minimum true looks for the offer.
            "cpm": { # The cpm terms.
              "micros": "A String",
              "currencyCode": "A String",
            },
            "isReservation": True or False, # Whether the offer is a reservation.
            "descriptiveName": "A String", # A descriptive name for these terms.
            "urls": [ # The urls applicable to the offer.
              "A String",
            ],
            "estimatedSpend": { # The estimated spend for the offer.
              "micros": "A String",
              "currencyCode": "A String",
            },
          },
          "negotiationId": "A String", # The ID of the negotiation to which this negotiation round applies.
          "roundNumber": "A String", # The number of this negotiation round, in sequence.
          "notes": "A String", # Notes regarding this negotiation round.
          "originatorRole": "A String", # The role, either buyer or seller, initiating this negotiation round.
          "dbmPartnerId": "A String", # Stores DBM partner ID for use by DBM
          "editHistory": { # The edit history of this negotiation round.
            "createdTimeStamp": "A String",
            "createdByLoginName": "A String",
            "lastUpdatedByLoginName": "A String",
            "lastUpdateTimeStamp": "A String",
          },
          "action": "A String", # The action performed by this negotiation round.
        },
      ],
      "negotiationId": "A String", # The unique ID of this negotiation.
      "negotiationState": "A String", # The state of this negotiation.
      "buyer": { # Details of the buyer party in this negotiation.
        "buyer": {
          "enabledForPreferredDeals": True or False,
          "displayName": "A String",
          "customerId": 42,
          "enabledForInterestTargetingDeals": True or False,
          "sponsorAccountId": 42,
          "id": 42,
          "accountId": 42,
        },
        "webProperty": {
          "enabledForPreferredDeals": True or False,
          "name": "A String",
          "syndicationProduct": "A String",
          "allowInterestTargetedAds": True or False,
          "siteUrls": [
            "A String",
          ],
          "propertyCode": "A String",
          "id": 42,
        },
        "customerId": 42,
        "name": "A String",
        "buyerSellerRole": "A String",
      },
      "stats": { # The stats for this negotiation.
        "revenue": {
          "micros": "A String",
          "currencyCode": "A String",
        },
        "bids": "A String",
        "impressions": "A String",
        "requests": "A String",
        "goodBids": "A String",
        "spend": {
          "micros": "A String",
          "currencyCode": "A String",
        },
      },
      "externalDealId": "A String", # For finalized negotiations, the ID of the finalized deal.
      "seller": { # Details of the seller party in this negotiation.
        "buyer": {
          "enabledForPreferredDeals": True or False,
          "displayName": "A String",
          "customerId": 42,
          "enabledForInterestTargetingDeals": True or False,
          "sponsorAccountId": 42,
          "id": 42,
          "accountId": 42,
        },
        "webProperty": {
          "enabledForPreferredDeals": True or False,
          "name": "A String",
          "syndicationProduct": "A String",
          "allowInterestTargetedAds": True or False,
          "siteUrls": [
            "A String",
          ],
          "propertyCode": "A String",
          "id": 42,
        },
        "customerId": 42,
        "name": "A String",
        "buyerSellerRole": "A String",
      },
      "dealType": "A String", # The type of this deal.
      "sellerEmailContacts": [ # The seller party's contact email.
        "A String",
      ],
    }

    Returns:
      An object of the form:

        {
        "status": "A String", # The status of this negotiation.
        "buyerEmailContacts": [ # The buyer party's contact email.
          "A String",
        ],
        "labelNames": [ # A list of label names applicable to this negotiation.
          "A String",
        ],
        "billedBuyer": { # The billed buyer; Specified by a buyer buying through an intermediary.
          "buyer": {
            "enabledForPreferredDeals": True or False,
            "displayName": "A String",
            "customerId": 42,
            "enabledForInterestTargetingDeals": True or False,
            "sponsorAccountId": 42,
            "id": 42,
            "accountId": 42,
          },
          "webProperty": {
            "enabledForPreferredDeals": True or False,
            "name": "A String",
            "syndicationProduct": "A String",
            "allowInterestTargetedAds": True or False,
            "siteUrls": [
              "A String",
            ],
            "propertyCode": "A String",
            "id": 42,
          },
          "customerId": 42,
          "name": "A String",
          "buyerSellerRole": "A String",
        },
        "kind": "adexchangebuyer#negotiation",
        "offerId": "A String", # The ID of this negotiation's original offer.
        "negotiationRounds": [ # The series of negotiation rounds for this negotiation.
          {
            "kind": "adexchangebuyer#negotiationRound",
            "terms": { # The detailed terms proposed in this negotiation round.
              "finalizeAutomatically": True or False, # If true, the offer will finalize automatically when accepted.
              "inventorySegmentTargeting": { # The inventory segment targeting for the offer.
                "positiveIcmInterests": [
                  "A String",
                ],
                "positiveInventorySlots": [
                  "A String",
                ],
                "negativeSiteUrls": [
                  "A String",
                ],
                "positiveIcmBrands": [
                  "A String",
                ],
                "negativeXfpPlacements": [
                  "A String",
                ],
                "positiveVideoAdPositionSegments": [
                  "A String",
                ],
                "negativeIcmInterests": [
                  "A String",
                ],
                "negativeAudienceSegments": [
                  "A String",
                ],
                "positiveOperatingSystems": [
                  "A String",
                ],
                "negativeOperatingSystems": [
                  "A String",
                ],
                "negativeIcmBrands": [
                  "A String",
                ],
                "positiveLocations": [
                  "A String",
                ],
                "negativeMobileApps": [
                  "A String",
                ],
                "positiveDeviceCategories": [
                  "A String",
                ],
                "negativeAdSizes": [
                  {
                    "width": 42,
                    "height": 42,
                  },
                ],
                "negativeInventorySlots": [
                  "A String",
                ],
                "negativeVideoAdPositionSegments": [
                  "A String",
                ],
                "negativeVideoDurationSegments": [
                  "A String",
                ],
                "positiveSizes": [
                  "A String",
                ],
                "positiveXfpAdSlots": [
                  "A String",
                ],
                "positiveKeyValues": [
                  {
                    "keyName": "A String",
                    "value": "A String",
                  },
                ],
                "positiveSiteUrls": [
                  "A String",
                ],
                "positiveMobileApps": [
                  "A String",
                ],
                "negativeKeyValues": [
                  {
                    "keyName": "A String",
                    "value": "A String",
                  },
                ],
                "negativeSizes": [
                  "A String",
                ],
                "positiveOperatingSystemVersions": [
                  "A String",
                ],
                "negativeLocations": [
                  "A String",
                ],
                "positiveAdSizes": [
                  {
                    "width": 42,
                    "height": 42,
                  },
                ],
                "negativeOperatingSystemVersions": [
                  "A String",
                ],
                "positiveXfpPlacements": [
                  "A String",
                ],
                "negativeXfpAdSlots": [
                  "A String",
                ],
                "positiveVideoDurationSegments": [
                  "A String",
                ],
                "positiveAudienceSegments": [
                  "A String",
                ],
                "negativeDeviceCategories": [
                  "A String",
                ],
                "positiveAdTypeSegments": [
                  "A String",
                ],
                "negativeAdTypeSegments": [
                  "A String",
                ],
              },
              "endDate": { # The end date for the offer.
                "timeZoneId": "A String",
                "hour": 42,
                "month": 42,
                "second": 42,
                "year": 42,
                "day": 42,
                "minute": 42,
              },
              "termsAttributes": [ # A list of terms attributes.
                "A String",
              ],
              "startDate": { # The start date for the offer.
                "timeZoneId": "A String",
                "hour": 42,
                "month": 42,
                "second": 42,
                "year": 42,
                "day": 42,
                "minute": 42,
              },
              "buyerBillingType": "A String", # The buyer billing type.
              "estimatedImpressionsPerDay": "A String", # The estimated daily impressions for the offer.
              "monetizerType": "A String", # The monetizer type.
              "targetByDealId": True or False, # Whether to target by deal id.
              "adSlots": [ # The particular ad slots targeted by the offer.
                {
                  "name": "A String",
                  "description": "A String",
                  "channelId": 42,
                  "channelCode": "A String",
                  "webPropertyId": 42,
                  "size": "A String",
                },
              ],
              "advertisers": [ # A list of advertisers for this offer.
                {
                  "brands": [
                    {
                      "advertiserId": "A String",
                      "id": "A String",
                      "name": "A String",
                    },
                  ],
                  "status": "A String",
                  "id": "A String",
                  "name": "A String",
                },
              ],
              "minimumSpendMicros": "A String", # The minimum spend for the offer.
              "targetingAllAdSlots": True or False, # If true, the offer targets all ad slots.
              "creativeReviewPolicy": "A String", # Whether to use publisher review policy or AdX review policy.
              "audienceSegmentDescription": "A String", # A description of the audience segment for the offer.
              "dealPremium": { # The premium terms.
                "micros": "A String",
                "currencyCode": "A String",
              },
              "creativeBlockingLevel": "A String", # Whether to use or ignore publisher blocking rules.
              "audienceSegment": { # The audience segment for the offer.
                "numCookies": "A String",
                "description": "A String",
                "name": "A String",
                "id": "A String",
              },
              "description": "A String", # A description for these terms.
              "billingTerms": "A String", # The billing terms.
              "semiTransparent": True or False, # Whether this offer is semi-transparent.
              "minimumTrueLooks": "A String", # The minimum true looks for the offer.
              "cpm": { # The cpm terms.
                "micros": "A String",
                "currencyCode": "A String",
              },
              "isReservation": True or False, # Whether the offer is a reservation.
              "descriptiveName": "A String", # A descriptive name for these terms.
              "urls": [ # The urls applicable to the offer.
                "A String",
              ],
              "estimatedSpend": { # The estimated spend for the offer.
                "micros": "A String",
                "currencyCode": "A String",
              },
            },
            "negotiationId": "A String", # The ID of the negotiation to which this negotiation round applies.
            "roundNumber": "A String", # The number of this negotiation round, in sequence.
            "notes": "A String", # Notes regarding this negotiation round.
            "originatorRole": "A String", # The role, either buyer or seller, initiating this negotiation round.
            "dbmPartnerId": "A String", # Stores DBM partner ID for use by DBM
            "editHistory": { # The edit history of this negotiation round.
              "createdTimeStamp": "A String",
              "createdByLoginName": "A String",
              "lastUpdatedByLoginName": "A String",
              "lastUpdateTimeStamp": "A String",
            },
            "action": "A String", # The action performed by this negotiation round.
          },
        ],
        "negotiationId": "A String", # The unique ID of this negotiation.
        "negotiationState": "A String", # The state of this negotiation.
        "buyer": { # Details of the buyer party in this negotiation.
          "buyer": {
            "enabledForPreferredDeals": True or False,
            "displayName": "A String",
            "customerId": 42,
            "enabledForInterestTargetingDeals": True or False,
            "sponsorAccountId": 42,
            "id": 42,
            "accountId": 42,
          },
          "webProperty": {
            "enabledForPreferredDeals": True or False,
            "name": "A String",
            "syndicationProduct": "A String",
            "allowInterestTargetedAds": True or False,
            "siteUrls": [
              "A String",
            ],
            "propertyCode": "A String",
            "id": 42,
          },
          "customerId": 42,
          "name": "A String",
          "buyerSellerRole": "A String",
        },
        "stats": { # The stats for this negotiation.
          "revenue": {
            "micros": "A String",
            "currencyCode": "A String",
          },
          "bids": "A String",
          "impressions": "A String",
          "requests": "A String",
          "goodBids": "A String",
          "spend": {
            "micros": "A String",
            "currencyCode": "A String",
          },
        },
        "externalDealId": "A String", # For finalized negotiations, the ID of the finalized deal.
        "seller": { # Details of the seller party in this negotiation.
          "buyer": {
            "enabledForPreferredDeals": True or False,
            "displayName": "A String",
            "customerId": 42,
            "enabledForInterestTargetingDeals": True or False,
            "sponsorAccountId": 42,
            "id": 42,
            "accountId": 42,
          },
          "webProperty": {
            "enabledForPreferredDeals": True or False,
            "name": "A String",
            "syndicationProduct": "A String",
            "allowInterestTargetedAds": True or False,
            "siteUrls": [
              "A String",
            ],
            "propertyCode": "A String",
            "id": 42,
          },
          "customerId": 42,
          "name": "A String",
          "buyerSellerRole": "A String",
        },
        "dealType": "A String", # The type of this deal.
        "sellerEmailContacts": [ # The seller party's contact email.
          "A String",
        ],
      }

`list()`

    Lists all negotiations the authenticated user has access to.

    Args:

    Returns:
      An object of the form:

        {
        "kind": "adexchangebuyer#negotiationsList",
        "negotiations": [
          {
            "status": "A String", # The status of this negotiation.
            "buyerEmailContacts": [ # The buyer party's contact email.
              "A String",
            ],
            "labelNames": [ # A list of label names applicable to this negotiation.
              "A String",
            ],
            "billedBuyer": { # The billed buyer; Specified by a buyer buying through an intermediary.
              "buyer": {
                "enabledForPreferredDeals": True or False,
                "displayName": "A String",
                "customerId": 42,
                "enabledForInterestTargetingDeals": True or False,
                "sponsorAccountId": 42,
                "id": 42,
                "accountId": 42,
              },
              "webProperty": {
                "enabledForPreferredDeals": True or False,
                "name": "A String",
                "syndicationProduct": "A String",
                "allowInterestTargetedAds": True or False,
                "siteUrls": [
                  "A String",
                ],
                "propertyCode": "A String",
                "id": 42,
              },
              "customerId": 42,
              "name": "A String",
              "buyerSellerRole": "A String",
            },
            "kind": "adexchangebuyer#negotiation",
            "offerId": "A String", # The ID of this negotiation's original offer.
            "negotiationRounds": [ # The series of negotiation rounds for this negotiation.
              {
                "kind": "adexchangebuyer#negotiationRound",
                "terms": { # The detailed terms proposed in this negotiation round.
                  "finalizeAutomatically": True or False, # If true, the offer will finalize automatically when accepted.
                  "inventorySegmentTargeting": { # The inventory segment targeting for the offer.
                    "positiveIcmInterests": [
                      "A String",
                    ],
                    "positiveInventorySlots": [
                      "A String",
                    ],
                    "negativeSiteUrls": [
                      "A String",
                    ],
                    "positiveIcmBrands": [
                      "A String",
                    ],
                    "negativeXfpPlacements": [
                      "A String",
                    ],
                    "positiveVideoAdPositionSegments": [
                      "A String",
                    ],
                    "negativeIcmInterests": [
                      "A String",
                    ],
                    "negativeAudienceSegments": [
                      "A String",
                    ],
                    "positiveOperatingSystems": [
                      "A String",
                    ],
                    "negativeOperatingSystems": [
                      "A String",
                    ],
                    "negativeIcmBrands": [
                      "A String",
                    ],
                    "positiveLocations": [
                      "A String",
                    ],
                    "negativeMobileApps": [
                      "A String",
                    ],
                    "positiveDeviceCategories": [
                      "A String",
                    ],
                    "negativeAdSizes": [
                      {
                        "width": 42,
                        "height": 42,
                      },
                    ],
                    "negativeInventorySlots": [
                      "A String",
                    ],
                    "negativeVideoAdPositionSegments": [
                      "A String",
                    ],
                    "negativeVideoDurationSegments": [
                      "A String",
                    ],
                    "positiveSizes": [
                      "A String",
                    ],
                    "positiveXfpAdSlots": [
                      "A String",
                    ],
                    "positiveKeyValues": [
                      {
                        "keyName": "A String",
                        "value": "A String",
                      },
                    ],
                    "positiveSiteUrls": [
                      "A String",
                    ],
                    "positiveMobileApps": [
                      "A String",
                    ],
                    "negativeKeyValues": [
                      {
                        "keyName": "A String",
                        "value": "A String",
                      },
                    ],
                    "negativeSizes": [
                      "A String",
                    ],
                    "positiveOperatingSystemVersions": [
                      "A String",
                    ],
                    "negativeLocations": [
                      "A String",
                    ],
                    "positiveAdSizes": [
                      {
                        "width": 42,
                        "height": 42,
                      },
                    ],
                    "negativeOperatingSystemVersions": [
                      "A String",
                    ],
                    "positiveXfpPlacements": [
                      "A String",
                    ],
                    "negativeXfpAdSlots": [
                      "A String",
                    ],
                    "positiveVideoDurationSegments": [
                      "A String",
                    ],
                    "positiveAudienceSegments": [
                      "A String",
                    ],
                    "negativeDeviceCategories": [
                      "A String",
                    ],
                    "positiveAdTypeSegments": [
                      "A String",
                    ],
                    "negativeAdTypeSegments": [
                      "A String",
                    ],
                  },
                  "endDate": { # The end date for the offer.
                    "timeZoneId": "A String",
                    "hour": 42,
                    "month": 42,
                    "second": 42,
                    "year": 42,
                    "day": 42,
                    "minute": 42,
                  },
                  "termsAttributes": [ # A list of terms attributes.
                    "A String",
                  ],
                  "startDate": { # The start date for the offer.
                    "timeZoneId": "A String",
                    "hour": 42,
                    "month": 42,
                    "second": 42,
                    "year": 42,
                    "day": 42,
                    "minute": 42,
                  },
                  "buyerBillingType": "A String", # The buyer billing type.
                  "estimatedImpressionsPerDay": "A String", # The estimated daily impressions for the offer.
                  "monetizerType": "A String", # The monetizer type.
                  "targetByDealId": True or False, # Whether to target by deal id.
                  "adSlots": [ # The particular ad slots targeted by the offer.
                    {
                      "name": "A String",
                      "description": "A String",
                      "channelId": 42,
                      "channelCode": "A String",
                      "webPropertyId": 42,
                      "size": "A String",
                    },
                  ],
                  "advertisers": [ # A list of advertisers for this offer.
                    {
                      "brands": [
                        {
                          "advertiserId": "A String",
                          "id": "A String",
                          "name": "A String",
                        },
                      ],
                      "status": "A String",
                      "id": "A String",
                      "name": "A String",
                    },
                  ],
                  "minimumSpendMicros": "A String", # The minimum spend for the offer.
                  "targetingAllAdSlots": True or False, # If true, the offer targets all ad slots.
                  "creativeReviewPolicy": "A String", # Whether to use publisher review policy or AdX review policy.
                  "audienceSegmentDescription": "A String", # A description of the audience segment for the offer.
                  "dealPremium": { # The premium terms.
                    "micros": "A String",
                    "currencyCode": "A String",
                  },
                  "creativeBlockingLevel": "A String", # Whether to use or ignore publisher blocking rules.
                  "audienceSegment": { # The audience segment for the offer.
                    "numCookies": "A String",
                    "description": "A String",
                    "name": "A String",
                    "id": "A String",
                  },
                  "description": "A String", # A description for these terms.
                  "billingTerms": "A String", # The billing terms.
                  "semiTransparent": True or False, # Whether this offer is semi-transparent.
                  "minimumTrueLooks": "A String", # The minimum true looks for the offer.
                  "cpm": { # The cpm terms.
                    "micros": "A String",
                    "currencyCode": "A String",
                  },
                  "isReservation": True or False, # Whether the offer is a reservation.
                  "descriptiveName": "A String", # A descriptive name for these terms.
                  "urls": [ # The urls applicable to the offer.
                    "A String",
                  ],
                  "estimatedSpend": { # The estimated spend for the offer.
                    "micros": "A String",
                    "currencyCode": "A String",
                  },
                },
                "negotiationId": "A String", # The ID of the negotiation to which this negotiation round applies.
                "roundNumber": "A String", # The number of this negotiation round, in sequence.
                "notes": "A String", # Notes regarding this negotiation round.
                "originatorRole": "A String", # The role, either buyer or seller, initiating this negotiation round.
                "dbmPartnerId": "A String", # Stores DBM partner ID for use by DBM
                "editHistory": { # The edit history of this negotiation round.
                  "createdTimeStamp": "A String",
                  "createdByLoginName": "A String",
                  "lastUpdatedByLoginName": "A String",
                  "lastUpdateTimeStamp": "A String",
                },
                "action": "A String", # The action performed by this negotiation round.
              },
            ],
            "negotiationId": "A String", # The unique ID of this negotiation.
            "negotiationState": "A String", # The state of this negotiation.
            "buyer": { # Details of the buyer party in this negotiation.
              "buyer": {
                "enabledForPreferredDeals": True or False,
                "displayName": "A String",
                "customerId": 42,
                "enabledForInterestTargetingDeals": True or False,
                "sponsorAccountId": 42,
                "id": 42,
                "accountId": 42,
              },
              "webProperty": {
                "enabledForPreferredDeals": True or False,
                "name": "A String",
                "syndicationProduct": "A String",
                "allowInterestTargetedAds": True or False,
                "siteUrls": [
                  "A String",
                ],
                "propertyCode": "A String",
                "id": 42,
              },
              "customerId": 42,
              "name": "A String",
              "buyerSellerRole": "A String",
            },
            "stats": { # The stats for this negotiation.
              "revenue": {
                "micros": "A String",
                "currencyCode": "A String",
              },
              "bids": "A String",
              "impressions": "A String",
              "requests": "A String",
              "goodBids": "A String",
              "spend": {
                "micros": "A String",
                "currencyCode": "A String",
              },
            },
            "externalDealId": "A String", # For finalized negotiations, the ID of the finalized deal.
            "seller": { # Details of the seller party in this negotiation.
              "buyer": {
                "enabledForPreferredDeals": True or False,
                "displayName": "A String",
                "customerId": 42,
                "enabledForInterestTargetingDeals": True or False,
                "sponsorAccountId": 42,
                "id": 42,
                "accountId": 42,
              },
              "webProperty": {
                "enabledForPreferredDeals": True or False,
                "name": "A String",
                "syndicationProduct": "A String",
                "allowInterestTargetedAds": True or False,
                "siteUrls": [
                  "A String",
                ],
                "propertyCode": "A String",
                "id": 42,
              },
              "customerId": 42,
              "name": "A String",
              "buyerSellerRole": "A String",
            },
            "dealType": "A String", # The type of this deal.
            "sellerEmailContacts": [ # The seller party's contact email.
              "A String",
            ],
          },
        ],
      }