File: adexchangebuyer_v1_4.marketplacedeals.html

package info (click to toggle)
python-googleapi 2.186.0-1
links: PTS
area: main
in suites: forky, sid
size: 553,432 kB
sloc: python: 11,087; javascript: 249; sh: 114; makefile: 59
file content (1815 lines) | stat: -rw-r--r-- 133,246 bytes
parent folder | download | duplicates (2)
<html><body>
<style>

body, h1, h2, h3, div, span, p, pre, a {
  margin: 0;
  padding: 0;
  border: 0;
  font-weight: inherit;
  font-style: inherit;
  font-size: 100%;
  font-family: inherit;
  vertical-align: baseline;
}

body {
  font-size: 13px;
  padding: 1em;
}

h1 {
  font-size: 26px;
  margin-bottom: 1em;
}

h2 {
  font-size: 24px;
  margin-bottom: 1em;
}

h3 {
  font-size: 20px;
  margin-bottom: 1em;
  margin-top: 1em;
}

pre, code {
  line-height: 1.5;
  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
}

pre {
  margin-top: 0.5em;
}

h1, h2, h3, p {
  font-family: Arial, sans serif;
}

h1, h2, h3 {
  border-bottom: solid #CCC 1px;
}

.toc_element {
  margin-top: 0.5em;
}

.firstline {
  margin-left: 2 em;
}

.method  {
  margin-top: 1em;
  border: solid 1px #CCC;
  padding: 1em;
  background: #EEE;
}

.details {
  font-weight: bold;
  font-size: 14px;
}

</style>

<h1><a href="adexchangebuyer_v1_4.html">Ad Exchange Buyer API</a> . <a href="adexchangebuyer_v1_4.marketplacedeals.html">marketplacedeals</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
  <code><a href="#close">close()</a></code></p>
<p class="firstline">Close httplib2 connections.</p>
<p class="toc_element">
  <code><a href="#delete">delete(proposalId, body=None)</a></code></p>
<p class="firstline">Delete the specified deals from the proposal</p>
<p class="toc_element">
  <code><a href="#insert">insert(proposalId, body=None)</a></code></p>
<p class="firstline">Add new deals for the specified proposal</p>
<p class="toc_element">
  <code><a href="#list">list(proposalId, pqlQuery=None)</a></code></p>
<p class="firstline">List all the deals for a given proposal</p>
<p class="toc_element">
  <code><a href="#update">update(proposalId, body=None)</a></code></p>
<p class="firstline">Replaces all the deals in the proposal with the passed in deals</p>
<h3>Method Details</h3>
<div class="method">
    <code class="details" id="close">close()</code>
  <pre>Close httplib2 connections.</pre>
</div>

<div class="method">
    <code class="details" id="delete">delete(proposalId, body=None)</code>
  <pre>Delete the specified deals from the proposal

Args:
  proposalId: string, The proposalId to delete deals from. (required)
  body: object, The request body.
    The object takes the form of:

{
  &quot;dealIds&quot;: [ # List of deals to delete for a given proposal
    &quot;A String&quot;,
  ],
  &quot;proposalRevisionNumber&quot;: &quot;A String&quot;, # The last known proposal revision number.
  &quot;updateAction&quot;: &quot;A String&quot;, # Indicates an optional action to take on the proposal
}


