--- title: "PUT /v2beta1/accounts/{accountId}/proposals/{proposalId}" method: PUT path: "/v2beta1/accounts/{accountId}/proposals/{proposalId}" tags: ["accounts"] --- # PUT /v2beta1/accounts/{accountId}/proposals/{proposalId} `PUT /v2beta1/accounts/{accountId}/proposals/{proposalId}` Update the given proposal at the client known revision number. If the server revision has advanced since the passed-in `proposal.proposal_revision`, an `ABORTED` error message will be returned. Only the buyer-modifiable fields of the proposal will be updated. Note that the deals in the proposal will be updated to match the passed-in copy. If a passed-in deal does not have a `deal_id`, the server will assign a new unique ID and create the deal. If passed-in deal has a `deal_id`, it will be updated to match the passed-in copy. Any existing deals not present in the passed-in proposal will be deleted. It is an error to pass in a deal with a `deal_id` not present at head. ## Path parameters - `accountId` string, required - `proposalId` string, required ## Request body - Proposal — Represents a proposal in the Marketplace. A proposal is the unit of negotiation between a seller and a buyer and contains deals which are served. Note: You can't update, create, or otherwise modify Private Auction deals through the API. Fields are updatable unless noted otherwise. - `deals` Deal[] — The deals associated with this proposal. For Private Auction proposals (whose deals have NonGuaranteedAuctionTerms), there will only be one deal. - `programmaticCreativeSource` 'PROGRAMMATIC_CREATIVE_SOURCE_UNSPECIFIED' | 'ADVERTISER' | 'PUBLISHER' — Output only. Specifies the creative source for programmatic deals. PUBLISHER means creative is provided by seller and ADVERTISER means creative is provided by buyer. - `targeting` MarketplaceTargeting — Targeting represents different criteria that can be used by advertisers to 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. - `placementTargeting` PlacementTargeting — Represents targeting about where the ads can appear, for example, certain sites or mobile applications. Different placement targeting types will be logically OR'ed. - `urlTargeting` UrlTargeting — Represents a list of targeted and excluded URLs (for example, google.com). For Private Auction and AdX Preferred Deals, URLs are either included or excluded. For Programmatic Guaranteed and Preferred Deals, this doesn't apply. - `targetedUrls` string[] — A list of URLs to be included. - `excludedUrls` string[] — A list of URLs to be excluded. - `mobileApplicationTargeting` MobileApplicationTargeting — Mobile application targeting settings. - `firstPartyTargeting` FirstPartyMobileApplicationTargeting — Represents a list of targeted and excluded mobile application IDs that publishers own. Mobile application IDs are from App Store and Google Play Store. Android App ID, for example, com.google.android.apps.maps, can be found in 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` string[] — A list of application IDs to be included. - `excludedAppIds` string[] — A list of application IDs to be excluded. - `inventorySizeTargeting` InventorySizeTargeting — Represents the size of an ad unit that can be targeted on an ad 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. - `excludedInventorySizes` AdSize[] — A list of inventory sizes to be excluded. - `height` string, int64 — The height of the ad slot in pixels. This field will be present only when size type is `PIXEL`. - `sizeType` 'SIZE_TYPE_UNSPECIFIED' | 'PIXEL' | 'INTERSTITIAL' | 'NATIVE' | 'FLUID' — The size type of the ad slot. - `width` string, int64 — The width of the ad slot in pixels. This field will be present only when size type is `PIXEL`. - `targetedInventorySizes` AdSize[] — A list of inventory sizes to be included. - `height` string, int64 — The height of the ad slot in pixels. This field will be present only when size type is `PIXEL`. - `sizeType` 'SIZE_TYPE_UNSPECIFIED' | 'PIXEL' | 'INTERSTITIAL' | 'NATIVE' | 'FLUID' — The size type of the ad slot. - `width` string, int64 — The width of the ad slot in pixels. This field will be present only when size type is `PIXEL`. - `geoTargeting` CriteriaTargeting — Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. - `excludedCriteriaIds` string[] — A list of numeric IDs to be excluded. - `targetedCriteriaIds` string[] — A list of numeric IDs to be included. - `technologyTargeting` TechnologyTargeting — Represents targeting about various types of technology. - `deviceCapabilityTargeting` CriteriaTargeting — Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. - `excludedCriteriaIds` string[] — A list of numeric IDs to be excluded. - `targetedCriteriaIds` string[] — A list of numeric IDs to be included. - `operatingSystemTargeting` OperatingSystemTargeting — Represents targeting information for operating systems. - `operatingSystemVersionCriteria` CriteriaTargeting — Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. - `excludedCriteriaIds` string[] — A list of numeric IDs to be excluded. - `targetedCriteriaIds` string[] — A list of numeric IDs to be included. - `operatingSystemCriteria` CriteriaTargeting — Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. - `excludedCriteriaIds` string[] — A list of numeric IDs to be excluded. - `targetedCriteriaIds` string[] — A list of numeric IDs to be included. - `deviceCategoryTargeting` CriteriaTargeting — Generic targeting used for targeting dimensions that contains a list of included and excluded numeric IDs. - `excludedCriteriaIds` string[] — A list of numeric IDs to be excluded. - `targetedCriteriaIds` string[] — A list of numeric IDs to be included. - `videoTargeting` VideoTargeting — Represents targeting information about video. - `targetedPositionTypes` string[] — 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. - `excludedPositionTypes` string[] — A list of video positions to be excluded. Position types can either be included or excluded (XOR). - `creativePreApprovalPolicy` 'CREATIVE_PRE_APPROVAL_POLICY_UNSPECIFIED' | 'SELLER_PRE_APPROVAL_REQUIRED' | 'SELLER_PRE_APPROVAL_NOT_REQUIRED' — Output only. Specifies the creative pre-approval policy. - `creativeRestrictions` CreativeRestrictions — Represents creative restrictions associated to Programmatic Guaranteed/ Preferred Deal in Ad Manager. This doesn't apply to Private Auction and AdX Preferred Deals. - `creativeSpecifications` CreativeSpecification[] - `creativeSize` AdSize — Represents size of a single ad slot, or a creative. - `height` string, int64 — The height of the ad slot in pixels. This field will be present only when size type is `PIXEL`. - `sizeType` 'SIZE_TYPE_UNSPECIFIED' | 'PIXEL' | 'INTERSTITIAL' | 'NATIVE' | 'FLUID' — The size type of the ad slot. - `width` string, int64 — The width of the ad slot in pixels. This field will be present only when size type is `PIXEL`. - `creativeCompanionSizes` AdSize[] — Companion sizes may be filled in only when this is a video creative. - `height` string, int64 — The height of the ad slot in pixels. This field will be present only when size type is `PIXEL`. - `sizeType` 'SIZE_TYPE_UNSPECIFIED' | 'PIXEL' | 'INTERSTITIAL' | 'NATIVE' | 'FLUID' — The size type of the ad slot. - `width` string, int64 — The width of the ad slot in pixels. This field will be present only when size type is `PIXEL`. - `creativeFormat` 'CREATIVE_FORMAT_UNSPECIFIED' | 'DISPLAY' | 'VIDEO' — The format of the environment that the creatives will be displayed in. - `skippableAdType` 'SKIPPABLE_AD_TYPE_UNSPECIFIED' | 'SKIPPABLE' | 'INSTREAM_SELECT' | 'NOT_SKIPPABLE' — Skippable video ads allow viewers to skip ads after 5 seconds. - `createProductRevision` string, int64 — Optional. Revision number of the product that the deal was created from. If present on create, and the server `product_revision` has advanced since 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. - `dealTerms` DealTerms — The deal terms specify the details of a Product/deal. They specify things like price per buyer, the type of pricing model (for example, fixed price, auction) and expected impressions from the publisher. - `nonGuaranteedAuctionTerms` NonGuaranteedAuctionTerms — Terms for Private Auctions. Note that Private Auctions can be created only by the seller, but they can be returned in a get or list request. - `reservePricesPerBuyer` PricePerBuyer[] — Reserve price for the specified buyer. - `advertiserIds` string[] — The list of advertisers for this price when associated with this buyer. If empty, all advertisers with this buyer pay this price. - `buyer` Buyer — Represents a buyer of inventory. Each buyer is identified by a unique Authorized Buyers account ID. - `accountId` string — Authorized Buyers account ID of the buyer. - `price` Price — Represents a price and a pricing type for a product / deal. - `pricingType` 'PRICING_TYPE_UNSPECIFIED' | 'COST_PER_MILLE' | 'COST_PER_DAY' — The pricing type for the deal/product. (default: CPM) - `amount` Money — Represents an amount of money with its currency type. - … - `autoOptimizePrivateAuction` boolean — True if open auction buyers are allowed to compete with invited buyers in this private auction. - `estimatedGrossSpend` Price — Represents a price and a pricing type for a product / deal. - `pricingType` 'PRICING_TYPE_UNSPECIFIED' | 'COST_PER_MILLE' | 'COST_PER_DAY' — The pricing type for the deal/product. (default: CPM) - `amount` Money — Represents an amount of money with its currency type. - `currencyCode` string — The three-letter currency code defined in ISO 4217. - `nanos` integer — 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` string, int64 — The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar. - `sellerTimeZone` 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` GuaranteedFixedPriceTerms — Terms for Programmatic Guaranteed Deals. - `minimumDailyLooks` string, int64 — Daily minimum looks for CPD deal types. For CPD deals, buyer should negotiate on this field instead of guaranteed_looks. - `impressionCap` string, int64 — The lifetime impression cap for CPM sponsorship deals. The deal will stop serving when the cap is reached. - `percentShareOfVoice` string, int64 — For sponsorship deals, this is the percentage of the seller's eligible impressions that the deal will serve until the cap is reached. - `reservationType` 'RESERVATION_TYPE_UNSPECIFIED' | 'STANDARD' | 'SPONSORSHIP' — The reservation type for a Programmatic Guaranteed deal. This indicates whether the number of impressions is fixed, or a percent of available impressions. If not specified, the default reservation type is STANDARD. - `guaranteedImpressions` string, int64 — Guaranteed impressions as a percentage. This is the percentage of guaranteed looks that the buyer is guaranteeing to buy. - `guaranteedLooks` string, int64 — Count of guaranteed looks. Required for deal, optional for product. For CPD deals, buyer changes to guaranteed_looks will be ignored. - `fixedPrices` PricePerBuyer[] — Fixed price for the specified buyer. - `advertiserIds` string[] — The list of advertisers for this price when associated with this buyer. If empty, all advertisers with this buyer pay this price. - `buyer` Buyer — Represents a buyer of inventory. Each buyer is identified by a unique Authorized Buyers account ID. - `accountId` string — Authorized Buyers account ID of the buyer. - `price` Price — Represents a price and a pricing type for a product / deal. - `pricingType` 'PRICING_TYPE_UNSPECIFIED' | 'COST_PER_MILLE' | 'COST_PER_DAY' — The pricing type for the deal/product. (default: CPM) - `amount` Money — Represents an amount of money with its currency type. - … - `nonGuaranteedFixedPriceTerms` NonGuaranteedFixedPriceTerms — Terms for Preferred Deals. - `fixedPrices` PricePerBuyer[] — Fixed price for the specified buyer. - `advertiserIds` string[] — The list of advertisers for this price when associated with this buyer. If empty, all advertisers with this buyer pay this price. - `buyer` Buyer — Represents a buyer of inventory. Each buyer is identified by a unique Authorized Buyers account ID. - `accountId` string — Authorized Buyers account ID of the buyer. - `price` Price — Represents a price and a pricing type for a product / deal. - `pricingType` 'PRICING_TYPE_UNSPECIFIED' | 'COST_PER_MILLE' | 'COST_PER_DAY' — The pricing type for the deal/product. (default: CPM) - `amount` Money — Represents an amount of money with its currency type. - … - `brandingType` 'BRANDING_TYPE_UNSPECIFIED' | 'BRANDED' | 'SEMI_TRANSPARENT' — Visibility of the URL in bid requests. (default: BRANDED) - `estimatedImpressionsPerDay` string, int64 — Non-binding estimate of the impressions served per day. Can be set by buyer or seller. - `description` string — Publisher provided description for the terms. - `syndicationProduct` 'SYNDICATION_PRODUCT_UNSPECIFIED' | 'CONTENT' | 'MOBILE' | 'VIDEO' | 'GAMES' — 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. - `buyerPrivateData` PrivateData — Buyers are allowed to store certain types of private data in a proposal/deal. - `referenceId` string — A buyer or seller specified reference ID. This can be queried in the list operations (max-length: 1024 unicode code units). - `externalDealId` 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. - `createTime` string, google-datetime — Output only. The time of the deal creation. - `proposalId` string — Output only. ID of the proposal that this deal is part of. - `isSetupComplete` boolean — Output only. True, if the buyside inventory setup is complete for this deal. - `displayName` string — The name of the deal. - `availableStartTime` string, google-datetime — 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 (for example, in milliseconds) will be truncated towards the start of time in seconds. - `webPropertyCode` string — The web property code for the seller copied over from the product. - `creativeSafeFrameCompatibility` 'CREATIVE_SAFE_FRAME_COMPATIBILITY_UNSPECIFIED' | 'COMPATIBLE' | 'INCOMPATIBLE' — Output only. Specifies whether the creative is safeFrame compatible. - `deliveryControl` DeliveryControl — Message contains details about how the deals will be paced. - `creativeBlockingLevel` 'CREATIVE_BLOCKING_LEVEL_UNSPECIFIED' | 'PUBLISHER_BLOCKING_RULES' | 'ADX_POLICY_BLOCKING_ONLY' — Output only. Specified the creative blocking levels to be applied. - `deliveryRateType` 'DELIVERY_RATE_TYPE_UNSPECIFIED' | 'EVENLY' | 'FRONT_LOADED' | 'AS_FAST_AS_POSSIBLE' — Output only. Specifies how the impression delivery will be paced. - `frequencyCaps` FrequencyCap[] — Output only. Specifies any frequency caps. - `numTimeUnits` integer — 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. - `timeUnitType` 'TIME_UNIT_TYPE_UNSPECIFIED' | 'MINUTE' | 'HOUR' | 'DAY' | 'WEEK' | 'MONTH' | 'LIFETIME' | 'POD' | 'STREAM' — The time unit. Along with num_time_units defines the amount of time over which impressions per user are counted and capped. - `maxImpressions` integer — The maximum number of impressions that can be served to a user within the specified time period. - `availableEndTime` string, google-datetime — 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. - `dealId` string — Output only. A unique deal ID for the deal (server-assigned). - `description` string — Description for the deal terms. - `sellerContacts` ContactInformation[] — Output only. Seller contact information for the deal. - `email` string — Email address for the contact. - `name` string — The name of the contact. - `targetingCriterion` TargetingCriteria[] — The shared targeting visible to buyers and sellers. Each shared targeting entity is AND'd together. - `key` string — The key representing the shared targeting criterion. Targeting criteria defined by Google ad servers will begin with GOOG_. Third parties may define their own keys. A list of permissible keys along with the acceptable values will be provided as part of the external documentation. - `exclusions` TargetingValue[] — The list of values to exclude from targeting. Each value is AND'd together. - `creativeSizeValue` CreativeSize — Specifies the size of the creative. - `companionSizes` Size[] — For video creatives specifies the sizes of companion ads (if present). Companion sizes may be filled in only when creative_size_type = VIDEO - `width` integer — The width of the creative - `height` integer — The height of the creative. - `creativeSizeType` 'CREATIVE_SIZE_TYPE_UNSPECIFIED' | 'REGULAR' | 'INTERSTITIAL' | 'VIDEO' | 'NATIVE' — The creative size type. - `skippableAdType` 'SKIPPABLE_AD_TYPE_UNSPECIFIED' | 'GENERIC' | 'INSTREAM_SELECT' | 'NOT_SKIPPABLE' — The type of skippable ad for this creative. It will have a value only if creative_size_type = CreativeSizeType.VIDEO. - `allowedFormats` string[] — 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). - `nativeTemplate` 'UNKNOWN_NATIVE_TEMPLATE' | 'NATIVE_CONTENT_AD' | 'NATIVE_APP_INSTALL_AD' | 'NATIVE_VIDEO_CONTENT_AD' | 'NATIVE_VIDEO_APP_INSTALL_AD' — Output only. The native template for this creative. It will have a value only if creative_size_type = CreativeSizeType.NATIVE. - `size` Size — Message depicting the size of the creative. The units of width and height depend on the type of the targeting. - `width` integer — The width of the creative - `height` integer — The height of the creative. - `dayPartTargetingValue` DayPartTargeting — Specifies the day part targeting criteria. - `dayParts` DayPart[] — A list of day part targeting criterion. - `dayOfWeek` 'DAY_OF_WEEK_UNSPECIFIED' | 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY' — The day of the week to target. If unspecified, applicable to all days. - `startTime` TimeOfDay — Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. - … - `endTime` TimeOfDay — Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. - … - `timeZoneType` 'TIME_ZONE_SOURCE_UNSPECIFIED' | 'PUBLISHER' | 'USER' — The timezone to use for interpreting the day part targeting. - `longValue` string, int64 — The long value to include/exclude. - `stringValue` string — The string value to include/exclude. - `inclusions` TargetingValue[] — The list of value to include as part of the targeting. Each value is OR'd together. - `creativeSizeValue` CreativeSize — Specifies the size of the creative. - `companionSizes` Size[] — For video creatives specifies the sizes of companion ads (if present). Companion sizes may be filled in only when creative_size_type = VIDEO - `width` integer — The width of the creative - `height` integer — The height of the creative. - `creativeSizeType` 'CREATIVE_SIZE_TYPE_UNSPECIFIED' | 'REGULAR' | 'INTERSTITIAL' | 'VIDEO' | 'NATIVE' — The creative size type. - `skippableAdType` 'SKIPPABLE_AD_TYPE_UNSPECIFIED' | 'GENERIC' | 'INSTREAM_SELECT' | 'NOT_SKIPPABLE' — The type of skippable ad for this creative. It will have a value only if creative_size_type = CreativeSizeType.VIDEO. - `allowedFormats` string[] — 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). - `nativeTemplate` 'UNKNOWN_NATIVE_TEMPLATE' | 'NATIVE_CONTENT_AD' | 'NATIVE_APP_INSTALL_AD' | 'NATIVE_VIDEO_CONTENT_AD' | 'NATIVE_VIDEO_APP_INSTALL_AD' — Output only. The native template for this creative. It will have a value only if creative_size_type = CreativeSizeType.NATIVE. - `size` Size — Message depicting the size of the creative. The units of width and height depend on the type of the targeting. - `width` integer — The width of the creative - `height` integer — The height of the creative. - `dayPartTargetingValue` DayPartTargeting — Specifies the day part targeting criteria. - `dayParts` DayPart[] — A list of day part targeting criterion. - `dayOfWeek` 'DAY_OF_WEEK_UNSPECIFIED' | 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY' — The day of the week to target. If unspecified, applicable to all days. - `startTime` TimeOfDay — Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. - … - `endTime` TimeOfDay — Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. - … - `timeZoneType` 'TIME_ZONE_SOURCE_UNSPECIFIED' | 'PUBLISHER' | 'USER' — The timezone to use for interpreting the day part targeting. - `longValue` string, int64 — The long value to include/exclude. - `stringValue` string — The string value to include/exclude. - `updateTime` string, google-datetime — Output only. The time when the deal was last updated. - `dealServingMetadata` DealServingMetadata — Message captures metadata about the serving status of a deal. - `dealPauseStatus` DealPauseStatus — Tracks which parties (if any) have paused a deal. The deal is considered paused if either hasBuyerPaused or hasSellPaused is true. - `sellerPauseReason` string — The seller's reason for pausing, if the seller paused the deal. - `firstPausedBy` 'BUYER_SELLER_ROLE_UNSPECIFIED' | 'BUYER' | 'SELLER' — The role of the person who first paused this deal. - `buyerPauseReason` string — The buyer's reason for pausing, if the buyer paused the deal. - `hasSellerPaused` boolean — True, if the seller has paused the deal unilaterally. - `hasBuyerPaused` boolean — True, if the buyer has paused the deal unilaterally. - `createProductId` 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. - `proposalId` string — Output only. The unique ID of the proposal. - `proposalState` 'PROPOSAL_STATE_UNSPECIFIED' | 'PROPOSED' | 'BUYER_ACCEPTED' | 'SELLER_ACCEPTED' | 'CANCELED' | 'FINALIZED' — Output only. The current state of the proposal. - `sellerContacts` ContactInformation[] — Output only. Contact information for the seller. - `email` string — Email address for the contact. - `name` string — The name of the contact. - `termsAndConditions` string — Output only. The terms and conditions set by the publisher for this proposal. - `updateTime` string, google-datetime — Output only. The time when the proposal was last revised. - `buyerContacts` ContactInformation[] — Contact information for the buyer. - `email` string — Email address for the contact. - `name` string — The name of the contact. - `originatorRole` 'BUYER_SELLER_ROLE_UNSPECIFIED' | 'BUYER' | 'SELLER' — Output only. Indicates whether the buyer/seller created the proposal. - `seller` Seller — Represents a seller of inventory. Each seller is identified by a unique Ad Manager account ID. - `accountId` 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. - `subAccountId` string — Output only. Ad manager network code for the seller. - `buyerPrivateData` PrivateData — Buyers are allowed to store certain types of private data in a proposal/deal. - `referenceId` string — A buyer or seller specified reference ID. This can be queried in the list operations (max-length: 1024 unicode code units). - `buyer` Buyer — Represents a buyer of inventory. Each buyer is identified by a unique Authorized Buyers account ID. - `accountId` string — Authorized Buyers account ID of the buyer. - `lastUpdaterOrCommentorRole` 'BUYER_SELLER_ROLE_UNSPECIFIED' | 'BUYER' | 'SELLER' — Output only. The role of the last user that either updated the proposal or left a comment. - `billedBuyer` Buyer — Represents a buyer of inventory. Each buyer is identified by a unique Authorized Buyers account ID. - `accountId` string — Authorized Buyers account ID of the buyer. - `proposalRevision` string, int64 — 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. - `privateAuctionId` string — Output only. Private auction ID if this proposal is a private auction proposal. - `displayName` string — The name for the proposal. - `isRenegotiating` boolean — Output only. True if the proposal is being renegotiated. - `isSetupComplete` boolean — Output only. True, if the buyside inventory setup is complete for this proposal. - `notes` Note[] — Output only. The notes associated with this proposal. - `proposalRevision` string, int64 — Output only. The revision number of the proposal when the note is created. - `note` 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. - `creatorRole` 'BUYER_SELLER_ROLE_UNSPECIFIED' | 'BUYER' | 'SELLER' — Output only. The role of the person (buyer/seller) creating the note. - `noteId` string — Output only. The unique ID for the note. - `createTime` string, google-datetime — Output only. The timestamp for when this note was created. ## Response `200` Successful response --- [API](https://skmtc.net/google/apis/adexchangebuyer2.md) · [All operations](https://skmtc.net/google/apis/adexchangebuyer2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/adexchangebuyer2/revisions/ec45fdc03096/schema)