- משאב: מוכר
- 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. המידע הזה לא יוצג. שם המוכר. |
telephone |
מספר הטלפון הציבורי של המוכר, כולל קידומת המדינה והאזור שלו. למשל: +14567891234. |
url |
כתובת האתר הציבורי של המוכר. |
geo |
הפרטים הגיאוגרפיים של המוכר, כולל קו רוחב, קו אורך וכתובת. |
category |
הקטגוריה של העסק בפלטפורמת האגרגטור. |
numBookings30d |
השדה הזה הוצא משימוש. |
taxRateBasisPoints |
שיעור המס של המוכר בנקודות בסיס (מאה אחוז אחד). לדוגמה, אם שיעור המס הוא 7.5%, צריך להגדיר את השדה הזה כ-750. אם השדה הזה לא מוגדר או מוגדר ל-0, המחיר הכולל שבו המשתמש יחייב את המשתמש עבור כל שירות שסופק על ידי המוכר הזה יהיה המחיר המדויק שצוין על ידי Service.price. ההנחה היא שמחיר השירות פטור מהמיסים הרלוונטיים או כולל כבר אותם. המיסים לא יוצגו למשתמש כפריט נפרד. אם השדה הזה מוגדר לערך שאינו אפס, המחיר הכולל שיחויב מהמשתמש עבור כל שירות שסופק על ידי המוכר הזה יכלול את מחיר השירות ואת המס המשוער לפי שיעור המס שצוין כאן. שברים של יחידת המטבע הקטנה ביותר (למשל שברים של סנט אחד) יעוגלו באמצעות עיגול זוגי הקרוב ביותר. המיסים יוצגו למשתמש כפריט נפרד. השדה הזה הוצא משימוש. במקומו יש להשתמש ב-taxRate. |
taxRate |
שיעור המס של המוכר. אם השדה הזה קיים, הוא מבטל את השדה taxRateBasisPoints שהוצא משימוש. הודעה ריקה (כלומר TaxRate { }) תאפס את שיעור המס שהוחל לאפס. |
paymentRestrictions |
הגבלות על אמצעי התשלום שהמוכר הזה מקבל. נניח שאין הגבלות אם השדה הזה לא מוגדר. |
paymentOption[] |
אפשרויות התשלום הזמינות למוכר הזה. השירותים של המוכר הזה יוכלו להגביל בנפרד את אפשרויות התשלום שהם מאפשרים. |
paymentProcessorConfig |
הגדרה של ספק תשלומים שעבר המרה לאסימונים, אם למוכר יש תמיכה באפשרות הזו. |
tokenizationConfig |
הגדרה של ספק תשלומים שעבר המרה לאסימונים, אם למוכר יש תמיכה באפשרות הזו. |
terms |
התנאים וההגבלות של המוכר הספציפי, שמוצגים למשתמש בזמן הזמנה של שירות דרך 'Google הזמנת מקומות' בנוסף לתנאים האלה, התנאים וההגבלות של שותף האגרגטור מוצגים תמיד למשתמש, ואין להציג אותם כאן. |
brandId |
מחרוזת אטומה שמזהה את המותג המוצג לצרכנים שאפשר להשתמש בו להצגת שיוך לשותפים. השדה הזה מאפשר לשותפים עם כמה מותגים שפונים לצרכנים לספק למוכרים את כל המותגים באותו פיד. מותג מורכב מנכסים שמיועדים לצרכנים כמו השם, הלוגו, התנאים וההגבלות ומדיניות הפרטיות. אם יש רק מותג אחד של שותף שפונה לצרכנים, אין צורך להגדיר את השדה הזה ואפשר להתעלם ממנו. אם השותף... אין לכם כמה מותגים שפונים לצרכנים? --> התעלמות משדה זה יש כמה מותגים שהוגדרו?
הערה חשובה: רוב השותפים לא צריכים להגדיר את השדה הזה. שותפים שרוצים להשתמש בשדה הזה צריכים לפנות אלינו כדי להגדיר מותגים נפרדים, כולל מותג ברירת המחדל. |
matchingHints |
רמזים שיעזרו ל-Google להתאים בין מוכר למקום במפות Google. הערה: רוב השותפים לא צריכים להגדיר את השדה הזה, כי Google תתאים סוחרים למקומות במפות Google לפי המידע שמפורט למעלה. (אופציונלי) |
serviceAttribute[] |
הגדרות של מאפייני שירות שמשמשים לתיאור השירותים של המוכר הזה. (אופציונלי) |
actionLink[] |
אפשרות. כתובת URL של פעולה עם שפה משויכת, רשימת מדינות שמוגבלות לסוג, סוג ופלטפורמה אופציונלית שמציינת באיזו פלטפורמה יש לבצע את הפעולה הזו. |
waitlistAdvisement |
אפשרות. עצות כלליות ממוכר ספציפי למשתמש שמצטרף לרשימת המתנה דרך 'Google הזמנת מקומות'. שדות טקסט נפרדים בהמלצה צריכים להיות מוגבלים ל-100 בייטים. |
PaymentRestrictions
הגבלות על אמצעי התשלום שהמוכר הזה מקבל.
ייצוג JSON |
---|
{
"creditCardRestrictions": {
object ( |
שדות | |
---|---|
creditCardRestrictions |
הגבלות על כרטיסי האשראי שהמוכר הזה מכבד. נניח שכל כרטיסי האשראי מתקבלים אם השדה הזה לא מוגדר. לתשומת ליבכם: רשימת הכרטיסים שנתמכים ב-CreditCardType תגדל עם הזמן, ומשמעות הדבר היא שרשימת הכרטיסים תישאר ריקה לשינויים עתידיים. |
CreditCardRestrictions
הגבלות על סוגי כרטיסי האשראי שהמוכר הזה מקבל.
ייצוג JSON |
---|
{
"creditCardType": [
enum ( |
שדות | |
---|---|
creditCardType[] |
רשימה של כרטיסי אשראי נתמכים. אין תמיכה בכרטיסי אשראי אם השדה ריק. |
CreditCardType
סוג של כרטיס אשראי.
טיפוסים בני מנייה (enums) | |
---|---|
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 (שיעור המס) שמופיע ב-Merchant או בשירות. הודעה ריקה (כלומר TaxRate { }) תאפס את שיעור המס שהוחל לאפס. |
paymentOptionType |
הסוג של אפשרות תשלום זו. שימוש חד-פעמי לשירותים, לשימוש חוזר בחבילות ולמינויים ללא הגבלה. |
sessionCount |
לכמה ביקורים אפשר להשתמש באפשרות התשלום הזו. תקף רק לחבילות / סשנים מרובים, כאשר הערך צריך להיות גדול מ-1. |
purchaseInterval |
ניתן לרכוש את אפשרות התשלום בתוך פרק זמן זה. |
validInterval |
ניתן להשתמש באפשרות התשלום בטווח הזה (למשל, מחיר מיוחד לינואר 2017). אם השדה הזה קיים, הוא מבטל את valueDuration ו-ActivateType. |
validDuration |
משך התוקף של אפשרות התשלום (למשל, חברות ל-30 יום). משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, המסתיים ב-' |
activationType |
הגדרה של האופן שבו נקבע תאריך ההתחלה של התוקף עבור אפשרות התשלום הזו. |
userRestriction |
הגבלת המשתמשים שזכאים לרכוש את אפשרות התשלום הזו. יכול לשמש להגבלת אפשרות תשלום של קידום מכירות לקבוצת משנה של משתמשים. אם היא לא מוגדרת, כל המשתמשים יוכלו להשתתף. |
PaymentOptionType
סוג של אפשרות תשלום.
טיפוסים בני מנייה (enums) | |
---|---|
PAYMENT_OPTION_TYPE_UNSPECIFIED |
לא בשימוש. |
PAYMENT_OPTION_SINGLE_USE |
ניתן להשתמש באפשרות התשלום רק פעם אחת. |
PAYMENT_OPTION_MULTI_USE |
ניתן להשתמש באפשרות התשלום אם מספר הסשנים שלה גדול מ-0. |
PAYMENT_OPTION_UNLIMITED |
ניתן להשתמש באפשרות התשלום בטווח הזמן החוקי שלה – מספר הסשנים לא רלוונטי. |
ActivationType
הגדרה של האופן שבו נקבע תאריך ההתחלה של התוקף.
טיפוסים בני מנייה (enums) | |
---|---|
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 שנשלחה אל החברה לעיבוד תשלומים, יחד עם בקשות לתשלום. |
מעבד
הגדרת שותף ספציפי לעיבוד תשלומים.
טיפוסים בני מנייה (enums) | |
---|---|
PROCESSOR_UNSPECIFIED |
לא בשימוש |
PROCESSOR_STRIPE |
הגדרת תשלומים באמצעות Stripe. |
PROCESSOR_BRAINTREE |
הגדרת תשלומים באמצעות Braintree. |
TokenizationConfig
הגדרה אישית לאסימונים של מעבד התשלומים, ומוגדרת לכל מוכר.
ייצוג JSON |
---|
{
"tokenizationParameter": {
string: string,
...
},
"billingInformationFormat": enum ( |
שדות | |
---|---|
tokenizationParameter |
בהגדרת אסימונים בדרך כלל יהיה פרמטר TokenizationParameter אחד שהמפתח שלו הוא "gateway" והערך שלו הוא שם המעבד. שאר הפרמטרים תלויים במעבד. מידע נוסף זמין במסמכים של Google Pay. דוגמה ל-braintree:TokenizationParameter { key: "gateway" value: "braintree" } TokenizationParameter { key: "braintree:apiVersion" value: "v1" } TokenizationParameter { key: "braintree:sdkVersion" value: "2.30.0" }Tokenization { key: "braintreeization:merchant key:"braintree: דוגמה ל-Stripe: TokenizationParameter { key: "gateway" value: "stripe" } TokenizationParameter { key: "stripe:version" value: "2018-02-28" } To018-02-28" }TokenizationParameter { key: "stripe:publishableKey" value: "pk_1234" } דוגמה ל-Adyen: TokenizationParameter { key: "gateway" value: "adyen" } assetizationParameter { key: "gatewayMerchantId" value: "yourId" } אובייקט שמכיל רשימה של |
billingInformationFormat |
יש לכלול באסימון התשלום את נתוני החיוב של המשתמש כפי שהוזנו ב-Google Pay עם אמצעי התשלום שלו (ראו למעלה). השארת השדה ריק זהה לציון MIN. |
BillingInformationFormat
איזה ערך של 'כתובת לחיוב' לדרוש מהמשתמש ולכלול באסימון. ערכי ה-enum תואמים לפרמטרים ב-Google Pay API (מידע נוסף זמין בכתובת https://developers.google.com/pay/api/web/reference/object#BillingAddressParameters).
טיפוסים בני מנייה (enums) | |
---|---|
BILLING_INFORMATION_FORMAT_UNSPECIFIED |
לא צוין. ברירת המחדל היא MIN. |
MIN |
שם, קוד מדינה ומיקוד (הגדרת ברירת המחדל של Google Pay). |
FULL |
שם, רחוב, רשות מוניציפאלית, אזור, קוד מדינה ומיקוד. |
מונחים
קבוצת כללים והנחיות שמוצגים למשתמש לצורך ביצוע הזמנה דרך 'Google הזמנת מקומות'.
ייצוג JSON |
---|
{
"url": string,
"text": string,
"localizedText": {
object ( |
שדות | |
---|---|
url |
לחלופין, כתובת האתר של התנאים וההגבלות. |
text |
הטקסט שיוצג למשתמש. יש להשתמש ב-localizedText שבהמשך כדי ליצור שילובים חדשים. |
localizedText |
הטקסט המותאם לשוק המקומי שיוצג למשתמש. |
MerchantMatchingHints
רמזים שעוזרים ל-Google להתאים בין מוכר למקום במפות Google.
ייצוג JSON |
---|
{ "placeId": string } |
שדות | |
---|---|
placeId |
מזהה המקום של מקום מסוים במסד הנתונים של מקומות Google ובמפות Google. מידע נוסף על מזהי מקומות זמין בכתובת https://developers.google.com/places/web-service/place-id. |
ServiceAttribute
מאפייני שירות הם קטגוריות שהוגדרו על ידי שותפים, שמתארות את השירותים שהמוכר מקבל. לדוגמה, בנק עשוי להגדיר מאפיין שירות מסוג 'סוג חשבון' עם ערכים אפשריים של 'אישי' ו'עסקי', ואילו מספרה יכולה להגדיר מאפיין שירות 'סוג שירות' עם הערכים האפשריים 'תספורת', 'צבע' ו'סגנון'.
ייצוג JSON |
---|
{
"attributeId": string,
"attributeName": string,
"value": [
{
object ( |
שדות | |
---|---|
attributeId |
מזהה שמזהה באופן ייחודי את מאפיין השירות הזה בין היתר עבור אותו מוכר, למשל 'סוג חשבון'. |
attributeName |
שם שגלוי למשתמש עבור המאפיין הזה, למשל "סוג חשבון". |
value[] |
כל הערכים האפשריים למאפיין השירות הזה. |
Value
מייצג ערך אפשרי למאפיין שירות מסוים.
ייצוג JSON |
---|
{ "valueId": string, "valueName": string } |
שדות | |
---|---|
valueId |
מזהה שמזהה את הערך הזה באופן ייחודי בין היתר עבור מאפיין השירות הזה. למשל, 'personal'. |
valueName |
שם של הערך שגלוי למשתמש, למשל "אישי". |
ייעוץ
הודעות שמוצגות למשתמש כשמבצעים הזמנה דרך 'Google הזמנת מקומות'.
ייצוג JSON |
---|
{
"text": {
object ( |
שדות | |
---|---|
text |
הודעה מותאמת אישית שתוצג למשתמש כשמבצעים הזמנה דרך 'Google הזמנת מקומות'. |
שיטות |
|
---|---|
|
הפונקציה יוצרת Merchant חדש שמנוהל על ידי אתר האגרגטור שצוין ומחזירה אותו. |
|
מחיקת נכס Merchant קיים שמנוהל על ידי אתר האגרגטור שצוין. |
|
קבלת MerchantStatus של Merchant . |
|
עדכון Merchant קיים שמנוהל על ידי אתר האגרגטור שצוין ומחזיר אותו. |