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é

UserInfo

Thông tin về người dùng. Thuộc tính này dùng để trình bày thông tin của người dùng liên quan đến đơn đặt hàng.

Biểu diễn dưới dạng JSON 
{
  "email": string,
  "firstName": string,
  "lastName": string,
  "displayName": string,
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ]
}
Trường
email

string

Email của người dùng, ví dụ: janedoe@gmail.com.

firstName

string

Tên của người dùng.

lastName

string

Họ của người dùng.

displayName

string

Tên hiển thị của người dùng, có thể khác với họ hoặc tên.

phoneNumbers[]

object (PhoneNumber)

Số điện thoại của người dùng.

PhoneNumber

Đại diện tiêu chuẩn bằng số điện thoại.

Biểu diễn dưới dạng JSON 
{
  "e164PhoneNumber": string,
  "extension": string,
  "preferredDomesticCarrierCode": string
}
Trường
e164PhoneNumber

string

Số điện thoại ở định dạng E.164, theo định nghĩa trong Khuyến nghị E.164 của Liên minh Viễn thông Quốc tế (ITU). Đường liên kết đến wiki: https://en.wikipedia.org/wiki/E.164

extension

string

Phần mở rộng không được chuẩn hoá trong các đề xuất của ITU, ngoại trừ việc được định nghĩa là một chuỗi số có độ dài tối đa là 40 chữ số. Giá trị này được định nghĩa là một chuỗi ở đây để phù hợp với việc sử dụng có thể sử dụng số 0 ở đầu trong phần mở rộng (các tổ chức có toàn quyền làm như vậy, vì không có tiêu chuẩn được xác định). Ngoại trừ chữ số, một số ký tự quay số khác như "," (cho biết thời gian chờ) có thể được lưu trữ tại đây. Ví dụ: trong số máy lẻ xxx-xxx-xxxx. 123, "123" là phần mở rộng.

preferredDomesticCarrierCode

string

Mã chọn nhà mạng được ưu tiên khi gọi trong nước cho số điện thoại này. Quy định này cũng áp dụng cho mã cần quay số ở một số quốc gia khi gọi từ điện thoại cố định sang điện thoại di động hoặc ngược lại. Ví dụ: ở Columbia, "3" cần phải được gọi trước số điện thoại khi gọi từ điện thoại di động đến điện thoại cố định trong nước và ngược lại. https://en.wikipedia.org/wiki/Telephone_numbers_in_Colombia https://en.wikipedia.org/wiki/Brazilian_Carrier_Selection_Code

Lưu ý rằng đây là "ưu tiên" có nghĩa là các mã khác cũng có thể hoạt động.

Bài đăng có hình ảnh

Hình ảnh hiển thị trong thẻ.

Biểu diễn dưới dạng JSON 
{
  "url": string,
  "accessibilityText": string,
  "height": number,
  "width": number
}
Trường
url

string

URL nguồn của hình ảnh. Hình ảnh có thể ở định dạng JPG, PNG và GIF (ảnh động và tĩnh). Ví dụ: https://www.agentx.com/logo.png. Bắt buộc.

accessibilityText

string

Nội dung mô tả bằng văn bản của hình ảnh dùng để tăng khả năng tiếp cận, ví dụ: trình đọc màn hình. Bắt buộc.

height

number

Chiều cao của hình ảnh tính bằng pixel. Không bắt buộc.

width

number

Chiều rộng của hình ảnh tính bằng pixel. Không bắt buộc.

Người bán

Người bán cho giỏ hàng/đơn đặt hàng/mục hàng.

Biểu diễn dưới dạng JSON 
{
  "id": string,
  "name": string,
  "image": {
    object (Image)
  },
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ],
  "address": {
    object (Location)
  }
}
Trường
id

string

Mã nhận dạng không bắt buộc được chỉ định cho người bán (nếu có).

name

string

Tên của người bán, chẳng hạn như "Bánh mì Panera".

image

object (Image)

Hình ảnh liên kết với người bán.

phoneNumbers[]

object (PhoneNumber)

Số điện thoại của người bán.

address

object (Location)

Địa chỉ của người bán.

Vị trí

Vùng chứa đại diện cho một vị trí.

Biểu diễn dưới dạng JSON 
{
  "coordinates": {
    object (LatLng)
  },
  "formattedAddress": string,
  "zipCode": string,
  "city": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "name": string,
  "phoneNumber": string,
  "notes": string,
  "placeId": string
}
Trường
coordinates

object (LatLng)

Toạ độ địa lý. Yêu cầu [DEVICE_PRECISE_LOCATION] Quyền [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION].
formattedAddress

string

Địa chỉ hiển thị, ví dụ: "1600 Amphitheatre Pkwy, Mountain View, CA 94043". Yêu cầu [DEVICE_PRECISE_LOCATION] Quyền [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION].
zipCode

string

Mã bưu chính. Yêu cầu [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] hoặc [DEVICE_COARSE_LOCATION] Quyền [google.actions.v2.Permission.DEVICE_COARSE_LOCATION].
city

string

Thành phố. Yêu cầu [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] hoặc [DEVICE_COARSE_LOCATION] Quyền [google.actions.v2.Permission.DEVICE_COARSE_LOCATION].
postalAddress

object (PostalAddress)

Địa chỉ bưu chính. Yêu cầu [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] hoặc [DEVICE_COARSE_LOCATION] Quyền [google.actions.v2.Permission.DEVICE_COARSE_LOCATION].
name

string

Tên địa điểm.

phoneNumber

string

Số điện thoại của vị trí, ví dụ: số điện thoại liên hệ của địa điểm doanh nghiệp hoặc số điện thoại của địa điểm giao hàng.

notes

string

Ghi chú về vị trí.

placeId

string

locationId được sử dụng với Places API để tìm nạp thông tin chi tiết về một địa điểm. Hãy xem https://developers.google.com/places/web-service/place-id

LatLng

Đối tượng đại diện cho cặp vĩ độ/kinh độ. Đối số này được biểu thị bằng cặp đôi đại diện cho vĩ độ và độ kinh độ. Trừ phi có quy định khác, tên này phải tuân thủ tiêu chuẩn WGS84. Giá trị phải nằm trong phạm vi chuẩn hoá.

Biểu diễn dưới dạng JSON 
{
  "latitude": number,
  "longitude": number
}
Trường
latitude

number

