REST Resource: orders.lines

Resource: Baris

Baris pesanan tunggal yang mewakili produk yang dikonfigurasi.

Representasi JSON
{
  "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
}
Kolom
name

string

Hanya output. Nama resource baris dalam format: orders/{order_id}/lines/{id}.

product

string

Hanya output. Nama Product yang dikonfigurasi baris ini. Format = produk/123

externalId

string

Opsional. ID yang digunakan untuk memetakan entity ini ke sumber eksternal.

displayName

string

Hanya output. Nama tampilan garis.

description

string

Hanya output. Kolom bentuk bebas tambahan untuk mendeskripsikan garis.

lineState

enum (LineState)

Hanya output. Status garis. Lihat LineState untuk mengetahui siklus proses Line.

Penjual dapat menggunakan metode kustom berikut: Reserve, Book, dan Reject untuk menetapkan salah satu opsi berikut:

  • LINE_STATE_RESERVED
  • LINE_STATE_BOOKED
  • LINE_STATE_REJECTED_BY_SELLER.

Semua status baris lainnya ditetapkan oleh pembeli.

rejection

object (Rejection)

Opsional. Detail penolakan untuk baris.

startTime
(deprecated)

string (Timestamp format)

Hanya output. Kapan baris akan mulai ditayangkan (inklusif).

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

endTime
(deprecated)

string (Timestamp format)

Hanya output. Kapan baris akan berhenti ditayangkan (eksklusif).

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

startDate

object (Date)

Hanya output. Tanggal baris akan mulai ditayangkan (inklusif). Zona waktu yang sama dengan unit iklan.

endDate

object (Date)

Hanya output. Tanggal baris akan berhenti ditayangkan (inklusif). Zona waktu yang sama dengan unit iklan.

budget

object (Money)

Hanya output. Anggaran saluran.

lineTerms

object (LineTerms)

Hanya output. Persyaratan jaminan penjual untuk baris ini.

pendingReservationExpirationTime

string (Timestamp format)

Hanya output. Stempel waktu masa berlaku habis untuk reservasi yang tertunda. Penjual harus melakukan reservasi atau menolak sebelum masa berlaku reservasi yang tertunda berakhir atau reservasi akan dianggap sebagai ditolak.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

reservationExpirationTime

string (Timestamp format)

Hanya output. Stempel waktu habis masa berlaku untuk reservasi. Pembeli harus melakukan pemesanan sebelum masa berlaku reservasi berakhir atau reservasi akan dianggap sebagai dibatalkan.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

targeting

object (Targeting)

Hanya output. Penargetan untuk jalur.

createTime

string (Timestamp format)

Hanya output. Stempel waktu pembuatan baris.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Hanya output. Stempel waktu terakhir diperbarui untuk baris.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

LineState

Status garis.

Enum
LINE_STATE_UNSPECIFIED Nilai default saat status garis belum ditentukan atau tidak diketahui dalam versi ini.
LINE_STATE_PENDING_RESERVATION Baris ini telah dibuat oleh pembeli dan meminta produk untuk direservasi serta diperbarui dengan informasi harga dan ketersediaan.
LINE_STATE_RESERVED Baris ini dipesan oleh penjual. Status ini hanya mungkin jika status sebelumnya adalah menunggu reservasi.
LINE_STATE_PENDING_BOOKING Pembeli telah menerima reservasi dan meminta antrean untuk dipesan.
LINE_STATE_BOOKED Penjual telah memesan antrean. Status ini hanya dimungkinkan jika status sebelumnya adalah pemesanan tertunda. Penolakan tidak diharapkan pada tahap ini.
LINE_STATE_REJECTED_BY_SELLER Saluran ditolak oleh penjual. Status ini hanya mungkin jika status sebelumnya adalah menunggu reservasi.
LINE_STATE_CANCELLED_BY_BUYER Baris dibatalkan oleh pembeli.
LINE_STATE_PENDING_RESERVATION_EXPIRED Masa berlaku baris telah berakhir saat reservasi tertunda.
LINE_STATE_RESERVED_EXPIRED Baris tersebut akan habis masa berlakunya saat dipesan, menunggu respons pembeli.

Metode

book

Memesan baris yang ada.

get

Mengambil baris individual untuk sebuah pesanan.

list

Mencantumkan baris untuk pesanan.

patch

Memperbarui baris yang ada.

reject

Menolak baris yang ada.

reserve

Mencadangkan jalur yang sudah ada.