- Tài nguyên: Người bán
- PaymentRestrictions
- CreditCardRestrictions
- CreditCardType
- PaymentOption
- PaymentOptionType
- ActivationType
- UserPurchaseRestriction
- PaymentProcessorConfig
- Bộ xử lý
- TokenizationConfig
- BillingInformationFormat
- Điều khoản
- MerchantMatchingHints
- ServiceAttribute
- Giá trị
- Lời khuyên
- Phương thức
Tài nguyên: Người bán
Thông tin về người bán trên nền tảng của đơn vị tập hợp.
Biểu diễn dưới dạng JSON |
---|
{ "name": string, "merchantName": string, "telephone": string, "url": string, "geo": { object ( |
Trường | |
---|---|
name |
Tên tài nguyên của người bán, có định dạng là |
merchantName |
merchantName, số điện thoại, url và địa lý được dùng để hỗ trợ so khớp khoảng không quảng cáo của đối tác với những người bán đã có mặt trên Google Maps. Thông tin này sẽ không xuất hiện. Tên của người bán. |
telephone |
Số điện thoại công khai của người bán, bao gồm cả quốc gia và mã vùng của người bán, ví dụ: +14567891234. |
url |
URL trang web công khai của người bán. |
geo |
Thông tin địa lý của người bán, bao gồm vĩ độ, kinh độ và địa chỉ. |
category |
Loại hình doanh nghiệp trên nền tảng của trang web tổng hợp. |
numBookings30d |
Trường này không được dùng nữa. |
taxRateBasisPoints |
Thuế suất của người bán theo điểm cơ bản (một phần trăm của một phần trăm). Ví dụ: Nếu thuế suất là 7,5% thì bạn phải đặt trường này thành 750. Nếu bạn không đặt trường này hoặc đặt thành 0, thì tổng giá tính cho người dùng của mọi dịch vụ do người bán này cung cấp sẽ là giá chính xác do Service.price chỉ định. Giá dịch vụ được coi là được miễn hoặc đã bao gồm các khoản thuế hiện hành. Thuế sẽ không được hiển thị cho người dùng dưới dạng một mục hàng riêng biệt. Nếu bạn đặt trường này thành bất kỳ giá trị nào khác 0, tổng giá tính cho người dùng cho bất kỳ dịch vụ nào do người bán này cung cấp sẽ bao gồm giá dịch vụ cộng với thuế được đánh giá theo thuế suất được cung cấp tại đây. Các phân số của đơn vị tiền tệ nhỏ nhất (ví dụ: các phân số của một xu) sẽ được làm tròn bằng cách làm tròn số chẵn gần nhất. Thuế sẽ được hiển thị cho người dùng dưới dạng một mục hàng riêng biệt. Trường này không được dùng nữa, vui lòng sử dụng taxRate. |
taxRate |
Thuế suất của người bán. Nếu có, trường này sẽ ghi đè trường taxRateBasisPoints không dùng nữa. Một thông báo trống (tức là taxRate { }) sẽ đặt lại thuế suất được áp dụng về 0. |
paymentRestrictions |
Các quy định hạn chế đối với phương thức thanh toán mà người bán này chấp nhận. Chúng tôi giả định rằng không có quy định hạn chế nào nếu bạn không thiết lập trường này. |
paymentOption[] |
Các lựa chọn thanh toán dành cho người bán này. Các dịch vụ của người bán này sẽ có thể giới hạn riêng các phương thức thanh toán mà họ cho phép. |
paymentProcessorConfig |
Cấu hình của một công ty xử lý thanh toán được mã hoá, nếu người bán có hỗ trợ. |
tokenizationConfig |
Cấu hình của một công ty xử lý thanh toán được mã hoá, nếu người bán có hỗ trợ. |
terms |
Điều khoản và điều kiện của người bán cụ thể sẽ được hiển thị cho người dùng khi khách hàng đặt dịch vụ thông qua tính năng Đặt chỗ với Google. Ngoài các Điều khoản và điều kiện này của đối tác tổng hợp, điều khoản và điều kiện luôn được hiển thị cho người dùng và không được cung cấp tại đây. |
brandId |
Một chuỗi mờ xác định thương hiệu dành cho người tiêu dùng để sử dụng khi hiển thị thuộc tính của đối tác. Trường này cho phép những đối tác có nhiều thương hiệu hướng đến người tiêu dùng cung cấp người bán của tất cả các thương hiệu trong cùng một nguồn cấp dữ liệu. Thương hiệu bao gồm các tài sản dành cho người tiêu dùng như tên, biểu trưng, Điều khoản dịch vụ và Chính sách quyền riêng tư. Nếu chỉ có một thương hiệu đối tác hướng đến người tiêu dùng, thì bạn không cần đặt và bạn có thể bỏ qua trường này. Nếu đối tác... Không có nhiều thương hiệu hướng đến người tiêu dùng? --> Bỏ qua trường này Bạn đã thiết lập nhiều thương hiệu chưa?
Lưu ý cẩn thận: hầu hết các đối tác không cần đặt trường này. Nếu muốn sử dụng trường này, đối tác phải liên hệ với chúng tôi trước để thiết lập các thương hiệu riêng biệt, bao gồm cả thương hiệu mặc định. |
matchingHints |
Gợi ý để giúp Google so khớp người bán với một địa điểm trên Google Maps. Lưu ý: hầu hết các đối tác không cần đặt trường này vì Google sẽ so khớp người bán với các địa điểm trên Google Maps bằng cách sử dụng thông tin được cung cấp ở trên. (không bắt buộc) |
serviceAttribute[] |
Định nghĩa về bất kỳ thuộc tính dịch vụ nào dùng để mô tả các Dịch vụ dành cho Người bán này. (không bắt buộc) |
actionLink[] |
Không bắt buộc. 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ế, loại và nền tảng không bắt buộc cho biết nền tảng nào sẽ thực hiện hành động này, |
waitlistAdvisement |
Không bắt buộc. Tư vấn chung của người bán cụ thể dành cho người dùng tham gia danh sách chờ thông qua tính năng Đặt chỗ bằng Google. Các trường văn bản riêng lẻ trong tư vấn nên có độ dài tối đa là 100 byte. |
PaymentRestrictions
Các quy định hạn chế đối với phương thức thanh toán mà người bán này chấp nhận.
Biểu diễn dưới dạng JSON |
---|
{
"creditCardRestrictions": {
object ( |
Trường | |
---|---|
creditCardRestrictions |
Các quy định hạn chế đối với thẻ tín dụng mà người bán này chấp nhận. Chúng tôi giả định rằng tất cả các thẻ tín dụng đều được chấp nhận nếu bạn không đặt trường này. Xin lưu ý rằng danh sách thẻ mà CreditCardType hỗ trợ sẽ tăng theo thời gian, có nghĩa là việc để trống trường này sẽ tạo ra cấu hình cho các thay đổi trong tương lai. |
CreditCardRestrictions
Các quy định hạn chế đối với loại thẻ tín dụng mà người bán này chấp nhận.
Biểu diễn dưới dạng JSON |
---|
{
"creditCardType": [
enum ( |
Trường | |
---|---|
creditCardType[] |
Danh sách thẻ tín dụng được hỗ trợ. Không có thẻ tín dụng nào được hỗ trợ nếu trống. |
CreditCardType
Loại thẻ tín dụng.
Enum | |
---|---|
CREDIT_CARD_TYPE_UNSPECIFIED |
Không sử dụng. |
VISA |
Thẻ tín dụng Visa. |
MASTERCARD |
Thẻ tín dụng Mastercard. |
AMERICAN_EXPRESS |
Thẻ tín dụng American Express. |
DISCOVER |
Thẻ tín dụng trên Discover. |
JCB |
Thẻ tín dụng JCB. |
PaymentOption
Một tuỳ chọn thanh toán, có thể được dùng để thanh toán cho các dịch vụ do người bán cung cấp. Lựa chọn thanh toán có thể được dùng chung giữa nhiều người bán (ví dụ: những người bán thuộc cùng một chuỗi).
Biểu diễn dưới dạng JSON |
---|
{ "paymentOptionId": string, "name": string, "description": string, "price": { object ( |
Trường | |
---|---|
paymentOptionId |
Mã này được dùng để xác định lựa chọn thanh toán này. Mã này áp dụng cho toàn bộ đơn vị tập hợp và việc sử dụng lại một giá trị cho nhiều người bán sẽ cho phép người dùng thanh toán bằng phương thức thanh toán tương ứng đối với những người bán đó. Khi sử dụng lại mã nhận dạng cho nhiều người bán, việc cập nhật bất kỳ giá trị nào cho một tuỳ chọn thanh toán của một người bán cũng sẽ cập nhật mọi tuỳ chọn thanh toán khác có cùng mã nhận dạng với một người bán khác. Do đó, phương pháp hay nhất là thiết lập để tất cả các lựa chọn thanh toán có cùng một mã nhận dạng và luôn được cập nhật thành các giá trị giống nhau để tránh mọi khả năng xảy ra hành vi sai trái. |
name |
Tên của tuỳ chọn thanh toán. Người dùng có thể nhìn thấy thông tin này. |
description |
Nội dung mô tả về phương thức thanh toán. Người dùng có thể nhìn thấy thông tin này. |
price |
Giá của lựa chọn thanh toán. |
taxRate |
Thuế suất cho phương thức thanh toán này. Nếu có, trường này sẽ thay thế trường taxRate (Thuế suất) trong Người bán hoặc Dịch vụ. Một thông báo trống (tức là taxRate { }) sẽ đặt lại thuế suất được áp dụng về 0. |
paymentOptionType |
Loại tùy chọn thanh toán này. Dùng một lần cho khách mua lẻ, dùng nhiều lần cho gói và không giới hạn cho gói thành viên. |
sessionCount |
Số phiên có thể sử dụng tuỳ chọn thanh toán này. Chỉ hợp lệ cho nhiều phiên hoạt động / gói, trong đó giá trị phải > 1. |
purchaseInterval |
Bạn có thể mua lựa chọn thanh toán trong khoảng thời gian này. |
validInterval |
Có thể sử dụng tùy chọn thanh toán trong khoảng thời gian này (ví dụ: giá đặc biệt cho tháng 1 năm 2017). Nếu có, giá trị này sẽ ghi đè validDuration và kích hoạtType. |
validDuration |
Thời hạn hiệu lực của lựa chọn thanh toán (ví dụ: gói thành viên 30 ngày). 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 " |
activationType |
Xác định cách xác định ngày bắt đầu có hiệu lực cho lựa chọn thanh toán này. |
userRestriction |
Giới hạn những người dùng đủ điều kiện mua phương thức thanh toán này. Có thể dùng để giới hạn một tuỳ chọn thanh toán khuyến mãi cho một nhóm nhỏ người dùng. Nếu bạn không đặt chính sách này, tất cả người dùng đều đủ điều kiện. |
PaymentOptionType
Loại tuỳ chọn thanh toán.
Enum | |
---|---|
PAYMENT_OPTION_TYPE_UNSPECIFIED |
Không sử dụng. |
PAYMENT_OPTION_SINGLE_USE |
Lựa chọn thanh toán chỉ có thể sử dụng một lần. |
PAYMENT_OPTION_MULTI_USE |
Bạn có thể sử dụng tuỳ chọn thanh toán nếu số phiên của tuỳ chọn đó > 0. |
PAYMENT_OPTION_UNLIMITED |
Bạn có thể sử dụng phương thức thanh toán này trong phạm vi thời gian hợp lệ (không áp dụng số phiên). |
ActivationType
Xác định cách xác định ngày bắt đầu có hiệu lực.
Enum | |
---|---|
ACTIVATION_TYPE_UNSPECIFIED |
Không sử dụng. |
ACTIVATION_ON_PURCHASE |
Hiệu lực bắt đầu từ thời điểm mua. |
ACTIVATION_ON_FIRST_USE |
Thời điểm bắt đầu có hiệu lực kể từ lần đầu tiên người dùng sử dụng lựa chọn thanh toán này. |
UserPurchaseRestriction
Giới hạn những người dùng đủ điều kiện mua một phương thức thanh toán.
Biểu diễn dưới dạng JSON |
---|
{ "newToMerchant": boolean, "newToPaymentOption": boolean } |
Trường | |
---|---|
newToMerchant |
Một lựa chọn thanh toán chỉ dành cho người dùng chưa từng mua hàng của cùng một người bán. |
newToPaymentOption |
Một phương thức thanh toán chỉ có thể được mua bởi người dùng chưa từng mua cùng một phương thức thanh toán đó. |
PaymentProcessorConfig
Cấu hình cho công ty xử lý thanh toán, được thiết lập trên cơ sở từng Người bán.
Biểu diễn dưới dạng JSON |
---|
{
"processor": enum ( |
Trường | |
---|---|
processor |
Xác định đối tác xử lý thanh toán áp dụng cấu hình này. |
publicKey |
Khoá dùng để xác định người bán này với công ty xử lý thanh toán. Đối với Stripe, hãy tham khảo: https://stripe.com/docs/dashboard#api-keys Đối với Braintree, hãy tham khảo: https://articles.braintreepayments.com/control-panel/important-gateway-credentials |
version |
Số phiên bản API được gửi đến công ty xử lý thanh toán cùng với yêu cầu thanh toán. |
Bộ xử lý
Xác định một đối tác xử lý thanh toán cụ thể.
Enum | |
---|---|
PROCESSOR_UNSPECIFIED |
Không Sử Dụng |
PROCESSOR_STRIPE |
Cấu hình để thanh toán bằng Stripe. |
PROCESSOR_BRAINTREE |
Cấu hình cho các khoản thanh toán bằng Braintree. |
TokenizationConfig
Cấu hình để mã hoá đơn vị xử lý thanh toán, được thiết lập trên cơ sở từng Người bán.
Biểu diễn dưới dạng JSON |
---|
{
"tokenizationParameter": {
string: string,
...
},
"billingInformationFormat": enum ( |
Trường | |
---|---|
tokenizationParameter |
Cấu hình mã hoá thường sẽ có một tokenizationParameter có khoá là "gateway" và có giá trị là tên của đơn vị xử lý. Các tham số còn lại phụ thuộc vào bộ xử lý. Vui lòng xem tài liệu của Google Pay để biết thêm thông tin. Ví dụ về Braintree: tokenizationParameter { key: "gateway" giá trị: "cây não" } tokenizationParameters { key: "braintree:apiVersion" giá trị: "v1" } thông số tokenization { key: "braintree:sdkVersion" giá trị: "2.30.0" } Thông số mã hoá { key: "braintree:merchantId" giá trị: "abcdef" } tokenizationParameters { key: "braintree:clientKey" giá trị: "production_xxx_yyy" } Ví dụ về Stripe: tokenizationParameter { key: "gateway" giá trị: "sọc" } tokenizationParameters { key: "stripe:version" giá trị: "28-02-2018" } tokenizationParameters { key: "stripe:publishableKey" giá trị: "pk_1234" } Ví dụ về Adyen: tokenizationParameter { key: "gateway" giá trị: "adyen" } thông số tokenization { key: "gatewayMerchantId" giá trị: "yourId" } Một đối tượng chứa danh sách các cặp |
billingInformationFormat |
Thêm thông tin thanh toán của người dùng vào Google Pay bằng phương thức FOP (xem ở trên) trong mã thông báo thanh toán. Việc để trống trường này tương đương với việc chỉ định MIN. |
BillingInformationFormat
Lượng Địa chỉ thanh toán cần thiết cho người dùng và cung cấp mã thông báo. Các giá trị enum tương ứng với các thông số trong API Google Pay (xem https://developers.google.com/pay/api/web/reference/object#BillingAddressParameters).
Enum | |
---|---|
BILLING_INFORMATION_FORMAT_UNSPECIFIED |
Chưa chỉ định. Giá trị mặc định là MIN. |
MIN |
tên, mã quốc gia và mã bưu chính (chế độ cài đặt mặc định của Google Pay). |
FULL |
tên, địa chỉ đường phố, địa phương, khu vực, mã quốc gia và mã bưu chính. |
Điều khoản
Một bộ quy tắc và nguyên tắc mà người dùng nhìn thấy để đặt trước thông qua tính năng Đặt chỗ với Google.
Biểu diễn dưới dạng JSON |
---|
{
"url": string,
"text": string,
"localizedText": {
object ( |
Trường | |
---|---|
url |
URL đến Điều khoản và điều kiện (không bắt buộc). |
text |
Văn bản sẽ hiển thị với người dùng. Sử dụng localText bên dưới cho các công cụ tích hợp mới. |
localizedText |
Văn bản đã bản địa hoá sẽ hiển thị với người dùng. |
MerchantMatchingHints
Gợi ý dùng để giúp Google so khớp người bán với một địa điểm trên Google Maps.
Biểu diễn dưới dạng JSON |
---|
{ "placeId": string } |
Trường | |
---|---|
placeId |
Mã địa điểm của một địa điểm trong cơ sở dữ liệu Google Địa điểm và trên Google Maps. Hãy xem https://developers.google.com/places/web-service/place-id để biết thêm về mã địa điểm. |
ServiceAttribute
Thuộc tính dịch vụ là các danh mục do đối tác xác định, mô tả các Dịch vụ mà người bán cung cấp. Ví dụ: ngân hàng có thể xác định "Loại tài khoản" thuộc tính dịch vụ có thể có các giá trị "Cá nhân" và "Doanh nghiệp", trong khi tiệm làm tóc có thể xác định "Loại dịch vụ" với các giá trị có thể sử dụng là "Cắt tóc", "Màu" và "Kiểu".
Biểu diễn dưới dạng JSON |
---|
{
"attributeId": string,
"attributeName": string,
"value": [
{
object ( |
Trường | |
---|---|
attributeId |
Giá trị nhận dạng giúp xác định duy nhất thuộc tính dịch vụ này cùng các thuộc tính khác của cùng một người bán, ví dụ: "loại tài khoản". |
attributeName |
Tên hiển thị cho người dùng cho thuộc tính này, ví dụ: "Loại tài khoản". |
value[] |
Tất cả giá trị có thể có cho thuộc tính dịch vụ này. |
Giá trị
Biểu thị một giá trị có thể có cho một thuộc tính dịch vụ cụ thể.
Biểu diễn dưới dạng JSON |
---|
{ "valueId": string, "valueName": string } |
Trường | |
---|---|
valueId |
Giá trị nhận dạng giúp xác định duy nhất giá trị này trong số các giá trị khác cho thuộc tính dịch vụ này, ví dụ: "cá nhân". |
valueName |
Tên hiển thị cho người dùng cho giá trị, ví dụ: "Cá nhân". |
Lời khuyên
Nội dung thông báo hiển thị cho người dùng khi họ đặt phòng thông qua tính năng Đặt chỗ với Google.
Biểu diễn dưới dạng JSON |
---|
{
"text": {
object ( |
Trường | |
---|---|
text |
Thông báo tuỳ chỉnh sẽ hiển thị cho người dùng khi họ đặt phòng thông qua tính năng Đặt chỗ với Google. |
Phương thức |
|
---|---|
|
Tạo một trang web tổng hợp mới Merchant do trang web tổng hợp đã chỉ định quản lý và trả về trang web đó. |
|
Xoá một Merchant hiện có do đơn vị tập hợp đã chỉ định quản lý. |
|
Lấy MerchantStatus của Merchant . |
|
Cập nhật một trang web tổng hợp Merchant hiện có do trang web tổng hợp đã chỉ định quản lý và trả về trang web đó. |