REST Resource: inventory.partners.merchants

משאב: מוכר

מידע על מוכר בפלטפורמה של אתר האגרגטור.

ייצוג JSON 
{
  "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)
  }
}
שדות
name

string

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

string

הערכים ב-MerchantName, במספר הטלפון, בכתובת ה-URL ובאזור הגיאוגרפי משמשים לתמיכה בהתאמת מלאי השותפים מול מוכרים שכבר קיימים במפות Google. המידע הזה לא יוצג.

שם המוכר.
telephone

string

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

string

כתובת האתר הציבורי של המוכר.
geo

object (GeoCoordinates)

הפרטים הגיאוגרפיים של המוכר, כולל קו רוחב, קו אורך וכתובת.
category

string

הקטגוריה של העסק בפלטפורמת האגרגטור.
numBookings30d
(deprecated)

string (int64 format)

השדה הזה הוצא משימוש.
taxRateBasisPoints
(deprecated)

integer (uint32 format)

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

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

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

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

object (TaxRate)

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

object (PaymentRestrictions)

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

object (PaymentOption)

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

object (PaymentProcessorConfig)

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

object (TokenizationConfig)

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

object (Terms)

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

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

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

object (MerchantMatchingHints)

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

object (ServiceAttribute)

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

object (Advisement)

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

PaymentRestrictions

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

ייצוג JSON 
{
  "creditCardRestrictions": {
    object (CreditCardRestrictions)
  }
}
שדות
creditCardRestrictions

object (CreditCardRestrictions)

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

CreditCardRestrictions

הגבלות על סוגי כרטיסי האשראי שהמוכר הזה מקבל.

ייצוג JSON 
{
  "creditCardType": [
    enum (CreditCardType)
  ]
}
שדות
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 (Price)
  },
  "taxRate": {
    object (TaxRate)
  },
  "paymentOptionType": enum (PaymentOptionType),
  "sessionCount": string,
  "purchaseInterval": {
    object (TimeRange)
  },
  "validInterval": {
    object (TimeRange)
  },
  "validDuration": string,
  "activationType": enum (ActivationType),
  "userRestriction": {
    object (UserPurchaseRestriction)
  }
}
שדות
paymentOptionId

string

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

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

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

string

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

string

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

object (Price)

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

object (TaxRate)

שיעור המס לאפשרות התשלום הזו. אם השדה הזה קיים, השדה הזה יבטל את השדה taxRate (שיעור המס) שמופיע ב-Merchant או בשירות. הודעה ריקה (כלומר TaxRate { }) תאפס את שיעור המס שהוחל לאפס.
paymentOptionType

enum (PaymentOptionType)

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

string (int64 format)

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

object (TimeRange)

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

object (TimeRange)

ניתן להשתמש באפשרות התשלום בטווח הזה (למשל, מחיר מיוחד לינואר 2017). אם השדה הזה קיים, הוא מבטל את valueDuration ו-ActivateType.
validDuration

string (Duration format)

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

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

enum (ActivationType)

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

object (UserPurchaseRestriction)

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

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

boolean

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

boolean

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

PaymentProcessorConfig

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

ייצוג JSON 
{
  "processor": enum (Processor),
  "publicKey": string,
  "version": string
}
שדות
processor

enum (Processor)

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

string

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

אם מדובר ב-Stripe, תוכלו לעיין במאמר הבא: https://stripe.com/docs/dashboard#api-keys לגבי Braintree: https://articles.braintreepayments.com/control-panel/important-gateway-credentials
version

string

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

מעבד

הגדרת שותף ספציפי לעיבוד תשלומים.

טיפוסים בני מנייה (enums)
PROCESSOR_UNSPECIFIED לא בשימוש
PROCESSOR_STRIPE הגדרת תשלומים באמצעות Stripe.
PROCESSOR_BRAINTREE הגדרת תשלומים באמצעות Braintree.

TokenizationConfig

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

ייצוג JSON 
{
  "tokenizationParameter": {
    string: string,
    ...
  },
  "billingInformationFormat": enum (BillingInformationFormat)
}
שדות
tokenizationParameter

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" }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" }

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

enum (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 (Text)
  }
}
שדות
url

string

לחלופין, כתובת האתר של התנאים וההגבלות.
text

string

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

object (Text)

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

MerchantMatchingHints

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

ייצוג JSON 
{
  "placeId": string
}
שדות
placeId

string

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

ServiceAttribute

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

ייצוג JSON 
{
  "attributeId": string,
  "attributeName": string,
  "value": [
    {
      object (Value)
    }
  ]
}
שדות
attributeId

string

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

string

שם שגלוי למשתמש עבור המאפיין הזה, למשל "סוג חשבון".
value[]

object (Value)

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

Value

מייצג ערך אפשרי למאפיין שירות מסוים.

ייצוג JSON 
{
  "valueId": string,
  "valueName": string
}
שדות
valueId

string

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

string

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

ייעוץ

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

ייצוג JSON 
{
  "text": {
    object (Text)
  }
}
שדות
text

object (Text)

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

שיטות

create

 הפונקציה יוצרת Merchant חדש שמנוהל על ידי אתר האגרגטור שצוין ומחזירה אותו.

delete

 מחיקת נכס Merchant קיים שמנוהל על ידי אתר האגרגטור שצוין.

getStatus

 קבלת MerchantStatus של Merchant.

patch

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