REST Resource: orders.lines

Kaynak: Satır

Yapılandırılmış bir ürünü temsil eden tek bir sipariş satırı.

JSON gösterimi 
{
  "name": string,
  "product": string,
  "externalId": string,
  "displayName": string,
  "description": string,
  "lineState": enum (LineState),
  "rejection": {
    object (Rejection)
  },
  "startTime": string,
  "endTime": string,
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  },
  "budget": {
    object (Money)
  },
  "lineTerms": {
    object (LineTerms)
  },
  "pendingReservationExpirationTime": string,
  "reservationExpirationTime": string,
  "targeting": {
    object (Targeting)
  },
  "createTime": string,
  "updateTime": string
}
Alanlar
name

string

Yalnızca çıkış. Satırın orders/{order_id}/lines/{id} biçimindeki kaynak adı.
product

string

Yalnızca çıkış. Bu satırın yapılandırdığı Product biriminin adı. Biçim = products/123
externalId

string

İsteğe bağlı. Bu varlığı harici kaynaklarla eşlemek için kullanılan kimlik.
displayName

string

Yalnızca çıkış. Çizginin görünen adı.
description

string

Yalnızca çıkış. Çizgiyi tanımlamak için ek serbest biçimli alan.
lineState

enum (LineState)

Yalnızca çıkış. Çizginin durumu. Bir Çizginin yaşam döngüsü için LineState adresini inceleyin.

Satıcı şu özel yöntemleri kullanabilir: Reserve, Book ve Reject:

  • LINE_STATE_RESERVED
  • LINE_STATE_BOOKED
  • LINE_STATE_REJECTED_BY_SELLER.

Diğer tüm satır durumları alıcı tarafından ayarlanır.
rejection

object (Rejection)

İsteğe bağlı. Satırın ret ayrıntıları.
startTime
(deprecated)

string (Timestamp format)

Yalnızca çıkış. Satırın ne zaman sunulmaya başlayacağı (dahil).

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
endTime
(deprecated)

string (Timestamp format)

Yalnızca çıkış. Satırın sunulmasının ne zaman durdurulacağı (hariç).

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
startDate

object (Date)

Yalnızca çıkış. Satırın sunulmaya başlayacağı tarih (bu tarih dahil). Reklam birimiyle aynı saat dilimi.
endDate

object (Date)

Yalnızca çıkış. Satırın sunulmasının durdurulacağı tarih (bu tarih dahil). Reklam birimiyle aynı saat dilimi.
budget

object (Money)

Yalnızca çıkış. Satırın bütçesi.
lineTerms

object (LineTerms)

Yalnızca çıkış. Satıcının bu satır için garantili şartları.
pendingReservationExpirationTime

string (Timestamp format)

Yalnızca çıkış. Beklemedeki rezervasyon için geçerlilik sonu zaman damgası. Satıcının beklemedeki bir rezervasyonun süresi dolmadan önce rezervasyon yapması veya reddetmesi gerekir. Aksi takdirde rezervasyon reddedilmiş olarak değerlendirilir.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
reservationExpirationTime

string (Timestamp format)

Yalnızca çıkış. Rezervasyonun geçerlilik bitişi zaman damgası. Bir rezervasyonun süresi dolmadan önce alıcının rezervasyon yapması gerekir. Aksi takdirde rezervasyon iptal edilmiş olarak değerlendirilir.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
targeting

object (Targeting)

Yalnızca çıkış. Satırın hedeflemesi.
createTime

string (Timestamp format)

Yalnızca çıkış. Satırın oluşturulma zaman damgası.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Yalnızca çıkış. Satır için son güncelleme zaman damgası.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

LineState

Bir hattın durumu.

Sıralamalar
LINE_STATE_UNSPECIFIED Çizgi durumu belirtilmediyse veya bu sürümde bilinmiyorsa varsayılan değer.
LINE_STATE_PENDING_RESERVATION Satır, alıcı tarafından oluşturulmuştur ve ürünlerin ayrılmasını, ayrıca fiyat ve stok durumu bilgileriyle güncellenmesini istemektedir.
LINE_STATE_RESERVED Satır, satıcı tarafından ayırtıldı. Bu durum yalnızca önceki durum "rezervasyon bekliyor" durumundaysa gerçekleşebilir.
LINE_STATE_PENDING_BOOKING Alıcı rezervasyonu kabul etti ve satırın rezerve edilmesini istiyor.
LINE_STATE_BOOKED Satıcı hattı rezerve etti. Bu durum yalnızca önceki durum "rezervasyon bekliyor" durumundaysa gerçekleşebilir. Bu aşamada reddedilme beklenmez.
LINE_STATE_REJECTED_BY_SELLER Satır, satıcı tarafından reddedildi. Bu durum yalnızca önceki durum "rezervasyon bekliyor" durumundaysa gerçekleşebilir.
LINE_STATE_CANCELLED_BY_BUYER Hat, alıcı tarafından iptal edildi.
LINE_STATE_PENDING_RESERVATION_EXPIRED Rezervasyon beklenirken hattın süresi doldu.
LINE_STATE_RESERVED_EXPIRED Alıcının yanıtı bekleniyorken satırın süresi doldu.

Yöntemler

book

 Mevcut bir satırı ayırır.

get

 Bir sipariş için tek bir satırı alır.

list

 Bir siparişin satırlarını listeler.

patch

 Mevcut bir hattı günceller.

reject

 Mevcut bir satırı reddeder.

reserve

 Mevcut bir hattı ayırır.