Vĩ độ tính bằng độ. Giá trị này phải nằm trong khoảng [-90.0, +90.0].

longitude

number

Kinh độ tính bằng độ. Giá trị này phải nằm trong khoảng [-180.0, +180.0].

PostalAddress (Địa chỉ bưu điện)

Đại diện cho địa chỉ bưu chính, ví dụ: cho địa chỉ giao hàng qua bưu điện hoặc địa chỉ thanh toán. Khi có địa chỉ bưu chính, dịch vụ bưu chính có thể giao hàng đến trụ sở là P.O. Hộp hoặc thứ tự tương tự. Tính năng này không nhằm lập mô hình vị trí địa lý (đường, thị trấn, núi).

Trong cách sử dụng thông thường, một địa chỉ sẽ được tạo thông qua hoạt động đầu vào của người dùng hoặc từ việc nhập dữ liệu hiện có, tuỳ thuộc vào loại quy trình.

Lời khuyên về việc nhập / chỉnh sửa địa chỉ: – Sử dụng tiện ích địa chỉ hỗ trợ i18n, chẳng hạn như https://github.com/google/libaddressinput) – Không nên cung cấp cho người dùng các phần tử trên giao diện người dùng để nhập hoặc chỉnh sửa các trường ở bên ngoài quốc gia sử dụng trường đó.

Để biết thêm hướng dẫn về cách sử dụng giản đồ này, vui lòng xem: https://support.google.com/business/answer/6397478

