File: adexchangebuyer2_v2beta1.accounts.products.html

package info (click to toggle)
python-googleapi 1.7.11-4
links: PTS
area: main
in suites: bullseye
size: 110,952 kB
sloc: python: 7,784; javascript: 249; makefile: 59; sh: 53; xml: 5
file content (815 lines) | stat: -rw-r--r-- 54,094 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="adexchangebuyer2_v2beta1.html">Ad Exchange Buyer API II</a> . <a href="adexchangebuyer2_v2beta1.accounts.html">accounts</a> . <a href="adexchangebuyer2_v2beta1.accounts.products.html">products</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
  <code><a href="#get">get(accountId, productId, x__xgafv=None)</a></code></p>
<p class="firstline">Gets the requested product by ID.</p>
<p class="toc_element">
  <code><a href="#list">list(accountId, pageSize=None, pageToken=None, x__xgafv=None, filter=None)</a></code></p>
<p class="firstline">List all products visible to the buyer (optionally filtered by the</p>
<p class="toc_element">
  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
<p class="firstline">Retrieves the next page of results.</p>
<h3>Method Details</h3>
<div class="method">
    <code class="details" id="get">get(accountId, productId, x__xgafv=None)</code>
  <pre>Gets the requested product by ID.

Args:
  accountId: string, Account ID of the buyer. (required)
  productId: string, The ID for the product to get the head revision for. (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Note: this resource requires whitelisting for access. Please contact your
      # account manager for access to Marketplace resources.
      #
      # A product is a segment of inventory that a seller wishes to sell. It is
      # associated with certain terms and targeting information which helps the buyer
      # know more about the inventory.
    "creatorContacts": [ # Optional contact information for the creator of this product.
      { # Contains information on how a buyer or seller can be reached.
        "email": "A String", # Email address for the contact.
        "name": "A String", # The name of the contact.
      },
    ],
    "updateTime": "A String", # Time of last update.
    "terms": { # The deal terms specify the details of a Product/deal. They specify things # The negotiable terms of the deal.
        # like price per buyer, the type of pricing model (e.g., fixed price, auction)
        # and expected impressions from the publisher.
      "description": "A String", # Publisher provided description for the terms.
      "guaranteedFixedPriceTerms": { # Terms for Programmatic Guaranteed Deals. # The terms for guaranteed fixed price deals.
        "guaranteedImpressions": "A String", # Guaranteed impressions as a percentage. This is the percentage
            # of guaranteed looks that the buyer is guaranteeing to buy.
        "fixedPrices": [ # Fixed price for the specified buyer.
          { # Used to specify pricing rules for buyers/advertisers. Each PricePerBuyer in
              # a product can become 0 or 1 deals. To check if there is a PricePerBuyer for
              # a particular buyer or buyer/advertiser pair, we look for the most specific
              # matching rule - we first look for a rule matching the buyer and advertiser,
              # next a rule with the buyer but an empty advertiser list, and otherwise look
              # for a matching rule where no buyer is set.
            "buyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # The buyer who will pay this price. If unset, all buyers can pay this price
                # (if the
                # advertisers match, and there's no more specific rule matching the buyer).
                # Authorized Buyers account ID.
              "accountId": "A String", # Authorized Buyers account ID of the buyer.
            },
            "advertiserIds": [ # The list of advertisers for this price when associated with this buyer.
                # If empty, all advertisers with this buyer pay this price.
              "A String",
            ],
            "price": { # Represents a price and a pricing type for a product / deal. # The specified price.
              "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
              "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified.
                "nanos": 42, # Number of nano (10^-9) units of the amount.
                    # The value must be between -999,999,999 and +999,999,999 inclusive.
                    # If `units` is positive, `nanos` must be positive or zero.
                    # If `units` is zero, `nanos` can be positive, zero, or negative.
                    # If `units` is negative, `nanos` must be negative or zero.
                    # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
                "units": "A String", # The whole units of the amount.
                    # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
                "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
              },
            },
          },
        ],
        "minimumDailyLooks": "A String", # Daily minimum looks for CPD deal types.
        "guaranteedLooks": "A String", # Count of guaranteed looks. Required for deal, optional for product.
      },
      "sellerTimeZone": "A String", # The time zone name. For deals with Cost Per Day billing, defines the
          # time zone used to mark the boundaries of a day. It should be an
          # IANA TZ name, such as "America/Los_Angeles". For more information,
          # see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones.
      "estimatedImpressionsPerDay": "A String", # Non-binding estimate of the impressions served per day.
          # Can be set by buyer or seller.
      "nonGuaranteedFixedPriceTerms": { # Terms for Preferred Deals. Note that Preferred Deals cannot be created via # The terms for non-guaranteed fixed price deals.
          # the API at this time, but can be returned in a get or list request.
        "fixedPrices": [ # Fixed price for the specified buyer.
          { # Used to specify pricing rules for buyers/advertisers. Each PricePerBuyer in
              # a product can become 0 or 1 deals. To check if there is a PricePerBuyer for
              # a particular buyer or buyer/advertiser pair, we look for the most specific
              # matching rule - we first look for a rule matching the buyer and advertiser,
              # next a rule with the buyer but an empty advertiser list, and otherwise look
              # for a matching rule where no buyer is set.
            "buyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # The buyer who will pay this price. If unset, all buyers can pay this price
                # (if the
                # advertisers match, and there's no more specific rule matching the buyer).
                # Authorized Buyers account ID.
              "accountId": "A String", # Authorized Buyers account ID of the buyer.
            },
            "advertiserIds": [ # The list of advertisers for this price when associated with this buyer.
                # If empty, all advertisers with this buyer pay this price.
              "A String",
            ],
            "price": { # Represents a price and a pricing type for a product / deal. # The specified price.
              "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
              "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified.
                "nanos": 42, # Number of nano (10^-9) units of the amount.
                    # The value must be between -999,999,999 and +999,999,999 inclusive.
                    # If `units` is positive, `nanos` must be positive or zero.
                    # If `units` is zero, `nanos` can be positive, zero, or negative.
                    # If `units` is negative, `nanos` must be negative or zero.
                    # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
                "units": "A String", # The whole units of the amount.
                    # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
                "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
              },
            },
          },
        ],
      },
      "estimatedGrossSpend": { # Represents a price and a pricing type for a product / deal. # Non-binding estimate of the estimated gross spend for this deal.
          # Can be set by buyer or seller.
        "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
        "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified.
          "nanos": 42, # Number of nano (10^-9) units of the amount.
              # The value must be between -999,999,999 and +999,999,999 inclusive.
              # If `units` is positive, `nanos` must be positive or zero.
              # If `units` is zero, `nanos` can be positive, zero, or negative.
              # If `units` is negative, `nanos` must be negative or zero.
              # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
          "units": "A String", # The whole units of the amount.
              # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
          "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
        },
      },
      "nonGuaranteedAuctionTerms": { # Terms for Private Auctions. Note that Private Auctions can be created only # The terms for non-guaranteed auction deals.
          # by the seller, but they can be returned in a get or list request.
        "reservePricesPerBuyer": [ # Reserve price for the specified buyer.
          { # Used to specify pricing rules for buyers/advertisers. Each PricePerBuyer in
              # a product can become 0 or 1 deals. To check if there is a PricePerBuyer for
              # a particular buyer or buyer/advertiser pair, we look for the most specific
              # matching rule - we first look for a rule matching the buyer and advertiser,
              # next a rule with the buyer but an empty advertiser list, and otherwise look
              # for a matching rule where no buyer is set.
            "buyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # The buyer who will pay this price. If unset, all buyers can pay this price
                # (if the
                # advertisers match, and there's no more specific rule matching the buyer).
                # Authorized Buyers account ID.
              "accountId": "A String", # Authorized Buyers account ID of the buyer.
            },
            "advertiserIds": [ # The list of advertisers for this price when associated with this buyer.
                # If empty, all advertisers with this buyer pay this price.
              "A String",
            ],
            "price": { # Represents a price and a pricing type for a product / deal. # The specified price.
              "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
              "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified.
                "nanos": 42, # Number of nano (10^-9) units of the amount.
                    # The value must be between -999,999,999 and +999,999,999 inclusive.
                    # If `units` is positive, `nanos` must be positive or zero.
                    # If `units` is zero, `nanos` can be positive, zero, or negative.
                    # If `units` is negative, `nanos` must be negative or zero.
                    # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
                "units": "A String", # The whole units of the amount.
                    # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
                "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
              },
            },
          },
        ],
        "autoOptimizePrivateAuction": True or False, # True if open auction buyers are allowed to compete with invited buyers
            # in this private auction.
      },
      "brandingType": "A String", # Visibility of the URL in bid requests. (default: BRANDED)
    },
    "syndicationProduct": "A String", # The syndication product associated with the deal.
    "targetingCriterion": [ # Targeting that is shared between the buyer and the seller. Each targeting
        # criterion has a specified key and for each key there is a list of inclusion
        # value or exclusion values.
      { # Advertisers can target different attributes of an ad slot. For example,
          # they can choose to show ads only if the user is in the U.S. Such
          # targeting criteria can be specified as part of Shared Targeting.
        "inclusions": [ # The list of value to include as part of the targeting. Each value is OR'd
            # together.
          { # A polymorphic targeting value used as part of Shared Targeting.
            "stringValue": "A String", # The string value to include/exclude.
            "longValue": "A String", # The long value to include/exclude.
            "creativeSizeValue": { # Specifies the size of the creative. # The creative size value to include/exclude.
                # Filled in when key = GOOG_CREATIVE_SIZE
              "companionSizes": [ # For video creatives specifies the sizes of companion ads (if present).
                  # Companion sizes may be filled in only when creative_size_type = VIDEO
                { # Message depicting the size of the creative. The units of width and
                    # height depend on the type of the targeting.
                  "width": 42, # The width of the creative
                  "height": 42, # The height of the creative.
                },
              ],
              "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
                  # only if creative_size_type = CreativeSizeType.NATIVE.
              "allowedFormats": [ # What formats are allowed by the publisher.
                  # If this repeated field is empty then all formats are allowed.
                  # For example, if this field contains AllowedFormatType.AUDIO then the
                  # publisher only allows an audio ad (without any video).
                "A String",
              ],
              "skippableAdType": "A String", # The type of skippable ad for this creative. It will have a value only if
                  # creative_size_type = CreativeSizeType.VIDEO.
              "creativeSizeType": "A String", # The creative size type.
              "size": { # Message depicting the size of the creative. The units of width and # For regular or video creative size type, specifies the size
                  # of the creative
                  # height depend on the type of the targeting.
                "width": 42, # The width of the creative
                "height": 42, # The height of the creative.
              },
            },
            "dayPartTargetingValue": { # Specifies the day part targeting criteria. # The daypart targeting to include / exclude.
                # Filled in when the key is GOOG_DAYPART_TARGETING.
                # The definition of this targeting is derived from the structure
                # used by Ad Manager.
              "dayParts": [ # A list of day part targeting criterion.
                { # Daypart targeting message that specifies if the ad can be shown
                    # only during certain parts of a day/week.
                  "dayOfWeek": "A String", # The day of the week to target. If unspecified, applicable to all days.
                  "endTime": { # Represents a time of day. The date and time zone are either not significant # The ending time of the day for the ad to show (minute level
                      # granularity). The end time is exclusive. This field is not available
                      # for filtering in PQL queries.
                      # or are specified elsewhere. An API may choose to allow leap seconds. Related
                      # types are google.type.Date and `google.protobuf.Timestamp`.
                    "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may
                        # allow the value 60 if it allows leap-seconds.
                    "hours": 42, # Hours of day in 24 hour format. Should be from 0 to 23. An API may choose
                        # to allow the value "24:00:00" for scenarios like business closing time.
                    "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
                    "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
                  },
                  "startTime": { # Represents a time of day. The date and time zone are either not significant # The starting time of day for the ad to show (minute level granularity).
                      # The start time is inclusive.
                      # This field is not available for filtering in PQL queries.
                      # or are specified elsewhere. An API may choose to allow leap seconds. Related
                      # types are google.type.Date and `google.protobuf.Timestamp`.
                    "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may
                        # allow the value 60 if it allows leap-seconds.
                    "hours": 42, # Hours of day in 24 hour format. Should be from 0 to 23. An API may choose
                        # to allow the value "24:00:00" for scenarios like business closing time.
                    "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
                    "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
                  },
                },
              ],
              "timeZoneType": "A String", # The timezone to use for interpreting the day part targeting.
            },
          },
        ],
        "exclusions": [ # The list of values to exclude from targeting. Each value is AND'd
            # together.
          { # A polymorphic targeting value used as part of Shared Targeting.
            "stringValue": "A String", # The string value to include/exclude.
            "longValue": "A String", # The long value to include/exclude.
            "creativeSizeValue": { # Specifies the size of the creative. # The creative size value to include/exclude.
                # Filled in when key = GOOG_CREATIVE_SIZE
              "companionSizes": [ # For video creatives specifies the sizes of companion ads (if present).
                  # Companion sizes may be filled in only when creative_size_type = VIDEO
                { # Message depicting the size of the creative. The units of width and
                    # height depend on the type of the targeting.
                  "width": 42, # The width of the creative
                  "height": 42, # The height of the creative.
                },
              ],
              "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
                  # only if creative_size_type = CreativeSizeType.NATIVE.
              "allowedFormats": [ # What formats are allowed by the publisher.
                  # If this repeated field is empty then all formats are allowed.
                  # For example, if this field contains AllowedFormatType.AUDIO then the
                  # publisher only allows an audio ad (without any video).
                "A String",
              ],
              "skippableAdType": "A String", # The type of skippable ad for this creative. It will have a value only if
                  # creative_size_type = CreativeSizeType.VIDEO.
              "creativeSizeType": "A String", # The creative size type.
              "size": { # Message depicting the size of the creative. The units of width and # For regular or video creative size type, specifies the size
                  # of the creative
                  # height depend on the type of the targeting.
                "width": 42, # The width of the creative
                "height": 42, # The height of the creative.
              },
            },
            "dayPartTargetingValue": { # Specifies the day part targeting criteria. # The daypart targeting to include / exclude.
                # Filled in when the key is GOOG_DAYPART_TARGETING.
                # The definition of this targeting is derived from the structure
                # used by Ad Manager.
              "dayParts": [ # A list of day part targeting criterion.
                { # Daypart targeting message that specifies if the ad can be shown
                    # only during certain parts of a day/week.
                  "dayOfWeek": "A String", # The day of the week to target. If unspecified, applicable to all days.
                  "endTime": { # Represents a time of day. The date and time zone are either not significant # The ending time of the day for the ad to show (minute level
                      # granularity). The end time is exclusive. This field is not available
                      # for filtering in PQL queries.
                      # or are specified elsewhere. An API may choose to allow leap seconds. Related
                      # types are google.type.Date and `google.protobuf.Timestamp`.
                    "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may
                        # allow the value 60 if it allows leap-seconds.
                    "hours": 42, # Hours of day in 24 hour format. Should be from 0 to 23. An API may choose
                        # to allow the value "24:00:00" for scenarios like business closing time.
                    "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
                    "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
                  },
                  "startTime": { # Represents a time of day. The date and time zone are either not significant # The starting time of day for the ad to show (minute level granularity).
                      # The start time is inclusive.
                      # This field is not available for filtering in PQL queries.
                      # or are specified elsewhere. An API may choose to allow leap seconds. Related
                      # types are google.type.Date and `google.protobuf.Timestamp`.
                    "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may
                        # allow the value 60 if it allows leap-seconds.
                    "hours": 42, # Hours of day in 24 hour format. Should be from 0 to 23. An API may choose
                        # to allow the value "24:00:00" for scenarios like business closing time.
                    "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
                    "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
                  },
                },
              ],
              "timeZoneType": "A String", # The timezone to use for interpreting the day part targeting.
            },
          },
        ],
        "key": "A String", # The key representing the shared targeting criterion.
            # Targeting criteria defined by Google ad servers will begin with GOOG_.
            # Third parties may define their own keys.
            # A list of permissible keys along with the acceptable values will be
            # provided as part of the external documentation.
      },
    ],
    "seller": { # Represents a seller of inventory. Each seller is identified by a unique # Information about the seller that created this product.
        # Ad Manager account ID.
      "subAccountId": "A String", # Optional sub-account ID for the seller.
      "accountId": "A String", # The unique ID for the seller. The seller fills in this field.
          # The seller account ID is then available to buyer in the product.
    },
    "webPropertyCode": "A String", # The web-property code for the seller. This needs to be copied as is when
        # adding a new deal to a proposal.
    "availableStartTime": "A String", # Inventory availability dates. The start time will be truncated to seconds
        # during serving. Thus, a field specified as 3:23:34.456 (HH:mm:ss.SSS) will
        # be truncated to 3:23:34 when serving.
    "hasCreatorSignedOff": True or False, # If the creator has already signed off on the product, then the buyer can
        # finalize the deal by accepting the product as is. When copying to a
        # proposal, if any of the terms are changed, then auto_finalize is
        # automatically set to false.
    "productRevision": "A String", # The revision number of the product (auto-assigned by Marketplace).
    "displayName": "A String", # The display name for this product as set by the seller.
    "publisherProfileId": "A String", # An ID which can be used by the Publisher Profile API to get more
        # information about the seller that created this product.
    "availableEndTime": "A String", # The proposed end time for the deal. The field will be truncated to the
        # order of seconds during serving.
    "createTime": "A String", # Creation time.
    "productId": "A String", # The unique ID for the product.
  }</pre>
