Order

Thực thể đơn đặt hàng. Lưu ý: 1. Tất cả các chuỗi ở tất cả cấp phải ít hơn 1000 ký tự trừ khi có quy định khác. 2. Tất cả các trường lặp lại ở tất cả các cấp phải nhỏ hơn 50 số đếm trừ khi có quy định khác. 3. Tất cả dấu thời gian ở tất cả các cấp, nếu được chỉ định, phải là dấu thời gian hợp lệ.

Biểu diễn dưới dạng JSON 
{
  "googleOrderId": string,
  "merchantOrderId": string,
  "userVisibleOrderId": string,
  "userVisibleStateLabel": string,
  "buyerInfo": {
    object (UserInfo)
  },
  "image": {
    object (Image)
  },
  "createTime": string,
  "lastUpdateTime": string,
  "transactionMerchant": {
    object (Merchant)
  },
  "contents": {
    object (Contents)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "paymentData": {
    object (PaymentData)
  },
  "termsOfServiceUrl": string,
  "note": string,
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseOrderExtension)
  },
  "ticket": {
    object (TicketOrderExtension)
  }
  // End of list of possible types for union field verticals.
}
Các trường
googleOrderId

string

Mã đơn hàng do Google chỉ định.
merchantOrderId

string

Bắt buộc: Mã đơn hàng nội bộ do người bán chỉ định. Mã này phải là duy nhất và bắt buộc cho các hoạt động cập nhật đơn đặt hàng tiếp theo. Mã này có thể được đặt thành googleOrderId được cung cấp hoặc bất kỳ giá trị riêng biệt nào khác. Xin lưu ý rằng mã nhận dạng được hiển thị cho người dùng là userVisibleOrderId. Đây có thể là một giá trị khác và thân thiện hơn với người dùng. Độ dài tối đa cho phép là 128 ký tự.
userVisibleOrderId

string

Mã nhận dạng dành cho người dùng đang tham chiếu đến đơn đặt hàng hiện tại. Mã này phải nhất quán với mã nhận dạng được hiển thị cho đơn đặt hàng này trong các ngữ cảnh khác, bao gồm cả trang web, ứng dụng và email.
userVisibleStateLabel
(deprecated)

string

Không dùng nữa: Sử dụng trạng thái OrderExtensions. Nhãn mà người dùng nhìn thấy cho trạng thái của đơn đặt hàng này.
buyerInfo

object (UserInfo)

thông tin về người mua.
image

object (Image)

Hình ảnh liên quan đến đơn đặt hàng.
createTime

string (Timestamp format)

Bắt buộc: ngày và giờ tạo đơn đặt hàng.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, chính xác đến nano giây. Ví dụ: "2014-10-02T15:01:23.045123456Z"
lastUpdateTime

string (Timestamp format)

ngày và giờ đơn đặt hàng được cập nhật lần cuối. Bắt buộc đối với OrderUpdate.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, chính xác đến nano giây. Ví dụ: "2014-10-02T15:01:23.045123456Z"
transactionMerchant

object (Merchant)

Người bán hỗ trợ thanh toán. Nhà cung cấp này có thể khác với nhà cung cấp ở cấp mục hàng. Ví dụ: Đơn đặt hàng Expedia với mục hàng từ ANA.
contents

object (Contents)

Bắt buộc: Nội dung đơn đặt hàng là một nhóm các mục hàng.
priceAttributes[]

object (PriceAttribute)

Giá, chiết khấu, thuế, v.v.
followUpActions[]

object (Action)

Các hành động tiếp theo ở cấp đơn đặt hàng.
paymentData

object (PaymentData)

Dữ liệu liên quan đến thanh toán cho đơn đặt hàng.
termsOfServiceUrl

string

Đường liên kết đến điều khoản dịch vụ áp dụng cho đơn đặt hàng/đơn đặt hàng được đề xuất.
note

string

Ghi chú đính kèm vào đơn đặt hàng.
promotions[]

object (Promotion)

Tất cả chương trình khuyến mãi liên quan đến đơn đặt hàng này.
disclosures[]

object (Disclosure)

Thông tin công bố liên quan đến đơn đặt hàng này.
vertical
(deprecated)

object

Ngừng sử dụng: Sử dụng ngành dọc. Các thuộc tính này sẽ áp dụng cho mọi mục hàng, trừ trường hợp bị ghi đè trong một số mục hàng. Ngành dọc này phải phù hợp với loại ngành dọc cấp mục hàng. Các giá trị có thể là: google.actions.orders.v3.verticals.purchase.PurchaseOrderExtension google.actions.orders.v3.verticals.ticket.TicketOrderExtension

