- 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 trang web tổng hợp.
Biểu diễn dưới dạng JSON |
---|
{ "name": string, "merchantName": string, "telephone": string, "url": string, "geo": { object ( |
Các trường | |
---|---|
name |
Tên tài nguyên của người bán (có định dạng |
merchantName |
merchantName, số điện thoại, url và địa lý được dùng để hỗ trợ việc so khớp kho hàng của đối tác với những người bán đã có trên Google Maps. Thông tin này sẽ không xuất hiện. Tên người bán. |
telephone |
Số điện thoại công khai của người bán, bao gồm cả mã quốc gia và mã vùng, 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 cả 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 tính 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%, bạn phải đặt giá trị cho trường này là 750. Nếu bạn không đặt hoặc đặt trường này thành 0, thì tổng giá tính cho người dùng đối với 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 giả định là được miễn hoặc đã bao gồm các khoản thuế hiện hành. Thuế sẽ không 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, thì tổng giá tính cho người dùng đối với mọi dịch vụ do người bán này cung cấp sẽ bao gồm giá dịch vụ cộng với thuế đánh giá theo thuế suất cung cấp tại đây. Phần thập phân của đơn vị tiền tệ nhỏ nhất (ví dụ: phân số của 1 xu) sẽ được làm tròn bằng cách làm tròn 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òn dùng nữa, vui lòng sử dụng taxRate thay thế. |
taxRate |
Thuế suất của người bán. Nếu có trường này, hãy ghi đè trường taxRateBasisPoint không dùng nữa. Nếu bạn nhận được thông báo trống (tức là taxRate { }) sẽ đặt lại thuế suất đã áp dụng về 0. |
paymentRestrictions |
Các quy định hạn chế đối với các phương thức thanh toán mà người bán này chấp nhận. Chúng tôi giả định không có quy định hạn chế nào nếu bạn không đặt trường này. |
paymentOption[] |
Các phương thức thanh toán có sẵn 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 từng lựa chọn thanh toán mà họ cho phép. |
paymentProcessorConfig |
Cấu hình của công ty xử lý thanh toán được mã hoá (nếu người bán có hỗ trợ công cụ xử lý đó). |
tokenizationConfig |
Cấu hình của công ty xử lý thanh toán được mã hoá (nếu người bán có hỗ trợ công cụ xử lý đó). |
terms |
Điều khoản và điều kiện của người bán cụ thể mà người dùng nhìn thấy khi người dùng đang đặt dịch vụ thông qua tính năng Đặt chỗ với Google. Ngoài ra, Điều khoản và điều kiện của đối tác tổng hợp luôn 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 mà người tiêu dùng nhìn thấy để sử dụng khi hiển thị thuộc tính của đối tác. Trường này cho phép các đối tác có nhiều thương hiệu tương tác trực tiếp với người tiêu dùng cung cấp cho người bán tất cả các thương hiệu trong cùng một nguồn cấp dữ liệu. Một thương hiệu bao gồm các đặc điểm mà người tiêu dùng nhìn thấy 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 đại diện cho người tiêu dùng, thì bạn không cần đặt và có thể bỏ qua trường này. Nếu đối tác... Không có nhiều thương hiệu hướng tới người tiêu dùng? --> Bỏ qua trường này Bạn có định cấu hình nhiều thương hiệu không?
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 thiết lập 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 dựa trên thông tin được cung cấp ở trên. (không bắt buộc) |
serviceAttribute[] |
Định nghĩa cho mọi thuộc tính dịch vụ dùng để mô tả Dịch vụ cho Người bán này. (không bắt buộc) |
actionLink[] |
Không bắt buộc. URL hành động có ngôn ngữ liên quan, danh sách 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 thực hiện hành động này trên nền tảng nào, |
waitlistAdvisement |
Không bắt buộc. Tư vấn chung của một người bán cụ thể cho người dùng tham gia danh sách chờ thông qua tính năng Đặt chỗ bằng Google. Mỗi trường văn bản trong nội dung tư vấn chỉ được có độ dài tối đa là 100 byte. |
PaymentRestrictions
Các quy định hạn chế đối với các 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 ( |
Các trường | |
---|---|
creditCardRestrictions |
Các 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ả 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 lên theo thời gian, nghĩa là việc để lại cấu hình cho các đối tượng trống này sẽ dẫn đến những thay đổi trong tương lai. |
CreditCardRestrictions
Các hạn chế đối với các 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 ( |
Các 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 thẻ 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 của Khám phá. |
JCB |
Thẻ tín dụng JCB. |
PaymentOption
Một phương thức thanh toán để thanh toán cho các dịch vụ do người bán cung cấp. Nhiều người bán có thể dùng chung phương thức thanh toán (ví dụ: những người bán thuộc cùng một chuỗi cửa hàng).
Biểu diễn dưới dạng JSON |
---|
{ "paymentOptionId": string, "name": string, "description": string, "price": { object ( |
Các trường | |
---|---|
paymentOptionId |
Mã này được dùng để xác định lựa chọn thanh toán này. Mã nhận dạng này áp dụng chung cho toàn bộ trang web tổng 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 cho những người bán đó. Khi bạn sử dụng lại một 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 đó ở một người bán khác. Do đó, phương pháp hay nhất là để tất 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 suy yếu. |
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ề lựa chọn thanh toán. Người dùng có thể nhìn thấy thông tin này. |
price |
Giá của phương thức 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 trong Người bán hoặc Dịch vụ. Nếu bạn nhận được thông báo trống (tức là taxRate { }) sẽ đặt lại thuế suất đã áp dụng về 0. |
paymentOptionType |
Loại của tuỳ chọn thanh toán này. Dùng một lần cho các gói thả xuống, dùng nhiều lần cho các gói và không giới hạn cho gói thành viên. |
sessionCount |
Số phiên hoạt động mà phương thức thanh toán này có thể được sử dụng. Chỉ hợp lệ cho nhiều phiên / gói, trong đó giá trị phải lớn hơn 1. |
purchaseInterval |
Người dùng có thể mua lựa chọn thanh toán trong khoảng thời gian này. |
validInterval |
Bạn 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ó, tuỳ chọn này sẽ ghi đè validDuration và ActivateType. |
validDuration |
Thời hạn có 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 có 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 tuỳ chọn thanh toán này. |
userRestriction |
Hạn chế 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 phương thức 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, thì tất cả người dùng đều đủ điều kiện. |
PaymentOptionType
Một 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ể được 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 chức năng đó > 0. |
PAYMENT_OPTION_UNLIMITED |
Có thể sử dụng tùy chọn thanh toán trong phạm vi thời gian hợp lệ - không thể áp dụng số phiên. |
ActivationType
Xác định cách xác định ngày bắt đầu hiệu lực.
Enum | |
---|---|
ACTIVATION_TYPE_UNSPECIFIED |
Không sử dụng. |
ACTIVATION_ON_PURCHASE |
Ưu đãi có hiệu lực tại thời điểm mua. |
ACTIVATION_ON_FIRST_USE |
Ưu đãi 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
Hạn chế người dùng đủ điều kiện mua phương thức thanh toán.
Biểu diễn dưới dạng JSON |
---|
{ "newToMerchant": boolean, "newToPaymentOption": boolean } |
Các trường | |
---|---|
newToMerchant |
Đây là phương thức thanh toán chỉ dành cho những người dùng chưa từng mua hàng của cùng một người bán. |
newToPaymentOption |
Một lựa chọn thanh toán chỉ dành cho những người dùng chưa từng mua loại hình thanh toán này trước đây. |
PaymentProcessorConfig
Cấu hình cho công ty xử lý thanh toán, được thiết lập theo từng Người bán.
Biểu diễn dưới dạng JSON |
---|
{
"processor": enum ( |
Các 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, vui lòng tham khảo: https://stripe.com/docs/dashboard#api-keys Đối với nãotree, 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 của các khoản thanh toán bằng Stripe. |
PROCESSOR_BRAINTREE |
Cấu hình của các khoản thanh toán bằng Hearttree. |
TokenizationConfig
Cấu hình để mã hoá đơn vị xử lý thanh toán, 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 ( |
Các trường | |
---|---|
tokenizationParameter |
Cấu hình của quá trình mã hoá thường sẽ có một tokenizationParameter (mã thông báo) có khoá là "gateway" và giá trị là tên của trình xử lý. Các thông số còn lại phụ thuộc vào bộ xử lý. Hãy xem tài liệu của Google Pay để biết thêm thông tin. Ví dụ: tokenizationParameter { key: "gateway" value: "braintree" } tokenizationParameter { key: "braintree:apiVersion" value: "v1" } tokenizationParameter { key: "braintree:sdkVersion" value: "2.30.0" } tokenizationParameter { key: "braintree:merchantId" } " Ví dụ về Stripe: tokenizationParameter { key: "gateway" value: "stripe" } tokenizationParameter { key: "stripe:version" giá trị: "2018-02-28" } tokenizationParameter { key: "stripe:publishableKey" giá trị: "pk_1234" } Ví dụ về Adyen: tokenizationParameter { key: "gateway" value: "adyen" } tokenizationParameter { key: "gatewayMerchantId" value: "yourId" } Một đối tượng chứa danh sách các cặp |
billingInformationFormat |
Cung cấp thông tin thanh toán của người dùng khi đã nhập thông tin thanh toán vào Google Pay bằng phương thức FOP của họ vào mã thanh toán (xem ở trên). Để trống trường này tương đương với việc chỉ định MIN. |
BillingInformationFormat
Số lượng Địa chỉ thanh toán cần yêu cầu ở người dùng và thêm vào 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 xác đị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. |
Thuật ngữ
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 ( |
Các trường | |
---|---|
url |
URL dẫn đến Điều khoản và điều kiện (không bắt buộc). |
text |
Văn bản mà người dùng nhìn thấy. Sử dụng địa phương văn bản bên dưới để tích hợp mới. |
localizedText |
Văn bản đã bản địa hoá mà người dùng sẽ thấy. |
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 } |
Các trường | |
---|---|
placeId |
Mã địa điểm cho một địa điểm trong cơ sở dữ liệu của Google Địa điểm và trên Google Maps. Truy cập vào https://developers.google.com/places/web-service/place-id để biết thêm thông tin về Mã địa điểm. |
ServiceAttribute
Thuộc tính dịch vụ là danh mục do đối tác xác định, mô tả các Dịch vụ cho Người bán. Ví dụ: ngân hàng có thể xác định thuộc tính dịch vụ "Loại tài khoản" với các giá trị có thể là "Cá nhân" và "Doanh nghiệp", trong khi tiệm làm tóc có thể xác định thuộc tính dịch vụ "Loại dịch vụ" với các giá trị có thể là "Cắt tóc", "Màu sắc" và "Kiểu".
Biểu diễn dưới dạng JSON |
---|
{
"attributeId": string,
"attributeName": string,
"value": [
{
object ( |
Các 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 trong số các thuộc tính khác của cùng một người bán, ví dụ như "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ả các giá trị có thể sử dụng 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 cụ thể của dịch vụ.
Biểu diễn dưới dạng JSON |
---|
{ "valueId": string, "valueName": string } |
Các trường | |
---|---|
valueId |
Một 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ụ như "cá nhân". |
valueName |
Tên mà người dùng nhìn thấy cho giá trị, ví dụ: "Cá nhân". |
Khuyến cáo
Thông báo tư vấn hiển thị cho người dùng khi đặt chỗ thông qua tính năng Đặt chỗ bằng Google.
Biểu diễn dưới dạng JSON |
---|
{
"text": {
object ( |
Các trường | |
---|---|
text |
Thông báo tuỳ chỉnh sẽ hiển thị cho người dùng khi đặt chỗ thông qua tính năng Đặt chỗ bằng Google. |
Phương thức |
|
---|---|
|
Tạo một Merchant mới do trình tổng hợp đã chỉ định quản lý rồi trả về mã này. |
|
Xoá Merchant hiện có do đơn vị tập hợp được chỉ định quản lý. |
|
Lấy MerchantStatus của Merchant . |
|
Cập nhật một Merchant hiện có do đơn vị tập hợp được chỉ định quản lý rồi trả lại tệp này. |