Order

{
  "email": string,
  "firstName": string,
  "lastName": string,
  "displayName": string,
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ]
}

string

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

string

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

string

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

string

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

object (PhoneNumber)

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

{
  "e164PhoneNumber": string,
  "extension": string,
  "preferredDomesticCarrierCode": string
}

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

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.

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.

{
  "url": string,
  "accessibilityText": string,
  "height": number,
  "width": number
}

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.

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.

number

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

number

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

{
  "id": string,
  "name": string,
  "image": {
    object (Image)
  },
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ],
  "address": {
    object (Location)
  }
}

string

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

string

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

object (Image)

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

object (PhoneNumber)

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

object (Location)

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

{
  "coordinates": {
    object (LatLng)
  },
  "formattedAddress": string,
  "zipCode": string,
  "city": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "name": string,
  "phoneNumber": string,
  "notes": string,
  "placeId": string
}

object (LatLng)

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

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].

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].

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].

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].

string

Tên địa điểm.

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.

string

Ghi chú về vị trí.

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

{
  "latitude": number,
  "longitude": number
}

number

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

number

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

{
  "revision": number,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}

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ũ.

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ĩ.

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

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ỳ).

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

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.

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.

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.

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).

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.

string

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

{
  "lineItems": [
    {
      object (LineItem)
    }
  ]
}

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.

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

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ự.

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ự.

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.

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.

object (PriceAttribute)

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

object (Action)

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

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.

object (Image)

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

string

Mô tả mục hàng.

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ỷ.

object (Disclosure)

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

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

object (PurchaseItemExtension)

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

object (ReservationItemExtension)

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

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

enum (Type)

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

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á.

enum (State)

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

boolean

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

object (Money)

Số tiền.

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.

{
  "currencyCode": string,
  "amountInMicros": string
}

string

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

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.

{
  "type": enum (Type),
  "title": string,
  "openUrlAction": {
    object (OpenUrlAction)
  },
  "actionMetadata": {
    object (ActionMetadata)
  }
}

enum (Type)

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

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ự.

object (OpenUrlAction)

Việc cần làm.

object (ActionMetadata)

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

{
  "url": string,
  "androidApp": {
    object (AndroidApp)
  },
  "urlTypeHint": enum (UrlTypeHint)
}

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

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.

enum (UrlTypeHint)

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

{
  "packageName": string,
  "versions": [
    {
      object (VersionFilter)
    }
  ]
}

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.

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.

{
  "minVersion": number,
  "maxVersion": number
}

number

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

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.

{
  "expireTime": string
}

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"

{
  "title": string,
  "disclosureText": {
    object (DisclosureText)
  },
  "presentationOptions": {
    object (DisclosurePresentationOptions)
  }
}

string

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

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.

object (DisclosurePresentationOptions)

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

{
  "template": string,
  "textLinks": [
    {
      object (TextLink)
    }
  ]
}

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.

object (TextLink)

Các đường liên kết dạng văn bản cần được thay thế trong mẫu. Số đầu tiên sẽ được thay thế cho "{0}" trong chuỗi mẫu và chuỗi thứ hai cho "{1}", v.v.

{
  "displayText": string,
  "url": string
}

string

Văn bản sẽ hiển thị cho người dùng.

string

URL mà người dùng sẽ được chuyển đến khi đường liên kết được kích hoạt.

{
  "presentationRequirement": enum (PresentationRequirement),
  "initiallyExpanded": boolean
}

enum (PresentationRequirement)

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

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.

{
  "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)
  }
}

enum (PurchaseStatus)

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

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ự.

enum (PurchaseType)

Bắt buộc: Loại giao dịch mua.

string

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

number

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

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á.

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.

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.

object (ItemOption)

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

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

object (ProductDetails)

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

{
  "measure": number,
  "unit": enum (Unit)
}

number

Giá trị: Ví dụ 1.2.

enum (Unit)

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

{
  "isReturnable": boolean,
  "daysToReturn": number,
  "policyUrl": string
}

boolean

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

number

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

string

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

{
  "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)
  }
}

string

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

enum (Type)

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

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.

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.

object (Location)

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

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"

object (PriceAttribute)

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

object (UserInfo)

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

string

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

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.

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.

{
  "timeIso8601": string
}

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ợ.

{
  "pickupType": enum (PickupType),
  "curbsideInfo": {
    object (CurbsideInfo)
  },
  "checkInInfo": [
    {
      object (CheckInInfo)
    }
  ]
}

enum (PickupType)

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

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.

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.

