Deal

import type { Deal } from "https://googleapis.deno.dev/v1/authorizedbuyersmarketplace:v1.ts";

A deal represents a segment of inventory for displaying ads that contains the terms and targeting information that is used for serving as well as the deal stats and status. Note: A proposal may contain multiple deals.

interface Deal {

readonly billedBuyer?: string;

readonly buyer?: string;

readonly client?: string;

readonly createTime?: Date;

readonly creativeRequirements?: CreativeRequirements;

readonly dealType?:

| "DEAL_TYPE_UNSPECIFIED"

| "PREFERRED_DEAL"

| "PRIVATE_AUCTION"

| "PROGRAMMATIC_GUARANTEED";

readonly deliveryControl?: DeliveryControl;

readonly description?: string;

readonly displayName?: string;

readonly eligibleSeatIds?: string[];

estimatedGrossSpend?: Money;

flightEndTime?: Date;

flightStartTime?: Date;

readonly mediaPlanner?: MediaPlanner;

name?: string;

preferredDealTerms?: PreferredDealTerms;

privateAuctionTerms?: PrivateAuctionTerms;

programmaticGuaranteedTerms?: ProgrammaticGuaranteedTerms;

readonly proposalRevision?: bigint;

publisherProfile?: string;

readonly sellerTimeZone?: TimeZone;

targeting?: MarketplaceTargeting;

readonly updateTime?: Date;

}

§Properties

readonly billedBuyer?: string

[src]

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}

readonly buyer?: string

[src]

Output only. Refers to a buyer in Real-time Bidding API's Buyer resource. Format: buyers/{buyerAccountId}

readonly client?: string

[src]

Output only. Refers to a Client. Format: buyers/{buyerAccountId}/clients/{clientAccountid}

readonly createTime?: Date

[src]

Output only. The time of the deal creation.

readonly creativeRequirements?: CreativeRequirements

[src]

Output only. Metadata about the creatives of this deal.

readonly dealType?: "DEAL_TYPE_UNSPECIFIED" | "PREFERRED_DEAL" | "PRIVATE_AUCTION" | "PROGRAMMATIC_GUARANTEED"

[src]

Output only. Type of deal.

readonly deliveryControl?: DeliveryControl

[src]

Output only. Specifies the pacing set by the publisher.

readonly description?: string

[src]

Output only. Free text description for the deal terms.

readonly displayName?: string

[src]

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.

readonly eligibleSeatIds?: string[]

[src]

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?: Money

[src]

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?: Date

[src]

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?: Date

[src]

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.

readonly mediaPlanner?: MediaPlanner

[src]

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?: string

[src]

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?: PreferredDealTerms

[src]

The terms for preferred deals.

privateAuctionTerms?: PrivateAuctionTerms

[src]

The terms for private auction deals.

programmaticGuaranteedTerms?: ProgrammaticGuaranteedTerms

[src]

The terms for programmatic guaranteed deals.

readonly proposalRevision?: bigint

[src]

Output only. The revision number for the proposal and is the same value as proposal.proposal_revision. Each update to 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.

publisherProfile?: string

[src]

Immutable. Reference to the seller on the deal. Format: buyers/{buyerAccountId}/publisherProfiles/{publisherProfileId}

readonly sellerTimeZone?: TimeZone

[src]

Output only. Time zone of the seller used to mark the boundaries of a day for daypart targeting and CPD billing.

targeting?: MarketplaceTargeting

[src]

Specifies the subset of inventory targeted by the deal. Can be updated by the buyer before the deal is finalized.

readonly updateTime?: Date

[src]

Output only. The time when the deal was last updated.