- Biểu diễn dưới dạng JSON
- ActionPlatform
- ActionLinkType
- OrderOnlineMetadata
- FulfillmentOption
- FulfillmentType
- AvailableDay
- Ngày
- FeeDetails
- NoFee
- MinimumFee
- FixedFee
- FoodOrderingMetadata
- FeeDetails
- FeeType
- FeeAmount
- Tiền
- MoneyRange
- QuantitativeValue
- RangeValue
- DurationRange
- AdvanceOrderDetails
- EventMetadata
- Surface
Một URL hành động có ngôn ngữ liên kết, danh sách các quốc gia bị hạn chế và nền tảng không bắt buộc cho biết nền tảng mà hành động này sẽ được thực hiện.
| Biểu diễn dưới dạng JSON |
|---|
{ "url": string, "language": string, "restrictedCountry": [ string ], "platform": enum ( |
| Trường | |
|---|---|
url |
URL điểm truy cập cho đường liên kết hành động này. |
language |
Thẻ ngôn ngữ BCP-47 xác định ngôn ngữ mà nội dung từ URI này có sẵn. |
restrictedCountry[] |
Mã quốc gia ISO 3166-1 alpha-2. Để trống nếu bạn muốn hiển thị không hạn chế. |
platform |
Nền tảng mà bạn nên thực hiện hành động này. Nếu bạn không đặt trường này, ACTION_PLATFORM_WEB_APPLICATION sẽ được dùng làm phương án dự phòng. |
actionLinkType |
Loại hành động được xác định trước. |
orderOnlineMetadata |
Siêu dữ liệu cho đường liên kết đặt hàng trực tuyến. Hỗ trợ thao tác có ActionLinkType là ACTION_LINK_TYPE_SHOP_ONLINE. |
foodOrderingMetadata |
Siêu dữ liệu cho đường liên kết Đặt món ăn. Hỗ trợ loại hành động: * |
eventMetadata |
Thông tin bổ sung về đường liên kết hành động, chỉ có trong danh mục dọc sự kiện. |
ActionPlatform
Nền tảng mà hành động được thực hiện. Ứng dụng web là giải pháp dự phòng chung. Bạn nên có ít nhất một ActionLink có ACTION_PLATFORM_WEB_APPLICATION. Đường liên kết có Android và iOS làm nền tảng chỉ được dùng trên hệ thống tương ứng.
| Enum | |
|---|---|
ACTION_PLATFORM_UNSPECIFIED |
Nền tảng không được chỉ định. |
ACTION_PLATFORM_WEB_APPLICATION |
Nền tảng hành động thường là web. |
ACTION_PLATFORM_MOBILE_WEB |
Nền tảng hành động là web trên thiết bị di động. |
ACTION_PLATFORM_ANDROID |
Nền tảng hành động là hệ điều hành Android. |
ACTION_PLATFORM_IOS |
Nền tảng hành động là iOS. |
ActionLinkType
Loại hành động được xác định trước liên kết với một đường liên kết hành động.
| Enum | |
|---|---|
ACTION_LINK_TYPE_UNSPECIFIED |
Loại đường liên kết hành động chưa được chỉ định. |
ACTION_LINK_TYPE_BOOK_APPOINTMENT |
Loại đường liên kết hành động là đặt lịch hẹn. |
ACTION_LINK_TYPE_BOOK_ONLINE_APPOINTMENT |
Loại đường liên kết hành động là đặt cuộc hẹn trực tuyến. |
ACTION_LINK_TYPE_ORDER_FOOD |
Loại đường liên kết hành động là đặt đồ ăn để giao hàng hoặc mang đi hoặc cả hai. |
ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY |
Loại đường liên kết hành động là đặt đồ ăn để giao hàng. |
ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT |
Loại đường liên kết hành động là đặt đồ ăn mang đi. |
ACTION_LINK_TYPE_MAKE_DINING_RESERVATION |
Loại đường liên kết hành động là đặt chỗ ăn uống. |
ACTION_LINK_TYPE_SHOP_ONLINE |
Loại đường liên kết hành động là đặt hàng để mua sắm, có thể là giao hàng hoặc đến lấy hàng hoặc cả hai. |
OrderOnlineMetadata
Siêu dữ liệu cho đường liên kết hành động đặt hàng trực tuyến.
| Biểu diễn dưới dạng JSON |
|---|
{
"fulfillmentOption": [
{
object ( |
| Trường | |
|---|---|
fulfillmentOption[] |
Các lựa chọn thực hiện đơn đặt hàng có sẵn cho đường liên kết hành động đặt hàng trực tuyến. |
FulfillmentOption
Phương thức thực hiện cho đường liên kết hành động đặt hàng trực tuyến.
| Biểu diễn dưới dạng JSON |
|---|
{ "fulfillmentType": enum ( |
| Trường | |
|---|---|
fulfillmentType |
Bắt buộc. Loại hình thực hiện đơn hàng. |
availableDay[] |
Bắt buộc. Danh sách các ngày có thể thực hiện phương thức thực hiện này (tốt nhất là ít nhất 2 ngày). |
feeDetails |
Bắt buộc. Thông tin chi tiết về phí của phương thức thực hiện đơn hàng. |
minimumOrder |
Bắt buộc. Đơn hàng tối thiểu cho phương thức thực hiện được liên kết với đường liên kết hành động. |
FulfillmentType
Loại phương thức thực hiện liên kết với một đường liên kết hành động.
| Enum | |
|---|---|
FULFILLMENT_TYPE_UNSPECIFIED |
Bạn chưa chỉ định kiểu thực hiện đơn hàng. |
FULFILLMENT_TYPE_DELIVERY |
Loại hình thực hiện đơn hàng là giao hàng. |
FULFILLMENT_TYPE_PICKUP |
Loại hình thực hiện đơn hàng là đến lấy hàng. |
AvailableDay
Tình trạng phòng theo ngày.
| Biểu diễn dưới dạng JSON |
|---|
{
"fulfillmentDate": {
object ( |
| Trường | |
|---|---|
fulfillmentDate |
Bắt buộc. Ngày có thể thực hiện một phương thức thực hiện đơn hàng. Được giả định là theo múi giờ của người bán. |
lastOrderingTime |
Bắt buộc. Dấu thời gian Unix. Thời gian muộn nhất mà người dùng có thể đặt hàng và nhận hàng là Ví dụ: nếu fulfillmentDate là 2020-08-10: – giá trị lastOrderingTime là 2020-08-10 18:00, tức là để nhận được đơn đặt hàng vào ngày 2020-08-10, khách hàng phải đặt đơn hàng trước 6 giờ chiều cùng ngày. – giá trị lastOrderingTime là 2020-08-08 20:00 có nghĩa là để nhận được đơn đặt hàng vào ngày 2020-08-10, khách hàng phải đặt hàng trước 20:00 hai ngày trước đó. Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: |
Ngày
Đại diện cho toàn bộ hoặc một phần ngày theo lịch, chẳng hạn như ngày sinh nhật. Thời gian trong ngày và múi giờ được chỉ định ở nơi khác hoặc không quan trọng. Ngày này có liên quan đến Lịch Gregorian. Nội dung này có thể đại diện cho một trong những nội dung sau:
- Một ngày đầy đủ, với các giá trị năm, tháng và ngày khác 0.
- Tháng và ngày, với giá trị năm bằng 0 (ví dụ: ngày kỷ niệm).
- Chỉ riêng giá trị năm, với giá trị tháng và ngày bằng 0.
- Năm và tháng, với giá trị ngày bằng 0 (ví dụ: ngày hết hạn thẻ tín dụng).
Các loại có liên quan:
google.type.TimeOfDaygoogle.type.DateTimegoogle.protobuf.Timestamp
| Biểu diễn dưới dạng JSON |
|---|
{ "year": integer, "month": integer, "day": integer } |
| Trường | |
|---|---|
year |
Năm của ngày. Giá trị phải từ 1 đến 9999 hoặc bằng 0 để chỉ định ngày không có năm. |
month |
Tháng trong năm. Giá trị phải từ 1 đến 12 hoặc từ 0 để chỉ định một năm không có tháng và ngày. |
day |
Ngày trong tháng. Giá trị phải từ 1 đến 31 và có giá trị trong năm và tháng, hoặc bằng 0 để chỉ định một năm hoặc một năm và tháng, trong đó ngày là không quan trọng. |
FeeDetails
Thông tin chi tiết về phí của phương thức thực hiện được liên kết với đường liên kết hành động.
| Biểu diễn dưới dạng JSON |
|---|
{ // Union field |
| Trường | |
|---|---|
Trường nhóm fee_details. Mô hình tính phí cho phương thức thực hiện đơn hàng. fee_details chỉ có thể là một trong những trạng thái sau: |
|
noFee |
Không tính phí cho phương thức thực hiện đơn hàng. |
baseFee |
Phí cơ bản liên quan đến phương thức thực hiện đơn hàng. |
fixedFee |
Khoản phí cố định liên quan đến phương thức thực hiện đơn hàng. |
NoFee
Loại này không có trường nào.
Bạn không phải trả phí cho phương thức thực hiện được liên kết với đường liên kết hành động.
MinimumFee
Khoản phí tối thiểu cần thiết cho phương thức thực hiện được liên kết với đường liên kết hành động.
| Biểu diễn dưới dạng JSON |
|---|
{
"baseFeeAmount": {
object ( |
| Trường | |
|---|---|
baseFeeAmount |
Bắt buộc. Số tiền phí cơ bản cho phương thức thực hiện đơn hàng. |
FixedFee
Khoản phí cố định cần thiết cho phương thức thực hiện đơn hàng được liên kết với đường liên kết hành động.
| Biểu diễn dưới dạng JSON |
|---|
{
"amount": {
object ( |
| Trường | |
|---|---|
amount |
Bắt buộc. Số tiền phí cố định cho phương thức thực hiện đơn hàng. |
FoodOrderingMetadata
Siêu dữ liệu cho đường liên kết đến hành động đặt món ăn.
| Biểu diễn dưới dạng JSON |
|---|
{ "feeDetails": [ { object ( |
| Trường | |
|---|---|
feeDetails[] |
Thông tin chi tiết về các khoản phí mà người dùng phải trả thêm vào tổng giá trị mặt hàng. Lặp lại cho các loại phí khác nhau như phí dịch vụ, phí giao hàng, v.v. |
advanceOrderDetails |
Thông tin chi tiết về tính năng hỗ trợ đặt hàng nâng cao (còn gọi là đặt hàng trước), trong đó người dùng có thể đặt hàng để thực hiện đơn hàng vào thời điểm khác chứ không phải Ngay bây giờ. |
Trường nhóm fulfillment_duration_options. Khoảng thời gian thực hiện đơn đặt hàng kể từ khi xác nhận đơn đặt hàng. Đối với đơn đặt hàng giao tận nơi, thời gian cho đến khi đồ ăn được giao. Đối với đơn đặt hàng đến lấy, khoảng thời gian cho đến khi đồ ăn sẵn sàng để bạn đến lấy. fulfillment_duration_options chỉ có thể là một trong những trạng thái sau: |
|
fulfillmentLeadTimeDuration |
Thời lượng cố định. Ví dụ: 30 phút. Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng " |
fulfillmentLeadTimeDurationRange |
Một khoảng thời gian. Ví dụ: * Từ 30 phút đến 45 phút * Hơn 30 phút * Dưới 50 phút |
FeeDetails
Thông tin về phí.
| Biểu diễn dưới dạng JSON |
|---|
{ "type": enum ( |
| Trường | |
|---|---|
type |
Loại phí. (bắt buộc) |
feeAmount |
Số tiền phí bằng đơn vị tiền tệ, tỷ lệ phần trăm của giá trị giỏ hàng hoặc kết hợp cả hai. (bắt buộc) |
FeeType
Loại phí.
| Enum | |
|---|---|
FEE_TYPE_UNSPECIFIED |
Bạn chưa chỉ định loại phí. |
DELIVERY |
Đối với phí giao hàng. |
SERVICE |
Đối với phí dịch vụ. |
FeeAmount
FeeAmount Ví dụ: * Phí cố định: 0 USD (không tính phí), 1,5 USD * Khoảng phí cố định: 1 USD (tối thiểu), 3 USD (tối đa), 5 – 6 USD * Tỷ lệ phần trăm theo quy mô giỏ hàng: 15,5%, 10% – 20%, 10% (tối thiểu), 15% (tối đa) * Kết hợp khoảng phí và tỷ lệ phần trăm: 25,5% và 2,5 USD (tối thiểu), 25,5% và 4,5 USD (tối đa), 10% và 1,5 – 2,5 USD, 10,5% – 20% và 2,5 – 3,5 USD
| Biểu diễn dưới dạng JSON |
|---|
{ "cartPercentage": { object ( |
| Trường | |
|---|---|
cartPercentage |
Phí tính theo tỷ lệ phần trăm giá trị giỏ hàng. Hỗ trợ một phạm vi (có giới hạn và không giới hạn) hoặc một tỷ lệ phần trăm cố định. Giá trị phải nằm trong khoảng từ 0 đến 100. Ví dụ: * Cố định 5,5% * Ít nhất 5,5% * Nhiều nhất 5,5% * Từ 4,5% đến 5,5% |
Trường nhóm amount_options. Các lựa chọn để chỉ định số tiền. amount_options chỉ có thể là một trong những trạng thái sau: |
|
amount |
Số tiền cố định. Ví dụ: 35.000 VND. |
amountRange |
Phạm vi số tiền. Ví dụ: * Từ 3,5 USD đến 5,5 USD * Ít nhất 3,5 USD * Nhiều nhất 5,5 USD |
amountUnknown |
Số tiền không xác định. |
Tiền
Biểu thị một số tiền cùng với loại đơn vị tiền tệ.
| Biểu diễn dưới dạng JSON |
|---|
{ "currencyCode": string, "units": string, "nanos": integer } |
| Trường | |
|---|---|
currencyCode |
Mã đơn vị tiền tệ gồm 3 chữ cái được xác định trong ISO 4217. |
units |
Đơn vị số tiền là số nguyên. Ví dụ: nếu |
nanos |
Số lượng đơn vị nano (10^-9) của số tiền. Giá trị phải nằm trong khoảng từ -999.999.999 đến +999.999.999 (bao gồm). Nếu |
MoneyRange
Trình bao bọc cho một dải ô số tiền có thể có giới hạn hoặc không có giới hạn. Bạn phải cung cấp ít nhất một trong hai giá trị minAmount và maxAmount.
| Biểu diễn dưới dạng JSON |
|---|
{ "minAmount": { object ( |
| Trường | |
|---|---|
minAmount |
Số tiền tối thiểu. |
maxAmount |
Số tiền tối đa. |
QuantitativeValue
Trình bao bọc cho một giá trị bằng số có thể là một dải ô hoặc một giá trị cố định. QuantitativeValueVí dụ: * Giá trị đơn lẻ: value: 10.5 * Phạm vi có giới hạn: valueRange {minValue: 5.5, maxValue 10.5} * Giới hạn dưới: valueRange {minValue: 5.5} * Giới hạn trên: valueRange {maxValue: 10.5}
| Biểu diễn dưới dạng JSON |
|---|
{ // Union field |
| Trường | |
|---|---|
Trường nhóm value_options. (bắt buộc) value_options chỉ có thể là một trong những trạng thái sau: |
|
value |
Một giá trị duy nhất. Ví dụ: 5.6 |
valueRange |
Một dải giá trị cũng có thể là dải giá trị mở hoặc có giới hạn. Ví dụ: * Ít nhất 5,5 * Nhiều nhất 5,5 * Từ 5,5 đến 6,5 |
RangeValue
Phạm vi giá trị sao cho minValue < maxValue. Bạn phải cung cấp ít nhất một trong hai thông tin minValue và maxValue.
| Biểu diễn dưới dạng JSON |
|---|
{ "minValue": number, "maxValue": number } |
| Trường | |
|---|---|
minValue |
Giá trị tối thiểu. |
maxValue |
Giá trị tối đa. |
DurationRange
Trình bao bọc cho một dải ô thời lượng có thể có giới hạn hoặc không có giới hạn. Bạn phải cung cấp ít nhất một trong hai giá trị minDuration và maxDuration.
| Biểu diễn dưới dạng JSON |
|---|
{ "minDuration": string, "maxDuration": string } |
| Trường | |
|---|---|
minDuration |
Thời lượng tối thiểu. Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng " |
maxDuration |
Thời lượng tối đa. Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng " |
AdvanceOrderDetails
Để được hỗ trợ về tính năng đặt trước.
| Biểu diễn dưới dạng JSON |
|---|
{ "isSupported": boolean } |
| Trường | |
|---|---|
isSupported |
True nếu Advance Orders (Đơn đặt hàng trước), còn được gọi là Order Ahead (Đặt hàng trước), được hỗ trợ. (bắt buộc) |
EventMetadata
Thông tin bổ sung về đường liên kết hành động, chỉ có trong danh mục dọc sự kiện.
| Biểu diễn dưới dạng JSON |
|---|
{
"surface": enum ( |
| Trường | |
|---|---|
surface |
Bề mặt sự kiện được xác định trước liên kết với một đường liên kết hành động. Thuộc tính này chỉ được dùng cho ngành dọc Sự kiện. |
Bề mặt
Bề mặt sự kiện được xác định trước liên kết với một đường liên kết hành động. Thuộc tính này chỉ được dùng cho ngành dọc Sự kiện.
| Enum | |
|---|---|
SURFACE_UNSPECIFIED |
Bề mặt chưa được chỉ định. |
SURFACE_SEARCH |
Đường liên kết hành động là đặt vé xem sự kiện trên Mạng Tìm kiếm. |
SURFACE_YOUTUBE |
Đường liên kết hành động là đặt vé xem sự kiện trên YouTube. |
SURFACE_ADS |
Đường liên kết hành động là đường liên kết để nhấp vào quảng cáo cho sự kiện. |