Biểu diễn dưới dạng JSON 
{
  "revision": number,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
Trường
revision

number

Bản sửa đổi giản đồ của PostalAddress. Giá trị này phải được đặt thành 0, đây là bản sửa đổi mới nhất.

Tất cả các bản sửa đổi mới phải tương thích ngược với các bản sửa đổi cũ.
regionCode

string

Bắt buộc. Mã vùng CLDR của quốc gia/khu vực trong địa chỉ. Điều này không bao giờ được dự đoán và việc đảm bảo giá trị chính xác là tuỳ thuộc vào người dùng. Hãy tham khảo http://cldr.unicode.org/ và http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html để biết thông tin chi tiết. Ví dụ: "CH" cho Thuỵ Sĩ.

languageCode

string

Không bắt buộc. Mã ngôn ngữ BCP-47 của nội dung địa chỉ này (nếu biết). Đây thường là ngôn ngữ giao diện người dùng của biểu mẫu nhập hoặc được yêu cầu khớp với một trong các ngôn ngữ được sử dụng trong địa chỉ quốc gia/khu vực hoặc từ tương đương được chuyển tự của chúng. Điều này có thể ảnh hưởng đến việc định dạng ở một số quốc gia nhất định, nhưng không quan trọng đối với độ chính xác của dữ liệu và sẽ không bao giờ ảnh hưởng đến bất kỳ hoạt động xác thực hoặc hoạt động nào khác không liên quan đến việc định dạng.

Nếu không biết giá trị này, bạn nên bỏ qua giá trị này (thay vì chỉ định giá trị mặc định có thể không chính xác).

Ví dụ: "zh-Hant", "ja", "ja-Latn", "en".
postalCode

string

Không bắt buộc. Mã bưu chính của địa chỉ. Không phải quốc gia nào cũng sử dụng hoặc yêu cầu mã bưu chính phải xuất hiện, nhưng ở Hoa Kỳ, các quốc gia đó có thể kích hoạt quy trình xác thực bổ sung với các phần khác của địa chỉ (ví dụ: xác thực tiểu bang/mã bưu chính tại Hoa Kỳ).

sortingCode

string

Không bắt buộc. Mã phân loại bổ sung, theo quốc gia cụ thể. Thông tin này không được sử dụng ở hầu hết các khu vực. Khi giá trị được sử dụng, giá trị phải là một chuỗi như "CEDEX", có thể theo sau là một số (ví dụ: "CEDEX 7") hoặc chỉ một số, đại diện cho "mã lĩnh vực" (Jamaica), "chỉ báo khu vực giao hàng" (Malawi) hoặc "chỉ báo tại bưu điện" (ví dụ: Bờ Biển Ngà).

administrativeArea

string

Không bắt buộc. Phân khu hành chính cao nhất dùng cho địa chỉ bưu chính của một quốc gia hoặc khu vực. Ví dụ: bạn có thể nhập một tiểu bang, một tỉnh, một vùng hoặc một tỉnh. Cụ thể, đối với Tây Ban Nha, đây là tỉnh và không phải là cộng đồng tự trị (ví dụ: "Barcelona" chứ không phải "Catalonia"). Nhiều quốc gia không sử dụng khu vực hành chính trong địa chỉ bưu điện. Ví dụ: ở Thuỵ Sĩ thì không nên điền giá trị này.

locality

string

Không bắt buộc. Nói chung là phần thành phố/thị trấn của địa chỉ. Ví dụ: Thành phố ở Hoa Kỳ, xã CNTT, thị trấn có bưu điện của Vương quốc Anh. Trong các khu vực trên thế giới nơi các địa phương không được xác định rõ hoặc không phù hợp với cấu trúc này, hãy để trống địa phương và sử dụng addressLines.

sublocality

string

Không bắt buộc. Quận/phường của địa chỉ. Ví dụ: đây có thể là vùng lân cận, thị xã, quận.

addressLines[]

string

Dòng địa chỉ phi cấu trúc mô tả các cấp thấp hơn của một địa chỉ.

Do các giá trị trong addressLines không có thông tin về loại và đôi khi có thể chứa nhiều giá trị trong một trường (ví dụ: "Austin, TX"), điều quan trọng là thứ tự dòng phải rõ ràng. Thứ tự của các dòng địa chỉ phải là "thứ tự phong bì" cho quốc gia/khu vực trong địa chỉ. Ở những nơi giá trị này có thể thay đổi (ví dụ: Nhật Bản), address_language được sử dụng để thể hiện rõ ràng (ví dụ: "ja" cho thứ tự từ lớn đến nhỏ và "ja-Latn" hoặc "en" cho từ nhỏ đến lớn). Bằng cách này, dòng địa chỉ cụ thể nhất có thể được chọn dựa trên ngôn ngữ.

Cách biểu diễn cấu trúc tối thiểu được phép của một địa chỉ bao gồm một Mã vùng với tất cả thông tin còn lại được đặt trong Dòng địa chỉ. Có thể định dạng một địa chỉ như vậy gần như mà không cần mã hoá địa lý, nhưng không thể lập luận ngữ nghĩa về bất kỳ thành phần địa chỉ nào cho đến khi địa chỉ đó được giải quyết ít nhất một phần.

Tạo một địa chỉ chỉ chứa mã vùng và addressLines, sau đó mã hóa địa lý là cách được khuyến nghị để xử lý các địa chỉ hoàn toàn không có cấu trúc (trái ngược với việc đoán phần nào của địa chỉ sẽ là địa phương hoặc khu vực hành chính).
recipients[]

string

Không bắt buộc. Người nhận tại địa chỉ. Trong một số trường hợp nhất định, trường này có thể chứa thông tin nhiều dòng. Ví dụ: thẻ có thể chứa từ "chăm sóc" của bạn.

organization

string

Không bắt buộc. Tên của tổ chức tại địa chỉ.

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 là 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.

LineItem

Một mục hàng chứa một ngành dọc. Một đơn đặt hàng hoặc giỏ hàng có thể có nhiều mục hàng thuộc cùng một ngành dọc. Bạn nên xác định các mục hàng phụ/tiện ích bổ sung, v.v. trong các giao thức dọc tuỳ thuộc vào trường hợp sử dụ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 
{
  "id": string,
  "name": string,
  "userVisibleStateLabel": string,
  "provider": {
    object (Merchant)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "recipients": [
    {
      object (UserInfo)
    }
  ],
  "image": {
    object (Image)
  },
  "description": string,
  "notes": [
    string
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseItemExtension)
  },
  "reservation": {
    object (ReservationItemExtension)
  }
  // End of list of possible types for union field verticals.
}
Trường
id

string

Bắt buộc: Giá trị nhận dạng được chỉ định cho người bán cho mục hàng. Dùng để xác định mục hàng hiện có khi áp dụng nội dung cập nhật một phần. Độ dài tối đa cho phép là 64 ký tự.

name

string

Tên của mục hàng như trên biên nhận. Độ dài tối đa cho phép là 100 ký tự.

userVisibleStateLabel
(deprecated)

string

Không dùng nữa. Thay vào đó, hãy sử dụng trạng thái cấp độ dọc. Ví dụ: đối với giao dịch mua hàng, hãy sử dụng PurchaseOrderExtension.status. Nhãn hiển thị cho người dùng về trạng thái của mục hàng này.
provider

object (Merchant)

Nhà cung cấp mục hàng cụ thể, nếu khác với đơn đặt hàng tổng thể. Ví dụ: Đơn đặt hàng trên Expedia có nhà cung cấp mục hàng ANA.

priceAttributes[]

object (PriceAttribute)

Giá và mức điều chỉnh ở cấp mục hàng.

followUpActions[]

object (Action)

Hành động theo dõi tại mục hàng.

recipients[]

object (UserInfo)

Khách hàng cấp mục hàng, thông tin này có thể khác với người mua cấp Đơn đặt hàng. Ví dụ: Người dùng X đã đặt chỗ tại nhà hàng theo tên của người dùng Y.

image

object (Image)

Hình ảnh nhỏ liên kết với mặt hàng này, nếu có.

description

string

Mô tả mục hàng.

notes[]

string

Các lưu ý bổ sung áp dụng cho mục hàng cụ thể này, ví dụ: chính sách huỷ.

disclosures[]

object (Disclosure)

Thông tin công bố liên quan đến mục hàng này.

vertical
(deprecated)

object

Không dùng nữa: Sử dụng ngành dọc. Bắt buộc: Nội dung ngữ nghĩa của mục hàng dựa trên loại/ngành dọc của mục hàng. Mỗi ngành dọc nên bao gồm thông tin chi tiết về việc thực hiện đơn hàng riêng. Phải là một trong các giá trị sau: google.actions.orders.v3.verticals.purchase.PurchaseItemExtension google.actions.orders.v3.verticals.reservation.ReservationItemExtension google.actions.orders.v3.verticals.ticket.TicketItemExtension

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. Bắt buộc: Nội dung ngữ nghĩa của mục hàng dựa trên loại/ngành dọc của mục hàng. Mỗi ngành dọc nên bao gồm thông tin chi tiết về việc thực hiện đơn hàng riêng. verticals chỉ có thể là một trong những trạng thái sau đây:
purchase

object (PurchaseItemExtension)

Các đơn đặt hàng như hàng hoá, thực phẩm, v.v.

reservation

object (ReservationItemExtension)

Đặt chỗ trước như nhà hàng, cắt tóc, v.v.

PriceAttribute

Thuộc tính giá của một đơn đặt hàng hoặc mục hàng.

Biểu diễn dưới dạng JSON 
{
  "type": enum (Type),
  "name": string,
  "state": enum (State),
  "taxIncluded": boolean,

  // Union field spec can be only one of the following:
  "amount": {
    object (Money)
  },
  "amountMillipercentage": number
  // End of list of possible types for union field spec.
}
Trường
type

enum (Type)

Bắt buộc: Thuộc tính loại tiền.

name

string

Bắt buộc: Chuỗi do người dùng hiển thị của thuộc tính giá. Email này do người bán gửi và bản địa hoá.

state

enum (State)

Bắt buộc: Tình trạng của giá: Ước tính so với thực tế.

taxIncluded

boolean

Liệu giá đã bao gồm thuế hay chưa.

Trường kết hợp spec. Đại diện cho số tiền hoặc mili phần trăm. spec chỉ có thể là một trong những trạng thái sau đây:
amount

object (Money)

Số tiền.

amountMillipercentage
(deprecated)

number

Tỷ lệ phần trăm: 1/1000 Ví dụ: 8,750% được thể hiện là 8750, tỷ lệ phần trăm âm thể hiện tỷ lệ phần trăm chiết khấu. Không dùng trường này nữa. Có thể cân nhắc việc thêm lại ứng dụng khi cần có một trường hợp sử dụng vững chắc.

Loại

Đại diện cho loại tiền.

Enum
TYPE_UNSPECIFIED Loại chưa được chỉ định, ứng dụng không cần phải đặt thông tin này một cách rõ ràng.
REGULAR Giá hiển thị thông thường, trước khi áp dụng các khoản chiết khấu, v.v.
DISCOUNT Cần trừ vào tổng thành tiền.
TAX Cần thêm vào thành tiền.
DELIVERY Cần thêm vào thành tiền.
SUBTOTAL Tổng phụ phí trước khi có thể được thêm vào một số khoản phí.
FEE Mọi khoản phí bổ sung.
GRATUITY Cần thêm vào thành tiền.
TOTAL Giá hiển thị của đơn đặt hàng hoặc mục hàng.

Tiểu bang

Biểu thị trạng thái giá.

Enum
STATE_UNSPECIFIED Chưa chỉ định.
ESTIMATE Giá chỉ là ước tính.
ACTUAL Giá thực tế sẽ được tính cho người dùng.

Tiền

Đại diện cho số tiền kèm theo loại đơn vị tiền tệ.

Biểu diễn dưới dạng JSON 
{
  "currencyCode": string,
  "amountInMicros": string
}
Trường
currencyCode

string

Mã đơn vị tiền tệ gồm 3 chữ cái được xác định trong ISO 4217.

amountInMicros

string (int64 format)

Số tiền tính bằng phần triệu. Ví dụ: trường này phải được đặt là 1990000 với giá $1, 99.

Hành động

Một hành động tiếp theo được liên kết với đơn đặt hàng hoặc mục hàng.

Biểu diễn dưới dạng JSON 
{
  "type": enum (Type),
  "title": string,
  "openUrlAction": {
    object (OpenUrlAction)
  },
  "actionMetadata": {
    object (ActionMetadata)
  }
}
Trường
type

enum (Type)

Bắt buộc: Loại tác vụ.

title

string

Tiêu đề hoặc nhãn của thao tác, hiển thị cho người dùng. Độ dài tối đa cho phép là 100 ký tự.

openUrlAction

object (OpenUrlAction)

Việc cần làm.

actionMetadata

object (ActionMetadata)

Siêu dữ liệu liên kết với một hành động.

Loại

Những hành động tiếp theo có thể thực hiện.

Enum
TYPE_UNSPECIFIED Hành động không xác định.
VIEW_DETAILS Thao tác xem chi tiết đơn đặt hàng.
MODIFY Sửa đổi thao tác đối với đơn đặt hàng.
CANCEL Thao tác huỷ đơn đặt hàng.
RETURN Thao tác trả lại hàng.
EXCHANGE Thao tác đặt hàng Exchange.
EMAIL

Hành động đối với email. Các loại EMAIL và CALL không được dùng nữa. Có thể sử dụng openUrlAction.url làm số điện thoại hoặc email.
CALL

Hành động gọi.
REORDER Sắp xếp lại hành động.
REVIEW Xem lại hành động đặt hàng.
CUSTOMER_SERVICE Liên hệ với bộ phận dịch vụ khách hàng.
FIX_ISSUE Hãy chuyển thẳng đến trang web hoặc ứng dụng của người bán để khắc phục vấn đề.
DIRECTION Đường liên kết đến đường đi.

OpenUrlAction

Mở URL đã cho.

Biểu diễn dưới dạng JSON 
{
  "url": string,
  "androidApp": {
    object (AndroidApp)
  },
  "urlTypeHint": enum (UrlTypeHint)
}
Trường
url

string

Trường URL có thể là bất kỳ trường hợp nào sau đây: – URL http/https để mở một Ứng dụng liên kết với ứng dụng hoặc một trang web

androidApp

object (AndroidApp)

Thông tin về Ứng dụng Android nếu ứng dụng Android dự kiến sẽ thực hiện URL.

urlTypeHint

enum (UrlTypeHint)

Cho biết gợi ý về loại url.

AndroidApp

Thông số kỹ thuật của Ứng dụng Android cho các quy tắc hạn chế về phương thức thực hiện

Biểu diễn dưới dạng JSON 
{
  "packageName": string,
  "versions": [
    {
      object (VersionFilter)
    }
  ]
}
Trường
packageName

string

Bạn phải chỉ định tên gói Tên gói khi chỉ định Phương thức thực hiện Android.

versions[]

object (VersionFilter)

Khi bạn chỉ định nhiều bộ lọc, mọi kết quả khớp bộ lọc sẽ kích hoạt ứng dụng.

VersionFilter

VersionFilter nên được bao gồm nếu yêu cầu (các) phiên bản cụ thể của Ứng dụng.

Biểu diễn dưới dạng JSON 
{
  "minVersion": number,
  "maxVersion": number
}
Trường
minVersion

number

Mã phiên bản tối thiểu hoặc 0, bao gồm cả hai giá trị này.

maxVersion

number

Mã phiên bản tối đa, bao gồm cả hai giá trị này. Dải ô được xem xét là [minVersion:maxVersion]. Phạm vi rỗng ngụ ý mọi phiên bản. Ví dụ: Để chỉ định một phiên bản, hãy sử dụng: [target_version:target_version]. Để chỉ định một phiên bản bất kỳ, hãy không chỉ định minVersion và maxVersion. Để chỉ định tất cả các phiên bản cho đến maxVersion, hãy không chỉ định minVersion. Để chỉ định tất cả các phiên bản từ minVersion, hãy không chỉ định maxVersion.

UrlTypeHint

Các loại gợi ý URL khác nhau.

Enum
URL_TYPE_HINT_UNSPECIFIED Không xác định
AMP_CONTENT URL trỏ trực tiếp đến nội dung AMP hoặc đến một URL chính tắc tham chiếu đến nội dung AMP thông qua <link rel="amphtml">.

ActionMetadata

Siêu dữ liệu liên quan cho mỗi hành động.

Biểu diễn dưới dạng JSON 
{
  "expireTime": string
}
Trường
expireTime

string (Timestamp format)

Thời điểm mà hành động này sẽ hết hạn.

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"

Thông tin công bố

Thông tin công bố về sản phẩm, dịch vụ hoặc chính sách có thể hiển thị cho người dùng.

Biểu diễn dưới dạng JSON 
{
  "title": string,
  "disclosureText": {
    object (DisclosureText)
  },
  "presentationOptions": {
    object (DisclosurePresentationOptions)
  }
}
Trường
title

string

Tiêu đề của thông tin công bố. Ví dụ: "Thông tin an toàn".

disclosureText

object (DisclosureText)

Nội dung của thông tin công bố. Được phép sử dụng đường liên kết trang web.

presentationOptions

object (DisclosurePresentationOptions)

Các lựa chọn trình bày về việc công bố thông tin.

DisclosureText

Đại diện cho một văn bản thuần tuý có các đường liên kết trang web.

Biểu diễn dưới dạng JSON 
{
  "template": string,
  "textLinks": [
    {
      object (TextLink)
    }
  ]
}
Trường
template

string

Văn bản hiển thị, chứa phần giữ chỗ như "{0}" và "{1}" cho mỗi đường liên kết văn bản cần chèn vào. Ví dụ: "CẢNH BÁO: Sản phẩm này có thể khiến bạn tiếp xúc với các hoá chất được tiểu bang California xác định là gây ung thư. Để biết thêm thông tin, hãy truy cập {0}." Văn bản thông tin công bố này không được chứa bất kỳ nội dung quảng cáo hoặc nội dung tương tự quảng cáo nào.

DisclosurePresentationOptions

Các lựa chọn trình bày thông tin công bố.

Biểu diễn dưới dạng JSON 
{
  "presentationRequirement": enum (PresentationRequirement),
  "initiallyExpanded": boolean
}
Trường
presentationRequirement

enum (PresentationRequirement)

Yêu cầu về việc trình bày thông tin công bố.

initiallyExpanded

boolean

Liệu nội dung của thông tin công bố có nên được mở rộng ban đầu hay không. Theo mặc định, ban đầu, thanh này sẽ được thu gọn.

PresentationRequirement

Yêu cầu về việc trình bày thông tin công bố.

Enum
REQUIREMENT_UNSPECIFIED Yêu cầu chưa xác định. Không nên đặt giá trị này một cách rõ ràng.
REQUIREMENT_OPTIONAL Bạn không bắt buộc phải công bố thông tin. Bạn có thể bỏ qua thuộc tính này nếu thiết bị không hỗ trợ hiển thị thông tin công bố.
REQUIREMENT_REQUIRED Bạn phải công bố thông tin. Cuộc trò chuyện sẽ được chuyển sang điện thoại nếu thiết bị của bạn không hỗ trợ hiển thị thông tin công bố.

PurchaseItemExtension

Nội dung mục hàng của Ngành dọc mua hàng.

Biểu diễn dưới dạng JSON 
{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "productId": string,
  "quantity": number,
  "unitMeasure": {
    object (MerchantUnitMeasure)
  },
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "itemOptions": [
    {
      object (ItemOption)
    }
  ],
  "extension": {
    "@type": string,
    field1: ...,
    ...
  },
  "productDetails": {
    object (ProductDetails)
  }
}
Trường
status

enum (PurchaseStatus)

Bắt buộc: Trạng thái cấp mục hàng.

userVisibleStatusLabel

string

Bắt buộc: 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.

productId
(deprecated)

string

Mã sản phẩm hoặc ưu đãi liên kết với mục hàng này.
quantity

number

Số lượng của mặt hàng.

unitMeasure

object (MerchantUnitMeasure)

Số lượng đo lường đơn vị. Chỉ định kích thước của mặt hàng theo đơn vị đã chọn. Kích thước cùng với giá đang được sử dụng để xác định đơn giá.

returnsInfo

object (PurchaseReturnsInfo)

Thông tin trả về của mục hàng này. Nếu bạn không đặt chính sách này, mục hàng này sẽ kế thừa thông tin trả về cấp đơn đặt hàng.

fulfillmentInfo

object (PurchaseFulfillmentInfo)

Thông tin thực hiện đơn hàng cho mục hàng này. Nếu bạn không đặt chính sách này, mục hàng này sẽ kế thừa thông tin về việc thực hiện đơn đặt hàng ở cấp đơn đặt hàng.

itemOptions[]

object (ItemOption)

Tiện ích bổ sung hoặc mục phụ bổ sung.

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" }.
productDetails

object (ProductDetails)

Thông tin chi tiết về sản phẩm.

PurchaseStatus

Trạng thái mua hàng liên kết với một đơn đặt hàng hoặc một mục hàng cụ thể.

Enum
PURCHASE_STATUS_UNSPECIFIED Trạng thái chưa xác định.
READY_FOR_PICKUP Sẵn sàng để nhận hàng.
SHIPPED Đã giao hàng.
DELIVERED Đã gửi thành công.
OUT_OF_STOCK Hết hàng.
IN_PREPARATION "IN_PREPARATION" có thể có ý nghĩa khác nhau trong ngữ cảnh khác nhau. Đối với đơn đặt hàng THỰC PHẨM, đó có thể là thực phẩm đang được chuẩn bị. Đối với Nhà bán lẻ, đây có thể là một mặt hàng đang được đóng gói.
CREATED Đơn đặt hàng đã được tạo.
CONFIRMED Người bán đã xác nhận đơn đặt hàng.
REJECTED Người bán đã từ chối đơn đặt hàng hoặc mục hàng.
RETURNED Mặt hàng đã được người dùng trả về.
CANCELLED Đơn đặt hàng hoặc mục hàng đã bị người dùng huỷ.
CHANGE_REQUESTED Người dùng đã yêu cầu thay đổi đơn đặt hàng và đối tác tích hợp đang xử lý thay đổi này. Đơn đặt hàng phải được chuyển sang một trạng thái khác sau khi yêu cầu được xử lý.

PurchaseType

Danh mục giao dịch mua.

Enum
PURCHASE_TYPE_UNSPECIFIED Giá trị không xác định.
RETAIL Quy định này áp dụng cho cả các giao dịch mua như hàng hoá thực.
FOOD Bao gồm cả giao dịch mua đơn đặt món ăn.
GROCERY Mua hàng tạp hoá.
MOBILE_RECHARGE Giao dịch mua nạp tiền điện thoại trả trước.

MerchantUnitMeasure

Số lượng đo lường để định giá theo đơn vị của người bán.

Biểu diễn dưới dạng JSON 
{
  "measure": number,
  "unit": enum (Unit)
}
Trường
measure

number

Giá trị: Ví dụ 1.2.

unit

enum (Unit)

Đơn vị: Ví dụ: POUND, GRAM.

Đơn vị

Enum
UNIT_UNSPECIFIED Chưa xác định đơn vị.
MILLIGRAM Miligam.
GRAM Gram
KILOGRAM Kilogam.
OUNCE Ounce.
POUND Bảng Anh.

PurchaseReturnsInfo

Trả về thông tin liên quan đến một đơn đặt hàng hoặc một mục hàng cụ thể.

Biểu diễn dưới dạng JSON 
{
  "isReturnable": boolean,
  "daysToReturn": number,
  "policyUrl": string
}
Trường
isReturnable

boolean

Nếu giá trị là true, thì hệ thống sẽ cho phép trả về.

daysToReturn

number

Bạn được phép trả lại hàng trong vòng bao nhiêu ngày đó.

policyUrl

string

Đường liên kết đến chính sách trả lại hàng.

PurchaseFulfillmentInfo

Thông tin thực hiện đơn hàng liên quan đến đơn đặt hàng hoặc mục hàng cụ thể.

Biểu diễn dưới dạng JSON 
{
  "id": string,
  "fulfillmentType": enum (Type),
  "expectedFulfillmentTime": {
    object (Time)
  },
  "expectedPreparationTime": {
    object (Time)
  },
  "location": {
    object (Location)
  },
  "expireTime": string,
  "price": {
    object (PriceAttribute)
  },
  "fulfillmentContact": {
    object (UserInfo)
  },
  "shippingMethodName": string,
  "storeCode": string,
  "pickupInfo": {
    object (PickupInfo)
  }
}
Trường
id

string

Giá trị nhận dạng duy nhất của dịch vụ này.

fulfillmentType

enum (Type)

Bắt buộc: Loại phương thức thực hiện.

expectedFulfillmentTime

object (Time)

Một cửa sổ nếu phạm vi thời gian được chỉ định hoặc giờ đến dự kiến nếu chỉ định một thời gian. Thời gian giao hàng hoặc đến lấy hàng dự kiến.

expectedPreparationTime

object (Time)

Một cửa sổ nếu phạm vi thời gian được chỉ định hoặc giờ đến dự kiến nếu chỉ định một thời gian. Thời gian dự kiến để chuẩn bị món ăn. Ưu tiên thanh toán một lần.

location

object (Location)

Vị trí đến lấy hàng hoặc giao hàng.

expireTime

string (Timestamp format)

Thời gian mà tuỳ chọn thực hiện này hết hạn.

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"
price

object (PriceAttribute)

Chi phí của lựa chọn này.

fulfillmentContact

object (UserInfo)

Thông tin liên hệ của người dùng để thực hiện yêu cầu này.

shippingMethodName

string

Tên của phương thức vận chuyển do người dùng chọn.

storeCode

string

StoreCode của vị trí. Ví dụ: Walmart là merchant và storeCode là cửa hàng walmart nơi thực hiện đơn hàng. https://support.google.com/business/answer/3370250?ref_topic=4596653.

pickupInfo

object (PickupInfo)

Thông tin bổ sung về cách chọn đơn đặt hàng. Trường này chỉ áp dụng khi loại phương thức thực hiện là PICKUP.

Loại

Loại phương thức thực hiện đơn hàng.

Enum
TYPE_UNSPECIFIED Chưa xác định loại.
DELIVERY Đơn đặt hàng này sẽ được giao.
PICKUP Bạn cần đến lấy đơn đặt hàng này.

Thời gian

Cấu trúc thời gian biểu thị thời gian của một sự kiện sẽ dùng khi hiển thị đơn đặt hàng cho người dùng.

Biểu diễn dưới dạng JSON 
{
  "timeIso8601": string
}
Trường
timeIso8601

string

Biểu thị thời gian sự kiện đặt hàng như thời gian đặt trước, thời gian giao hàng, v.v. Có thể là thời lượng (thời gian bắt đầu và kết thúc), chỉ ngày, giờ, v.v. Hãy tham khảo https://en.wikipedia.org/wiki/ISO_8601 để biết tất cả định dạng được hỗ trợ.

PickupInfo

Thông tin chi tiết về cách thức nhận đơn đặt hàng. Thông tin này bao gồm các thông tin chi tiết như loại hình đến lấy hàng và siêu dữ liệu bổ sung đi kèm với từng loại, nếu có.

Biểu diễn dưới dạng JSON 
{
  "pickupType": enum (PickupType),
  "curbsideInfo": {
    object (CurbsideInfo)
  },
  "checkInInfo": [
    {
      object (CheckInInfo)
    }
  ]
}
Trường
pickupType

enum (PickupType)

Phương pháp nhận hàng, chẳng hạn như INSTORE, CURBSIDE, v.v.

curbsideInfo

object (CurbsideInfo)

Thông tin chi tiết liên quan đến thông tin về lề đường. NếupickupType không phải là "CURBSIDE", trường này sẽ bị bỏ qua.

checkInInfo[]

object (CheckInInfo)

Danh sách nhiều phương thức mà đối tác hỗ trợ để hỗ trợ quá trình xác nhận có mặt.

PickupType

Danh sách các loại hình đến lấy hàng được hỗ trợ.

Enum
UNSPECIFIED Chưa xác định loại hình nhận hàng.
INSTORE Đến lấy đồ ăn trong nhà hàng.
CURBSIDE Đỗ xe ở một địa điểm được chỉ định bên ngoài nhà hàng và sẽ có người giao đồ ăn đến đó.

CurbsideInfo

Thông tin chi tiết về việc tạo thuận lợi cho việc giữ chỗ ở lề đường.

Biểu diễn dưới dạng JSON 
{
  "curbsideFulfillmentType": enum (CurbsideFulfillmentType),
  "userVehicle": {
    object (Vehicle)
  }
}
Trường
curbsideFulfillmentType

enum (CurbsideFulfillmentType)

Đối tác cần thêm thông tin để hỗ trợ các đơn đặt hàng đến lấy hàng ở lề đường. Tuỳ thuộc vào loại phương thức thực hiện đơn hàng mà bạn chọn, thông tin chi tiết tương ứng sẽ được thu thập từ người dùng.

userVehicle

object (Vehicle)

Thông tin chi tiết về xe của người dùng đặt hàng.

CurbsideFulfillmentType

Giá trị có thể có của các kiểu thực hiện đơn hàng ở lề đường.

Enum
UNSPECIFIED Chưa xác định loại phương thức thực hiện nhiệm vụ ở lề đường.
VEHICLE_DETAIL Cần có thông tin về xe để hỗ trợ nhận hàng ở lề đường.

Loại xe

Thông tin chi tiết về xe

Biểu diễn dưới dạng JSON 
{
  "make": string,
  "model": string,
  "licensePlate": string,
  "colorName": string,
  "image": {
    object (Image)
  }
}
Trường
make

string

Nhà sản xuất xe (ví dụ: "Honda"). Thông tin này sẽ hiển thị cho người dùng và phải được bản địa hoá. Bắt buộc.

model

string

Mẫu xe (ví dụ: "Grom"). Thông tin này sẽ hiển thị cho người dùng và phải được bản địa hoá. Bắt buộc.

licensePlate

string

Biển số xe (ví dụ: "1ABC234"). Bắt buộc.

colorName

string

Tên màu của xe, ví dụ: màu đen Tùy chọn.

image

object (Image)

URL dẫn đến ảnh chụp chiếc xe. Ảnh sẽ được hiển thị ở kích thước khoảng 256x256px. Phải ở định dạng jpg hoặc png. Không bắt buộc.

CheckInInfo

Siêu dữ liệu do đối tác yêu cầu để hỗ trợ phương pháp xác nhận an toàn.

Biểu diễn dưới dạng JSON 
{
  "checkInType": enum (CheckInType)
}
Trường
checkInType

enum (CheckInType)

Phương thức dùng để gửi hướng dẫn đăng ký.

CheckInType

Các phương thức khác nhau được sử dụng để gửi hướng dẫn đăng ký.

Enum
CHECK_IN_TYPE_UNSPECIFIED Giá trị không xác định.
EMAIL Thông tin đăng ký sẽ được gửi qua email.
SMS Thông tin đăng ký sẽ được gửi qua SMS.

ItemOption

Đại diện cho tiện ích bổ sung hoặc mục con.

Biểu diễn dưới dạng JSON 
{
  "id": string,
  "name": string,
  "prices": [
    {
      object (PriceAttribute)
    }
  ],
  "note": string,
  "quantity": number,
  "productId": string,
  "subOptions": [
    {
      object (ItemOption)
    }
  ]
}
Trường
id

string

Đối với các lựa chọn là mặt hàng, hãy sử dụng mã mặt hàng duy nhất.

name

string

Tên lựa chọn.

prices[]

object (PriceAttribute)

Tổng giá của lựa chọn.

note

string

Ghi chú liên quan đến lựa chọn này.

quantity

number

Đối với các lựa chọn là mặt hàng, số lượng.

productId

string

Mã sản phẩm hoặc ưu đãi liên kết với lựa chọn này.

subOptions[]

object (ItemOption)

Để xác định các tuỳ chọn phụ lồng nhau khác.

ProductDetails

Thông tin chi tiết về sản phẩm.

Biểu diễn dưới dạng JSON 
{
  "productId": string,
  "gtin": string,
  "plu": string,
  "productType": string,
  "productAttributes": {
    string: string,
    ...
  }
}
Trường
productId

string

Mã sản phẩm hoặc ưu đãi liên kết với mục hàng này.

gtin

string

Mã số sản phẩm thương mại toàn cầu của sản phẩm. Hữu ích nếu offerId không có trong Merchant Center. Không bắt buộc.

plu

string

Mã tra cứu giá, thường được gọi là mã PLU, số PLU, PLU, mã sản phẩm hoặc nhãn sản phẩm, là một hệ thống số giúp xác định riêng biệt các sản phẩm bán theo số lượng lớn tại các cửa hàng tạp hoá và siêu thị.

productType

string

Danh mục sản phẩm do người bán xác định. Ví dụ: "Trang chủ > Hàng tạp hoá > Sản phẩm từ sữa và Trứng > Sữa > Sữa nguyên chất"

productAttributes

map (key: string, value: string)

Thông tin chi tiết về sản phẩm do người bán cung cấp, ví dụ: { &quot;allergen&quot;: &quot;peanut&quot; }. Hữu ích nếu offerId không có trong Merchant Center. Không bắt buộc.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

ReservationItemExtension

Nội dung mục hàng cho các đơn đặt hàng đặt trước như nhà hàng, cắt tóc, v.v. Mã tiếp theo: 15.

Biểu diễn dưới dạng JSON 
{
  "status": enum (ReservationStatus),
  "userVisibleStatusLabel": string,
  "type": enum (ReservationType),
  "reservationTime": {
    object (Time)
  },
  "userAcceptableTimeRange": {
    object (Time)
  },
  "confirmationCode": string,
  "partySize": number,
  "staffFacilitators": [
    {
      object (StaffFacilitator)
    }
  ],
  "location": {
    object (Location)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  }
}
Trường
status

enum (ReservationStatus)

Bắt buộc: Trạng thái đặt trước.

userVisibleStatusLabel

string

Bắt buộc: 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 (ReservationType)

Loại đặt chỗ. Bạn có thể không đặt được nếu không áp dụng được bất kỳ loại nào.

reservationTime

object (Time)

Thời gian diễn ra dịch vụ/sự kiện theo lịch. Có thể là phạm vi thời gian, ngày tháng hoặc ngày giờ chính xác.

userAcceptableTimeRange

object (Time)

Phạm vi thời gian mà người dùng chấp nhận.

confirmationCode

string

Mã xác nhận cho lượt đặt chỗ này.

partySize

number

Số lượng người.

staffFacilitators[]

object (StaffFacilitator)

Nhân viên hỗ trợ sẽ phụ trách yêu cầu đặt chỗ. Ví dụ: Nhà tạo mẫu tóc.

location

object (Location)

Vị trí của dịch vụ/sự kiện.

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

ReservationStatus

Trạng thái của yêu cầu đặt chỗ.

Enum
RESERVATION_STATUS_UNSPECIFIED Trạng thái không xác định.
PENDING Yêu cầu đặt chỗ đang chờ xử lý.
CONFIRMED Yêu cầu đặt chỗ đã được xác nhận.
CANCELLED Người dùng đã huỷ yêu cầu đặt chỗ.
FULFILLED Yêu cầu đặt chỗ đã được thực hiện.
CHANGE_REQUESTED Đã yêu cầu thay đổi yêu cầu đặt chỗ
REJECTED Yêu cầu đặt chỗ đã hết hạn hoặc bị nhà tích hợp từ chối.

ReservationType

Loại đặt chỗ.

Enum
RESERVATION_TYPE_UNSPECIFIED Loại không xác định.
RESTAURANT Đặt chỗ trước nhà hàng.
HAIRDRESSER Đặt trước cho thợ làm tóc.

StaffFacilitator

Thông tin về nhân viên cung cấp dịch vụ.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "image": {
    object (Image)
  }
}
Trường
name

