- แหล่งข้อมูล: ผู้ขาย
- PaymentRestrictions
- CreditCardRestrictions
- CreditCardType
- PaymentOption
- PaymentOptionType
- ActivationType
- UserPurchaseRestriction
- PaymentProcessorConfig
- โปรเซสเซอร์
- TokenizationConfig
- BillingInformationFormat
- ข้อกำหนด
- MerchantMatchingHints
- ServiceAttribute
- ค่า
- การให้คําแนะนํา
- EconomicOperator
- เมธอด
แหล่งข้อมูล: ผู้ขาย
ข้อมูลเกี่ยวกับผู้ขายที่อยู่ในแพลตฟอร์มของผู้รวบรวมข้อมูล
การแสดง JSON |
---|
{ "name": string, "merchantName": string, "telephone": string, "url": string, "geo": { object ( |
ช่อง | |
---|---|
name |
ชื่อทรัพยากรของผู้ขายซึ่งมีรูปแบบเป็น |
merchant |
ระบบจะใช้ merchantName, telephone, url และ geo เพื่อรองรับการจับคู่สินค้าคงคลังของพาร์ทเนอร์กับผู้ขายที่มีอยู่ใน Google Maps อยู่แล้ว ระบบจะไม่แสดงข้อมูลนี้ ชื่อผู้ขาย |
telephone |
หมายเลขโทรศัพท์สาธารณะของผู้ขาย รวมถึงรหัสประเทศและรหัสพื้นที่ เช่น +14567891234 |
url |
URL ของเว็บไซต์สาธารณะของผู้ขาย |
geo |
ข้อมูลทางภูมิศาสตร์ของผู้ขาย ซึ่งรวมถึงละติจูด ลองจิจูด และที่อยู่ |
category |
หมวดหมู่ของธุรกิจในแพลตฟอร์มของผู้รวบรวมข้อมูล |
numBookings30d |
ช่องนี้เลิกใช้งานแล้ว |
taxRateBasisPoints |
อัตราภาษีของผู้ขายในจุดฐาน (1 ใน 100 ของ 1 เปอร์เซ็นต์) เช่น หากอัตราภาษีคือ 7.5% คุณควรตั้งค่าช่องนี้เป็น 750 หากไม่ได้ตั้งค่าช่องนี้หรือตั้งค่าเป็น 0 ราคารวมที่เรียกเก็บจากผู้ใช้สำหรับบริการใดๆ ที่ผู้ให้บริการรายนี้มอบให้คือราคาที่แน่นอนที่ระบุโดย Service.price ระบบจะถือว่าราคาบริการได้รับการยกเว้นหรือรวมภาษีที่เกี่ยวข้องแล้ว ระบบจะไม่แสดงภาษีเป็นบรรทัดรายการแยกต่างหากแก่ผู้ใช้ หากตั้งค่าฟิลด์นี้เป็นค่าที่ไม่ใช่ 0 ราคารวมที่เรียกเก็บจากผู้ใช้สำหรับบริการใดๆ ที่ผู้ให้บริการรายนี้จัดหาให้จะรวมราคาบริการบวกภาษีที่ประเมินโดยใช้อัตราภาษีที่ระบุไว้ที่นี่ ระบบจะปัดเศษส่วนของหน่วยสกุลเงินที่เล็กที่สุด (เช่น เศษส่วนของ 1 เซนต์) โดยใช้การปัดเศษให้ใกล้เคียงที่สุด ระบบจะแสดงภาษีเป็นบรรทัดรายการแยกต่างหากแก่ผู้ใช้ ช่องนี้เลิกใช้งานแล้ว โปรดใช้ taxRate แทน |
tax |
อัตราภาษีของผู้ขาย หากมี ฟิลด์นี้จะลบล้างฟิลด์ taxRateBasisPoints ที่เลิกใช้งานแล้ว ข้อความว่าง (เช่น taxRate { }) จะรีเซ็ตอัตราภาษีที่ใช้เป็น 0 |
payment |
ข้อจำกัดเกี่ยวกับวิธีการชำระเงินที่ผู้ขายรายนี้ยอมรับ เราจะถือว่าไม่มีข้อจำกัดหากไม่ได้ตั้งค่าช่องนี้ |
payment |
ตัวเลือกการชำระเงินที่ใช้ได้กับผู้ขายรายนี้ บริการภายใต้ผู้ขายรายนี้จะจำกัดตัวเลือกการชำระเงินที่อนุญาตแยกต่างหากได้ |
paymentProcessorConfig |
การกำหนดค่าสำหรับผู้ประมวลผลการชำระเงินด้วยโทเค็น หากผู้ขายรองรับ |
tokenization |
การกําหนดค่าสําหรับผู้ประมวลผลการชําระเงินด้วยโทเค็น หากผู้ขายรองรับ |
terms |
ข้อกำหนดและเงื่อนไขของผู้ขายที่แสดงต่อผู้ใช้เมื่อมีการจองบริการผ่าน "จองกับ Google" นอกเหนือจากนี้ ข้อกำหนดและเงื่อนไขของพาร์ทเนอร์ผู้รวบรวมข้อมูลจะแสดงต่อผู้ใช้เสมอและไม่ต้องระบุไว้ที่นี่ |
brand |
สตริงทึบแสงที่ระบุแบรนด์ที่แสดงต่อผู้บริโภคเพื่อใช้เมื่อแสดงการระบุแหล่งที่มาของพาร์ทเนอร์ ช่องนี้ช่วยให้พาร์ทเนอร์ที่มีแบรนด์ที่แสดงต่อผู้บริโภคหลายแบรนด์ระบุผู้ขายสำหรับทุกแบรนด์ภายในฟีดเดียวกันได้ แบรนด์ประกอบด้วยพร็อพเพอร์ตี้ที่แสดงต่อผู้บริโภค เช่น ชื่อ โลโก้ ข้อกำหนดในการให้บริการ และนโยบายความเป็นส่วนตัว หากมีแบรนด์พาร์ทเนอร์ที่แสดงต่อผู้บริโภคเพียงแบรนด์เดียว ก็ไม่จำเป็นต้องตั้งค่าช่องนี้และสามารถละเว้นได้ หากพาร์ทเนอร์... ไม่มีแบรนด์ที่แสดงต่อผู้บริโภคหลายแบรนด์ --> ละเว้นช่องนี้ มีการกำหนดค่าแบรนด์หลายรายการหรือไม่
หมายเหตุสำคัญ: พาร์ทเนอร์ส่วนใหญ่ไม่จําเป็นต้องตั้งค่าช่องนี้ หากพาร์ทเนอร์ต้องการใช้ช่องนี้ จะต้องติดต่อเราก่อนเพื่อกำหนดค่าแบรนด์แยกต่างหาก ซึ่งรวมถึงแบรนด์เริ่มต้น |
matching |
คำแนะนำที่จะช่วยให้ Google จับคู่ผู้ขายกับสถานที่ใน Google Maps ได้ หมายเหตุ: พาร์ทเนอร์ส่วนใหญ่ไม่จําเป็นต้องตั้งค่าช่องนี้ เนื่องจาก Google จะจับคู่ผู้ขายกับสถานที่ใน Google Maps โดยใช้ข้อมูลที่ระบุไว้ข้างต้น (ไม่บังคับ) |
service |
คำจำกัดความสำหรับแอตทริบิวต์บริการที่ใช้อธิบายบริการสำหรับผู้ขายรายนี้ (ไม่บังคับ) |
action |
ไม่บังคับ URL การดำเนินการที่มีภาษาที่เกี่ยวข้อง รายชื่อประเทศที่ถูกจํากัด ประเภท และแพลตฟอร์มที่ไม่บังคับซึ่งระบุแพลตฟอร์มที่ควรดําเนินการนี้ |
waitlist |
ไม่บังคับ คำแนะนำทั่วไปจากผู้ขายที่เฉพาะเจาะจงสำหรับผู้ใช้ที่เข้าร่วมคิวรอผ่าน "จองกับ Google" ช่องข้อความแต่ละช่องในคำแนะนำควรมีความยาวไม่เกิน 100 ไบต์ |
economic |
ไม่บังคับ ข้อมูลผู้ดําเนินการทางเศรษฐกิจที่เชื่อมโยงกับผู้ขายรายนี้ซึ่งจําเป็นสําหรับการปฏิบัติตามข้อกําหนด (ไม่บังคับ) |
PaymentRestrictions
ข้อจำกัดเกี่ยวกับวิธีการชำระเงินที่ผู้ขายรายนี้ยอมรับ
การแสดง JSON |
---|
{
"creditCardRestrictions": {
object ( |
ช่อง | |
---|---|
credit |
ข้อจำกัดเกี่ยวกับบัตรเครดิตที่ผู้ขายรายนี้ยอมรับ เราจะถือว่าระบบยอมรับบัตรเครดิตทั้งหมดหากไม่ได้ตั้งค่าช่องนี้ โปรดทราบว่ารายการบัตรที่ CreditCardType รองรับจะเพิ่มขึ้นเมื่อเวลาผ่านไป ซึ่งหมายความว่าการปล่อยค่านี้ว่างไว้จะทำให้การกำหนดค่ามีการเปลี่ยนแปลงในอนาคต |
CreditCardRestrictions
ข้อจำกัดเกี่ยวกับประเภทบัตรเครดิตที่ผู้ขายรายนี้ยอมรับ
การแสดง JSON |
---|
{
"creditCardType": [
enum ( |
ช่อง | |
---|---|
credit |
รายการบัตรเครดิตที่รองรับ ระบบจะไม่รองรับบัตรเครดิตหากช่องนี้ว่างเปล่า |
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 ( |
ช่อง | |
---|---|
payment |
รหัสนี้ใช้เพื่อระบุตัวเลือกการชำระเงินนี้ รหัสนี้เป็นรหัสสากลสำหรับผู้รวบรวมข้อมูลทั้งหมด และการใช้ค่าซ้ำกับผู้ขายหลายรายจะช่วยให้ผู้ใช้ชำระเงินด้วยตัวเลือกการชำระเงินที่เกี่ยวข้องกับผู้ขายเหล่านั้นได้ เมื่อใช้รหัสเดียวกันกับผู้ขายหลายรายซ้ำ อัปเดตค่าสำหรับตัวเลือกการชำระเงินภายใต้ผู้ขายรายหนึ่งจะเป็นการอัปเดตตัวเลือกการชำระเงินอื่นๆ ที่มีรหัสเดียวกันภายใต้ผู้ขายรายอื่นด้วย ดังนั้น แนวทางปฏิบัติแนะนำคือให้ตัวเลือกการชำระเงินทั้งหมดใช้รหัสเดียวกัน อัปเดตเป็นค่าเดียวกันเสมอ เพื่อหลีกเลี่ยงพฤติกรรมที่อาจเกิดขึ้น |
name |
ชื่อตัวเลือกการชําระเงิน ซึ่งผู้ใช้จะเห็น |
description |
คำอธิบายตัวเลือกการชำระเงิน ซึ่งผู้ใช้จะเห็น |
price |
ราคาของตัวเลือกการชําระเงิน |
tax |
อัตราภาษีสำหรับตัวเลือกการชำระเงินนี้ หากมี ช่องนี้จะลบล้างช่อง taxRate ที่มีอยู่ในผู้ขายหรือบริการ ข้อความว่าง (เช่น taxRate { }) จะรีเซ็ตอัตราภาษีที่ใช้เป็น 0 |
payment |
ประเภทของตัวเลือกการชําระเงินนี้ แบบใช้ครั้งเดียวสำหรับฟีเจอร์แบบแวะมาเล่น แบบใช้หลายครั้งสำหรับแพ็ก และแบบไม่จำกัดสำหรับการเป็นสมาชิก |
session |
จำนวนเซสชันที่ใช้ตัวเลือกการชำระเงินนี้ได้ ใช้ได้กับเซสชัน / แพ็กหลายรายการเท่านั้น โดยค่าควรมากกว่า 1 |
purchase |
คุณจะซื้อตัวเลือกการชำระเงินได้ภายในช่วงเวลานี้ |
valid |
ตัวเลือกการชำระเงินจะใช้ได้ภายในช่วงเวลานี้ (เช่น ราคาพิเศษสำหรับเดือนมกราคม 2017) หากมี ค่านี้จะลบล้าง validDuration และ activationType |
valid |
ระยะเวลาที่ตัวเลือกการชําระเงินใช้งานได้ (เช่น การเป็นสมาชิก 30 วัน) ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 9 หลัก โดยลงท้ายด้วย |
activation |
กำหนดวิธีกำหนดวันที่เริ่มต้นของตัวเลือกการชำระเงินนี้ |
user |
จำกัดผู้ใช้ที่มีสิทธิ์ซื้อตัวเลือกการชำระเงินนี้ ใช้เพื่อจำกัดตัวเลือกการชำระเงินโปรโมชันให้ผู้ใช้กลุ่มย่อยได้ หากไม่ได้ตั้งค่า ผู้ใช้ทุกคนจะมีสิทธิ์ |
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 } |
ช่อง | |
---|---|
new |
ตัวเลือกการชำระเงินที่ซื้อได้เฉพาะผู้ใช้ที่ไม่เคยซื้อจากผู้ขายรายเดียวกันมาก่อน |
new |
ตัวเลือกการชำระเงินที่ซื้อได้เฉพาะผู้ใช้ที่ไม่เคยซื้อตัวเลือกการชำระเงินเดียวกันมาก่อน |
PaymentProcessorConfig
การกําหนดค่าสําหรับผู้ประมวลผลการชําระเงิน ซึ่งตั้งค่าตามผู้ขาย
การแสดง JSON |
---|
{
"processor": enum ( |
ช่อง | |
---|---|
processor |
กำหนดพาร์ทเนอร์ผู้ประมวลผลการชำระเงินที่ใช้การกำหนดค่านี้ได้ |
public |
คีย์ที่ใช้ระบุผู้ขายรายนี้กับผู้ประมวลผลการชำระเงิน สำหรับ 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 ( |
ช่อง | |
---|---|
tokenization |
โดยปกติแล้วการกําหนดค่าการแยกข้อมูลรหัสจะมี tokenizationParameter 1 รายการที่มีคีย์เป็น "gateway" และค่าคือชื่อของโปรแกรมประมวลผล พารามิเตอร์ที่เหลือจะขึ้นอยู่กับตัวประมวลผล ดูข้อมูลเพิ่มเติมได้ในเอกสารประกอบของ Google Pay ตัวอย่าง Braintree: tokenizationParameter { key: "gateway" value: "braintree" } tokenizationParameter { key: "braintree:apiVersion" value: "v1" } tokenizationParameter { key: "braintree:sdkVersion" value: "2.30.0" } tokenizationParameter { key: "braintree:merchantId" value: "abcdef" } tokenizationParameter { key: "braintree:clientKey" value: "production_xxx_yyy" } ตัวอย่าง Stripe: tokenizationParameter { key: "gateway" value: "stripe" } tokenizationParameter { key: "stripe:version" value: "2018-02-28" } tokenizationParameter { key: "stripe:publishableKey" value: "pk_1234" } ตัวอย่าง Adyen: tokenizationParameter { key: "gateway" value: "adyen" } tokenizationParameter { key: "gatewayMerchantId" value: "yourId" } ออบเจ็กต์ที่มีรายการคู่ |
billing |
รวมข้อมูลการเรียกเก็บเงินของผู้ใช้ตามที่ป้อนใน Google Pay ไว้ในโทเค็นการชำระเงินพร้อมกับ FOP (ดูด้านบน) การเว้นช่องว่างไว้จะเทียบเท่ากับการระบุ 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 ด้านล่างสำหรับการผสานรวมใหม่ |
localized |
ข้อความที่แปลแล้วซึ่งจะแสดงต่อผู้ใช้ |
MerchantMatchingHints
คำแนะนำที่ใช้ในการช่วยให้ Google จับคู่ผู้ขายกับสถานที่ใน Google Maps
การแสดง JSON |
---|
{ "placeId": string } |
ช่อง | |
---|---|
place |
รหัสสถานที่สำหรับสถานที่ในฐานข้อมูล Google Places และใน Google Maps ดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่ได้ที่ https://developers.google.com/places/web-service/place-id |
ServiceAttribute
แอตทริบิวต์บริการคือหมวดหมู่ที่พาร์ทเนอร์กำหนดซึ่งอธิบายบริการสำหรับผู้ขาย ตัวอย่างเช่น ธนาคารอาจกำหนดแอตทริบิวต์บริการ "ประเภทบัญชี" ที่มีค่าที่เป็นไปได้เป็น "ส่วนบุคคล" และ "ธุรกิจ" ส่วนร้านทำผมอาจกำหนดแอตทริบิวต์บริการ "ประเภทบริการ" ที่มีค่าที่เป็นไปได้เป็น "ตัดผม" "ทำสี" และ "จัดทรง"
การแสดง JSON |
---|
{
"attributeId": string,
"attributeName": string,
"value": [
{
object ( |
ช่อง | |
---|---|
attribute |
ตัวระบุที่ระบุแอตทริบิวต์บริการนี้โดยไม่ซ้ำกับแอตทริบิวต์อื่นๆ สำหรับผู้ขายรายเดียวกัน เช่น "account-type" |
attribute |
ชื่อที่ผู้ใช้มองเห็นได้สําหรับแอตทริบิวต์นี้ เช่น "ประเภทบัญชี" |
value[] |
ค่าที่เป็นไปได้ทั้งหมดสำหรับแอตทริบิวต์บริการนี้ |
ค่า
แสดงค่าที่เป็นไปได้สำหรับแอตทริบิวต์บริการหนึ่งๆ
การแสดง JSON |
---|
{ "valueId": string, "valueName": string } |
ช่อง | |
---|---|
value |
ตัวระบุที่ระบุค่านี้โดยไม่ซ้ำกับค่าอื่นๆ สำหรับแอตทริบิวต์บริการนี้ เช่น "personal" |
value |
ชื่อที่ผู้ใช้มองเห็นสำหรับค่า เช่น "ส่วนตัว" |
คำแนะนำ
คําแนะนําที่แสดงต่อผู้ใช้เมื่อจองผ่าน "จองกับ Google"
การแสดง JSON |
---|
{
"text": {
object ( |
ช่อง | |
---|---|
text |
ข้อความที่กำหนดเองที่จะแสดงต่อผู้ใช้เมื่อจองผ่าน "จองกับ Google" |
EconomicOperator
ข้อมูลผู้ดําเนินการทางเศรษฐกิจสําหรับผู้รวบรวมข้อมูล
การแสดง JSON |
---|
{
"text": {
object ( |
ช่อง | |
---|---|
text |
ต้องระบุ ชื่อ ที่อยู่ หมายเลขโทรศัพท์ และอีเมลของผู้ดําเนินการทางเศรษฐกิจ ซึ่งหมายถึงผู้ผลิต ตัวแทนที่ได้รับอนุญาต ผู้นําเข้า ผู้จัดจําหน่าย ผู้ให้บริการดําเนินการตามคำสั่งซื้อ หรือบุคคลธรรมดาหรือนิติบุคคลอื่นๆ ที่ต้องปฏิบัติตามภาระหน้าที่ที่เกี่ยวข้องกับการผลิตผลิตภัณฑ์ การจัดจําหน่าย หรือการใช้งานผลิตภัณฑ์ การนําเสนอสตริงรูปแบบอิสระของ economicOperator ข้อมูลนี้อาจอยู่ในรูปแบบ " " และ "\n" |
เมธอด |
|
---|---|
|
สร้าง Merchant ใหม่ซึ่งจัดการโดยผู้รวบรวมข้อมูลที่คุณระบุ แล้วแสดงผล |
|
ลบ Merchant ที่มีอยู่ซึ่งจัดการโดยผู้รวบรวมข้อมูลที่ระบุ |
|
รับ MerchantStatus ของ Merchant |
|
อัปเดต Merchant ที่มีอยู่ซึ่งจัดการโดยผู้รวบรวมข้อมูลที่ระบุ และแสดงผล |