# Ad Exchange Buyer API . negotiationrounds

## Instance Methods

Adds the requested negotiationRound to the requested negotiation.

### Method Details

`insert(negotiationId, body)`

    Adds the requested negotiationRound to the requested negotiation.

    Args:
      negotiationId: string, A parameter (required)
      body: object, The request body. (required)
        The object takes the form of:

    {
      "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.
    }

    Returns:
      An object of the form:

        {
        "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.
      }