{
  "curbsideFulfillmentType": enum (CurbsideFulfillmentType),
  "userVehicle": {
    object (Vehicle)
  }
}

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.

object (Vehicle)

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

{
  "make": string,
  "model": string,
  "licensePlate": string,
  "colorName": string,
  "image": {
    object (Image)
  }
}

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.

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.

string

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

string

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

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.

{
  "checkInType": enum (CheckInType)
}

enum (CheckInType)

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

{
  "id": string,
  "name": string,
  "prices": [
    {
      object (PriceAttribute)
    }
  ],
  "note": string,
  "quantity": number,
  "productId": string,
  "subOptions": [
    {
      object (ItemOption)
    }
  ]
}

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.

string

Tên lựa chọn.

object (PriceAttribute)

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

string

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

number

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

string

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

object (ItemOption)

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

{
  "productId": string,
  "gtin": string,
  "plu": string,
  "productType": string,
  "productAttributes": {
    string: string,
    ...
  }
}

string

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

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.

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ị.

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"

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ụ: { "allergen": "peanut" }. 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" }.

{
  "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: ...,
    ...
  }
}

enum (ReservationStatus)

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

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ự.

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.

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.

object (Time)

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

string

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

number

Số lượng người.

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.

object (Location)

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

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

{
  "name": string,
  "image": {
    object (Image)
  }
}

string

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

object (Image)

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

{
  "paymentResult": {
    object (PaymentResult)
  },
  "paymentInfo": {
    object (PaymentInfo)
  }
}

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ý.

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.

{

  // Union field result can be only one of the following:
  "googlePaymentData": string,
  "merchantPaymentMethodId": string
  // End of list of possible types for union field result.
}

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

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.

{
  "paymentMethodDisplayInfo": {
    object (PaymentMethodDisplayInfo)
  },
  "paymentMethodProvenance": enum (PaymentMethodProvenance)
}

object (PaymentMethodDisplayInfo)

Thông tin hiển thị của phương thức thanh toán đã sử dụng cho giao dịch.

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.

{
  "paymentType": enum (PaymentType),
  "paymentMethodDisplayName": string,
  "paymentMethodVoiceName": string
}

enum (PaymentType)

Loại thanh toán.

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

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.

{
  "coupon": string
}

string

Bắt buộc: Mã giảm giá áp dụng cho ưu đãi này.

{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  },
  "purchaseLocationType": enum (PurchaseLocationType),
  "errors": [
    {
      object (PurchaseError)
    }
  ]
}

enum (PurchaseStatus)

Bắt buộc: Trạng thái chung cho đơn đặt hàng.

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ự.

enum (PurchaseType)

Bắt buộc: Loại giao dịch mua.

object (PurchaseReturnsInfo)

Thông tin trả lại hàng của đơn đặt hàng.

object (PurchaseFulfillmentInfo)

Thông tin thực hiện đơn đặt hàng.

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

enum (PurchaseLocationType)

Địa điểm mua hàng (tại cửa hàng / trực tuyến)

object (PurchaseError)

Không bắt buộc: Các lỗi khiến đơn đặt hàng này bị từ chối.

{
  "type": enum (ErrorType),
  "description": string,
  "entityId": string,
  "updatedPrice": {
    object (PriceAttribute)
  },
  "availableQuantity": number
}

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.

string

Nội dung mô tả bổ sung về lỗi.

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.

object (PriceAttribute)

Phù hợp trong trường hợp xảy ra loại lỗi PRICE_CHANGED / INTRUE_PRICE.

number

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

{
  "ticketEvent": {
    object (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.

{
  "type": enum (Type),
  "name": string,
  "description": string,
  "url": string,
  "location": {
    object (Location)
  },
  "eventCharacters": [
    {
      object (EventCharacter)
    }
  ],
  "startDate": {
    object (Time)
  },
  "endDate": {
    object (Time)
  },
  "doorTime": {
    object (Time)
  }
}

enum (Type)

Bắt buộc: Loại sự kiện bán vé, ví dụ: phim, buổi hoà nhạc.

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.

string

Mô tả về sự kiện.

string

URL dẫn đến thông tin sự kiện.

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.

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.

object (Time)

Thời gian bắt đầu.

object (Time)

Thời gian kết thúc.

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.

{
  "type": enum (Type),
  "name": string,
  "image": {
    object (Image)
  }
}

enum (Type)

Loại ký tự sự kiện, ví dụ: diễn viên hoặc đạo diễn.

string

Tên nhân vật.

object (Image)

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