- Yêu cầu HTTP
- Tham số đường dẫn
- Nội dung yêu cầu
- Nội dung phản hồi
- OrderUpdate
- Loại
- UserNotification
Cập nhật Thứ tự từ 3p thành AOG. Trả về INVALID_ACCOUNT nếu id của đơn đặt hàng trống hoặc không bằng với đơn đặt hàng hiện tại.
Yêu cầu HTTP
PATCH https://actions.googleapis.com/v3/orders/{orderUpdate.order.merchantOrderId}
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Các tham số | |
---|---|
orderUpdate.order.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à 64 ký tự. |
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON | |
---|---|
{ "header": { object ( |
Các trường | ||
---|---|---|
header |
Tiêu đề của yêu cầu cập nhật đơn đặt hàng. |
|
orderUpdate.type |
Không dùng nữa: Thay vào đó, hãy sử dụng OrderUpdate.update_mask. Nếu loại = SNAPSHOT, OrderUpdate.order phải là toàn bộ đơn đặt hàng. Nếu loại = ORDER_STATUS, đây là sự thay đổi trạng thái cấp đơn đặt hàng. Chỉ đến thứ tự order.last_update_time và thứ hạng theo ngành dọc này mới được đến lấy. Lưu ý: type.ORDER_STATUS chỉ hỗ trợ nội dung cập nhật trạng thái PurcahaseOrderExtension và không có kế hoạch mở rộng phạm vi hỗ trợ này. Thay vào đó, bạn nên sử dụng updateMask vì phương thức này chung chung, dễ mở rộng và có thể dùng cho mọi ngành dọc. |
|
orderUpdate.order.googleOrderId |
Mã đơn hàng do Google chỉ định. |
|
orderUpdate.order.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. |
|
orderUpdate.order.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. |
|
orderUpdate.order.buyerInfo |
Thông tin về người mua. |
|
orderUpdate.order.image |
Hình ảnh liên quan đến đơn đặt hàng. |
|
orderUpdate.order.createTime |
Bắt buộc: Ngày và giờ đơn đặt hàng được tạo. Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, chính xác đến nano giây. Ví dụ: |
|
orderUpdate.order.lastUpdateTime |
Ngày và giờ đơn đặt hàng được cập nhật 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ụ: |
|
orderUpdate.order.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. |
|
orderUpdate.order.contents |
Bắt buộc: Nội dung đơn đặt hàng là một nhóm các mục hàng. |
|
orderUpdate.order.priceAttributes[] |
Giá, chiết khấu, thuế, v.v. |
|
orderUpdate.order.followUpActions[] |
Các hành động tiếp theo ở cấp đơn đặt hàng. |
|
orderUpdate.order.paymentData |
Dữ liệu liên quan đến thanh toán cho đơn đặt hàng. |
|
orderUpdate.order.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. |
|
orderUpdate.order.note |
Ghi chú đính kèm vào đơn đặt hàng. |
|
orderUpdate.order.promotions[] |
Tất cả chương trình khuyến mãi liên quan đến đơn đặt hàng này. |
|
orderUpdate.order.disclosures[] |
Thông tin công bố liên quan đến đơn đặt hàng này. |
|
orderUpdate.order.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 |
|
orderUpdate.updateMask |
Lưu ý: Sau đây là một số điều nên cân nhắc/đề xuất đối với các trường đặc biệt sau đây: 1. order.last_update_time sẽ luôn được cập nhật trong yêu cầu cập nhật. 2. order.create_time, order.google_order_id và order.merchant_order_id sẽ bị bỏ qua nếu bạn cung cấp thông tin này trong updateMask. Danh sách các tên trường đủ điều kiện được phân tách bằng dấu phẩy. Ví dụ: |
|
orderUpdate.userNotification |
Nếu được chỉ định, hiển thị thông báo cho người dùng cùng với tiêu đề và văn bản đã chỉ định. Chỉ định thông báo là một gợi ý để thông báo và không đảm bảo sẽ tạo ra thông báo. |
|
orderUpdate.reason |
Lý do thay đổi/cập nhật. |
|
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: |
||
orderUpdate.order.purchase |
Đơn đặt hàng |
|
orderUpdate.order.ticket |
Đặt vé |
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của Order
.
OrderUpdate
Cập nhật thành đơn đặt hàng.
Biểu diễn dưới dạng JSON | |
---|---|
{ "type": enum ( |
Các trường | |
---|---|
type |
Không dùng nữa: Thay vào đó, hãy sử dụng OrderUpdate.update_mask. Nếu loại = SNAPSHOT, OrderUpdate.order phải là toàn bộ đơn đặt hàng. Nếu loại = ORDER_STATUS, đây là sự thay đổi trạng thái cấp đơn đặt hàng. Chỉ đến thứ tự order.last_update_time và thứ hạng theo ngành dọc này mới được đến lấy. Lưu ý: type.ORDER_STATUS chỉ hỗ trợ nội dung cập nhật trạng thái PurcahaseOrderExtension và không có kế hoạch mở rộng phạm vi hỗ trợ này. Thay vào đó, bạn nên sử dụng updateMask vì phương thức này chung chung, dễ mở rộng và có thể dùng cho mọi ngành dọc. |
order |
|
updateMask |
Lưu ý: Sau đây là một số điều nên cân nhắc/đề xuất đối với các trường đặc biệt sau đây: 1. order.last_update_time sẽ luôn được cập nhật trong yêu cầu cập nhật. 2. order.create_time, order.google_order_id và order.merchant_order_id sẽ bị bỏ qua nếu bạn cung cấp thông tin này trong updateMask. Danh sách các tên trường đủ điều kiện được phân tách bằng dấu phẩy. Ví dụ: |
userNotification |
Nếu được chỉ định, hiển thị thông báo cho người dùng cùng với tiêu đề và văn bản đã chỉ định. Chỉ định thông báo là một gợi ý để thông báo và không đảm bảo sẽ tạo ra thông báo. |
reason |
Lý do thay đổi/cập nhật. |
Loại
Không dùng nữa: Thay vào đó, hãy sử dụng OrderUpdate.update_mask. Cho phép cập nhật đơn đặt hàng.
Enum | |
---|---|
TYPE_UNSPECIFIED |
Chưa chỉ định loại, không nên đặt loại này một cách rõ ràng. |
ORDER_STATUS |
Chỉ cập nhật trạng thái của đơn đặt hàng. |
SNAPSHOT |
Cập nhật thông tin tổng quan nhanh về đơn đặt hàng. |
UserNotification
Thông báo không bắt buộc cho người dùng trong nội dung cập nhật về Đơn đặt hàng.
Biểu diễn dưới dạng JSON | |
---|---|
{ "title": string, "text": string } |
Các trường | |
---|---|
title |
Tiêu đề của thông báo cho người dùng. Độ dài tối đa cho phép là 30 ký tự. |
text |
Nội dung của thông báo. Độ dài tối đa cho phép là 100 ký tự. |