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)
    }
  ],
  "reservationLinkoutTemplate": [
    {
      object (LinkoutTemplate)
    }
  ],
  "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

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

object (GeoCoordinates)

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

string

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

string (int64 format)

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

integer (uint32 format)

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

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

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

השדה הזה הוצא משימוש. במקומו צריך להשתמש בשדה taxRate.
taxRate
(deprecated)

object (TaxRate)

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

object (PaymentRestrictions)

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

object (PaymentOption)

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

object (PaymentProcessorConfig)

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

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)

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

object (LinkoutTemplate)

אופציונלי. תבנית הקישור ליציאה מהאפליקציה שמציינת איך Google צריכה ליצור את כתובת ה-URL של השותף כדי להזמין שולחן בפלטפורמה שלו.

הערה: נכון לעכשיו, אם תספקו כמה ערכים, המערכת תשתמש רק בערך הראשון.

תבנית ה-URI תומכת בשדות שיאוכלסו על סמך בחירות ההזמנה של המשתמש. כל שדות החובה נדרשים כדי ליצור כתובת ה-URL להזמנת מקום בהצלחה: * (חובה) partySize, int: גודל הקבוצה שעבורה המשתמש מבקש הזמנה. ‫* (חובה) selected_date_time, תאריך ושעה בפורמט ISO 8601 (https://en.wikipedia.org/wiki/ISO_8601): השעה שבה המשתמש מבקש לבצע הזמנה. ‫* (אופציונלי) merchantId, מחרוזת: מזהה המוכר שהמשתמש מבקש לבצע הזמנה אצלו. לא נדרש אם התבנית כבר כוללת מזהה מוכר. ‫* (אופציונלי) roomId, מחרוזת: המזהה של החדר שהמשתמש מבקש להזמין.
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 כרטיס אשראי של ויזה.
MASTERCARD כרטיס אשראי של Mastercard.
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" 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" }.
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

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

LinkoutTemplate

תבנית שמציינת איך Google צריכה ליצור כתובות URL לאתר של שותף.

ייצוג ב-JSON 
{
  "uriTemplate": string
}
שדות
uriTemplate

string

תבנית ה-URI צריכה להיות בהתאם ל-RFC 6570, כפי שמתואר בכתובת https://datatracker.ietf.org/doc/html/rfc6570. תמיכה בתבניות ברמה 1 ובכל התבניות המורכבות ברמה 4. למשל: http://example.com/book/{foo}?b={bar} * foo = 2 * bar = abc https://example.com/book/2?b=abc

ייעוץ

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

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

object (Text)

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

EconomicOperator

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

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

object (Text)

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

Methods

create

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

delete

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

getStatus

 קבלת MerchantStatus של Merchant.

patch

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