- แหล่งข้อมูล: ผู้ขาย
- PaymentRestrictions
- CreditCardRestrictions
- CreditCardType
- PaymentOption
- PaymentOptionType
- ActivationType
- UserPurchaseRestriction
- PaymentProcessorConfig
- โปรเซสเซอร์
- TokenizationConfig
- BillingInformationFormat
- ข้อกำหนด
- MerchantMatchingHints
- ServiceAttribute
- ค่า
- คำแนะนำ
- เมธอด
แหล่งข้อมูล: ผู้ขาย
ข้อมูลเกี่ยวกับผู้ขายที่อยู่บนแพลตฟอร์มของผู้รวบรวมข้อมูล
การแสดง JSON |
---|
{ "name": string, "merchantName": string, "telephone": string, "url": string, "geo": { object ( |
ช่อง | |
---|---|
name |
ชื่อทรัพยากรผู้ขาย ซึ่งมีรูปแบบ |
merchantName |
ระบบใช้ MerchantName, โทรศัพท์, URL และภูมิศาสตร์เพื่อรองรับการจับคู่สินค้าคงคลังของพาร์ทเนอร์กับผู้ขายที่มีอยู่ใน Google Maps อยู่แล้ว ข้อมูลนี้จะไม่แสดง ชื่อผู้ขาย |
telephone |
หมายเลขโทรศัพท์สาธารณะของผู้ขาย รวมถึงรหัสประเทศและรหัสพื้นที่ เช่น +14567891234 |
url |
URL ของเว็บไซต์สาธารณะของผู้ขาย |
geo |
ข้อมูลทางภูมิศาสตร์ของผู้ขาย รวมถึงละติจูด ลองจิจูด และที่อยู่ |
category |
หมวดหมู่ของธุรกิจในแพลตฟอร์มของผู้รวบรวมข้อมูล |
numBookings30d |
ช่องนี้เลิกใช้งานแล้ว |
taxRateBasisPoints |
อัตราภาษีของผู้ขายเป็นคะแนนพื้นฐาน (100 ของเปอร์เซ็นต์) เช่น หากอัตราภาษีคือ 7.5% ช่องนี้ควรตั้งค่าเป็น 750 หากไม่ได้ตั้งค่าช่องนี้หรือตั้งค่าเป็น 0 ราคารวมที่เรียกเก็บจากผู้ใช้สำหรับบริการใดก็ตามที่ผู้ขายรายนี้จะเป็นราคาที่แน่นอนที่ Service.price ระบุไว้ ราคาบริการนี้ถือว่าได้รับการยกเว้นหรือรวมภาษีที่เกี่ยวข้องแล้ว ภาษีจะไม่แสดงให้ผู้ใช้เห็นเป็นบรรทัดรายการแยกต่างหาก หากตั้งค่าช่องนี้เป็นค่าที่ไม่ใช่ 0 ราคารวมที่เรียกเก็บจากผู้ใช้สำหรับบริการใดๆ ที่ผู้ขายให้จะรวมราคาบริการบวกภาษีที่ประเมินโดยใช้อัตราภาษีที่ระบุไว้ที่นี่ เศษส่วนของหน่วยสกุลเงินที่เล็กที่สุด (เช่น เศษส่วน 1 เซ็นต์) จะปัดเศษโดยใช้การปัดเศษทศนิยมที่ใกล้เคียงที่สุด ภาษีจะแสดงต่อผู้ใช้เป็นบรรทัดรายการแยกต่างหาก ช่องนี้เลิกใช้งานแล้ว โปรดใช้ TaxRate แทน |
taxRate |
อัตราภาษีของผู้ขาย หากมีช่องนี้จะลบล้างช่อง TaxRateBasisPoints ที่เลิกใช้งานแล้ว ข้อความว่างเปล่า (เช่นtaxRate { }) จะรีเซ็ตอัตราภาษีที่ใช้เป็น 0 |
paymentRestrictions |
ข้อจำกัดเกี่ยวกับวิธีการชำระเงินที่ผู้ขายรายนี้ยอมรับ เราถือว่าไม่มีข้อจำกัดหากไม่ได้ตั้งค่าช่องนี้ |
paymentOption[] |
ตัวเลือกการชำระเงินที่มีให้สำหรับผู้ขายรายนี้ บริการภายใต้ผู้ขายรายนี้จะสามารถจำกัดตัวเลือกการชำระเงินที่ผู้ขายอนุญาตได้ทีละรายการ |
paymentProcessorConfig |
การกำหนดค่าสำหรับผู้ประมวลผลการชำระเงินที่แปลงเป็นโทเค็น หากผู้ขายรองรับ |
tokenizationConfig |
การกำหนดค่าสำหรับผู้ประมวลผลการชำระเงินที่แปลงเป็นโทเค็น หากผู้ขายรองรับ |
terms |
ข้อกำหนดและเงื่อนไขของผู้ขายที่เฉพาะเจาะจงซึ่งแสดงต่อผู้ใช้เมื่อมีการจองบริการผ่าน "จองกับ Google" นอกจากข้อกำหนดและเงื่อนไขของพาร์ทเนอร์ผู้รวบรวมข้อมูลเหล่านี้จะแสดงต่อผู้ใช้ทุกครั้งและต้องไม่ระบุไว้ที่นี่ |
brandId |
สตริงที่คลุมเครือซึ่งระบุแบรนด์ที่ผู้บริโภคใช้เมื่อแสดงการระบุแหล่งที่มาของพาร์ทเนอร์ ช่องนี้จะช่วยให้พาร์ทเนอร์ที่มีแบรนด์สำหรับผู้บริโภคหลายแบรนด์มอบผู้ขายสำหรับแบรนด์ทั้งหมดภายในฟีดเดียวกันได้ แบรนด์ประกอบด้วยพร็อพเพอร์ตี้ที่แสดงต่อผู้ใช้ เช่น ชื่อ โลโก้ ข้อกำหนดในการให้บริการ และนโยบายความเป็นส่วนตัว หากมีแบรนด์พาร์ทเนอร์สำหรับผู้บริโภคเพียงแบรนด์เดียว ก็ไม่จำเป็นต้องตั้งค่าช่องนี้และไม่ต้องสนใจ หากพาร์ทเนอร์... หากไม่มีแบรนด์สำหรับผู้บริโภคหลายแบรนด์ --> ละเว้นช่องนี้ มีแบรนด์หลายรายการที่กำหนดค่าไว้หรือไม่
หมายเหตุ: พาร์ทเนอร์ส่วนใหญ่ไม่จำเป็นต้องตั้งค่าช่องนี้ หากพาร์ทเนอร์ต้องการใช้ช่องนี้ พาร์ทเนอร์ต้องติดต่อเราก่อนเพื่อกำหนดค่าแบรนด์แยกกัน รวมถึงแบรนด์เริ่มต้น |
matchingHints |
คำแนะนำที่จะช่วยให้ Google จับคู่ผู้ขายกับสถานที่ใน Google Maps หมายเหตุ: พาร์ทเนอร์ส่วนใหญ่ไม่จำเป็นต้องตั้งค่าช่องนี้ เนื่องจาก Google จะจับคู่ผู้ขายกับสถานที่ใน Google Maps โดยใช้ข้อมูลที่ให้ไว้ข้างต้น (ไม่บังคับ) |
serviceAttribute[] |
คำจำกัดความของแอตทริบิวต์ของบริการที่ใช้เพื่ออธิบายบริการสำหรับผู้ขายรายนี้ (ไม่บังคับ) |
actionLink[] |
ไม่บังคับ URL การดำเนินการที่มีภาษาที่เกี่ยวข้อง รายชื่อประเทศที่ถูกจำกัด ประเภท และแพลตฟอร์มที่ไม่บังคับซึ่งระบุว่าต้องดำเนินการกับแพลตฟอร์มใด |
waitlistAdvisement |
ไม่บังคับ คำแนะนำทั่วไปจากผู้ขายที่เฉพาะเจาะจงสำหรับผู้ใช้ที่เข้าร่วมคิวรอผ่าน "จองกับ Google" ช่องข้อความแต่ละช่องในคำแนะนำควรมีความยาวได้ไม่เกิน 100 ไบต์ |
PaymentRestrictions
ข้อจำกัดเกี่ยวกับวิธีการชำระเงินที่ผู้ขายรายนี้ยอมรับ
การแสดง JSON |
---|
{
"creditCardRestrictions": {
object ( |
ช่อง | |
---|---|
creditCardRestrictions |
ข้อจำกัดเกี่ยวกับบัตรเครดิตที่ผู้ขายรายนี้ยอมรับ เราถือว่าเรายอมรับบัตรเครดิตทั้งหมด หากไม่ได้ตั้งช่องนี้ไว้ โปรดทราบว่ารายการของบัตรที่ CreditCardType รองรับจะมีจำนวนเพิ่มขึ้นเรื่อยๆ ซึ่งหมายความว่าการปล่อยหัวเรื่องให้ว่างเปล่านี้จะทำให้เกิดการเปลี่ยนแปลงในอนาคต |
CreditCardRestrictions
ข้อจำกัดเกี่ยวกับประเภทบัตรเครดิตที่ผู้ขายรายนี้ยอมรับ
การแสดง JSON |
---|
{
"creditCardType": [
enum ( |
ช่อง | |
---|---|
creditCardType[] |
รายการบัตรเครดิตที่รองรับ ไม่มีบัตรเครดิตที่รองรับหากไม่มีข้อมูล |
CreditCardType
ประเภทบัตรเครดิต
Enum | |
---|---|
CREDIT_CARD_TYPE_UNSPECIFIED |
ไม่ได้ใช้งาน |
VISA |
บัตรเครดิต Visa |
MASTERCARD |
บัตรเครดิต Mastercard |
AMERICAN_EXPRESS |
บัตรเครดิต American Express |
DISCOVER |
บัตรเครดิต Discover |
JCB |
บัตรเครดิต JCB |
PaymentOption
ตัวเลือกการชำระเงินที่ใช้ชำระค่าบริการของผู้ขายได้ ตัวเลือกการชำระเงินสามารถแชร์ระหว่างผู้ขายหลายราย (เช่น ผู้ขายที่อยู่ในเครือเดียวกัน)
การแสดง JSON |
---|
{ "paymentOptionId": string, "name": string, "description": string, "price": { object ( |
ช่อง | |
---|---|
paymentOptionId |
รหัสนี้ใช้เพื่อระบุตัวเลือกการชำระเงินนี้ รหัสนี้ใช้กับผู้รวบรวมข้อมูลทั้งหมดทั่วโลก และการใช้ค่าซ้ำสำหรับผู้ขายหลายรายจะช่วยให้ผู้ใช้ชำระเงินด้วยตัวเลือกการชำระเงินที่เกี่ยวข้องสำหรับผู้ขายเหล่านั้น เมื่อใช้รหัสซ้ำเพื่อเข้าถึงผู้ขายหลายราย การอัปเดตค่าสำหรับตัวเลือกการชำระเงินภายใต้ผู้ขายรายหนึ่งจะเป็นการอัปเดตตัวเลือกการชำระเงินอื่นๆ ที่มีรหัสเดียวกันด้วยภายใต้ผู้ขายรายอื่น ดังนั้น แนวทางปฏิบัติแนะนำคือให้ตัวเลือกการชำระเงินทั้งหมดที่ใช้รหัสเดียวกันและได้รับการอัปเดตให้เป็นค่าเดียวกันเสมอ เพื่อหลีกเลี่ยงโอกาสที่จะเกิดพฤติกรรมที่ต่ำเกินจริง |
name |
ชื่อของตัวเลือกการชำระเงิน โดยผู้ใช้จะมองเห็นสิ่งนี้ได้ |
description |
คำอธิบายตัวเลือกการชำระเงิน โดยผู้ใช้จะมองเห็นสิ่งนี้ได้ |
price |
ราคาของตัวเลือกการชำระเงิน |
taxRate |
อัตราภาษีสำหรับตัวเลือกการชำระเงินนี้ หากมีช่องนี้จะลบล้างช่องอัตราภาษีที่มีอยู่ในผู้ขายหรือบริการ ข้อความว่างเปล่า (เช่นtaxRate { }) จะรีเซ็ตอัตราภาษีที่ใช้เป็น 0 |
paymentOptionType |
ประเภทของตัวเลือกการชำระเงินนี้ ใช้รายการเดียวเพื่อการดร็อปอิน อเนกประสงค์สำหรับแพ็กเกจ และไม่จำกัดสำหรับการเป็นสมาชิก |
sessionCount |
จำนวนเซสชันที่ใช้ได้สำหรับตัวเลือกการชำระเงินนี้ ใช้ได้กับหลายเซสชัน / แพ็กเท่านั้น ซึ่งควรมีค่า > 1. |
purchaseInterval |
คุณสามารถซื้อตัวเลือกการชำระเงินได้ภายในช่วงเวลานี้ |
validInterval |
คุณสามารถใช้ตัวเลือกการชำระเงินภายในระยะเวลานี้ (เช่น ราคาพิเศษสำหรับเดือนมกราคม 2017) หากมี คอลัมน์นี้จะลบล้าง validDuration และactivateType |
validDuration |
ระยะเวลาของตัวเลือกการชำระเงินที่ใช้ได้ (เช่น การเป็นสมาชิก 30 วัน) ระยะเวลาเป็นวินาทีโดยมีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย " |
activationType |
กำหนดวันที่เริ่มต้นที่ใช้งานได้สำหรับตัวเลือกการชำระเงินนี้ |
userRestriction |
จำกัดผู้ใช้ที่มีสิทธิ์ซื้อตัวเลือกการชำระเงินนี้ ใช้เพื่อจำกัดตัวเลือกการชำระเงินตามโปรโมชันสำหรับผู้ใช้กลุ่มย่อย หากไม่ได้ตั้งค่า ผู้ใช้ทุกคนจะมีสิทธิ์ |
PaymentOptionType
ประเภทของตัวเลือกการชำระเงิน
Enum | |
---|---|
PAYMENT_OPTION_TYPE_UNSPECIFIED |
ไม่ได้ใช้งาน |
PAYMENT_OPTION_SINGLE_USE |
ตัวเลือกการชำระเงินสามารถใช้ได้เพียงครั้งเดียว |
PAYMENT_OPTION_MULTI_USE |
สามารถใช้ตัวเลือกการชำระเงินได้หากจำนวนเซสชัน > 0. |
PAYMENT_OPTION_UNLIMITED |
สามารถใช้ตัวเลือกการชำระเงินได้ภายในช่วงเวลาที่ใช้งานได้ - จำนวนเซสชันไม่เกี่ยวข้อง |
ActivationType
ระบุวิธีกำหนดวันที่เริ่มต้นความถูกต้อง
Enum | |
---|---|
ACTIVATION_TYPE_UNSPECIFIED |
ไม่ได้ใช้งาน |
ACTIVATION_ON_PURCHASE |
อายุการใช้งานจะเริ่ม ณ เวลาที่ซื้อ |
ACTIVATION_ON_FIRST_USE |
อายุการใช้งานจะเริ่มเมื่อมีการใช้ตัวเลือกการชำระเงินเป็นครั้งแรก |
UserPurchaseRestriction
จำกัดผู้ใช้ที่มีสิทธิ์ซื้อตัวเลือกการชำระเงิน
การแสดง JSON |
---|
{ "newToMerchant": boolean, "newToPaymentOption": boolean } |
ช่อง | |
---|---|
newToMerchant |
ตัวเลือกการชำระเงินที่จะซื้อได้โดยผู้ใช้ที่ไม่เคยซื้อสินค้าจากผู้ขายรายเดียวกันมาก่อนเท่านั้น |
newToPaymentOption |
ตัวเลือกการชำระเงินที่จะซื้อได้โดยผู้ใช้ที่ไม่เคยซื้อตัวเลือกการชำระเงินเดียวกันมาก่อนเท่านั้น |
PaymentProcessorConfig
การกำหนดค่าสำหรับผู้ประมวลผลการชำระเงินที่ตั้งค่าไว้สำหรับผู้ขายแต่ละราย
การแสดง JSON |
---|
{
"processor": enum ( |
ช่อง | |
---|---|
processor |
กำหนดพาร์ทเนอร์ผู้ประมวลผลการชำระเงินที่ใช้การกำหนดค่านี้ |
publicKey |
คีย์ที่ใช้ระบุผู้ขายรายนี้กับผู้ประมวลผลการชำระเงิน สำหรับ Stripe โปรดไปที่ https://stripe.com/docs/dashboard#api-keys สำหรับ Braintree โปรดดู https://articles.braintreepayments.com/control-panel/important-gateway-credentials |
version |
หมายเลขเวอร์ชันของ API ที่ส่งไปยังผู้ประมวลผลการชำระเงินพร้อมกับคำขอการชำระเงิน |
โปรเซสเซอร์
กำหนดพาร์ทเนอร์ผู้ประมวลผลการชำระเงินที่เฉพาะเจาะจง
Enum | |
---|---|
PROCESSOR_UNSPECIFIED |
ไม่ได้ใช้งาน |
PROCESSOR_STRIPE |
การกำหนดค่าสำหรับการชำระเงินด้วย Stripe |
PROCESSOR_BRAINTREE |
การกำหนดค่าสำหรับการชำระเงินด้วย Braintree |
TokenizationConfig
การกำหนดค่าสำหรับการแปลงข้อมูลเป็นโทเค็นของผู้ประมวลผลการชำระเงิน ซึ่งตั้งค่าตามผู้ขายแต่ละราย
การแสดง JSON |
---|
{
"tokenizationParameter": {
string: string,
...
},
"billingInformationFormat": enum ( |
ช่อง | |
---|---|
tokenizationParameter |
โดยทั่วไปแล้ว การกําหนดค่าการแปลงเป็นโทเค็นจะมีโทเค็นการเปลี่ยนแปลงพารามิเตอร์ 1 รายการซึ่งมีคีย์เป็น "เกตเวย์" และมีค่าเป็นชื่อของโปรเซสเซอร์ใด พารามิเตอร์ที่เหลือจะขึ้นอยู่กับโปรเซสเซอร์ ดูข้อมูลเพิ่มเติมได้ในเอกสารประกอบของ Google Pay ตัวอย่าง Braintree: TokenizationParameters { key: "gateway" ค่า: "braintree" }TokenizationParameters { คีย์: "braintree:apiVersion" ค่า: "v1" }Tokenizationพารามิเตอร์ { คีย์: "braintree:sdkVersion" ค่า: "2.30.0" } พารามิเตอร์การแปลงข้อมูล { คีย์: "braintree:merchantId" ค่า: "abcdef" }TokenizationParameters { คีย์: "braintree:clientKey" ค่า: "production_xxx_yyy" } ตัวอย่าง Stripe: TokenizationParameters { key: "gateway" ค่า: "แถบ" }Tokenizationพารามิเตอร์ { คีย์: "stripe:version" value: "2018-02-28" }Tokenizationพารามิเตอร์ { คีย์: "stripe:publishableKey" ค่า: "pk_1234" } ตัวอย่าง Adyen: TokenizationParameters { key: "gateway" ค่า: "adyen" }Tokenizationพารามิเตอร์ { คีย์: "gatewayMerchantId" value: "รหัสของคุณ" } ออบเจ็กต์ที่มีรายการคู่ |
billingInformationFormat |
ใส่ข้อมูลสำหรับการเรียกเก็บเงินของผู้ใช้ตามที่ป้อนใน Google Pay โดยใช้รูปแบบการชำระเงินในโทเค็นการชำระเงิน (ดูด้านบน) การเว้นช่องนี้ว่างไว้เทียบเท่ากับการระบุ MIN |
BillingInformationFormat
ที่อยู่สำหรับการเรียกเก็บเงินที่ผู้ใช้ต้องระบุและรวมไว้ในโทเค็น ค่า enum สอดคล้องกับพารามิเตอร์ใน Google Pay API (ดู https://developers.google.com/pay/api/web/reference/object#BillingAddressParameters)
Enum | |
---|---|
BILLING_INFORMATION_FORMAT_UNSPECIFIED |
ไม่ได้ระบุ ค่าเริ่มต้นคือ MIN |
MIN |
ชื่อ รหัสประเทศ และรหัสไปรษณีย์ (การตั้งค่าเริ่มต้นของ Google Pay) |
FULL |
ชื่อ, ที่อยู่, ย่าน, ภูมิภาค, รหัสประเทศ และรหัสไปรษณีย์ |
ข้อกำหนด
ชุดกฎและหลักเกณฑ์ที่แสดงต่อผู้ใช้เพื่อทำการจองผ่าน "จองกับ Google"
การแสดง JSON |
---|
{
"url": string,
"text": string,
"localizedText": {
object ( |
ช่อง | |
---|---|
url |
(ไม่บังคับ) URL ไปยังข้อกำหนดในการให้บริการ |
text |
ข้อความที่จะแสดงต่อผู้ใช้ ใช้ localizedText ด้านล่างสำหรับการผสานรวมใหม่ |
localizedText |
ข้อความที่แปลแล้วที่จะแสดงต่อผู้ใช้ |
MerchantMatchingHints
คำแนะนำที่ใช้เพื่อช่วยให้ Google จับคู่ผู้ขายกับสถานที่ใน Google Maps
การแสดง JSON |
---|
{ "placeId": string } |
ช่อง | |
---|---|
placeId |
รหัสสถานที่ของสถานที่ในฐานข้อมูล Google Places และใน Google Maps ดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่ได้ที่ https://developers.google.com/places/web-service/place-id |
ServiceAttribute
แอตทริบิวต์ของบริการคือหมวดหมู่ที่กำหนดโดยพาร์ทเนอร์ ซึ่งอธิบายถึงบริการสำหรับผู้ขาย ตัวอย่างเช่น ธนาคารอาจกำหนด "ประเภทบัญชี" แอตทริบิวต์บริการที่มีค่าที่เป็นไปได้เป็น "Personal" และ "ธุรกิจ" ในขณะที่ร้านทำผมอาจกำหนด "ประเภทบริการ" service [บริการ] ที่มีค่าที่เป็นไปได้เป็น "Haircut", "Color" และ "Style"
การแสดง JSON |
---|
{
"attributeId": string,
"attributeName": string,
"value": [
{
object ( |
ช่อง | |
---|---|
attributeId |
ตัวระบุที่ระบุแอตทริบิวต์บริการนี้โดยไม่ซ้ำกันสำหรับผู้ขายรายเดียวกัน เช่น "account-type" |
attributeName |
ชื่อที่ผู้ใช้มองเห็นได้สำหรับแอตทริบิวต์นี้ เช่น "ประเภทบัญชี" |
value[] |
ค่าที่เป็นไปได้ทั้งหมดสำหรับแอตทริบิวต์บริการนี้ |
ค่า
แสดงค่าที่เป็นไปได้สำหรับแอตทริบิวต์บริการที่เฉพาะเจาะจง
การแสดง JSON |
---|
{ "valueId": string, "valueName": string } |
ช่อง | |
---|---|
valueId |
ตัวระบุที่ระบุค่านี้โดยไม่ซ้ำกันสำหรับแอตทริบิวต์บริการนี้ เช่น "ส่วนตัว" |
valueName |
ชื่อที่ผู้ใช้มองเห็นสำหรับค่าดังกล่าว เช่น "ส่วนตัว" |
คำแนะนำ
คำแนะนำที่แสดงต่อผู้ใช้เมื่อจองผ่าน "จองกับ Google"
การแสดง JSON |
---|
{
"text": {
object ( |
ช่อง | |
---|---|
text |
ข้อความที่กำหนดเองที่จะแสดงแก่ผู้ใช้เมื่อจองผ่าน "จองกับ Google" |
เมธอด |
|
---|---|
|
สร้าง Merchant ใหม่ที่จัดการโดยผู้รวบรวมข้อมูลที่ระบุและส่งคืน |
|
ลบ Merchant ที่มีอยู่ซึ่งจัดการโดยผู้รวบรวมข้อมูลที่ระบุ |
|
รับ MerchantStatus ของ Merchant |
|
อัปเดตMerchant ที่มีอยู่ซึ่งจัดการโดยผู้รวบรวมข้อมูลที่ระบุ และส่งข้อมูลดังกล่าวกลับมา |