Đối tượng chứa các trường thuộc kiểu tuỳ ý. Trường bổ sung "@type" chứa URI nhận dạng loại. Ví dụ: { "id": 1234, "@type": "types.example.com/standard/id" }.
Trường nhóm verticals. Các thuộc tính này sẽ áp dụng cho mọi mục hàng, trừ trường hợp bị ghi đè trong một số mục hàng. Ngành dọc này phải phù hợp với loại ngành dọc cấp mục hàng. verticals chỉ có thể là một trong những trạng thái sau đây:
purchase

object (PurchaseOrderExtension)

Đơn đặt hàng
ticket

object (TicketOrderExtension)

Đặt vé

Nội dung

Trình bao bọc cho mục hàng.

Biểu diễn dưới dạng JSON 
{
  "lineItems": [
    {
      object (LineItem)
    }
  ]
}
Các trường
lineItems[]

object (LineItem)

Danh sách mục hàng trong đơn đặt hàng. Bắt buộc phải có ít nhất 1 mục hàng và tối đa 50 mục hàng. Tất cả các mục hàng phải thuộc cùng một ngành dọc.

PaymentData

Dữ liệu thanh toán liên quan đến đơn đặt hàng.

Biểu diễn dưới dạng JSON 
{
  "paymentResult": {
    object (PaymentResult)
  },
  "paymentInfo": {
    object (PaymentInfo)
  }
}
Các trường
paymentResult

object (PaymentResult)

Kết quả thanh toán được nhà tích hợp sử dụng để hoàn tất một giao dịch. Trường này sẽ được điền sẵn bằng các hành động trên Google nếu trải nghiệm thanh toán do actions-on-Google quản lý.
paymentInfo

object (PaymentInfo)

Thông tin thanh toán liên quan đến đơn đặt hàng hữu ích cho tương tác dành cho người dùng.

PaymentResult

Kết quả thanh toán được đơn vị tích hợp sử dụng để hoàn tất một giao dịch.

Biểu diễn dưới dạng JSON 
{

  // Union field result can be only one of the following:
  "googlePaymentData": string,
  "merchantPaymentMethodId": string
  // End of list of possible types for union field result.
}
Các trường
Trường nhóm result. Bạn đã cung cấp dữ liệu thanh toán trên Google hoặc phương thức thanh toán của người bán. result chỉ có thể là một trong những trạng thái sau đây:
googlePaymentData

string

Dữ liệu về phương thức thanh toán do Google cung cấp. Nếu công ty xử lý thanh toán của bạn được liệt kê là công ty xử lý thanh toán được Google hỗ trợ tại đây: https://developers.google.com/pay/api/ Hãy chuyển đến công ty xử lý thanh toán của bạn thông qua đường liên kết để tìm hiểu thêm thông tin. Nếu không, hãy tham khảo tài liệu sau đây để biết thông tin chi tiết về tải trọng. https://developers.google.com/pay/api/payment-data-cryptography
merchantPaymentMethodId

string

Phương thức thanh toán do Người bán/Hành động cung cấp do người dùng chọn.

PaymentInfo

Thông tin thanh toán liên quan đến đơn đặt hàng đang được thực hiện. Proto này ghi lại thông tin hữu ích cho tương tác đối mặt với người dùng.

Biểu diễn dưới dạng JSON 
{
  "paymentMethodDisplayInfo": {
    object (PaymentMethodDisplayInfo)
  },
  "paymentMethodProvenance": enum (PaymentMethodProvenance)
}
Các trường
paymentMethodDisplayInfo

object (PaymentMethodDisplayInfo)

Thông tin hiển thị của phương thức thanh toán mà giao dịch sử dụng.
paymentMethodProvenance

enum (PaymentMethodProvenance)

Chứng minh phương thức thanh toán đã sử dụng cho giao dịch. Người dùng có thể đã đăng ký cùng một phương thức thanh toán với cả Google và người bán.

PaymentMethodDisplayInfo

Kết quả thanh toán được đơn vị tích hợp sử dụng để hoàn tất một giao dịch.

Biểu diễn dưới dạng JSON 
{
  "paymentType": enum (PaymentType),
  "paymentMethodDisplayName": string
}
Các trường
paymentType

enum (PaymentType)

Loại thanh toán.
paymentMethodDisplayName

string

Tên hiển thị của người dùng của phương thức thanh toán. Ví dụ: VISA **** 1234 Đang kiểm tra acct **** 5678

Khuyến mãi

Chương trình khuyến mãi/ưu đãi đã được thêm vào giỏ hàng.

Biểu diễn dưới dạng JSON 
{
  "coupon": string
}
Các trường
coupon

string

Bắt buộc: Mã giảm giá được áp dụng cho ưu đãi này.

PurchaseOrderExtension

Phần mở rộng về đơn đặt hàng cho ngành dọc mua hàng. Bạn có thể áp dụng các thuộc tính này cho tất cả các mục hàng trong đơn đặt hàng, trừ trường hợp bị ghi đè trong một mục hàng.

