- Biểu diễn dưới dạng JSON
- Nội dung
- PaymentData
- PaymentResult
- PaymentInfo
- PaymentMethodDisplayInfo
- Khuyến mãi
- PurchaseOrderExtension
- PurchaseError
- TicketOrderExtension
- TicketEvent
- EventCharacter (Ký tự sự kiện)
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 ( |
Các trường | ||
---|---|---|
googleOrderId |
Mã đơn hàng do Google chỉ định. |
|
merchantOrderId |
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 |
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 |
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 |
thông tin về người mua. |
|
image |
Hình ảnh liên quan đến đơn đặt hàng. |
|
createTime |
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ụ: |
|
lastUpdateTime |
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ụ: |
|
transactionMerchant |
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 |
Bắt buộc: Nội dung đơn đặt hàng là một nhóm các mục hàng. |
|
priceAttributes[] |
Giá, chiết khấu, thuế, v.v. |
|
followUpActions[] |
Các hành động tiếp theo ở cấp đơn đặt hàng. |
|
paymentData |
Dữ liệu liên quan đến thanh toán cho đơn đặt hàng. |
|
termsOfServiceUrl |
Đườ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 |
Ghi chú đính kèm vào đơn đặt hàng. |
|
promotions[] |
Tất cả chương trình khuyến mãi liên quan đến đơn đặt hàng này. |
|
disclosures[] |
Thông tin công bố liên quan đến đơn đặt hàng này. |
|
vertical |
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à: Đối tượng chứa các trường thuộc kiểu tuỳ ý. Trường bổ sung |
|
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 |
Đơn đặt hàng |
|
ticket |
Đặ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 ( |
Các trường | |
---|---|
lineItems[] |
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 ( |
Các trường | |
---|---|
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 |
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 |
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 |
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 |
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 ( |
Các trường | |
---|---|
paymentMethodDisplayInfo |
Thông tin hiển thị của phương thức thanh toán mà giao dịch sử dụng. |
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 ( |
Các trường | |
---|---|
paymentType |
Loại thanh toán. |
paymentMethodDisplayName |
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 |
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 ( |
Các trường | |
---|---|
status |
Bắt buộc: Tình trạng chung của đơn đặt hàng. |
userVisibleStatusLabel |
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 |
Bắt buộc: loại giao dịch mua. |
returnsInfo |
Thông tin về trường hợp trả lại hàng của đơn đặt hàng. |
fulfillmentInfo |
Thông tin về việc thực hiện đơn đặt hàng. |
extension |
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 |
purchaseLocationType |
Vị trí mua hàng (tại cửa hàng / trực tuyến) |
errors[] |
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 ( |
Các trường | |
---|---|
type |
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 |
Nội dung mô tả khác về lỗi. |
entityId |
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 |
Có liên quan trong trường hợp loại lỗiPRICE_CHANGED / INChỉnh sửa_PRICE. |
availableQuantity |
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 ( |
Các trường | |
---|---|
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 ( |
Các trường | |
---|---|
type |
Bắt buộc: loại sự kiện bán vé, ví dụ: phim, buổi hoà nhạc. |
name |
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 |
mô tả sự kiện. |
url |
URL dẫn đến thông tin sự kiện. |
location |
Địa điểm diễn ra sự kiện hoặc trụ sở của một tổ chức. |
eventCharacters[] |
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 |
Thời gian bắt đầu. |
endDate |
Thời gian kết thúc. |
doorTime |
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 ( |
Các trường | |
---|---|
type |
loại nhân vật sự kiện, ví dụ: diễn viên hoặc đạo diễn. |
name |
tên của nhân vật. |
image |
Hình ảnh của nhân vật. |