string

Tên của người điều phối là nhân viên. Ví dụ: "John Smith"

image

object (Image)

Hình ảnh của người thực hiện.

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 Actions on Google điền sẵn 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 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,
  "paymentMethodVoiceName": 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

paymentMethodVoiceName

string

Tên phương thức thanh toán sẽ được đọc to cho người dùng trên các thiết bị chỉ có trợ lý thoại. Ví dụ: "visa kết thúc bằng một hai ba bốn" hoặc "kiểm tra tài khoản có các số cuối là năm sáu bảy tám". Lưu ý: Đây là chuỗi được tối ưu hoá cho giọng nói sẽ được dùng thay cho paymentMethodDisplayName cho các thiết bị chỉ có trợ lý thoại. Nếu bạn không đặt chuỗi này, thì paymentMethodDisplayName sẽ được đọc với người dùng.

PaymentType

PaymentType cho biết phương thức thanh toán được sử dụng cho phương thức thanh toán do Người bán cung cấp. Hành động cũng phải cung cấp tên hiển thị cho phương thức thanh toán.

Enum
PAYMENT_TYPE_UNSPECIFIED Hình thức thanh toán chưa được chỉ định.
PAYMENT_CARD Thẻ tín dụng/thẻ ghi nợ hoặc thẻ trả trước.
BANK Phương thức thanh toán là một tài khoản ngân hàng.
LOYALTY_PROGRAM Phương thức thanh toán là chương trình khách hàng thân thiết.
CASH Phương thức thanh toán là tiền mặt.
GIFT_CARD Phương thức thanh toán là thẻ quà tặng.
WALLET Ví của bên thứ ba, ví dụ: PayPal