Biểu diễn dưới dạng JSON 
{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  },
  "purchaseLocationType": enum (PurchaseLocationType),
  "errors": [
    {
      object (PurchaseError)
    }
  ]
}
Các trường
status

enum (PurchaseStatus)

Bắt buộc: Tình trạng chung của đơn đặt hàng.
userVisibleStatusLabel

string

Chuỗi/nhãn mà người dùng nhìn thấy cho trạng thái. Độ dài tối đa cho phép là 50 ký tự.
type

enum (PurchaseType)

Bắt buộc: loại giao dịch mua.
returnsInfo

object (PurchaseReturnsInfo)

Thông tin về trường hợp trả lại hàng của đơn đặt hàng.
fulfillmentInfo

object (PurchaseFulfillmentInfo)

Thông tin về việc thực hiện đơn đặt hàng.
extension

object

Mọi trường bổ sung được trao đổi giữa người bán và Google.

Đối tượng chứa các trường thuộc kiểu tuỳ ý. Trường bổ sung "@type" chứa URI nhận dạng loại. Ví dụ: { "id": 1234, "@type": "types.example.com/standard/id" }.
purchaseLocationType

enum (PurchaseLocationType)

Vị trí mua hàng (tại cửa hàng / trực tuyến)
errors[]

object (PurchaseError)

Không bắt buộc: Lỗi do đơn đặt hàng này bị từ chối.

PurchaseError

Lỗi đơn đặt hàng có thể bị từ chối.

Biểu diễn dưới dạng JSON 
{
  "type": enum (ErrorType),
  "description": string,
  "entityId": string,
  "updatedPrice": {
    object (PriceAttribute)
  },
  "availableQuantity": integer
}
Các trường
type

enum (ErrorType)

Bắt buộc: Thông tin này cho biết lý do chi tiết vì sao người bán từ chối đơn đặt hàng.
description

string

Nội dung mô tả khác về lỗi.
entityId

string

Mã nhận dạng thực thể tương ứng với lỗi. Ví dụ này có thể tương ứng với LineItemId / ItemOptionId.
updatedPrice

object (PriceAttribute)

Có liên quan trong trường hợp loại lỗiPRICE_CHANGED / INChỉnh sửa_PRICE.
availableQuantity

integer

Hiện đang có số lượng. Áp dụng trong trường hợp Availability_CHANGED.

TicketOrderExtension

Đặt hàng nội dung cho các đơn đặt vé như phim, thể thao, v.v.

Biểu diễn dưới dạng JSON 
{
  "ticketEvent": {
    object (TicketEvent)
  }
}
Các trường
ticketEvent

object (TicketEvent)

Sự kiện áp dụng cho tất cả các phiếu yêu cầu hỗ trợ của mục hàng.

TicketEvent

Đại diện cho một sự kiện.

Biểu diễn dưới dạng JSON 
{
  "type": enum (Type),
  "name": string,
  "description": string,
  "url": string,
  "location": {
    object (Location)
  },
  "eventCharacters": [
    {
      object (EventCharacter)
    }
  ],
  "startDate": {
    object (Time)
  },
  "endDate": {
    object (Time)
  },
  "doorTime": {
    object (Time)
  }
}
Các trường
type

enum (Type)

Bắt buộc: loại sự kiện bán vé, ví dụ: phim, buổi hoà nhạc.
name

string

Bắt buộc: tên của sự kiện. Ví dụ: nếu sự kiện là một bộ phim, thì đây phải là tên phim.
description

string

mô tả sự kiện.
url

string

URL dẫn đến thông tin sự kiện.
location

object (Location)

Địa điểm diễn ra sự kiện hoặc trụ sở của một tổ chức.
eventCharacters[]

object (EventCharacter)

Các ký tự có liên quan đến sự kiện này. Đó có thể là đạo diễn hoặc diễn viên của một sự kiện phim hoặc người biểu diễn buổi hoà nhạc, v.v.
startDate

object (Time)

Thời gian bắt đầu.
endDate

object (Time)

Thời gian kết thúc.
doorTime

object (Time)

Thời gian tham gia có thể khác với thời gian bắt đầu sự kiện. Ví dụ:sự kiện bắt đầu lúc 9 giờ sáng, nhưng thời gian tham gia là 8 giờ 30 sáng.

EventCharacter

Một nhân vật sự kiện, ví dụ: người tổ chức, người biểu diễn, v.v.

Biểu diễn dưới dạng JSON 
{
  "type": enum (Type),
  "name": string,
  "image": {
    object (Image)
  }
}
Các trường
type

enum (Type)

loại nhân vật sự kiện, ví dụ: diễn viên hoặc đạo diễn.
name

string

tên của nhân vật.
image

object (Image)

Hình ảnh của nhân vật.