REST Resource: inventory.partners.merchants

{
  "name": string,
  "merchantName": string,
  "telephone": string,
  "url": string,
  "geo": {
    object (GeoCoordinates)
  },
  "category": string,
  "numBookings30d": string,
  "taxRateBasisPoints": integer,
  "taxRate": {
    object (TaxRate)
  },
  "paymentRestrictions": {
    object (PaymentRestrictions)
  },
  "paymentOption": [
    {
      object (PaymentOption)
    }
  ],
  "paymentProcessorConfig": {
    object (PaymentProcessorConfig)
  },
  "tokenizationConfig": {
    object (TokenizationConfig)
  },
  "terms": {
    object (Terms)
  },
  "brandId": string,
  "matchingHints": {
    object (MerchantMatchingHints)
  },
  "serviceAttribute": [
    {
      object (ServiceAttribute)
    }
  ],
  "actionLink": [
    {
      object (ActionLink)
    }
  ],
  "waitlistAdvisement": {
    object (Advisement)
  },
  "economicOperator": {
    object (EconomicOperator)
  }
}

string

שם המשאב של המוֹכר, בפורמט partners/{partner_id}/merchants/{merchantId}.

string

השדות merchantName, ‏ telephone, ‏ url ו-geo משמשים לצורך התאמת מלאי שטחי הפרסום של שותפים למוכרים שכבר מופיעים במפות Google. המידע הזה לא יוצג.

שם המוֹכר.

string

מספר הטלפון הציבורי של המוכר, כולל קידומת המדינה וקידומת האזור, למשל ‎+14567891234.

string

כתובת ה-URL של האתר הציבורי של המוֹכר.

object (GeoCoordinates)

המידע הגיאוגרפי של המוֹכר, כולל קו הרוחב, קו האורך והכתובת.

string

הקטגוריה של העסק בפלטפורמה של המאגר.

string (int64 format)

השדה הזה הוצא משימוש.

integer (uint32 format)

שיעור המס של המוכר בנקודות בסיס (100 אלפית האחוז). לדוגמה, אם שיעור המס הוא 7.5%, צריך להגדיר את השדה הזה לערך 750.

אם השדה הזה לא מוגדר או מוגדר כ-0, המחיר הכולל שנגבה מהמשתמש על כל שירות שמסופק על ידי המוכר הזה הוא המחיר המדויק שצוין ב-Service.price. ההנחה היא שמחיר השירות פטור ממיסים רלוונטיים או שכבר כולל אותם. המיסים לא יוצגו למשתמש כפריט נפרד.

אם השדה הזה מוגדר לערך שאינו אפס, המחיר הכולל שבו המשתמש מחויב על כל שירות שמסופק על ידי המוכר הזה יכלול את מחיר השירות בתוספת המס שחושב לפי שיעור המס שצוין כאן. שבר של יחידת המטבע הקטנה ביותר (לדוגמה, שבר של סנט אחד) יעוגל לפי השבר השלם הקרוב ביותר. המיסים יוצגו למשתמש כפריט נפרד.

השדה הזה הוצא משימוש. במקום זאת, יש להשתמש בשדה taxRate.

object (TaxRate)

שיעור המס של המוכר. אם השדה הזה קיים, הוא משנה את השדה taxRateBasisPoints שהוצא משימוש. הודעת ריק (כלומר taxRate { }) תאפס את שיעור המס שהוחל לאפס.

object (PaymentRestrictions)

הגבלות על אמצעי התשלום שהמוכר הזה מקבל. אם השדה הזה לא מוגדר, אנחנו מניחים שאין הגבלות.

object (PaymentOption)

אפשרויות התשלום הזמינות אצל המוכר הזה. שירותים שמנוהלים על ידי המוכר הזה יוכלו להגביל בנפרד את אפשרויות התשלום שהם מאפשרים.

object (PaymentProcessorConfig)

הגדרה של מעבד תשלומים המבוסס על אסימונים, אם יש למוכרים תמיכה בכך.

object (TokenizationConfig)

הגדרה של מעבד תשלומים שמשתמש באסימונים, אם יש למוכרים תמיכה בכך.

object (Terms)

התנאים וההגבלות של המוֹכר הספציפי שמוצגים למשתמש כשמזמינים שירות דרך Google הזמנת מקומות. בנוסף, התנאים וההגבלות של שותף ה-Aggregator תמיד מוצגים למשתמש ואסור לספק אותם כאן.

string

מחרוזת אטומה שמזהה את המותג שמוצג לצרכנים, שתשמש להצגת שיוך לשותף. השדה הזה מאפשר לשותפים שיש להם כמה מותגים שמוצגים לצרכנים לספק מוכרים לכל המותגים באותו פיד.

מותג מורכב ממאפיינים שגלויים לצרכנים, כמו השם, הלוגו, התנאים וההגבלות ומדיניות הפרטיות.