Returns:
  An object of the form:

    {
  &quot;deals&quot;: [ # List of deals deleted (in the same proposal as passed in the request)
    { # A proposal can contain multiple deals. A deal contains the terms and targeting information that is used for serving.
      &quot;buyerPrivateData&quot;: { # Buyer private data (hidden from seller).
        &quot;referenceId&quot;: &quot;A String&quot;,
        &quot;referencePayload&quot;: &quot;A String&quot;,
      },
      &quot;creationTimeMs&quot;: &quot;A String&quot;, # The time (ms since epoch) of the deal creation. (readonly)
      &quot;creativePreApprovalPolicy&quot;: &quot;A String&quot;, # Specifies the creative pre-approval policy (buyer-readonly)
      &quot;creativeSafeFrameCompatibility&quot;: &quot;A String&quot;, # Specifies whether the creative is safeFrame compatible (buyer-readonly)
      &quot;dealId&quot;: &quot;A String&quot;, # A unique deal-id for the deal (readonly).
      &quot;dealServingMetadata&quot;: { # Metadata about the serving status of this deal (readonly, writes via custom actions)
        &quot;alcoholAdsAllowed&quot;: True or False, # True if alcohol ads are allowed for this deal (read-only). This field is only populated when querying for finalized orders using the method GetFinalizedOrderDeals
        &quot;dealPauseStatus&quot;: { # Tracks which parties (if any) have paused a deal. The deal is considered paused if has_buyer_paused || has_seller_paused. Each of the has_buyer_paused or the has_seller_paused bits can be set independently. # Tracks which parties (if any) have paused a deal. (readonly, except via PauseResumeOrderDeals action)
          &quot;buyerPauseReason&quot;: &quot;A String&quot;,
          &quot;firstPausedBy&quot;: &quot;A String&quot;, # If the deal is paused, records which party paused the deal first.
          &quot;hasBuyerPaused&quot;: True or False,
          &quot;hasSellerPaused&quot;: True or False,
          &quot;sellerPauseReason&quot;: &quot;A String&quot;,
        },
      },
      &quot;deliveryControl&quot;: { # The set of fields around delivery control that are interesting for a buyer to see but are non-negotiable. These are set by the publisher. This message is assigned an id of 100 since some day we would want to model this as a protobuf extension.
        &quot;creativeBlockingLevel&quot;: &quot;A String&quot;,
        &quot;deliveryRateType&quot;: &quot;A String&quot;,
        &quot;frequencyCaps&quot;: [
          {
            &quot;maxImpressions&quot;: 42,
            &quot;numTimeUnits&quot;: 42,
            &quot;timeUnitType&quot;: &quot;A String&quot;,
          },
        ],
      },
      &quot;externalDealId&quot;: &quot;A String&quot;, # The external deal id assigned to this deal once the deal is finalized. This is the deal-id that shows up in serving/reporting etc. (readonly)
      &quot;flightEndTimeMs&quot;: &quot;A String&quot;, # Proposed flight end time of the deal (ms since epoch) This will generally be stored in a granularity of a second. (updatable)
      &quot;flightStartTimeMs&quot;: &quot;A String&quot;, # Proposed flight start time of the deal (ms since epoch) This will generally be stored in a granularity of a second. (updatable)
      &quot;inventoryDescription&quot;: &quot;A String&quot;, # Description for the deal terms. (buyer-readonly)
      &quot;isRfpTemplate&quot;: True or False, # Indicates whether the current deal is a RFP template. RFP template is created by buyer and not based on seller created products.
      &quot;isSetupComplete&quot;: True or False, # True, if the buyside inventory setup is complete for this deal. (readonly, except via OrderSetupCompleted action)
      &quot;kind&quot;: &quot;adexchangebuyer#marketplaceDeal&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;adexchangebuyer#marketplaceDeal&quot;.
      &quot;lastUpdateTimeMs&quot;: &quot;A String&quot;, # The time (ms since epoch) when the deal was last updated. (readonly)
      &quot;makegoodRequestedReason&quot;: &quot;A String&quot;,
      &quot;name&quot;: &quot;A String&quot;, # The name of the deal. (updatable)
      &quot;productId&quot;: &quot;A String&quot;, # The product-id from which this deal was created. (readonly, except on create)
      &quot;productRevisionNumber&quot;: &quot;A String&quot;, # The revision number of the product that the deal was created from (readonly, except on create)
      &quot;programmaticCreativeSource&quot;: &quot;A String&quot;, # Specifies the creative source for programmatic deals, PUBLISHER means creative is provided by seller and ADVERTISR means creative is provided by buyer. (buyer-readonly)
      &quot;proposalId&quot;: &quot;A String&quot;,
      &quot;sellerContacts&quot;: [ # Optional Seller contact information for the deal (buyer-readonly)
        {
          &quot;email&quot;: &quot;A String&quot;, # Email address of the contact.
          &quot;name&quot;: &quot;A String&quot;, # The name of the contact.
        },
      ],
      &quot;sharedTargetings&quot;: [ # The shared targeting visible to buyers and sellers. Each shared targeting entity is AND&#x27;d together. (updatable)
        {
          &quot;exclusions&quot;: [ # The list of values to exclude from targeting. Each value is AND&#x27;d together.
            {
              &quot;creativeSizeValue&quot;: { # Next Id: 7 # The creative size value to exclude/include.
                &quot;allowedFormats&quot;: [ # The formats allowed by the publisher.
                  &quot;A String&quot;,
                ],
                &quot;companionSizes&quot;: [ # For video size type, the list of companion sizes.
                  {
                    &quot;height&quot;: 42, # The height of the creative.
                    &quot;width&quot;: 42, # The width of the creative.
                  },
                ],
                &quot;creativeSizeType&quot;: &quot;A String&quot;, # The Creative size type.
                &quot;nativeTemplate&quot;: &quot;A String&quot;, # The native template for native ad.
                &quot;size&quot;: { # For regular or video creative size type, specifies the size of the creative.
                  &quot;height&quot;: 42, # The height of the creative.
                  &quot;width&quot;: 42, # The width of the creative.
                },
                &quot;skippableAdType&quot;: &quot;A String&quot;, # The skippable ad type for video size.
              },
              &quot;dayPartTargetingValue&quot;: { # The daypart targeting to include / exclude. Filled in when the key is GOOG_DAYPART_TARGETING.
                &quot;dayParts&quot;: [
                  {
                    &quot;dayOfWeek&quot;: &quot;A String&quot;,
                    &quot;endHour&quot;: 42,
                    &quot;endMinute&quot;: 42,
                    &quot;startHour&quot;: 42,
                    &quot;startMinute&quot;: 42,
                  },
                ],
                &quot;timeZoneType&quot;: &quot;A String&quot;,
              },
              &quot;demogAgeCriteriaValue&quot;: {
                &quot;demogAgeCriteriaIds&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;demogGenderCriteriaValue&quot;: {
                &quot;demogGenderCriteriaIds&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;longValue&quot;: &quot;A String&quot;, # The long value to exclude/include.
              &quot;requestPlatformTargetingValue&quot;: {
                &quot;requestPlatforms&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;stringValue&quot;: &quot;A String&quot;, # The string value to exclude/include.
            },
          ],
          &quot;inclusions&quot;: [ # The list of value to include as part of the targeting. Each value is OR&#x27;d together.
            {
              &quot;creativeSizeValue&quot;: { # Next Id: 7 # The creative size value to exclude/include.
                &quot;allowedFormats&quot;: [ # The formats allowed by the publisher.
                  &quot;A String&quot;,
                ],
                &quot;companionSizes&quot;: [ # For video size type, the list of companion sizes.
                  {
                    &quot;height&quot;: 42, # The height of the creative.
                    &quot;width&quot;: 42, # The width of the creative.
                  },
                ],
                &quot;creativeSizeType&quot;: &quot;A String&quot;, # The Creative size type.
                &quot;nativeTemplate&quot;: &quot;A String&quot;, # The native template for native ad.
                &quot;size&quot;: { # For regular or video creative size type, specifies the size of the creative.
                  &quot;height&quot;: 42, # The height of the creative.
                  &quot;width&quot;: 42, # The width of the creative.
                },
                &quot;skippableAdType&quot;: &quot;A String&quot;, # The skippable ad type for video size.
              },
              &quot;dayPartTargetingValue&quot;: { # The daypart targeting to include / exclude. Filled in when the key is GOOG_DAYPART_TARGETING.
                &quot;dayParts&quot;: [
                  {
                    &quot;dayOfWeek&quot;: &quot;A String&quot;,
                    &quot;endHour&quot;: 42,
                    &quot;endMinute&quot;: 42,
                    &quot;startHour&quot;: 42,
                    &quot;startMinute&quot;: 42,
                  },
                ],
                &quot;timeZoneType&quot;: &quot;A String&quot;,
              },
              &quot;demogAgeCriteriaValue&quot;: {
                &quot;demogAgeCriteriaIds&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;demogGenderCriteriaValue&quot;: {
                &quot;demogGenderCriteriaIds&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;longValue&quot;: &quot;A String&quot;, # The long value to exclude/include.
              &quot;requestPlatformTargetingValue&quot;: {
                &quot;requestPlatforms&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;stringValue&quot;: &quot;A String&quot;, # The string value to exclude/include.
            },
          ],
          &quot;key&quot;: &quot;A String&quot;, # The key representing the shared targeting criterion.
        },
      ],
      &quot;syndicationProduct&quot;: &quot;A String&quot;, # The syndication product associated with the deal. (readonly, except on create)
      &quot;terms&quot;: { # The negotiable terms of the deal. (updatable)
        &quot;brandingType&quot;: &quot;A String&quot;, # Visibility of the URL in bid requests.
        &quot;crossListedExternalDealIdType&quot;: &quot;A String&quot;, # Indicates that this ExternalDealId exists under at least two different AdxInventoryDeals. Currently, the only case that the same ExternalDealId will exist is programmatic cross sell case.
        &quot;description&quot;: &quot;A String&quot;, # Description for the proposed terms of the deal.
        &quot;estimatedGrossSpend&quot;: { # Non-binding estimate of the estimated gross spend for this deal Can be set by buyer or seller.
          &quot;amountMicros&quot;: 3.14, # The price value in micros.
          &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
          &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
          &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
        },
        &quot;estimatedImpressionsPerDay&quot;: &quot;A String&quot;, # Non-binding estimate of the impressions served per day Can be set by buyer or seller.
        &quot;guaranteedFixedPriceTerms&quot;: { # The terms for guaranteed fixed price deals.
          &quot;billingInfo&quot;: { # External billing info for this Deal. This field is relevant when external billing info such as price has a different currency code than DFP/AdX.
            &quot;currencyConversionTimeMs&quot;: &quot;A String&quot;, # The timestamp (in ms since epoch) when the original reservation price for the deal was first converted to DFP currency. This is used to convert the contracted price into buyer&#x27;s currency without discrepancy.
            &quot;dfpLineItemId&quot;: &quot;A String&quot;, # The DFP line item id associated with this deal. For features like CPD, buyers can retrieve the DFP line item for billing reconciliation.
            &quot;originalContractedQuantity&quot;: &quot;A String&quot;, # The original contracted quantity (# impressions) for this deal. To ensure delivery, sometimes the publisher will book the deal with a impression buffer, such that guaranteed_looks is greater than the contracted quantity. However clients are billed using the original contracted quantity.
            &quot;price&quot;: { # The original reservation price for the deal, if the currency code is different from the one used in negotiation.
              &quot;amountMicros&quot;: 3.14, # The price value in micros.
              &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
              &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
              &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
            },
          },
          &quot;fixedPrices&quot;: [ # Fixed price for the specified buyer.
            { # Used to specify pricing rules for buyers. Each PricePerBuyer in a product can become [0,1] deals. To check if there is a PricePerBuyer for a particular buyer we look for the most specific matching rule - we first look for a rule matching the buyer and otherwise look for a matching rule where no buyer is set.
              &quot;auctionTier&quot;: &quot;A String&quot;, # Optional access type for this buyer.
              &quot;billedBuyer&quot;: { # Reference to the buyer that will get billed.
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;buyer&quot;: { # The buyer who will pay this price. If unset, all buyers can pay this price (if the advertisers match, and there&#x27;s no more specific rule matching the buyer).
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;price&quot;: { # The specified price
                &quot;amountMicros&quot;: 3.14, # The price value in micros.
                &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
                &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
                &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
              },
            },
          ],
          &quot;guaranteedImpressions&quot;: &quot;A String&quot;, # Guaranteed impressions as a percentage. This is the percentage of guaranteed looks that the buyer is guaranteeing to buy.
          &quot;guaranteedLooks&quot;: &quot;A String&quot;, # Count of guaranteed looks. Required for deal, optional for product. For CPD deals, buyer changes to guaranteed_looks will be ignored.
          &quot;minimumDailyLooks&quot;: &quot;A String&quot;, # Count of minimum daily looks for a CPD deal. For CPD deals, buyer should negotiate on this field instead of guaranteed_looks.
        },
        &quot;nonGuaranteedAuctionTerms&quot;: { # The terms for non-guaranteed auction deals.
          &quot;autoOptimizePrivateAuction&quot;: True or False, # True if open auction buyers are allowed to compete with invited buyers in this private auction (buyer-readonly).
          &quot;reservePricePerBuyers&quot;: [ # Reserve price for the specified buyer.
            { # Used to specify pricing rules for buyers. Each PricePerBuyer in a product can become [0,1] deals. To check if there is a PricePerBuyer for a particular buyer we look for the most specific matching rule - we first look for a rule matching the buyer and otherwise look for a matching rule where no buyer is set.
              &quot;auctionTier&quot;: &quot;A String&quot;, # Optional access type for this buyer.
              &quot;billedBuyer&quot;: { # Reference to the buyer that will get billed.
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;buyer&quot;: { # The buyer who will pay this price. If unset, all buyers can pay this price (if the advertisers match, and there&#x27;s no more specific rule matching the buyer).
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;price&quot;: { # The specified price
                &quot;amountMicros&quot;: 3.14, # The price value in micros.
                &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
                &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
                &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
              },
            },
          ],
        },
        &quot;nonGuaranteedFixedPriceTerms&quot;: { # The terms for non-guaranteed fixed price deals.
          &quot;fixedPrices&quot;: [ # Fixed price for the specified buyer.
            { # Used to specify pricing rules for buyers. Each PricePerBuyer in a product can become [0,1] deals. To check if there is a PricePerBuyer for a particular buyer we look for the most specific matching rule - we first look for a rule matching the buyer and otherwise look for a matching rule where no buyer is set.
              &quot;auctionTier&quot;: &quot;A String&quot;, # Optional access type for this buyer.
              &quot;billedBuyer&quot;: { # Reference to the buyer that will get billed.
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;buyer&quot;: { # The buyer who will pay this price. If unset, all buyers can pay this price (if the advertisers match, and there&#x27;s no more specific rule matching the buyer).
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;price&quot;: { # The specified price
                &quot;amountMicros&quot;: 3.14, # The price value in micros.
                &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
                &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
                &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
              },
            },
          ],
        },
        &quot;rubiconNonGuaranteedTerms&quot;: { # The terms for rubicon non-guaranteed deals.
          &quot;priorityPrice&quot;: { # Optional price for Rubicon priority access in the auction.
            &quot;amountMicros&quot;: 3.14, # The price value in micros.
            &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
            &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
            &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
          },
          &quot;standardPrice&quot;: { # Optional price for Rubicon standard access in the auction.
            &quot;amountMicros&quot;: 3.14, # The price value in micros.
            &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
            &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
            &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
          },
        },
        &quot;sellerTimeZone&quot;: &quot;A String&quot;, # For deals with Cost Per Day billing, defines the timezone used to mark the boundaries of a day (buyer-readonly)
      },
      &quot;webPropertyCode&quot;: &quot;A String&quot;,
    },
  ],
  &quot;proposalRevisionNumber&quot;: &quot;A String&quot;, # The updated revision number for the proposal.
}</pre>
</div>

<div class="method">
    <code class="details" id="insert">insert(proposalId, body=None)</code>
  <pre>Add new deals for the specified proposal

Args:
  proposalId: string, proposalId for which deals need to be added. (required)
  body: object, The request body.
    The object takes the form of:

{
  &quot;deals&quot;: [ # The list of deals to add
    { # A proposal can contain multiple deals. A deal contains the terms and targeting information that is used for serving.
      &quot;buyerPrivateData&quot;: { # Buyer private data (hidden from seller).
        &quot;referenceId&quot;: &quot;A String&quot;,
        &quot;referencePayload&quot;: &quot;A String&quot;,
      },
      &quot;creationTimeMs&quot;: &quot;A String&quot;, # The time (ms since epoch) of the deal creation. (readonly)
      &quot;creativePreApprovalPolicy&quot;: &quot;A String&quot;, # Specifies the creative pre-approval policy (buyer-readonly)
      &quot;creativeSafeFrameCompatibility&quot;: &quot;A String&quot;, # Specifies whether the creative is safeFrame compatible (buyer-readonly)
      &quot;dealId&quot;: &quot;A String&quot;, # A unique deal-id for the deal (readonly).
      &quot;dealServingMetadata&quot;: { # Metadata about the serving status of this deal (readonly, writes via custom actions)
        &quot;alcoholAdsAllowed&quot;: True or False, # True if alcohol ads are allowed for this deal (read-only). This field is only populated when querying for finalized orders using the method GetFinalizedOrderDeals
        &quot;dealPauseStatus&quot;: { # Tracks which parties (if any) have paused a deal. The deal is considered paused if has_buyer_paused || has_seller_paused. Each of the has_buyer_paused or the has_seller_paused bits can be set independently. # Tracks which parties (if any) have paused a deal. (readonly, except via PauseResumeOrderDeals action)
          &quot;buyerPauseReason&quot;: &quot;A String&quot;,
          &quot;firstPausedBy&quot;: &quot;A String&quot;, # If the deal is paused, records which party paused the deal first.
          &quot;hasBuyerPaused&quot;: True or False,
          &quot;hasSellerPaused&quot;: True or False,
          &quot;sellerPauseReason&quot;: &quot;A String&quot;,
        },
      },
      &quot;deliveryControl&quot;: { # The set of fields around delivery control that are interesting for a buyer to see but are non-negotiable. These are set by the publisher. This message is assigned an id of 100 since some day we would want to model this as a protobuf extension.
        &quot;creativeBlockingLevel&quot;: &quot;A String&quot;,
        &quot;deliveryRateType&quot;: &quot;A String&quot;,
        &quot;frequencyCaps&quot;: [
          {
            &quot;maxImpressions&quot;: 42,
            &quot;numTimeUnits&quot;: 42,
            &quot;timeUnitType&quot;: &quot;A String&quot;,
          },
        ],
      },
      &quot;externalDealId&quot;: &quot;A String&quot;, # The external deal id assigned to this deal once the deal is finalized. This is the deal-id that shows up in serving/reporting etc. (readonly)
      &quot;flightEndTimeMs&quot;: &quot;A String&quot;, # Proposed flight end time of the deal (ms since epoch) This will generally be stored in a granularity of a second. (updatable)
      &quot;flightStartTimeMs&quot;: &quot;A String&quot;, # Proposed flight start time of the deal (ms since epoch) This will generally be stored in a granularity of a second. (updatable)
      &quot;inventoryDescription&quot;: &quot;A String&quot;, # Description for the deal terms. (buyer-readonly)
      &quot;isRfpTemplate&quot;: True or False, # Indicates whether the current deal is a RFP template. RFP template is created by buyer and not based on seller created products.
      &quot;isSetupComplete&quot;: True or False, # True, if the buyside inventory setup is complete for this deal. (readonly, except via OrderSetupCompleted action)
      &quot;kind&quot;: &quot;adexchangebuyer#marketplaceDeal&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;adexchangebuyer#marketplaceDeal&quot;.
      &quot;lastUpdateTimeMs&quot;: &quot;A String&quot;, # The time (ms since epoch) when the deal was last updated. (readonly)
      &quot;makegoodRequestedReason&quot;: &quot;A String&quot;,
      &quot;name&quot;: &quot;A String&quot;, # The name of the deal. (updatable)
      &quot;productId&quot;: &quot;A String&quot;, # The product-id from which this deal was created. (readonly, except on create)
      &quot;productRevisionNumber&quot;: &quot;A String&quot;, # The revision number of the product that the deal was created from (readonly, except on create)
      &quot;programmaticCreativeSource&quot;: &quot;A String&quot;, # Specifies the creative source for programmatic deals, PUBLISHER means creative is provided by seller and ADVERTISR means creative is provided by buyer. (buyer-readonly)
      &quot;proposalId&quot;: &quot;A String&quot;,
      &quot;sellerContacts&quot;: [ # Optional Seller contact information for the deal (buyer-readonly)
        {
          &quot;email&quot;: &quot;A String&quot;, # Email address of the contact.
          &quot;name&quot;: &quot;A String&quot;, # The name of the contact.
        },
      ],
      &quot;sharedTargetings&quot;: [ # The shared targeting visible to buyers and sellers. Each shared targeting entity is AND&#x27;d together. (updatable)
        {
          &quot;exclusions&quot;: [ # The list of values to exclude from targeting. Each value is AND&#x27;d together.
            {
              &quot;creativeSizeValue&quot;: { # Next Id: 7 # The creative size value to exclude/include.
                &quot;allowedFormats&quot;: [ # The formats allowed by the publisher.
                  &quot;A String&quot;,
                ],
                &quot;companionSizes&quot;: [ # For video size type, the list of companion sizes.
                  {
                    &quot;height&quot;: 42, # The height of the creative.
                    &quot;width&quot;: 42, # The width of the creative.
                  },
                ],
                &quot;creativeSizeType&quot;: &quot;A String&quot;, # The Creative size type.
                &quot;nativeTemplate&quot;: &quot;A String&quot;, # The native template for native ad.
                &quot;size&quot;: { # For regular or video creative size type, specifies the size of the creative.
                  &quot;height&quot;: 42, # The height of the creative.
                  &quot;width&quot;: 42, # The width of the creative.
                },
                &quot;skippableAdType&quot;: &quot;A String&quot;, # The skippable ad type for video size.
              },
              &quot;dayPartTargetingValue&quot;: { # The daypart targeting to include / exclude. Filled in when the key is GOOG_DAYPART_TARGETING.
                &quot;dayParts&quot;: [
                  {
                    &quot;dayOfWeek&quot;: &quot;A String&quot;,
                    &quot;endHour&quot;: 42,
                    &quot;endMinute&quot;: 42,
                    &quot;startHour&quot;: 42,
                    &quot;startMinute&quot;: 42,
                  },
                ],
                &quot;timeZoneType&quot;: &quot;A String&quot;,
              },
              &quot;demogAgeCriteriaValue&quot;: {
                &quot;demogAgeCriteriaIds&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;demogGenderCriteriaValue&quot;: {
                &quot;demogGenderCriteriaIds&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;longValue&quot;: &quot;A String&quot;, # The long value to exclude/include.
              &quot;requestPlatformTargetingValue&quot;: {
                &quot;requestPlatforms&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;stringValue&quot;: &quot;A String&quot;, # The string value to exclude/include.
            },
          ],
          &quot;inclusions&quot;: [ # The list of value to include as part of the targeting. Each value is OR&#x27;d together.
            {
              &quot;creativeSizeValue&quot;: { # Next Id: 7 # The creative size value to exclude/include.
                &quot;allowedFormats&quot;: [ # The formats allowed by the publisher.
                  &quot;A String&quot;,
                ],
                &quot;companionSizes&quot;: [ # For video size type, the list of companion sizes.
                  {
                    &quot;height&quot;: 42, # The height of the creative.
                    &quot;width&quot;: 42, # The width of the creative.
                  },
                ],
                &quot;creativeSizeType&quot;: &quot;A String&quot;, # The Creative size type.
                &quot;nativeTemplate&quot;: &quot;A String&quot;, # The native template for native ad.
                &quot;size&quot;: { # For regular or video creative size type, specifies the size of the creative.
                  &quot;height&quot;: 42, # The height of the creative.
                  &quot;width&quot;: 42, # The width of the creative.
                },
                &quot;skippableAdType&quot;: &quot;A String&quot;, # The skippable ad type for video size.
              },
              &quot;dayPartTargetingValue&quot;: { # The daypart targeting to include / exclude. Filled in when the key is GOOG_DAYPART_TARGETING.
                &quot;dayParts&quot;: [
                  {
                    &quot;dayOfWeek&quot;: &quot;A String&quot;,
                    &quot;endHour&quot;: 42,
                    &quot;endMinute&quot;: 42,
                    &quot;startHour&quot;: 42,
                    &quot;startMinute&quot;: 42,
                  },
                ],
                &quot;timeZoneType&quot;: &quot;A String&quot;,
              },
              &quot;demogAgeCriteriaValue&quot;: {
                &quot;demogAgeCriteriaIds&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;demogGenderCriteriaValue&quot;: {
                &quot;demogGenderCriteriaIds&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;longValue&quot;: &quot;A String&quot;, # The long value to exclude/include.
              &quot;requestPlatformTargetingValue&quot;: {
                &quot;requestPlatforms&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;stringValue&quot;: &quot;A String&quot;, # The string value to exclude/include.
            },
          ],
          &quot;key&quot;: &quot;A String&quot;, # The key representing the shared targeting criterion.
        },
      ],
      &quot;syndicationProduct&quot;: &quot;A String&quot;, # The syndication product associated with the deal. (readonly, except on create)
      &quot;terms&quot;: { # The negotiable terms of the deal. (updatable)
        &quot;brandingType&quot;: &quot;A String&quot;, # Visibility of the URL in bid requests.
        &quot;crossListedExternalDealIdType&quot;: &quot;A String&quot;, # Indicates that this ExternalDealId exists under at least two different AdxInventoryDeals. Currently, the only case that the same ExternalDealId will exist is programmatic cross sell case.
        &quot;description&quot;: &quot;A String&quot;, # Description for the proposed terms of the deal.
        &quot;estimatedGrossSpend&quot;: { # Non-binding estimate of the estimated gross spend for this deal Can be set by buyer or seller.
          &quot;amountMicros&quot;: 3.14, # The price value in micros.
          &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
          &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
          &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
        },
        &quot;estimatedImpressionsPerDay&quot;: &quot;A String&quot;, # Non-binding estimate of the impressions served per day Can be set by buyer or seller.
        &quot;guaranteedFixedPriceTerms&quot;: { # The terms for guaranteed fixed price deals.
          &quot;billingInfo&quot;: { # External billing info for this Deal. This field is relevant when external billing info such as price has a different currency code than DFP/AdX.
            &quot;currencyConversionTimeMs&quot;: &quot;A String&quot;, # The timestamp (in ms since epoch) when the original reservation price for the deal was first converted to DFP currency. This is used to convert the contracted price into buyer&#x27;s currency without discrepancy.
            &quot;dfpLineItemId&quot;: &quot;A String&quot;, # The DFP line item id associated with this deal. For features like CPD, buyers can retrieve the DFP line item for billing reconciliation.
            &quot;originalContractedQuantity&quot;: &quot;A String&quot;, # The original contracted quantity (# impressions) for this deal. To ensure delivery, sometimes the publisher will book the deal with a impression buffer, such that guaranteed_looks is greater than the contracted quantity. However clients are billed using the original contracted quantity.
            &quot;price&quot;: { # The original reservation price for the deal, if the currency code is different from the one used in negotiation.
              &quot;amountMicros&quot;: 3.14, # The price value in micros.
              &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
              &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
              &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
            },
          },
          &quot;fixedPrices&quot;: [ # Fixed price for the specified buyer.
            { # Used to specify pricing rules for buyers. Each PricePerBuyer in a product can become [0,1] deals. To check if there is a PricePerBuyer for a particular buyer we look for the most specific matching rule - we first look for a rule matching the buyer and otherwise look for a matching rule where no buyer is set.
              &quot;auctionTier&quot;: &quot;A String&quot;, # Optional access type for this buyer.
              &quot;billedBuyer&quot;: { # Reference to the buyer that will get billed.
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;buyer&quot;: { # The buyer who will pay this price. If unset, all buyers can pay this price (if the advertisers match, and there&#x27;s no more specific rule matching the buyer).
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;price&quot;: { # The specified price
                &quot;amountMicros&quot;: 3.14, # The price value in micros.
                &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
                &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
                &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
              },
            },
          ],
          &quot;guaranteedImpressions&quot;: &quot;A String&quot;, # Guaranteed impressions as a percentage. This is the percentage of guaranteed looks that the buyer is guaranteeing to buy.
          &quot;guaranteedLooks&quot;: &quot;A String&quot;, # Count of guaranteed looks. Required for deal, optional for product. For CPD deals, buyer changes to guaranteed_looks will be ignored.
          &quot;minimumDailyLooks&quot;: &quot;A String&quot;, # Count of minimum daily looks for a CPD deal. For CPD deals, buyer should negotiate on this field instead of guaranteed_looks.
        },
        &quot;nonGuaranteedAuctionTerms&quot;: { # The terms for non-guaranteed auction deals.
          &quot;autoOptimizePrivateAuction&quot;: True or False, # True if open auction buyers are allowed to compete with invited buyers in this private auction (buyer-readonly).
          &quot;reservePricePerBuyers&quot;: [ # Reserve price for the specified buyer.
            { # Used to specify pricing rules for buyers. Each PricePerBuyer in a product can become [0,1] deals. To check if there is a PricePerBuyer for a particular buyer we look for the most specific matching rule - we first look for a rule matching the buyer and otherwise look for a matching rule where no buyer is set.
              &quot;auctionTier&quot;: &quot;A String&quot;, # Optional access type for this buyer.
              &quot;billedBuyer&quot;: { # Reference to the buyer that will get billed.
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;buyer&quot;: { # The buyer who will pay this price. If unset, all buyers can pay this price (if the advertisers match, and there&#x27;s no more specific rule matching the buyer).
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;price&quot;: { # The specified price
                &quot;amountMicros&quot;: 3.14, # The price value in micros.
                &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
                &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
                &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
              },
            },
          ],
        },
        &quot;nonGuaranteedFixedPriceTerms&quot;: { # The terms for non-guaranteed fixed price deals.
          &quot;fixedPrices&quot;: [ # Fixed price for the specified buyer.
            { # Used to specify pricing rules for buyers. Each PricePerBuyer in a product can become [0,1] deals. To check if there is a PricePerBuyer for a particular buyer we look for the most specific matching rule - we first look for a rule matching the buyer and otherwise look for a matching rule where no buyer is set.
              &quot;auctionTier&quot;: &quot;A String&quot;, # Optional access type for this buyer.
              &quot;billedBuyer&quot;: { # Reference to the buyer that will get billed.
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;buyer&quot;: { # The buyer who will pay this price. If unset, all buyers can pay this price (if the advertisers match, and there&#x27;s no more specific rule matching the buyer).
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;price&quot;: { # The specified price
                &quot;amountMicros&quot;: 3.14, # The price value in micros.
                &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
                &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
                &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
              },
            },
          ],
        },
        &quot;rubiconNonGuaranteedTerms&quot;: { # The terms for rubicon non-guaranteed deals.
          &quot;priorityPrice&quot;: { # Optional price for Rubicon priority access in the auction.
            &quot;amountMicros&quot;: 3.14, # The price value in micros.
            &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
            &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
            &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
          },
          &quot;standardPrice&quot;: { # Optional price for Rubicon standard access in the auction.
            &quot;amountMicros&quot;: 3.14, # The price value in micros.
            &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
            &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
            &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
          },
        },
        &quot;sellerTimeZone&quot;: &quot;A String&quot;, # For deals with Cost Per Day billing, defines the timezone used to mark the boundaries of a day (buyer-readonly)
      },
      &quot;webPropertyCode&quot;: &quot;A String&quot;,
    },
  ],
  &quot;proposalRevisionNumber&quot;: &quot;A String&quot;, # The last known proposal revision number.
  &quot;updateAction&quot;: &quot;A String&quot;, # Indicates an optional action to take on the proposal
}


Returns:
  An object of the form:

    {
  &quot;deals&quot;: [ # List of deals added (in the same proposal as passed in the request)
    { # A proposal can contain multiple deals. A deal contains the terms and targeting information that is used for serving.
      &quot;buyerPrivateData&quot;: { # Buyer private data (hidden from seller).
        &quot;referenceId&quot;: &quot;A String&quot;,
        &quot;referencePayload&quot;: &quot;A String&quot;,
      },
      &quot;creationTimeMs&quot;: &quot;A String&quot;, # The time (ms since epoch) of the deal creation. (readonly)
      &quot;creativePreApprovalPolicy&quot;: &quot;A String&quot;, # Specifies the creative pre-approval policy (buyer-readonly)
      &quot;creativeSafeFrameCompatibility&quot;: &quot;A String&quot;, # Specifies whether the creative is safeFrame compatible (buyer-readonly)
      &quot;dealId&quot;: &quot;A String&quot;, # A unique deal-id for the deal (readonly).
      &quot;dealServingMetadata&quot;: { # Metadata about the serving status of this deal (readonly, writes via custom actions)
        &quot;alcoholAdsAllowed&quot;: True or False, # True if alcohol ads are allowed for this deal (read-only). This field is only populated when querying for finalized orders using the method GetFinalizedOrderDeals
        &quot;dealPauseStatus&quot;: { # Tracks which parties (if any) have paused a deal. The deal is considered paused if has_buyer_paused || has_seller_paused. Each of the has_buyer_paused or the has_seller_paused bits can be set independently. # Tracks which parties (if any) have paused a deal. (readonly, except via PauseResumeOrderDeals action)
          &quot;buyerPauseReason&quot;: &quot;A String&quot;,
          &quot;firstPausedBy&quot;: &quot;A String&quot;, # If the deal is paused, records which party paused the deal first.
          &quot;hasBuyerPaused&quot;: True or False,
          &quot;hasSellerPaused&quot;: True or False,
          &quot;sellerPauseReason&quot;: &quot;A String&quot;,
        },
      },
      &quot;deliveryControl&quot;: { # The set of fields around delivery control that are interesting for a buyer to see but are non-negotiable. These are set by the publisher. This message is assigned an id of 100 since some day we would want to model this as a protobuf extension.
        &quot;creativeBlockingLevel&quot;: &quot;A String&quot;,
        &quot;deliveryRateType&quot;: &quot;A String&quot;,
        &quot;frequencyCaps&quot;: [
          {
            &quot;maxImpressions&quot;: 42,
            &quot;numTimeUnits&quot;: 42,
            &quot;timeUnitType&quot;: &quot;A String&quot;,
          },
        ],
      },
      &quot;externalDealId&quot;: &quot;A String&quot;, # The external deal id assigned to this deal once the deal is finalized. This is the deal-id that shows up in serving/reporting etc. (readonly)
      &quot;flightEndTimeMs&quot;: &quot;A String&quot;, # Proposed flight end time of the deal (ms since epoch) This will generally be stored in a granularity of a second. (updatable)
      &quot;flightStartTimeMs&quot;: &quot;A String&quot;, # Proposed flight start time of the deal (ms since epoch) This will generally be stored in a granularity of a second. (updatable)
      &quot;inventoryDescription&quot;: &quot;A String&quot;, # Description for the deal terms. (buyer-readonly)
      &quot;isRfpTemplate&quot;: True or False, # Indicates whether the current deal is a RFP template. RFP template is created by buyer and not based on seller created products.
      &quot;isSetupComplete&quot;: True or False, # True, if the buyside inventory setup is complete for this deal. (readonly, except via OrderSetupCompleted action)
      &quot;kind&quot;: &quot;adexchangebuyer#marketplaceDeal&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;adexchangebuyer#marketplaceDeal&quot;.
      &quot;lastUpdateTimeMs&quot;: &quot;A String&quot;, # The time (ms since epoch) when the deal was last updated. (readonly)
      &quot;makegoodRequestedReason&quot;: &quot;A String&quot;,
      &quot;name&quot;: &quot;A String&quot;, # The name of the deal. (updatable)
      &quot;productId&quot;: &quot;A String&quot;, # The product-id from which this deal was created. (readonly, except on create)
      &quot;productRevisionNumber&quot;: &quot;A String&quot;, # The revision number of the product that the deal was created from (readonly, except on create)
      &quot;programmaticCreativeSource&quot;: &quot;A String&quot;, # Specifies the creative source for programmatic deals, PUBLISHER means creative is provided by seller and ADVERTISR means creative is provided by buyer. (buyer-readonly)
      &quot;proposalId&quot;: &quot;A String&quot;,
      &quot;sellerContacts&quot;: [ # Optional Seller contact information for the deal (buyer-readonly)
        {
          &quot;email&quot;: &quot;A String&quot;, # Email address of the contact.
          &quot;name&quot;: &quot;A String&quot;, # The name of the contact.
        },
      ],
      &quot;sharedTargetings&quot;: [ # The shared targeting visible to buyers and sellers. Each shared targeting entity is AND&#x27;d together. (updatable)
        {
          &quot;exclusions&quot;: [ # The list of values to exclude from targeting. Each value is AND&#x27;d together.
            {
              &quot;creativeSizeValue&quot;: { # Next Id: 7 # The creative size value to exclude/include.
                &quot;allowedFormats&quot;: [ # The formats allowed by the publisher.
                  &quot;A String&quot;,
                ],
                &quot;companionSizes&quot;: [ # For video size type, the list of companion sizes.
                  {
                    &quot;height&quot;: 42, # The height of the creative.
                    &quot;width&quot;: 42, # The width of the creative.
                  },
                ],
                &quot;creativeSizeType&quot;: &quot;A String&quot;, # The Creative size type.
                &quot;nativeTemplate&quot;: &quot;A String&quot;, # The native template for native ad.
                &quot;size&quot;: { # For regular or video creative size type, specifies the size of the creative.
                  &quot;height&quot;: 42, # The height of the creative.
                  &quot;width&quot;: 42, # The width of the creative.
                },
                &quot;skippableAdType&quot;: &quot;A String&quot;, # The skippable ad type for video size.
              },
              &quot;dayPartTargetingValue&quot;: { # The daypart targeting to include / exclude. Filled in when the key is GOOG_DAYPART_TARGETING.
                &quot;dayParts&quot;: [
                  {
                    &quot;dayOfWeek&quot;: &quot;A String&quot;,
                    &quot;endHour&quot;: 42,
                    &quot;endMinute&quot;: 42,
                    &quot;startHour&quot;: 42,
                    &quot;startMinute&quot;: 42,
                  },
                ],
                &quot;timeZoneType&quot;: &quot;A String&quot;,
              },
              &quot;demogAgeCriteriaValue&quot;: {
                &quot;demogAgeCriteriaIds&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;demogGenderCriteriaValue&quot;: {
                &quot;demogGenderCriteriaIds&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;longValue&quot;: &quot;A String&quot;, # The long value to exclude/include.
              &quot;requestPlatformTargetingValue&quot;: {
                &quot;requestPlatforms&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;stringValue&quot;: &quot;A String&quot;, # The string value to exclude/include.
            },
          ],
          &quot;inclusions&quot;: [ # The list of value to include as part of the targeting. Each value is OR&#x27;d together.
            {
              &quot;creativeSizeValue&quot;: { # Next Id: 7 # The creative size value to exclude/include.
                &quot;allowedFormats&quot;: [ # The formats allowed by the publisher.
                  &quot;A String&quot;,
                ],
                &quot;companionSizes&quot;: [ # For video size type, the list of companion sizes.
                  {
                    &quot;height&quot;: 42, # The height of the creative.
                    &quot;width&quot;: 42, # The width of the creative.
                  },
                ],
                &quot;creativeSizeType&quot;: &quot;A String&quot;, # The Creative size type.
                &quot;nativeTemplate&quot;: &quot;A String&quot;, # The native template for native ad.
                &quot;size&quot;: { # For regular or video creative size type, specifies the size of the creative.
                  &quot;height&quot;: 42, # The height of the creative.
                  &quot;width&quot;: 42, # The width of the creative.
                },
                &quot;skippableAdType&quot;: &quot;A String&quot;, # The skippable ad type for video size.
              },
              &quot;dayPartTargetingValue&quot;: { # The daypart targeting to include / exclude. Filled in when the key is GOOG_DAYPART_TARGETING.
                &quot;dayParts&quot;: [
                  {
                    &quot;dayOfWeek&quot;: &quot;A String&quot;,
                    &quot;endHour&quot;: 42,
                    &quot;endMinute&quot;: 42,
                    &quot;startHour&quot;: 42,
                    &quot;startMinute&quot;: 42,
                  },
                ],
                &quot;timeZoneType&quot;: &quot;A String&quot;,
              },
              &quot;demogAgeCriteriaValue&quot;: {
                &quot;demogAgeCriteriaIds&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;demogGenderCriteriaValue&quot;: {
                &quot;demogGenderCriteriaIds&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;longValue&quot;: &quot;A String&quot;, # The long value to exclude/include.
              &quot;requestPlatformTargetingValue&quot;: {
                &quot;requestPlatforms&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;stringValue&quot;: &quot;A String&quot;, # The string value to exclude/include.
            },
          ],
          &quot;key&quot;: &quot;A String&quot;, # The key representing the shared targeting criterion.
        },
      ],
      &quot;syndicationProduct&quot;: &quot;A String&quot;, # The syndication product associated with the deal. (readonly, except on create)
      &quot;terms&quot;: { # The negotiable terms of the deal. (updatable)
        &quot;brandingType&quot;: &quot;A String&quot;, # Visibility of the URL in bid requests.
        &quot;crossListedExternalDealIdType&quot;: &quot;A String&quot;, # Indicates that this ExternalDealId exists under at least two different AdxInventoryDeals. Currently, the only case that the same ExternalDealId will exist is programmatic cross sell case.
        &quot;description&quot;: &quot;A String&quot;, # Description for the proposed terms of the deal.
        &quot;estimatedGrossSpend&quot;: { # Non-binding estimate of the estimated gross spend for this deal Can be set by buyer or seller.
          &quot;amountMicros&quot;: 3.14, # The price value in micros.
          &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
          &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
          &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
        },
        &quot;estimatedImpressionsPerDay&quot;: &quot;A String&quot;, # Non-binding estimate of the impressions served per day Can be set by buyer or seller.
        &quot;guaranteedFixedPriceTerms&quot;: { # The terms for guaranteed fixed price deals.
          &quot;billingInfo&quot;: { # External billing info for this Deal. This field is relevant when external billing info such as price has a different currency code than DFP/AdX.
            &quot;currencyConversionTimeMs&quot;: &quot;A String&quot;, # The timestamp (in ms since epoch) when the original reservation price for the deal was first converted to DFP currency. This is used to convert the contracted price into buyer&#x27;s currency without discrepancy.
            &quot;dfpLineItemId&quot;: &quot;A String&quot;, # The DFP line item id associated with this deal. For features like CPD, buyers can retrieve the DFP line item for billing reconciliation.
            &quot;originalContractedQuantity&quot;: &quot;A String&quot;, # The original contracted quantity (# impressions) for this deal. To ensure delivery, sometimes the publisher will book the deal with a impression buffer, such that guaranteed_looks is greater than the contracted quantity. However clients are billed using the original contracted quantity.
            &quot;price&quot;: { # The original reservation price for the deal, if the currency code is different from the one used in negotiation.
              &quot;amountMicros&quot;: 3.14, # The price value in micros.
              &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
              &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
              &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
            },
          },
          &quot;fixedPrices&quot;: [ # Fixed price for the specified buyer.
            { # Used to specify pricing rules for buyers. Each PricePerBuyer in a product can become [0,1] deals. To check if there is a PricePerBuyer for a particular buyer we look for the most specific matching rule - we first look for a rule matching the buyer and otherwise look for a matching rule where no buyer is set.
              &quot;auctionTier&quot;: &quot;A String&quot;, # Optional access type for this buyer.
              &quot;billedBuyer&quot;: { # Reference to the buyer that will get billed.
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;buyer&quot;: { # The buyer who will pay this price. If unset, all buyers can pay this price (if the advertisers match, and there&#x27;s no more specific rule matching the buyer).
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;price&quot;: { # The specified price
                &quot;amountMicros&quot;: 3.14, # The price value in micros.
                &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
                &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
                &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
              },
            },
          ],
          &quot;guaranteedImpressions&quot;: &quot;A String&quot;, # Guaranteed impressions as a percentage. This is the percentage of guaranteed looks that the buyer is guaranteeing to buy.
          &quot;guaranteedLooks&quot;: &quot;A String&quot;, # Count of guaranteed looks. Required for deal, optional for product. For CPD deals, buyer changes to guaranteed_looks will be ignored.
          &quot;minimumDailyLooks&quot;: &quot;A String&quot;, # Count of minimum daily looks for a CPD deal. For CPD deals, buyer should negotiate on this field instead of guaranteed_looks.
        },
        &quot;nonGuaranteedAuctionTerms&quot;: { # The terms for non-guaranteed auction deals.
          &quot;autoOptimizePrivateAuction&quot;: True or False, # True if open auction buyers are allowed to compete with invited buyers in this private auction (buyer-readonly).
          &quot;reservePricePerBuyers&quot;: [ # Reserve price for the specified buyer.
            { # Used to specify pricing rules for buyers. Each PricePerBuyer in a product can become [0,1] deals. To check if there is a PricePerBuyer for a particular buyer we look for the most specific matching rule - we first look for a rule matching the buyer and otherwise look for a matching rule where no buyer is set.
              &quot;auctionTier&quot;: &quot;A String&quot;, # Optional access type for this buyer.
              &quot;billedBuyer&quot;: { # Reference to the buyer that will get billed.
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;buyer&quot;: { # The buyer who will pay this price. If unset, all buyers can pay this price (if the advertisers match, and there&#x27;s no more specific rule matching the buyer).
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;price&quot;: { # The specified price
                &quot;amountMicros&quot;: 3.14, # The price value in micros.
                &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
                &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
                &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
              },
            },
          ],
        },
        &quot;nonGuaranteedFixedPriceTerms&quot;: { # The terms for non-guaranteed fixed price deals.
          &quot;fixedPrices&quot;: [ # Fixed price for the specified buyer.
            { # Used to specify pricing rules for buyers. Each PricePerBuyer in a product can become [0,1] deals. To check if there is a PricePerBuyer for a particular buyer we look for the most specific matching rule - we first look for a rule matching the buyer and otherwise look for a matching rule where no buyer is set.
              &quot;auctionTier&quot;: &quot;A String&quot;, # Optional access type for this buyer.
              &quot;billedBuyer&quot;: { # Reference to the buyer that will get billed.
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;buyer&quot;: { # The buyer who will pay this price. If unset, all buyers can pay this price (if the advertisers match, and there&#x27;s no more specific rule matching the buyer).
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;price&quot;: { # The specified price
                &quot;amountMicros&quot;: 3.14, # The price value in micros.
                &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
                &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
                &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
              },
            },
          ],
        },
        &quot;rubiconNonGuaranteedTerms&quot;: { # The terms for rubicon non-guaranteed deals.
          &quot;priorityPrice&quot;: { # Optional price for Rubicon priority access in the auction.
            &quot;amountMicros&quot;: 3.14, # The price value in micros.
            &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
            &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
            &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
          },
          &quot;standardPrice&quot;: { # Optional price for Rubicon standard access in the auction.
            &quot;amountMicros&quot;: 3.14, # The price value in micros.
            &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
            &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
            &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
          },
        },
        &quot;sellerTimeZone&quot;: &quot;A String&quot;, # For deals with Cost Per Day billing, defines the timezone used to mark the boundaries of a day (buyer-readonly)
      },
      &quot;webPropertyCode&quot;: &quot;A String&quot;,
    },
  ],
  &quot;proposalRevisionNumber&quot;: &quot;A String&quot;, # The updated revision number for the proposal.
}</pre>
</div>

<div class="method">
    <code class="details" id="list">list(proposalId, pqlQuery=None)</code>
  <pre>List all the deals for a given proposal

Args:
  proposalId: string, The proposalId to get deals for. To search across all proposals specify order_id = &#x27;-&#x27; as part of the URL. (required)
  pqlQuery: string, Query string to retrieve specific deals.

Returns:
  An object of the form:

    {
  &quot;deals&quot;: [ # List of deals for the proposal
    { # A proposal can contain multiple deals. A deal contains the terms and targeting information that is used for serving.
      &quot;buyerPrivateData&quot;: { # Buyer private data (hidden from seller).
        &quot;referenceId&quot;: &quot;A String&quot;,
        &quot;referencePayload&quot;: &quot;A String&quot;,
      },
      &quot;creationTimeMs&quot;: &quot;A String&quot;, # The time (ms since epoch) of the deal creation. (readonly)
      &quot;creativePreApprovalPolicy&quot;: &quot;A String&quot;, # Specifies the creative pre-approval policy (buyer-readonly)
      &quot;creativeSafeFrameCompatibility&quot;: &quot;A String&quot;, # Specifies whether the creative is safeFrame compatible (buyer-readonly)
      &quot;dealId&quot;: &quot;A String&quot;, # A unique deal-id for the deal (readonly).
      &quot;dealServingMetadata&quot;: { # Metadata about the serving status of this deal (readonly, writes via custom actions)
        &quot;alcoholAdsAllowed&quot;: True or False, # True if alcohol ads are allowed for this deal (read-only). This field is only populated when querying for finalized orders using the method GetFinalizedOrderDeals
        &quot;dealPauseStatus&quot;: { # Tracks which parties (if any) have paused a deal. The deal is considered paused if has_buyer_paused || has_seller_paused. Each of the has_buyer_paused or the has_seller_paused bits can be set independently. # Tracks which parties (if any) have paused a deal. (readonly, except via PauseResumeOrderDeals action)
          &quot;buyerPauseReason&quot;: &quot;A String&quot;,
          &quot;firstPausedBy&quot;: &quot;A String&quot;, # If the deal is paused, records which party paused the deal first.
          &quot;hasBuyerPaused&quot;: True or False,
          &quot;hasSellerPaused&quot;: True or False,
          &quot;sellerPauseReason&quot;: &quot;A String&quot;,
        },
      },
      &quot;deliveryControl&quot;: { # The set of fields around delivery control that are interesting for a buyer to see but are non-negotiable. These are set by the publisher. This message is assigned an id of 100 since some day we would want to model this as a protobuf extension.
        &quot;creativeBlockingLevel&quot;: &quot;A String&quot;,
        &quot;deliveryRateType&quot;: &quot;A String&quot;,
        &quot;frequencyCaps&quot;: [
          {
            &quot;maxImpressions&quot;: 42,
            &quot;numTimeUnits&quot;: 42,
            &quot;timeUnitType&quot;: &quot;A String&quot;,
          },
        ],
      },
      &quot;externalDealId&quot;: &quot;A String&quot;, # The external deal id assigned to this deal once the deal is finalized. This is the deal-id that shows up in serving/reporting etc. (readonly)
      &quot;flightEndTimeMs&quot;: &quot;A String&quot;, # Proposed flight end time of the deal (ms since epoch) This will generally be stored in a granularity of a second. (updatable)
      &quot;flightStartTimeMs&quot;: &quot;A String&quot;, # Proposed flight start time of the deal (ms since epoch) This will generally be stored in a granularity of a second. (updatable)
      &quot;inventoryDescription&quot;: &quot;A String&quot;, # Description for the deal terms. (buyer-readonly)
      &quot;isRfpTemplate&quot;: True or False, # Indicates whether the current deal is a RFP template. RFP template is created by buyer and not based on seller created products.
      &quot;isSetupComplete&quot;: True or False, # True, if the buyside inventory setup is complete for this deal. (readonly, except via OrderSetupCompleted action)
      &quot;kind&quot;: &quot;adexchangebuyer#marketplaceDeal&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;adexchangebuyer#marketplaceDeal&quot;.
      &quot;lastUpdateTimeMs&quot;: &quot;A String&quot;, # The time (ms since epoch) when the deal was last updated. (readonly)
      &quot;makegoodRequestedReason&quot;: &quot;A String&quot;,
      &quot;name&quot;: &quot;A String&quot;, # The name of the deal. (updatable)
      &quot;productId&quot;: &quot;A String&quot;, # The product-id from which this deal was created. (readonly, except on create)
      &quot;productRevisionNumber&quot;: &quot;A String&quot;, # The revision number of the product that the deal was created from (readonly, except on create)
      &quot;programmaticCreativeSource&quot;: &quot;A String&quot;, # Specifies the creative source for programmatic deals, PUBLISHER means creative is provided by seller and ADVERTISR means creative is provided by buyer. (buyer-readonly)
      &quot;proposalId&quot;: &quot;A String&quot;,
      &quot;sellerContacts&quot;: [ # Optional Seller contact information for the deal (buyer-readonly)
        {
          &quot;email&quot;: &quot;A String&quot;, # Email address of the contact.
          &quot;name&quot;: &quot;A String&quot;, # The name of the contact.
        },
      ],
      &quot;sharedTargetings&quot;: [ # The shared targeting visible to buyers and sellers. Each shared targeting entity is AND&#x27;d together. (updatable)
        {
          &quot;exclusions&quot;: [ # The list of values to exclude from targeting. Each value is AND&#x27;d together.
            {
              &quot;creativeSizeValue&quot;: { # Next Id: 7 # The creative size value to exclude/include.
                &quot;allowedFormats&quot;: [ # The formats allowed by the publisher.
                  &quot;A String&quot;,
                ],
                &quot;companionSizes&quot;: [ # For video size type, the list of companion sizes.
                  {
                    &quot;height&quot;: 42, # The height of the creative.
                    &quot;width&quot;: 42, # The width of the creative.
                  },
                ],
                &quot;creativeSizeType&quot;: &quot;A String&quot;, # The Creative size type.
                &quot;nativeTemplate&quot;: &quot;A String&quot;, # The native template for native ad.
                &quot;size&quot;: { # For regular or video creative size type, specifies the size of the creative.
                  &quot;height&quot;: 42, # The height of the creative.
                  &quot;width&quot;: 42, # The width of the creative.
                },
                &quot;skippableAdType&quot;: &quot;A String&quot;, # The skippable ad type for video size.
              },
              &quot;dayPartTargetingValue&quot;: { # The daypart targeting to include / exclude. Filled in when the key is GOOG_DAYPART_TARGETING.
                &quot;dayParts&quot;: [
                  {
                    &quot;dayOfWeek&quot;: &quot;A String&quot;,
                    &quot;endHour&quot;: 42,
                    &quot;endMinute&quot;: 42,
                    &quot;startHour&quot;: 42,
                    &quot;startMinute&quot;: 42,
                  },
                ],
                &quot;timeZoneType&quot;: &quot;A String&quot;,
              },
              &quot;demogAgeCriteriaValue&quot;: {
                &quot;demogAgeCriteriaIds&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;demogGenderCriteriaValue&quot;: {
                &quot;demogGenderCriteriaIds&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;longValue&quot;: &quot;A String&quot;, # The long value to exclude/include.
              &quot;requestPlatformTargetingValue&quot;: {
                &quot;requestPlatforms&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;stringValue&quot;: &quot;A String&quot;, # The string value to exclude/include.
            },
          ],
          &quot;inclusions&quot;: [ # The list of value to include as part of the targeting. Each value is OR&#x27;d together.
            {
              &quot;creativeSizeValue&quot;: { # Next Id: 7 # The creative size value to exclude/include.
                &quot;allowedFormats&quot;: [ # The formats allowed by the publisher.
                  &quot;A String&quot;,
                ],
                &quot;companionSizes&quot;: [ # For video size type, the list of companion sizes.
                  {
                    &quot;height&quot;: 42, # The height of the creative.
                    &quot;width&quot;: 42, # The width of the creative.
                  },
                ],
                &quot;creativeSizeType&quot;: &quot;A String&quot;, # The Creative size type.
                &quot;nativeTemplate&quot;: &quot;A String&quot;, # The native template for native ad.
                &quot;size&quot;: { # For regular or video creative size type, specifies the size of the creative.
                  &quot;height&quot;: 42, # The height of the creative.
                  &quot;width&quot;: 42, # The width of the creative.
                },
                &quot;skippableAdType&quot;: &quot;A String&quot;, # The skippable ad type for video size.
              },
              &quot;dayPartTargetingValue&quot;: { # The daypart targeting to include / exclude. Filled in when the key is GOOG_DAYPART_TARGETING.
                &quot;dayParts&quot;: [
                  {
                    &quot;dayOfWeek&quot;: &quot;A String&quot;,
                    &quot;endHour&quot;: 42,
                    &quot;endMinute&quot;: 42,
                    &quot;startHour&quot;: 42,
                    &quot;startMinute&quot;: 42,
                  },
                ],
                &quot;timeZoneType&quot;: &quot;A String&quot;,
              },
              &quot;demogAgeCriteriaValue&quot;: {
                &quot;demogAgeCriteriaIds&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;demogGenderCriteriaValue&quot;: {
                &quot;demogGenderCriteriaIds&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;longValue&quot;: &quot;A String&quot;, # The long value to exclude/include.
              &quot;requestPlatformTargetingValue&quot;: {
                &quot;requestPlatforms&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;stringValue&quot;: &quot;A String&quot;, # The string value to exclude/include.
            },
          ],
          &quot;key&quot;: &quot;A String&quot;, # The key representing the shared targeting criterion.
        },
      ],
      &quot;syndicationProduct&quot;: &quot;A String&quot;, # The syndication product associated with the deal. (readonly, except on create)
      &quot;terms&quot;: { # The negotiable terms of the deal. (updatable)
        &quot;brandingType&quot;: &quot;A String&quot;, # Visibility of the URL in bid requests.
        &quot;crossListedExternalDealIdType&quot;: &quot;A String&quot;, # Indicates that this ExternalDealId exists under at least two different AdxInventoryDeals. Currently, the only case that the same ExternalDealId will exist is programmatic cross sell case.
        &quot;description&quot;: &quot;A String&quot;, # Description for the proposed terms of the deal.
        &quot;estimatedGrossSpend&quot;: { # Non-binding estimate of the estimated gross spend for this deal Can be set by buyer or seller.
          &quot;amountMicros&quot;: 3.14, # The price value in micros.
          &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
          &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
          &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
        },
        &quot;estimatedImpressionsPerDay&quot;: &quot;A String&quot;, # Non-binding estimate of the impressions served per day Can be set by buyer or seller.
        &quot;guaranteedFixedPriceTerms&quot;: { # The terms for guaranteed fixed price deals.
          &quot;billingInfo&quot;: { # External billing info for this Deal. This field is relevant when external billing info such as price has a different currency code than DFP/AdX.
            &quot;currencyConversionTimeMs&quot;: &quot;A String&quot;, # The timestamp (in ms since epoch) when the original reservation price for the deal was first converted to DFP currency. This is used to convert the contracted price into buyer&#x27;s currency without discrepancy.
            &quot;dfpLineItemId&quot;: &quot;A String&quot;, # The DFP line item id associated with this deal. For features like CPD, buyers can retrieve the DFP line item for billing reconciliation.
            &quot;originalContractedQuantity&quot;: &quot;A String&quot;, # The original contracted quantity (# impressions) for this deal. To ensure delivery, sometimes the publisher will book the deal with a impression buffer, such that guaranteed_looks is greater than the contracted quantity. However clients are billed using the original contracted quantity.
            &quot;price&quot;: { # The original reservation price for the deal, if the currency code is different from the one used in negotiation.
              &quot;amountMicros&quot;: 3.14, # The price value in micros.
              &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
              &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
              &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
            },
          },
          &quot;fixedPrices&quot;: [ # Fixed price for the specified buyer.
            { # Used to specify pricing rules for buyers. Each PricePerBuyer in a product can become [0,1] deals. To check if there is a PricePerBuyer for a particular buyer we look for the most specific matching rule - we first look for a rule matching the buyer and otherwise look for a matching rule where no buyer is set.
              &quot;auctionTier&quot;: &quot;A String&quot;, # Optional access type for this buyer.
              &quot;billedBuyer&quot;: { # Reference to the buyer that will get billed.
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;buyer&quot;: { # The buyer who will pay this price. If unset, all buyers can pay this price (if the advertisers match, and there&#x27;s no more specific rule matching the buyer).
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;price&quot;: { # The specified price
                &quot;amountMicros&quot;: 3.14, # The price value in micros.
                &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
                &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
                &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
              },
            },
          ],
          &quot;guaranteedImpressions&quot;: &quot;A String&quot;, # Guaranteed impressions as a percentage. This is the percentage of guaranteed looks that the buyer is guaranteeing to buy.
          &quot;guaranteedLooks&quot;: &quot;A String&quot;, # Count of guaranteed looks. Required for deal, optional for product. For CPD deals, buyer changes to guaranteed_looks will be ignored.
          &quot;minimumDailyLooks&quot;: &quot;A String&quot;, # Count of minimum daily looks for a CPD deal. For CPD deals, buyer should negotiate on this field instead of guaranteed_looks.
        },
        &quot;nonGuaranteedAuctionTerms&quot;: { # The terms for non-guaranteed auction deals.
          &quot;autoOptimizePrivateAuction&quot;: True or False, # True if open auction buyers are allowed to compete with invited buyers in this private auction (buyer-readonly).
          &quot;reservePricePerBuyers&quot;: [ # Reserve price for the specified buyer.
            { # Used to specify pricing rules for buyers. Each PricePerBuyer in a product can become [0,1] deals. To check if there is a PricePerBuyer for a particular buyer we look for the most specific matching rule - we first look for a rule matching the buyer and otherwise look for a matching rule where no buyer is set.
              &quot;auctionTier&quot;: &quot;A String&quot;, # Optional access type for this buyer.
              &quot;billedBuyer&quot;: { # Reference to the buyer that will get billed.
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;buyer&quot;: { # The buyer who will pay this price. If unset, all buyers can pay this price (if the advertisers match, and there&#x27;s no more specific rule matching the buyer).
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;price&quot;: { # The specified price
                &quot;amountMicros&quot;: 3.14, # The price value in micros.
                &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
                &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
                &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
              },
            },
          ],
        },
        &quot;nonGuaranteedFixedPriceTerms&quot;: { # The terms for non-guaranteed fixed price deals.
          &quot;fixedPrices&quot;: [ # Fixed price for the specified buyer.
            { # Used to specify pricing rules for buyers. Each PricePerBuyer in a product can become [0,1] deals. To check if there is a PricePerBuyer for a particular buyer we look for the most specific matching rule - we first look for a rule matching the buyer and otherwise look for a matching rule where no buyer is set.
              &quot;auctionTier&quot;: &quot;A String&quot;, # Optional access type for this buyer.
              &quot;billedBuyer&quot;: { # Reference to the buyer that will get billed.
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;buyer&quot;: { # The buyer who will pay this price. If unset, all buyers can pay this price (if the advertisers match, and there&#x27;s no more specific rule matching the buyer).
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;price&quot;: { # The specified price
                &quot;amountMicros&quot;: 3.14, # The price value in micros.
                &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
                &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
                &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
              },
            },
          ],
        },
        &quot;rubiconNonGuaranteedTerms&quot;: { # The terms for rubicon non-guaranteed deals.
          &quot;priorityPrice&quot;: { # Optional price for Rubicon priority access in the auction.
            &quot;amountMicros&quot;: 3.14, # The price value in micros.
            &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
            &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
            &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
          },
          &quot;standardPrice&quot;: { # Optional price for Rubicon standard access in the auction.
            &quot;amountMicros&quot;: 3.14, # The price value in micros.
            &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
            &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
            &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
          },
        },
        &quot;sellerTimeZone&quot;: &quot;A String&quot;, # For deals with Cost Per Day billing, defines the timezone used to mark the boundaries of a day (buyer-readonly)
      },
      &quot;webPropertyCode&quot;: &quot;A String&quot;,
    },
  ],
}</pre>
</div>

<div class="method">
    <code class="details" id="update">update(proposalId, body=None)</code>
  <pre>Replaces all the deals in the proposal with the passed in deals

Args:
  proposalId: string, The proposalId to edit deals on. (required)
  body: object, The request body.
    The object takes the form of:

{
  &quot;deals&quot;: [ # List of deals to edit. Service may perform 3 different operations based on comparison of deals in this list vs deals already persisted in database: 1. Add new deal to proposal If a deal in this list does not exist in the proposal, the service will create a new deal and add it to the proposal. Validation will follow AddOrderDealsRequest. 2. Update existing deal in the proposal If a deal in this list already exist in the proposal, the service will update that existing deal to this new deal in the request. Validation will follow UpdateOrderDealsRequest. 3. Delete deals from the proposal (just need the id) If a existing deal in the proposal is not present in this list, the service will delete that deal from the proposal. Validation will follow DeleteOrderDealsRequest.
    { # A proposal can contain multiple deals. A deal contains the terms and targeting information that is used for serving.
      &quot;buyerPrivateData&quot;: { # Buyer private data (hidden from seller).
        &quot;referenceId&quot;: &quot;A String&quot;,
        &quot;referencePayload&quot;: &quot;A String&quot;,
      },
      &quot;creationTimeMs&quot;: &quot;A String&quot;, # The time (ms since epoch) of the deal creation. (readonly)
      &quot;creativePreApprovalPolicy&quot;: &quot;A String&quot;, # Specifies the creative pre-approval policy (buyer-readonly)
      &quot;creativeSafeFrameCompatibility&quot;: &quot;A String&quot;, # Specifies whether the creative is safeFrame compatible (buyer-readonly)
      &quot;dealId&quot;: &quot;A String&quot;, # A unique deal-id for the deal (readonly).
      &quot;dealServingMetadata&quot;: { # Metadata about the serving status of this deal (readonly, writes via custom actions)
        &quot;alcoholAdsAllowed&quot;: True or False, # True if alcohol ads are allowed for this deal (read-only). This field is only populated when querying for finalized orders using the method GetFinalizedOrderDeals
        &quot;dealPauseStatus&quot;: { # Tracks which parties (if any) have paused a deal. The deal is considered paused if has_buyer_paused || has_seller_paused. Each of the has_buyer_paused or the has_seller_paused bits can be set independently. # Tracks which parties (if any) have paused a deal. (readonly, except via PauseResumeOrderDeals action)
          &quot;buyerPauseReason&quot;: &quot;A String&quot;,
          &quot;firstPausedBy&quot;: &quot;A String&quot;, # If the deal is paused, records which party paused the deal first.
          &quot;hasBuyerPaused&quot;: True or False,
          &quot;hasSellerPaused&quot;: True or False,
          &quot;sellerPauseReason&quot;: &quot;A String&quot;,
        },
      },
      &quot;deliveryControl&quot;: { # The set of fields around delivery control that are interesting for a buyer to see but are non-negotiable. These are set by the publisher. This message is assigned an id of 100 since some day we would want to model this as a protobuf extension.
        &quot;creativeBlockingLevel&quot;: &quot;A String&quot;,
        &quot;deliveryRateType&quot;: &quot;A String&quot;,
        &quot;frequencyCaps&quot;: [
          {
            &quot;maxImpressions&quot;: 42,
            &quot;numTimeUnits&quot;: 42,
            &quot;timeUnitType&quot;: &quot;A String&quot;,
          },
        ],
      },
      &quot;externalDealId&quot;: &quot;A String&quot;, # The external deal id assigned to this deal once the deal is finalized. This is the deal-id that shows up in serving/reporting etc. (readonly)
      &quot;flightEndTimeMs&quot;: &quot;A String&quot;, # Proposed flight end time of the deal (ms since epoch) This will generally be stored in a granularity of a second. (updatable)
      &quot;flightStartTimeMs&quot;: &quot;A String&quot;, # Proposed flight start time of the deal (ms since epoch) This will generally be stored in a granularity of a second. (updatable)
      &quot;inventoryDescription&quot;: &quot;A String&quot;, # Description for the deal terms. (buyer-readonly)
      &quot;isRfpTemplate&quot;: True or False, # Indicates whether the current deal is a RFP template. RFP template is created by buyer and not based on seller created products.
      &quot;isSetupComplete&quot;: True or False, # True, if the buyside inventory setup is complete for this deal. (readonly, except via OrderSetupCompleted action)
      &quot;kind&quot;: &quot;adexchangebuyer#marketplaceDeal&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;adexchangebuyer#marketplaceDeal&quot;.
      &quot;lastUpdateTimeMs&quot;: &quot;A String&quot;, # The time (ms since epoch) when the deal was last updated. (readonly)
      &quot;makegoodRequestedReason&quot;: &quot;A String&quot;,
      &quot;name&quot;: &quot;A String&quot;, # The name of the deal. (updatable)
      &quot;productId&quot;: &quot;A String&quot;, # The product-id from which this deal was created. (readonly, except on create)
      &quot;productRevisionNumber&quot;: &quot;A String&quot;, # The revision number of the product that the deal was created from (readonly, except on create)
      &quot;programmaticCreativeSource&quot;: &quot;A String&quot;, # Specifies the creative source for programmatic deals, PUBLISHER means creative is provided by seller and ADVERTISR means creative is provided by buyer. (buyer-readonly)
      &quot;proposalId&quot;: &quot;A String&quot;,
      &quot;sellerContacts&quot;: [ # Optional Seller contact information for the deal (buyer-readonly)
        {
          &quot;email&quot;: &quot;A String&quot;, # Email address of the contact.
          &quot;name&quot;: &quot;A String&quot;, # The name of the contact.
        },
      ],
      &quot;sharedTargetings&quot;: [ # The shared targeting visible to buyers and sellers. Each shared targeting entity is AND&#x27;d together. (updatable)
        {
          &quot;exclusions&quot;: [ # The list of values to exclude from targeting. Each value is AND&#x27;d together.
            {
              &quot;creativeSizeValue&quot;: { # Next Id: 7 # The creative size value to exclude/include.
                &quot;allowedFormats&quot;: [ # The formats allowed by the publisher.
                  &quot;A String&quot;,
                ],
                &quot;companionSizes&quot;: [ # For video size type, the list of companion sizes.
                  {
                    &quot;height&quot;: 42, # The height of the creative.
                    &quot;width&quot;: 42, # The width of the creative.
                  },
                ],
                &quot;creativeSizeType&quot;: &quot;A String&quot;, # The Creative size type.
                &quot;nativeTemplate&quot;: &quot;A String&quot;, # The native template for native ad.
                &quot;size&quot;: { # For regular or video creative size type, specifies the size of the creative.
                  &quot;height&quot;: 42, # The height of the creative.
                  &quot;width&quot;: 42, # The width of the creative.
                },
                &quot;skippableAdType&quot;: &quot;A String&quot;, # The skippable ad type for video size.
              },
              &quot;dayPartTargetingValue&quot;: { # The daypart targeting to include / exclude. Filled in when the key is GOOG_DAYPART_TARGETING.
                &quot;dayParts&quot;: [
                  {
                    &quot;dayOfWeek&quot;: &quot;A String&quot;,
                    &quot;endHour&quot;: 42,
                    &quot;endMinute&quot;: 42,
                    &quot;startHour&quot;: 42,
                    &quot;startMinute&quot;: 42,
                  },
                ],
                &quot;timeZoneType&quot;: &quot;A String&quot;,
              },
              &quot;demogAgeCriteriaValue&quot;: {
                &quot;demogAgeCriteriaIds&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;demogGenderCriteriaValue&quot;: {
                &quot;demogGenderCriteriaIds&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;longValue&quot;: &quot;A String&quot;, # The long value to exclude/include.
              &quot;requestPlatformTargetingValue&quot;: {
                &quot;requestPlatforms&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;stringValue&quot;: &quot;A String&quot;, # The string value to exclude/include.
            },
          ],
          &quot;inclusions&quot;: [ # The list of value to include as part of the targeting. Each value is OR&#x27;d together.
            {
              &quot;creativeSizeValue&quot;: { # Next Id: 7 # The creative size value to exclude/include.
                &quot;allowedFormats&quot;: [ # The formats allowed by the publisher.
                  &quot;A String&quot;,
                ],
                &quot;companionSizes&quot;: [ # For video size type, the list of companion sizes.
                  {
                    &quot;height&quot;: 42, # The height of the creative.
                    &quot;width&quot;: 42, # The width of the creative.
                  },
                ],
                &quot;creativeSizeType&quot;: &quot;A String&quot;, # The Creative size type.
                &quot;nativeTemplate&quot;: &quot;A String&quot;, # The native template for native ad.
                &quot;size&quot;: { # For regular or video creative size type, specifies the size of the creative.
                  &quot;height&quot;: 42, # The height of the creative.
                  &quot;width&quot;: 42, # The width of the creative.
                },
                &quot;skippableAdType&quot;: &quot;A String&quot;, # The skippable ad type for video size.
              },
              &quot;dayPartTargetingValue&quot;: { # The daypart targeting to include / exclude. Filled in when the key is GOOG_DAYPART_TARGETING.
                &quot;dayParts&quot;: [
                  {
                    &quot;dayOfWeek&quot;: &quot;A String&quot;,
                    &quot;endHour&quot;: 42,
                    &quot;endMinute&quot;: 42,
                    &quot;startHour&quot;: 42,
                    &quot;startMinute&quot;: 42,
                  },
                ],
                &quot;timeZoneType&quot;: &quot;A String&quot;,
              },
              &quot;demogAgeCriteriaValue&quot;: {
                &quot;demogAgeCriteriaIds&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;demogGenderCriteriaValue&quot;: {
                &quot;demogGenderCriteriaIds&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;longValue&quot;: &quot;A String&quot;, # The long value to exclude/include.
              &quot;requestPlatformTargetingValue&quot;: {
                &quot;requestPlatforms&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;stringValue&quot;: &quot;A String&quot;, # The string value to exclude/include.
            },
          ],
          &quot;key&quot;: &quot;A String&quot;, # The key representing the shared targeting criterion.
        },
      ],
      &quot;syndicationProduct&quot;: &quot;A String&quot;, # The syndication product associated with the deal. (readonly, except on create)
      &quot;terms&quot;: { # The negotiable terms of the deal. (updatable)
        &quot;brandingType&quot;: &quot;A String&quot;, # Visibility of the URL in bid requests.
        &quot;crossListedExternalDealIdType&quot;: &quot;A String&quot;, # Indicates that this ExternalDealId exists under at least two different AdxInventoryDeals. Currently, the only case that the same ExternalDealId will exist is programmatic cross sell case.
        &quot;description&quot;: &quot;A String&quot;, # Description for the proposed terms of the deal.
        &quot;estimatedGrossSpend&quot;: { # Non-binding estimate of the estimated gross spend for this deal Can be set by buyer or seller.
          &quot;amountMicros&quot;: 3.14, # The price value in micros.
          &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
          &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
          &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
        },
        &quot;estimatedImpressionsPerDay&quot;: &quot;A String&quot;, # Non-binding estimate of the impressions served per day Can be set by buyer or seller.
        &quot;guaranteedFixedPriceTerms&quot;: { # The terms for guaranteed fixed price deals.
          &quot;billingInfo&quot;: { # External billing info for this Deal. This field is relevant when external billing info such as price has a different currency code than DFP/AdX.
            &quot;currencyConversionTimeMs&quot;: &quot;A String&quot;, # The timestamp (in ms since epoch) when the original reservation price for the deal was first converted to DFP currency. This is used to convert the contracted price into buyer&#x27;s currency without discrepancy.
            &quot;dfpLineItemId&quot;: &quot;A String&quot;, # The DFP line item id associated with this deal. For features like CPD, buyers can retrieve the DFP line item for billing reconciliation.
            &quot;originalContractedQuantity&quot;: &quot;A String&quot;, # The original contracted quantity (# impressions) for this deal. To ensure delivery, sometimes the publisher will book the deal with a impression buffer, such that guaranteed_looks is greater than the contracted quantity. However clients are billed using the original contracted quantity.
            &quot;price&quot;: { # The original reservation price for the deal, if the currency code is different from the one used in negotiation.
              &quot;amountMicros&quot;: 3.14, # The price value in micros.
              &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
              &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
              &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
            },
          },
          &quot;fixedPrices&quot;: [ # Fixed price for the specified buyer.
            { # Used to specify pricing rules for buyers. Each PricePerBuyer in a product can become [0,1] deals. To check if there is a PricePerBuyer for a particular buyer we look for the most specific matching rule - we first look for a rule matching the buyer and otherwise look for a matching rule where no buyer is set.
              &quot;auctionTier&quot;: &quot;A String&quot;, # Optional access type for this buyer.
              &quot;billedBuyer&quot;: { # Reference to the buyer that will get billed.
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;buyer&quot;: { # The buyer who will pay this price. If unset, all buyers can pay this price (if the advertisers match, and there&#x27;s no more specific rule matching the buyer).
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;price&quot;: { # The specified price
                &quot;amountMicros&quot;: 3.14, # The price value in micros.
                &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
                &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
                &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
              },
            },
          ],
          &quot;guaranteedImpressions&quot;: &quot;A String&quot;, # Guaranteed impressions as a percentage. This is the percentage of guaranteed looks that the buyer is guaranteeing to buy.
          &quot;guaranteedLooks&quot;: &quot;A String&quot;, # Count of guaranteed looks. Required for deal, optional for product. For CPD deals, buyer changes to guaranteed_looks will be ignored.
          &quot;minimumDailyLooks&quot;: &quot;A String&quot;, # Count of minimum daily looks for a CPD deal. For CPD deals, buyer should negotiate on this field instead of guaranteed_looks.
        },
        &quot;nonGuaranteedAuctionTerms&quot;: { # The terms for non-guaranteed auction deals.
          &quot;autoOptimizePrivateAuction&quot;: True or False, # True if open auction buyers are allowed to compete with invited buyers in this private auction (buyer-readonly).
          &quot;reservePricePerBuyers&quot;: [ # Reserve price for the specified buyer.
            { # Used to specify pricing rules for buyers. Each PricePerBuyer in a product can become [0,1] deals. To check if there is a PricePerBuyer for a particular buyer we look for the most specific matching rule - we first look for a rule matching the buyer and otherwise look for a matching rule where no buyer is set.
              &quot;auctionTier&quot;: &quot;A String&quot;, # Optional access type for this buyer.
              &quot;billedBuyer&quot;: { # Reference to the buyer that will get billed.
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;buyer&quot;: { # The buyer who will pay this price. If unset, all buyers can pay this price (if the advertisers match, and there&#x27;s no more specific rule matching the buyer).
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;price&quot;: { # The specified price
                &quot;amountMicros&quot;: 3.14, # The price value in micros.
                &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
                &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
                &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
              },
            },
          ],
        },
        &quot;nonGuaranteedFixedPriceTerms&quot;: { # The terms for non-guaranteed fixed price deals.
          &quot;fixedPrices&quot;: [ # Fixed price for the specified buyer.
            { # Used to specify pricing rules for buyers. Each PricePerBuyer in a product can become [0,1] deals. To check if there is a PricePerBuyer for a particular buyer we look for the most specific matching rule - we first look for a rule matching the buyer and otherwise look for a matching rule where no buyer is set.
              &quot;auctionTier&quot;: &quot;A String&quot;, # Optional access type for this buyer.
              &quot;billedBuyer&quot;: { # Reference to the buyer that will get billed.
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;buyer&quot;: { # The buyer who will pay this price. If unset, all buyers can pay this price (if the advertisers match, and there&#x27;s no more specific rule matching the buyer).
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;price&quot;: { # The specified price
                &quot;amountMicros&quot;: 3.14, # The price value in micros.
                &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
                &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
                &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
              },
            },
          ],
        },
        &quot;rubiconNonGuaranteedTerms&quot;: { # The terms for rubicon non-guaranteed deals.
          &quot;priorityPrice&quot;: { # Optional price for Rubicon priority access in the auction.
            &quot;amountMicros&quot;: 3.14, # The price value in micros.
            &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
            &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
            &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
          },
          &quot;standardPrice&quot;: { # Optional price for Rubicon standard access in the auction.
            &quot;amountMicros&quot;: 3.14, # The price value in micros.
            &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
            &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
            &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
          },
        },
        &quot;sellerTimeZone&quot;: &quot;A String&quot;, # For deals with Cost Per Day billing, defines the timezone used to mark the boundaries of a day (buyer-readonly)
      },
      &quot;webPropertyCode&quot;: &quot;A String&quot;,
    },
  ],
  &quot;proposal&quot;: { # Represents a proposal in the marketplace. A proposal is the unit of negotiation between a seller and a buyer and contains deals which are served. Each field in a proposal can have one of the following setting: # If specified, also updates the proposal in the batch transaction. This is useful when the proposal and the deals need to be updated in one transaction.
      #
      # (readonly) - It is an error to try and set this field. (buyer-readonly) - Only the seller can set this field. (seller-readonly) - Only the buyer can set this field. (updatable) - The field is updatable at all times by either buyer or the seller.
    &quot;billedBuyer&quot;: { # Reference to the buyer that will get billed for this proposal. (readonly)
      &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
    },
    &quot;buyer&quot;: { # Reference to the buyer on the proposal. (readonly, except on create)
      &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
    },
    &quot;buyerContacts&quot;: [ # Optional contact information of the buyer. (seller-readonly)
      {
        &quot;email&quot;: &quot;A String&quot;, # Email address of the contact.
        &quot;name&quot;: &quot;A String&quot;, # The name of the contact.
      },
    ],
    &quot;buyerPrivateData&quot;: { # Private data for buyer. (hidden from seller).
      &quot;referenceId&quot;: &quot;A String&quot;,
      &quot;referencePayload&quot;: &quot;A String&quot;,
    },
    &quot;dbmAdvertiserIds&quot;: [ # IDs of DBM advertisers permission to this proposal.
      &quot;A String&quot;,
    ],
    &quot;hasBuyerSignedOff&quot;: True or False, # When an proposal is in an accepted state, indicates whether the buyer has signed off. Once both sides have signed off on a deal, the proposal can be finalized by the seller. (seller-readonly)
    &quot;hasSellerSignedOff&quot;: True or False, # When an proposal is in an accepted state, indicates whether the buyer has signed off Once both sides have signed off on a deal, the proposal can be finalized by the seller. (buyer-readonly)
    &quot;inventorySource&quot;: &quot;A String&quot;, # What exchange will provide this inventory (readonly, except on create).
    &quot;isRenegotiating&quot;: True or False, # True if the proposal is being renegotiated (readonly).
    &quot;isSetupComplete&quot;: True or False, # True, if the buyside inventory setup is complete for this proposal. (readonly, except via OrderSetupCompleted action) Deprecated in favor of deal level setup complete flag.
    &quot;kind&quot;: &quot;adexchangebuyer#proposal&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;adexchangebuyer#proposal&quot;.
    &quot;labels&quot;: [ # List of labels associated with the proposal. (readonly)
      {
        &quot;accountId&quot;: &quot;A String&quot;, # The accountId of the party that created the label.
        &quot;createTimeMs&quot;: &quot;A String&quot;, # The creation time (in ms since epoch) for the label.
        &quot;deprecatedMarketplaceDealParty&quot;: { # Information about the party that created the label.
          &quot;buyer&quot;: { # The buyer/seller associated with the deal. One of buyer/seller is specified for a deal-party.
            &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
          },
          &quot;seller&quot;: { # The buyer/seller associated with the deal. One of buyer/seller is specified for a deal party.
            &quot;accountId&quot;: &quot;A String&quot;, # The unique id for the seller. The seller fills in this field. The seller account id is then available to buyer in the product.
            &quot;subAccountId&quot;: &quot;A String&quot;, # Optional sub-account id for the seller.
          },
        },
        &quot;label&quot;: &quot;A String&quot;, # The label to use.
      },
    ],
    &quot;lastUpdaterOrCommentorRole&quot;: &quot;A String&quot;, # The role of the last user that either updated the proposal or left a comment. (readonly)
    &quot;name&quot;: &quot;A String&quot;, # The name for the proposal (updatable)
    &quot;negotiationId&quot;: &quot;A String&quot;, # Optional negotiation id if this proposal is a preferred deal proposal.
    &quot;originatorRole&quot;: &quot;A String&quot;, # Indicates whether the buyer/seller created the proposal.(readonly)
    &quot;privateAuctionId&quot;: &quot;A String&quot;, # Optional private auction id if this proposal is a private auction proposal.
    &quot;proposalId&quot;: &quot;A String&quot;, # The unique id of the proposal. (readonly).
    &quot;proposalState&quot;: &quot;A String&quot;, # The current state of the proposal. (readonly)
    &quot;revisionNumber&quot;: &quot;A String&quot;, # The revision number for the proposal (readonly).
    &quot;revisionTimeMs&quot;: &quot;A String&quot;, # The time (ms since epoch) when the proposal was last revised (readonly).
    &quot;seller&quot;: { # Reference to the seller on the proposal. (readonly, except on create)
      &quot;accountId&quot;: &quot;A String&quot;, # The unique id for the seller. The seller fills in this field. The seller account id is then available to buyer in the product.
      &quot;subAccountId&quot;: &quot;A String&quot;, # Optional sub-account id for the seller.
    },
    &quot;sellerContacts&quot;: [ # Optional contact information of the seller (buyer-readonly).
      {
        &quot;email&quot;: &quot;A String&quot;, # Email address of the contact.
        &quot;name&quot;: &quot;A String&quot;, # The name of the contact.
      },
    ],
  },
  &quot;proposalRevisionNumber&quot;: &quot;A String&quot;, # The last known revision number for the proposal.
  &quot;updateAction&quot;: &quot;A String&quot;, # Indicates an optional action to take on the proposal
}


Returns:
  An object of the form:

    {
  &quot;deals&quot;: [ # List of all deals in the proposal after edit.
    { # A proposal can contain multiple deals. A deal contains the terms and targeting information that is used for serving.
      &quot;buyerPrivateData&quot;: { # Buyer private data (hidden from seller).
        &quot;referenceId&quot;: &quot;A String&quot;,
        &quot;referencePayload&quot;: &quot;A String&quot;,
      },
      &quot;creationTimeMs&quot;: &quot;A String&quot;, # The time (ms since epoch) of the deal creation. (readonly)
      &quot;creativePreApprovalPolicy&quot;: &quot;A String&quot;, # Specifies the creative pre-approval policy (buyer-readonly)
      &quot;creativeSafeFrameCompatibility&quot;: &quot;A String&quot;, # Specifies whether the creative is safeFrame compatible (buyer-readonly)
      &quot;dealId&quot;: &quot;A String&quot;, # A unique deal-id for the deal (readonly).
      &quot;dealServingMetadata&quot;: { # Metadata about the serving status of this deal (readonly, writes via custom actions)
        &quot;alcoholAdsAllowed&quot;: True or False, # True if alcohol ads are allowed for this deal (read-only). This field is only populated when querying for finalized orders using the method GetFinalizedOrderDeals
        &quot;dealPauseStatus&quot;: { # Tracks which parties (if any) have paused a deal. The deal is considered paused if has_buyer_paused || has_seller_paused. Each of the has_buyer_paused or the has_seller_paused bits can be set independently. # Tracks which parties (if any) have paused a deal. (readonly, except via PauseResumeOrderDeals action)
          &quot;buyerPauseReason&quot;: &quot;A String&quot;,
          &quot;firstPausedBy&quot;: &quot;A String&quot;, # If the deal is paused, records which party paused the deal first.
          &quot;hasBuyerPaused&quot;: True or False,
          &quot;hasSellerPaused&quot;: True or False,
          &quot;sellerPauseReason&quot;: &quot;A String&quot;,
        },
      },
      &quot;deliveryControl&quot;: { # The set of fields around delivery control that are interesting for a buyer to see but are non-negotiable. These are set by the publisher. This message is assigned an id of 100 since some day we would want to model this as a protobuf extension.
        &quot;creativeBlockingLevel&quot;: &quot;A String&quot;,
        &quot;deliveryRateType&quot;: &quot;A String&quot;,
        &quot;frequencyCaps&quot;: [
          {
            &quot;maxImpressions&quot;: 42,
            &quot;numTimeUnits&quot;: 42,
            &quot;timeUnitType&quot;: &quot;A String&quot;,
          },
        ],
      },
      &quot;externalDealId&quot;: &quot;A String&quot;, # The external deal id assigned to this deal once the deal is finalized. This is the deal-id that shows up in serving/reporting etc. (readonly)
      &quot;flightEndTimeMs&quot;: &quot;A String&quot;, # Proposed flight end time of the deal (ms since epoch) This will generally be stored in a granularity of a second. (updatable)
      &quot;flightStartTimeMs&quot;: &quot;A String&quot;, # Proposed flight start time of the deal (ms since epoch) This will generally be stored in a granularity of a second. (updatable)
      &quot;inventoryDescription&quot;: &quot;A String&quot;, # Description for the deal terms. (buyer-readonly)
      &quot;isRfpTemplate&quot;: True or False, # Indicates whether the current deal is a RFP template. RFP template is created by buyer and not based on seller created products.
      &quot;isSetupComplete&quot;: True or False, # True, if the buyside inventory setup is complete for this deal. (readonly, except via OrderSetupCompleted action)
      &quot;kind&quot;: &quot;adexchangebuyer#marketplaceDeal&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;adexchangebuyer#marketplaceDeal&quot;.
      &quot;lastUpdateTimeMs&quot;: &quot;A String&quot;, # The time (ms since epoch) when the deal was last updated. (readonly)
      &quot;makegoodRequestedReason&quot;: &quot;A String&quot;,
      &quot;name&quot;: &quot;A String&quot;, # The name of the deal. (updatable)
      &quot;productId&quot;: &quot;A String&quot;, # The product-id from which this deal was created. (readonly, except on create)
      &quot;productRevisionNumber&quot;: &quot;A String&quot;, # The revision number of the product that the deal was created from (readonly, except on create)
      &quot;programmaticCreativeSource&quot;: &quot;A String&quot;, # Specifies the creative source for programmatic deals, PUBLISHER means creative is provided by seller and ADVERTISR means creative is provided by buyer. (buyer-readonly)
      &quot;proposalId&quot;: &quot;A String&quot;,
      &quot;sellerContacts&quot;: [ # Optional Seller contact information for the deal (buyer-readonly)
        {
          &quot;email&quot;: &quot;A String&quot;, # Email address of the contact.
          &quot;name&quot;: &quot;A String&quot;, # The name of the contact.
        },
      ],
      &quot;sharedTargetings&quot;: [ # The shared targeting visible to buyers and sellers. Each shared targeting entity is AND&#x27;d together. (updatable)
        {
          &quot;exclusions&quot;: [ # The list of values to exclude from targeting. Each value is AND&#x27;d together.
            {
              &quot;creativeSizeValue&quot;: { # Next Id: 7 # The creative size value to exclude/include.
                &quot;allowedFormats&quot;: [ # The formats allowed by the publisher.
                  &quot;A String&quot;,
                ],
                &quot;companionSizes&quot;: [ # For video size type, the list of companion sizes.
                  {
                    &quot;height&quot;: 42, # The height of the creative.
                    &quot;width&quot;: 42, # The width of the creative.
                  },
                ],
                &quot;creativeSizeType&quot;: &quot;A String&quot;, # The Creative size type.
                &quot;nativeTemplate&quot;: &quot;A String&quot;, # The native template for native ad.
                &quot;size&quot;: { # For regular or video creative size type, specifies the size of the creative.
                  &quot;height&quot;: 42, # The height of the creative.
                  &quot;width&quot;: 42, # The width of the creative.
                },
                &quot;skippableAdType&quot;: &quot;A String&quot;, # The skippable ad type for video size.
              },
              &quot;dayPartTargetingValue&quot;: { # The daypart targeting to include / exclude. Filled in when the key is GOOG_DAYPART_TARGETING.
                &quot;dayParts&quot;: [
                  {
                    &quot;dayOfWeek&quot;: &quot;A String&quot;,
                    &quot;endHour&quot;: 42,
                    &quot;endMinute&quot;: 42,
                    &quot;startHour&quot;: 42,
                    &quot;startMinute&quot;: 42,
                  },
                ],
                &quot;timeZoneType&quot;: &quot;A String&quot;,
              },
              &quot;demogAgeCriteriaValue&quot;: {
                &quot;demogAgeCriteriaIds&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;demogGenderCriteriaValue&quot;: {
                &quot;demogGenderCriteriaIds&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;longValue&quot;: &quot;A String&quot;, # The long value to exclude/include.
              &quot;requestPlatformTargetingValue&quot;: {
                &quot;requestPlatforms&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;stringValue&quot;: &quot;A String&quot;, # The string value to exclude/include.
            },
          ],
          &quot;inclusions&quot;: [ # The list of value to include as part of the targeting. Each value is OR&#x27;d together.
            {
              &quot;creativeSizeValue&quot;: { # Next Id: 7 # The creative size value to exclude/include.
                &quot;allowedFormats&quot;: [ # The formats allowed by the publisher.
                  &quot;A String&quot;,
                ],
                &quot;companionSizes&quot;: [ # For video size type, the list of companion sizes.
                  {
                    &quot;height&quot;: 42, # The height of the creative.
                    &quot;width&quot;: 42, # The width of the creative.
                  },
                ],
                &quot;creativeSizeType&quot;: &quot;A String&quot;, # The Creative size type.
                &quot;nativeTemplate&quot;: &quot;A String&quot;, # The native template for native ad.
                &quot;size&quot;: { # For regular or video creative size type, specifies the size of the creative.
                  &quot;height&quot;: 42, # The height of the creative.
                  &quot;width&quot;: 42, # The width of the creative.
                },
                &quot;skippableAdType&quot;: &quot;A String&quot;, # The skippable ad type for video size.
              },
              &quot;dayPartTargetingValue&quot;: { # The daypart targeting to include / exclude. Filled in when the key is GOOG_DAYPART_TARGETING.
                &quot;dayParts&quot;: [
                  {
                    &quot;dayOfWeek&quot;: &quot;A String&quot;,
                    &quot;endHour&quot;: 42,
                    &quot;endMinute&quot;: 42,
                    &quot;startHour&quot;: 42,
                    &quot;startMinute&quot;: 42,
                  },
                ],
                &quot;timeZoneType&quot;: &quot;A String&quot;,
              },
              &quot;demogAgeCriteriaValue&quot;: {
                &quot;demogAgeCriteriaIds&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;demogGenderCriteriaValue&quot;: {
                &quot;demogGenderCriteriaIds&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;longValue&quot;: &quot;A String&quot;, # The long value to exclude/include.
              &quot;requestPlatformTargetingValue&quot;: {
                &quot;requestPlatforms&quot;: [
                  &quot;A String&quot;,
                ],
              },
              &quot;stringValue&quot;: &quot;A String&quot;, # The string value to exclude/include.
            },
          ],
          &quot;key&quot;: &quot;A String&quot;, # The key representing the shared targeting criterion.
        },
      ],
      &quot;syndicationProduct&quot;: &quot;A String&quot;, # The syndication product associated with the deal. (readonly, except on create)
      &quot;terms&quot;: { # The negotiable terms of the deal. (updatable)
        &quot;brandingType&quot;: &quot;A String&quot;, # Visibility of the URL in bid requests.
        &quot;crossListedExternalDealIdType&quot;: &quot;A String&quot;, # Indicates that this ExternalDealId exists under at least two different AdxInventoryDeals. Currently, the only case that the same ExternalDealId will exist is programmatic cross sell case.
        &quot;description&quot;: &quot;A String&quot;, # Description for the proposed terms of the deal.
        &quot;estimatedGrossSpend&quot;: { # Non-binding estimate of the estimated gross spend for this deal Can be set by buyer or seller.
          &quot;amountMicros&quot;: 3.14, # The price value in micros.
          &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
          &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
          &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
        },
        &quot;estimatedImpressionsPerDay&quot;: &quot;A String&quot;, # Non-binding estimate of the impressions served per day Can be set by buyer or seller.
        &quot;guaranteedFixedPriceTerms&quot;: { # The terms for guaranteed fixed price deals.
          &quot;billingInfo&quot;: { # External billing info for this Deal. This field is relevant when external billing info such as price has a different currency code than DFP/AdX.
            &quot;currencyConversionTimeMs&quot;: &quot;A String&quot;, # The timestamp (in ms since epoch) when the original reservation price for the deal was first converted to DFP currency. This is used to convert the contracted price into buyer&#x27;s currency without discrepancy.
            &quot;dfpLineItemId&quot;: &quot;A String&quot;, # The DFP line item id associated with this deal. For features like CPD, buyers can retrieve the DFP line item for billing reconciliation.
            &quot;originalContractedQuantity&quot;: &quot;A String&quot;, # The original contracted quantity (# impressions) for this deal. To ensure delivery, sometimes the publisher will book the deal with a impression buffer, such that guaranteed_looks is greater than the contracted quantity. However clients are billed using the original contracted quantity.
            &quot;price&quot;: { # The original reservation price for the deal, if the currency code is different from the one used in negotiation.
              &quot;amountMicros&quot;: 3.14, # The price value in micros.
              &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
              &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
              &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
            },
          },
          &quot;fixedPrices&quot;: [ # Fixed price for the specified buyer.
            { # Used to specify pricing rules for buyers. Each PricePerBuyer in a product can become [0,1] deals. To check if there is a PricePerBuyer for a particular buyer we look for the most specific matching rule - we first look for a rule matching the buyer and otherwise look for a matching rule where no buyer is set.
              &quot;auctionTier&quot;: &quot;A String&quot;, # Optional access type for this buyer.
              &quot;billedBuyer&quot;: { # Reference to the buyer that will get billed.
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;buyer&quot;: { # The buyer who will pay this price. If unset, all buyers can pay this price (if the advertisers match, and there&#x27;s no more specific rule matching the buyer).
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;price&quot;: { # The specified price
                &quot;amountMicros&quot;: 3.14, # The price value in micros.
                &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
                &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
                &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
              },
            },
          ],
          &quot;guaranteedImpressions&quot;: &quot;A String&quot;, # Guaranteed impressions as a percentage. This is the percentage of guaranteed looks that the buyer is guaranteeing to buy.
          &quot;guaranteedLooks&quot;: &quot;A String&quot;, # Count of guaranteed looks. Required for deal, optional for product. For CPD deals, buyer changes to guaranteed_looks will be ignored.
          &quot;minimumDailyLooks&quot;: &quot;A String&quot;, # Count of minimum daily looks for a CPD deal. For CPD deals, buyer should negotiate on this field instead of guaranteed_looks.
        },
        &quot;nonGuaranteedAuctionTerms&quot;: { # The terms for non-guaranteed auction deals.
          &quot;autoOptimizePrivateAuction&quot;: True or False, # True if open auction buyers are allowed to compete with invited buyers in this private auction (buyer-readonly).
          &quot;reservePricePerBuyers&quot;: [ # Reserve price for the specified buyer.
            { # Used to specify pricing rules for buyers. Each PricePerBuyer in a product can become [0,1] deals. To check if there is a PricePerBuyer for a particular buyer we look for the most specific matching rule - we first look for a rule matching the buyer and otherwise look for a matching rule where no buyer is set.
              &quot;auctionTier&quot;: &quot;A String&quot;, # Optional access type for this buyer.
              &quot;billedBuyer&quot;: { # Reference to the buyer that will get billed.
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;buyer&quot;: { # The buyer who will pay this price. If unset, all buyers can pay this price (if the advertisers match, and there&#x27;s no more specific rule matching the buyer).
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;price&quot;: { # The specified price
                &quot;amountMicros&quot;: 3.14, # The price value in micros.
                &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
                &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
                &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
              },
            },
          ],
        },
        &quot;nonGuaranteedFixedPriceTerms&quot;: { # The terms for non-guaranteed fixed price deals.
          &quot;fixedPrices&quot;: [ # Fixed price for the specified buyer.
            { # Used to specify pricing rules for buyers. Each PricePerBuyer in a product can become [0,1] deals. To check if there is a PricePerBuyer for a particular buyer we look for the most specific matching rule - we first look for a rule matching the buyer and otherwise look for a matching rule where no buyer is set.
              &quot;auctionTier&quot;: &quot;A String&quot;, # Optional access type for this buyer.
              &quot;billedBuyer&quot;: { # Reference to the buyer that will get billed.
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;buyer&quot;: { # The buyer who will pay this price. If unset, all buyers can pay this price (if the advertisers match, and there&#x27;s no more specific rule matching the buyer).
                &quot;accountId&quot;: &quot;A String&quot;, # Adx account id of the buyer.
              },
              &quot;price&quot;: { # The specified price
                &quot;amountMicros&quot;: 3.14, # The price value in micros.
                &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
                &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
                &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
              },
            },
          ],
        },
        &quot;rubiconNonGuaranteedTerms&quot;: { # The terms for rubicon non-guaranteed deals.
          &quot;priorityPrice&quot;: { # Optional price for Rubicon priority access in the auction.
            &quot;amountMicros&quot;: 3.14, # The price value in micros.
            &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
            &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
            &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
          },
          &quot;standardPrice&quot;: { # Optional price for Rubicon standard access in the auction.
            &quot;amountMicros&quot;: 3.14, # The price value in micros.
            &quot;currencyCode&quot;: &quot;A String&quot;, # The currency code for the price.
            &quot;expectedCpmMicros&quot;: 3.14, # In case of CPD deals, the expected CPM in micros.
            &quot;pricingType&quot;: &quot;A String&quot;, # The pricing type for the deal/product.
          },
        },
        &quot;sellerTimeZone&quot;: &quot;A String&quot;, # For deals with Cost Per Day billing, defines the timezone used to mark the boundaries of a day (buyer-readonly)
      },
      &quot;webPropertyCode&quot;: &quot;A String&quot;,
    },
  ],
  &quot;orderRevisionNumber&quot;: &quot;A String&quot;, # The latest revision number after the update has been applied.
}</pre>
</div>

</body></html>