docs: update docs (#916)
* fix: re-run script
* test: fix noxfile
diff --git a/docs/dyn/adexchangebuyer2_v2beta1.accounts.proposals.html b/docs/dyn/adexchangebuyer2_v2beta1.accounts.proposals.html
index 731141e..e0856ac 100644
--- a/docs/dyn/adexchangebuyer2_v2beta1.accounts.proposals.html
+++ b/docs/dyn/adexchangebuyer2_v2beta1.accounts.proposals.html
@@ -93,7 +93,7 @@
<code><a href="#get">get(accountId, proposalId, x__xgafv=None)</a></code></p>
<p class="firstline">Gets a proposal given its ID. The proposal is returned at its head</p>
<p class="toc_element">
- <code><a href="#list">list(accountId, filter=None, pageToken=None, pageSize=None, filterSyntax=None, x__xgafv=None)</a></code></p>
+ <code><a href="#list">list(accountId, pageToken=None, filterSyntax=None, filter=None, pageSize=None, x__xgafv=None)</a></code></p>
<p class="firstline">List proposals. A filter expression (PQL query) may be specified to</p>
<p class="toc_element">
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -144,73 +144,26 @@
# Auction or Preferred Deals deals through the API.
#
# Fields are updatable unless noted otherwise.
- "buyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Reference to the buyer on the proposal.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- # Authorized Buyers account ID.
- "accountId": "A String", # Authorized Buyers account ID of the buyer.
- },
- "isRenegotiating": True or False, # Output only. True if the proposal is being renegotiated.
- "notes": [ # Output only. The notes associated with this proposal.
- { # A proposal may be associated to several notes.
- "note": "A String", # The actual note to attach.
- # (max-length: 1024 unicode code units)
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "proposalRevision": "A String", # Output only. The revision number of the proposal when the note is created.
- "noteId": "A String", # Output only. The unique ID for the note.
- "createTime": "A String", # Output only. The timestamp for when this note was created.
- "creatorRole": "A String", # Output only. The role of the person (buyer/seller) creating the note.
- },
- ],
- "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
- # proposal.
- "proposalState": "A String", # Output only. The current state of the proposal.
- "sellerContacts": [ # Output only. Contact information for the seller.
- { # 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.
- },
- ],
- "privateAuctionId": "A String", # Output only. Private auction ID if this proposal is a private auction
- # proposal.
+ "proposalRevision": "A String", # Output only. The revision number for the proposal.
+ # Each update to the proposal or the deal causes the proposal revision number
+ # to auto-increment. The buyer keeps track of the last revision number they
+ # know of and pass it in when making an update. If the head revision number
+ # on the server has since incremented, then an ABORTED error is returned
+ # during the update operation to let the buyer know that a subsequent update
+ # was made.
"originatorRole": "A String", # Output only. Indicates whether the buyer/seller created the proposal.
- "lastUpdaterOrCommentorRole": "A String", # Output only. The role of the last user that either updated the proposal or
- # left a comment.
- "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Private data for buyer. (hidden from seller).
- "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
- # operations (max-length: 1024 unicode code units).
- },
- "displayName": "A String", # The name for the proposal.
- "buyerContacts": [ # Contact information for the buyer.
- { # 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.
- },
- ],
- "billedBuyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Output only. Reference to the buyer that will get billed for this proposal.
- # Authorized Buyers account ID.
- "accountId": "A String", # Authorized Buyers account ID of the buyer.
- },
- "updateTime": "A String", # Output only. The time when the proposal was last revised.
- "proposalId": "A String", # Output only. The unique ID of the proposal.
"deals": [ # The deals associated with this proposal. For Private Auction proposals
# (whose deals have NonGuaranteedAuctionTerms), there will only be one deal.
{ # A deal represents a segment of inventory for displaying ads on.
# A proposal can contain multiple deals. A deal contains the terms and
# targeting information that is used for serving.
+ "dealId": "A String", # Output only. A unique deal ID for the deal (server-assigned).
+ "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
+ # deal.
+ "createTime": "A String", # Output only. The time of the deal creation.
"programmaticCreativeSource": "A String", # Output only. Specifies the creative source for programmatic deals.
# PUBLISHER means creative is provided by seller and ADVERTISER means
# creative is provided by buyer.
- "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Buyer private data (hidden from seller).
- "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
- # operations (max-length: 1024 unicode code units).
- },
- "displayName": "A String", # The name of the deal.
- "webPropertyCode": "A String", # The web property code for the seller copied over from the product.
- "updateTime": "A String", # Output only. The time when the deal was last updated.
"targetingCriterion": [ # The shared targeting visible to buyers and sellers. Each shared
# targeting entity is AND'd together.
{ # Advertisers can target different attributes of an ad slot. For example,
@@ -219,36 +172,6 @@
"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.
- "creativeSizeValue": { # Specifies the size of the creative. # The creative size value to include/exclude.
- # Filled in when key = GOOG_CREATIVE_SIZE
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- "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",
- ],
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- ],
- "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.
- "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
- # only if creative_size_type = CreativeSizeType.NATIVE.
- },
- "stringValue": "A String", # The string value to include/exclude.
- "longValue": "A String", # The long value to include/exclude.
"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
@@ -257,34 +180,135 @@
"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.
- "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`.
- "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
- "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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
- "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.
- },
- "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`.
- "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.
"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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
"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.
},
+ "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`.
+ "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "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.
+ "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.
+ },
+ "dayOfWeek": "A String", # The day of the week to target. If unspecified, applicable to all days.
},
],
},
+ "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
+ "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
+ # only if creative_size_type = CreativeSizeType.NATIVE.
+ "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.
+ },
+ "creativeSizeType": "A String", # The creative size type.
+ "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.
+ "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.
+ },
+ ],
+ },
+ "stringValue": "A String", # The string value to include/exclude.
+ },
+ ],
+ "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.
+ "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.
+ "timeZoneType": "A String", # The timezone to use for interpreting the day part targeting.
+ "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.
+ "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`.
+ "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "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.
+ "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.
+ },
+ "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`.
+ "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "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.
+ "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.
+ },
+ "dayOfWeek": "A String", # The day of the week to target. If unspecified, applicable to all days.
+ },
+ ],
+ },
+ "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
+ "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
+ # only if creative_size_type = CreativeSizeType.NATIVE.
+ "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.
+ },
+ "creativeSizeType": "A String", # The creative size type.
+ "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.
+ "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.
+ },
+ ],
+ },
+ "stringValue": "A String", # The string value to include/exclude.
},
],
"key": "A String", # The key representing the shared targeting criterion.
@@ -292,120 +316,56 @@
# 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.
- "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.
- "creativeSizeValue": { # Specifies the size of the creative. # The creative size value to include/exclude.
- # Filled in when key = GOOG_CREATIVE_SIZE
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- "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",
- ],
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- ],
- "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.
- "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
- # only if creative_size_type = CreativeSizeType.NATIVE.
- },
- "stringValue": "A String", # The string value to include/exclude.
- "longValue": "A String", # The long value to include/exclude.
- "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.
- "timeZoneType": "A String", # The timezone to use for interpreting the day part targeting.
- "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.
- "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`.
- "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
- "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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
- "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.
- },
- "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`.
- "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
- "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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
- "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.
- },
- },
- ],
- },
+ },
+ ],
+ "creativeRestrictions": { # Represents creative restrictions associated to Programmatic Guaranteed/ # Output only. Restricitions about the creatives associated with the deal
+ # (i.e., size) This is available for Programmatic Guaranteed/Preferred Deals
+ # in Ad Manager.
+ # Preferred Deal in Ad Manager.
+ # This doesn't apply to Private Auction and AdX Preferred Deals.
+ "skippableAdType": "A String", # Skippable video ads allow viewers to skip ads after 5 seconds.
+ "creativeFormat": "A String", # The format of the environment that the creatives will be displayed in.
+ "creativeSpecifications": [
+ { # Represents information for a creative that is associated with a Programmatic
+ # Guaranteed/Preferred Deal in Ad Manager.
+ "creativeSize": { # Represents size of a single ad slot, or a creative. # The size of the creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
},
- ],
+ "creativeCompanionSizes": [ # Companion sizes may be filled in only when this is a video creative.
+ { # Represents size of a single ad slot, or a creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
+ },
+ ],
+ },
+ ],
+ },
+ "dealServingMetadata": { # Message captures metadata about the serving status of a deal. # Output only. Metadata about the serving status of this deal.
+ "dealPauseStatus": { # Tracks which parties (if any) have paused a deal. # Output only. Tracks which parties (if any) have paused a deal.
+ # The deal is considered paused if either hasBuyerPaused or
+ # hasSellPaused is true.
+ "firstPausedBy": "A String", # The role of the person who first paused this deal.
+ "hasBuyerPaused": True or False, # True, if the buyer has paused the deal unilaterally.
+ "buyerPauseReason": "A String", # The buyer's reason for pausing, if the buyer paused the deal.
+ "sellerPauseReason": "A String", # The seller's reason for pausing, if the seller paused the deal.
+ "hasSellerPaused": True or False, # True, if the seller has paused the deal unilaterally.
},
- ],
- "dealId": "A String", # Output only. A unique deal ID for the deal (server-assigned).
- "proposalId": "A String", # Output only. ID of the proposal that this deal is part of.
- "availableEndTime": "A String", # Proposed flight end time of the deal.
- # This will generally be stored in a granularity of a second.
- # A value is not required for Private Auction deals or Preferred Deals.
- "syndicationProduct": "A String", # The syndication product associated with the deal.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "createProductId": "A String", # The product ID from which this deal was created.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "creativeSafeFrameCompatibility": "A String", # Output only. Specifies whether the creative is safeFrame compatible.
- "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
- # deal.
- "createProductRevision": "A String", # Optional revision number of the product that the deal was created from.
- # If present on create, and the server `product_revision` has advanced sinced
- # the passed-in `create_product_revision`, an `ABORTED` error will be
- # returned.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "sellerContacts": [ # Output only. Seller contact information for the deal.
- { # 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.
- },
- ],
- "availableStartTime": "A String", # Optional proposed flight start time of the deal.
- # This will generally be stored in the granularity of one second since deal
- # serving starts at seconds boundary. Any time specified with more
- # granularity (e.g., in milliseconds) will be truncated towards the start of
- # time in seconds.
- "createTime": "A String", # Output only. The time of the deal creation.
+ },
"dealTerms": { # 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.
- "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.
+ "guaranteedFixedPriceTerms": { # Terms for Programmatic Guaranteed Deals. # The terms for guaranteed fixed price deals.
+ "guaranteedLooks": "A String", # Count of guaranteed looks. Required for deal, optional for product.
+ "guaranteedImpressions": "A String", # Guaranteed impressions as a percentage. This is the percentage
+ # of guaranteed looks that the buyer is guaranteeing to buy.
+ "minimumDailyLooks": "A String", # Daily minimum looks for CPD deal types.
"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
@@ -413,24 +373,24 @@
# 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.
+ "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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
"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.
},
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
},
- "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",
- ],
"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).
@@ -440,6 +400,11 @@
},
],
},
+ "description": "A String", # Publisher provided description for the terms.
+ "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.
"nonGuaranteedAuctionTerms": { # Terms for Private Auctions. Note that Private Auctions can be created only # The terms for non-guaranteed auction deals.
@@ -453,24 +418,60 @@
# 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.
+ "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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
"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.
},
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
},
+ "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.
+ },
+ },
+ ],
+ },
+ "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.
"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.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+ "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.
+ "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ },
+ },
"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).
@@ -482,152 +483,34 @@
},
"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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
"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.
},
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
},
"brandingType": "A String", # Visibility of the URL in bid requests. (default: BRANDED)
- "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.
- "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.
- "minimumDailyLooks": "A String", # Daily minimum looks for CPD deal types.
- "guaranteedLooks": "A String", # Count of guaranteed looks. Required for deal, optional for product.
- "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.
- "price": { # Represents a price and a pricing type for a product / deal. # The specified price.
- "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- "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.
- },
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
- },
- "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",
- ],
- "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.
- },
- },
- ],
- },
},
+ "externalDealId": "A String", # Output only. 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.
+ "createProductId": "A String", # The product ID from which this deal was created.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ "updateTime": "A String", # Output only. The time when the deal was last updated.
+ "proposalId": "A String", # Output only. ID of the proposal that this deal is part of.
"targeting": { # Targeting represents different criteria that can be used by advertisers to # Output only. Specifies the subset of inventory targeted by the deal.
# target ad inventory. For example, they can choose to target ad requests only
# if the user is in the US.
# Multiple types of targeting are always applied as a logical AND, unless noted
# otherwise.
- "geoTargeting": { # Generic targeting used for targeting dimensions that contains a list of # Geo criteria IDs to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- "inventorySizeTargeting": { # Represents the size of an ad unit that can be targeted on an ad # Inventory sizes to be included/excluded.
- # request. It only applies to Private Auction, AdX Preferred Deals and
- # Auction Packages. This targeting does not apply to Programmatic Guaranteed
- # and Preferred Deals in Ad Manager.
- "targetedInventorySizes": [ # A list of inventory sizes to be included.
- { # Represents size of a single ad slot, or a creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- ],
- "excludedInventorySizes": [ # A list of inventory sizes to be excluded.
- { # Represents size of a single ad slot, or a creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- ],
- },
- "videoTargeting": { # Represents targeting information about video. # Video targeting information.
- "targetedPositionTypes": [ # A list of video positions to be included.
- # When the included list is present, the excluded list must be empty.
- # When the excluded list is present, the included list must be empty.
- "A String",
- ],
- "excludedPositionTypes": [ # A list of video positions to be excluded.
- # Position types can either be included or excluded (XOR).
- "A String",
- ],
- },
- "technologyTargeting": { # Represents targeting about various types of technology. # Technology targeting information, e.g., operating system, device category.
- "deviceCapabilityTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device capabilities to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- "operatingSystemTargeting": { # Represents targeting information for operating systems. # Operating system related targeting information.
- "operatingSystemCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating systems to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- "operatingSystemVersionCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating system versions to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- },
- "deviceCategoryTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device categories to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- },
"placementTargeting": { # Represents targeting about where the ads can appear, e.g., certain sites or # Placement targeting information, e.g., URL, mobile applications.
# mobile applications.
# Different placement targeting types will be logically OR'ed.
@@ -636,10 +519,10 @@
# excluded.
# For Programmatic Guaranteed and Preferred Deals, this doesn't
# apply.
- "targetedUrls": [ # A list of URLs to be included.
+ "excludedUrls": [ # A list of URLs to be excluded.
"A String",
],
- "excludedUrls": [ # A list of URLs to be excluded.
+ "targetedUrls": [ # A list of URLs to be included.
"A String",
],
},
@@ -653,84 +536,155 @@
# Google Play Store URL.
# iOS App ID (which is a number) can be found at the end of iTunes store URL.
# First party mobile applications is either included or excluded.
- "targetedAppIds": [ # A list of application IDs to be included.
+ "excludedAppIds": [ # A list of application IDs to be excluded.
"A String",
],
- "excludedAppIds": [ # A list of application IDs to be excluded.
+ "targetedAppIds": [ # A list of application IDs to be included.
"A String",
],
},
},
},
+ "inventorySizeTargeting": { # Represents the size of an ad unit that can be targeted on an ad # Inventory sizes to be included/excluded.
+ # request. It only applies to Private Auction, AdX Preferred Deals and
+ # Auction Packages. This targeting does not apply to Programmatic Guaranteed
+ # and Preferred Deals in Ad Manager.
+ "targetedInventorySizes": [ # A list of inventory sizes to be included.
+ { # Represents size of a single ad slot, or a creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
+ },
+ ],
+ "excludedInventorySizes": [ # A list of inventory sizes to be excluded.
+ { # Represents size of a single ad slot, or a creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
+ },
+ ],
+ },
+ "geoTargeting": { # Generic targeting used for targeting dimensions that contains a list of # Geo criteria IDs to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ "technologyTargeting": { # Represents targeting about various types of technology. # Technology targeting information, e.g., operating system, device category.
+ "operatingSystemTargeting": { # Represents targeting information for operating systems. # Operating system related targeting information.
+ "operatingSystemVersionCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating system versions to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ "operatingSystemCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating systems to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ },
+ "deviceCapabilityTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device capabilities to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ "deviceCategoryTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device categories to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ },
+ "videoTargeting": { # Represents targeting information about video. # Video targeting information.
+ "targetedPositionTypes": [ # A list of video positions to be included.
+ # When the included list is present, the excluded list must be empty.
+ # When the excluded list is present, the included list must be empty.
+ "A String",
+ ],
+ "excludedPositionTypes": [ # A list of video positions to be excluded.
+ # Position types can either be included or excluded (XOR).
+ "A String",
+ ],
+ },
},
- "creativePreApprovalPolicy": "A String", # Output only. Specifies the creative pre-approval policy.
+ "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Buyer private data (hidden from seller).
+ "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
+ # operations (max-length: 1024 unicode code units).
+ },
"deliveryControl": { # Message contains details about how the deals will be paced. # 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.
- "deliveryRateType": "A String", # Output only. Specifies how the impression delivery will be paced.
"frequencyCaps": [ # Output only. Specifies any frequency caps.
{ # Frequency cap.
- "numTimeUnits": 42, # The amount of time, in the units specified by time_unit_type. Defines the
- # amount of time over which impressions per user are counted and capped.
"maxImpressions": 42, # The maximum number of impressions that can be served to a user within the
# specified time period.
"timeUnitType": "A String", # The time unit. Along with num_time_units defines the amount of time over
# which impressions per user are counted and capped.
+ "numTimeUnits": 42, # The amount of time, in the units specified by time_unit_type. Defines the
+ # amount of time over which impressions per user are counted and capped.
},
],
"creativeBlockingLevel": "A String", # Output only. Specified the creative blocking levels to be applied.
+ "deliveryRateType": "A String", # Output only. Specifies how the impression delivery will be paced.
},
- "externalDealId": "A String", # Output only. 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.
- "creativeRestrictions": { # Represents creative restrictions associated to Programmatic Guaranteed/ # Output only. Restricitions about the creatives associated with the deal
- # (i.e., size) This is available for Programmatic Guaranteed/Preferred Deals
- # in Ad Manager.
- # Preferred Deal in Ad Manager.
- # This doesn't apply to Private Auction and AdX Preferred Deals.
- "creativeFormat": "A String", # The format of the environment that the creatives will be displayed in.
- "creativeSpecifications": [
- { # Represents information for a creative that is associated with a Programmatic
- # Guaranteed/Preferred Deal in Ad Manager.
- "creativeSize": { # Represents size of a single ad slot, or a creative. # The size of the creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- "creativeCompanionSizes": [ # Companion sizes may be filled in only when this is a video creative.
- { # Represents size of a single ad slot, or a creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- ],
- },
- ],
- "skippableAdType": "A String", # Skippable video ads allow viewers to skip ads after 5 seconds.
- },
- "dealServingMetadata": { # Message captures metadata about the serving status of a deal. # Output only. Metadata about the serving status of this deal.
- "dealPauseStatus": { # Tracks which parties (if any) have paused a deal. # Output only. Tracks which parties (if any) have paused a deal.
- # The deal is considered paused if either hasBuyerPaused or
- # hasSellPaused is true.
- "firstPausedBy": "A String", # The role of the person who first paused this deal.
- "sellerPauseReason": "A String", # The seller's reason for pausing, if the seller paused the deal.
- "hasSellerPaused": True or False, # True, if the seller has paused the deal unilaterally.
- "buyerPauseReason": "A String", # The buyer's reason for pausing, if the buyer paused the deal.
- "hasBuyerPaused": True or False, # True, if the buyer has paused the deal unilaterally.
+ "availableEndTime": "A String", # Proposed flight end time of the deal.
+ # This will generally be stored in a granularity of a second.
+ # A value is not required for Private Auction deals or Preferred Deals.
+ "availableStartTime": "A String", # Optional proposed flight start time of the deal.
+ # This will generally be stored in the granularity of one second since deal
+ # serving starts at seconds boundary. Any time specified with more
+ # granularity (e.g., in milliseconds) will be truncated towards the start of
+ # time in seconds.
+ "displayName": "A String", # The name of the deal.
+ "creativeSafeFrameCompatibility": "A String", # Output only. Specifies whether the creative is safeFrame compatible.
+ "createProductRevision": "A String", # Optional revision number of the product that the deal was created from.
+ # If present on create, and the server `product_revision` has advanced sinced
+ # the passed-in `create_product_revision`, an `ABORTED` error will be
+ # returned.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ "creativePreApprovalPolicy": "A String", # Output only. Specifies the creative pre-approval policy.
+ "webPropertyCode": "A String", # The web property code for the seller copied over from the product.
+ "sellerContacts": [ # Output only. Seller contact information for the deal.
+ { # Contains information on how a buyer or seller can be reached.
+ "name": "A String", # The name of the contact.
+ "email": "A String", # Email address for the contact.
},
- },
+ ],
"description": "A String", # Description for the deal terms.
+ "syndicationProduct": "A String", # The syndication product associated with the deal.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
},
],
- "proposalRevision": "A String", # Output only. The revision number for the proposal.
- # Each update to the proposal or the deal causes the proposal revision number
- # to auto-increment. The buyer keeps track of the last revision number they
- # know of and pass it in when making an update. If the head revision number
- # on the server has since incremented, then an ABORTED error is returned
- # during the update operation to let the buyer know that a subsequent update
- # was made.
+ "billedBuyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Output only. Reference to the buyer that will get billed for this proposal.
+ # Authorized Buyers account ID.
+ "accountId": "A String", # Authorized Buyers account ID of the buyer.
+ },
+ "displayName": "A String", # The name for the proposal.
"seller": { # Represents a seller of inventory. Each seller is identified by a unique # Reference to the seller on the proposal.
#
# Note: This field may be set only when creating the resource. Modifying
@@ -740,6 +694,52 @@
"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.
},
+ "updateTime": "A String", # Output only. The time when the proposal was last revised.
+ "proposalId": "A String", # Output only. The unique ID of the proposal.
+ "isRenegotiating": True or False, # Output only. True if the proposal is being renegotiated.
+ "proposalState": "A String", # Output only. The current state of the proposal.
+ "notes": [ # Output only. The notes associated with this proposal.
+ { # A proposal may be associated to several notes.
+ "noteId": "A String", # Output only. The unique ID for the note.
+ "creatorRole": "A String", # Output only. The role of the person (buyer/seller) creating the note.
+ "proposalRevision": "A String", # Output only. The revision number of the proposal when the note is created.
+ "createTime": "A String", # Output only. The timestamp for when this note was created.
+ "note": "A String", # The actual note to attach.
+ # (max-length: 1024 unicode code units)
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ },
+ ],
+ "sellerContacts": [ # Output only. Contact information for the seller.
+ { # Contains information on how a buyer or seller can be reached.
+ "name": "A String", # The name of the contact.
+ "email": "A String", # Email address for the contact.
+ },
+ ],
+ "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Private data for buyer. (hidden from seller).
+ "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
+ # operations (max-length: 1024 unicode code units).
+ },
+ "buyerContacts": [ # Contact information for the buyer.
+ { # Contains information on how a buyer or seller can be reached.
+ "name": "A String", # The name of the contact.
+ "email": "A String", # Email address for the contact.
+ },
+ ],
+ "privateAuctionId": "A String", # Output only. Private auction ID if this proposal is a private auction
+ # proposal.
+ "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
+ # proposal.
+ "buyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Reference to the buyer on the proposal.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ # Authorized Buyers account ID.
+ "accountId": "A String", # Authorized Buyers account ID of the buyer.
+ },
+ "lastUpdaterOrCommentorRole": "A String", # Output only. The role of the last user that either updated the proposal or
+ # left a comment.
}</pre>
</div>
@@ -758,15 +758,15 @@
{ # Request message for adding a note to a given proposal.
"note": { # A proposal may be associated to several notes. # Details of the note to add.
+ "noteId": "A String", # Output only. The unique ID for the note.
+ "creatorRole": "A String", # Output only. The role of the person (buyer/seller) creating the note.
+ "proposalRevision": "A String", # Output only. The revision number of the proposal when the note is created.
+ "createTime": "A String", # Output only. The timestamp for when this note was created.
"note": "A String", # The actual note to attach.
# (max-length: 1024 unicode code units)
#
# Note: This field may be set only when creating the resource. Modifying
# this field while updating the resource will result in an error.
- "proposalRevision": "A String", # Output only. The revision number of the proposal when the note is created.
- "noteId": "A String", # Output only. The unique ID for the note.
- "createTime": "A String", # Output only. The timestamp for when this note was created.
- "creatorRole": "A String", # Output only. The role of the person (buyer/seller) creating the note.
},
}
@@ -779,15 +779,15 @@
An object of the form:
{ # A proposal may be associated to several notes.
+ "noteId": "A String", # Output only. The unique ID for the note.
+ "creatorRole": "A String", # Output only. The role of the person (buyer/seller) creating the note.
+ "proposalRevision": "A String", # Output only. The revision number of the proposal when the note is created.
+ "createTime": "A String", # Output only. The timestamp for when this note was created.
"note": "A String", # The actual note to attach.
# (max-length: 1024 unicode code units)
#
# Note: This field may be set only when creating the resource. Modifying
# this field while updating the resource will result in an error.
- "proposalRevision": "A String", # Output only. The revision number of the proposal when the note is created.
- "noteId": "A String", # Output only. The unique ID for the note.
- "createTime": "A String", # Output only. The timestamp for when this note was created.
- "creatorRole": "A String", # Output only. The role of the person (buyer/seller) creating the note.
}</pre>
</div>
@@ -825,73 +825,26 @@
# Auction or Preferred Deals deals through the API.
#
# Fields are updatable unless noted otherwise.
- "buyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Reference to the buyer on the proposal.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- # Authorized Buyers account ID.
- "accountId": "A String", # Authorized Buyers account ID of the buyer.
- },
- "isRenegotiating": True or False, # Output only. True if the proposal is being renegotiated.
- "notes": [ # Output only. The notes associated with this proposal.
- { # A proposal may be associated to several notes.
- "note": "A String", # The actual note to attach.
- # (max-length: 1024 unicode code units)
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "proposalRevision": "A String", # Output only. The revision number of the proposal when the note is created.
- "noteId": "A String", # Output only. The unique ID for the note.
- "createTime": "A String", # Output only. The timestamp for when this note was created.
- "creatorRole": "A String", # Output only. The role of the person (buyer/seller) creating the note.
- },
- ],
- "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
- # proposal.
- "proposalState": "A String", # Output only. The current state of the proposal.
- "sellerContacts": [ # Output only. Contact information for the seller.
- { # 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.
- },
- ],
- "privateAuctionId": "A String", # Output only. Private auction ID if this proposal is a private auction
- # proposal.
+ "proposalRevision": "A String", # Output only. The revision number for the proposal.
+ # Each update to the proposal or the deal causes the proposal revision number
+ # to auto-increment. The buyer keeps track of the last revision number they
+ # know of and pass it in when making an update. If the head revision number
+ # on the server has since incremented, then an ABORTED error is returned
+ # during the update operation to let the buyer know that a subsequent update
+ # was made.
"originatorRole": "A String", # Output only. Indicates whether the buyer/seller created the proposal.
- "lastUpdaterOrCommentorRole": "A String", # Output only. The role of the last user that either updated the proposal or
- # left a comment.
- "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Private data for buyer. (hidden from seller).
- "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
- # operations (max-length: 1024 unicode code units).
- },
- "displayName": "A String", # The name for the proposal.
- "buyerContacts": [ # Contact information for the buyer.
- { # 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.
- },
- ],
- "billedBuyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Output only. Reference to the buyer that will get billed for this proposal.
- # Authorized Buyers account ID.
- "accountId": "A String", # Authorized Buyers account ID of the buyer.
- },
- "updateTime": "A String", # Output only. The time when the proposal was last revised.
- "proposalId": "A String", # Output only. The unique ID of the proposal.
"deals": [ # The deals associated with this proposal. For Private Auction proposals
# (whose deals have NonGuaranteedAuctionTerms), there will only be one deal.
{ # A deal represents a segment of inventory for displaying ads on.
# A proposal can contain multiple deals. A deal contains the terms and
# targeting information that is used for serving.
+ "dealId": "A String", # Output only. A unique deal ID for the deal (server-assigned).
+ "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
+ # deal.
+ "createTime": "A String", # Output only. The time of the deal creation.
"programmaticCreativeSource": "A String", # Output only. Specifies the creative source for programmatic deals.
# PUBLISHER means creative is provided by seller and ADVERTISER means
# creative is provided by buyer.
- "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Buyer private data (hidden from seller).
- "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
- # operations (max-length: 1024 unicode code units).
- },
- "displayName": "A String", # The name of the deal.
- "webPropertyCode": "A String", # The web property code for the seller copied over from the product.
- "updateTime": "A String", # Output only. The time when the deal was last updated.
"targetingCriterion": [ # The shared targeting visible to buyers and sellers. Each shared
# targeting entity is AND'd together.
{ # Advertisers can target different attributes of an ad slot. For example,
@@ -900,36 +853,6 @@
"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.
- "creativeSizeValue": { # Specifies the size of the creative. # The creative size value to include/exclude.
- # Filled in when key = GOOG_CREATIVE_SIZE
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- "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",
- ],
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- ],
- "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.
- "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
- # only if creative_size_type = CreativeSizeType.NATIVE.
- },
- "stringValue": "A String", # The string value to include/exclude.
- "longValue": "A String", # The long value to include/exclude.
"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
@@ -938,34 +861,135 @@
"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.
- "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`.
- "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
- "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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
- "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.
- },
- "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`.
- "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.
"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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
"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.
},
+ "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`.
+ "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "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.
+ "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.
+ },
+ "dayOfWeek": "A String", # The day of the week to target. If unspecified, applicable to all days.
},
],
},
+ "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
+ "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
+ # only if creative_size_type = CreativeSizeType.NATIVE.
+ "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.
+ },
+ "creativeSizeType": "A String", # The creative size type.
+ "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.
+ "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.
+ },
+ ],
+ },
+ "stringValue": "A String", # The string value to include/exclude.
+ },
+ ],
+ "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.
+ "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.
+ "timeZoneType": "A String", # The timezone to use for interpreting the day part targeting.
+ "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.
+ "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`.
+ "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "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.
+ "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.
+ },
+ "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`.
+ "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "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.
+ "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.
+ },
+ "dayOfWeek": "A String", # The day of the week to target. If unspecified, applicable to all days.
+ },
+ ],
+ },
+ "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
+ "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
+ # only if creative_size_type = CreativeSizeType.NATIVE.
+ "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.
+ },
+ "creativeSizeType": "A String", # The creative size type.
+ "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.
+ "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.
+ },
+ ],
+ },
+ "stringValue": "A String", # The string value to include/exclude.
},
],
"key": "A String", # The key representing the shared targeting criterion.
@@ -973,120 +997,56 @@
# 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.
- "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.
- "creativeSizeValue": { # Specifies the size of the creative. # The creative size value to include/exclude.
- # Filled in when key = GOOG_CREATIVE_SIZE
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- "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",
- ],
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- ],
- "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.
- "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
- # only if creative_size_type = CreativeSizeType.NATIVE.
- },
- "stringValue": "A String", # The string value to include/exclude.
- "longValue": "A String", # The long value to include/exclude.
- "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.
- "timeZoneType": "A String", # The timezone to use for interpreting the day part targeting.
- "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.
- "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`.
- "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
- "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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
- "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.
- },
- "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`.
- "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
- "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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
- "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.
- },
- },
- ],
- },
+ },
+ ],
+ "creativeRestrictions": { # Represents creative restrictions associated to Programmatic Guaranteed/ # Output only. Restricitions about the creatives associated with the deal
+ # (i.e., size) This is available for Programmatic Guaranteed/Preferred Deals
+ # in Ad Manager.
+ # Preferred Deal in Ad Manager.
+ # This doesn't apply to Private Auction and AdX Preferred Deals.
+ "skippableAdType": "A String", # Skippable video ads allow viewers to skip ads after 5 seconds.
+ "creativeFormat": "A String", # The format of the environment that the creatives will be displayed in.
+ "creativeSpecifications": [
+ { # Represents information for a creative that is associated with a Programmatic
+ # Guaranteed/Preferred Deal in Ad Manager.
+ "creativeSize": { # Represents size of a single ad slot, or a creative. # The size of the creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
},
- ],
+ "creativeCompanionSizes": [ # Companion sizes may be filled in only when this is a video creative.
+ { # Represents size of a single ad slot, or a creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
+ },
+ ],
+ },
+ ],
+ },
+ "dealServingMetadata": { # Message captures metadata about the serving status of a deal. # Output only. Metadata about the serving status of this deal.
+ "dealPauseStatus": { # Tracks which parties (if any) have paused a deal. # Output only. Tracks which parties (if any) have paused a deal.
+ # The deal is considered paused if either hasBuyerPaused or
+ # hasSellPaused is true.
+ "firstPausedBy": "A String", # The role of the person who first paused this deal.
+ "hasBuyerPaused": True or False, # True, if the buyer has paused the deal unilaterally.
+ "buyerPauseReason": "A String", # The buyer's reason for pausing, if the buyer paused the deal.
+ "sellerPauseReason": "A String", # The seller's reason for pausing, if the seller paused the deal.
+ "hasSellerPaused": True or False, # True, if the seller has paused the deal unilaterally.
},
- ],
- "dealId": "A String", # Output only. A unique deal ID for the deal (server-assigned).
- "proposalId": "A String", # Output only. ID of the proposal that this deal is part of.
- "availableEndTime": "A String", # Proposed flight end time of the deal.
- # This will generally be stored in a granularity of a second.
- # A value is not required for Private Auction deals or Preferred Deals.
- "syndicationProduct": "A String", # The syndication product associated with the deal.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "createProductId": "A String", # The product ID from which this deal was created.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "creativeSafeFrameCompatibility": "A String", # Output only. Specifies whether the creative is safeFrame compatible.
- "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
- # deal.
- "createProductRevision": "A String", # Optional revision number of the product that the deal was created from.
- # If present on create, and the server `product_revision` has advanced sinced
- # the passed-in `create_product_revision`, an `ABORTED` error will be
- # returned.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "sellerContacts": [ # Output only. Seller contact information for the deal.
- { # 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.
- },
- ],
- "availableStartTime": "A String", # Optional proposed flight start time of the deal.
- # This will generally be stored in the granularity of one second since deal
- # serving starts at seconds boundary. Any time specified with more
- # granularity (e.g., in milliseconds) will be truncated towards the start of
- # time in seconds.
- "createTime": "A String", # Output only. The time of the deal creation.
+ },
"dealTerms": { # 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.
- "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.
+ "guaranteedFixedPriceTerms": { # Terms for Programmatic Guaranteed Deals. # The terms for guaranteed fixed price deals.
+ "guaranteedLooks": "A String", # Count of guaranteed looks. Required for deal, optional for product.
+ "guaranteedImpressions": "A String", # Guaranteed impressions as a percentage. This is the percentage
+ # of guaranteed looks that the buyer is guaranteeing to buy.
+ "minimumDailyLooks": "A String", # Daily minimum looks for CPD deal types.
"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
@@ -1094,24 +1054,24 @@
# 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.
+ "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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
"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.
},
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
},
- "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",
- ],
"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).
@@ -1121,6 +1081,11 @@
},
],
},
+ "description": "A String", # Publisher provided description for the terms.
+ "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.
"nonGuaranteedAuctionTerms": { # Terms for Private Auctions. Note that Private Auctions can be created only # The terms for non-guaranteed auction deals.
@@ -1134,24 +1099,60 @@
# 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.
+ "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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
"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.
},
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
},
+ "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.
+ },
+ },
+ ],
+ },
+ "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.
"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.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+ "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.
+ "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ },
+ },
"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).
@@ -1163,152 +1164,34 @@
},
"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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
"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.
},
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
},
"brandingType": "A String", # Visibility of the URL in bid requests. (default: BRANDED)
- "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.
- "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.
- "minimumDailyLooks": "A String", # Daily minimum looks for CPD deal types.
- "guaranteedLooks": "A String", # Count of guaranteed looks. Required for deal, optional for product.
- "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.
- "price": { # Represents a price and a pricing type for a product / deal. # The specified price.
- "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- "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.
- },
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
- },
- "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",
- ],
- "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.
- },
- },
- ],
- },
},
+ "externalDealId": "A String", # Output only. 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.
+ "createProductId": "A String", # The product ID from which this deal was created.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ "updateTime": "A String", # Output only. The time when the deal was last updated.
+ "proposalId": "A String", # Output only. ID of the proposal that this deal is part of.
"targeting": { # Targeting represents different criteria that can be used by advertisers to # Output only. Specifies the subset of inventory targeted by the deal.
# target ad inventory. For example, they can choose to target ad requests only
# if the user is in the US.
# Multiple types of targeting are always applied as a logical AND, unless noted
# otherwise.
- "geoTargeting": { # Generic targeting used for targeting dimensions that contains a list of # Geo criteria IDs to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- "inventorySizeTargeting": { # Represents the size of an ad unit that can be targeted on an ad # Inventory sizes to be included/excluded.
- # request. It only applies to Private Auction, AdX Preferred Deals and
- # Auction Packages. This targeting does not apply to Programmatic Guaranteed
- # and Preferred Deals in Ad Manager.
- "targetedInventorySizes": [ # A list of inventory sizes to be included.
- { # Represents size of a single ad slot, or a creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- ],
- "excludedInventorySizes": [ # A list of inventory sizes to be excluded.
- { # Represents size of a single ad slot, or a creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- ],
- },
- "videoTargeting": { # Represents targeting information about video. # Video targeting information.
- "targetedPositionTypes": [ # A list of video positions to be included.
- # When the included list is present, the excluded list must be empty.
- # When the excluded list is present, the included list must be empty.
- "A String",
- ],
- "excludedPositionTypes": [ # A list of video positions to be excluded.
- # Position types can either be included or excluded (XOR).
- "A String",
- ],
- },
- "technologyTargeting": { # Represents targeting about various types of technology. # Technology targeting information, e.g., operating system, device category.
- "deviceCapabilityTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device capabilities to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- "operatingSystemTargeting": { # Represents targeting information for operating systems. # Operating system related targeting information.
- "operatingSystemCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating systems to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- "operatingSystemVersionCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating system versions to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- },
- "deviceCategoryTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device categories to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- },
"placementTargeting": { # Represents targeting about where the ads can appear, e.g., certain sites or # Placement targeting information, e.g., URL, mobile applications.
# mobile applications.
# Different placement targeting types will be logically OR'ed.
@@ -1317,10 +1200,10 @@
# excluded.
# For Programmatic Guaranteed and Preferred Deals, this doesn't
# apply.
- "targetedUrls": [ # A list of URLs to be included.
+ "excludedUrls": [ # A list of URLs to be excluded.
"A String",
],
- "excludedUrls": [ # A list of URLs to be excluded.
+ "targetedUrls": [ # A list of URLs to be included.
"A String",
],
},
@@ -1334,84 +1217,155 @@
# Google Play Store URL.
# iOS App ID (which is a number) can be found at the end of iTunes store URL.
# First party mobile applications is either included or excluded.
- "targetedAppIds": [ # A list of application IDs to be included.
+ "excludedAppIds": [ # A list of application IDs to be excluded.
"A String",
],
- "excludedAppIds": [ # A list of application IDs to be excluded.
+ "targetedAppIds": [ # A list of application IDs to be included.
"A String",
],
},
},
},
+ "inventorySizeTargeting": { # Represents the size of an ad unit that can be targeted on an ad # Inventory sizes to be included/excluded.
+ # request. It only applies to Private Auction, AdX Preferred Deals and
+ # Auction Packages. This targeting does not apply to Programmatic Guaranteed
+ # and Preferred Deals in Ad Manager.
+ "targetedInventorySizes": [ # A list of inventory sizes to be included.
+ { # Represents size of a single ad slot, or a creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
+ },
+ ],
+ "excludedInventorySizes": [ # A list of inventory sizes to be excluded.
+ { # Represents size of a single ad slot, or a creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
+ },
+ ],
+ },
+ "geoTargeting": { # Generic targeting used for targeting dimensions that contains a list of # Geo criteria IDs to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ "technologyTargeting": { # Represents targeting about various types of technology. # Technology targeting information, e.g., operating system, device category.
+ "operatingSystemTargeting": { # Represents targeting information for operating systems. # Operating system related targeting information.
+ "operatingSystemVersionCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating system versions to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ "operatingSystemCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating systems to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ },
+ "deviceCapabilityTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device capabilities to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ "deviceCategoryTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device categories to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ },
+ "videoTargeting": { # Represents targeting information about video. # Video targeting information.
+ "targetedPositionTypes": [ # A list of video positions to be included.
+ # When the included list is present, the excluded list must be empty.
+ # When the excluded list is present, the included list must be empty.
+ "A String",
+ ],
+ "excludedPositionTypes": [ # A list of video positions to be excluded.
+ # Position types can either be included or excluded (XOR).
+ "A String",
+ ],
+ },
},
- "creativePreApprovalPolicy": "A String", # Output only. Specifies the creative pre-approval policy.
+ "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Buyer private data (hidden from seller).
+ "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
+ # operations (max-length: 1024 unicode code units).
+ },
"deliveryControl": { # Message contains details about how the deals will be paced. # 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.
- "deliveryRateType": "A String", # Output only. Specifies how the impression delivery will be paced.
"frequencyCaps": [ # Output only. Specifies any frequency caps.
{ # Frequency cap.
- "numTimeUnits": 42, # The amount of time, in the units specified by time_unit_type. Defines the
- # amount of time over which impressions per user are counted and capped.
"maxImpressions": 42, # The maximum number of impressions that can be served to a user within the
# specified time period.
"timeUnitType": "A String", # The time unit. Along with num_time_units defines the amount of time over
# which impressions per user are counted and capped.
+ "numTimeUnits": 42, # The amount of time, in the units specified by time_unit_type. Defines the
+ # amount of time over which impressions per user are counted and capped.
},
],
"creativeBlockingLevel": "A String", # Output only. Specified the creative blocking levels to be applied.
+ "deliveryRateType": "A String", # Output only. Specifies how the impression delivery will be paced.
},
- "externalDealId": "A String", # Output only. 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.
- "creativeRestrictions": { # Represents creative restrictions associated to Programmatic Guaranteed/ # Output only. Restricitions about the creatives associated with the deal
- # (i.e., size) This is available for Programmatic Guaranteed/Preferred Deals
- # in Ad Manager.
- # Preferred Deal in Ad Manager.
- # This doesn't apply to Private Auction and AdX Preferred Deals.
- "creativeFormat": "A String", # The format of the environment that the creatives will be displayed in.
- "creativeSpecifications": [
- { # Represents information for a creative that is associated with a Programmatic
- # Guaranteed/Preferred Deal in Ad Manager.
- "creativeSize": { # Represents size of a single ad slot, or a creative. # The size of the creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- "creativeCompanionSizes": [ # Companion sizes may be filled in only when this is a video creative.
- { # Represents size of a single ad slot, or a creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- ],
- },
- ],
- "skippableAdType": "A String", # Skippable video ads allow viewers to skip ads after 5 seconds.
- },
- "dealServingMetadata": { # Message captures metadata about the serving status of a deal. # Output only. Metadata about the serving status of this deal.
- "dealPauseStatus": { # Tracks which parties (if any) have paused a deal. # Output only. Tracks which parties (if any) have paused a deal.
- # The deal is considered paused if either hasBuyerPaused or
- # hasSellPaused is true.
- "firstPausedBy": "A String", # The role of the person who first paused this deal.
- "sellerPauseReason": "A String", # The seller's reason for pausing, if the seller paused the deal.
- "hasSellerPaused": True or False, # True, if the seller has paused the deal unilaterally.
- "buyerPauseReason": "A String", # The buyer's reason for pausing, if the buyer paused the deal.
- "hasBuyerPaused": True or False, # True, if the buyer has paused the deal unilaterally.
+ "availableEndTime": "A String", # Proposed flight end time of the deal.
+ # This will generally be stored in a granularity of a second.
+ # A value is not required for Private Auction deals or Preferred Deals.
+ "availableStartTime": "A String", # Optional proposed flight start time of the deal.
+ # This will generally be stored in the granularity of one second since deal
+ # serving starts at seconds boundary. Any time specified with more
+ # granularity (e.g., in milliseconds) will be truncated towards the start of
+ # time in seconds.
+ "displayName": "A String", # The name of the deal.
+ "creativeSafeFrameCompatibility": "A String", # Output only. Specifies whether the creative is safeFrame compatible.
+ "createProductRevision": "A String", # Optional revision number of the product that the deal was created from.
+ # If present on create, and the server `product_revision` has advanced sinced
+ # the passed-in `create_product_revision`, an `ABORTED` error will be
+ # returned.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ "creativePreApprovalPolicy": "A String", # Output only. Specifies the creative pre-approval policy.
+ "webPropertyCode": "A String", # The web property code for the seller copied over from the product.
+ "sellerContacts": [ # Output only. Seller contact information for the deal.
+ { # Contains information on how a buyer or seller can be reached.
+ "name": "A String", # The name of the contact.
+ "email": "A String", # Email address for the contact.
},
- },
+ ],
"description": "A String", # Description for the deal terms.
+ "syndicationProduct": "A String", # The syndication product associated with the deal.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
},
],
- "proposalRevision": "A String", # Output only. The revision number for the proposal.
- # Each update to the proposal or the deal causes the proposal revision number
- # to auto-increment. The buyer keeps track of the last revision number they
- # know of and pass it in when making an update. If the head revision number
- # on the server has since incremented, then an ABORTED error is returned
- # during the update operation to let the buyer know that a subsequent update
- # was made.
+ "billedBuyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Output only. Reference to the buyer that will get billed for this proposal.
+ # Authorized Buyers account ID.
+ "accountId": "A String", # Authorized Buyers account ID of the buyer.
+ },
+ "displayName": "A String", # The name for the proposal.
"seller": { # Represents a seller of inventory. Each seller is identified by a unique # Reference to the seller on the proposal.
#
# Note: This field may be set only when creating the resource. Modifying
@@ -1421,6 +1375,52 @@
"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.
},
+ "updateTime": "A String", # Output only. The time when the proposal was last revised.
+ "proposalId": "A String", # Output only. The unique ID of the proposal.
+ "isRenegotiating": True or False, # Output only. True if the proposal is being renegotiated.
+ "proposalState": "A String", # Output only. The current state of the proposal.
+ "notes": [ # Output only. The notes associated with this proposal.
+ { # A proposal may be associated to several notes.
+ "noteId": "A String", # Output only. The unique ID for the note.
+ "creatorRole": "A String", # Output only. The role of the person (buyer/seller) creating the note.
+ "proposalRevision": "A String", # Output only. The revision number of the proposal when the note is created.
+ "createTime": "A String", # Output only. The timestamp for when this note was created.
+ "note": "A String", # The actual note to attach.
+ # (max-length: 1024 unicode code units)
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ },
+ ],
+ "sellerContacts": [ # Output only. Contact information for the seller.
+ { # Contains information on how a buyer or seller can be reached.
+ "name": "A String", # The name of the contact.
+ "email": "A String", # Email address for the contact.
+ },
+ ],
+ "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Private data for buyer. (hidden from seller).
+ "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
+ # operations (max-length: 1024 unicode code units).
+ },
+ "buyerContacts": [ # Contact information for the buyer.
+ { # Contains information on how a buyer or seller can be reached.
+ "name": "A String", # The name of the contact.
+ "email": "A String", # Email address for the contact.
+ },
+ ],
+ "privateAuctionId": "A String", # Output only. Private auction ID if this proposal is a private auction
+ # proposal.
+ "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
+ # proposal.
+ "buyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Reference to the buyer on the proposal.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ # Authorized Buyers account ID.
+ "accountId": "A String", # Authorized Buyers account ID of the buyer.
+ },
+ "lastUpdaterOrCommentorRole": "A String", # Output only. The role of the last user that either updated the proposal or
+ # left a comment.
}</pre>
</div>
@@ -1461,73 +1461,26 @@
# Auction or Preferred Deals deals through the API.
#
# Fields are updatable unless noted otherwise.
- "buyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Reference to the buyer on the proposal.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- # Authorized Buyers account ID.
- "accountId": "A String", # Authorized Buyers account ID of the buyer.
- },
- "isRenegotiating": True or False, # Output only. True if the proposal is being renegotiated.
- "notes": [ # Output only. The notes associated with this proposal.
- { # A proposal may be associated to several notes.
- "note": "A String", # The actual note to attach.
- # (max-length: 1024 unicode code units)
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "proposalRevision": "A String", # Output only. The revision number of the proposal when the note is created.
- "noteId": "A String", # Output only. The unique ID for the note.
- "createTime": "A String", # Output only. The timestamp for when this note was created.
- "creatorRole": "A String", # Output only. The role of the person (buyer/seller) creating the note.
- },
- ],
- "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
- # proposal.
- "proposalState": "A String", # Output only. The current state of the proposal.
- "sellerContacts": [ # Output only. Contact information for the seller.
- { # 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.
- },
- ],
- "privateAuctionId": "A String", # Output only. Private auction ID if this proposal is a private auction
- # proposal.
+ "proposalRevision": "A String", # Output only. The revision number for the proposal.
+ # Each update to the proposal or the deal causes the proposal revision number
+ # to auto-increment. The buyer keeps track of the last revision number they
+ # know of and pass it in when making an update. If the head revision number
+ # on the server has since incremented, then an ABORTED error is returned
+ # during the update operation to let the buyer know that a subsequent update
+ # was made.
"originatorRole": "A String", # Output only. Indicates whether the buyer/seller created the proposal.
- "lastUpdaterOrCommentorRole": "A String", # Output only. The role of the last user that either updated the proposal or
- # left a comment.
- "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Private data for buyer. (hidden from seller).
- "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
- # operations (max-length: 1024 unicode code units).
- },
- "displayName": "A String", # The name for the proposal.
- "buyerContacts": [ # Contact information for the buyer.
- { # 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.
- },
- ],
- "billedBuyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Output only. Reference to the buyer that will get billed for this proposal.
- # Authorized Buyers account ID.
- "accountId": "A String", # Authorized Buyers account ID of the buyer.
- },
- "updateTime": "A String", # Output only. The time when the proposal was last revised.
- "proposalId": "A String", # Output only. The unique ID of the proposal.
"deals": [ # The deals associated with this proposal. For Private Auction proposals
# (whose deals have NonGuaranteedAuctionTerms), there will only be one deal.
{ # A deal represents a segment of inventory for displaying ads on.
# A proposal can contain multiple deals. A deal contains the terms and
# targeting information that is used for serving.
+ "dealId": "A String", # Output only. A unique deal ID for the deal (server-assigned).
+ "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
+ # deal.
+ "createTime": "A String", # Output only. The time of the deal creation.
"programmaticCreativeSource": "A String", # Output only. Specifies the creative source for programmatic deals.
# PUBLISHER means creative is provided by seller and ADVERTISER means
# creative is provided by buyer.
- "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Buyer private data (hidden from seller).
- "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
- # operations (max-length: 1024 unicode code units).
- },
- "displayName": "A String", # The name of the deal.
- "webPropertyCode": "A String", # The web property code for the seller copied over from the product.
- "updateTime": "A String", # Output only. The time when the deal was last updated.
"targetingCriterion": [ # The shared targeting visible to buyers and sellers. Each shared
# targeting entity is AND'd together.
{ # Advertisers can target different attributes of an ad slot. For example,
@@ -1536,36 +1489,6 @@
"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.
- "creativeSizeValue": { # Specifies the size of the creative. # The creative size value to include/exclude.
- # Filled in when key = GOOG_CREATIVE_SIZE
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- "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",
- ],
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- ],
- "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.
- "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
- # only if creative_size_type = CreativeSizeType.NATIVE.
- },
- "stringValue": "A String", # The string value to include/exclude.
- "longValue": "A String", # The long value to include/exclude.
"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
@@ -1574,34 +1497,135 @@
"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.
- "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`.
- "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
- "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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
- "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.
- },
- "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`.
- "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.
"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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
"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.
},
+ "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`.
+ "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "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.
+ "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.
+ },
+ "dayOfWeek": "A String", # The day of the week to target. If unspecified, applicable to all days.
},
],
},
+ "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
+ "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
+ # only if creative_size_type = CreativeSizeType.NATIVE.
+ "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.
+ },
+ "creativeSizeType": "A String", # The creative size type.
+ "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.
+ "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.
+ },
+ ],
+ },
+ "stringValue": "A String", # The string value to include/exclude.
+ },
+ ],
+ "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.
+ "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.
+ "timeZoneType": "A String", # The timezone to use for interpreting the day part targeting.
+ "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.
+ "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`.
+ "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "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.
+ "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.
+ },
+ "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`.
+ "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "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.
+ "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.
+ },
+ "dayOfWeek": "A String", # The day of the week to target. If unspecified, applicable to all days.
+ },
+ ],
+ },
+ "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
+ "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
+ # only if creative_size_type = CreativeSizeType.NATIVE.
+ "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.
+ },
+ "creativeSizeType": "A String", # The creative size type.
+ "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.
+ "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.
+ },
+ ],
+ },
+ "stringValue": "A String", # The string value to include/exclude.
},
],
"key": "A String", # The key representing the shared targeting criterion.
@@ -1609,120 +1633,56 @@
# 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.
- "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.
- "creativeSizeValue": { # Specifies the size of the creative. # The creative size value to include/exclude.
- # Filled in when key = GOOG_CREATIVE_SIZE
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- "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",
- ],
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- ],
- "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.
- "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
- # only if creative_size_type = CreativeSizeType.NATIVE.
- },
- "stringValue": "A String", # The string value to include/exclude.
- "longValue": "A String", # The long value to include/exclude.
- "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.
- "timeZoneType": "A String", # The timezone to use for interpreting the day part targeting.
- "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.
- "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`.
- "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
- "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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
- "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.
- },
- "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`.
- "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
- "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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
- "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.
- },
- },
- ],
- },
+ },
+ ],
+ "creativeRestrictions": { # Represents creative restrictions associated to Programmatic Guaranteed/ # Output only. Restricitions about the creatives associated with the deal
+ # (i.e., size) This is available for Programmatic Guaranteed/Preferred Deals
+ # in Ad Manager.
+ # Preferred Deal in Ad Manager.
+ # This doesn't apply to Private Auction and AdX Preferred Deals.
+ "skippableAdType": "A String", # Skippable video ads allow viewers to skip ads after 5 seconds.
+ "creativeFormat": "A String", # The format of the environment that the creatives will be displayed in.
+ "creativeSpecifications": [
+ { # Represents information for a creative that is associated with a Programmatic
+ # Guaranteed/Preferred Deal in Ad Manager.
+ "creativeSize": { # Represents size of a single ad slot, or a creative. # The size of the creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
},
- ],
+ "creativeCompanionSizes": [ # Companion sizes may be filled in only when this is a video creative.
+ { # Represents size of a single ad slot, or a creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
+ },
+ ],
+ },
+ ],
+ },
+ "dealServingMetadata": { # Message captures metadata about the serving status of a deal. # Output only. Metadata about the serving status of this deal.
+ "dealPauseStatus": { # Tracks which parties (if any) have paused a deal. # Output only. Tracks which parties (if any) have paused a deal.
+ # The deal is considered paused if either hasBuyerPaused or
+ # hasSellPaused is true.
+ "firstPausedBy": "A String", # The role of the person who first paused this deal.
+ "hasBuyerPaused": True or False, # True, if the buyer has paused the deal unilaterally.
+ "buyerPauseReason": "A String", # The buyer's reason for pausing, if the buyer paused the deal.
+ "sellerPauseReason": "A String", # The seller's reason for pausing, if the seller paused the deal.
+ "hasSellerPaused": True or False, # True, if the seller has paused the deal unilaterally.
},
- ],
- "dealId": "A String", # Output only. A unique deal ID for the deal (server-assigned).
- "proposalId": "A String", # Output only. ID of the proposal that this deal is part of.
- "availableEndTime": "A String", # Proposed flight end time of the deal.
- # This will generally be stored in a granularity of a second.
- # A value is not required for Private Auction deals or Preferred Deals.
- "syndicationProduct": "A String", # The syndication product associated with the deal.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "createProductId": "A String", # The product ID from which this deal was created.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "creativeSafeFrameCompatibility": "A String", # Output only. Specifies whether the creative is safeFrame compatible.
- "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
- # deal.
- "createProductRevision": "A String", # Optional revision number of the product that the deal was created from.
- # If present on create, and the server `product_revision` has advanced sinced
- # the passed-in `create_product_revision`, an `ABORTED` error will be
- # returned.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "sellerContacts": [ # Output only. Seller contact information for the deal.
- { # 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.
- },
- ],
- "availableStartTime": "A String", # Optional proposed flight start time of the deal.
- # This will generally be stored in the granularity of one second since deal
- # serving starts at seconds boundary. Any time specified with more
- # granularity (e.g., in milliseconds) will be truncated towards the start of
- # time in seconds.
- "createTime": "A String", # Output only. The time of the deal creation.
+ },
"dealTerms": { # 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.
- "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.
+ "guaranteedFixedPriceTerms": { # Terms for Programmatic Guaranteed Deals. # The terms for guaranteed fixed price deals.
+ "guaranteedLooks": "A String", # Count of guaranteed looks. Required for deal, optional for product.
+ "guaranteedImpressions": "A String", # Guaranteed impressions as a percentage. This is the percentage
+ # of guaranteed looks that the buyer is guaranteeing to buy.
+ "minimumDailyLooks": "A String", # Daily minimum looks for CPD deal types.
"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
@@ -1730,24 +1690,24 @@
# 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.
+ "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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
"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.
},
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
},
- "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",
- ],
"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).
@@ -1757,6 +1717,11 @@
},
],
},
+ "description": "A String", # Publisher provided description for the terms.
+ "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.
"nonGuaranteedAuctionTerms": { # Terms for Private Auctions. Note that Private Auctions can be created only # The terms for non-guaranteed auction deals.
@@ -1770,24 +1735,60 @@
# 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.
+ "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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
"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.
},
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
},
+ "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.
+ },
+ },
+ ],
+ },
+ "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.
"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.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+ "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.
+ "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ },
+ },
"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).
@@ -1799,152 +1800,34 @@
},
"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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
"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.
},
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
},
"brandingType": "A String", # Visibility of the URL in bid requests. (default: BRANDED)
- "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.
- "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.
- "minimumDailyLooks": "A String", # Daily minimum looks for CPD deal types.
- "guaranteedLooks": "A String", # Count of guaranteed looks. Required for deal, optional for product.
- "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.
- "price": { # Represents a price and a pricing type for a product / deal. # The specified price.
- "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- "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.
- },
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
- },
- "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",
- ],
- "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.
- },
- },
- ],
- },
},
+ "externalDealId": "A String", # Output only. 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.
+ "createProductId": "A String", # The product ID from which this deal was created.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ "updateTime": "A String", # Output only. The time when the deal was last updated.
+ "proposalId": "A String", # Output only. ID of the proposal that this deal is part of.
"targeting": { # Targeting represents different criteria that can be used by advertisers to # Output only. Specifies the subset of inventory targeted by the deal.
# target ad inventory. For example, they can choose to target ad requests only
# if the user is in the US.
# Multiple types of targeting are always applied as a logical AND, unless noted
# otherwise.
- "geoTargeting": { # Generic targeting used for targeting dimensions that contains a list of # Geo criteria IDs to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- "inventorySizeTargeting": { # Represents the size of an ad unit that can be targeted on an ad # Inventory sizes to be included/excluded.
- # request. It only applies to Private Auction, AdX Preferred Deals and
- # Auction Packages. This targeting does not apply to Programmatic Guaranteed
- # and Preferred Deals in Ad Manager.
- "targetedInventorySizes": [ # A list of inventory sizes to be included.
- { # Represents size of a single ad slot, or a creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- ],
- "excludedInventorySizes": [ # A list of inventory sizes to be excluded.
- { # Represents size of a single ad slot, or a creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- ],
- },
- "videoTargeting": { # Represents targeting information about video. # Video targeting information.
- "targetedPositionTypes": [ # A list of video positions to be included.
- # When the included list is present, the excluded list must be empty.
- # When the excluded list is present, the included list must be empty.
- "A String",
- ],
- "excludedPositionTypes": [ # A list of video positions to be excluded.
- # Position types can either be included or excluded (XOR).
- "A String",
- ],
- },
- "technologyTargeting": { # Represents targeting about various types of technology. # Technology targeting information, e.g., operating system, device category.
- "deviceCapabilityTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device capabilities to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- "operatingSystemTargeting": { # Represents targeting information for operating systems. # Operating system related targeting information.
- "operatingSystemCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating systems to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- "operatingSystemVersionCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating system versions to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- },
- "deviceCategoryTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device categories to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- },
"placementTargeting": { # Represents targeting about where the ads can appear, e.g., certain sites or # Placement targeting information, e.g., URL, mobile applications.
# mobile applications.
# Different placement targeting types will be logically OR'ed.
@@ -1953,10 +1836,10 @@
# excluded.
# For Programmatic Guaranteed and Preferred Deals, this doesn't
# apply.
- "targetedUrls": [ # A list of URLs to be included.
+ "excludedUrls": [ # A list of URLs to be excluded.
"A String",
],
- "excludedUrls": [ # A list of URLs to be excluded.
+ "targetedUrls": [ # A list of URLs to be included.
"A String",
],
},
@@ -1970,84 +1853,155 @@
# Google Play Store URL.
# iOS App ID (which is a number) can be found at the end of iTunes store URL.
# First party mobile applications is either included or excluded.
- "targetedAppIds": [ # A list of application IDs to be included.
+ "excludedAppIds": [ # A list of application IDs to be excluded.
"A String",
],
- "excludedAppIds": [ # A list of application IDs to be excluded.
+ "targetedAppIds": [ # A list of application IDs to be included.
"A String",
],
},
},
},
+ "inventorySizeTargeting": { # Represents the size of an ad unit that can be targeted on an ad # Inventory sizes to be included/excluded.
+ # request. It only applies to Private Auction, AdX Preferred Deals and
+ # Auction Packages. This targeting does not apply to Programmatic Guaranteed
+ # and Preferred Deals in Ad Manager.
+ "targetedInventorySizes": [ # A list of inventory sizes to be included.
+ { # Represents size of a single ad slot, or a creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
+ },
+ ],
+ "excludedInventorySizes": [ # A list of inventory sizes to be excluded.
+ { # Represents size of a single ad slot, or a creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
+ },
+ ],
+ },
+ "geoTargeting": { # Generic targeting used for targeting dimensions that contains a list of # Geo criteria IDs to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ "technologyTargeting": { # Represents targeting about various types of technology. # Technology targeting information, e.g., operating system, device category.
+ "operatingSystemTargeting": { # Represents targeting information for operating systems. # Operating system related targeting information.
+ "operatingSystemVersionCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating system versions to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ "operatingSystemCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating systems to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ },
+ "deviceCapabilityTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device capabilities to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ "deviceCategoryTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device categories to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ },
+ "videoTargeting": { # Represents targeting information about video. # Video targeting information.
+ "targetedPositionTypes": [ # A list of video positions to be included.
+ # When the included list is present, the excluded list must be empty.
+ # When the excluded list is present, the included list must be empty.
+ "A String",
+ ],
+ "excludedPositionTypes": [ # A list of video positions to be excluded.
+ # Position types can either be included or excluded (XOR).
+ "A String",
+ ],
+ },
},
- "creativePreApprovalPolicy": "A String", # Output only. Specifies the creative pre-approval policy.
+ "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Buyer private data (hidden from seller).
+ "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
+ # operations (max-length: 1024 unicode code units).
+ },
"deliveryControl": { # Message contains details about how the deals will be paced. # 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.
- "deliveryRateType": "A String", # Output only. Specifies how the impression delivery will be paced.
"frequencyCaps": [ # Output only. Specifies any frequency caps.
{ # Frequency cap.
- "numTimeUnits": 42, # The amount of time, in the units specified by time_unit_type. Defines the
- # amount of time over which impressions per user are counted and capped.
"maxImpressions": 42, # The maximum number of impressions that can be served to a user within the
# specified time period.
"timeUnitType": "A String", # The time unit. Along with num_time_units defines the amount of time over
# which impressions per user are counted and capped.
+ "numTimeUnits": 42, # The amount of time, in the units specified by time_unit_type. Defines the
+ # amount of time over which impressions per user are counted and capped.
},
],
"creativeBlockingLevel": "A String", # Output only. Specified the creative blocking levels to be applied.
+ "deliveryRateType": "A String", # Output only. Specifies how the impression delivery will be paced.
},
- "externalDealId": "A String", # Output only. 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.
- "creativeRestrictions": { # Represents creative restrictions associated to Programmatic Guaranteed/ # Output only. Restricitions about the creatives associated with the deal
- # (i.e., size) This is available for Programmatic Guaranteed/Preferred Deals
- # in Ad Manager.
- # Preferred Deal in Ad Manager.
- # This doesn't apply to Private Auction and AdX Preferred Deals.
- "creativeFormat": "A String", # The format of the environment that the creatives will be displayed in.
- "creativeSpecifications": [
- { # Represents information for a creative that is associated with a Programmatic
- # Guaranteed/Preferred Deal in Ad Manager.
- "creativeSize": { # Represents size of a single ad slot, or a creative. # The size of the creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- "creativeCompanionSizes": [ # Companion sizes may be filled in only when this is a video creative.
- { # Represents size of a single ad slot, or a creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- ],
- },
- ],
- "skippableAdType": "A String", # Skippable video ads allow viewers to skip ads after 5 seconds.
- },
- "dealServingMetadata": { # Message captures metadata about the serving status of a deal. # Output only. Metadata about the serving status of this deal.
- "dealPauseStatus": { # Tracks which parties (if any) have paused a deal. # Output only. Tracks which parties (if any) have paused a deal.
- # The deal is considered paused if either hasBuyerPaused or
- # hasSellPaused is true.
- "firstPausedBy": "A String", # The role of the person who first paused this deal.
- "sellerPauseReason": "A String", # The seller's reason for pausing, if the seller paused the deal.
- "hasSellerPaused": True or False, # True, if the seller has paused the deal unilaterally.
- "buyerPauseReason": "A String", # The buyer's reason for pausing, if the buyer paused the deal.
- "hasBuyerPaused": True or False, # True, if the buyer has paused the deal unilaterally.
+ "availableEndTime": "A String", # Proposed flight end time of the deal.
+ # This will generally be stored in a granularity of a second.
+ # A value is not required for Private Auction deals or Preferred Deals.
+ "availableStartTime": "A String", # Optional proposed flight start time of the deal.
+ # This will generally be stored in the granularity of one second since deal
+ # serving starts at seconds boundary. Any time specified with more
+ # granularity (e.g., in milliseconds) will be truncated towards the start of
+ # time in seconds.
+ "displayName": "A String", # The name of the deal.
+ "creativeSafeFrameCompatibility": "A String", # Output only. Specifies whether the creative is safeFrame compatible.
+ "createProductRevision": "A String", # Optional revision number of the product that the deal was created from.
+ # If present on create, and the server `product_revision` has advanced sinced
+ # the passed-in `create_product_revision`, an `ABORTED` error will be
+ # returned.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ "creativePreApprovalPolicy": "A String", # Output only. Specifies the creative pre-approval policy.
+ "webPropertyCode": "A String", # The web property code for the seller copied over from the product.
+ "sellerContacts": [ # Output only. Seller contact information for the deal.
+ { # Contains information on how a buyer or seller can be reached.
+ "name": "A String", # The name of the contact.
+ "email": "A String", # Email address for the contact.
},
- },
+ ],
"description": "A String", # Description for the deal terms.
+ "syndicationProduct": "A String", # The syndication product associated with the deal.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
},
],
- "proposalRevision": "A String", # Output only. The revision number for the proposal.
- # Each update to the proposal or the deal causes the proposal revision number
- # to auto-increment. The buyer keeps track of the last revision number they
- # know of and pass it in when making an update. If the head revision number
- # on the server has since incremented, then an ABORTED error is returned
- # during the update operation to let the buyer know that a subsequent update
- # was made.
+ "billedBuyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Output only. Reference to the buyer that will get billed for this proposal.
+ # Authorized Buyers account ID.
+ "accountId": "A String", # Authorized Buyers account ID of the buyer.
+ },
+ "displayName": "A String", # The name for the proposal.
"seller": { # Represents a seller of inventory. Each seller is identified by a unique # Reference to the seller on the proposal.
#
# Note: This field may be set only when creating the resource. Modifying
@@ -2057,6 +2011,52 @@
"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.
},
+ "updateTime": "A String", # Output only. The time when the proposal was last revised.
+ "proposalId": "A String", # Output only. The unique ID of the proposal.
+ "isRenegotiating": True or False, # Output only. True if the proposal is being renegotiated.
+ "proposalState": "A String", # Output only. The current state of the proposal.
+ "notes": [ # Output only. The notes associated with this proposal.
+ { # A proposal may be associated to several notes.
+ "noteId": "A String", # Output only. The unique ID for the note.
+ "creatorRole": "A String", # Output only. The role of the person (buyer/seller) creating the note.
+ "proposalRevision": "A String", # Output only. The revision number of the proposal when the note is created.
+ "createTime": "A String", # Output only. The timestamp for when this note was created.
+ "note": "A String", # The actual note to attach.
+ # (max-length: 1024 unicode code units)
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ },
+ ],
+ "sellerContacts": [ # Output only. Contact information for the seller.
+ { # Contains information on how a buyer or seller can be reached.
+ "name": "A String", # The name of the contact.
+ "email": "A String", # Email address for the contact.
+ },
+ ],
+ "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Private data for buyer. (hidden from seller).
+ "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
+ # operations (max-length: 1024 unicode code units).
+ },
+ "buyerContacts": [ # Contact information for the buyer.
+ { # Contains information on how a buyer or seller can be reached.
+ "name": "A String", # The name of the contact.
+ "email": "A String", # Email address for the contact.
+ },
+ ],
+ "privateAuctionId": "A String", # Output only. Private auction ID if this proposal is a private auction
+ # proposal.
+ "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
+ # proposal.
+ "buyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Reference to the buyer on the proposal.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ # Authorized Buyers account ID.
+ "accountId": "A String", # Authorized Buyers account ID of the buyer.
+ },
+ "lastUpdaterOrCommentorRole": "A String", # Output only. The role of the last user that either updated the proposal or
+ # left a comment.
}</pre>
</div>
@@ -2081,73 +2081,26 @@
# Auction or Preferred Deals deals through the API.
#
# Fields are updatable unless noted otherwise.
- "buyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Reference to the buyer on the proposal.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- # Authorized Buyers account ID.
- "accountId": "A String", # Authorized Buyers account ID of the buyer.
- },
- "isRenegotiating": True or False, # Output only. True if the proposal is being renegotiated.
- "notes": [ # Output only. The notes associated with this proposal.
- { # A proposal may be associated to several notes.
- "note": "A String", # The actual note to attach.
- # (max-length: 1024 unicode code units)
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "proposalRevision": "A String", # Output only. The revision number of the proposal when the note is created.
- "noteId": "A String", # Output only. The unique ID for the note.
- "createTime": "A String", # Output only. The timestamp for when this note was created.
- "creatorRole": "A String", # Output only. The role of the person (buyer/seller) creating the note.
- },
- ],
- "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
- # proposal.
- "proposalState": "A String", # Output only. The current state of the proposal.
- "sellerContacts": [ # Output only. Contact information for the seller.
- { # 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.
- },
- ],
- "privateAuctionId": "A String", # Output only. Private auction ID if this proposal is a private auction
- # proposal.
+ "proposalRevision": "A String", # Output only. The revision number for the proposal.
+ # Each update to the proposal or the deal causes the proposal revision number
+ # to auto-increment. The buyer keeps track of the last revision number they
+ # know of and pass it in when making an update. If the head revision number
+ # on the server has since incremented, then an ABORTED error is returned
+ # during the update operation to let the buyer know that a subsequent update
+ # was made.
"originatorRole": "A String", # Output only. Indicates whether the buyer/seller created the proposal.
- "lastUpdaterOrCommentorRole": "A String", # Output only. The role of the last user that either updated the proposal or
- # left a comment.
- "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Private data for buyer. (hidden from seller).
- "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
- # operations (max-length: 1024 unicode code units).
- },
- "displayName": "A String", # The name for the proposal.
- "buyerContacts": [ # Contact information for the buyer.
- { # 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.
- },
- ],
- "billedBuyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Output only. Reference to the buyer that will get billed for this proposal.
- # Authorized Buyers account ID.
- "accountId": "A String", # Authorized Buyers account ID of the buyer.
- },
- "updateTime": "A String", # Output only. The time when the proposal was last revised.
- "proposalId": "A String", # Output only. The unique ID of the proposal.
"deals": [ # The deals associated with this proposal. For Private Auction proposals
# (whose deals have NonGuaranteedAuctionTerms), there will only be one deal.
{ # A deal represents a segment of inventory for displaying ads on.
# A proposal can contain multiple deals. A deal contains the terms and
# targeting information that is used for serving.
+ "dealId": "A String", # Output only. A unique deal ID for the deal (server-assigned).
+ "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
+ # deal.
+ "createTime": "A String", # Output only. The time of the deal creation.
"programmaticCreativeSource": "A String", # Output only. Specifies the creative source for programmatic deals.
# PUBLISHER means creative is provided by seller and ADVERTISER means
# creative is provided by buyer.
- "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Buyer private data (hidden from seller).
- "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
- # operations (max-length: 1024 unicode code units).
- },
- "displayName": "A String", # The name of the deal.
- "webPropertyCode": "A String", # The web property code for the seller copied over from the product.
- "updateTime": "A String", # Output only. The time when the deal was last updated.
"targetingCriterion": [ # The shared targeting visible to buyers and sellers. Each shared
# targeting entity is AND'd together.
{ # Advertisers can target different attributes of an ad slot. For example,
@@ -2156,36 +2109,6 @@
"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.
- "creativeSizeValue": { # Specifies the size of the creative. # The creative size value to include/exclude.
- # Filled in when key = GOOG_CREATIVE_SIZE
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- "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",
- ],
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- ],
- "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.
- "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
- # only if creative_size_type = CreativeSizeType.NATIVE.
- },
- "stringValue": "A String", # The string value to include/exclude.
- "longValue": "A String", # The long value to include/exclude.
"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
@@ -2194,34 +2117,135 @@
"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.
- "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`.
- "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
- "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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
- "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.
- },
- "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`.
- "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.
"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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
"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.
},
+ "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`.
+ "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "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.
+ "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.
+ },
+ "dayOfWeek": "A String", # The day of the week to target. If unspecified, applicable to all days.
},
],
},
+ "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
+ "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
+ # only if creative_size_type = CreativeSizeType.NATIVE.
+ "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.
+ },
+ "creativeSizeType": "A String", # The creative size type.
+ "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.
+ "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.
+ },
+ ],
+ },
+ "stringValue": "A String", # The string value to include/exclude.
+ },
+ ],
+ "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.
+ "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.
+ "timeZoneType": "A String", # The timezone to use for interpreting the day part targeting.
+ "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.
+ "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`.
+ "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "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.
+ "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.
+ },
+ "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`.
+ "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "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.
+ "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.
+ },
+ "dayOfWeek": "A String", # The day of the week to target. If unspecified, applicable to all days.
+ },
+ ],
+ },
+ "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
+ "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
+ # only if creative_size_type = CreativeSizeType.NATIVE.
+ "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.
+ },
+ "creativeSizeType": "A String", # The creative size type.
+ "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.
+ "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.
+ },
+ ],
+ },
+ "stringValue": "A String", # The string value to include/exclude.
},
],
"key": "A String", # The key representing the shared targeting criterion.
@@ -2229,120 +2253,56 @@
# 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.
- "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.
- "creativeSizeValue": { # Specifies the size of the creative. # The creative size value to include/exclude.
- # Filled in when key = GOOG_CREATIVE_SIZE
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- "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",
- ],
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- ],
- "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.
- "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
- # only if creative_size_type = CreativeSizeType.NATIVE.
- },
- "stringValue": "A String", # The string value to include/exclude.
- "longValue": "A String", # The long value to include/exclude.
- "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.
- "timeZoneType": "A String", # The timezone to use for interpreting the day part targeting.
- "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.
- "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`.
- "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
- "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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
- "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.
- },
- "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`.
- "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
- "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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
- "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.
- },
- },
- ],
- },
+ },
+ ],
+ "creativeRestrictions": { # Represents creative restrictions associated to Programmatic Guaranteed/ # Output only. Restricitions about the creatives associated with the deal
+ # (i.e., size) This is available for Programmatic Guaranteed/Preferred Deals
+ # in Ad Manager.
+ # Preferred Deal in Ad Manager.
+ # This doesn't apply to Private Auction and AdX Preferred Deals.
+ "skippableAdType": "A String", # Skippable video ads allow viewers to skip ads after 5 seconds.
+ "creativeFormat": "A String", # The format of the environment that the creatives will be displayed in.
+ "creativeSpecifications": [
+ { # Represents information for a creative that is associated with a Programmatic
+ # Guaranteed/Preferred Deal in Ad Manager.
+ "creativeSize": { # Represents size of a single ad slot, or a creative. # The size of the creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
},
- ],
+ "creativeCompanionSizes": [ # Companion sizes may be filled in only when this is a video creative.
+ { # Represents size of a single ad slot, or a creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
+ },
+ ],
+ },
+ ],
+ },
+ "dealServingMetadata": { # Message captures metadata about the serving status of a deal. # Output only. Metadata about the serving status of this deal.
+ "dealPauseStatus": { # Tracks which parties (if any) have paused a deal. # Output only. Tracks which parties (if any) have paused a deal.
+ # The deal is considered paused if either hasBuyerPaused or
+ # hasSellPaused is true.
+ "firstPausedBy": "A String", # The role of the person who first paused this deal.
+ "hasBuyerPaused": True or False, # True, if the buyer has paused the deal unilaterally.
+ "buyerPauseReason": "A String", # The buyer's reason for pausing, if the buyer paused the deal.
+ "sellerPauseReason": "A String", # The seller's reason for pausing, if the seller paused the deal.
+ "hasSellerPaused": True or False, # True, if the seller has paused the deal unilaterally.
},
- ],
- "dealId": "A String", # Output only. A unique deal ID for the deal (server-assigned).
- "proposalId": "A String", # Output only. ID of the proposal that this deal is part of.
- "availableEndTime": "A String", # Proposed flight end time of the deal.
- # This will generally be stored in a granularity of a second.
- # A value is not required for Private Auction deals or Preferred Deals.
- "syndicationProduct": "A String", # The syndication product associated with the deal.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "createProductId": "A String", # The product ID from which this deal was created.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "creativeSafeFrameCompatibility": "A String", # Output only. Specifies whether the creative is safeFrame compatible.
- "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
- # deal.
- "createProductRevision": "A String", # Optional revision number of the product that the deal was created from.
- # If present on create, and the server `product_revision` has advanced sinced
- # the passed-in `create_product_revision`, an `ABORTED` error will be
- # returned.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "sellerContacts": [ # Output only. Seller contact information for the deal.
- { # 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.
- },
- ],
- "availableStartTime": "A String", # Optional proposed flight start time of the deal.
- # This will generally be stored in the granularity of one second since deal
- # serving starts at seconds boundary. Any time specified with more
- # granularity (e.g., in milliseconds) will be truncated towards the start of
- # time in seconds.
- "createTime": "A String", # Output only. The time of the deal creation.
+ },
"dealTerms": { # 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.
- "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.
+ "guaranteedFixedPriceTerms": { # Terms for Programmatic Guaranteed Deals. # The terms for guaranteed fixed price deals.
+ "guaranteedLooks": "A String", # Count of guaranteed looks. Required for deal, optional for product.
+ "guaranteedImpressions": "A String", # Guaranteed impressions as a percentage. This is the percentage
+ # of guaranteed looks that the buyer is guaranteeing to buy.
+ "minimumDailyLooks": "A String", # Daily minimum looks for CPD deal types.
"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
@@ -2350,24 +2310,24 @@
# 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.
+ "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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
"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.
},
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
},
- "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",
- ],
"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).
@@ -2377,6 +2337,11 @@
},
],
},
+ "description": "A String", # Publisher provided description for the terms.
+ "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.
"nonGuaranteedAuctionTerms": { # Terms for Private Auctions. Note that Private Auctions can be created only # The terms for non-guaranteed auction deals.
@@ -2390,24 +2355,60 @@
# 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.
+ "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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
"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.
},
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
},
+ "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.
+ },
+ },
+ ],
+ },
+ "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.
"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.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+ "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.
+ "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ },
+ },
"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).
@@ -2419,152 +2420,34 @@
},
"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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
"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.
},
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
},
"brandingType": "A String", # Visibility of the URL in bid requests. (default: BRANDED)
- "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.
- "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.
- "minimumDailyLooks": "A String", # Daily minimum looks for CPD deal types.
- "guaranteedLooks": "A String", # Count of guaranteed looks. Required for deal, optional for product.
- "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.
- "price": { # Represents a price and a pricing type for a product / deal. # The specified price.
- "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- "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.
- },
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
- },
- "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",
- ],
- "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.
- },
- },
- ],
- },
},
+ "externalDealId": "A String", # Output only. 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.
+ "createProductId": "A String", # The product ID from which this deal was created.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ "updateTime": "A String", # Output only. The time when the deal was last updated.
+ "proposalId": "A String", # Output only. ID of the proposal that this deal is part of.
"targeting": { # Targeting represents different criteria that can be used by advertisers to # Output only. Specifies the subset of inventory targeted by the deal.
# target ad inventory. For example, they can choose to target ad requests only
# if the user is in the US.
# Multiple types of targeting are always applied as a logical AND, unless noted
# otherwise.
- "geoTargeting": { # Generic targeting used for targeting dimensions that contains a list of # Geo criteria IDs to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- "inventorySizeTargeting": { # Represents the size of an ad unit that can be targeted on an ad # Inventory sizes to be included/excluded.
- # request. It only applies to Private Auction, AdX Preferred Deals and
- # Auction Packages. This targeting does not apply to Programmatic Guaranteed
- # and Preferred Deals in Ad Manager.
- "targetedInventorySizes": [ # A list of inventory sizes to be included.
- { # Represents size of a single ad slot, or a creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- ],
- "excludedInventorySizes": [ # A list of inventory sizes to be excluded.
- { # Represents size of a single ad slot, or a creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- ],
- },
- "videoTargeting": { # Represents targeting information about video. # Video targeting information.
- "targetedPositionTypes": [ # A list of video positions to be included.
- # When the included list is present, the excluded list must be empty.
- # When the excluded list is present, the included list must be empty.
- "A String",
- ],
- "excludedPositionTypes": [ # A list of video positions to be excluded.
- # Position types can either be included or excluded (XOR).
- "A String",
- ],
- },
- "technologyTargeting": { # Represents targeting about various types of technology. # Technology targeting information, e.g., operating system, device category.
- "deviceCapabilityTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device capabilities to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- "operatingSystemTargeting": { # Represents targeting information for operating systems. # Operating system related targeting information.
- "operatingSystemCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating systems to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- "operatingSystemVersionCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating system versions to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- },
- "deviceCategoryTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device categories to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- },
"placementTargeting": { # Represents targeting about where the ads can appear, e.g., certain sites or # Placement targeting information, e.g., URL, mobile applications.
# mobile applications.
# Different placement targeting types will be logically OR'ed.
@@ -2573,10 +2456,10 @@
# excluded.
# For Programmatic Guaranteed and Preferred Deals, this doesn't
# apply.
- "targetedUrls": [ # A list of URLs to be included.
+ "excludedUrls": [ # A list of URLs to be excluded.
"A String",
],
- "excludedUrls": [ # A list of URLs to be excluded.
+ "targetedUrls": [ # A list of URLs to be included.
"A String",
],
},
@@ -2590,84 +2473,155 @@
# Google Play Store URL.
# iOS App ID (which is a number) can be found at the end of iTunes store URL.
# First party mobile applications is either included or excluded.
- "targetedAppIds": [ # A list of application IDs to be included.
+ "excludedAppIds": [ # A list of application IDs to be excluded.
"A String",
],
- "excludedAppIds": [ # A list of application IDs to be excluded.
+ "targetedAppIds": [ # A list of application IDs to be included.
"A String",
],
},
},
},
+ "inventorySizeTargeting": { # Represents the size of an ad unit that can be targeted on an ad # Inventory sizes to be included/excluded.
+ # request. It only applies to Private Auction, AdX Preferred Deals and
+ # Auction Packages. This targeting does not apply to Programmatic Guaranteed
+ # and Preferred Deals in Ad Manager.
+ "targetedInventorySizes": [ # A list of inventory sizes to be included.
+ { # Represents size of a single ad slot, or a creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
+ },
+ ],
+ "excludedInventorySizes": [ # A list of inventory sizes to be excluded.
+ { # Represents size of a single ad slot, or a creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
+ },
+ ],
+ },
+ "geoTargeting": { # Generic targeting used for targeting dimensions that contains a list of # Geo criteria IDs to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ "technologyTargeting": { # Represents targeting about various types of technology. # Technology targeting information, e.g., operating system, device category.
+ "operatingSystemTargeting": { # Represents targeting information for operating systems. # Operating system related targeting information.
+ "operatingSystemVersionCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating system versions to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ "operatingSystemCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating systems to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ },
+ "deviceCapabilityTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device capabilities to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ "deviceCategoryTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device categories to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ },
+ "videoTargeting": { # Represents targeting information about video. # Video targeting information.
+ "targetedPositionTypes": [ # A list of video positions to be included.
+ # When the included list is present, the excluded list must be empty.
+ # When the excluded list is present, the included list must be empty.
+ "A String",
+ ],
+ "excludedPositionTypes": [ # A list of video positions to be excluded.
+ # Position types can either be included or excluded (XOR).
+ "A String",
+ ],
+ },
},
- "creativePreApprovalPolicy": "A String", # Output only. Specifies the creative pre-approval policy.
+ "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Buyer private data (hidden from seller).
+ "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
+ # operations (max-length: 1024 unicode code units).
+ },
"deliveryControl": { # Message contains details about how the deals will be paced. # 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.
- "deliveryRateType": "A String", # Output only. Specifies how the impression delivery will be paced.
"frequencyCaps": [ # Output only. Specifies any frequency caps.
{ # Frequency cap.
- "numTimeUnits": 42, # The amount of time, in the units specified by time_unit_type. Defines the
- # amount of time over which impressions per user are counted and capped.
"maxImpressions": 42, # The maximum number of impressions that can be served to a user within the
# specified time period.
"timeUnitType": "A String", # The time unit. Along with num_time_units defines the amount of time over
# which impressions per user are counted and capped.
+ "numTimeUnits": 42, # The amount of time, in the units specified by time_unit_type. Defines the
+ # amount of time over which impressions per user are counted and capped.
},
],
"creativeBlockingLevel": "A String", # Output only. Specified the creative blocking levels to be applied.
+ "deliveryRateType": "A String", # Output only. Specifies how the impression delivery will be paced.
},
- "externalDealId": "A String", # Output only. 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.
- "creativeRestrictions": { # Represents creative restrictions associated to Programmatic Guaranteed/ # Output only. Restricitions about the creatives associated with the deal
- # (i.e., size) This is available for Programmatic Guaranteed/Preferred Deals
- # in Ad Manager.
- # Preferred Deal in Ad Manager.
- # This doesn't apply to Private Auction and AdX Preferred Deals.
- "creativeFormat": "A String", # The format of the environment that the creatives will be displayed in.
- "creativeSpecifications": [
- { # Represents information for a creative that is associated with a Programmatic
- # Guaranteed/Preferred Deal in Ad Manager.
- "creativeSize": { # Represents size of a single ad slot, or a creative. # The size of the creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- "creativeCompanionSizes": [ # Companion sizes may be filled in only when this is a video creative.
- { # Represents size of a single ad slot, or a creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- ],
- },
- ],
- "skippableAdType": "A String", # Skippable video ads allow viewers to skip ads after 5 seconds.
- },
- "dealServingMetadata": { # Message captures metadata about the serving status of a deal. # Output only. Metadata about the serving status of this deal.
- "dealPauseStatus": { # Tracks which parties (if any) have paused a deal. # Output only. Tracks which parties (if any) have paused a deal.
- # The deal is considered paused if either hasBuyerPaused or
- # hasSellPaused is true.
- "firstPausedBy": "A String", # The role of the person who first paused this deal.
- "sellerPauseReason": "A String", # The seller's reason for pausing, if the seller paused the deal.
- "hasSellerPaused": True or False, # True, if the seller has paused the deal unilaterally.
- "buyerPauseReason": "A String", # The buyer's reason for pausing, if the buyer paused the deal.
- "hasBuyerPaused": True or False, # True, if the buyer has paused the deal unilaterally.
+ "availableEndTime": "A String", # Proposed flight end time of the deal.
+ # This will generally be stored in a granularity of a second.
+ # A value is not required for Private Auction deals or Preferred Deals.
+ "availableStartTime": "A String", # Optional proposed flight start time of the deal.
+ # This will generally be stored in the granularity of one second since deal
+ # serving starts at seconds boundary. Any time specified with more
+ # granularity (e.g., in milliseconds) will be truncated towards the start of
+ # time in seconds.
+ "displayName": "A String", # The name of the deal.
+ "creativeSafeFrameCompatibility": "A String", # Output only. Specifies whether the creative is safeFrame compatible.
+ "createProductRevision": "A String", # Optional revision number of the product that the deal was created from.
+ # If present on create, and the server `product_revision` has advanced sinced
+ # the passed-in `create_product_revision`, an `ABORTED` error will be
+ # returned.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ "creativePreApprovalPolicy": "A String", # Output only. Specifies the creative pre-approval policy.
+ "webPropertyCode": "A String", # The web property code for the seller copied over from the product.
+ "sellerContacts": [ # Output only. Seller contact information for the deal.
+ { # Contains information on how a buyer or seller can be reached.
+ "name": "A String", # The name of the contact.
+ "email": "A String", # Email address for the contact.
},
- },
+ ],
"description": "A String", # Description for the deal terms.
+ "syndicationProduct": "A String", # The syndication product associated with the deal.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
},
],
- "proposalRevision": "A String", # Output only. The revision number for the proposal.
- # Each update to the proposal or the deal causes the proposal revision number
- # to auto-increment. The buyer keeps track of the last revision number they
- # know of and pass it in when making an update. If the head revision number
- # on the server has since incremented, then an ABORTED error is returned
- # during the update operation to let the buyer know that a subsequent update
- # was made.
+ "billedBuyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Output only. Reference to the buyer that will get billed for this proposal.
+ # Authorized Buyers account ID.
+ "accountId": "A String", # Authorized Buyers account ID of the buyer.
+ },
+ "displayName": "A String", # The name for the proposal.
"seller": { # Represents a seller of inventory. Each seller is identified by a unique # Reference to the seller on the proposal.
#
# Note: This field may be set only when creating the resource. Modifying
@@ -2677,6 +2631,52 @@
"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.
},
+ "updateTime": "A String", # Output only. The time when the proposal was last revised.
+ "proposalId": "A String", # Output only. The unique ID of the proposal.
+ "isRenegotiating": True or False, # Output only. True if the proposal is being renegotiated.
+ "proposalState": "A String", # Output only. The current state of the proposal.
+ "notes": [ # Output only. The notes associated with this proposal.
+ { # A proposal may be associated to several notes.
+ "noteId": "A String", # Output only. The unique ID for the note.
+ "creatorRole": "A String", # Output only. The role of the person (buyer/seller) creating the note.
+ "proposalRevision": "A String", # Output only. The revision number of the proposal when the note is created.
+ "createTime": "A String", # Output only. The timestamp for when this note was created.
+ "note": "A String", # The actual note to attach.
+ # (max-length: 1024 unicode code units)
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ },
+ ],
+ "sellerContacts": [ # Output only. Contact information for the seller.
+ { # Contains information on how a buyer or seller can be reached.
+ "name": "A String", # The name of the contact.
+ "email": "A String", # Email address for the contact.
+ },
+ ],
+ "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Private data for buyer. (hidden from seller).
+ "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
+ # operations (max-length: 1024 unicode code units).
+ },
+ "buyerContacts": [ # Contact information for the buyer.
+ { # Contains information on how a buyer or seller can be reached.
+ "name": "A String", # The name of the contact.
+ "email": "A String", # Email address for the contact.
+ },
+ ],
+ "privateAuctionId": "A String", # Output only. Private auction ID if this proposal is a private auction
+ # proposal.
+ "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
+ # proposal.
+ "buyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Reference to the buyer on the proposal.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ # Authorized Buyers account ID.
+ "accountId": "A String", # Authorized Buyers account ID of the buyer.
+ },
+ "lastUpdaterOrCommentorRole": "A String", # Output only. The role of the last user that either updated the proposal or
+ # left a comment.
}
x__xgafv: string, V1 error format.
@@ -2698,73 +2698,26 @@
# Auction or Preferred Deals deals through the API.
#
# Fields are updatable unless noted otherwise.
- "buyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Reference to the buyer on the proposal.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- # Authorized Buyers account ID.
- "accountId": "A String", # Authorized Buyers account ID of the buyer.
- },
- "isRenegotiating": True or False, # Output only. True if the proposal is being renegotiated.
- "notes": [ # Output only. The notes associated with this proposal.
- { # A proposal may be associated to several notes.
- "note": "A String", # The actual note to attach.
- # (max-length: 1024 unicode code units)
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "proposalRevision": "A String", # Output only. The revision number of the proposal when the note is created.
- "noteId": "A String", # Output only. The unique ID for the note.
- "createTime": "A String", # Output only. The timestamp for when this note was created.
- "creatorRole": "A String", # Output only. The role of the person (buyer/seller) creating the note.
- },
- ],
- "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
- # proposal.
- "proposalState": "A String", # Output only. The current state of the proposal.
- "sellerContacts": [ # Output only. Contact information for the seller.
- { # 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.
- },
- ],
- "privateAuctionId": "A String", # Output only. Private auction ID if this proposal is a private auction
- # proposal.
+ "proposalRevision": "A String", # Output only. The revision number for the proposal.
+ # Each update to the proposal or the deal causes the proposal revision number
+ # to auto-increment. The buyer keeps track of the last revision number they
+ # know of and pass it in when making an update. If the head revision number
+ # on the server has since incremented, then an ABORTED error is returned
+ # during the update operation to let the buyer know that a subsequent update
+ # was made.
"originatorRole": "A String", # Output only. Indicates whether the buyer/seller created the proposal.
- "lastUpdaterOrCommentorRole": "A String", # Output only. The role of the last user that either updated the proposal or
- # left a comment.
- "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Private data for buyer. (hidden from seller).
- "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
- # operations (max-length: 1024 unicode code units).
- },
- "displayName": "A String", # The name for the proposal.
- "buyerContacts": [ # Contact information for the buyer.
- { # 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.
- },
- ],
- "billedBuyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Output only. Reference to the buyer that will get billed for this proposal.
- # Authorized Buyers account ID.
- "accountId": "A String", # Authorized Buyers account ID of the buyer.
- },
- "updateTime": "A String", # Output only. The time when the proposal was last revised.
- "proposalId": "A String", # Output only. The unique ID of the proposal.
"deals": [ # The deals associated with this proposal. For Private Auction proposals
# (whose deals have NonGuaranteedAuctionTerms), there will only be one deal.
{ # A deal represents a segment of inventory for displaying ads on.
# A proposal can contain multiple deals. A deal contains the terms and
# targeting information that is used for serving.
+ "dealId": "A String", # Output only. A unique deal ID for the deal (server-assigned).
+ "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
+ # deal.
+ "createTime": "A String", # Output only. The time of the deal creation.
"programmaticCreativeSource": "A String", # Output only. Specifies the creative source for programmatic deals.
# PUBLISHER means creative is provided by seller and ADVERTISER means
# creative is provided by buyer.
- "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Buyer private data (hidden from seller).
- "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
- # operations (max-length: 1024 unicode code units).
- },
- "displayName": "A String", # The name of the deal.
- "webPropertyCode": "A String", # The web property code for the seller copied over from the product.
- "updateTime": "A String", # Output only. The time when the deal was last updated.
"targetingCriterion": [ # The shared targeting visible to buyers and sellers. Each shared
# targeting entity is AND'd together.
{ # Advertisers can target different attributes of an ad slot. For example,
@@ -2773,36 +2726,6 @@
"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.
- "creativeSizeValue": { # Specifies the size of the creative. # The creative size value to include/exclude.
- # Filled in when key = GOOG_CREATIVE_SIZE
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- "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",
- ],
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- ],
- "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.
- "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
- # only if creative_size_type = CreativeSizeType.NATIVE.
- },
- "stringValue": "A String", # The string value to include/exclude.
- "longValue": "A String", # The long value to include/exclude.
"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
@@ -2811,34 +2734,135 @@
"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.
- "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`.
- "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
- "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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
- "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.
- },
- "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`.
- "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.
"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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
"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.
},
+ "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`.
+ "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "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.
+ "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.
+ },
+ "dayOfWeek": "A String", # The day of the week to target. If unspecified, applicable to all days.
},
],
},
+ "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
+ "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
+ # only if creative_size_type = CreativeSizeType.NATIVE.
+ "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.
+ },
+ "creativeSizeType": "A String", # The creative size type.
+ "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.
+ "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.
+ },
+ ],
+ },
+ "stringValue": "A String", # The string value to include/exclude.
+ },
+ ],
+ "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.
+ "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.
+ "timeZoneType": "A String", # The timezone to use for interpreting the day part targeting.
+ "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.
+ "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`.
+ "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "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.
+ "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.
+ },
+ "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`.
+ "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "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.
+ "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.
+ },
+ "dayOfWeek": "A String", # The day of the week to target. If unspecified, applicable to all days.
+ },
+ ],
+ },
+ "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
+ "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
+ # only if creative_size_type = CreativeSizeType.NATIVE.
+ "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.
+ },
+ "creativeSizeType": "A String", # The creative size type.
+ "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.
+ "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.
+ },
+ ],
+ },
+ "stringValue": "A String", # The string value to include/exclude.
},
],
"key": "A String", # The key representing the shared targeting criterion.
@@ -2846,120 +2870,56 @@
# 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.
- "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.
- "creativeSizeValue": { # Specifies the size of the creative. # The creative size value to include/exclude.
- # Filled in when key = GOOG_CREATIVE_SIZE
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- "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",
- ],
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- ],
- "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.
- "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
- # only if creative_size_type = CreativeSizeType.NATIVE.
- },
- "stringValue": "A String", # The string value to include/exclude.
- "longValue": "A String", # The long value to include/exclude.
- "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.
- "timeZoneType": "A String", # The timezone to use for interpreting the day part targeting.
- "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.
- "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`.
- "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
- "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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
- "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.
- },
- "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`.
- "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
- "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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
- "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.
- },
- },
- ],
- },
+ },
+ ],
+ "creativeRestrictions": { # Represents creative restrictions associated to Programmatic Guaranteed/ # Output only. Restricitions about the creatives associated with the deal
+ # (i.e., size) This is available for Programmatic Guaranteed/Preferred Deals
+ # in Ad Manager.
+ # Preferred Deal in Ad Manager.
+ # This doesn't apply to Private Auction and AdX Preferred Deals.
+ "skippableAdType": "A String", # Skippable video ads allow viewers to skip ads after 5 seconds.
+ "creativeFormat": "A String", # The format of the environment that the creatives will be displayed in.
+ "creativeSpecifications": [
+ { # Represents information for a creative that is associated with a Programmatic
+ # Guaranteed/Preferred Deal in Ad Manager.
+ "creativeSize": { # Represents size of a single ad slot, or a creative. # The size of the creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
},
- ],
+ "creativeCompanionSizes": [ # Companion sizes may be filled in only when this is a video creative.
+ { # Represents size of a single ad slot, or a creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
+ },
+ ],
+ },
+ ],
+ },
+ "dealServingMetadata": { # Message captures metadata about the serving status of a deal. # Output only. Metadata about the serving status of this deal.
+ "dealPauseStatus": { # Tracks which parties (if any) have paused a deal. # Output only. Tracks which parties (if any) have paused a deal.
+ # The deal is considered paused if either hasBuyerPaused or
+ # hasSellPaused is true.
+ "firstPausedBy": "A String", # The role of the person who first paused this deal.
+ "hasBuyerPaused": True or False, # True, if the buyer has paused the deal unilaterally.
+ "buyerPauseReason": "A String", # The buyer's reason for pausing, if the buyer paused the deal.
+ "sellerPauseReason": "A String", # The seller's reason for pausing, if the seller paused the deal.
+ "hasSellerPaused": True or False, # True, if the seller has paused the deal unilaterally.
},
- ],
- "dealId": "A String", # Output only. A unique deal ID for the deal (server-assigned).
- "proposalId": "A String", # Output only. ID of the proposal that this deal is part of.
- "availableEndTime": "A String", # Proposed flight end time of the deal.
- # This will generally be stored in a granularity of a second.
- # A value is not required for Private Auction deals or Preferred Deals.
- "syndicationProduct": "A String", # The syndication product associated with the deal.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "createProductId": "A String", # The product ID from which this deal was created.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "creativeSafeFrameCompatibility": "A String", # Output only. Specifies whether the creative is safeFrame compatible.
- "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
- # deal.
- "createProductRevision": "A String", # Optional revision number of the product that the deal was created from.
- # If present on create, and the server `product_revision` has advanced sinced
- # the passed-in `create_product_revision`, an `ABORTED` error will be
- # returned.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "sellerContacts": [ # Output only. Seller contact information for the deal.
- { # 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.
- },
- ],
- "availableStartTime": "A String", # Optional proposed flight start time of the deal.
- # This will generally be stored in the granularity of one second since deal
- # serving starts at seconds boundary. Any time specified with more
- # granularity (e.g., in milliseconds) will be truncated towards the start of
- # time in seconds.
- "createTime": "A String", # Output only. The time of the deal creation.
+ },
"dealTerms": { # 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.
- "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.
+ "guaranteedFixedPriceTerms": { # Terms for Programmatic Guaranteed Deals. # The terms for guaranteed fixed price deals.
+ "guaranteedLooks": "A String", # Count of guaranteed looks. Required for deal, optional for product.
+ "guaranteedImpressions": "A String", # Guaranteed impressions as a percentage. This is the percentage
+ # of guaranteed looks that the buyer is guaranteeing to buy.
+ "minimumDailyLooks": "A String", # Daily minimum looks for CPD deal types.
"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
@@ -2967,24 +2927,24 @@
# 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.
+ "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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
"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.
},
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
},
- "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",
- ],
"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).
@@ -2994,6 +2954,11 @@
},
],
},
+ "description": "A String", # Publisher provided description for the terms.
+ "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.
"nonGuaranteedAuctionTerms": { # Terms for Private Auctions. Note that Private Auctions can be created only # The terms for non-guaranteed auction deals.
@@ -3007,24 +2972,60 @@
# 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.
+ "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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
"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.
},
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
},
+ "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.
+ },
+ },
+ ],
+ },
+ "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.
"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.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+ "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.
+ "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ },
+ },
"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).
@@ -3036,152 +3037,34 @@
},
"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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
"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.
},
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
},
"brandingType": "A String", # Visibility of the URL in bid requests. (default: BRANDED)
- "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.
- "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.
- "minimumDailyLooks": "A String", # Daily minimum looks for CPD deal types.
- "guaranteedLooks": "A String", # Count of guaranteed looks. Required for deal, optional for product.
- "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.
- "price": { # Represents a price and a pricing type for a product / deal. # The specified price.
- "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- "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.
- },
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
- },
- "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",
- ],
- "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.
- },
- },
- ],
- },
},
+ "externalDealId": "A String", # Output only. 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.
+ "createProductId": "A String", # The product ID from which this deal was created.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ "updateTime": "A String", # Output only. The time when the deal was last updated.
+ "proposalId": "A String", # Output only. ID of the proposal that this deal is part of.
"targeting": { # Targeting represents different criteria that can be used by advertisers to # Output only. Specifies the subset of inventory targeted by the deal.
# target ad inventory. For example, they can choose to target ad requests only
# if the user is in the US.
# Multiple types of targeting are always applied as a logical AND, unless noted
# otherwise.
- "geoTargeting": { # Generic targeting used for targeting dimensions that contains a list of # Geo criteria IDs to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- "inventorySizeTargeting": { # Represents the size of an ad unit that can be targeted on an ad # Inventory sizes to be included/excluded.
- # request. It only applies to Private Auction, AdX Preferred Deals and
- # Auction Packages. This targeting does not apply to Programmatic Guaranteed
- # and Preferred Deals in Ad Manager.
- "targetedInventorySizes": [ # A list of inventory sizes to be included.
- { # Represents size of a single ad slot, or a creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- ],
- "excludedInventorySizes": [ # A list of inventory sizes to be excluded.
- { # Represents size of a single ad slot, or a creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- ],
- },
- "videoTargeting": { # Represents targeting information about video. # Video targeting information.
- "targetedPositionTypes": [ # A list of video positions to be included.
- # When the included list is present, the excluded list must be empty.
- # When the excluded list is present, the included list must be empty.
- "A String",
- ],
- "excludedPositionTypes": [ # A list of video positions to be excluded.
- # Position types can either be included or excluded (XOR).
- "A String",
- ],
- },
- "technologyTargeting": { # Represents targeting about various types of technology. # Technology targeting information, e.g., operating system, device category.
- "deviceCapabilityTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device capabilities to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- "operatingSystemTargeting": { # Represents targeting information for operating systems. # Operating system related targeting information.
- "operatingSystemCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating systems to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- "operatingSystemVersionCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating system versions to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- },
- "deviceCategoryTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device categories to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- },
"placementTargeting": { # Represents targeting about where the ads can appear, e.g., certain sites or # Placement targeting information, e.g., URL, mobile applications.
# mobile applications.
# Different placement targeting types will be logically OR'ed.
@@ -3190,10 +3073,10 @@
# excluded.
# For Programmatic Guaranteed and Preferred Deals, this doesn't
# apply.
- "targetedUrls": [ # A list of URLs to be included.
+ "excludedUrls": [ # A list of URLs to be excluded.
"A String",
],
- "excludedUrls": [ # A list of URLs to be excluded.
+ "targetedUrls": [ # A list of URLs to be included.
"A String",
],
},
@@ -3207,84 +3090,155 @@
# Google Play Store URL.
# iOS App ID (which is a number) can be found at the end of iTunes store URL.
# First party mobile applications is either included or excluded.
- "targetedAppIds": [ # A list of application IDs to be included.
+ "excludedAppIds": [ # A list of application IDs to be excluded.
"A String",
],
- "excludedAppIds": [ # A list of application IDs to be excluded.
+ "targetedAppIds": [ # A list of application IDs to be included.
"A String",
],
},
},
},
+ "inventorySizeTargeting": { # Represents the size of an ad unit that can be targeted on an ad # Inventory sizes to be included/excluded.
+ # request. It only applies to Private Auction, AdX Preferred Deals and
+ # Auction Packages. This targeting does not apply to Programmatic Guaranteed
+ # and Preferred Deals in Ad Manager.
+ "targetedInventorySizes": [ # A list of inventory sizes to be included.
+ { # Represents size of a single ad slot, or a creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
+ },
+ ],
+ "excludedInventorySizes": [ # A list of inventory sizes to be excluded.
+ { # Represents size of a single ad slot, or a creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
+ },
+ ],
+ },
+ "geoTargeting": { # Generic targeting used for targeting dimensions that contains a list of # Geo criteria IDs to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ "technologyTargeting": { # Represents targeting about various types of technology. # Technology targeting information, e.g., operating system, device category.
+ "operatingSystemTargeting": { # Represents targeting information for operating systems. # Operating system related targeting information.
+ "operatingSystemVersionCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating system versions to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ "operatingSystemCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating systems to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ },
+ "deviceCapabilityTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device capabilities to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ "deviceCategoryTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device categories to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ },
+ "videoTargeting": { # Represents targeting information about video. # Video targeting information.
+ "targetedPositionTypes": [ # A list of video positions to be included.
+ # When the included list is present, the excluded list must be empty.
+ # When the excluded list is present, the included list must be empty.
+ "A String",
+ ],
+ "excludedPositionTypes": [ # A list of video positions to be excluded.
+ # Position types can either be included or excluded (XOR).
+ "A String",
+ ],
+ },
},
- "creativePreApprovalPolicy": "A String", # Output only. Specifies the creative pre-approval policy.
+ "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Buyer private data (hidden from seller).
+ "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
+ # operations (max-length: 1024 unicode code units).
+ },
"deliveryControl": { # Message contains details about how the deals will be paced. # 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.
- "deliveryRateType": "A String", # Output only. Specifies how the impression delivery will be paced.
"frequencyCaps": [ # Output only. Specifies any frequency caps.
{ # Frequency cap.
- "numTimeUnits": 42, # The amount of time, in the units specified by time_unit_type. Defines the
- # amount of time over which impressions per user are counted and capped.
"maxImpressions": 42, # The maximum number of impressions that can be served to a user within the
# specified time period.
"timeUnitType": "A String", # The time unit. Along with num_time_units defines the amount of time over
# which impressions per user are counted and capped.
+ "numTimeUnits": 42, # The amount of time, in the units specified by time_unit_type. Defines the
+ # amount of time over which impressions per user are counted and capped.
},
],
"creativeBlockingLevel": "A String", # Output only. Specified the creative blocking levels to be applied.
+ "deliveryRateType": "A String", # Output only. Specifies how the impression delivery will be paced.
},
- "externalDealId": "A String", # Output only. 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.
- "creativeRestrictions": { # Represents creative restrictions associated to Programmatic Guaranteed/ # Output only. Restricitions about the creatives associated with the deal
- # (i.e., size) This is available for Programmatic Guaranteed/Preferred Deals
- # in Ad Manager.
- # Preferred Deal in Ad Manager.
- # This doesn't apply to Private Auction and AdX Preferred Deals.
- "creativeFormat": "A String", # The format of the environment that the creatives will be displayed in.
- "creativeSpecifications": [
- { # Represents information for a creative that is associated with a Programmatic
- # Guaranteed/Preferred Deal in Ad Manager.
- "creativeSize": { # Represents size of a single ad slot, or a creative. # The size of the creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- "creativeCompanionSizes": [ # Companion sizes may be filled in only when this is a video creative.
- { # Represents size of a single ad slot, or a creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- ],
- },
- ],
- "skippableAdType": "A String", # Skippable video ads allow viewers to skip ads after 5 seconds.
- },
- "dealServingMetadata": { # Message captures metadata about the serving status of a deal. # Output only. Metadata about the serving status of this deal.
- "dealPauseStatus": { # Tracks which parties (if any) have paused a deal. # Output only. Tracks which parties (if any) have paused a deal.
- # The deal is considered paused if either hasBuyerPaused or
- # hasSellPaused is true.
- "firstPausedBy": "A String", # The role of the person who first paused this deal.
- "sellerPauseReason": "A String", # The seller's reason for pausing, if the seller paused the deal.
- "hasSellerPaused": True or False, # True, if the seller has paused the deal unilaterally.
- "buyerPauseReason": "A String", # The buyer's reason for pausing, if the buyer paused the deal.
- "hasBuyerPaused": True or False, # True, if the buyer has paused the deal unilaterally.
+ "availableEndTime": "A String", # Proposed flight end time of the deal.
+ # This will generally be stored in a granularity of a second.
+ # A value is not required for Private Auction deals or Preferred Deals.
+ "availableStartTime": "A String", # Optional proposed flight start time of the deal.
+ # This will generally be stored in the granularity of one second since deal
+ # serving starts at seconds boundary. Any time specified with more
+ # granularity (e.g., in milliseconds) will be truncated towards the start of
+ # time in seconds.
+ "displayName": "A String", # The name of the deal.
+ "creativeSafeFrameCompatibility": "A String", # Output only. Specifies whether the creative is safeFrame compatible.
+ "createProductRevision": "A String", # Optional revision number of the product that the deal was created from.
+ # If present on create, and the server `product_revision` has advanced sinced
+ # the passed-in `create_product_revision`, an `ABORTED` error will be
+ # returned.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ "creativePreApprovalPolicy": "A String", # Output only. Specifies the creative pre-approval policy.
+ "webPropertyCode": "A String", # The web property code for the seller copied over from the product.
+ "sellerContacts": [ # Output only. Seller contact information for the deal.
+ { # Contains information on how a buyer or seller can be reached.
+ "name": "A String", # The name of the contact.
+ "email": "A String", # Email address for the contact.
},
- },
+ ],
"description": "A String", # Description for the deal terms.
+ "syndicationProduct": "A String", # The syndication product associated with the deal.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
},
],
- "proposalRevision": "A String", # Output only. The revision number for the proposal.
- # Each update to the proposal or the deal causes the proposal revision number
- # to auto-increment. The buyer keeps track of the last revision number they
- # know of and pass it in when making an update. If the head revision number
- # on the server has since incremented, then an ABORTED error is returned
- # during the update operation to let the buyer know that a subsequent update
- # was made.
+ "billedBuyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Output only. Reference to the buyer that will get billed for this proposal.
+ # Authorized Buyers account ID.
+ "accountId": "A String", # Authorized Buyers account ID of the buyer.
+ },
+ "displayName": "A String", # The name for the proposal.
"seller": { # Represents a seller of inventory. Each seller is identified by a unique # Reference to the seller on the proposal.
#
# Note: This field may be set only when creating the resource. Modifying
@@ -3294,6 +3248,52 @@
"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.
},
+ "updateTime": "A String", # Output only. The time when the proposal was last revised.
+ "proposalId": "A String", # Output only. The unique ID of the proposal.
+ "isRenegotiating": True or False, # Output only. True if the proposal is being renegotiated.
+ "proposalState": "A String", # Output only. The current state of the proposal.
+ "notes": [ # Output only. The notes associated with this proposal.
+ { # A proposal may be associated to several notes.
+ "noteId": "A String", # Output only. The unique ID for the note.
+ "creatorRole": "A String", # Output only. The role of the person (buyer/seller) creating the note.
+ "proposalRevision": "A String", # Output only. The revision number of the proposal when the note is created.
+ "createTime": "A String", # Output only. The timestamp for when this note was created.
+ "note": "A String", # The actual note to attach.
+ # (max-length: 1024 unicode code units)
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ },
+ ],
+ "sellerContacts": [ # Output only. Contact information for the seller.
+ { # Contains information on how a buyer or seller can be reached.
+ "name": "A String", # The name of the contact.
+ "email": "A String", # Email address for the contact.
+ },
+ ],
+ "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Private data for buyer. (hidden from seller).
+ "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
+ # operations (max-length: 1024 unicode code units).
+ },
+ "buyerContacts": [ # Contact information for the buyer.
+ { # Contains information on how a buyer or seller can be reached.
+ "name": "A String", # The name of the contact.
+ "email": "A String", # Email address for the contact.
+ },
+ ],
+ "privateAuctionId": "A String", # Output only. Private auction ID if this proposal is a private auction
+ # proposal.
+ "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
+ # proposal.
+ "buyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Reference to the buyer on the proposal.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ # Authorized Buyers account ID.
+ "accountId": "A String", # Authorized Buyers account ID of the buyer.
+ },
+ "lastUpdaterOrCommentorRole": "A String", # Output only. The role of the last user that either updated the proposal or
+ # left a comment.
}</pre>
</div>
@@ -3324,73 +3324,26 @@
# Auction or Preferred Deals deals through the API.
#
# Fields are updatable unless noted otherwise.
- "buyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Reference to the buyer on the proposal.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- # Authorized Buyers account ID.
- "accountId": "A String", # Authorized Buyers account ID of the buyer.
- },
- "isRenegotiating": True or False, # Output only. True if the proposal is being renegotiated.
- "notes": [ # Output only. The notes associated with this proposal.
- { # A proposal may be associated to several notes.
- "note": "A String", # The actual note to attach.
- # (max-length: 1024 unicode code units)
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "proposalRevision": "A String", # Output only. The revision number of the proposal when the note is created.
- "noteId": "A String", # Output only. The unique ID for the note.
- "createTime": "A String", # Output only. The timestamp for when this note was created.
- "creatorRole": "A String", # Output only. The role of the person (buyer/seller) creating the note.
- },
- ],
- "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
- # proposal.
- "proposalState": "A String", # Output only. The current state of the proposal.
- "sellerContacts": [ # Output only. Contact information for the seller.
- { # 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.
- },
- ],
- "privateAuctionId": "A String", # Output only. Private auction ID if this proposal is a private auction
- # proposal.
+ "proposalRevision": "A String", # Output only. The revision number for the proposal.
+ # Each update to the proposal or the deal causes the proposal revision number
+ # to auto-increment. The buyer keeps track of the last revision number they
+ # know of and pass it in when making an update. If the head revision number
+ # on the server has since incremented, then an ABORTED error is returned
+ # during the update operation to let the buyer know that a subsequent update
+ # was made.
"originatorRole": "A String", # Output only. Indicates whether the buyer/seller created the proposal.
- "lastUpdaterOrCommentorRole": "A String", # Output only. The role of the last user that either updated the proposal or
- # left a comment.
- "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Private data for buyer. (hidden from seller).
- "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
- # operations (max-length: 1024 unicode code units).
- },
- "displayName": "A String", # The name for the proposal.
- "buyerContacts": [ # Contact information for the buyer.
- { # 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.
- },
- ],
- "billedBuyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Output only. Reference to the buyer that will get billed for this proposal.
- # Authorized Buyers account ID.
- "accountId": "A String", # Authorized Buyers account ID of the buyer.
- },
- "updateTime": "A String", # Output only. The time when the proposal was last revised.
- "proposalId": "A String", # Output only. The unique ID of the proposal.
"deals": [ # The deals associated with this proposal. For Private Auction proposals
# (whose deals have NonGuaranteedAuctionTerms), there will only be one deal.
{ # A deal represents a segment of inventory for displaying ads on.
# A proposal can contain multiple deals. A deal contains the terms and
# targeting information that is used for serving.
+ "dealId": "A String", # Output only. A unique deal ID for the deal (server-assigned).
+ "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
+ # deal.
+ "createTime": "A String", # Output only. The time of the deal creation.
"programmaticCreativeSource": "A String", # Output only. Specifies the creative source for programmatic deals.
# PUBLISHER means creative is provided by seller and ADVERTISER means
# creative is provided by buyer.
- "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Buyer private data (hidden from seller).
- "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
- # operations (max-length: 1024 unicode code units).
- },
- "displayName": "A String", # The name of the deal.
- "webPropertyCode": "A String", # The web property code for the seller copied over from the product.
- "updateTime": "A String", # Output only. The time when the deal was last updated.
"targetingCriterion": [ # The shared targeting visible to buyers and sellers. Each shared
# targeting entity is AND'd together.
{ # Advertisers can target different attributes of an ad slot. For example,
@@ -3399,36 +3352,6 @@
"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.
- "creativeSizeValue": { # Specifies the size of the creative. # The creative size value to include/exclude.
- # Filled in when key = GOOG_CREATIVE_SIZE
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- "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",
- ],
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- ],
- "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.
- "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
- # only if creative_size_type = CreativeSizeType.NATIVE.
- },
- "stringValue": "A String", # The string value to include/exclude.
- "longValue": "A String", # The long value to include/exclude.
"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
@@ -3437,34 +3360,135 @@
"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.
- "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`.
- "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
- "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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
- "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.
- },
- "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`.
- "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.
"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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
"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.
},
+ "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`.
+ "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "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.
+ "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.
+ },
+ "dayOfWeek": "A String", # The day of the week to target. If unspecified, applicable to all days.
},
],
},
+ "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
+ "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
+ # only if creative_size_type = CreativeSizeType.NATIVE.
+ "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.
+ },
+ "creativeSizeType": "A String", # The creative size type.
+ "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.
+ "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.
+ },
+ ],
+ },
+ "stringValue": "A String", # The string value to include/exclude.
+ },
+ ],
+ "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.
+ "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.
+ "timeZoneType": "A String", # The timezone to use for interpreting the day part targeting.
+ "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.
+ "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`.
+ "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "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.
+ "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.
+ },
+ "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`.
+ "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "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.
+ "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.
+ },
+ "dayOfWeek": "A String", # The day of the week to target. If unspecified, applicable to all days.
+ },
+ ],
+ },
+ "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
+ "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
+ # only if creative_size_type = CreativeSizeType.NATIVE.
+ "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.
+ },
+ "creativeSizeType": "A String", # The creative size type.
+ "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.
+ "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.
+ },
+ ],
+ },
+ "stringValue": "A String", # The string value to include/exclude.
},
],
"key": "A String", # The key representing the shared targeting criterion.
@@ -3472,120 +3496,56 @@
# 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.
- "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.
- "creativeSizeValue": { # Specifies the size of the creative. # The creative size value to include/exclude.
- # Filled in when key = GOOG_CREATIVE_SIZE
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- "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",
- ],
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- ],
- "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.
- "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
- # only if creative_size_type = CreativeSizeType.NATIVE.
- },
- "stringValue": "A String", # The string value to include/exclude.
- "longValue": "A String", # The long value to include/exclude.
- "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.
- "timeZoneType": "A String", # The timezone to use for interpreting the day part targeting.
- "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.
- "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`.
- "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
- "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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
- "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.
- },
- "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`.
- "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
- "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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
- "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.
- },
- },
- ],
- },
+ },
+ ],
+ "creativeRestrictions": { # Represents creative restrictions associated to Programmatic Guaranteed/ # Output only. Restricitions about the creatives associated with the deal
+ # (i.e., size) This is available for Programmatic Guaranteed/Preferred Deals
+ # in Ad Manager.
+ # Preferred Deal in Ad Manager.
+ # This doesn't apply to Private Auction and AdX Preferred Deals.
+ "skippableAdType": "A String", # Skippable video ads allow viewers to skip ads after 5 seconds.
+ "creativeFormat": "A String", # The format of the environment that the creatives will be displayed in.
+ "creativeSpecifications": [
+ { # Represents information for a creative that is associated with a Programmatic
+ # Guaranteed/Preferred Deal in Ad Manager.
+ "creativeSize": { # Represents size of a single ad slot, or a creative. # The size of the creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
},
- ],
+ "creativeCompanionSizes": [ # Companion sizes may be filled in only when this is a video creative.
+ { # Represents size of a single ad slot, or a creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
+ },
+ ],
+ },
+ ],
+ },
+ "dealServingMetadata": { # Message captures metadata about the serving status of a deal. # Output only. Metadata about the serving status of this deal.
+ "dealPauseStatus": { # Tracks which parties (if any) have paused a deal. # Output only. Tracks which parties (if any) have paused a deal.
+ # The deal is considered paused if either hasBuyerPaused or
+ # hasSellPaused is true.
+ "firstPausedBy": "A String", # The role of the person who first paused this deal.
+ "hasBuyerPaused": True or False, # True, if the buyer has paused the deal unilaterally.
+ "buyerPauseReason": "A String", # The buyer's reason for pausing, if the buyer paused the deal.
+ "sellerPauseReason": "A String", # The seller's reason for pausing, if the seller paused the deal.
+ "hasSellerPaused": True or False, # True, if the seller has paused the deal unilaterally.
},
- ],
- "dealId": "A String", # Output only. A unique deal ID for the deal (server-assigned).
- "proposalId": "A String", # Output only. ID of the proposal that this deal is part of.
- "availableEndTime": "A String", # Proposed flight end time of the deal.
- # This will generally be stored in a granularity of a second.
- # A value is not required for Private Auction deals or Preferred Deals.
- "syndicationProduct": "A String", # The syndication product associated with the deal.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "createProductId": "A String", # The product ID from which this deal was created.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "creativeSafeFrameCompatibility": "A String", # Output only. Specifies whether the creative is safeFrame compatible.
- "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
- # deal.
- "createProductRevision": "A String", # Optional revision number of the product that the deal was created from.
- # If present on create, and the server `product_revision` has advanced sinced
- # the passed-in `create_product_revision`, an `ABORTED` error will be
- # returned.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "sellerContacts": [ # Output only. Seller contact information for the deal.
- { # 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.
- },
- ],
- "availableStartTime": "A String", # Optional proposed flight start time of the deal.
- # This will generally be stored in the granularity of one second since deal
- # serving starts at seconds boundary. Any time specified with more
- # granularity (e.g., in milliseconds) will be truncated towards the start of
- # time in seconds.
- "createTime": "A String", # Output only. The time of the deal creation.
+ },
"dealTerms": { # 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.
- "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.
+ "guaranteedFixedPriceTerms": { # Terms for Programmatic Guaranteed Deals. # The terms for guaranteed fixed price deals.
+ "guaranteedLooks": "A String", # Count of guaranteed looks. Required for deal, optional for product.
+ "guaranteedImpressions": "A String", # Guaranteed impressions as a percentage. This is the percentage
+ # of guaranteed looks that the buyer is guaranteeing to buy.
+ "minimumDailyLooks": "A String", # Daily minimum looks for CPD deal types.
"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
@@ -3593,24 +3553,24 @@
# 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.
+ "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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
"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.
},
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
},
- "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",
- ],
"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).
@@ -3620,6 +3580,11 @@
},
],
},
+ "description": "A String", # Publisher provided description for the terms.
+ "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.
"nonGuaranteedAuctionTerms": { # Terms for Private Auctions. Note that Private Auctions can be created only # The terms for non-guaranteed auction deals.
@@ -3633,24 +3598,60 @@
# 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.
+ "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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
"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.
},
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
},
+ "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.
+ },
+ },
+ ],
+ },
+ "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.
"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.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+ "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.
+ "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ },
+ },
"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).
@@ -3662,152 +3663,34 @@
},
"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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
"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.
},
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
},
"brandingType": "A String", # Visibility of the URL in bid requests. (default: BRANDED)
- "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.
- "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.
- "minimumDailyLooks": "A String", # Daily minimum looks for CPD deal types.
- "guaranteedLooks": "A String", # Count of guaranteed looks. Required for deal, optional for product.
- "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.
- "price": { # Represents a price and a pricing type for a product / deal. # The specified price.
- "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- "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.
- },
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
- },
- "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",
- ],
- "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.
- },
- },
- ],
- },
},
+ "externalDealId": "A String", # Output only. 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.
+ "createProductId": "A String", # The product ID from which this deal was created.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ "updateTime": "A String", # Output only. The time when the deal was last updated.
+ "proposalId": "A String", # Output only. ID of the proposal that this deal is part of.
"targeting": { # Targeting represents different criteria that can be used by advertisers to # Output only. Specifies the subset of inventory targeted by the deal.
# target ad inventory. For example, they can choose to target ad requests only
# if the user is in the US.
# Multiple types of targeting are always applied as a logical AND, unless noted
# otherwise.
- "geoTargeting": { # Generic targeting used for targeting dimensions that contains a list of # Geo criteria IDs to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- "inventorySizeTargeting": { # Represents the size of an ad unit that can be targeted on an ad # Inventory sizes to be included/excluded.
- # request. It only applies to Private Auction, AdX Preferred Deals and
- # Auction Packages. This targeting does not apply to Programmatic Guaranteed
- # and Preferred Deals in Ad Manager.
- "targetedInventorySizes": [ # A list of inventory sizes to be included.
- { # Represents size of a single ad slot, or a creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- ],
- "excludedInventorySizes": [ # A list of inventory sizes to be excluded.
- { # Represents size of a single ad slot, or a creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- ],
- },
- "videoTargeting": { # Represents targeting information about video. # Video targeting information.
- "targetedPositionTypes": [ # A list of video positions to be included.
- # When the included list is present, the excluded list must be empty.
- # When the excluded list is present, the included list must be empty.
- "A String",
- ],
- "excludedPositionTypes": [ # A list of video positions to be excluded.
- # Position types can either be included or excluded (XOR).
- "A String",
- ],
- },
- "technologyTargeting": { # Represents targeting about various types of technology. # Technology targeting information, e.g., operating system, device category.
- "deviceCapabilityTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device capabilities to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- "operatingSystemTargeting": { # Represents targeting information for operating systems. # Operating system related targeting information.
- "operatingSystemCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating systems to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- "operatingSystemVersionCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating system versions to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- },
- "deviceCategoryTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device categories to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- },
"placementTargeting": { # Represents targeting about where the ads can appear, e.g., certain sites or # Placement targeting information, e.g., URL, mobile applications.
# mobile applications.
# Different placement targeting types will be logically OR'ed.
@@ -3816,10 +3699,10 @@
# excluded.
# For Programmatic Guaranteed and Preferred Deals, this doesn't
# apply.
- "targetedUrls": [ # A list of URLs to be included.
+ "excludedUrls": [ # A list of URLs to be excluded.
"A String",
],
- "excludedUrls": [ # A list of URLs to be excluded.
+ "targetedUrls": [ # A list of URLs to be included.
"A String",
],
},
@@ -3833,84 +3716,155 @@
# Google Play Store URL.
# iOS App ID (which is a number) can be found at the end of iTunes store URL.
# First party mobile applications is either included or excluded.
- "targetedAppIds": [ # A list of application IDs to be included.
+ "excludedAppIds": [ # A list of application IDs to be excluded.
"A String",
],
- "excludedAppIds": [ # A list of application IDs to be excluded.
+ "targetedAppIds": [ # A list of application IDs to be included.
"A String",
],
},
},
},
+ "inventorySizeTargeting": { # Represents the size of an ad unit that can be targeted on an ad # Inventory sizes to be included/excluded.
+ # request. It only applies to Private Auction, AdX Preferred Deals and
+ # Auction Packages. This targeting does not apply to Programmatic Guaranteed
+ # and Preferred Deals in Ad Manager.
+ "targetedInventorySizes": [ # A list of inventory sizes to be included.
+ { # Represents size of a single ad slot, or a creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
+ },
+ ],
+ "excludedInventorySizes": [ # A list of inventory sizes to be excluded.
+ { # Represents size of a single ad slot, or a creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
+ },
+ ],
+ },
+ "geoTargeting": { # Generic targeting used for targeting dimensions that contains a list of # Geo criteria IDs to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ "technologyTargeting": { # Represents targeting about various types of technology. # Technology targeting information, e.g., operating system, device category.
+ "operatingSystemTargeting": { # Represents targeting information for operating systems. # Operating system related targeting information.
+ "operatingSystemVersionCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating system versions to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ "operatingSystemCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating systems to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ },
+ "deviceCapabilityTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device capabilities to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ "deviceCategoryTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device categories to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ },
+ "videoTargeting": { # Represents targeting information about video. # Video targeting information.
+ "targetedPositionTypes": [ # A list of video positions to be included.
+ # When the included list is present, the excluded list must be empty.
+ # When the excluded list is present, the included list must be empty.
+ "A String",
+ ],
+ "excludedPositionTypes": [ # A list of video positions to be excluded.
+ # Position types can either be included or excluded (XOR).
+ "A String",
+ ],
+ },
},
- "creativePreApprovalPolicy": "A String", # Output only. Specifies the creative pre-approval policy.
+ "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Buyer private data (hidden from seller).
+ "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
+ # operations (max-length: 1024 unicode code units).
+ },
"deliveryControl": { # Message contains details about how the deals will be paced. # 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.
- "deliveryRateType": "A String", # Output only. Specifies how the impression delivery will be paced.
"frequencyCaps": [ # Output only. Specifies any frequency caps.
{ # Frequency cap.
- "numTimeUnits": 42, # The amount of time, in the units specified by time_unit_type. Defines the
- # amount of time over which impressions per user are counted and capped.
"maxImpressions": 42, # The maximum number of impressions that can be served to a user within the
# specified time period.
"timeUnitType": "A String", # The time unit. Along with num_time_units defines the amount of time over
# which impressions per user are counted and capped.
+ "numTimeUnits": 42, # The amount of time, in the units specified by time_unit_type. Defines the
+ # amount of time over which impressions per user are counted and capped.
},
],
"creativeBlockingLevel": "A String", # Output only. Specified the creative blocking levels to be applied.
+ "deliveryRateType": "A String", # Output only. Specifies how the impression delivery will be paced.
},
- "externalDealId": "A String", # Output only. 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.
- "creativeRestrictions": { # Represents creative restrictions associated to Programmatic Guaranteed/ # Output only. Restricitions about the creatives associated with the deal
- # (i.e., size) This is available for Programmatic Guaranteed/Preferred Deals
- # in Ad Manager.
- # Preferred Deal in Ad Manager.
- # This doesn't apply to Private Auction and AdX Preferred Deals.
- "creativeFormat": "A String", # The format of the environment that the creatives will be displayed in.
- "creativeSpecifications": [
- { # Represents information for a creative that is associated with a Programmatic
- # Guaranteed/Preferred Deal in Ad Manager.
- "creativeSize": { # Represents size of a single ad slot, or a creative. # The size of the creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- "creativeCompanionSizes": [ # Companion sizes may be filled in only when this is a video creative.
- { # Represents size of a single ad slot, or a creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- ],
- },
- ],
- "skippableAdType": "A String", # Skippable video ads allow viewers to skip ads after 5 seconds.
- },
- "dealServingMetadata": { # Message captures metadata about the serving status of a deal. # Output only. Metadata about the serving status of this deal.
- "dealPauseStatus": { # Tracks which parties (if any) have paused a deal. # Output only. Tracks which parties (if any) have paused a deal.
- # The deal is considered paused if either hasBuyerPaused or
- # hasSellPaused is true.
- "firstPausedBy": "A String", # The role of the person who first paused this deal.
- "sellerPauseReason": "A String", # The seller's reason for pausing, if the seller paused the deal.
- "hasSellerPaused": True or False, # True, if the seller has paused the deal unilaterally.
- "buyerPauseReason": "A String", # The buyer's reason for pausing, if the buyer paused the deal.
- "hasBuyerPaused": True or False, # True, if the buyer has paused the deal unilaterally.
+ "availableEndTime": "A String", # Proposed flight end time of the deal.
+ # This will generally be stored in a granularity of a second.
+ # A value is not required for Private Auction deals or Preferred Deals.
+ "availableStartTime": "A String", # Optional proposed flight start time of the deal.
+ # This will generally be stored in the granularity of one second since deal
+ # serving starts at seconds boundary. Any time specified with more
+ # granularity (e.g., in milliseconds) will be truncated towards the start of
+ # time in seconds.
+ "displayName": "A String", # The name of the deal.
+ "creativeSafeFrameCompatibility": "A String", # Output only. Specifies whether the creative is safeFrame compatible.
+ "createProductRevision": "A String", # Optional revision number of the product that the deal was created from.
+ # If present on create, and the server `product_revision` has advanced sinced
+ # the passed-in `create_product_revision`, an `ABORTED` error will be
+ # returned.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ "creativePreApprovalPolicy": "A String", # Output only. Specifies the creative pre-approval policy.
+ "webPropertyCode": "A String", # The web property code for the seller copied over from the product.
+ "sellerContacts": [ # Output only. Seller contact information for the deal.
+ { # Contains information on how a buyer or seller can be reached.
+ "name": "A String", # The name of the contact.
+ "email": "A String", # Email address for the contact.
},
- },
+ ],
"description": "A String", # Description for the deal terms.
+ "syndicationProduct": "A String", # The syndication product associated with the deal.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
},
],
- "proposalRevision": "A String", # Output only. The revision number for the proposal.
- # Each update to the proposal or the deal causes the proposal revision number
- # to auto-increment. The buyer keeps track of the last revision number they
- # know of and pass it in when making an update. If the head revision number
- # on the server has since incremented, then an ABORTED error is returned
- # during the update operation to let the buyer know that a subsequent update
- # was made.
+ "billedBuyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Output only. Reference to the buyer that will get billed for this proposal.
+ # Authorized Buyers account ID.
+ "accountId": "A String", # Authorized Buyers account ID of the buyer.
+ },
+ "displayName": "A String", # The name for the proposal.
"seller": { # Represents a seller of inventory. Each seller is identified by a unique # Reference to the seller on the proposal.
#
# Note: This field may be set only when creating the resource. Modifying
@@ -3920,11 +3874,57 @@
"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.
},
+ "updateTime": "A String", # Output only. The time when the proposal was last revised.
+ "proposalId": "A String", # Output only. The unique ID of the proposal.
+ "isRenegotiating": True or False, # Output only. True if the proposal is being renegotiated.
+ "proposalState": "A String", # Output only. The current state of the proposal.
+ "notes": [ # Output only. The notes associated with this proposal.
+ { # A proposal may be associated to several notes.
+ "noteId": "A String", # Output only. The unique ID for the note.
+ "creatorRole": "A String", # Output only. The role of the person (buyer/seller) creating the note.
+ "proposalRevision": "A String", # Output only. The revision number of the proposal when the note is created.
+ "createTime": "A String", # Output only. The timestamp for when this note was created.
+ "note": "A String", # The actual note to attach.
+ # (max-length: 1024 unicode code units)
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ },
+ ],
+ "sellerContacts": [ # Output only. Contact information for the seller.
+ { # Contains information on how a buyer or seller can be reached.
+ "name": "A String", # The name of the contact.
+ "email": "A String", # Email address for the contact.
+ },
+ ],
+ "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Private data for buyer. (hidden from seller).
+ "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
+ # operations (max-length: 1024 unicode code units).
+ },
+ "buyerContacts": [ # Contact information for the buyer.
+ { # Contains information on how a buyer or seller can be reached.
+ "name": "A String", # The name of the contact.
+ "email": "A String", # Email address for the contact.
+ },
+ ],
+ "privateAuctionId": "A String", # Output only. Private auction ID if this proposal is a private auction
+ # proposal.
+ "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
+ # proposal.
+ "buyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Reference to the buyer on the proposal.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ # Authorized Buyers account ID.
+ "accountId": "A String", # Authorized Buyers account ID of the buyer.
+ },
+ "lastUpdaterOrCommentorRole": "A String", # Output only. The role of the last user that either updated the proposal or
+ # left a comment.
}</pre>
</div>
<div class="method">
- <code class="details" id="list">list(accountId, filter=None, pageToken=None, pageSize=None, filterSyntax=None, x__xgafv=None)</code>
+ <code class="details" id="list">list(accountId, pageToken=None, filterSyntax=None, filter=None, pageSize=None, x__xgafv=None)</code>
<pre>List proposals. A filter expression (PQL query) may be specified to
filter the results. To retrieve all finalized proposals, regardless if a
proposal is being renegotiated, see the FinalizedProposals resource.
@@ -3934,15 +3934,15 @@
Args:
accountId: string, Account ID of the buyer. (required)
+ pageToken: string, The page token as returned from ListProposalsResponse.
+ filterSyntax: string, Syntax the filter is written in. Current implementation defaults to PQL
+but in the future it will be LIST_FILTER.
filter: string, An optional PQL filter query used to query for proposals.
Nested repeated fields, such as proposal.deals.targetingCriterion,
cannot be filtered.
- pageToken: string, The page token as returned from ListProposalsResponse.
pageSize: integer, Requested page size. The server may return fewer results than requested.
If unspecified, the server will pick an appropriate default.
- filterSyntax: string, Syntax the filter is written in. Current implementation defaults to PQL
-but in the future it will be LIST_FILTER.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -3952,7 +3952,6 @@
An object of the form:
{ # Response message for listing proposals.
- "nextPageToken": "A String", # Continuation token for fetching the next page of results.
"proposals": [ # The list of proposals.
{ # Note: this resource requires whitelisting for access. Please contact your
# account manager for access to Marketplace resources.
@@ -3965,73 +3964,26 @@
# Auction or Preferred Deals deals through the API.
#
# Fields are updatable unless noted otherwise.
- "buyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Reference to the buyer on the proposal.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- # Authorized Buyers account ID.
- "accountId": "A String", # Authorized Buyers account ID of the buyer.
- },
- "isRenegotiating": True or False, # Output only. True if the proposal is being renegotiated.
- "notes": [ # Output only. The notes associated with this proposal.
- { # A proposal may be associated to several notes.
- "note": "A String", # The actual note to attach.
- # (max-length: 1024 unicode code units)
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "proposalRevision": "A String", # Output only. The revision number of the proposal when the note is created.
- "noteId": "A String", # Output only. The unique ID for the note.
- "createTime": "A String", # Output only. The timestamp for when this note was created.
- "creatorRole": "A String", # Output only. The role of the person (buyer/seller) creating the note.
- },
- ],
- "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
- # proposal.
- "proposalState": "A String", # Output only. The current state of the proposal.
- "sellerContacts": [ # Output only. Contact information for the seller.
- { # 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.
- },
- ],
- "privateAuctionId": "A String", # Output only. Private auction ID if this proposal is a private auction
- # proposal.
+ "proposalRevision": "A String", # Output only. The revision number for the proposal.
+ # Each update to the proposal or the deal causes the proposal revision number
+ # to auto-increment. The buyer keeps track of the last revision number they
+ # know of and pass it in when making an update. If the head revision number
+ # on the server has since incremented, then an ABORTED error is returned
+ # during the update operation to let the buyer know that a subsequent update
+ # was made.
"originatorRole": "A String", # Output only. Indicates whether the buyer/seller created the proposal.
- "lastUpdaterOrCommentorRole": "A String", # Output only. The role of the last user that either updated the proposal or
- # left a comment.
- "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Private data for buyer. (hidden from seller).
- "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
- # operations (max-length: 1024 unicode code units).
- },
- "displayName": "A String", # The name for the proposal.
- "buyerContacts": [ # Contact information for the buyer.
- { # 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.
- },
- ],
- "billedBuyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Output only. Reference to the buyer that will get billed for this proposal.
- # Authorized Buyers account ID.
- "accountId": "A String", # Authorized Buyers account ID of the buyer.
- },
- "updateTime": "A String", # Output only. The time when the proposal was last revised.
- "proposalId": "A String", # Output only. The unique ID of the proposal.
"deals": [ # The deals associated with this proposal. For Private Auction proposals
# (whose deals have NonGuaranteedAuctionTerms), there will only be one deal.
{ # A deal represents a segment of inventory for displaying ads on.
# A proposal can contain multiple deals. A deal contains the terms and
# targeting information that is used for serving.
+ "dealId": "A String", # Output only. A unique deal ID for the deal (server-assigned).
+ "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
+ # deal.
+ "createTime": "A String", # Output only. The time of the deal creation.
"programmaticCreativeSource": "A String", # Output only. Specifies the creative source for programmatic deals.
# PUBLISHER means creative is provided by seller and ADVERTISER means
# creative is provided by buyer.
- "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Buyer private data (hidden from seller).
- "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
- # operations (max-length: 1024 unicode code units).
- },
- "displayName": "A String", # The name of the deal.
- "webPropertyCode": "A String", # The web property code for the seller copied over from the product.
- "updateTime": "A String", # Output only. The time when the deal was last updated.
"targetingCriterion": [ # The shared targeting visible to buyers and sellers. Each shared
# targeting entity is AND'd together.
{ # Advertisers can target different attributes of an ad slot. For example,
@@ -4040,36 +3992,6 @@
"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.
- "creativeSizeValue": { # Specifies the size of the creative. # The creative size value to include/exclude.
- # Filled in when key = GOOG_CREATIVE_SIZE
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- "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",
- ],
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- ],
- "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.
- "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
- # only if creative_size_type = CreativeSizeType.NATIVE.
- },
- "stringValue": "A String", # The string value to include/exclude.
- "longValue": "A String", # The long value to include/exclude.
"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
@@ -4078,34 +4000,135 @@
"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.
- "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`.
- "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
- "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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
- "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.
- },
- "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`.
- "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.
"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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
"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.
},
+ "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`.
+ "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "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.
+ "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.
+ },
+ "dayOfWeek": "A String", # The day of the week to target. If unspecified, applicable to all days.
},
],
},
+ "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
+ "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
+ # only if creative_size_type = CreativeSizeType.NATIVE.
+ "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.
+ },
+ "creativeSizeType": "A String", # The creative size type.
+ "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.
+ "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.
+ },
+ ],
+ },
+ "stringValue": "A String", # The string value to include/exclude.
+ },
+ ],
+ "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.
+ "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.
+ "timeZoneType": "A String", # The timezone to use for interpreting the day part targeting.
+ "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.
+ "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`.
+ "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "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.
+ "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.
+ },
+ "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`.
+ "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "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.
+ "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.
+ },
+ "dayOfWeek": "A String", # The day of the week to target. If unspecified, applicable to all days.
+ },
+ ],
+ },
+ "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
+ "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
+ # only if creative_size_type = CreativeSizeType.NATIVE.
+ "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.
+ },
+ "creativeSizeType": "A String", # The creative size type.
+ "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.
+ "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.
+ },
+ ],
+ },
+ "stringValue": "A String", # The string value to include/exclude.
},
],
"key": "A String", # The key representing the shared targeting criterion.
@@ -4113,120 +4136,56 @@
# 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.
- "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.
- "creativeSizeValue": { # Specifies the size of the creative. # The creative size value to include/exclude.
- # Filled in when key = GOOG_CREATIVE_SIZE
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- "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",
- ],
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- ],
- "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.
- "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
- # only if creative_size_type = CreativeSizeType.NATIVE.
- },
- "stringValue": "A String", # The string value to include/exclude.
- "longValue": "A String", # The long value to include/exclude.
- "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.
- "timeZoneType": "A String", # The timezone to use for interpreting the day part targeting.
- "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.
- "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`.
- "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
- "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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
- "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.
- },
- "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`.
- "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
- "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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
- "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.
- },
- },
- ],
- },
+ },
+ ],
+ "creativeRestrictions": { # Represents creative restrictions associated to Programmatic Guaranteed/ # Output only. Restricitions about the creatives associated with the deal
+ # (i.e., size) This is available for Programmatic Guaranteed/Preferred Deals
+ # in Ad Manager.
+ # Preferred Deal in Ad Manager.
+ # This doesn't apply to Private Auction and AdX Preferred Deals.
+ "skippableAdType": "A String", # Skippable video ads allow viewers to skip ads after 5 seconds.
+ "creativeFormat": "A String", # The format of the environment that the creatives will be displayed in.
+ "creativeSpecifications": [
+ { # Represents information for a creative that is associated with a Programmatic
+ # Guaranteed/Preferred Deal in Ad Manager.
+ "creativeSize": { # Represents size of a single ad slot, or a creative. # The size of the creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
},
- ],
+ "creativeCompanionSizes": [ # Companion sizes may be filled in only when this is a video creative.
+ { # Represents size of a single ad slot, or a creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
+ },
+ ],
+ },
+ ],
+ },
+ "dealServingMetadata": { # Message captures metadata about the serving status of a deal. # Output only. Metadata about the serving status of this deal.
+ "dealPauseStatus": { # Tracks which parties (if any) have paused a deal. # Output only. Tracks which parties (if any) have paused a deal.
+ # The deal is considered paused if either hasBuyerPaused or
+ # hasSellPaused is true.
+ "firstPausedBy": "A String", # The role of the person who first paused this deal.
+ "hasBuyerPaused": True or False, # True, if the buyer has paused the deal unilaterally.
+ "buyerPauseReason": "A String", # The buyer's reason for pausing, if the buyer paused the deal.
+ "sellerPauseReason": "A String", # The seller's reason for pausing, if the seller paused the deal.
+ "hasSellerPaused": True or False, # True, if the seller has paused the deal unilaterally.
},
- ],
- "dealId": "A String", # Output only. A unique deal ID for the deal (server-assigned).
- "proposalId": "A String", # Output only. ID of the proposal that this deal is part of.
- "availableEndTime": "A String", # Proposed flight end time of the deal.
- # This will generally be stored in a granularity of a second.
- # A value is not required for Private Auction deals or Preferred Deals.
- "syndicationProduct": "A String", # The syndication product associated with the deal.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "createProductId": "A String", # The product ID from which this deal was created.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "creativeSafeFrameCompatibility": "A String", # Output only. Specifies whether the creative is safeFrame compatible.
- "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
- # deal.
- "createProductRevision": "A String", # Optional revision number of the product that the deal was created from.
- # If present on create, and the server `product_revision` has advanced sinced
- # the passed-in `create_product_revision`, an `ABORTED` error will be
- # returned.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "sellerContacts": [ # Output only. Seller contact information for the deal.
- { # 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.
- },
- ],
- "availableStartTime": "A String", # Optional proposed flight start time of the deal.
- # This will generally be stored in the granularity of one second since deal
- # serving starts at seconds boundary. Any time specified with more
- # granularity (e.g., in milliseconds) will be truncated towards the start of
- # time in seconds.
- "createTime": "A String", # Output only. The time of the deal creation.
+ },
"dealTerms": { # 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.
- "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.
+ "guaranteedFixedPriceTerms": { # Terms for Programmatic Guaranteed Deals. # The terms for guaranteed fixed price deals.
+ "guaranteedLooks": "A String", # Count of guaranteed looks. Required for deal, optional for product.
+ "guaranteedImpressions": "A String", # Guaranteed impressions as a percentage. This is the percentage
+ # of guaranteed looks that the buyer is guaranteeing to buy.
+ "minimumDailyLooks": "A String", # Daily minimum looks for CPD deal types.
"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
@@ -4234,24 +4193,24 @@
# 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.
+ "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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
"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.
},
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
},
- "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",
- ],
"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).
@@ -4261,6 +4220,11 @@
},
],
},
+ "description": "A String", # Publisher provided description for the terms.
+ "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.
"nonGuaranteedAuctionTerms": { # Terms for Private Auctions. Note that Private Auctions can be created only # The terms for non-guaranteed auction deals.
@@ -4274,24 +4238,60 @@
# 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.
+ "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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
"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.
},
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
},
+ "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.
+ },
+ },
+ ],
+ },
+ "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.
"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.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+ "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.
+ "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ },
+ },
"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).
@@ -4303,152 +4303,34 @@
},
"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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
"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.
},
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
},
"brandingType": "A String", # Visibility of the URL in bid requests. (default: BRANDED)
- "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.
- "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.
- "minimumDailyLooks": "A String", # Daily minimum looks for CPD deal types.
- "guaranteedLooks": "A String", # Count of guaranteed looks. Required for deal, optional for product.
- "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.
- "price": { # Represents a price and a pricing type for a product / deal. # The specified price.
- "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- "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.
- },
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
- },
- "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",
- ],
- "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.
- },
- },
- ],
- },
},
+ "externalDealId": "A String", # Output only. 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.
+ "createProductId": "A String", # The product ID from which this deal was created.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ "updateTime": "A String", # Output only. The time when the deal was last updated.
+ "proposalId": "A String", # Output only. ID of the proposal that this deal is part of.
"targeting": { # Targeting represents different criteria that can be used by advertisers to # Output only. Specifies the subset of inventory targeted by the deal.
# target ad inventory. For example, they can choose to target ad requests only
# if the user is in the US.
# Multiple types of targeting are always applied as a logical AND, unless noted
# otherwise.
- "geoTargeting": { # Generic targeting used for targeting dimensions that contains a list of # Geo criteria IDs to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- "inventorySizeTargeting": { # Represents the size of an ad unit that can be targeted on an ad # Inventory sizes to be included/excluded.
- # request. It only applies to Private Auction, AdX Preferred Deals and
- # Auction Packages. This targeting does not apply to Programmatic Guaranteed
- # and Preferred Deals in Ad Manager.
- "targetedInventorySizes": [ # A list of inventory sizes to be included.
- { # Represents size of a single ad slot, or a creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- ],
- "excludedInventorySizes": [ # A list of inventory sizes to be excluded.
- { # Represents size of a single ad slot, or a creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- ],
- },
- "videoTargeting": { # Represents targeting information about video. # Video targeting information.
- "targetedPositionTypes": [ # A list of video positions to be included.
- # When the included list is present, the excluded list must be empty.
- # When the excluded list is present, the included list must be empty.
- "A String",
- ],
- "excludedPositionTypes": [ # A list of video positions to be excluded.
- # Position types can either be included or excluded (XOR).
- "A String",
- ],
- },
- "technologyTargeting": { # Represents targeting about various types of technology. # Technology targeting information, e.g., operating system, device category.
- "deviceCapabilityTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device capabilities to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- "operatingSystemTargeting": { # Represents targeting information for operating systems. # Operating system related targeting information.
- "operatingSystemCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating systems to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- "operatingSystemVersionCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating system versions to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- },
- "deviceCategoryTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device categories to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- },
"placementTargeting": { # Represents targeting about where the ads can appear, e.g., certain sites or # Placement targeting information, e.g., URL, mobile applications.
# mobile applications.
# Different placement targeting types will be logically OR'ed.
@@ -4457,10 +4339,10 @@
# excluded.
# For Programmatic Guaranteed and Preferred Deals, this doesn't
# apply.
- "targetedUrls": [ # A list of URLs to be included.
+ "excludedUrls": [ # A list of URLs to be excluded.
"A String",
],
- "excludedUrls": [ # A list of URLs to be excluded.
+ "targetedUrls": [ # A list of URLs to be included.
"A String",
],
},
@@ -4474,84 +4356,155 @@
# Google Play Store URL.
# iOS App ID (which is a number) can be found at the end of iTunes store URL.
# First party mobile applications is either included or excluded.
- "targetedAppIds": [ # A list of application IDs to be included.
+ "excludedAppIds": [ # A list of application IDs to be excluded.
"A String",
],
- "excludedAppIds": [ # A list of application IDs to be excluded.
+ "targetedAppIds": [ # A list of application IDs to be included.
"A String",
],
},
},
},
+ "inventorySizeTargeting": { # Represents the size of an ad unit that can be targeted on an ad # Inventory sizes to be included/excluded.
+ # request. It only applies to Private Auction, AdX Preferred Deals and
+ # Auction Packages. This targeting does not apply to Programmatic Guaranteed
+ # and Preferred Deals in Ad Manager.
+ "targetedInventorySizes": [ # A list of inventory sizes to be included.
+ { # Represents size of a single ad slot, or a creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
+ },
+ ],
+ "excludedInventorySizes": [ # A list of inventory sizes to be excluded.
+ { # Represents size of a single ad slot, or a creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
+ },
+ ],
+ },
+ "geoTargeting": { # Generic targeting used for targeting dimensions that contains a list of # Geo criteria IDs to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ "technologyTargeting": { # Represents targeting about various types of technology. # Technology targeting information, e.g., operating system, device category.
+ "operatingSystemTargeting": { # Represents targeting information for operating systems. # Operating system related targeting information.
+ "operatingSystemVersionCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating system versions to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ "operatingSystemCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating systems to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ },
+ "deviceCapabilityTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device capabilities to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ "deviceCategoryTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device categories to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ },
+ "videoTargeting": { # Represents targeting information about video. # Video targeting information.
+ "targetedPositionTypes": [ # A list of video positions to be included.
+ # When the included list is present, the excluded list must be empty.
+ # When the excluded list is present, the included list must be empty.
+ "A String",
+ ],
+ "excludedPositionTypes": [ # A list of video positions to be excluded.
+ # Position types can either be included or excluded (XOR).
+ "A String",
+ ],
+ },
},
- "creativePreApprovalPolicy": "A String", # Output only. Specifies the creative pre-approval policy.
+ "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Buyer private data (hidden from seller).
+ "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
+ # operations (max-length: 1024 unicode code units).
+ },
"deliveryControl": { # Message contains details about how the deals will be paced. # 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.
- "deliveryRateType": "A String", # Output only. Specifies how the impression delivery will be paced.
"frequencyCaps": [ # Output only. Specifies any frequency caps.
{ # Frequency cap.
- "numTimeUnits": 42, # The amount of time, in the units specified by time_unit_type. Defines the
- # amount of time over which impressions per user are counted and capped.
"maxImpressions": 42, # The maximum number of impressions that can be served to a user within the
# specified time period.
"timeUnitType": "A String", # The time unit. Along with num_time_units defines the amount of time over
# which impressions per user are counted and capped.
+ "numTimeUnits": 42, # The amount of time, in the units specified by time_unit_type. Defines the
+ # amount of time over which impressions per user are counted and capped.
},
],
"creativeBlockingLevel": "A String", # Output only. Specified the creative blocking levels to be applied.
+ "deliveryRateType": "A String", # Output only. Specifies how the impression delivery will be paced.
},
- "externalDealId": "A String", # Output only. 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.
- "creativeRestrictions": { # Represents creative restrictions associated to Programmatic Guaranteed/ # Output only. Restricitions about the creatives associated with the deal
- # (i.e., size) This is available for Programmatic Guaranteed/Preferred Deals
- # in Ad Manager.
- # Preferred Deal in Ad Manager.
- # This doesn't apply to Private Auction and AdX Preferred Deals.
- "creativeFormat": "A String", # The format of the environment that the creatives will be displayed in.
- "creativeSpecifications": [
- { # Represents information for a creative that is associated with a Programmatic
- # Guaranteed/Preferred Deal in Ad Manager.
- "creativeSize": { # Represents size of a single ad slot, or a creative. # The size of the creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- "creativeCompanionSizes": [ # Companion sizes may be filled in only when this is a video creative.
- { # Represents size of a single ad slot, or a creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- ],
- },
- ],
- "skippableAdType": "A String", # Skippable video ads allow viewers to skip ads after 5 seconds.
- },
- "dealServingMetadata": { # Message captures metadata about the serving status of a deal. # Output only. Metadata about the serving status of this deal.
- "dealPauseStatus": { # Tracks which parties (if any) have paused a deal. # Output only. Tracks which parties (if any) have paused a deal.
- # The deal is considered paused if either hasBuyerPaused or
- # hasSellPaused is true.
- "firstPausedBy": "A String", # The role of the person who first paused this deal.
- "sellerPauseReason": "A String", # The seller's reason for pausing, if the seller paused the deal.
- "hasSellerPaused": True or False, # True, if the seller has paused the deal unilaterally.
- "buyerPauseReason": "A String", # The buyer's reason for pausing, if the buyer paused the deal.
- "hasBuyerPaused": True or False, # True, if the buyer has paused the deal unilaterally.
+ "availableEndTime": "A String", # Proposed flight end time of the deal.
+ # This will generally be stored in a granularity of a second.
+ # A value is not required for Private Auction deals or Preferred Deals.
+ "availableStartTime": "A String", # Optional proposed flight start time of the deal.
+ # This will generally be stored in the granularity of one second since deal
+ # serving starts at seconds boundary. Any time specified with more
+ # granularity (e.g., in milliseconds) will be truncated towards the start of
+ # time in seconds.
+ "displayName": "A String", # The name of the deal.
+ "creativeSafeFrameCompatibility": "A String", # Output only. Specifies whether the creative is safeFrame compatible.
+ "createProductRevision": "A String", # Optional revision number of the product that the deal was created from.
+ # If present on create, and the server `product_revision` has advanced sinced
+ # the passed-in `create_product_revision`, an `ABORTED` error will be
+ # returned.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ "creativePreApprovalPolicy": "A String", # Output only. Specifies the creative pre-approval policy.
+ "webPropertyCode": "A String", # The web property code for the seller copied over from the product.
+ "sellerContacts": [ # Output only. Seller contact information for the deal.
+ { # Contains information on how a buyer or seller can be reached.
+ "name": "A String", # The name of the contact.
+ "email": "A String", # Email address for the contact.
},
- },
+ ],
"description": "A String", # Description for the deal terms.
+ "syndicationProduct": "A String", # The syndication product associated with the deal.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
},
],
- "proposalRevision": "A String", # Output only. The revision number for the proposal.
- # Each update to the proposal or the deal causes the proposal revision number
- # to auto-increment. The buyer keeps track of the last revision number they
- # know of and pass it in when making an update. If the head revision number
- # on the server has since incremented, then an ABORTED error is returned
- # during the update operation to let the buyer know that a subsequent update
- # was made.
+ "billedBuyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Output only. Reference to the buyer that will get billed for this proposal.
+ # Authorized Buyers account ID.
+ "accountId": "A String", # Authorized Buyers account ID of the buyer.
+ },
+ "displayName": "A String", # The name for the proposal.
"seller": { # Represents a seller of inventory. Each seller is identified by a unique # Reference to the seller on the proposal.
#
# Note: This field may be set only when creating the resource. Modifying
@@ -4561,8 +4514,55 @@
"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.
},
+ "updateTime": "A String", # Output only. The time when the proposal was last revised.
+ "proposalId": "A String", # Output only. The unique ID of the proposal.
+ "isRenegotiating": True or False, # Output only. True if the proposal is being renegotiated.
+ "proposalState": "A String", # Output only. The current state of the proposal.
+ "notes": [ # Output only. The notes associated with this proposal.
+ { # A proposal may be associated to several notes.
+ "noteId": "A String", # Output only. The unique ID for the note.
+ "creatorRole": "A String", # Output only. The role of the person (buyer/seller) creating the note.
+ "proposalRevision": "A String", # Output only. The revision number of the proposal when the note is created.
+ "createTime": "A String", # Output only. The timestamp for when this note was created.
+ "note": "A String", # The actual note to attach.
+ # (max-length: 1024 unicode code units)
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ },
+ ],
+ "sellerContacts": [ # Output only. Contact information for the seller.
+ { # Contains information on how a buyer or seller can be reached.
+ "name": "A String", # The name of the contact.
+ "email": "A String", # Email address for the contact.
+ },
+ ],
+ "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Private data for buyer. (hidden from seller).
+ "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
+ # operations (max-length: 1024 unicode code units).
+ },
+ "buyerContacts": [ # Contact information for the buyer.
+ { # Contains information on how a buyer or seller can be reached.
+ "name": "A String", # The name of the contact.
+ "email": "A String", # Email address for the contact.
+ },
+ ],
+ "privateAuctionId": "A String", # Output only. Private auction ID if this proposal is a private auction
+ # proposal.
+ "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
+ # proposal.
+ "buyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Reference to the buyer on the proposal.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ # Authorized Buyers account ID.
+ "accountId": "A String", # Authorized Buyers account ID of the buyer.
+ },
+ "lastUpdaterOrCommentorRole": "A String", # Output only. The role of the last user that either updated the proposal or
+ # left a comment.
},
],
+ "nextPageToken": "A String", # Continuation token for fetching the next page of results.
}</pre>
</div>
@@ -4622,73 +4622,26 @@
# Auction or Preferred Deals deals through the API.
#
# Fields are updatable unless noted otherwise.
- "buyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Reference to the buyer on the proposal.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- # Authorized Buyers account ID.
- "accountId": "A String", # Authorized Buyers account ID of the buyer.
- },
- "isRenegotiating": True or False, # Output only. True if the proposal is being renegotiated.
- "notes": [ # Output only. The notes associated with this proposal.
- { # A proposal may be associated to several notes.
- "note": "A String", # The actual note to attach.
- # (max-length: 1024 unicode code units)
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "proposalRevision": "A String", # Output only. The revision number of the proposal when the note is created.
- "noteId": "A String", # Output only. The unique ID for the note.
- "createTime": "A String", # Output only. The timestamp for when this note was created.
- "creatorRole": "A String", # Output only. The role of the person (buyer/seller) creating the note.
- },
- ],
- "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
- # proposal.
- "proposalState": "A String", # Output only. The current state of the proposal.
- "sellerContacts": [ # Output only. Contact information for the seller.
- { # 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.
- },
- ],
- "privateAuctionId": "A String", # Output only. Private auction ID if this proposal is a private auction
- # proposal.
+ "proposalRevision": "A String", # Output only. The revision number for the proposal.
+ # Each update to the proposal or the deal causes the proposal revision number
+ # to auto-increment. The buyer keeps track of the last revision number they
+ # know of and pass it in when making an update. If the head revision number
+ # on the server has since incremented, then an ABORTED error is returned
+ # during the update operation to let the buyer know that a subsequent update
+ # was made.
"originatorRole": "A String", # Output only. Indicates whether the buyer/seller created the proposal.
- "lastUpdaterOrCommentorRole": "A String", # Output only. The role of the last user that either updated the proposal or
- # left a comment.
- "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Private data for buyer. (hidden from seller).
- "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
- # operations (max-length: 1024 unicode code units).
- },
- "displayName": "A String", # The name for the proposal.
- "buyerContacts": [ # Contact information for the buyer.
- { # 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.
- },
- ],
- "billedBuyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Output only. Reference to the buyer that will get billed for this proposal.
- # Authorized Buyers account ID.
- "accountId": "A String", # Authorized Buyers account ID of the buyer.
- },
- "updateTime": "A String", # Output only. The time when the proposal was last revised.
- "proposalId": "A String", # Output only. The unique ID of the proposal.
"deals": [ # The deals associated with this proposal. For Private Auction proposals
# (whose deals have NonGuaranteedAuctionTerms), there will only be one deal.
{ # A deal represents a segment of inventory for displaying ads on.
# A proposal can contain multiple deals. A deal contains the terms and
# targeting information that is used for serving.
+ "dealId": "A String", # Output only. A unique deal ID for the deal (server-assigned).
+ "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
+ # deal.
+ "createTime": "A String", # Output only. The time of the deal creation.
"programmaticCreativeSource": "A String", # Output only. Specifies the creative source for programmatic deals.
# PUBLISHER means creative is provided by seller and ADVERTISER means
# creative is provided by buyer.
- "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Buyer private data (hidden from seller).
- "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
- # operations (max-length: 1024 unicode code units).
- },
- "displayName": "A String", # The name of the deal.
- "webPropertyCode": "A String", # The web property code for the seller copied over from the product.
- "updateTime": "A String", # Output only. The time when the deal was last updated.
"targetingCriterion": [ # The shared targeting visible to buyers and sellers. Each shared
# targeting entity is AND'd together.
{ # Advertisers can target different attributes of an ad slot. For example,
@@ -4697,36 +4650,6 @@
"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.
- "creativeSizeValue": { # Specifies the size of the creative. # The creative size value to include/exclude.
- # Filled in when key = GOOG_CREATIVE_SIZE
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- "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",
- ],
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- ],
- "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.
- "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
- # only if creative_size_type = CreativeSizeType.NATIVE.
- },
- "stringValue": "A String", # The string value to include/exclude.
- "longValue": "A String", # The long value to include/exclude.
"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
@@ -4735,34 +4658,135 @@
"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.
- "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`.
- "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
- "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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
- "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.
- },
- "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`.
- "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.
"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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
"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.
},
+ "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`.
+ "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "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.
+ "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.
+ },
+ "dayOfWeek": "A String", # The day of the week to target. If unspecified, applicable to all days.
},
],
},
+ "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
+ "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
+ # only if creative_size_type = CreativeSizeType.NATIVE.
+ "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.
+ },
+ "creativeSizeType": "A String", # The creative size type.
+ "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.
+ "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.
+ },
+ ],
+ },
+ "stringValue": "A String", # The string value to include/exclude.
+ },
+ ],
+ "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.
+ "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.
+ "timeZoneType": "A String", # The timezone to use for interpreting the day part targeting.
+ "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.
+ "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`.
+ "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "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.
+ "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.
+ },
+ "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`.
+ "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "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.
+ "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.
+ },
+ "dayOfWeek": "A String", # The day of the week to target. If unspecified, applicable to all days.
+ },
+ ],
+ },
+ "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
+ "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
+ # only if creative_size_type = CreativeSizeType.NATIVE.
+ "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.
+ },
+ "creativeSizeType": "A String", # The creative size type.
+ "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.
+ "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.
+ },
+ ],
+ },
+ "stringValue": "A String", # The string value to include/exclude.
},
],
"key": "A String", # The key representing the shared targeting criterion.
@@ -4770,120 +4794,56 @@
# 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.
- "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.
- "creativeSizeValue": { # Specifies the size of the creative. # The creative size value to include/exclude.
- # Filled in when key = GOOG_CREATIVE_SIZE
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- "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",
- ],
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- ],
- "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.
- "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
- # only if creative_size_type = CreativeSizeType.NATIVE.
- },
- "stringValue": "A String", # The string value to include/exclude.
- "longValue": "A String", # The long value to include/exclude.
- "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.
- "timeZoneType": "A String", # The timezone to use for interpreting the day part targeting.
- "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.
- "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`.
- "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
- "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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
- "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.
- },
- "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`.
- "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
- "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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
- "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.
- },
- },
- ],
- },
+ },
+ ],
+ "creativeRestrictions": { # Represents creative restrictions associated to Programmatic Guaranteed/ # Output only. Restricitions about the creatives associated with the deal
+ # (i.e., size) This is available for Programmatic Guaranteed/Preferred Deals
+ # in Ad Manager.
+ # Preferred Deal in Ad Manager.
+ # This doesn't apply to Private Auction and AdX Preferred Deals.
+ "skippableAdType": "A String", # Skippable video ads allow viewers to skip ads after 5 seconds.
+ "creativeFormat": "A String", # The format of the environment that the creatives will be displayed in.
+ "creativeSpecifications": [
+ { # Represents information for a creative that is associated with a Programmatic
+ # Guaranteed/Preferred Deal in Ad Manager.
+ "creativeSize": { # Represents size of a single ad slot, or a creative. # The size of the creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
},
- ],
+ "creativeCompanionSizes": [ # Companion sizes may be filled in only when this is a video creative.
+ { # Represents size of a single ad slot, or a creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
+ },
+ ],
+ },
+ ],
+ },
+ "dealServingMetadata": { # Message captures metadata about the serving status of a deal. # Output only. Metadata about the serving status of this deal.
+ "dealPauseStatus": { # Tracks which parties (if any) have paused a deal. # Output only. Tracks which parties (if any) have paused a deal.
+ # The deal is considered paused if either hasBuyerPaused or
+ # hasSellPaused is true.
+ "firstPausedBy": "A String", # The role of the person who first paused this deal.
+ "hasBuyerPaused": True or False, # True, if the buyer has paused the deal unilaterally.
+ "buyerPauseReason": "A String", # The buyer's reason for pausing, if the buyer paused the deal.
+ "sellerPauseReason": "A String", # The seller's reason for pausing, if the seller paused the deal.
+ "hasSellerPaused": True or False, # True, if the seller has paused the deal unilaterally.
},
- ],
- "dealId": "A String", # Output only. A unique deal ID for the deal (server-assigned).
- "proposalId": "A String", # Output only. ID of the proposal that this deal is part of.
- "availableEndTime": "A String", # Proposed flight end time of the deal.
- # This will generally be stored in a granularity of a second.
- # A value is not required for Private Auction deals or Preferred Deals.
- "syndicationProduct": "A String", # The syndication product associated with the deal.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "createProductId": "A String", # The product ID from which this deal was created.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "creativeSafeFrameCompatibility": "A String", # Output only. Specifies whether the creative is safeFrame compatible.
- "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
- # deal.
- "createProductRevision": "A String", # Optional revision number of the product that the deal was created from.
- # If present on create, and the server `product_revision` has advanced sinced
- # the passed-in `create_product_revision`, an `ABORTED` error will be
- # returned.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "sellerContacts": [ # Output only. Seller contact information for the deal.
- { # 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.
- },
- ],
- "availableStartTime": "A String", # Optional proposed flight start time of the deal.
- # This will generally be stored in the granularity of one second since deal
- # serving starts at seconds boundary. Any time specified with more
- # granularity (e.g., in milliseconds) will be truncated towards the start of
- # time in seconds.
- "createTime": "A String", # Output only. The time of the deal creation.
+ },
"dealTerms": { # 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.
- "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.
+ "guaranteedFixedPriceTerms": { # Terms for Programmatic Guaranteed Deals. # The terms for guaranteed fixed price deals.
+ "guaranteedLooks": "A String", # Count of guaranteed looks. Required for deal, optional for product.
+ "guaranteedImpressions": "A String", # Guaranteed impressions as a percentage. This is the percentage
+ # of guaranteed looks that the buyer is guaranteeing to buy.
+ "minimumDailyLooks": "A String", # Daily minimum looks for CPD deal types.
"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
@@ -4891,24 +4851,24 @@
# 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.
+ "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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
"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.
},
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
},
- "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",
- ],
"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).
@@ -4918,6 +4878,11 @@
},
],
},
+ "description": "A String", # Publisher provided description for the terms.
+ "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.
"nonGuaranteedAuctionTerms": { # Terms for Private Auctions. Note that Private Auctions can be created only # The terms for non-guaranteed auction deals.
@@ -4931,24 +4896,60 @@
# 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.
+ "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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
"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.
},
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
},
+ "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.
+ },
+ },
+ ],
+ },
+ "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.
"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.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+ "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.
+ "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ },
+ },
"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).
@@ -4960,152 +4961,34 @@
},
"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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
"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.
},
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
},
"brandingType": "A String", # Visibility of the URL in bid requests. (default: BRANDED)
- "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.
- "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.
- "minimumDailyLooks": "A String", # Daily minimum looks for CPD deal types.
- "guaranteedLooks": "A String", # Count of guaranteed looks. Required for deal, optional for product.
- "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.
- "price": { # Represents a price and a pricing type for a product / deal. # The specified price.
- "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- "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.
- },
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
- },
- "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",
- ],
- "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.
- },
- },
- ],
- },
},
+ "externalDealId": "A String", # Output only. 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.
+ "createProductId": "A String", # The product ID from which this deal was created.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ "updateTime": "A String", # Output only. The time when the deal was last updated.
+ "proposalId": "A String", # Output only. ID of the proposal that this deal is part of.
"targeting": { # Targeting represents different criteria that can be used by advertisers to # Output only. Specifies the subset of inventory targeted by the deal.
# target ad inventory. For example, they can choose to target ad requests only
# if the user is in the US.
# Multiple types of targeting are always applied as a logical AND, unless noted
# otherwise.
- "geoTargeting": { # Generic targeting used for targeting dimensions that contains a list of # Geo criteria IDs to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- "inventorySizeTargeting": { # Represents the size of an ad unit that can be targeted on an ad # Inventory sizes to be included/excluded.
- # request. It only applies to Private Auction, AdX Preferred Deals and
- # Auction Packages. This targeting does not apply to Programmatic Guaranteed
- # and Preferred Deals in Ad Manager.
- "targetedInventorySizes": [ # A list of inventory sizes to be included.
- { # Represents size of a single ad slot, or a creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- ],
- "excludedInventorySizes": [ # A list of inventory sizes to be excluded.
- { # Represents size of a single ad slot, or a creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- ],
- },
- "videoTargeting": { # Represents targeting information about video. # Video targeting information.
- "targetedPositionTypes": [ # A list of video positions to be included.
- # When the included list is present, the excluded list must be empty.
- # When the excluded list is present, the included list must be empty.
- "A String",
- ],
- "excludedPositionTypes": [ # A list of video positions to be excluded.
- # Position types can either be included or excluded (XOR).
- "A String",
- ],
- },
- "technologyTargeting": { # Represents targeting about various types of technology. # Technology targeting information, e.g., operating system, device category.
- "deviceCapabilityTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device capabilities to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- "operatingSystemTargeting": { # Represents targeting information for operating systems. # Operating system related targeting information.
- "operatingSystemCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating systems to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- "operatingSystemVersionCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating system versions to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- },
- "deviceCategoryTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device categories to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- },
"placementTargeting": { # Represents targeting about where the ads can appear, e.g., certain sites or # Placement targeting information, e.g., URL, mobile applications.
# mobile applications.
# Different placement targeting types will be logically OR'ed.
@@ -5114,10 +4997,10 @@
# excluded.
# For Programmatic Guaranteed and Preferred Deals, this doesn't
# apply.
- "targetedUrls": [ # A list of URLs to be included.
+ "excludedUrls": [ # A list of URLs to be excluded.
"A String",
],
- "excludedUrls": [ # A list of URLs to be excluded.
+ "targetedUrls": [ # A list of URLs to be included.
"A String",
],
},
@@ -5131,84 +5014,155 @@
# Google Play Store URL.
# iOS App ID (which is a number) can be found at the end of iTunes store URL.
# First party mobile applications is either included or excluded.
- "targetedAppIds": [ # A list of application IDs to be included.
+ "excludedAppIds": [ # A list of application IDs to be excluded.
"A String",
],
- "excludedAppIds": [ # A list of application IDs to be excluded.
+ "targetedAppIds": [ # A list of application IDs to be included.
"A String",
],
},
},
},
+ "inventorySizeTargeting": { # Represents the size of an ad unit that can be targeted on an ad # Inventory sizes to be included/excluded.
+ # request. It only applies to Private Auction, AdX Preferred Deals and
+ # Auction Packages. This targeting does not apply to Programmatic Guaranteed
+ # and Preferred Deals in Ad Manager.
+ "targetedInventorySizes": [ # A list of inventory sizes to be included.
+ { # Represents size of a single ad slot, or a creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
+ },
+ ],
+ "excludedInventorySizes": [ # A list of inventory sizes to be excluded.
+ { # Represents size of a single ad slot, or a creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
+ },
+ ],
+ },
+ "geoTargeting": { # Generic targeting used for targeting dimensions that contains a list of # Geo criteria IDs to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ "technologyTargeting": { # Represents targeting about various types of technology. # Technology targeting information, e.g., operating system, device category.
+ "operatingSystemTargeting": { # Represents targeting information for operating systems. # Operating system related targeting information.
+ "operatingSystemVersionCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating system versions to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ "operatingSystemCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating systems to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ },
+ "deviceCapabilityTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device capabilities to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ "deviceCategoryTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device categories to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ },
+ "videoTargeting": { # Represents targeting information about video. # Video targeting information.
+ "targetedPositionTypes": [ # A list of video positions to be included.
+ # When the included list is present, the excluded list must be empty.
+ # When the excluded list is present, the included list must be empty.
+ "A String",
+ ],
+ "excludedPositionTypes": [ # A list of video positions to be excluded.
+ # Position types can either be included or excluded (XOR).
+ "A String",
+ ],
+ },
},
- "creativePreApprovalPolicy": "A String", # Output only. Specifies the creative pre-approval policy.
+ "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Buyer private data (hidden from seller).
+ "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
+ # operations (max-length: 1024 unicode code units).
+ },
"deliveryControl": { # Message contains details about how the deals will be paced. # 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.
- "deliveryRateType": "A String", # Output only. Specifies how the impression delivery will be paced.
"frequencyCaps": [ # Output only. Specifies any frequency caps.
{ # Frequency cap.
- "numTimeUnits": 42, # The amount of time, in the units specified by time_unit_type. Defines the
- # amount of time over which impressions per user are counted and capped.
"maxImpressions": 42, # The maximum number of impressions that can be served to a user within the
# specified time period.
"timeUnitType": "A String", # The time unit. Along with num_time_units defines the amount of time over
# which impressions per user are counted and capped.
+ "numTimeUnits": 42, # The amount of time, in the units specified by time_unit_type. Defines the
+ # amount of time over which impressions per user are counted and capped.
},
],
"creativeBlockingLevel": "A String", # Output only. Specified the creative blocking levels to be applied.
+ "deliveryRateType": "A String", # Output only. Specifies how the impression delivery will be paced.
},
- "externalDealId": "A String", # Output only. 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.
- "creativeRestrictions": { # Represents creative restrictions associated to Programmatic Guaranteed/ # Output only. Restricitions about the creatives associated with the deal
- # (i.e., size) This is available for Programmatic Guaranteed/Preferred Deals
- # in Ad Manager.
- # Preferred Deal in Ad Manager.
- # This doesn't apply to Private Auction and AdX Preferred Deals.
- "creativeFormat": "A String", # The format of the environment that the creatives will be displayed in.
- "creativeSpecifications": [
- { # Represents information for a creative that is associated with a Programmatic
- # Guaranteed/Preferred Deal in Ad Manager.
- "creativeSize": { # Represents size of a single ad slot, or a creative. # The size of the creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- "creativeCompanionSizes": [ # Companion sizes may be filled in only when this is a video creative.
- { # Represents size of a single ad slot, or a creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- ],
- },
- ],
- "skippableAdType": "A String", # Skippable video ads allow viewers to skip ads after 5 seconds.
- },
- "dealServingMetadata": { # Message captures metadata about the serving status of a deal. # Output only. Metadata about the serving status of this deal.
- "dealPauseStatus": { # Tracks which parties (if any) have paused a deal. # Output only. Tracks which parties (if any) have paused a deal.
- # The deal is considered paused if either hasBuyerPaused or
- # hasSellPaused is true.
- "firstPausedBy": "A String", # The role of the person who first paused this deal.
- "sellerPauseReason": "A String", # The seller's reason for pausing, if the seller paused the deal.
- "hasSellerPaused": True or False, # True, if the seller has paused the deal unilaterally.
- "buyerPauseReason": "A String", # The buyer's reason for pausing, if the buyer paused the deal.
- "hasBuyerPaused": True or False, # True, if the buyer has paused the deal unilaterally.
+ "availableEndTime": "A String", # Proposed flight end time of the deal.
+ # This will generally be stored in a granularity of a second.
+ # A value is not required for Private Auction deals or Preferred Deals.
+ "availableStartTime": "A String", # Optional proposed flight start time of the deal.
+ # This will generally be stored in the granularity of one second since deal
+ # serving starts at seconds boundary. Any time specified with more
+ # granularity (e.g., in milliseconds) will be truncated towards the start of
+ # time in seconds.
+ "displayName": "A String", # The name of the deal.
+ "creativeSafeFrameCompatibility": "A String", # Output only. Specifies whether the creative is safeFrame compatible.
+ "createProductRevision": "A String", # Optional revision number of the product that the deal was created from.
+ # If present on create, and the server `product_revision` has advanced sinced
+ # the passed-in `create_product_revision`, an `ABORTED` error will be
+ # returned.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ "creativePreApprovalPolicy": "A String", # Output only. Specifies the creative pre-approval policy.
+ "webPropertyCode": "A String", # The web property code for the seller copied over from the product.
+ "sellerContacts": [ # Output only. Seller contact information for the deal.
+ { # Contains information on how a buyer or seller can be reached.
+ "name": "A String", # The name of the contact.
+ "email": "A String", # Email address for the contact.
},
- },
+ ],
"description": "A String", # Description for the deal terms.
+ "syndicationProduct": "A String", # The syndication product associated with the deal.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
},
],
- "proposalRevision": "A String", # Output only. The revision number for the proposal.
- # Each update to the proposal or the deal causes the proposal revision number
- # to auto-increment. The buyer keeps track of the last revision number they
- # know of and pass it in when making an update. If the head revision number
- # on the server has since incremented, then an ABORTED error is returned
- # during the update operation to let the buyer know that a subsequent update
- # was made.
+ "billedBuyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Output only. Reference to the buyer that will get billed for this proposal.
+ # Authorized Buyers account ID.
+ "accountId": "A String", # Authorized Buyers account ID of the buyer.
+ },
+ "displayName": "A String", # The name for the proposal.
"seller": { # Represents a seller of inventory. Each seller is identified by a unique # Reference to the seller on the proposal.
#
# Note: This field may be set only when creating the resource. Modifying
@@ -5218,6 +5172,52 @@
"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.
},
+ "updateTime": "A String", # Output only. The time when the proposal was last revised.
+ "proposalId": "A String", # Output only. The unique ID of the proposal.
+ "isRenegotiating": True or False, # Output only. True if the proposal is being renegotiated.
+ "proposalState": "A String", # Output only. The current state of the proposal.
+ "notes": [ # Output only. The notes associated with this proposal.
+ { # A proposal may be associated to several notes.
+ "noteId": "A String", # Output only. The unique ID for the note.
+ "creatorRole": "A String", # Output only. The role of the person (buyer/seller) creating the note.
+ "proposalRevision": "A String", # Output only. The revision number of the proposal when the note is created.
+ "createTime": "A String", # Output only. The timestamp for when this note was created.
+ "note": "A String", # The actual note to attach.
+ # (max-length: 1024 unicode code units)
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ },
+ ],
+ "sellerContacts": [ # Output only. Contact information for the seller.
+ { # Contains information on how a buyer or seller can be reached.
+ "name": "A String", # The name of the contact.
+ "email": "A String", # Email address for the contact.
+ },
+ ],
+ "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Private data for buyer. (hidden from seller).
+ "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
+ # operations (max-length: 1024 unicode code units).
+ },
+ "buyerContacts": [ # Contact information for the buyer.
+ { # Contains information on how a buyer or seller can be reached.
+ "name": "A String", # The name of the contact.
+ "email": "A String", # Email address for the contact.
+ },
+ ],
+ "privateAuctionId": "A String", # Output only. Private auction ID if this proposal is a private auction
+ # proposal.
+ "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
+ # proposal.
+ "buyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Reference to the buyer on the proposal.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ # Authorized Buyers account ID.
+ "accountId": "A String", # Authorized Buyers account ID of the buyer.
+ },
+ "lastUpdaterOrCommentorRole": "A String", # Output only. The role of the last user that either updated the proposal or
+ # left a comment.
}</pre>
</div>
@@ -5264,73 +5264,26 @@
# Auction or Preferred Deals deals through the API.
#
# Fields are updatable unless noted otherwise.
- "buyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Reference to the buyer on the proposal.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- # Authorized Buyers account ID.
- "accountId": "A String", # Authorized Buyers account ID of the buyer.
- },
- "isRenegotiating": True or False, # Output only. True if the proposal is being renegotiated.
- "notes": [ # Output only. The notes associated with this proposal.
- { # A proposal may be associated to several notes.
- "note": "A String", # The actual note to attach.
- # (max-length: 1024 unicode code units)
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "proposalRevision": "A String", # Output only. The revision number of the proposal when the note is created.
- "noteId": "A String", # Output only. The unique ID for the note.
- "createTime": "A String", # Output only. The timestamp for when this note was created.
- "creatorRole": "A String", # Output only. The role of the person (buyer/seller) creating the note.
- },
- ],
- "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
- # proposal.
- "proposalState": "A String", # Output only. The current state of the proposal.
- "sellerContacts": [ # Output only. Contact information for the seller.
- { # 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.
- },
- ],
- "privateAuctionId": "A String", # Output only. Private auction ID if this proposal is a private auction
- # proposal.
+ "proposalRevision": "A String", # Output only. The revision number for the proposal.
+ # Each update to the proposal or the deal causes the proposal revision number
+ # to auto-increment. The buyer keeps track of the last revision number they
+ # know of and pass it in when making an update. If the head revision number
+ # on the server has since incremented, then an ABORTED error is returned
+ # during the update operation to let the buyer know that a subsequent update
+ # was made.
"originatorRole": "A String", # Output only. Indicates whether the buyer/seller created the proposal.
- "lastUpdaterOrCommentorRole": "A String", # Output only. The role of the last user that either updated the proposal or
- # left a comment.
- "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Private data for buyer. (hidden from seller).
- "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
- # operations (max-length: 1024 unicode code units).
- },
- "displayName": "A String", # The name for the proposal.
- "buyerContacts": [ # Contact information for the buyer.
- { # 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.
- },
- ],
- "billedBuyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Output only. Reference to the buyer that will get billed for this proposal.
- # Authorized Buyers account ID.
- "accountId": "A String", # Authorized Buyers account ID of the buyer.
- },
- "updateTime": "A String", # Output only. The time when the proposal was last revised.
- "proposalId": "A String", # Output only. The unique ID of the proposal.
"deals": [ # The deals associated with this proposal. For Private Auction proposals
# (whose deals have NonGuaranteedAuctionTerms), there will only be one deal.
{ # A deal represents a segment of inventory for displaying ads on.
# A proposal can contain multiple deals. A deal contains the terms and
# targeting information that is used for serving.
+ "dealId": "A String", # Output only. A unique deal ID for the deal (server-assigned).
+ "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
+ # deal.
+ "createTime": "A String", # Output only. The time of the deal creation.
"programmaticCreativeSource": "A String", # Output only. Specifies the creative source for programmatic deals.
# PUBLISHER means creative is provided by seller and ADVERTISER means
# creative is provided by buyer.
- "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Buyer private data (hidden from seller).
- "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
- # operations (max-length: 1024 unicode code units).
- },
- "displayName": "A String", # The name of the deal.
- "webPropertyCode": "A String", # The web property code for the seller copied over from the product.
- "updateTime": "A String", # Output only. The time when the deal was last updated.
"targetingCriterion": [ # The shared targeting visible to buyers and sellers. Each shared
# targeting entity is AND'd together.
{ # Advertisers can target different attributes of an ad slot. For example,
@@ -5339,36 +5292,6 @@
"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.
- "creativeSizeValue": { # Specifies the size of the creative. # The creative size value to include/exclude.
- # Filled in when key = GOOG_CREATIVE_SIZE
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- "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",
- ],
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- ],
- "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.
- "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
- # only if creative_size_type = CreativeSizeType.NATIVE.
- },
- "stringValue": "A String", # The string value to include/exclude.
- "longValue": "A String", # The long value to include/exclude.
"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
@@ -5377,34 +5300,135 @@
"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.
- "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`.
- "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
- "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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
- "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.
- },
- "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`.
- "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.
"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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
"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.
},
+ "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`.
+ "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "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.
+ "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.
+ },
+ "dayOfWeek": "A String", # The day of the week to target. If unspecified, applicable to all days.
},
],
},
+ "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
+ "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
+ # only if creative_size_type = CreativeSizeType.NATIVE.
+ "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.
+ },
+ "creativeSizeType": "A String", # The creative size type.
+ "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.
+ "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.
+ },
+ ],
+ },
+ "stringValue": "A String", # The string value to include/exclude.
+ },
+ ],
+ "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.
+ "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.
+ "timeZoneType": "A String", # The timezone to use for interpreting the day part targeting.
+ "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.
+ "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`.
+ "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "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.
+ "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.
+ },
+ "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`.
+ "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "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.
+ "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.
+ },
+ "dayOfWeek": "A String", # The day of the week to target. If unspecified, applicable to all days.
+ },
+ ],
+ },
+ "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
+ "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
+ # only if creative_size_type = CreativeSizeType.NATIVE.
+ "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.
+ },
+ "creativeSizeType": "A String", # The creative size type.
+ "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.
+ "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.
+ },
+ ],
+ },
+ "stringValue": "A String", # The string value to include/exclude.
},
],
"key": "A String", # The key representing the shared targeting criterion.
@@ -5412,120 +5436,56 @@
# 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.
- "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.
- "creativeSizeValue": { # Specifies the size of the creative. # The creative size value to include/exclude.
- # Filled in when key = GOOG_CREATIVE_SIZE
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- "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",
- ],
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- ],
- "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.
- "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
- # only if creative_size_type = CreativeSizeType.NATIVE.
- },
- "stringValue": "A String", # The string value to include/exclude.
- "longValue": "A String", # The long value to include/exclude.
- "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.
- "timeZoneType": "A String", # The timezone to use for interpreting the day part targeting.
- "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.
- "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`.
- "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
- "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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
- "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.
- },
- "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`.
- "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
- "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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
- "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.
- },
- },
- ],
- },
+ },
+ ],
+ "creativeRestrictions": { # Represents creative restrictions associated to Programmatic Guaranteed/ # Output only. Restricitions about the creatives associated with the deal
+ # (i.e., size) This is available for Programmatic Guaranteed/Preferred Deals
+ # in Ad Manager.
+ # Preferred Deal in Ad Manager.
+ # This doesn't apply to Private Auction and AdX Preferred Deals.
+ "skippableAdType": "A String", # Skippable video ads allow viewers to skip ads after 5 seconds.
+ "creativeFormat": "A String", # The format of the environment that the creatives will be displayed in.
+ "creativeSpecifications": [
+ { # Represents information for a creative that is associated with a Programmatic
+ # Guaranteed/Preferred Deal in Ad Manager.
+ "creativeSize": { # Represents size of a single ad slot, or a creative. # The size of the creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
},
- ],
+ "creativeCompanionSizes": [ # Companion sizes may be filled in only when this is a video creative.
+ { # Represents size of a single ad slot, or a creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
+ },
+ ],
+ },
+ ],
+ },
+ "dealServingMetadata": { # Message captures metadata about the serving status of a deal. # Output only. Metadata about the serving status of this deal.
+ "dealPauseStatus": { # Tracks which parties (if any) have paused a deal. # Output only. Tracks which parties (if any) have paused a deal.
+ # The deal is considered paused if either hasBuyerPaused or
+ # hasSellPaused is true.
+ "firstPausedBy": "A String", # The role of the person who first paused this deal.
+ "hasBuyerPaused": True or False, # True, if the buyer has paused the deal unilaterally.
+ "buyerPauseReason": "A String", # The buyer's reason for pausing, if the buyer paused the deal.
+ "sellerPauseReason": "A String", # The seller's reason for pausing, if the seller paused the deal.
+ "hasSellerPaused": True or False, # True, if the seller has paused the deal unilaterally.
},
- ],
- "dealId": "A String", # Output only. A unique deal ID for the deal (server-assigned).
- "proposalId": "A String", # Output only. ID of the proposal that this deal is part of.
- "availableEndTime": "A String", # Proposed flight end time of the deal.
- # This will generally be stored in a granularity of a second.
- # A value is not required for Private Auction deals or Preferred Deals.
- "syndicationProduct": "A String", # The syndication product associated with the deal.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "createProductId": "A String", # The product ID from which this deal was created.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "creativeSafeFrameCompatibility": "A String", # Output only. Specifies whether the creative is safeFrame compatible.
- "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
- # deal.
- "createProductRevision": "A String", # Optional revision number of the product that the deal was created from.
- # If present on create, and the server `product_revision` has advanced sinced
- # the passed-in `create_product_revision`, an `ABORTED` error will be
- # returned.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "sellerContacts": [ # Output only. Seller contact information for the deal.
- { # 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.
- },
- ],
- "availableStartTime": "A String", # Optional proposed flight start time of the deal.
- # This will generally be stored in the granularity of one second since deal
- # serving starts at seconds boundary. Any time specified with more
- # granularity (e.g., in milliseconds) will be truncated towards the start of
- # time in seconds.
- "createTime": "A String", # Output only. The time of the deal creation.
+ },
"dealTerms": { # 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.
- "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.
+ "guaranteedFixedPriceTerms": { # Terms for Programmatic Guaranteed Deals. # The terms for guaranteed fixed price deals.
+ "guaranteedLooks": "A String", # Count of guaranteed looks. Required for deal, optional for product.
+ "guaranteedImpressions": "A String", # Guaranteed impressions as a percentage. This is the percentage
+ # of guaranteed looks that the buyer is guaranteeing to buy.
+ "minimumDailyLooks": "A String", # Daily minimum looks for CPD deal types.
"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
@@ -5533,24 +5493,24 @@
# 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.
+ "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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
"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.
},
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
},
- "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",
- ],
"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).
@@ -5560,6 +5520,11 @@
},
],
},
+ "description": "A String", # Publisher provided description for the terms.
+ "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.
"nonGuaranteedAuctionTerms": { # Terms for Private Auctions. Note that Private Auctions can be created only # The terms for non-guaranteed auction deals.
@@ -5573,24 +5538,60 @@
# 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.
+ "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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
"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.
},
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
},
+ "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.
+ },
+ },
+ ],
+ },
+ "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.
"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.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+ "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.
+ "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ },
+ },
"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).
@@ -5602,152 +5603,34 @@
},
"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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
"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.
},
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
},
"brandingType": "A String", # Visibility of the URL in bid requests. (default: BRANDED)
- "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.
- "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.
- "minimumDailyLooks": "A String", # Daily minimum looks for CPD deal types.
- "guaranteedLooks": "A String", # Count of guaranteed looks. Required for deal, optional for product.
- "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.
- "price": { # Represents a price and a pricing type for a product / deal. # The specified price.
- "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- "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.
- },
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
- },
- "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",
- ],
- "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.
- },
- },
- ],
- },
},
+ "externalDealId": "A String", # Output only. 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.
+ "createProductId": "A String", # The product ID from which this deal was created.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ "updateTime": "A String", # Output only. The time when the deal was last updated.
+ "proposalId": "A String", # Output only. ID of the proposal that this deal is part of.
"targeting": { # Targeting represents different criteria that can be used by advertisers to # Output only. Specifies the subset of inventory targeted by the deal.
# target ad inventory. For example, they can choose to target ad requests only
# if the user is in the US.
# Multiple types of targeting are always applied as a logical AND, unless noted
# otherwise.
- "geoTargeting": { # Generic targeting used for targeting dimensions that contains a list of # Geo criteria IDs to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- "inventorySizeTargeting": { # Represents the size of an ad unit that can be targeted on an ad # Inventory sizes to be included/excluded.
- # request. It only applies to Private Auction, AdX Preferred Deals and
- # Auction Packages. This targeting does not apply to Programmatic Guaranteed
- # and Preferred Deals in Ad Manager.
- "targetedInventorySizes": [ # A list of inventory sizes to be included.
- { # Represents size of a single ad slot, or a creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- ],
- "excludedInventorySizes": [ # A list of inventory sizes to be excluded.
- { # Represents size of a single ad slot, or a creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- ],
- },
- "videoTargeting": { # Represents targeting information about video. # Video targeting information.
- "targetedPositionTypes": [ # A list of video positions to be included.
- # When the included list is present, the excluded list must be empty.
- # When the excluded list is present, the included list must be empty.
- "A String",
- ],
- "excludedPositionTypes": [ # A list of video positions to be excluded.
- # Position types can either be included or excluded (XOR).
- "A String",
- ],
- },
- "technologyTargeting": { # Represents targeting about various types of technology. # Technology targeting information, e.g., operating system, device category.
- "deviceCapabilityTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device capabilities to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- "operatingSystemTargeting": { # Represents targeting information for operating systems. # Operating system related targeting information.
- "operatingSystemCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating systems to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- "operatingSystemVersionCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating system versions to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- },
- "deviceCategoryTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device categories to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- },
"placementTargeting": { # Represents targeting about where the ads can appear, e.g., certain sites or # Placement targeting information, e.g., URL, mobile applications.
# mobile applications.
# Different placement targeting types will be logically OR'ed.
@@ -5756,10 +5639,10 @@
# excluded.
# For Programmatic Guaranteed and Preferred Deals, this doesn't
# apply.
- "targetedUrls": [ # A list of URLs to be included.
+ "excludedUrls": [ # A list of URLs to be excluded.
"A String",
],
- "excludedUrls": [ # A list of URLs to be excluded.
+ "targetedUrls": [ # A list of URLs to be included.
"A String",
],
},
@@ -5773,84 +5656,155 @@
# Google Play Store URL.
# iOS App ID (which is a number) can be found at the end of iTunes store URL.
# First party mobile applications is either included or excluded.
- "targetedAppIds": [ # A list of application IDs to be included.
+ "excludedAppIds": [ # A list of application IDs to be excluded.
"A String",
],
- "excludedAppIds": [ # A list of application IDs to be excluded.
+ "targetedAppIds": [ # A list of application IDs to be included.
"A String",
],
},
},
},
+ "inventorySizeTargeting": { # Represents the size of an ad unit that can be targeted on an ad # Inventory sizes to be included/excluded.
+ # request. It only applies to Private Auction, AdX Preferred Deals and
+ # Auction Packages. This targeting does not apply to Programmatic Guaranteed
+ # and Preferred Deals in Ad Manager.
+ "targetedInventorySizes": [ # A list of inventory sizes to be included.
+ { # Represents size of a single ad slot, or a creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
+ },
+ ],
+ "excludedInventorySizes": [ # A list of inventory sizes to be excluded.
+ { # Represents size of a single ad slot, or a creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
+ },
+ ],
+ },
+ "geoTargeting": { # Generic targeting used for targeting dimensions that contains a list of # Geo criteria IDs to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ "technologyTargeting": { # Represents targeting about various types of technology. # Technology targeting information, e.g., operating system, device category.
+ "operatingSystemTargeting": { # Represents targeting information for operating systems. # Operating system related targeting information.
+ "operatingSystemVersionCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating system versions to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ "operatingSystemCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating systems to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ },
+ "deviceCapabilityTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device capabilities to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ "deviceCategoryTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device categories to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ },
+ "videoTargeting": { # Represents targeting information about video. # Video targeting information.
+ "targetedPositionTypes": [ # A list of video positions to be included.
+ # When the included list is present, the excluded list must be empty.
+ # When the excluded list is present, the included list must be empty.
+ "A String",
+ ],
+ "excludedPositionTypes": [ # A list of video positions to be excluded.
+ # Position types can either be included or excluded (XOR).
+ "A String",
+ ],
+ },
},
- "creativePreApprovalPolicy": "A String", # Output only. Specifies the creative pre-approval policy.
+ "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Buyer private data (hidden from seller).
+ "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
+ # operations (max-length: 1024 unicode code units).
+ },
"deliveryControl": { # Message contains details about how the deals will be paced. # 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.
- "deliveryRateType": "A String", # Output only. Specifies how the impression delivery will be paced.
"frequencyCaps": [ # Output only. Specifies any frequency caps.
{ # Frequency cap.
- "numTimeUnits": 42, # The amount of time, in the units specified by time_unit_type. Defines the
- # amount of time over which impressions per user are counted and capped.
"maxImpressions": 42, # The maximum number of impressions that can be served to a user within the
# specified time period.
"timeUnitType": "A String", # The time unit. Along with num_time_units defines the amount of time over
# which impressions per user are counted and capped.
+ "numTimeUnits": 42, # The amount of time, in the units specified by time_unit_type. Defines the
+ # amount of time over which impressions per user are counted and capped.
},
],
"creativeBlockingLevel": "A String", # Output only. Specified the creative blocking levels to be applied.
+ "deliveryRateType": "A String", # Output only. Specifies how the impression delivery will be paced.
},
- "externalDealId": "A String", # Output only. 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.
- "creativeRestrictions": { # Represents creative restrictions associated to Programmatic Guaranteed/ # Output only. Restricitions about the creatives associated with the deal
- # (i.e., size) This is available for Programmatic Guaranteed/Preferred Deals
- # in Ad Manager.
- # Preferred Deal in Ad Manager.
- # This doesn't apply to Private Auction and AdX Preferred Deals.
- "creativeFormat": "A String", # The format of the environment that the creatives will be displayed in.
- "creativeSpecifications": [
- { # Represents information for a creative that is associated with a Programmatic
- # Guaranteed/Preferred Deal in Ad Manager.
- "creativeSize": { # Represents size of a single ad slot, or a creative. # The size of the creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- "creativeCompanionSizes": [ # Companion sizes may be filled in only when this is a video creative.
- { # Represents size of a single ad slot, or a creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- ],
- },
- ],
- "skippableAdType": "A String", # Skippable video ads allow viewers to skip ads after 5 seconds.
- },
- "dealServingMetadata": { # Message captures metadata about the serving status of a deal. # Output only. Metadata about the serving status of this deal.
- "dealPauseStatus": { # Tracks which parties (if any) have paused a deal. # Output only. Tracks which parties (if any) have paused a deal.
- # The deal is considered paused if either hasBuyerPaused or
- # hasSellPaused is true.
- "firstPausedBy": "A String", # The role of the person who first paused this deal.
- "sellerPauseReason": "A String", # The seller's reason for pausing, if the seller paused the deal.
- "hasSellerPaused": True or False, # True, if the seller has paused the deal unilaterally.
- "buyerPauseReason": "A String", # The buyer's reason for pausing, if the buyer paused the deal.
- "hasBuyerPaused": True or False, # True, if the buyer has paused the deal unilaterally.
+ "availableEndTime": "A String", # Proposed flight end time of the deal.
+ # This will generally be stored in a granularity of a second.
+ # A value is not required for Private Auction deals or Preferred Deals.
+ "availableStartTime": "A String", # Optional proposed flight start time of the deal.
+ # This will generally be stored in the granularity of one second since deal
+ # serving starts at seconds boundary. Any time specified with more
+ # granularity (e.g., in milliseconds) will be truncated towards the start of
+ # time in seconds.
+ "displayName": "A String", # The name of the deal.
+ "creativeSafeFrameCompatibility": "A String", # Output only. Specifies whether the creative is safeFrame compatible.
+ "createProductRevision": "A String", # Optional revision number of the product that the deal was created from.
+ # If present on create, and the server `product_revision` has advanced sinced
+ # the passed-in `create_product_revision`, an `ABORTED` error will be
+ # returned.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ "creativePreApprovalPolicy": "A String", # Output only. Specifies the creative pre-approval policy.
+ "webPropertyCode": "A String", # The web property code for the seller copied over from the product.
+ "sellerContacts": [ # Output only. Seller contact information for the deal.
+ { # Contains information on how a buyer or seller can be reached.
+ "name": "A String", # The name of the contact.
+ "email": "A String", # Email address for the contact.
},
- },
+ ],
"description": "A String", # Description for the deal terms.
+ "syndicationProduct": "A String", # The syndication product associated with the deal.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
},
],
- "proposalRevision": "A String", # Output only. The revision number for the proposal.
- # Each update to the proposal or the deal causes the proposal revision number
- # to auto-increment. The buyer keeps track of the last revision number they
- # know of and pass it in when making an update. If the head revision number
- # on the server has since incremented, then an ABORTED error is returned
- # during the update operation to let the buyer know that a subsequent update
- # was made.
+ "billedBuyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Output only. Reference to the buyer that will get billed for this proposal.
+ # Authorized Buyers account ID.
+ "accountId": "A String", # Authorized Buyers account ID of the buyer.
+ },
+ "displayName": "A String", # The name for the proposal.
"seller": { # Represents a seller of inventory. Each seller is identified by a unique # Reference to the seller on the proposal.
#
# Note: This field may be set only when creating the resource. Modifying
@@ -5860,6 +5814,52 @@
"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.
},
+ "updateTime": "A String", # Output only. The time when the proposal was last revised.
+ "proposalId": "A String", # Output only. The unique ID of the proposal.
+ "isRenegotiating": True or False, # Output only. True if the proposal is being renegotiated.
+ "proposalState": "A String", # Output only. The current state of the proposal.
+ "notes": [ # Output only. The notes associated with this proposal.
+ { # A proposal may be associated to several notes.
+ "noteId": "A String", # Output only. The unique ID for the note.
+ "creatorRole": "A String", # Output only. The role of the person (buyer/seller) creating the note.
+ "proposalRevision": "A String", # Output only. The revision number of the proposal when the note is created.
+ "createTime": "A String", # Output only. The timestamp for when this note was created.
+ "note": "A String", # The actual note to attach.
+ # (max-length: 1024 unicode code units)
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ },
+ ],
+ "sellerContacts": [ # Output only. Contact information for the seller.
+ { # Contains information on how a buyer or seller can be reached.
+ "name": "A String", # The name of the contact.
+ "email": "A String", # Email address for the contact.
+ },
+ ],
+ "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Private data for buyer. (hidden from seller).
+ "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
+ # operations (max-length: 1024 unicode code units).
+ },
+ "buyerContacts": [ # Contact information for the buyer.
+ { # Contains information on how a buyer or seller can be reached.
+ "name": "A String", # The name of the contact.
+ "email": "A String", # Email address for the contact.
+ },
+ ],
+ "privateAuctionId": "A String", # Output only. Private auction ID if this proposal is a private auction
+ # proposal.
+ "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
+ # proposal.
+ "buyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Reference to the buyer on the proposal.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ # Authorized Buyers account ID.
+ "accountId": "A String", # Authorized Buyers account ID of the buyer.
+ },
+ "lastUpdaterOrCommentorRole": "A String", # Output only. The role of the last user that either updated the proposal or
+ # left a comment.
}</pre>
</div>
@@ -5896,73 +5896,26 @@
# Auction or Preferred Deals deals through the API.
#
# Fields are updatable unless noted otherwise.
- "buyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Reference to the buyer on the proposal.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- # Authorized Buyers account ID.
- "accountId": "A String", # Authorized Buyers account ID of the buyer.
- },
- "isRenegotiating": True or False, # Output only. True if the proposal is being renegotiated.
- "notes": [ # Output only. The notes associated with this proposal.
- { # A proposal may be associated to several notes.
- "note": "A String", # The actual note to attach.
- # (max-length: 1024 unicode code units)
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "proposalRevision": "A String", # Output only. The revision number of the proposal when the note is created.
- "noteId": "A String", # Output only. The unique ID for the note.
- "createTime": "A String", # Output only. The timestamp for when this note was created.
- "creatorRole": "A String", # Output only. The role of the person (buyer/seller) creating the note.
- },
- ],
- "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
- # proposal.
- "proposalState": "A String", # Output only. The current state of the proposal.
- "sellerContacts": [ # Output only. Contact information for the seller.
- { # 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.
- },
- ],
- "privateAuctionId": "A String", # Output only. Private auction ID if this proposal is a private auction
- # proposal.
+ "proposalRevision": "A String", # Output only. The revision number for the proposal.
+ # Each update to the proposal or the deal causes the proposal revision number
+ # to auto-increment. The buyer keeps track of the last revision number they
+ # know of and pass it in when making an update. If the head revision number
+ # on the server has since incremented, then an ABORTED error is returned
+ # during the update operation to let the buyer know that a subsequent update
+ # was made.
"originatorRole": "A String", # Output only. Indicates whether the buyer/seller created the proposal.
- "lastUpdaterOrCommentorRole": "A String", # Output only. The role of the last user that either updated the proposal or
- # left a comment.
- "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Private data for buyer. (hidden from seller).
- "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
- # operations (max-length: 1024 unicode code units).
- },
- "displayName": "A String", # The name for the proposal.
- "buyerContacts": [ # Contact information for the buyer.
- { # 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.
- },
- ],
- "billedBuyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Output only. Reference to the buyer that will get billed for this proposal.
- # Authorized Buyers account ID.
- "accountId": "A String", # Authorized Buyers account ID of the buyer.
- },
- "updateTime": "A String", # Output only. The time when the proposal was last revised.
- "proposalId": "A String", # Output only. The unique ID of the proposal.
"deals": [ # The deals associated with this proposal. For Private Auction proposals
# (whose deals have NonGuaranteedAuctionTerms), there will only be one deal.
{ # A deal represents a segment of inventory for displaying ads on.
# A proposal can contain multiple deals. A deal contains the terms and
# targeting information that is used for serving.
+ "dealId": "A String", # Output only. A unique deal ID for the deal (server-assigned).
+ "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
+ # deal.
+ "createTime": "A String", # Output only. The time of the deal creation.
"programmaticCreativeSource": "A String", # Output only. Specifies the creative source for programmatic deals.
# PUBLISHER means creative is provided by seller and ADVERTISER means
# creative is provided by buyer.
- "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Buyer private data (hidden from seller).
- "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
- # operations (max-length: 1024 unicode code units).
- },
- "displayName": "A String", # The name of the deal.
- "webPropertyCode": "A String", # The web property code for the seller copied over from the product.
- "updateTime": "A String", # Output only. The time when the deal was last updated.
"targetingCriterion": [ # The shared targeting visible to buyers and sellers. Each shared
# targeting entity is AND'd together.
{ # Advertisers can target different attributes of an ad slot. For example,
@@ -5971,36 +5924,6 @@
"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.
- "creativeSizeValue": { # Specifies the size of the creative. # The creative size value to include/exclude.
- # Filled in when key = GOOG_CREATIVE_SIZE
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- "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",
- ],
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- ],
- "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.
- "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
- # only if creative_size_type = CreativeSizeType.NATIVE.
- },
- "stringValue": "A String", # The string value to include/exclude.
- "longValue": "A String", # The long value to include/exclude.
"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
@@ -6009,34 +5932,135 @@
"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.
- "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`.
- "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
- "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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
- "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.
- },
- "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`.
- "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.
"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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
"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.
},
+ "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`.
+ "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "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.
+ "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.
+ },
+ "dayOfWeek": "A String", # The day of the week to target. If unspecified, applicable to all days.
},
],
},
+ "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
+ "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
+ # only if creative_size_type = CreativeSizeType.NATIVE.
+ "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.
+ },
+ "creativeSizeType": "A String", # The creative size type.
+ "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.
+ "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.
+ },
+ ],
+ },
+ "stringValue": "A String", # The string value to include/exclude.
+ },
+ ],
+ "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.
+ "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.
+ "timeZoneType": "A String", # The timezone to use for interpreting the day part targeting.
+ "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.
+ "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`.
+ "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "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.
+ "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.
+ },
+ "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`.
+ "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "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.
+ "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.
+ },
+ "dayOfWeek": "A String", # The day of the week to target. If unspecified, applicable to all days.
+ },
+ ],
+ },
+ "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
+ "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
+ # only if creative_size_type = CreativeSizeType.NATIVE.
+ "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.
+ },
+ "creativeSizeType": "A String", # The creative size type.
+ "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.
+ "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.
+ },
+ ],
+ },
+ "stringValue": "A String", # The string value to include/exclude.
},
],
"key": "A String", # The key representing the shared targeting criterion.
@@ -6044,120 +6068,56 @@
# 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.
- "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.
- "creativeSizeValue": { # Specifies the size of the creative. # The creative size value to include/exclude.
- # Filled in when key = GOOG_CREATIVE_SIZE
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- "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",
- ],
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- ],
- "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.
- "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
- # only if creative_size_type = CreativeSizeType.NATIVE.
- },
- "stringValue": "A String", # The string value to include/exclude.
- "longValue": "A String", # The long value to include/exclude.
- "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.
- "timeZoneType": "A String", # The timezone to use for interpreting the day part targeting.
- "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.
- "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`.
- "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
- "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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
- "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.
- },
- "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`.
- "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
- "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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
- "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.
- },
- },
- ],
- },
+ },
+ ],
+ "creativeRestrictions": { # Represents creative restrictions associated to Programmatic Guaranteed/ # Output only. Restricitions about the creatives associated with the deal
+ # (i.e., size) This is available for Programmatic Guaranteed/Preferred Deals
+ # in Ad Manager.
+ # Preferred Deal in Ad Manager.
+ # This doesn't apply to Private Auction and AdX Preferred Deals.
+ "skippableAdType": "A String", # Skippable video ads allow viewers to skip ads after 5 seconds.
+ "creativeFormat": "A String", # The format of the environment that the creatives will be displayed in.
+ "creativeSpecifications": [
+ { # Represents information for a creative that is associated with a Programmatic
+ # Guaranteed/Preferred Deal in Ad Manager.
+ "creativeSize": { # Represents size of a single ad slot, or a creative. # The size of the creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
},
- ],
+ "creativeCompanionSizes": [ # Companion sizes may be filled in only when this is a video creative.
+ { # Represents size of a single ad slot, or a creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
+ },
+ ],
+ },
+ ],
+ },
+ "dealServingMetadata": { # Message captures metadata about the serving status of a deal. # Output only. Metadata about the serving status of this deal.
+ "dealPauseStatus": { # Tracks which parties (if any) have paused a deal. # Output only. Tracks which parties (if any) have paused a deal.
+ # The deal is considered paused if either hasBuyerPaused or
+ # hasSellPaused is true.
+ "firstPausedBy": "A String", # The role of the person who first paused this deal.
+ "hasBuyerPaused": True or False, # True, if the buyer has paused the deal unilaterally.
+ "buyerPauseReason": "A String", # The buyer's reason for pausing, if the buyer paused the deal.
+ "sellerPauseReason": "A String", # The seller's reason for pausing, if the seller paused the deal.
+ "hasSellerPaused": True or False, # True, if the seller has paused the deal unilaterally.
},
- ],
- "dealId": "A String", # Output only. A unique deal ID for the deal (server-assigned).
- "proposalId": "A String", # Output only. ID of the proposal that this deal is part of.
- "availableEndTime": "A String", # Proposed flight end time of the deal.
- # This will generally be stored in a granularity of a second.
- # A value is not required for Private Auction deals or Preferred Deals.
- "syndicationProduct": "A String", # The syndication product associated with the deal.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "createProductId": "A String", # The product ID from which this deal was created.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "creativeSafeFrameCompatibility": "A String", # Output only. Specifies whether the creative is safeFrame compatible.
- "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
- # deal.
- "createProductRevision": "A String", # Optional revision number of the product that the deal was created from.
- # If present on create, and the server `product_revision` has advanced sinced
- # the passed-in `create_product_revision`, an `ABORTED` error will be
- # returned.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "sellerContacts": [ # Output only. Seller contact information for the deal.
- { # 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.
- },
- ],
- "availableStartTime": "A String", # Optional proposed flight start time of the deal.
- # This will generally be stored in the granularity of one second since deal
- # serving starts at seconds boundary. Any time specified with more
- # granularity (e.g., in milliseconds) will be truncated towards the start of
- # time in seconds.
- "createTime": "A String", # Output only. The time of the deal creation.
+ },
"dealTerms": { # 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.
- "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.
+ "guaranteedFixedPriceTerms": { # Terms for Programmatic Guaranteed Deals. # The terms for guaranteed fixed price deals.
+ "guaranteedLooks": "A String", # Count of guaranteed looks. Required for deal, optional for product.
+ "guaranteedImpressions": "A String", # Guaranteed impressions as a percentage. This is the percentage
+ # of guaranteed looks that the buyer is guaranteeing to buy.
+ "minimumDailyLooks": "A String", # Daily minimum looks for CPD deal types.
"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
@@ -6165,24 +6125,24 @@
# 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.
+ "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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
"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.
},
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
},
- "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",
- ],
"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).
@@ -6192,6 +6152,11 @@
},
],
},
+ "description": "A String", # Publisher provided description for the terms.
+ "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.
"nonGuaranteedAuctionTerms": { # Terms for Private Auctions. Note that Private Auctions can be created only # The terms for non-guaranteed auction deals.
@@ -6205,24 +6170,60 @@
# 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.
+ "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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
"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.
},
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
},
+ "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.
+ },
+ },
+ ],
+ },
+ "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.
"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.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+ "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.
+ "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ },
+ },
"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).
@@ -6234,152 +6235,34 @@
},
"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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
"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.
},
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
},
"brandingType": "A String", # Visibility of the URL in bid requests. (default: BRANDED)
- "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.
- "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.
- "minimumDailyLooks": "A String", # Daily minimum looks for CPD deal types.
- "guaranteedLooks": "A String", # Count of guaranteed looks. Required for deal, optional for product.
- "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.
- "price": { # Represents a price and a pricing type for a product / deal. # The specified price.
- "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- "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.
- },
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
- },
- "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",
- ],
- "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.
- },
- },
- ],
- },
},
+ "externalDealId": "A String", # Output only. 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.
+ "createProductId": "A String", # The product ID from which this deal was created.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ "updateTime": "A String", # Output only. The time when the deal was last updated.
+ "proposalId": "A String", # Output only. ID of the proposal that this deal is part of.
"targeting": { # Targeting represents different criteria that can be used by advertisers to # Output only. Specifies the subset of inventory targeted by the deal.
# target ad inventory. For example, they can choose to target ad requests only
# if the user is in the US.
# Multiple types of targeting are always applied as a logical AND, unless noted
# otherwise.
- "geoTargeting": { # Generic targeting used for targeting dimensions that contains a list of # Geo criteria IDs to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- "inventorySizeTargeting": { # Represents the size of an ad unit that can be targeted on an ad # Inventory sizes to be included/excluded.
- # request. It only applies to Private Auction, AdX Preferred Deals and
- # Auction Packages. This targeting does not apply to Programmatic Guaranteed
- # and Preferred Deals in Ad Manager.
- "targetedInventorySizes": [ # A list of inventory sizes to be included.
- { # Represents size of a single ad slot, or a creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- ],
- "excludedInventorySizes": [ # A list of inventory sizes to be excluded.
- { # Represents size of a single ad slot, or a creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- ],
- },
- "videoTargeting": { # Represents targeting information about video. # Video targeting information.
- "targetedPositionTypes": [ # A list of video positions to be included.
- # When the included list is present, the excluded list must be empty.
- # When the excluded list is present, the included list must be empty.
- "A String",
- ],
- "excludedPositionTypes": [ # A list of video positions to be excluded.
- # Position types can either be included or excluded (XOR).
- "A String",
- ],
- },
- "technologyTargeting": { # Represents targeting about various types of technology. # Technology targeting information, e.g., operating system, device category.
- "deviceCapabilityTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device capabilities to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- "operatingSystemTargeting": { # Represents targeting information for operating systems. # Operating system related targeting information.
- "operatingSystemCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating systems to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- "operatingSystemVersionCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating system versions to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- },
- "deviceCategoryTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device categories to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- },
"placementTargeting": { # Represents targeting about where the ads can appear, e.g., certain sites or # Placement targeting information, e.g., URL, mobile applications.
# mobile applications.
# Different placement targeting types will be logically OR'ed.
@@ -6388,10 +6271,10 @@
# excluded.
# For Programmatic Guaranteed and Preferred Deals, this doesn't
# apply.
- "targetedUrls": [ # A list of URLs to be included.
+ "excludedUrls": [ # A list of URLs to be excluded.
"A String",
],
- "excludedUrls": [ # A list of URLs to be excluded.
+ "targetedUrls": [ # A list of URLs to be included.
"A String",
],
},
@@ -6405,84 +6288,155 @@
# Google Play Store URL.
# iOS App ID (which is a number) can be found at the end of iTunes store URL.
# First party mobile applications is either included or excluded.
- "targetedAppIds": [ # A list of application IDs to be included.
+ "excludedAppIds": [ # A list of application IDs to be excluded.
"A String",
],
- "excludedAppIds": [ # A list of application IDs to be excluded.
+ "targetedAppIds": [ # A list of application IDs to be included.
"A String",
],
},
},
},
+ "inventorySizeTargeting": { # Represents the size of an ad unit that can be targeted on an ad # Inventory sizes to be included/excluded.
+ # request. It only applies to Private Auction, AdX Preferred Deals and
+ # Auction Packages. This targeting does not apply to Programmatic Guaranteed
+ # and Preferred Deals in Ad Manager.
+ "targetedInventorySizes": [ # A list of inventory sizes to be included.
+ { # Represents size of a single ad slot, or a creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
+ },
+ ],
+ "excludedInventorySizes": [ # A list of inventory sizes to be excluded.
+ { # Represents size of a single ad slot, or a creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
+ },
+ ],
+ },
+ "geoTargeting": { # Generic targeting used for targeting dimensions that contains a list of # Geo criteria IDs to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ "technologyTargeting": { # Represents targeting about various types of technology. # Technology targeting information, e.g., operating system, device category.
+ "operatingSystemTargeting": { # Represents targeting information for operating systems. # Operating system related targeting information.
+ "operatingSystemVersionCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating system versions to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ "operatingSystemCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating systems to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ },
+ "deviceCapabilityTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device capabilities to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ "deviceCategoryTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device categories to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ },
+ "videoTargeting": { # Represents targeting information about video. # Video targeting information.
+ "targetedPositionTypes": [ # A list of video positions to be included.
+ # When the included list is present, the excluded list must be empty.
+ # When the excluded list is present, the included list must be empty.
+ "A String",
+ ],
+ "excludedPositionTypes": [ # A list of video positions to be excluded.
+ # Position types can either be included or excluded (XOR).
+ "A String",
+ ],
+ },
},
- "creativePreApprovalPolicy": "A String", # Output only. Specifies the creative pre-approval policy.
+ "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Buyer private data (hidden from seller).
+ "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
+ # operations (max-length: 1024 unicode code units).
+ },
"deliveryControl": { # Message contains details about how the deals will be paced. # 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.
- "deliveryRateType": "A String", # Output only. Specifies how the impression delivery will be paced.
"frequencyCaps": [ # Output only. Specifies any frequency caps.
{ # Frequency cap.
- "numTimeUnits": 42, # The amount of time, in the units specified by time_unit_type. Defines the
- # amount of time over which impressions per user are counted and capped.
"maxImpressions": 42, # The maximum number of impressions that can be served to a user within the
# specified time period.
"timeUnitType": "A String", # The time unit. Along with num_time_units defines the amount of time over
# which impressions per user are counted and capped.
+ "numTimeUnits": 42, # The amount of time, in the units specified by time_unit_type. Defines the
+ # amount of time over which impressions per user are counted and capped.
},
],
"creativeBlockingLevel": "A String", # Output only. Specified the creative blocking levels to be applied.
+ "deliveryRateType": "A String", # Output only. Specifies how the impression delivery will be paced.
},
- "externalDealId": "A String", # Output only. 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.
- "creativeRestrictions": { # Represents creative restrictions associated to Programmatic Guaranteed/ # Output only. Restricitions about the creatives associated with the deal
- # (i.e., size) This is available for Programmatic Guaranteed/Preferred Deals
- # in Ad Manager.
- # Preferred Deal in Ad Manager.
- # This doesn't apply to Private Auction and AdX Preferred Deals.
- "creativeFormat": "A String", # The format of the environment that the creatives will be displayed in.
- "creativeSpecifications": [
- { # Represents information for a creative that is associated with a Programmatic
- # Guaranteed/Preferred Deal in Ad Manager.
- "creativeSize": { # Represents size of a single ad slot, or a creative. # The size of the creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- "creativeCompanionSizes": [ # Companion sizes may be filled in only when this is a video creative.
- { # Represents size of a single ad slot, or a creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- ],
- },
- ],
- "skippableAdType": "A String", # Skippable video ads allow viewers to skip ads after 5 seconds.
- },
- "dealServingMetadata": { # Message captures metadata about the serving status of a deal. # Output only. Metadata about the serving status of this deal.
- "dealPauseStatus": { # Tracks which parties (if any) have paused a deal. # Output only. Tracks which parties (if any) have paused a deal.
- # The deal is considered paused if either hasBuyerPaused or
- # hasSellPaused is true.
- "firstPausedBy": "A String", # The role of the person who first paused this deal.
- "sellerPauseReason": "A String", # The seller's reason for pausing, if the seller paused the deal.
- "hasSellerPaused": True or False, # True, if the seller has paused the deal unilaterally.
- "buyerPauseReason": "A String", # The buyer's reason for pausing, if the buyer paused the deal.
- "hasBuyerPaused": True or False, # True, if the buyer has paused the deal unilaterally.
+ "availableEndTime": "A String", # Proposed flight end time of the deal.
+ # This will generally be stored in a granularity of a second.
+ # A value is not required for Private Auction deals or Preferred Deals.
+ "availableStartTime": "A String", # Optional proposed flight start time of the deal.
+ # This will generally be stored in the granularity of one second since deal
+ # serving starts at seconds boundary. Any time specified with more
+ # granularity (e.g., in milliseconds) will be truncated towards the start of
+ # time in seconds.
+ "displayName": "A String", # The name of the deal.
+ "creativeSafeFrameCompatibility": "A String", # Output only. Specifies whether the creative is safeFrame compatible.
+ "createProductRevision": "A String", # Optional revision number of the product that the deal was created from.
+ # If present on create, and the server `product_revision` has advanced sinced
+ # the passed-in `create_product_revision`, an `ABORTED` error will be
+ # returned.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ "creativePreApprovalPolicy": "A String", # Output only. Specifies the creative pre-approval policy.
+ "webPropertyCode": "A String", # The web property code for the seller copied over from the product.
+ "sellerContacts": [ # Output only. Seller contact information for the deal.
+ { # Contains information on how a buyer or seller can be reached.
+ "name": "A String", # The name of the contact.
+ "email": "A String", # Email address for the contact.
},
- },
+ ],
"description": "A String", # Description for the deal terms.
+ "syndicationProduct": "A String", # The syndication product associated with the deal.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
},
],
- "proposalRevision": "A String", # Output only. The revision number for the proposal.
- # Each update to the proposal or the deal causes the proposal revision number
- # to auto-increment. The buyer keeps track of the last revision number they
- # know of and pass it in when making an update. If the head revision number
- # on the server has since incremented, then an ABORTED error is returned
- # during the update operation to let the buyer know that a subsequent update
- # was made.
+ "billedBuyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Output only. Reference to the buyer that will get billed for this proposal.
+ # Authorized Buyers account ID.
+ "accountId": "A String", # Authorized Buyers account ID of the buyer.
+ },
+ "displayName": "A String", # The name for the proposal.
"seller": { # Represents a seller of inventory. Each seller is identified by a unique # Reference to the seller on the proposal.
#
# Note: This field may be set only when creating the resource. Modifying
@@ -6492,6 +6446,52 @@
"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.
},
+ "updateTime": "A String", # Output only. The time when the proposal was last revised.
+ "proposalId": "A String", # Output only. The unique ID of the proposal.
+ "isRenegotiating": True or False, # Output only. True if the proposal is being renegotiated.
+ "proposalState": "A String", # Output only. The current state of the proposal.
+ "notes": [ # Output only. The notes associated with this proposal.
+ { # A proposal may be associated to several notes.
+ "noteId": "A String", # Output only. The unique ID for the note.
+ "creatorRole": "A String", # Output only. The role of the person (buyer/seller) creating the note.
+ "proposalRevision": "A String", # Output only. The revision number of the proposal when the note is created.
+ "createTime": "A String", # Output only. The timestamp for when this note was created.
+ "note": "A String", # The actual note to attach.
+ # (max-length: 1024 unicode code units)
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ },
+ ],
+ "sellerContacts": [ # Output only. Contact information for the seller.
+ { # Contains information on how a buyer or seller can be reached.
+ "name": "A String", # The name of the contact.
+ "email": "A String", # Email address for the contact.
+ },
+ ],
+ "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Private data for buyer. (hidden from seller).
+ "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
+ # operations (max-length: 1024 unicode code units).
+ },
+ "buyerContacts": [ # Contact information for the buyer.
+ { # Contains information on how a buyer or seller can be reached.
+ "name": "A String", # The name of the contact.
+ "email": "A String", # Email address for the contact.
+ },
+ ],
+ "privateAuctionId": "A String", # Output only. Private auction ID if this proposal is a private auction
+ # proposal.
+ "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
+ # proposal.
+ "buyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Reference to the buyer on the proposal.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ # Authorized Buyers account ID.
+ "accountId": "A String", # Authorized Buyers account ID of the buyer.
+ },
+ "lastUpdaterOrCommentorRole": "A String", # Output only. The role of the last user that either updated the proposal or
+ # left a comment.
}
x__xgafv: string, V1 error format.
@@ -6513,73 +6513,26 @@
# Auction or Preferred Deals deals through the API.
#
# Fields are updatable unless noted otherwise.
- "buyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Reference to the buyer on the proposal.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- # Authorized Buyers account ID.
- "accountId": "A String", # Authorized Buyers account ID of the buyer.
- },
- "isRenegotiating": True or False, # Output only. True if the proposal is being renegotiated.
- "notes": [ # Output only. The notes associated with this proposal.
- { # A proposal may be associated to several notes.
- "note": "A String", # The actual note to attach.
- # (max-length: 1024 unicode code units)
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "proposalRevision": "A String", # Output only. The revision number of the proposal when the note is created.
- "noteId": "A String", # Output only. The unique ID for the note.
- "createTime": "A String", # Output only. The timestamp for when this note was created.
- "creatorRole": "A String", # Output only. The role of the person (buyer/seller) creating the note.
- },
- ],
- "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
- # proposal.
- "proposalState": "A String", # Output only. The current state of the proposal.
- "sellerContacts": [ # Output only. Contact information for the seller.
- { # 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.
- },
- ],
- "privateAuctionId": "A String", # Output only. Private auction ID if this proposal is a private auction
- # proposal.
+ "proposalRevision": "A String", # Output only. The revision number for the proposal.
+ # Each update to the proposal or the deal causes the proposal revision number
+ # to auto-increment. The buyer keeps track of the last revision number they
+ # know of and pass it in when making an update. If the head revision number
+ # on the server has since incremented, then an ABORTED error is returned
+ # during the update operation to let the buyer know that a subsequent update
+ # was made.
"originatorRole": "A String", # Output only. Indicates whether the buyer/seller created the proposal.
- "lastUpdaterOrCommentorRole": "A String", # Output only. The role of the last user that either updated the proposal or
- # left a comment.
- "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Private data for buyer. (hidden from seller).
- "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
- # operations (max-length: 1024 unicode code units).
- },
- "displayName": "A String", # The name for the proposal.
- "buyerContacts": [ # Contact information for the buyer.
- { # 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.
- },
- ],
- "billedBuyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Output only. Reference to the buyer that will get billed for this proposal.
- # Authorized Buyers account ID.
- "accountId": "A String", # Authorized Buyers account ID of the buyer.
- },
- "updateTime": "A String", # Output only. The time when the proposal was last revised.
- "proposalId": "A String", # Output only. The unique ID of the proposal.
"deals": [ # The deals associated with this proposal. For Private Auction proposals
# (whose deals have NonGuaranteedAuctionTerms), there will only be one deal.
{ # A deal represents a segment of inventory for displaying ads on.
# A proposal can contain multiple deals. A deal contains the terms and
# targeting information that is used for serving.
+ "dealId": "A String", # Output only. A unique deal ID for the deal (server-assigned).
+ "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
+ # deal.
+ "createTime": "A String", # Output only. The time of the deal creation.
"programmaticCreativeSource": "A String", # Output only. Specifies the creative source for programmatic deals.
# PUBLISHER means creative is provided by seller and ADVERTISER means
# creative is provided by buyer.
- "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Buyer private data (hidden from seller).
- "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
- # operations (max-length: 1024 unicode code units).
- },
- "displayName": "A String", # The name of the deal.
- "webPropertyCode": "A String", # The web property code for the seller copied over from the product.
- "updateTime": "A String", # Output only. The time when the deal was last updated.
"targetingCriterion": [ # The shared targeting visible to buyers and sellers. Each shared
# targeting entity is AND'd together.
{ # Advertisers can target different attributes of an ad slot. For example,
@@ -6588,36 +6541,6 @@
"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.
- "creativeSizeValue": { # Specifies the size of the creative. # The creative size value to include/exclude.
- # Filled in when key = GOOG_CREATIVE_SIZE
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- "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",
- ],
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- ],
- "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.
- "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
- # only if creative_size_type = CreativeSizeType.NATIVE.
- },
- "stringValue": "A String", # The string value to include/exclude.
- "longValue": "A String", # The long value to include/exclude.
"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
@@ -6626,34 +6549,135 @@
"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.
- "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`.
- "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
- "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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
- "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.
- },
- "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`.
- "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.
"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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
"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.
},
+ "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`.
+ "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "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.
+ "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.
+ },
+ "dayOfWeek": "A String", # The day of the week to target. If unspecified, applicable to all days.
},
],
},
+ "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
+ "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
+ # only if creative_size_type = CreativeSizeType.NATIVE.
+ "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.
+ },
+ "creativeSizeType": "A String", # The creative size type.
+ "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.
+ "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.
+ },
+ ],
+ },
+ "stringValue": "A String", # The string value to include/exclude.
+ },
+ ],
+ "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.
+ "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.
+ "timeZoneType": "A String", # The timezone to use for interpreting the day part targeting.
+ "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.
+ "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`.
+ "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "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.
+ "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.
+ },
+ "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`.
+ "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+ "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.
+ "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.
+ },
+ "dayOfWeek": "A String", # The day of the week to target. If unspecified, applicable to all days.
+ },
+ ],
+ },
+ "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
+ "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
+ # only if creative_size_type = CreativeSizeType.NATIVE.
+ "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.
+ },
+ "creativeSizeType": "A String", # The creative size type.
+ "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.
+ "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.
+ },
+ ],
+ },
+ "stringValue": "A String", # The string value to include/exclude.
},
],
"key": "A String", # The key representing the shared targeting criterion.
@@ -6661,120 +6685,56 @@
# 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.
- "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.
- "creativeSizeValue": { # Specifies the size of the creative. # The creative size value to include/exclude.
- # Filled in when key = GOOG_CREATIVE_SIZE
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- "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",
- ],
- "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.
- "height": 42, # The height of the creative.
- "width": 42, # The width of the creative
- },
- ],
- "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.
- "nativeTemplate": "A String", # Output only. The native template for this creative. It will have a value
- # only if creative_size_type = CreativeSizeType.NATIVE.
- },
- "stringValue": "A String", # The string value to include/exclude.
- "longValue": "A String", # The long value to include/exclude.
- "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.
- "timeZoneType": "A String", # The timezone to use for interpreting the day part targeting.
- "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.
- "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`.
- "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
- "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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
- "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.
- },
- "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`.
- "minutes": 42, # Minutes of hour of day. Must be from 0 to 59.
- "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.
- "nanos": 42, # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
- "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.
- },
- },
- ],
- },
+ },
+ ],
+ "creativeRestrictions": { # Represents creative restrictions associated to Programmatic Guaranteed/ # Output only. Restricitions about the creatives associated with the deal
+ # (i.e., size) This is available for Programmatic Guaranteed/Preferred Deals
+ # in Ad Manager.
+ # Preferred Deal in Ad Manager.
+ # This doesn't apply to Private Auction and AdX Preferred Deals.
+ "skippableAdType": "A String", # Skippable video ads allow viewers to skip ads after 5 seconds.
+ "creativeFormat": "A String", # The format of the environment that the creatives will be displayed in.
+ "creativeSpecifications": [
+ { # Represents information for a creative that is associated with a Programmatic
+ # Guaranteed/Preferred Deal in Ad Manager.
+ "creativeSize": { # Represents size of a single ad slot, or a creative. # The size of the creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
},
- ],
+ "creativeCompanionSizes": [ # Companion sizes may be filled in only when this is a video creative.
+ { # Represents size of a single ad slot, or a creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
+ },
+ ],
+ },
+ ],
+ },
+ "dealServingMetadata": { # Message captures metadata about the serving status of a deal. # Output only. Metadata about the serving status of this deal.
+ "dealPauseStatus": { # Tracks which parties (if any) have paused a deal. # Output only. Tracks which parties (if any) have paused a deal.
+ # The deal is considered paused if either hasBuyerPaused or
+ # hasSellPaused is true.
+ "firstPausedBy": "A String", # The role of the person who first paused this deal.
+ "hasBuyerPaused": True or False, # True, if the buyer has paused the deal unilaterally.
+ "buyerPauseReason": "A String", # The buyer's reason for pausing, if the buyer paused the deal.
+ "sellerPauseReason": "A String", # The seller's reason for pausing, if the seller paused the deal.
+ "hasSellerPaused": True or False, # True, if the seller has paused the deal unilaterally.
},
- ],
- "dealId": "A String", # Output only. A unique deal ID for the deal (server-assigned).
- "proposalId": "A String", # Output only. ID of the proposal that this deal is part of.
- "availableEndTime": "A String", # Proposed flight end time of the deal.
- # This will generally be stored in a granularity of a second.
- # A value is not required for Private Auction deals or Preferred Deals.
- "syndicationProduct": "A String", # The syndication product associated with the deal.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "createProductId": "A String", # The product ID from which this deal was created.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "creativeSafeFrameCompatibility": "A String", # Output only. Specifies whether the creative is safeFrame compatible.
- "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
- # deal.
- "createProductRevision": "A String", # Optional revision number of the product that the deal was created from.
- # If present on create, and the server `product_revision` has advanced sinced
- # the passed-in `create_product_revision`, an `ABORTED` error will be
- # returned.
- #
- # Note: This field may be set only when creating the resource. Modifying
- # this field while updating the resource will result in an error.
- "sellerContacts": [ # Output only. Seller contact information for the deal.
- { # 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.
- },
- ],
- "availableStartTime": "A String", # Optional proposed flight start time of the deal.
- # This will generally be stored in the granularity of one second since deal
- # serving starts at seconds boundary. Any time specified with more
- # granularity (e.g., in milliseconds) will be truncated towards the start of
- # time in seconds.
- "createTime": "A String", # Output only. The time of the deal creation.
+ },
"dealTerms": { # 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.
- "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.
+ "guaranteedFixedPriceTerms": { # Terms for Programmatic Guaranteed Deals. # The terms for guaranteed fixed price deals.
+ "guaranteedLooks": "A String", # Count of guaranteed looks. Required for deal, optional for product.
+ "guaranteedImpressions": "A String", # Guaranteed impressions as a percentage. This is the percentage
+ # of guaranteed looks that the buyer is guaranteeing to buy.
+ "minimumDailyLooks": "A String", # Daily minimum looks for CPD deal types.
"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
@@ -6782,24 +6742,24 @@
# 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.
+ "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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
"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.
},
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
},
- "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",
- ],
"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).
@@ -6809,6 +6769,11 @@
},
],
},
+ "description": "A String", # Publisher provided description for the terms.
+ "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.
"nonGuaranteedAuctionTerms": { # Terms for Private Auctions. Note that Private Auctions can be created only # The terms for non-guaranteed auction deals.
@@ -6822,24 +6787,60 @@
# 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.
+ "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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
"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.
},
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
},
+ "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.
+ },
+ },
+ ],
+ },
+ "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.
"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.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+ "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.
+ "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ },
+ },
"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).
@@ -6851,152 +6852,34 @@
},
"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.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
+ "units": "A String", # The whole units of the amount.
+ # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
"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.
},
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
},
"brandingType": "A String", # Visibility of the URL in bid requests. (default: BRANDED)
- "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.
- "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.
- "minimumDailyLooks": "A String", # Daily minimum looks for CPD deal types.
- "guaranteedLooks": "A String", # Count of guaranteed looks. Required for deal, optional for product.
- "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.
- "price": { # Represents a price and a pricing type for a product / deal. # The specified price.
- "amount": { # Represents an amount of money with its currency type. # The actual price with currency specified.
- "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
- "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.
- },
- "pricingType": "A String", # The pricing type for the deal/product. (default: CPM)
- },
- "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",
- ],
- "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.
- },
- },
- ],
- },
},
+ "externalDealId": "A String", # Output only. 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.
+ "createProductId": "A String", # The product ID from which this deal was created.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ "updateTime": "A String", # Output only. The time when the deal was last updated.
+ "proposalId": "A String", # Output only. ID of the proposal that this deal is part of.
"targeting": { # Targeting represents different criteria that can be used by advertisers to # Output only. Specifies the subset of inventory targeted by the deal.
# target ad inventory. For example, they can choose to target ad requests only
# if the user is in the US.
# Multiple types of targeting are always applied as a logical AND, unless noted
# otherwise.
- "geoTargeting": { # Generic targeting used for targeting dimensions that contains a list of # Geo criteria IDs to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- "inventorySizeTargeting": { # Represents the size of an ad unit that can be targeted on an ad # Inventory sizes to be included/excluded.
- # request. It only applies to Private Auction, AdX Preferred Deals and
- # Auction Packages. This targeting does not apply to Programmatic Guaranteed
- # and Preferred Deals in Ad Manager.
- "targetedInventorySizes": [ # A list of inventory sizes to be included.
- { # Represents size of a single ad slot, or a creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- ],
- "excludedInventorySizes": [ # A list of inventory sizes to be excluded.
- { # Represents size of a single ad slot, or a creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- ],
- },
- "videoTargeting": { # Represents targeting information about video. # Video targeting information.
- "targetedPositionTypes": [ # A list of video positions to be included.
- # When the included list is present, the excluded list must be empty.
- # When the excluded list is present, the included list must be empty.
- "A String",
- ],
- "excludedPositionTypes": [ # A list of video positions to be excluded.
- # Position types can either be included or excluded (XOR).
- "A String",
- ],
- },
- "technologyTargeting": { # Represents targeting about various types of technology. # Technology targeting information, e.g., operating system, device category.
- "deviceCapabilityTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device capabilities to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- "operatingSystemTargeting": { # Represents targeting information for operating systems. # Operating system related targeting information.
- "operatingSystemCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating systems to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- "operatingSystemVersionCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating system versions to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- },
- "deviceCategoryTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device categories to be included/excluded.
- # included and excluded numeric IDs.
- "targetedCriteriaIds": [ # A list of numeric IDs to be included.
- "A String",
- ],
- "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
- "A String",
- ],
- },
- },
"placementTargeting": { # Represents targeting about where the ads can appear, e.g., certain sites or # Placement targeting information, e.g., URL, mobile applications.
# mobile applications.
# Different placement targeting types will be logically OR'ed.
@@ -7005,10 +6888,10 @@
# excluded.
# For Programmatic Guaranteed and Preferred Deals, this doesn't
# apply.
- "targetedUrls": [ # A list of URLs to be included.
+ "excludedUrls": [ # A list of URLs to be excluded.
"A String",
],
- "excludedUrls": [ # A list of URLs to be excluded.
+ "targetedUrls": [ # A list of URLs to be included.
"A String",
],
},
@@ -7022,84 +6905,155 @@
# Google Play Store URL.
# iOS App ID (which is a number) can be found at the end of iTunes store URL.
# First party mobile applications is either included or excluded.
- "targetedAppIds": [ # A list of application IDs to be included.
+ "excludedAppIds": [ # A list of application IDs to be excluded.
"A String",
],
- "excludedAppIds": [ # A list of application IDs to be excluded.
+ "targetedAppIds": [ # A list of application IDs to be included.
"A String",
],
},
},
},
+ "inventorySizeTargeting": { # Represents the size of an ad unit that can be targeted on an ad # Inventory sizes to be included/excluded.
+ # request. It only applies to Private Auction, AdX Preferred Deals and
+ # Auction Packages. This targeting does not apply to Programmatic Guaranteed
+ # and Preferred Deals in Ad Manager.
+ "targetedInventorySizes": [ # A list of inventory sizes to be included.
+ { # Represents size of a single ad slot, or a creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
+ },
+ ],
+ "excludedInventorySizes": [ # A list of inventory sizes to be excluded.
+ { # Represents size of a single ad slot, or a creative.
+ "width": "A String", # The width of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "height": "A String", # The height of the ad slot in pixels.
+ # This field will be present only when size type is `PIXEL`.
+ "sizeType": "A String", # The size type of the ad slot.
+ },
+ ],
+ },
+ "geoTargeting": { # Generic targeting used for targeting dimensions that contains a list of # Geo criteria IDs to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ "technologyTargeting": { # Represents targeting about various types of technology. # Technology targeting information, e.g., operating system, device category.
+ "operatingSystemTargeting": { # Represents targeting information for operating systems. # Operating system related targeting information.
+ "operatingSystemVersionCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating system versions to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ "operatingSystemCriteria": { # Generic targeting used for targeting dimensions that contains a list of # IDs of operating systems to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ },
+ "deviceCapabilityTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device capabilities to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ "deviceCategoryTargeting": { # Generic targeting used for targeting dimensions that contains a list of # IDs of device categories to be included/excluded.
+ # included and excluded numeric IDs.
+ "excludedCriteriaIds": [ # A list of numeric IDs to be excluded.
+ "A String",
+ ],
+ "targetedCriteriaIds": [ # A list of numeric IDs to be included.
+ "A String",
+ ],
+ },
+ },
+ "videoTargeting": { # Represents targeting information about video. # Video targeting information.
+ "targetedPositionTypes": [ # A list of video positions to be included.
+ # When the included list is present, the excluded list must be empty.
+ # When the excluded list is present, the included list must be empty.
+ "A String",
+ ],
+ "excludedPositionTypes": [ # A list of video positions to be excluded.
+ # Position types can either be included or excluded (XOR).
+ "A String",
+ ],
+ },
},
- "creativePreApprovalPolicy": "A String", # Output only. Specifies the creative pre-approval policy.
+ "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Buyer private data (hidden from seller).
+ "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
+ # operations (max-length: 1024 unicode code units).
+ },
"deliveryControl": { # Message contains details about how the deals will be paced. # 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.
- "deliveryRateType": "A String", # Output only. Specifies how the impression delivery will be paced.
"frequencyCaps": [ # Output only. Specifies any frequency caps.
{ # Frequency cap.
- "numTimeUnits": 42, # The amount of time, in the units specified by time_unit_type. Defines the
- # amount of time over which impressions per user are counted and capped.
"maxImpressions": 42, # The maximum number of impressions that can be served to a user within the
# specified time period.
"timeUnitType": "A String", # The time unit. Along with num_time_units defines the amount of time over
# which impressions per user are counted and capped.
+ "numTimeUnits": 42, # The amount of time, in the units specified by time_unit_type. Defines the
+ # amount of time over which impressions per user are counted and capped.
},
],
"creativeBlockingLevel": "A String", # Output only. Specified the creative blocking levels to be applied.
+ "deliveryRateType": "A String", # Output only. Specifies how the impression delivery will be paced.
},
- "externalDealId": "A String", # Output only. 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.
- "creativeRestrictions": { # Represents creative restrictions associated to Programmatic Guaranteed/ # Output only. Restricitions about the creatives associated with the deal
- # (i.e., size) This is available for Programmatic Guaranteed/Preferred Deals
- # in Ad Manager.
- # Preferred Deal in Ad Manager.
- # This doesn't apply to Private Auction and AdX Preferred Deals.
- "creativeFormat": "A String", # The format of the environment that the creatives will be displayed in.
- "creativeSpecifications": [
- { # Represents information for a creative that is associated with a Programmatic
- # Guaranteed/Preferred Deal in Ad Manager.
- "creativeSize": { # Represents size of a single ad slot, or a creative. # The size of the creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- "creativeCompanionSizes": [ # Companion sizes may be filled in only when this is a video creative.
- { # Represents size of a single ad slot, or a creative.
- "width": "A String", # The width of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- "sizeType": "A String", # The size type of the ad slot.
- "height": "A String", # The height of the ad slot in pixels.
- # This field will be present only when size type is `PIXEL`.
- },
- ],
- },
- ],
- "skippableAdType": "A String", # Skippable video ads allow viewers to skip ads after 5 seconds.
- },
- "dealServingMetadata": { # Message captures metadata about the serving status of a deal. # Output only. Metadata about the serving status of this deal.
- "dealPauseStatus": { # Tracks which parties (if any) have paused a deal. # Output only. Tracks which parties (if any) have paused a deal.
- # The deal is considered paused if either hasBuyerPaused or
- # hasSellPaused is true.
- "firstPausedBy": "A String", # The role of the person who first paused this deal.
- "sellerPauseReason": "A String", # The seller's reason for pausing, if the seller paused the deal.
- "hasSellerPaused": True or False, # True, if the seller has paused the deal unilaterally.
- "buyerPauseReason": "A String", # The buyer's reason for pausing, if the buyer paused the deal.
- "hasBuyerPaused": True or False, # True, if the buyer has paused the deal unilaterally.
+ "availableEndTime": "A String", # Proposed flight end time of the deal.
+ # This will generally be stored in a granularity of a second.
+ # A value is not required for Private Auction deals or Preferred Deals.
+ "availableStartTime": "A String", # Optional proposed flight start time of the deal.
+ # This will generally be stored in the granularity of one second since deal
+ # serving starts at seconds boundary. Any time specified with more
+ # granularity (e.g., in milliseconds) will be truncated towards the start of
+ # time in seconds.
+ "displayName": "A String", # The name of the deal.
+ "creativeSafeFrameCompatibility": "A String", # Output only. Specifies whether the creative is safeFrame compatible.
+ "createProductRevision": "A String", # Optional revision number of the product that the deal was created from.
+ # If present on create, and the server `product_revision` has advanced sinced
+ # the passed-in `create_product_revision`, an `ABORTED` error will be
+ # returned.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ "creativePreApprovalPolicy": "A String", # Output only. Specifies the creative pre-approval policy.
+ "webPropertyCode": "A String", # The web property code for the seller copied over from the product.
+ "sellerContacts": [ # Output only. Seller contact information for the deal.
+ { # Contains information on how a buyer or seller can be reached.
+ "name": "A String", # The name of the contact.
+ "email": "A String", # Email address for the contact.
},
- },
+ ],
"description": "A String", # Description for the deal terms.
+ "syndicationProduct": "A String", # The syndication product associated with the deal.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
},
],
- "proposalRevision": "A String", # Output only. The revision number for the proposal.
- # Each update to the proposal or the deal causes the proposal revision number
- # to auto-increment. The buyer keeps track of the last revision number they
- # know of and pass it in when making an update. If the head revision number
- # on the server has since incremented, then an ABORTED error is returned
- # during the update operation to let the buyer know that a subsequent update
- # was made.
+ "billedBuyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Output only. Reference to the buyer that will get billed for this proposal.
+ # Authorized Buyers account ID.
+ "accountId": "A String", # Authorized Buyers account ID of the buyer.
+ },
+ "displayName": "A String", # The name for the proposal.
"seller": { # Represents a seller of inventory. Each seller is identified by a unique # Reference to the seller on the proposal.
#
# Note: This field may be set only when creating the resource. Modifying
@@ -7109,6 +7063,52 @@
"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.
},
+ "updateTime": "A String", # Output only. The time when the proposal was last revised.
+ "proposalId": "A String", # Output only. The unique ID of the proposal.
+ "isRenegotiating": True or False, # Output only. True if the proposal is being renegotiated.
+ "proposalState": "A String", # Output only. The current state of the proposal.
+ "notes": [ # Output only. The notes associated with this proposal.
+ { # A proposal may be associated to several notes.
+ "noteId": "A String", # Output only. The unique ID for the note.
+ "creatorRole": "A String", # Output only. The role of the person (buyer/seller) creating the note.
+ "proposalRevision": "A String", # Output only. The revision number of the proposal when the note is created.
+ "createTime": "A String", # Output only. The timestamp for when this note was created.
+ "note": "A String", # The actual note to attach.
+ # (max-length: 1024 unicode code units)
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ },
+ ],
+ "sellerContacts": [ # Output only. Contact information for the seller.
+ { # Contains information on how a buyer or seller can be reached.
+ "name": "A String", # The name of the contact.
+ "email": "A String", # Email address for the contact.
+ },
+ ],
+ "buyerPrivateData": { # Buyers are allowed to store certain types of private data in a proposal/deal. # Private data for buyer. (hidden from seller).
+ "referenceId": "A String", # A buyer or seller specified reference ID. This can be queried in the list
+ # operations (max-length: 1024 unicode code units).
+ },
+ "buyerContacts": [ # Contact information for the buyer.
+ { # Contains information on how a buyer or seller can be reached.
+ "name": "A String", # The name of the contact.
+ "email": "A String", # Email address for the contact.
+ },
+ ],
+ "privateAuctionId": "A String", # Output only. Private auction ID if this proposal is a private auction
+ # proposal.
+ "isSetupComplete": True or False, # Output only. True, if the buyside inventory setup is complete for this
+ # proposal.
+ "buyer": { # Represents a buyer of inventory. Each buyer is identified by a unique # Reference to the buyer on the proposal.
+ #
+ # Note: This field may be set only when creating the resource. Modifying
+ # this field while updating the resource will result in an error.
+ # Authorized Buyers account ID.
+ "accountId": "A String", # Authorized Buyers account ID of the buyer.
+ },
+ "lastUpdaterOrCommentorRole": "A String", # Output only. The role of the last user that either updated the proposal or
+ # left a comment.
}</pre>
</div>