Method: orders.patch

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

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à 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 (OrderRequestHeader)
  },
  "orderUpdate": {
    "type": enum (Type),
    "order": {
      "googleOrderId": 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.
    },
    "updateMask": string,
    "userNotification": {
      object (UserNotification)
    },
    "reason": string
  }
}
Các trường
header

object (OrderRequestHeader)

Tiêu đề của yêu cầu cập nhật đơn đặt hàng.

orderUpdate.type
(deprecated)

enum (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

string

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

orderUpdate.order.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.

orderUpdate.order.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.

orderUpdate.order.buyerInfo

object (UserInfo)

Thông tin về người mua.

orderUpdate.order.image

object (Image)

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

orderUpdate.order.createTime

string (Timestamp format)

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ụ: "2014-10-02T15:01:23.045123456Z"

orderUpdate.order.lastUpdateTime

string (Timestamp format)

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ụ: "2014-10-02T15:01:23.045123456Z"

orderUpdate.order.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.

orderUpdate.order.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.

orderUpdate.order.priceAttributes[]

object (PriceAttribute)

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

orderUpdate.order.followUpActions[]

object (Action)

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

orderUpdate.order.paymentData

object (PaymentData)

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

orderUpdate.order.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.

orderUpdate.order.note

string

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

orderUpdate.order.promotions[]

object (Promotion)

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

orderUpdate.order.disclosures[]

object (Disclosure)

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

orderUpdate.order.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" }.

orderUpdate.updateMask

string (FieldMask format)

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ụ: "user.displayName,photo"

orderUpdate.userNotification

object (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

string

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

object (PurchaseOrderExtension)

Đơn đặt hàng

orderUpdate.order.ticket

object (TicketOrderExtension)

Đặ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 (Type),
  "order": {
    object (Order)
  },
  "updateMask": string,
  "userNotification": {
    object (UserNotification)
  },
  "reason": string
}
Các trường
type
(deprecated)

enum (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

object (Order)

updateMask

string (FieldMask format)

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ụ: "user.displayName,photo"

userNotification

object (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

string

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

string

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

string

Nội dung của thông báo. Độ dài tối đa cho phép là 100 ký tự.