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)
  },
  "economicOperator": {
    object (EconomicOperator)
  }
}
שדות
name

string

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

string

השדות merchantName,‏ telephone,‏ url ו-geo משמשים לצורך התאמת מלאי שטחי הפרסום של שותפים למוכרים שכבר מופיעים במפות 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 הזמנת מקומות'. בנוסף, התנאים וההגבלות של שותף ה-Aggregator תמיד מוצגים למשתמש ואסור לספק אותם כאן.
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 בייטים.
economicOperator

object (EconomicOperator)

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

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

enum (PaymentOptionType)

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

string (int64 format)

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

object (TimeRange)

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

object (TimeRange)

אפשר להשתמש באפשרות התשלום במהלך התקופה הזו (למשל, מחיר מיוחד לינואר 2017). אם הוא קיים, הוא מבטל את validDuration ואת activationType.
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)

בדרך כלל, תצורת יצירת אסימונים תכלול פרמטר אחד של יצירת אסימונים (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" ערך: '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 הזמנת מקומות'.

EconomicOperator

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

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

object (Text)

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

שיטות

create

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

delete

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

getStatus

 אחזור ה-MerchantStatus של Merchant.

patch

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