אם יש רק מותג שותף אחד שמוצג לצרכנים, אין צורך להגדיר את השדה הזה וניתן להתעלם ממנו.

אם השותף…

אין לכם כמה מותגים שמיועדים לצרכנים? --> התעלמות מהשדה הזה

האם יש כמה מותגים שהוגדרו?

  If this field is set
    --> Associated consumer-facing brand attribution is used

  If this field is unset or the empty string
    --> Default consumer-facing brand attribution is used

הערה חשובה: רוב השותפים לא צריכים להגדיר את השדה הזה. אם שותף רוצה להשתמש בשדה הזה, הוא צריך ליצור איתנו קשר קודם כדי להגדיר מותגים נפרדים, כולל מותג ברירת המחדל.

object (MerchantMatchingHints)

רמזים שיעזרו ל-Google להתאים בין מוכר למקום במפות Google. הערה: רוב השותפים לא צריכים להגדיר את השדה הזה, כי Google תתאים בין המוכרים למקומות במפות Google על סמך המידע שצוין למעלה. (אופציונלי)

object (ServiceAttribute)

הגדרות של מאפייני השירות המשמשים לתיאור השירותים של המוכר הזה. (אופציונלי)

object (ActionLink)

זה שינוי אופציונלי. כתובת URL של פעולה עם השפה המשויכת, רשימת המדינות המוגבלות, הסוג והפלטפורמה האופציונלית שמציינת באיזו פלטפורמה צריך לבצע את הפעולה הזו.

object (Advisement)

זה שינוי אופציונלי. המלצות כלליות של מוכר ספציפי למשתמש שמצטרף לרשימת המתנה דרך 'Google הזמנת מקומות'. אורך שדות הטקסט הנפרדים בהודעה צריך להיות מוגבל ל-100 בייטים.

object (EconomicOperator)

זה שינוי אופציונלי. פרטי המפעיל הכלכלי המשויכים למוכ"ז הספציפי הזה, שנדרשים לציות לתקנות. (אופציונלי)

{
  "creditCardRestrictions": {
    object (CreditCardRestrictions)
  }
}

object (CreditCardRestrictions)

הגבלות על כרטיסי האשראי שהמוכר הזה מקבל. אם השדה הזה לא מוגדר, נניח שכל כרטיסי האשראי מתקבלים. חשוב לזכור שרשימת הכרטיסים שנתמכים על ידי CreditCardType תגדל עם הזמן, כך שהשארת השדה הזה ריק עלולה לגרום לשינויים בהגדרה בעתיד.

{
  "creditCardType": [
    enum (CreditCardType)
  ]
}

enum (CreditCardType)

רשימה של כרטיסי אשראי נתמכים. אין תמיכה בכרטיסי אשראי ריקים.

{
  "paymentOptionId": string,
  "name": string,
  "description": string,
  "price": {
    object (Price)
  },
  "taxRate": {
    object (TaxRate)
  },
  "paymentOptionType": enum (PaymentOptionType),
  "sessionCount": string,
  "purchaseInterval": {
    object (TimeRange)
  },
  "validInterval": {
    object (TimeRange)
  },
  "validDuration": string,
  "activationType": enum (ActivationType),
  "userRestriction": {
    object (UserPurchaseRestriction)
  }
}

string

המזהה הזה משמש לזיהוי אפשרות התשלום הזו.

המזהה הזה הוא גלובלי לכל המאגר, ושימוש חוזר בערך במספר מוכרים יאפשר למשתמש לשלם באמצעות אפשרות התשלום המתאימה אצל המוכרים האלה.

כשמשתמשים שוב במזהה בכמה מוכרים, עדכון של ערך כלשהו של אפשרות תשלום אצל מוכר אחד יעדכן גם כל אפשרות תשלום אחרת עם אותו מזהה, אצל מוכר אחר. לכן, מומלץ להשתמש באותו מזהה לכל אפשרויות התשלום, ולעדכן אותן תמיד לערכים זהים, כדי למנוע התנהגות זדונית.

string

השם של אפשרות התשלום. המשתמש יכול לראות את השם הזה.

string

תיאור של אפשרות התשלום. המשתמש יכול לראות את השם הזה.

object (Price)

המחיר של אפשרות התשלום.

object (TaxRate)

שיעור המס של אפשרות התשלום הזו. אם השדה הזה קיים, הוא משנה את הערך של השדה taxRate שמופיע אצל המוכר או השירות. הודעת ריק (כלומר taxRate { }) תאפס את שיעור המס שהוחל לאפס.

enum (PaymentOptionType)

הסוג של אפשרות התשלום הזו. לשימוש חד-פעמי עבור אירועים חד-פעמיים, לשימוש רב-פעמי עבור חבילות ושימוש בלתי מוגבל למינויים.

string (int64 format)