</div>

<div class="method">
    <code class="details" id="list">list(accountId, pageSize=None, pageToken=None, x__xgafv=None, filter=None)</code>
  <pre>List all products visible to the buyer (optionally filtered by the
specified PQL query).

Args:
  accountId: string, Account ID of the buyer. (required)
  pageSize: integer, Requested page size. The server may return fewer results than requested.
If unspecified, the server will pick an appropriate default.
  pageToken: string, The page token as returned from ListProductsResponse.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format
  filter: string, An optional PQL query used to query for products. See
https://developers.google.com/ad-manager/docs/pqlreference
for documentation about PQL and examples.

Nested repeated fields, such as product.targetingCriterion.inclusions,
cannot be filtered.

Returns:
  An object of the form:

    { # Response message for listing products visible to the buyer.
    "nextPageToken": "A String", # List pagination support.
    "products": [ # The list of matching products at their head revision number.
      { # Note: this resource requires whitelisting for access. Please contact your
          # account manager for access to Marketplace resources.
          #
          # A product is a segment of inventory that a seller wishes to sell. It is
          # associated with certain terms and targeting information which helps the buyer
          # know more about the inventory.
        "creatorContacts": [ # Optional contact information for the creator of this product.
          { # Contains information on how a buyer or seller can be reached.
            "email": "A String", # Email address for the contact.
            "name": "A String", # The name of the contact.
          },
        ],
        "updateTime": "A String", # Time of last update.
        "terms": { # The deal terms specify the details of a Product/deal. They specify things # The negotiable terms of the deal.
            # like price per buyer, the type of pricing model (e.g., fixed price, auction)
            # and expected impressions from the publisher.
          "description": "A String", # Publisher provided description for the terms.
          "guaranteedFixedPriceTerms": { # Terms for Programmatic Guaranteed Deals. # The terms for guaranteed fixed price deals.
            "guaranteedImpressions": "A String", # Guaranteed impressions as a percentage. This is the percentage
                # of guaranteed looks that the buyer is guaranteeing to buy.
            "fixedPrices": [ # Fixed price for the specified buyer.
              { # Used to specify pricing rules for buyers/advertisers. Each PricePerBuyer in
                  # a product can become 0 or 1 deals. To check if there is a PricePerBuyer for
                  # a particular buyer or buyer/advertiser pair, we look for the most specific
                  # matching rule - we first look for a rule matching the buyer and advertiser,
                  # next a rule with the buyer but an empty advertiser list, and otherwise look
                  # for a matching rule where no buyer is set.
                "buyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # The buyer who will pay this price. If unset, all buyers can pay this price
                    # (if the
                    # advertisers match, and there's no more specific rule matching the buyer).
                    # Authorized Buyers account ID.
                  "accountId": "A String", # Authorized Buyers account ID of the buyer.
                },
                "advertiserIds": [ # The list of advertisers for this price when associated with this buyer.
                    # If empty, all advertisers with this buyer pay this price.
                  "A String",
                ],
                "price": { # Represents a price and a pricing type for a product / deal. # The specified price.
                  "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
                  "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified.
                    "nanos": 42, # Number of nano (10^-9) units of the amount.
                        # The value must be between -999,999,999 and +999,999,999 inclusive.
                        # If `units` is positive, `nanos` must be positive or zero.
                        # If `units` is zero, `nanos` can be positive, zero, or negative.
                        # If `units` is negative, `nanos` must be negative or zero.
                        # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
                    "units": "A String", # The whole units of the amount.
                        # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
                    "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
                  },
                },
              },
            ],
            "minimumDailyLooks": "A String", # Daily minimum looks for CPD deal types.
            "guaranteedLooks": "A String", # Count of guaranteed looks. Required for deal, optional for product.
          },
          "sellerTimeZone": "A String", # The time zone name. For deals with Cost Per Day billing, defines the
              # time zone used to mark the boundaries of a day. It should be an
              # IANA TZ name, such as "America/Los_Angeles". For more information,
              # see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones.
          "estimatedImpressionsPerDay": "A String", # Non-binding estimate of the impressions served per day.
              # Can be set by buyer or seller.
          "nonGuaranteedFixedPriceTerms": { # Terms for Preferred Deals. Note that Preferred Deals cannot be created via # The terms for non-guaranteed fixed price deals.
              # the API at this time, but can be returned in a get or list request.
            "fixedPrices": [ # Fixed price for the specified buyer.
              { # Used to specify pricing rules for buyers/advertisers. Each PricePerBuyer in
                  # a product can become 0 or 1 deals. To check if there is a PricePerBuyer for
                  # a particular buyer or buyer/advertiser pair, we look for the most specific
                  # matching rule - we first look for a rule matching the buyer and advertiser,
                  # next a rule with the buyer but an empty advertiser list, and otherwise look
                  # for a matching rule where no buyer is set.
                "buyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # The buyer who will pay this price. If unset, all buyers can pay this price
                    # (if the
                    # advertisers match, and there's no more specific rule matching the buyer).
                    # Authorized Buyers account ID.
                  "accountId": "A String", # Authorized Buyers account ID of the buyer.
                },
                "advertiserIds": [ # The list of advertisers for this price when associated with this buyer.
                    # If empty, all advertisers with this buyer pay this price.
                  "A String",
                ],
                "price": { # Represents a price and a pricing type for a product / deal. # The specified price.
                  "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
                  "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified.
                    "nanos": 42, # Number of nano (10^-9) units of the amount.
                        # The value must be between -999,999,999 and +999,999,999 inclusive.
                        # If `units` is positive, `nanos` must be positive or zero.
                        # If `units` is zero, `nanos` can be positive, zero, or negative.
                        # If `units` is negative, `nanos` must be negative or zero.
                        # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
                    "units": "A String", # The whole units of the amount.
                        # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
                    "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
                  },
                },
              },
            ],
          },
          "estimatedGrossSpend": { # Represents a price and a pricing type for a product / deal. # Non-binding estimate of the estimated gross spend for this deal.
              # Can be set by buyer or seller.
            "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
            "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified.
              "nanos": 42, # Number of nano (10^-9) units of the amount.
                  # The value must be between -999,999,999 and +999,999,999 inclusive.
                  # If `units` is positive, `nanos` must be positive or zero.
                  # If `units` is zero, `nanos` can be positive, zero, or negative.
                  # If `units` is negative, `nanos` must be negative or zero.
                  # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
              "units": "A String", # The whole units of the amount.
                  # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
              "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
            },
          },
          "nonGuaranteedAuctionTerms": { # Terms for Private Auctions. Note that Private Auctions can be created only # The terms for non-guaranteed auction deals.
              # by the seller, but they can be returned in a get or list request.
            "reservePricesPerBuyer": [ # Reserve price for the specified buyer.
              { # Used to specify pricing rules for buyers/advertisers. Each PricePerBuyer in
                  # a product can become 0 or 1 deals. To check if there is a PricePerBuyer for
                  # a particular buyer or buyer/advertiser pair, we look for the most specific
                  # matching rule - we first look for a rule matching the buyer and advertiser,
                  # next a rule with the buyer but an empty advertiser list, and otherwise look
                  # for a matching rule where no buyer is set.
                "buyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # The buyer who will pay this price. If unset, all buyers can pay this price
                    # (if the
                    # advertisers match, and there's no more specific rule matching the buyer).
                    # Authorized Buyers account ID.
                  "accountId": "A String", # Authorized Buyers account ID of the buyer.
                },
                "advertiserIds": [ # The list of advertisers for this price when associated with this buyer.
                    # If empty, all advertisers with this buyer pay this price.
                  "A String",
                ],
                "price": { # Represents a price and a pricing type for a product / deal. # The specified price.
                  "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
                  "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified.
                    "nanos": 42, # Number of nano (10^-9) units of the amount.
                        # The value must be between -999,999,999 and +999,999,999 inclusive.
                        # If `units` is positive, `nanos` must be positive or zero.
                        # If `units` is zero, `nanos` can be positive, zero, or negative.
                        # If `units` is negative, `nanos` must be negative or zero.
                        # For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
                    "units": "A String", # The whole units of the amount.
                        # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
                    "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
                  },
                },
              },
            ],
            "autoOptimizePrivateAuction": True or False, # True if open auction buyers are allowed to compete with invited buyers
                # in this private auction.
          },
          "brandingType": "A String", # Visibility of the URL in bid requests. (default: BRANDED)
        },
        "syndicationProduct": "A String", # The syndication product associated with the deal.
        "targetingCriterion": [ # Targeting that is shared between the buyer and the seller. Each targeting
            # criterion has a specified key and for each key there is a list of inclusion
            # value or exclusion values.
          { # Advertisers can target different attributes of an ad slot. For example,
              # they can choose to show ads only if the user is in the U.S. Such
              # targeting criteria can be specified as part of Shared Targeting.
            "inclusions": [ # The list of value to include as part of the targeting. Each value is OR'd
                # together.
              { # A polymorphic targeting value used as part of Shared Targeting.
                "stringValue": "A String", # The string value to include/exclude.
                "longValue": "A String", # The long value to include/exclude.
                "creativeSizeValue": { # Specifies the size of the creative. # The creative size value to include/exclude.
                    # Filled in when key = GOOG_CREATIVE_SIZE
                  "companionSizes": [ # For video creatives specifies the sizes of companion ads (if present).
                      # Companion sizes may be filled in only when creative_size_type = VIDEO
                    { # Message depicting the size of the creative. The units of width and
                        # height depend on the type of the targeting.
                      "width": 42, # The width of the creative
                      "height": 42, # The height of the creative.
                    },
                  ],
                  "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
                      # only if creative_size_type = CreativeSizeType.NATIVE.
                  "allowedFormats": [ # What formats are allowed by the publisher.
                      # If this repeated field is empty then all formats are allowed.
                      # For example, if this field contains AllowedFormatType.AUDIO then the
                      # publisher only allows an audio ad (without any video).
                    "A String",
                  ],
                  "skippableAdType": "A String", # The type of skippable ad for this creative. It will have a value only if
                      # creative_size_type = CreativeSizeType.VIDEO.
                  "creativeSizeType": "A String", # The creative size type.
                  "size": { # Message depicting the size of the creative. The units of width and # For regular or video creative size type, specifies the size
                      # of the creative
                      # height depend on the type of the targeting.
                    "width": 42, # The width of the creative
                    "height": 42, # The height of the creative.
                  },
                },
                "dayPartTargetingValue": { # Specifies the day part targeting criteria. # The daypart targeting to include / exclude.
                    # Filled in when the key is GOOG_DAYPART_TARGETING.
                    # The definition of this targeting is derived from the structure
                    # used by Ad Manager.
                  "dayParts": [ # A list of day part targeting criterion.
                    { # Daypart targeting message that specifies if the ad can be shown
                        # only during certain parts of a day/week.
                      "dayOfWeek": "A String", # The day of the week to target. If unspecified, applicable to all days.
                      "endTime": { # Represents a time of day. The date and time zone are either not significant # The ending time of the day for the ad to show (minute level
                          # granularity). The end time is exclusive. This field is not available
                          # for filtering in PQL queries.
                          # or are specified elsewhere. An API may choose to allow leap seconds. Related
                          # types are google.type.Date and `google.protobuf.Timestamp`.
                        "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may
                            # allow the value 60 if it allows leap-seconds.
                        "hours": 42, # Hours of day in 24 hour format. Should be from 0 to 23. An API may choose
                            # to allow the value "24:00:00" for scenarios like business closing time.
                        "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
                        "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
                      },
                      "startTime": { # Represents a time of day. The date and time zone are either not significant # The starting time of day for the ad to show (minute level granularity).
                          # The start time is inclusive.
                          # This field is not available for filtering in PQL queries.
                          # or are specified elsewhere. An API may choose to allow leap seconds. Related
                          # types are google.type.Date and `google.protobuf.Timestamp`.
                        "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may
                            # allow the value 60 if it allows leap-seconds.
                        "hours": 42, # Hours of day in 24 hour format. Should be from 0 to 23. An API may choose
                            # to allow the value "24:00:00" for scenarios like business closing time.
                        "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
                        "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
                      },
                    },
                  ],
                  "timeZoneType": "A String", # The timezone to use for interpreting the day part targeting.
                },
              },
            ],
            "exclusions": [ # The list of values to exclude from targeting. Each value is AND'd
                # together.
              { # A polymorphic targeting value used as part of Shared Targeting.
                "stringValue": "A String", # The string value to include/exclude.
                "longValue": "A String", # The long value to include/exclude.
                "creativeSizeValue": { # Specifies the size of the creative. # The creative size value to include/exclude.
                    # Filled in when key = GOOG_CREATIVE_SIZE
                  "companionSizes": [ # For video creatives specifies the sizes of companion ads (if present).
                      # Companion sizes may be filled in only when creative_size_type = VIDEO
                    { # Message depicting the size of the creative. The units of width and
                        # height depend on the type of the targeting.
                      "width": 42, # The width of the creative
                      "height": 42, # The height of the creative.
                    },
                  ],
                  "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
                      # only if creative_size_type = CreativeSizeType.NATIVE.
                  "allowedFormats": [ # What formats are allowed by the publisher.
                      # If this repeated field is empty then all formats are allowed.
                      # For example, if this field contains AllowedFormatType.AUDIO then the
                      # publisher only allows an audio ad (without any video).
                    "A String",
                  ],
                  "skippableAdType": "A String", # The type of skippable ad for this creative. It will have a value only if
                      # creative_size_type = CreativeSizeType.VIDEO.
                  "creativeSizeType": "A String", # The creative size type.
                  "size": { # Message depicting the size of the creative. The units of width and # For regular or video creative size type, specifies the size
                      # of the creative
                      # height depend on the type of the targeting.
                    "width": 42, # The width of the creative
                    "height": 42, # The height of the creative.
                  },
                },
                "dayPartTargetingValue": { # Specifies the day part targeting criteria. # The daypart targeting to include / exclude.
                    # Filled in when the key is GOOG_DAYPART_TARGETING.
                    # The definition of this targeting is derived from the structure
                    # used by Ad Manager.
                  "dayParts": [ # A list of day part targeting criterion.
                    { # Daypart targeting message that specifies if the ad can be shown
                        # only during certain parts of a day/week.
                      "dayOfWeek": "A String", # The day of the week to target. If unspecified, applicable to all days.
                      "endTime": { # Represents a time of day. The date and time zone are either not significant # The ending time of the day for the ad to show (minute level
                          # granularity). The end time is exclusive. This field is not available
                          # for filtering in PQL queries.
                          # or are specified elsewhere. An API may choose to allow leap seconds. Related
                          # types are google.type.Date and `google.protobuf.Timestamp`.
                        "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may
                            # allow the value 60 if it allows leap-seconds.
                        "hours": 42, # Hours of day in 24 hour format. Should be from 0 to 23. An API may choose
                            # to allow the value "24:00:00" for scenarios like business closing time.
                        "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
                        "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
                      },
                      "startTime": { # Represents a time of day. The date and time zone are either not significant # The starting time of day for the ad to show (minute level granularity).
                          # The start time is inclusive.
                          # This field is not available for filtering in PQL queries.
                          # or are specified elsewhere. An API may choose to allow leap seconds. Related
                          # types are google.type.Date and `google.protobuf.Timestamp`.
                        "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may
                            # allow the value 60 if it allows leap-seconds.
                        "hours": 42, # Hours of day in 24 hour format. Should be from 0 to 23. An API may choose
                            # to allow the value "24:00:00" for scenarios like business closing time.
                        "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
                        "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
                      },
                    },
                  ],
                  "timeZoneType": "A String", # The timezone to use for interpreting the day part targeting.
                },
              },
            ],
            "key": "A String", # The key representing the shared targeting criterion.
                # Targeting criteria defined by Google ad servers will begin with GOOG_.
                # Third parties may define their own keys.
                # A list of permissible keys along with the acceptable values will be
                # provided as part of the external documentation.
          },
        ],
        "seller": { # Represents a seller of inventory. Each seller is identified by a unique # Information about the seller that created this product.
            # Ad Manager account ID.
          "subAccountId": "A String", # Optional sub-account ID for the seller.
          "accountId": "A String", # The unique ID for the seller. The seller fills in this field.
              # The seller account ID is then available to buyer in the product.
        },
        "webPropertyCode": "A String", # The web-property code for the seller. This needs to be copied as is when
            # adding a new deal to a proposal.
        "availableStartTime": "A String", # Inventory availability dates. The start time will be truncated to seconds
            # during serving. Thus, a field specified as 3:23:34.456 (HH:mm:ss.SSS) will
            # be truncated to 3:23:34 when serving.
        "hasCreatorSignedOff": True or False, # If the creator has already signed off on the product, then the buyer can
            # finalize the deal by accepting the product as is. When copying to a
            # proposal, if any of the terms are changed, then auto_finalize is
            # automatically set to false.
        "productRevision": "A String", # The revision number of the product (auto-assigned by Marketplace).
        "displayName": "A String", # The display name for this product as set by the seller.
        "publisherProfileId": "A String", # An ID which can be used by the Publisher Profile API to get more
            # information about the seller that created this product.
        "availableEndTime": "A String", # The proposed end time for the deal. The field will be truncated to the
            # order of seconds during serving.
        "createTime": "A String", # Creation time.
        "productId": "A String", # The unique ID for the product.
      },
    ],
  }</pre>
</div>

<div class="method">
    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
  <pre>Retrieves the next page of results.

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

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

</body></html>