PaymentMethodProvenance

Thể hiện nguồn gốc của phương thức thanh toán được dùng cho giao dịch.

Enum
PAYMENT_METHOD_PROVENANCE_UNSPECIFIED Chứng từ chưa xác định.
PAYMENT_METHOD_PROVENANCE_GOOGLE Provenance là của Google.
PAYMENT_METHOD_PROVENANCE_MERCHANT Provenance là người bán.

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.

PurchaseLocationType

Loại vị trí của giao dịch mua.

Enum
UNSPECIFIED_LOCATION Giá trị không xác định.
ONLINE_PURCHASE Tất cả giao dịch mua được mua trực tuyến.
INSTORE_PURCHASE Tất cả giao dịch mua tại cửa hàng.

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": number
}
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

number

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

ErrorType

Các loại lỗi có thể xảy ra.

Enum
ERROR_TYPE_UNSPECIFIED Lỗi không xác định
NOT_FOUND Không tìm thấy thực thể, có thể là Mục, FulfillmentOption, Quảng cáo. Cần có mã nhận dạng thực thể.
INVALID Dữ liệu thực thể không hợp lệ. có thể là Item, FulfillmentOption, promotion. Cần có mã nhận dạng thực thể.
AVAILABILITY_CHANGED Mặt hàng không có sẵn hoặc không có đủ mặt hàng để đáp ứng yêu cầu. Cần có mã nhận dạng thực thể.
PRICE_CHANGED Giá mặt hàng khác với giá trong thực thể mặt hàng. Bạn phải cung cấp mã nhận dạng thực thể và giá mới.
INCORRECT_PRICE Lỗi về giá trong phần Phí, Tổng. Bạn phải cung cấp mã nhận dạng thực thể và giá mới.
REQUIREMENTS_NOT_MET Những giới hạn khi chấp nhận đơn đặt hàng không đáp ứng yêu cầu – kích thước giỏ hàng tối thiểu, v.v.
TOO_LATE FulfillmentOption đã hết hạn.
NO_CAPACITY Không có sẵn dung lượng dịch vụ.
INELIGIBLE Người dùng không đủ điều kiện để đặt hàng (danh sách đen).
OUT_OF_SERVICE_AREA Không thể giao hàng tới địa chỉ được yêu cầu do quy tắc biên giới, v.v.
CLOSED Nhà hàng đóng cửa không hoạt động vào thời điểm gọi món.
PROMO_NOT_APPLICABLE Mã lỗi chung để phát hiện tất cả các trường hợp không áp dụng được mã khuyến mãi, nếu không có trường hợp nào dưới đây phù hợp. Thêm mã khuyến mãi dưới dạng Mã nhận dạng thực thể.
PROMO_NOT_RECOGNIZED Đối tác không nhận ra mã giảm giá. Thêm mã khuyến mãi dưới dạng Mã nhận dạng thực thể.
PROMO_EXPIRED Không thể áp dụng vì chương trình khuyến mãi đã hết hạn. Thêm mã khuyến mãi dưới dạng Mã nhận dạng thực thể.
PROMO_USER_INELIGIBLE Người dùng hiện tại không đủ điều kiện nhận phiếu giảm giá này. Thêm mã khuyến mãi dưới dạng Mã nhận dạng thực thể.
PROMO_ORDER_INELIGIBLE Đơn đặt hàng hiện tại không đủ điều kiện nhận phiếu giảm giá này. Thêm mã khuyến mãi dưới dạng Mã nhận dạng thực thể.
UNAVAILABLE_SLOT Không có khung giờ đặt hàng trước.
FAILED_PRECONDITION Những giới hạn khi chấp nhận đơn đặt hàng không đáp ứng yêu cầu – kích thước giỏ hàng tối thiểu, v.v.
PAYMENT_DECLINED Khoản thanh toán không hợp lệ.
MERCHANT_UNREACHABLE Không thể liên hệ với người bán. Điều này hữu ích khi đối tác là đơn vị tập hợp và không thể liên hệ với người bán.

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 sự kiện. Ví dụ: nếu sự kiện là một bộ phim, đây phải là tên phim.

description

string

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.

Loại

Loại sự kiện.

Enum
EVENT_TYPE_UNKNOWN Loại sự kiện không xác định.
MOVIE Phim.
CONCERT Buổi hoà nhạc.
SPORTS Thể thao.

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 nhân vật.

image

object (Image)

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

Loại

Loại ký tự.

Enum
TYPE_UNKNOWN Loại không xác định.
ACTOR Actor (Diễn viên).
PERFORMER Người thực hiện.
DIRECTOR Đạo diễn.
ORGANIZER Người tổ chức.