מספר הסשנים שבהם אפשר להשתמש באפשרות התשלום הזו. הערך תקף רק למארזים או לסשנים מרובים, שבהם הערך צריך להיות גדול מ-1.

object (TimeRange)

אפשר לרכוש את אפשרות התשלום במהלך התקופה הזו.

object (TimeRange)

אפשר להשתמש באפשרות התשלום במהלך התקופה הזו (למשל, מחיר מיוחד לינואר 2017). אם הפרמטר הזה קיים, הוא משנה את הערכים של validDuration ו-activationType.

string (Duration format)

משך התוקף של אפשרות התשלום (למשל, מינוי ל-30 יום).

משך הזמן בשניות, עם עד תשע ספרות עשרוניות, שמסתיימים ב-'s'. דוגמה: "3.5s".

enum (ActivationType)

הגדרה של האופן שבו נקבע תאריך תחילת התוקף של אפשרות התשלום הזו.

object (UserPurchaseRestriction)

הגבלת המשתמשים שיכולים לרכוש את אפשרות התשלום הזו. אפשר להשתמש בה כדי להגביל אפשרות תשלום במסגרת קידום מכירות לקבוצת משנה של משתמשים. אם לא תגדירו את המדיניות, כל המשתמשים יהיו זכאים.

{
  "newToMerchant": boolean,
  "newToPaymentOption": boolean
}

boolean

אפשרות תשלום שרק משתמשים שמעולם לא רכשו מאותו מוכר יכולים לרכוש.

boolean

אפשרות תשלום שרק משתמשים שלא רכשו בעבר את אותה אפשרות תשלום יכולים לרכוש.

{
  "processor": enum (Processor),
  "publicKey": string,
  "version": string
}

enum (Processor)

מגדיר את שותף מעבד התשלומים שאליו חלה ההגדרה הזו.

string

המפתח שמשמש לזיהוי המוכר הזה אצל חברת עיבוד התשלומים.

ל-Stripe: https://stripe.com/docs/dashboard#api-keys. ל-Braintree: https://articles.braintreepayments.com/control-panel/important-gateway-credentials

string

מספר גרסת ה-API שנשלח לחברת עיבוד התשלומים יחד עם בקשות התשלום.

{
  "tokenizationParameter": {
    string: string,
    ...
  },
  "billingInformationFormat": enum (BillingInformationFormat)
}

map (key: string, value: string)

בדרך כלל, תצורת יצירת אסימונים תכלול פרמטר אחד של יצירת אסימונים (tokenizationParameter) שהמפתח שלו הוא 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" }

אובייקט שמכיל רשימה של זוגות "key": value. דוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

enum (BillingInformationFormat)

צריך לכלול באסימון התשלום את פרטי החיוב של המשתמש כפי שהוזנו ב-Google Pay באמצעות FOP (ראו למעלה). השארת השדה ריק זהה לציון MIN.

{
  "url": string,
  "text": string,
  "localizedText": {
    object (Text)
  }
}

string

אם רוצים, כתובת ה-URL של התנאים וההגבלות.

string

הטקסט שיוצג למשתמש. משתמשים ב-localizedText שבהמשך בשילובים חדשים.

object (Text)

הטקסט המותאם לשוק המקומי שיוצג למשתמש.

{
  "placeId": string
}

string

מזהה המקום של מקום במסד הנתונים של מקומות Google ובמפות Google. מידע נוסף על מזהי מיקומים זמין בכתובת https://developers.google.com/places/web-service/place-id.

{
  "attributeId": string,
  "attributeName": string,
  "value": [
    {
      object (Value)
    }
  ]
}

string

מזהה שמזהה באופן ייחודי את מאפיין השירות הזה בין שאר המאפיינים של אותו מוכר, למשל 'account-type'.

string

שם שגלוי למשתמש למאפיין הזה, למשל 'סוג חשבון'.

object (Value)

כל הערכים האפשריים למאפיין השירות הזה.

{
  "valueId": string,
  "valueName": string
}

string

מזהה שמזהה באופן ייחודי את הערך הזה מבין ערכים אחרים של מאפיין השירות הזה, למשל 'אישי'.

string

שם הערך שגלוי למשתמשים, למשל 'אישי'.

{
  "text": {
    object (Text)
  }
}

object (Text)

הודעה מותאמת אישית שתוצג למשתמש כשיבצע הזמנה דרך 'Google הזמנת מקומות'.

{
  "text": {
    object (Text)
  }
}

object (Text)

חובה. השם, הכתובת, מספר הטלפון וכתובת האימייל של המפעיל הכלכלי, המוגדר כמייצר, הנציג המורשה, היבואן, המפיץ, ספק שירותי המילוי או כל אדם טבעי או משפטי אחר שכפוף לחובות שקשורות לייצור מוצרים, להפצתם או להפעלתם. ייצוג של economicOperator במחרוזת בפורמט חופשי. אפשר לעצב את המידע הזה באמצעות " " ו-"\n".