# type Proposal (v202602)

**Service** **ProposalService** **Dependencies** [ProposalPage](https://developers.google.com/ad-manager/api/reference/v202602/ProposalService.ProposalPage) [createProposals()](https://developers.google.com/ad-manager/api/reference/v202602/ProposalService#createProposals) [updateProposals()](https://developers.google.com/ad-manager/api/reference/v202602/ProposalService#updateProposals) ▼ **Proposal**

A `Proposal` represents an agreement between an interactive advertising seller and a buyer
that specifies the details of an advertising campaign.

*** ** * ** ***

Namespace
:
    `https://www.google.com/apis/ads/publisher/v202602`

| ## Field ||
|---|---|
| ### `id` | ` xsd:long` The unique ID of the `Proposal`. This attribute is read-only. |
| ### `isProgrammatic` | ` xsd:boolean` Flag that specifies whether this `Proposal` is for programmatic deals. This value is default to `false`. |
| ### `dfpOrderId` | ` xsd:long` The unique ID of corresponding [Order](https://developers.google.com/ad-manager/api/reference/v202602/OrderService.Order). This will be `null` if the `Proposal` has not been pushed to Ad Manager. This attribute is read-only. |
| ### `name` | ` xsd:string` The name of the `Proposal`. This value has a maximum length of 255 characters. This value is copied to [Order.name](https://developers.google.com/ad-manager/api/reference/v202602/OrderService.Order#name) when the proposal turns into an order. This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration. This attribute is required. |
| ### `startDateTime` | ` https://developers.google.com/ad-manager/api/reference/v202602/ProposalService.DateTime ` The date and time at which the order and line items associated with the `Proposal` are eligible to begin serving. This attribute is derived from the proposal line item of the proposal which has the earliest [ProposalLineItem.startDateTime](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.ProposalLineItem#startDateTime). This attribute will be null, if this proposal has no related line items, or none of its line items have a start time. This attribute is read-only. |
| ### `endDateTime` | ` https://developers.google.com/ad-manager/api/reference/v202602/ProposalService.DateTime ` The date and time at which the order and line items associated with the `Proposal` stop being served. This attribute is derived from the proposal line item of the proposal which has the latest [ProposalLineItem.endDateTime](https://developers.google.com/ad-manager/api/reference/v202602/ForecastService.ProposalLineItem#endDateTime). This attribute will be null, if this proposal has no related line items, or none of its line items have an end time. This attribute is read-only. |
| ### `status` | ` https://developers.google.com/ad-manager/api/reference/v202602/ProposalService.ProposalStatus ` The status of the `Proposal`. This attribute is read-only. *** ** * ** *** **Enumerations** `DRAFT` :   Indicates that the [Proposal](https://developers.google.com/ad-manager/api/reference/v202602/ProposalService.Proposal) has just been created or retracted but no approval has been requested yet. `PENDING_APPROVAL` :   Indicates that a request for approval has been made for the [Proposal](https://developers.google.com/ad-manager/api/reference/v202602/ProposalService.Proposal). `APPROVED` :   Indicates that the [Proposal](https://developers.google.com/ad-manager/api/reference/v202602/ProposalService.Proposal) has been approved and is ready to serve. `REJECTED` :   Indicates that the [Proposal](https://developers.google.com/ad-manager/api/reference/v202602/ProposalService.Proposal) has been rejected in the approval workflow. `UNKNOWN` :   The value returned if the actual value is not exposed by the requested API version. <br /> |
| ### `isArchived` | ` xsd:boolean` The archival status of the `Proposal`. This attribute is read-only. |
| ### `advertiser` | ` https://developers.google.com/ad-manager/api/reference/v202602/ProposalService.ProposalCompanyAssociation ` The advertiser, to which this `Proposal` belongs, and a set of [Contact](https://developers.google.com/ad-manager/api/reference/v202602/ContactService.Contact) objects associated with the advertiser. The [ProposalCompanyAssociation.type](https://developers.google.com/ad-manager/api/reference/v202602/ProposalService.ProposalCompanyAssociation#type) of this attribute should be [ProposalCompanyAssociationType.ADVERTISER](https://developers.google.com/ad-manager/api/reference/v202602/ProposalService.ProposalCompanyAssociationType#ADVERTISER). This attribute is required when the proposal turns into an order, and its [ProposalCompanyAssociation.companyId](https://developers.google.com/ad-manager/api/reference/v202602/ProposalService.ProposalCompanyAssociation#companyId) will be copied to [Order.advertiserId](https://developers.google.com/ad-manager/api/reference/v202602/OrderService.Order#advertiserId). This attribute becomes readonly once the `Proposal` has been pushed. |
| ### `agencies` | ` https://developers.google.com/ad-manager/api/reference/v202602/ProposalService.ProposalCompanyAssociation[]` List of agencies and the set of [Contact](https://developers.google.com/ad-manager/api/reference/v202602/ContactService.Contact) objects associated with each agency. This attribute is optional. A `Proposal` only has at most one [Company](https://developers.google.com/ad-manager/api/reference/v202602/CompanyService.Company) with [ProposalCompanyAssociationType.PRIMARY_AGENCY](https://developers.google.com/ad-manager/api/reference/v202602/ProposalService.ProposalCompanyAssociationType#PRIMARY_AGENCY) type, but a [Company](https://developers.google.com/ad-manager/api/reference/v202602/CompanyService.Company) can appear more than once with different [ProposalCompanyAssociationType](https://developers.google.com/ad-manager/api/reference/v202602/ProposalService.ProposalCompanyAssociationType) values. If primary agency exists, its [ProposalCompanyAssociation.companyId](https://developers.google.com/ad-manager/api/reference/v202602/ProposalService.ProposalCompanyAssociation#companyId) will be copied to [Order.agencyId](https://developers.google.com/ad-manager/api/reference/v202602/OrderService.Order#agencyId) when the proposal turns into an order. |
| ### `internalNotes` | ` xsd:string` Provides any additional notes that may annotate the `Proposal`. This attribute is optional and has a maximum length of 65,535 characters. This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration. |
| ### `primarySalesperson` | ` https://developers.google.com/ad-manager/api/reference/v202602/ProposalService.SalespersonSplit ` The primary salesperson who brokered the transaction with the [advertiser](https://developers.google.com/ad-manager/api/reference/v202602/ProposalService.Proposal#advertiser). This attribute is required when the proposal turns into an order. This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration. |
| ### `salesPlannerIds` | ` xsd:long[]` List of unique IDs of [User](https://developers.google.com/ad-manager/api/reference/v202602/UserService.User) objects who are the sales planners of the `Proposal`. This attribute is optional. A proposal could have 8 sales planners at most. This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration. |
| ### `primaryTraffickerId` | ` xsd:long` The unique ID of the [User](https://developers.google.com/ad-manager/api/reference/v202602/UserService.User) who is primary trafficker and is responsible for trafficking the `Proposal`. This attribute is required when the proposal turns into an order, and will be copied to [Order.primaryTraffickerId](https://developers.google.com/ad-manager/api/reference/v202602/OrderService.Order#primaryTraffickerId) . This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration. |
| ### `sellerContactIds` | ` xsd:long[]` [users](https://developers.google.com/ad-manager/api/reference/v202602/UserService.User) who are the seller's contacts. |
| ### `appliedTeamIds` | ` xsd:long[]` The IDs of all teams that the `Proposal` is on directly. This attribute is optional. This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration. |
| ### `customFieldValues` | 1. ` https://developers.google.com/ad-manager/api/reference/v202602/ProposalService.BaseCustomFieldValue[]` 1. ` https://developers.google.com/ad-manager/api/reference/v202602/ProposalService.CustomFieldValue ` 2. ` https://developers.google.com/ad-manager/api/reference/v202602/ProposalService.DropDownCustomFieldValue ` <br /> The values of the custom fields associated with the `Proposal`. This attribute is optional. This attribute can be configured as editable after the proposal has been submitted. Please check with your network administrator for editable fields configuration. |
| ### `appliedLabels` | ` https://developers.google.com/ad-manager/api/reference/v202602/ProposalService.AppliedLabel[]` The set of labels applied directly to the `Proposal`. This attribute is optional. |
| ### `effectiveAppliedLabels` | ` https://developers.google.com/ad-manager/api/reference/v202602/ProposalService.AppliedLabel[]` Contains the set of labels applied directly to the proposal as well as those inherited ones. If a label has been negated, only the negated label is returned. This attribute is read-only. |
| ### `currencyCode` | ` xsd:string` The currency code of this `Proposal`. This attribute is optional and defaults to network's currency code. |
| ### `isSold` | ` xsd:boolean` Indicates whether the proposal has been sold, i.e., corresponds to whether the status of an [Order](https://developers.google.com/ad-manager/api/reference/v202602/OrderService.Order) is [OrderStatus.APPROVED](https://developers.google.com/ad-manager/api/reference/v202602/OrderService.OrderStatus#APPROVED) or [OrderStatus.PAUSED](https://developers.google.com/ad-manager/api/reference/v202602/OrderService.OrderStatus#PAUSED). This attribute is read-only. |
| ### `supplyPath` | ` https://developers.google.com/ad-manager/api/reference/v202602/ProposalService.SupplyPathType ` The supply path type for this proposal. *** ** * ** *** **Enumerations** `DIRECT` :   The deal's demand will be supplied by the ad server directly. `DEMAND_SIDE_PLATFORM` :   The deal's demand will be supplied by a demand side platform (DSP). `UNKNOWN` :   The value returned if the actual value is not exposed by the requested API version. <br /> |
| ### `lastModifiedDateTime` | ` https://developers.google.com/ad-manager/api/reference/v202602/ProposalService.DateTime ` The date and time this `Proposal` was last modified. This attribute is read-only. |
| ### `marketplaceInfo` | ` https://developers.google.com/ad-manager/api/reference/v202602/ProposalService.ProposalMarketplaceInfo ` The marketplace info of this proposal if it has a corresponding order in Marketplace. |
| ### `buyerRfp` | ` https://developers.google.com/ad-manager/api/reference/v202602/ProposalService.BuyerRfp ` The buyer RFP associated with this `Proposal`, which is optional. This field will be null if the proposal is not initiated from RFP. |
| ### `hasBuyerRfp` | ` xsd:boolean` Whether a [Proposal](https://developers.google.com/ad-manager/api/reference/v202602/ProposalService.Proposal) contains a [BuyerRfp](https://developers.google.com/ad-manager/api/reference/v202602/ProposalService.BuyerRfp) field. If this field is true, it indicates that the [Proposal](https://developers.google.com/ad-manager/api/reference/v202602/ProposalService.Proposal) in question orignated from a buyer. |
| ### `deliveryPausingEnabled` | ` xsd:boolean` Whether pausing is consented for the `Proposal`. This field is optional and defaults to true. If false, it indicates that the buyer and the seller agree that the proposal should not be paused. |