REST Resource: sellers.orders.lines

Resource: Line

A single order line which represents a configured product.

JSON representation 
{
  "name": string,
  "product": string,
  "externalId": string,
  "displayName": string,
  "description": string,
  "state": enum (State),
  "rejection": {
    object (Rejection)
  },
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  },
  "transactionType": enum (TransactionType),
  "pricingType": enum (PricingType),
  "externalDealId": string,
  "creativeType": enum (CreativeType),
  "budget": {
    object (Money)
  },
  "lineTerms": {
    object (LineTerms)
  },
  "pendingReservationExpirationTime": string,
  "reservationExpirationTime": string,
  "targeting": {
    object (Targeting)
  },
  "createTime": string,
  "updateTime": string
}
Fields
name

string

The resource name of the line in the format: sellers/{seller}/orders/{order}/lines/{line}.
product

string

The name of the Product this line is configuring. Format: sellers/{seller}/products/{product}
externalId

string

An id used to map this entity to external sources.
displayName

string

The display name of the line.
description

string

Additional freeform field to describe the line.
state

enum (State)

Output only. The state of the line. See State for the lifecycle of a Line.

Seller can use the following custom methods: Reserve, Book, and Reject to set to one of the following:

  • STATE_RESERVED
  • STATE_BOOKED
  • STATE_REJECTED_BY_SELLER.

All other line states are set by the buyer.
rejection

object (Rejection)

Rejection details for the line.
startDate

object (Date)

The date the line would start being served (inclusive). Same time zone as the ad unit.
endDate

object (Date)

The date the line would stop being served (inclusive). Same time zone as the ad unit.
transactionType

enum (TransactionType)

Transaction type for this line.
pricingType

enum (PricingType)

Pricing type for this line.
externalDealId

string

External deal ID for this line. If provided, the line is set to RTB execution if configured for the seller, otherwise errors.
creativeType

enum (CreativeType)

Creative type for this line. The product specified for this line must support the provided creative type.
budget

object (Money)

Output only. The budget of the line.
lineTerms

object (LineTerms)

Output only. The seller's guaranteed terms for this line.
pendingReservationExpirationTime

string (Timestamp format)

Output only. Expiration timestamp for the pending reservation. Seller needs to reserve or reject before a pending reservation expires or it will be treated as rejected.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".
reservationExpirationTime

string (Timestamp format)

Output only. Expiration timestamp for the reservation. The buyer needs to book before a reservation expires or it will be treated as cancelled.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".
targeting

object (Targeting)

The targeting for the line.
createTime

string (Timestamp format)

Output only. Creation timestamp for line.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Output only. Last updated timestamp for line.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

State

State of a line.

Enums
STATE_UNSPECIFIED The default value when the line state has not been specified or is unknown in this version.
STATE_PENDING_RESERVATION The line has been created by the buyer and is requesting the products be reserved as well as updated with pricing and availability information.
STATE_RESERVED The line was reserved by the seller. This state is only possible if the previous state is pending reservation.
STATE_PENDING_BOOKING The buyer has accepted the reservation and is requesting the line to be booked.
STATE_BOOKED The seller has booked the line. This state is only possible if the previous state is pending booking. Rejections are not expected at this stage.
STATE_REJECTED_BY_SELLER The line was rejected by the seller. This state is only possible if the previous state is pending reservation.
STATE_CANCELLED_BY_BUYER The line was cancelled by buyer.
STATE_PENDING_RESERVATION_EXPIRED The line expired while pending reservation.
STATE_RESERVED_EXPIRED The line expired while reserved, waiting for buyer's response.

TransactionType

Transaction type for a line.

Enums
TRANSACTION_TYPE_UNSPECIFIED The default value when the exchange has not been specified or is unknown in this version.
TRANSACTION_TYPE_RESERVED The transaction is reserved (guaranteed).
TRANSACTION_TYPE_NON_RESERVED The transaction is non-reserved (non-guaranteed).

PricingType

Pricing type for a line.

Enums
PRICING_TYPE_UNSPECIFIED The default value when the exchange has not been specified or is unknown in this version.
PRICING_TYPE_FIXED Fixed price per impression.
PRICING_TYPE_AUCTION Impression price will be determined by auction.

Methods

book

 Books an existing line.

create

 Creates a new line.

get

 Retrieves an individual line for an order.

list

 Lists lines for an order.

patch

 Updates an existing line.

reject

 Rejects an existing line.

reserve

 Reserves an existing line.