- 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 thao tác có ngôn ngữ liên kết, danh sách quốc gia bị hạn chế và nền tảng không bắt buộc cho biết nên thực hiện hành động trên nền tảng nào.
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ữ của nội dung trong URI này. |
restricted |
Mã quốc gia theo ISO 3166-1 alpha-2. Để trống để hiển thị không bị hạn chế. |
platform |
Nền tảng mà hành động này sẽ được thực hiện. Nếu trường này chưa được đặt, ACTION_PLATFORM_WEB_APPLICATION sẽ được sử dụng làm phương án dự phòng. |
action |
Loại hành động được xác định trước. |
order |
Siêu dữ liệu của đường liên kết đặt hàng trực tuyến. Hỗ trợ hành động bằng ActionLinkType của ACTION_LINK_TYPE_SHOP_online. |
food |
Siêu dữ liệu về các đường liên kết Đặt món ăn. Hỗ trợ loại thao tác: * |
event |
Thông tin bổ sung về đường liên kết hành động dành riêng cho ngành dọc sự kiện. |
ActionPlatform
Nền tảng mà hành động được thực hiện. Ứng dụng web là ứng dụng dự phòng chung. Bạn nên có ít nhất một Liên kết hành động với ACTION_PLATFORM_WEB_APPLICATION. Đường liên kết có nền tảng là Android và iOS chỉ được sử 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 nói chung là web. |
ACTION_PLATFORM_MOBILE_WEB |
Nền tảng hành động là nền tảng web trên thiết bị di động. |
ACTION_PLATFORM_ANDROID |
Nền tảng hành động là Android OS. |
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 lịch hẹn trực tuyến. |
ACTION_LINK_TYPE_ORDER_FOOD |
Loại đường liên kết hành động là đặt đồ ăn qua hình thức 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 tận nơi. |
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 đến hành động đặt hàng trực tuyến.
Biểu diễn dưới dạng JSON |
---|
{
"fulfillmentOption": [
{
object ( |
Trường | |
---|---|
fulfillment |
Các lựa chọn thực hiện hiện có cho đường liên kết đến hành động đặt hàng trực tuyến. |
FulfillmentOption
Tuỳ chọn thực hiện đơn hàng 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 | |
---|---|
fulfillment |
Bắt buộc. Loại phương thức thực hiện. |
available |
Bắt buộc. Danh sách ngày có thể sử dụng phương thức thực hiện này (ít nhất là 2). |
fee |
Bắt buộc. Thông tin chi tiết về phí cho phương thức thực hiện. |
minimum |
Bắt buộc. Đơn đặt hàng tối thiểu 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. |
FulfillmentType
Loại phương thức thực hiện liên kết với một hành động.
Enum | |
---|---|
FULFILLMENT_TYPE_UNSPECIFIED |
Chưa xác định loại phương thức thực hiện. |
FULFILLMENT_TYPE_DELIVERY |
Phương thức thực hiện là phân phối. |
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 | |
---|---|
fulfillment |
Bắt buộc. Ngày có sẵn cho phương thức thực hiện đơn hàng. Được hiển thị theo múi giờ của người bán. |
last |
Bắt buộc. Dấu thời gian Unix. Lần gần nhất người dùng có thể đặt hàng và nhận hàng theo Ví dụ: Nếu ngày thực hiện là 10/8/2020: – giá trị lastOrderingTime 18:00-2020-08-10 có nghĩa là, để nhận được đơn đặt hàng vào ngày 10/8/2020, khách hàng phải thực hiện đơn đặt hàng trước 6 giờ chiều cùng ngày. - giá trị lastOrderingTime 20:00 2020-08-08 có nghĩa là, để nhận được đơn đặt hàng vào ngày 10/8/2020, khách hàng phải thực hiện đơn đặt hàng trước 20:00 hai ngày trước đó. Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. 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 Gregory. Thông tin này có thể đại diện cho một trong những trường hợp sau:
- Ngày đầy đủ, với các giá trị năm, tháng và ngày khác 0.
- Tháng và ngày, thể hiện giá trị năm 0 (ví dụ: ngày kỷ niệm).
- Một năm riêng biệt, tháng 0 và ngày 0.
- Năm và tháng, không có ngày (ví dụ: ngày hết hạn thẻ tín dụng).
Các loại có liên quan:
google.type.TimeOfDay
google.type.DateTime
google.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 bằng 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 giá trị 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í cho phương thức thực hiện được liên kết với đường liên kết đến hành động.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Trường | |
---|---|
Trường hợp hợp nhất fee_details . Mô hình phí cho phương thức thực hiện. fee_details chỉ có thể là một trong những loại sau: |
|
no |
Không tính phí cho phương thức thực hiện đơn hàng. |
base |
Phí cơ bản liên quan đến phương thức thực hiện đơn hàng. |
fixed |
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.
Không cần tính 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
Phí tối thiểu bắt buộc đối với phương thức thực hiện đơn hàng 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 | |
---|---|
base |
Bắt buộc. Số tiền phí cơ bản cho phương thức thực hiện đơn hàng. |
FixedFee
Phí cố định bắt buộc đối với 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 |
---|
{
"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 | |
---|---|
fee |
Thông tin chi tiết về các khoản phí được tính cho người dùng ngoài tổng số 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. |
advance |
Thông tin chi tiết về dịch vụ hỗ trợ đặt hàng nâng cao (còn gọi là đặt hàng trước) mà người dùng có thể đặt hàng để thực hiện đơn hàng sau này. |
Trường kết hợp 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 lượng cho đến khi đồ ăn được giao. Đối với đơn đặt hàng mang đi, thời lượng cho đến khi đồ ăn sẵn sàng để đến lấy. fulfillment_duration_options chỉ có thể là một trong những loại sau: |
|
fulfillment |
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 " |
fulfillment |
Phạm vi thời lượng. Ví dụ: * 30 phút đến 45 phút * Trên 30 phút * Dưới 50 phút |
FeeDetails
Thông tin chi tiết về phí.
Biểu diễn dưới dạng JSON |
---|
{ "type": enum ( |
Trường | |
---|---|
type |
Loại phí. (bắt buộc) |
fee |
Số tiền phí tính theo đơn vị tiền tệ, tỷ lệ phần trăm 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 |
Loại phí chưa được chỉ định. |
DELIVERY |
Đối với phí giao hàng. |
SERVICE |
Đối với phí dịch vụ. |
FeeAmount
Ví dụ về FeeAmount
: * 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 USD – 6 USD * Tỷ lệ phần trăm theo kích thước 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 | |
---|---|
cart |
Phí 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 có 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ụ: * 5,5% cố định * Ít nhất 5,5% * Tối đa 5,5% * Từ 4,5% đến 5,5% |
Trường hợp hợp nhất amount_options . Các tuỳ chọn để chỉ định số tiền. amount_options chỉ có thể là một trong những loại sau: |
|
amount |
Số tiền cố định. Ví dụ: 3,5 USD. |
amount |
Phạm vi số tiền. Ví dụ: * Từ 3,5 đến 5,5 USD * Ít nhất 3,5 USD * Tối đa 5,5 USD |
amount |
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 | |
---|---|
currency |
Mã tiền tệ gồm ba chữ cái được xác định trong ISO 4217. |
units |
Toàn bộ đơn vị của số tiề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. 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 | |
---|---|
min |
Số tiền tối thiểu. |
max |
Số tiền tối đa. |
QuantitativeValue
Trình bao bọc cho một giá trị số có thể là một dải ô hoặc một giá trị cố định. QuantitativeValue
ví dụ: * Giá trị số ít: value: 10.5
* Phạm vi 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 kết hợp value_options . (bắt buộc) value_options chỉ có thể là một trong những giá trị sau: |
|
value |
Một giá trị riêng. Ví dụ: 5.6 |
value |
Một phạm vi giá trị cũng có thể là kết thúc mở hoặc bị giới hạn. Ví dụ: * Tối thiểu 5,5 * Tối đa 5,5 * 5,5 đến 6,5 |
RangeValue
Phạm vi giá trị sao cho minValue
< maxValue
. Yêu cầu phải có ít nhất một trong hai minValue
và maxValue
.
Biểu diễn dưới dạng JSON |
---|
{ "minValue": number, "maxValue": number } |
Trường | |
---|---|
min |
Giá trị tối thiểu. |
max |
Giá trị tối đa. |
DurationRange
Trình bao bọc cho một phạm vi thời lượng có thể có giới hạn hoặc không có giới hạn. Bạn phải nhập ít nhất một trong hai thời lượng minDuration và maxDuration.
Biểu diễn dưới dạng JSON |
---|
{ "minDuration": string, "maxDuration": string } |
Trường | |
---|---|
min |
Thời lượng tối thiểu. Thời lượng tính bằng giây với tối đa 9 chữ số phân số, kết thúc bằng " |
max |
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ợ đặt hàng trước.
Biểu diễn dưới dạng JSON |
---|
{ "isSupported": boolean } |
Trường | |
---|---|
is |
"True" nếu tính năng Đơn đặt hàng trước (còn gọi là Đặt hàng trước) được hỗ trợ. (bắt buộc) |
EventMetadata
Thông tin bổ sung về đường liên kết đến hành động dành riêng cho ngành sự kiện.
Biểu diễn dưới dạng JSON |
---|
{
"surface": enum ( |
Trường | |
---|---|
surface |
Nền tảng sự kiện được xác định trước đượ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 Sự kiện. |
Bề mặt
Khu vực 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. Danh mục 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 đang giúp bạn đặt vé xem sự kiện trên Tìm kiếm. |
SURFACE_YOUTUBE |
Đường liên kết hành động đang giúp bạn đặt vé xem sự kiện trên YouTube. |
SURFACE_ADS |
Đường liên kết hành động là nhấp vào quảng cáo cho sự kiện. |