Order

Thực thể đơn đặt hàng. Lưu ý: 1. Tất cả chuỗi ở mọi cấp độ phải nhỏ hơn 1000 ký tự trừ phi có quy định khác. 2. Số lượng trường lặp lại ở tất cả các cấp phải nhỏ hơn 50, trừ phi có quy định khác. 3. Tất cả dấu thời gian ở mọi 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.
}
Trường
googleOrderId

string

Mã đơn hàng được chỉ định của Google.
merchantOrderId

string

Bắt buộc: Mã đơn hàng nội bộ do người bán chỉ định. Mã nhận dạng này phải là duy nhất và bắt buộc phải 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 hoặc bất kỳ giá trị duy nhất nào khác mà bạn cung cấp. Xin lưu ý rằng mã nhận dạng mà người dùng nhìn thấy là userVisibleOrderId. Đây có thể là một giá trị khác và thân thiện với người dùng hơn. Độ 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 tham chiếu đến đơn đặt hàng hiện tại. Mã nhận dạng này phải nhất quán với mã nhận dạng 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 OrderExtension. Nhãn hiển thị cho người dùng 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 kết với đơ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ờ cập nhật đơn đặt hàng lần gần đây nhất. 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. Số lượng này có thể khác với nhà cung cấp cấp mục hàng. Ví dụ: Đơn đặt hàng trên Expedia có mục hàng của 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)

Hành động nối tiếp ở cấp đơn đặt hàng.
paymentData

object (PaymentData)

Dữ liệu liên quan đến việc 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 kết với đơ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

Không dùng nữa: 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ừ phi 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ể có: google.actions.orders.v3.verticals.purchase.PurchaseOrderExtension google.actions.orders.v3.verticals.ticket.TicketOrderExtension

Một đối tượng có chứa các trường thuộc loại tuỳ ý. Trường bổ sung "@type" chứa URI xác định kiểu. Ví dụ: { "id": 1234, "@type": "types.example.com/standard/id" }.
Trường kết hợp verticals. Các thuộc tính này sẽ áp dụng cho mọi mục hàng, trừ phi 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)

Đơn đặ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)
    }
  ]
}
Trường
lineItems[]

object (LineItem)

Danh sách mục hàng của đơn đặt hàng. Yêu cầu tối thiểu 1 mục hàng và tối đa là 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)
  }
}
Trường
paymentResult

object (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. Trường này sẽ được điền sẵn dữ liệu về các hành động trên Google nếu trải nghiệm thanh toán được quản lý bằng Actions-on-Google.
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 trực tiếp với người dùng.

PaymentResult

Kết quả thanh toán mà đơ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.
}
Trường
Trường kết hợp result. Dữ liệu thanh toán của Google hoặc phương thức thanh toán của người bán sẽ được cung cấp. 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ó tên trong danh sách 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 qua đường liên kết để tìm hiểu thêm chi tiết. Nếu không, hãy tham khảo tài liệu sau để 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. Proto này thu thập thông tin hữu ích cho hoạt động tương tác trực tiếp của người dùng.

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

object (PaymentMethodDisplayInfo)

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

enum (PaymentMethodProvenance)

Nguồn gốc của phương thức thanh toán được 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 mà đơ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
}
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ụ: Tài khoản thanh toán VISA **** 1234 **** 5678

Khuyến mãi

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
}
Trường
coupon

string

Bắt buộc: Mã giảm giá á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. Các thuộc tính này có thể áp dụng cho tất cả mục hàng bên trong đơn đặt hàng, trừ khi bị ghi đè trong 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)
    }
  ]
}
Trường
status

enum (PurchaseStatus)

Bắt buộc: Trạng thái chung cho đơn đặt hàng.
userVisibleStatusLabel

string

Nhãn/chuỗi 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 trả lại hàng của đơn đặt hàng.
fulfillmentInfo

object (PurchaseFulfillmentInfo)

Thông tin 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.

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

enum (PurchaseLocationType)

Địa điểm mua hàng (tại cửa hàng / trực tuyến)
errors[]

object (PurchaseError)

Không bắt buộc: Các lỗi khiến đơn đặt hàng này bị từ chối.

PurchaseError

Lỗi mà đơ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
}
Trường
type

enum (ErrorType)

Bắt buộc: Phần này cho biết lý do chi tiết khiến người bán từ chối đơn đặt hàng.
description

string

Nội dung mô tả bổ sung 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)

Phù hợp trong trường hợp xảy ra loại lỗi PRICE_CHANGED / INTRUE_PRICE.
availableQuantity

integer

Số lượng hàng hiện có. Có thể áp dụng trong trường hợp có long_CHANGED.

TicketOrderExtension

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

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

object (TicketEvent)

Sự kiện này đã á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 duy nhất.

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)
  }
}
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, đây phải là tên phim.
description

string

nội dung mô tả về sự kiện.
url

string

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

object (Location)

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

object (EventCharacter)

Các nhân vật 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 điện ảnh hay 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 vào cửa, 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 giờ vào cửa là 8:30 sáng.

EventCharacter

Một ký 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)
  }
}
Trường
type

enum (Type)

loại ký 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.