googleapis · gcf-merge-on-green · Mar 12, 2024 · Mar 12, 2024
@@ -44,7 +44,7 @@ defmodule GoogleApi.AuthorizedBuyersMarketplace.V1.Api.Bidders do
       *   `:quotaUser` (*type:* `String.t`) - Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
       *   `:uploadType` (*type:* `String.t`) - Legacy upload protocol for media (e.g. "media", "multipart").
       *   `:upload_protocol` (*type:* `String.t`) - Upload protocol for media (e.g. "raw", "multipart").
-      *   `:filter` (*type:* `String.t`) - Optional query string using the [Cloud API list filtering syntax](https://developers.google.com/authorized-buyers/apis/guides/v2/list-filters) Supported columns for filtering are: * deal.displayName * deal.dealType * deal.createTime * deal.updateTime * deal.flightStartTime * deal.flightEndTime * dealServingStatus
+      *   `:filter` (*type:* `String.t`) - Optional query string using the [Cloud API list filtering syntax](https://developers.google.com/authorized-buyers/apis/guides/list-filters) Supported columns for filtering are: * deal.displayName * deal.dealType * deal.createTime * deal.updateTime * deal.flightStartTime * deal.flightEndTime * deal.eligibleSeatIds * dealServingStatus
       *   `:orderBy` (*type:* `String.t`) - An optional query string to sort finalized deals using the [Cloud API sorting syntax](https://cloud.google.com/apis/design/design_patterns#sorting_order). If no sort order is specified, results will be returned in an arbitrary order. Supported columns for sorting are: * deal.displayName * deal.createTime * deal.updateTime * deal.flightStartTime * deal.flightEndTime * rtbMetrics.bidRequests7Days * rtbMetrics.bids7Days * rtbMetrics.adImpressions7Days * rtbMetrics.bidRate7Days * rtbMetrics.filteredBidRate7Days * rtbMetrics.mustBidRateCurrentMonth Example: 'deal.displayName, deal.updateTime desc'
       *   `:pageSize` (*type:* `integer()`) - Requested page size. The server may return fewer results than requested. If requested more than 500, the server will return 500 results per page. If unspecified, the server will pick a default page size of 100.
       *   `:pageToken` (*type:* `String.t`) - The page token as returned from ListFinalizedDealsResponse.

@@ -775,7 +775,7 @@ defmodule GoogleApi.AuthorizedBuyersMarketplace.V1.Api.Buyers do
       *   `:quotaUser` (*type:* `String.t`) - Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
       *   `:uploadType` (*type:* `String.t`) - Legacy upload protocol for media (e.g. "media", "multipart").
       *   `:upload_protocol` (*type:* `String.t`) - Upload protocol for media (e.g. "raw", "multipart").
-      *   `:filter` (*type:* `String.t`) - Query string using the [Filtering Syntax](https://developers.google.com/authorized-buyers/apis/guides/v2/list-filters) Supported fields for filtering are: * partnerClientId Use this field to filter the clients by the partnerClientId. For example, if the partnerClientId of the client is "1234", the value of this field should be `partnerClientId = "1234"`, in order to get only the client whose partnerClientId is "1234" in the response.
+      *   `:filter` (*type:* `String.t`) - Query string using the [Filtering Syntax](https://developers.google.com/authorized-buyers/apis/guides/list-filters) Supported fields for filtering are: * partnerClientId Use this field to filter the clients by the partnerClientId. For example, if the partnerClientId of the client is "1234", the value of this field should be `partnerClientId = "1234"`, in order to get only the client whose partnerClientId is "1234" in the response.
       *   `:pageSize` (*type:* `integer()`) - Requested page size. If left blank, a default page size of 500 will be applied.
       *   `:pageToken` (*type:* `String.t`) - A token identifying a page of results the server should return. Typically, this is the value of ListClientsResponse.nextPageToken returned from the previous call to the list method.
   *   `opts` (*type:* `keyword()`) - Call options
@@ -1513,7 +1513,7 @@ defmodule GoogleApi.AuthorizedBuyersMarketplace.V1.Api.Buyers do
       *   `:quotaUser` (*type:* `String.t`) - Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
       *   `:uploadType` (*type:* `String.t`) - Legacy upload protocol for media (e.g. "media", "multipart").
       *   `:upload_protocol` (*type:* `String.t`) - Upload protocol for media (e.g. "raw", "multipart").
-      *   `:filter` (*type:* `String.t`) - Optional query string using the [Cloud API list filtering syntax](https://developers.google.com/authorized-buyers/apis/guides/v2/list-filters) Supported columns for filtering are: * deal.displayName * deal.dealType * deal.createTime * deal.updateTime * deal.flightStartTime * deal.flightEndTime * dealServingStatus
+      *   `:filter` (*type:* `String.t`) - Optional query string using the [Cloud API list filtering syntax](https://developers.google.com/authorized-buyers/apis/guides/list-filters) Supported columns for filtering are: * deal.displayName * deal.dealType * deal.createTime * deal.updateTime * deal.flightStartTime * deal.flightEndTime * deal.eligibleSeatIds * dealServingStatus
       *   `:orderBy` (*type:* `String.t`) - An optional query string to sort finalized deals using the [Cloud API sorting syntax](https://cloud.google.com/apis/design/design_patterns#sorting_order). If no sort order is specified, results will be returned in an arbitrary order. Supported columns for sorting are: * deal.displayName * deal.createTime * deal.updateTime * deal.flightStartTime * deal.flightEndTime * rtbMetrics.bidRequests7Days * rtbMetrics.bids7Days * rtbMetrics.adImpressions7Days * rtbMetrics.bidRate7Days * rtbMetrics.filteredBidRate7Days * rtbMetrics.mustBidRateCurrentMonth Example: 'deal.displayName, deal.updateTime desc'
       *   `:pageSize` (*type:* `integer()`) - Requested page size. The server may return fewer results than requested. If requested more than 500, the server will return 500 results per page. If unspecified, the server will pick a default page size of 100.
       *   `:pageToken` (*type:* `String.t`) - The page token as returned from ListFinalizedDealsResponse.
@@ -2020,7 +2020,7 @@ defmodule GoogleApi.AuthorizedBuyersMarketplace.V1.Api.Buyers do
   end
 
   @doc """
-  Gets a proposal using its name. The proposal is returned at most recent revision. revision.
+  Gets a proposal using its resource name. The proposal is returned at the latest revision.
 
   ## Parameters
 
@@ -2092,7 +2092,7 @@ defmodule GoogleApi.AuthorizedBuyersMarketplace.V1.Api.Buyers do
   end
 
   @doc """
-  Lists proposals. A filter expression (list filter syntax) may be specified to filter the results. This will not list finalized versions of proposals that are being renegotiated; to retrieve these use the finalizedProposals resource.
+  Lists proposals. A filter expression using [Cloud API list filtering syntax](https://developers.google.com/authorized-buyers/apis/guides/list-filters) may be specified to filter the results.
 
   ## Parameters
 
@@ -2110,7 +2110,7 @@ defmodule GoogleApi.AuthorizedBuyersMarketplace.V1.Api.Buyers do
       *   `:quotaUser` (*type:* `String.t`) - Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
       *   `:uploadType` (*type:* `String.t`) - Legacy upload protocol for media (e.g. "media", "multipart").
       *   `:upload_protocol` (*type:* `String.t`) - Upload protocol for media (e.g. "raw", "multipart").
-      *   `:filter` (*type:* `String.t`) - Optional query string using the [Cloud API list filtering syntax](https://developers.google.com/authorized-buyers/apis/guides/v2/list-filters) Supported columns for filtering are: * displayName * dealType * updateTime * state
+      *   `:filter` (*type:* `String.t`) - Optional query string using the [Cloud API list filtering syntax](https://developers.google.com/authorized-buyers/apis/guides/list-filters) Supported columns for filtering are: * displayName * dealType * updateTime * state
       *   `:pageSize` (*type:* `integer()`) - Requested page size. The server may return fewer results than requested. If unspecified, the server will put a size of 500.
       *   `:pageToken` (*type:* `String.t`) - The page token as returned from ListProposalsResponse.
   *   `opts` (*type:* `keyword()`) - Call options
@@ -2170,7 +2170,7 @@ defmodule GoogleApi.AuthorizedBuyersMarketplace.V1.Api.Buyers do
   end
 
   @doc """
-  Updates the proposal at the given revision number. If the revision number in the request is behind the latest from the server, an error message will be returned. See FieldMask for how to use FieldMask. Only fields specified in the UpdateProposalRequest.update_mask will be updated; Fields noted as 'Immutable' or 'Output only' yet specified in the UpdateProposalRequest.update_mask will be ignored and left unchanged. Updating a private auction proposal is not allowed and will result in an error.
+  Updates the proposal at the given revision number. If the revision number in the request is behind the latest one kept in the server, an error message will be returned. See FieldMask for how to use FieldMask. Only fields specified in the UpdateProposalRequest.update_mask will be updated; Fields noted as 'Immutable' or 'Output only' yet specified in the UpdateProposalRequest.update_mask will be ignored and left unchanged. Updating a private auction proposal is not allowed and will result in an error.
 
   ## Parameters
 
@@ -2704,7 +2704,7 @@ defmodule GoogleApi.AuthorizedBuyersMarketplace.V1.Api.Buyers do
       *   `:quotaUser` (*type:* `String.t`) - Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
       *   `:uploadType` (*type:* `String.t`) - Legacy upload protocol for media (e.g. "media", "multipart").
       *   `:upload_protocol` (*type:* `String.t`) - Upload protocol for media (e.g. "raw", "multipart").
-      *   `:filter` (*type:* `String.t`) - Optional query string using the [Cloud API list filtering] (https://developers.google.com/authorized-buyers/apis/guides/v2/list-filters) syntax.
+      *   `:filter` (*type:* `String.t`) - Optional query string using the [Cloud API list filtering] (https://developers.google.com/authorized-buyers/apis/guides/list-filters) syntax.
       *   `:pageSize` (*type:* `integer()`) - Requested page size. The server may return fewer results than requested. If requested more than 500, the server will return 500 results per page. If unspecified, the server will pick a default page size of 100.
       *   `:pageToken` (*type:* `String.t`) - The page token as returned from a previous ListPublisherProfilesResponse.
   *   `opts` (*type:* `keyword()`) - Call options

@@ -20,7 +20,7 @@ defmodule GoogleApi.AuthorizedBuyersMarketplace.V1 do
   API client metadata for GoogleApi.AuthorizedBuyersMarketplace.V1.
   """
 
-  @discovery_revision "20220907"
+  @discovery_revision "20240311"
 
   def discovery_revision(), do: @discovery_revision
 end
@@ -21,18 +21,20 @@ defmodule GoogleApi.AuthorizedBuyersMarketplace.V1.Model.Deal do
 
   ## Attributes
 
-  *   `billedBuyer` (*type:* `String.t`, *default:* `nil`) - Output only. When the client field is populated, this field refers to the buyer who creates and manages the client buyer and gets billed on behalf of the client buyer; when the buyer field is populated, this field is the same value as buyer. Format : `buyers/{buyerAccountId}`
-  *   `buyer` (*type:* `String.t`, *default:* `nil`) - Output only. Refers to a buyer in The Realtime-bidding API. Format: `buyers/{buyerAccountId}`
+  *   `billedBuyer` (*type:* `String.t`, *default:* `nil`) - Output only. When the client field is populated, this field refers to the buyer who creates and manages the client buyer and gets billed on behalf of the client buyer; when the buyer field is populated, this field is the same value as buyer; when the deal belongs to a media planner account, this field will be empty. Format : `buyers/{buyerAccountId}`
+  *   `buyer` (*type:* `String.t`, *default:* `nil`) - Output only. Refers to a buyer in Real-time Bidding API's Buyer resource. Format: `buyers/{buyerAccountId}`
   *   `client` (*type:* `String.t`, *default:* `nil`) - Output only. Refers to a Client. Format: `buyers/{buyerAccountId}/clients/{clientAccountid}`
   *   `createTime` (*type:* `DateTime.t`, *default:* `nil`) - Output only. The time of the deal creation.
   *   `creativeRequirements` (*type:* `GoogleApi.AuthorizedBuyersMarketplace.V1.Model.CreativeRequirements.t`, *default:* `nil`) - Output only. Metadata about the creatives of this deal.
   *   `dealType` (*type:* `String.t`, *default:* `nil`) - Output only. Type of deal.
   *   `deliveryControl` (*type:* `GoogleApi.AuthorizedBuyersMarketplace.V1.Model.DeliveryControl.t`, *default:* `nil`) - Output only. Specifies the pacing set by the publisher.
   *   `description` (*type:* `String.t`, *default:* `nil`) - Output only. Free text description for the deal terms.
   *   `displayName` (*type:* `String.t`, *default:* `nil`) - Output only. The name of the deal. Maximum length of 255 unicode characters is allowed. Control characters are not allowed. Buyers cannot update this field. Note: Not to be confused with name, which is a unique identifier of the deal.
+  *   `eligibleSeatIds` (*type:* `list(String.t)`, *default:* `nil`) - Output only. If set, this field contains the list of DSP specific seat ids set by media planners that are eligible to transact on this deal. The seat ID is in the calling DSP's namespace.
   *   `estimatedGrossSpend` (*type:* `GoogleApi.AuthorizedBuyersMarketplace.V1.Model.Money.t`, *default:* `nil`) - Specified by buyers in request for proposal (RFP) to notify publisher the total estimated spend for the proposal. Publishers will receive this information and send back proposed deals accordingly.
   *   `flightEndTime` (*type:* `DateTime.t`, *default:* `nil`) - Proposed flight end time of the deal. This will generally be stored in a granularity of a second. A value is not necessary for Private Auction deals.
   *   `flightStartTime` (*type:* `DateTime.t`, *default:* `nil`) - 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.
+  *   `mediaPlanner` (*type:* `GoogleApi.AuthorizedBuyersMarketplace.V1.Model.MediaPlanner.t`, *default:* `nil`) - Output only. Refers to a buyer in Real-time Bidding API's Buyer resource. This field represents a media planner (For example, agency or big advertiser).
   *   `name` (*type:* `String.t`, *default:* `nil`) - Immutable. The unique identifier of the deal. Auto-generated by the server when a deal is created. Format: buyers/{accountId}/proposals/{proposalId}/deals/{dealId}
   *   `preferredDealTerms` (*type:* `GoogleApi.AuthorizedBuyersMarketplace.V1.Model.PreferredDealTerms.t`, *default:* `nil`) - The terms for preferred deals.
   *   `privateAuctionTerms` (*type:* `GoogleApi.AuthorizedBuyersMarketplace.V1.Model.PrivateAuctionTerms.t`, *default:* `nil`) - The terms for private auction deals.
@@ -58,9 +60,11 @@ defmodule GoogleApi.AuthorizedBuyersMarketplace.V1.Model.Deal do
             GoogleApi.AuthorizedBuyersMarketplace.V1.Model.DeliveryControl.t() | nil,
           :description => String.t() | nil,
           :displayName => String.t() | nil,
+          :eligibleSeatIds => list(String.t()) | nil,
           :estimatedGrossSpend => GoogleApi.AuthorizedBuyersMarketplace.V1.Model.Money.t() | nil,
           :flightEndTime => DateTime.t() | nil,
           :flightStartTime => DateTime.t() | nil,
+          :mediaPlanner => GoogleApi.AuthorizedBuyersMarketplace.V1.Model.MediaPlanner.t() | nil,
           :name => String.t() | nil,
           :preferredDealTerms =>
             GoogleApi.AuthorizedBuyersMarketplace.V1.Model.PreferredDealTerms.t() | nil,
@@ -89,9 +93,11 @@ defmodule GoogleApi.AuthorizedBuyersMarketplace.V1.Model.Deal do
   field(:deliveryControl, as: GoogleApi.AuthorizedBuyersMarketplace.V1.Model.DeliveryControl)
   field(:description)
   field(:displayName)
+  field(:eligibleSeatIds, type: :list)
   field(:estimatedGrossSpend, as: GoogleApi.AuthorizedBuyersMarketplace.V1.Model.Money)
   field(:flightEndTime, as: DateTime)
   field(:flightStartTime, as: DateTime)
+  field(:mediaPlanner, as: GoogleApi.AuthorizedBuyersMarketplace.V1.Model.MediaPlanner)
   field(:name)
 
   field(:preferredDealTerms, as: GoogleApi.AuthorizedBuyersMarketplace.V1.Model.PreferredDealTerms)

@@ -24,7 +24,7 @@ defmodule GoogleApi.AuthorizedBuyersMarketplace.V1.Model.FinalizedDeal do
   *   `deal` (*type:* `GoogleApi.AuthorizedBuyersMarketplace.V1.Model.Deal.t`, *default:* `nil`) - A copy of the Deal made upon finalization. During renegotiation, this will reflect the last finalized deal before renegotiation was initiated.
   *   `dealPausingInfo` (*type:* `GoogleApi.AuthorizedBuyersMarketplace.V1.Model.DealPausingInfo.t`, *default:* `nil`) - Information related to deal pausing for the deal.
   *   `dealServingStatus` (*type:* `String.t`, *default:* `nil`) - Serving status of the deal.
-  *   `name` (*type:* `String.t`, *default:* `nil`) - The resource name of the finalized deal. Format: `buyers/{accountId}/finalizeddeals/{finalizedDealId}`
+  *   `name` (*type:* `String.t`, *default:* `nil`) - The resource name of the finalized deal. Format: `buyers/{accountId}/finalizedDeals/{finalizedDealId}`
   *   `readyToServe` (*type:* `boolean()`, *default:* `nil`) - Whether the Programmatic Guaranteed deal is ready for serving.
   *   `rtbMetrics` (*type:* `GoogleApi.AuthorizedBuyersMarketplace.V1.Model.RtbMetrics.t`, *default:* `nil`) - Real-time bidding metrics for this deal.
   """

@@ -0,0 +1,46 @@
+# Copyright 2019 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# NOTE: This file is auto generated by the elixir code generator program.
+# Do not edit this file manually.
+
+defmodule GoogleApi.AuthorizedBuyersMarketplace.V1.Model.MediaPlanner do
+  @moduledoc """
+  Describes a single Media Planner account.
+
+  ## Attributes
+
+  *   `accountId` (*type:* `String.t`, *default:* `nil`) - Output only. Account ID of the media planner.
+  """
+
+  use GoogleApi.Gax.ModelBase
+
+  @type t :: %__MODULE__{
+          :accountId => String.t() | nil
+        }
+
+  field(:accountId)
+end
+
+defimpl Poison.Decoder, for: GoogleApi.AuthorizedBuyersMarketplace.V1.Model.MediaPlanner do
+  def decode(value, options) do
+    GoogleApi.AuthorizedBuyersMarketplace.V1.Model.MediaPlanner.decode(value, options)
+  end
+end
+
+defimpl Poison.Encoder, for: GoogleApi.AuthorizedBuyersMarketplace.V1.Model.MediaPlanner do
+  def encode(value, options) do
+    GoogleApi.Gax.ModelBase.encode(value, options)
+  end
+end