- แหล่งข้อมูล: ผู้ขาย
- 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 |
อัตราภาษีของผู้ขายเป็นคะแนนพื้นฐาน (หนึ่งร้อยจากหนึ่งเปอร์เซ็นต์) เช่น หากอัตราภาษีคือ 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 ที่มีอยู่ในผู้ขายหรือบริการ ส่วนข้อความที่ว่างเปล่า (เช่น 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 |
การกำหนดค่าการแปลงข้อมูลเป็นโทเค็นมักมี TokenizationParameters ที่มีคีย์เป็น "gateway" และมีค่าเป็นชื่อของผู้ประมวลผลข้อมูล พารามิเตอร์ที่เหลือจะขึ้นอยู่กับตัวประมวลผล ดูข้อมูลเพิ่มเติมได้ในเอกสารประกอบของ Google Pay Braintree ตัวอย่าง: "v1" } พารามิเตอร์โทเค็น { key: "gateway" value: "braintree" } tokenizationชื่อพารามิเตอร์ { key: "braintree:apiVersion" value: "v1" } tokenization Parameters { key: "braintree:sdkVersion" value: "2.30.0" } }Tokenization parameter { key: "braintreyyy:merchantId"} ค่า: "v1" } Stripe ตัวอย่าง: TokenizationVariable { key: "gateway" value: "stripe" } การกำหนดค่าโทเค็น { คีย์: "stripe:เวอร์ชัน" ค่า: "2018-02-28" } พารามิเตอร์เหตุการณ์โทเค็น { คีย์: "stripe:publishableKey" ค่า: "pk_1234" } ตัวอย่าง Adyen: TokenizationParameters { key: "gateway" value: "adyen" } tokenizationParameters { key: "gatewayMerchantId" value: "yourId" } ออบเจ็กต์ที่มีรายการคู่ |
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
แอตทริบิวต์บริการคือหมวดหมู่ที่พาร์ทเนอร์กำหนดซึ่งอธิบายบริการสำหรับผู้ขาย เช่น ธนาคารอาจกำหนดแอตทริบิวต์บริการ "ประเภทบัญชี" โดยให้มีค่าเป็น "ส่วนตัว" และ "ธุรกิจ" ส่วนร้านทำผมอาจกำหนดแอตทริบิวต์บริการ "ประเภทบริการ" โดยให้มีค่าที่เป็นไปได้เป็น "การตัดผม" "สี" และ "สไตล์"
การแสดง JSON |
---|
{
"attributeId": string,
"attributeName": string,
"value": [
{
object ( |
ช่อง | |
---|---|
attributeId |
ตัวระบุที่จะระบุแอตทริบิวต์ของบริการนี้โดยไม่ซ้ำกันสำหรับผู้ขายรายเดียวกัน เช่น "ประเภทบัญชี" |
attributeName |
ชื่อที่ผู้ใช้มองเห็นสำหรับแอตทริบิวต์นี้ เช่น "ประเภทบัญชี" |
value[] |
ค่าที่เป็นไปได้ทั้งหมดสำหรับแอตทริบิวต์บริการนี้ |
ค่า
แสดงค่าที่เป็นไปได้สำหรับแอตทริบิวต์บริการที่เฉพาะเจาะจง
การแสดง JSON |
---|
{ "valueId": string, "valueName": string } |
ช่อง | |
---|---|
valueId |
ตัวระบุที่ระบุค่านี้โดยไม่ซ้ำกันสำหรับแอตทริบิวต์บริการนี้ เช่น "personal" |
valueName |
ชื่อค่าที่ผู้ใช้มองเห็นได้ เช่น "ส่วนบุคคล" |
คำแนะนำ
คำแนะนำที่แสดงต่อผู้ใช้เมื่อจองผ่าน "จองกับ Google"
การแสดง JSON |
---|
{
"text": {
object ( |
ช่อง | |
---|---|
text |
ข้อความที่กำหนดเองที่จะแสดงต่อผู้ใช้เมื่อจองผ่าน "จองกับ Google" |
วิธีการ |
|
---|---|
|
สร้าง Merchant ใหม่ที่จัดการโดยผู้รวบรวมข้อมูลที่ระบุ และส่งกลับมา |
|
ลบ Merchant ที่มีอยู่ซึ่งจัดการโดยผู้รวบรวมข้อมูลที่ระบุ |
|
รับ MerchantStatus ของ Merchant |
|
อัปเดต Merchant ที่มีอยู่ซึ่งจัดการโดยผู้รวบรวมข้อมูลที่ระบุ แล้วส่งกลับมา |