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

כתובת ה-URL של האתר הציבורי של המוכר.
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 שהוצא משימוש. הודעה ריקה (למשל מס בשיעור { }) תאפס את שיעור המס שהוחל.
paymentRestrictions

object (PaymentRestrictions)

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

object (PaymentOption)

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

object (PaymentProcessorConfig)

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

object (TokenizationConfig)

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

object (Terms)

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

string

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

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

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

אם השותף...

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

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

  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

סוג כרטיס אשראי.

טיפוסים בני מנייה (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 (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 מצוין במוכר או בשירות. הודעה ריקה (למשל מס בשיעור { }) תאפס את שיעור המס שהוחל.
paymentOptionType

enum (PaymentOptionType)

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

string (int64 format)

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

object (TimeRange)

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

object (TimeRange)

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

string (Duration format)

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

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

enum (ActivationType)

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

object (UserPurchaseRestriction)

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

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

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 שנשלח למעבד התשלומים יחד עם בקשות תשלום.

מעבד

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

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

TokenizationConfig

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

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

map (key: string, value: string)

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

שאר הפרמטרים תלויים במעבד. מידע נוסף זמין במסמכים של Google Pay.

דוגמה ל-Baintree: TokenizationParameter { key: "gateway" value: "braintree" } TokenizationParameter { key: "braintree:apiVersion" ערך: "v1" } tokenizationParameter { key: "braintree:sdkVersion" ערך: "2.30.0" } TokenizationParameter { key: "braintree:merchantId" value: "abcdef" } TokenizationParameter { key: "braintree:clientKey" value: "production_xxx_yyy" }

דוגמה ל-Stripe: TokenizationParameter { key: "gateway" ערך: 'stripe' } TokenizationParameter { key: "stripe:version" value: "2018-02-28" } TokenizationParameter { key: "stripe:publishableKey" ערך: "pk_1234" }

דוגמה של Adyen: TokenizationParameter { key: "gateway" ערך: "adyen" } TokenizationParameter { 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).

טיפוסים בני מנייה (enum)
BILLING_INFORMATION_FORMAT_UNSPECIFIED לא צוין. ברירת המחדל היא MIN.
MIN שם, קוד מדינה ומיקוד (הגדרת ברירת המחדל של Google Pay).
FULL שם, רחוב, רשות מוניציפאלית, אזור, קוד מדינה ומיקוד.

תנאים

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

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

string

אופציונלי: כתובת ה-URL של התנאים וההגבלות.
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

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

string

שם המאפיין הזה גלוי למשתמש, לדוגמה: 'סוג החשבון'.
value[]

object (Value)

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

ערך

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

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

string

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

string

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

ייעוץ

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

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

object (Text)

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

שיטות

create

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

delete

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

getStatus

 אפשר לקבל את MerchantStatus של Merchant.

patch

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