Ad Exchange Buyer API . negotiationrounds

Instance Methods

insert(negotiationId, body)

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