REST Resource: inventory.partners.merchants.services

משאב: שירות

מידע על שירות שהמוכר מספק, לדוגמה: תספורת.

ייצוג JSON 
{
  "name": string,
  "serviceName": string,
  "localizedServiceName": {
    object (Text)
  },
  "description": string,
  "localizedDescription": {
    object (Text)
  },
  "price": {
    object (Price)
  },
  "priceInterpretation": enum (PriceInterpretation),
  "rules": {
    object (SchedulingRules)
  },
  "prepaymentType": enum (PrepaymentType),
  "prepaymentTerms": {
    object (PrepaymentTerms)
  },
  "form": [
    {
      object (ServiceIntakeForm)
    }
  ],
  "intakeForm": {
    object (ServiceIntakeForm)
  },
  "perTicketIntakeForm": {
    object (ServiceIntakeForm)
  },
  "taxRate": {
    object (TaxRate)
  },
  "paymentOptionId": [
    string
  ],
  "deposit": {
    object (Deposit)
  },
  "noShowFee": {
    object (NoShowFee)
  },
  "requireCreditCard": enum (RequireCreditCard),
  "actionLink": [
    {
      object (ActionLink)
    }
  ],
  "type": enum (ServiceType),
  "ticketType": [
    {
      object (TicketType)
    }
  ],
  "relatedMedia": [
    {
      object (RelatedMedia)
    }
  ],
  "serviceAttributeValueId": [
    {
      object (ServiceAttributeValueId)
    }
  ],
  "waitlistRules": {
    object (WaitlistRules)
  },
  "ticketingVerticalSpecificData": {
    object (TicketingVerticalSpecificData)
  },
  "integrationType": enum (IntegrationType),
  "perOrderFee": {
    object (PerOrderFee)
  },
  "toursAndActivitiesContent": {
    object (ToursAndActivitiesContent)
  },
  "location": [
    {
      object (Location)
    }
  ],
  "rating": {
    object (Rating)
  },
  "homeServiceData": {
    object (HomeServiceData)
  },
  "virtualSession": {
    object (VirtualSession)
  },
  "directMerchantPayment": {
    object (DirectMerchantPayment)
  }
}
שדות
name

string

השם של משאב השירות, בפורמט partners/{partner_id}/merchants/{merchantId}/services/{serviceId}.
serviceName

string

שם השירות, למשל: "תספורת לגברים". הוצא משימוש. במקומו צריך להשתמש ב-localizedServiceName.
localizedServiceName

object (Text)

שם השירות, למשל: "תספורת לגברים". ייתכן שבכמה מקומות.
description

string

תיאור השירות הגלוי למשתמש. הוצא משימוש. במקומו צריך להשתמש ב-localizedDescription.
localizedDescription

object (Text)

תיאור השירות הגלוי למשתמש.

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

תגי עיצוב נתמכים דמויי HTML:

תגי כותרות: <h1>, <h2>, <h3>, <h4>, <h5>, <h6>
ניתן להשתמש בתגי כותרת להצגת כותרות וכותרות משנה. לדוגמה, <h1>מסלול</h1> יציג את הטקסט המוטבע ככותרת החשובה ביותר של הקטע. לתשומת ליבכם: המערכת תתעלם מתגים, מסגנונות או ממאפיינים פנימיים של HTML. לדוגמה, <h1 style=".."> יטופלו בדיוק כמו ב-<h1>. רק טקסט טהור יישמר.

תג פסקה: <p>
ניתן להשתמש בתג הפיסקה כדי להדגיש מבוא או תוכן מפורטים. המערכת תתעלם מתגים, מסגנונות או ממאפיינים פנימיים, למעט עם כמה יוצאים מן הכלל: <br>, <strong> ו<em>. לפרטים נוספים, אפשר לעיין בקטע של התג לביטוי שבהמשך.

תגי רשימה: <ul>, <ol>, <li>
<ul> ניתן להשתמש בתג עם <li> להצגת רשימות לא ממוינות, ואת התג <ol> ניתן להשתמש בתג עם <li> כדי להציג רשימות ממוינות. זאת דרך טובה להציג רשימות של משימות, לוחות זמנים או כל רשימה אחרת שמתאימה לתרחישי השימוש שלכם.
דוגמה: כדי להציג רשימה של מאפיינים של טיול שייט:
<ol>
<li>נוף נפלא לים והזדמנויות לשחק עם חיות הבר.</li>
<li>סידורי נסיעה ושירותי תכנון קפדני.</li>
<li>המחיר הנמוך ביותר מובטח.</li>
</ol>
לתשומת ליבך: רק <li> ילדים מתחת לגיל <ul> או <ol> התגים יומרו. כל שאר הצאצאים יוסרו. בנוסף, המערכת תתעלם מתגים, מאפיינים וסגנונות פנימיים. אנחנו שומרים רק תוכן של טקסט טהור.

תג חלוקה: <div>
כל התגים הפנימיים הנתמכים של <div> ינותחו עם הכללים שצוינו למעלה, משתמע <div> התג עצמו לא מציין כאן קיבוץ או כניסת פיסקה. בנוסף, המערכת תתעלם מכל המאפיינים והסגנונות הפנימיים.

תגים לביטוי: <br>, <strong>, <em>:
נתמכים רק בשלושת התגים שלמעלה. &lt;br&gt; יכול לשמש לשבירת שורות בפסקאות, וגם <strong>/<em> יכול לשמש להדגשת טקסט חשוב. המערכת תתעלם מתגים אחרים של ביטויים.

תגים שאינם נתמכים:

  • <html>, <header> ו-<body> תגים אינם מותרים.
  • תגים אחרים שלא צוינו למעלה אינם נתמכים (לדוגמה, <table>, <td> ...).
    כל כתובות ה-URL, העוגנים והקישורים יוסרו ואף פעם לא יוצגו למשתמשי הקצה. כדי להשתמש בתמונות כדי ליצור חוויית משתמש עשירה, צריך להשתמש ב-relatedMedia למטה כדי לשלוח את כתובות ה-URL של התמונות שלך.

הערות חשובות:

  • לא כדאי להשתמש בתגים אחרים מלבד התגים הנתמכים שמפורטים למעלה, כי התוכן בתגים שלא נתמכים יוסר, מה שעלול לגרום לחוויית משתמש לא רצויה.
  • כדאי להימנע משימוש במבנים עם היררכיה עמוקה, כמו יותר מ-3 רמות שונות של כותרות או רשימות מקוננות. מבנה שטוח, פשוט ופשוט יוצר חוויית משתמש טובה יותר.
  • אם התבניות הנתמכות כרגע לא מספיקות לתרחישים לדוגמה שלכם, עליכם לפנות לצוות של 'Google הזמנת מקומות'.
  • הגודל המקסימלי המומלץ הוא 32,000 תווים.
price

object (Price)

מחיר השירות.
priceInterpretation

enum (PriceInterpretation)

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

object (SchedulingRules)

כללים לקביעה או לביטול של פגישות.
prepaymentType

enum (PrepaymentType)

האם נדרש תשלום מראש, אופציונלי או לא נתמך.
prepaymentTerms

object (PrepaymentTerms)

תנאים שקשורים למועד ביצוע התשלום מראש.
form[]
(deprecated)

object (ServiceIntakeForm)

הוצא משימוש. צריך להשתמש ב-intakeForm וב-perTicketIntakeForm.
intakeForm

object (ServiceIntakeForm)

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

object (ServiceIntakeForm)

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

object (TaxRate)

שיעור המס של השירות. אם השדה הזה קיים, הוא מבטל כל שיעור מס שנקבע ברמת המוֹכר. הודעה ריקה (לדוגמה, מס שיעור { }) תאפס את שיעור המס שהוחל.
paymentOptionId[]

string

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

object (Deposit)

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

object (NoShowFee)

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

enum (RequireCreditCard)

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

enum (ServiceType)

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

object (TicketType)

סוגי הכרטיסים שאפשר להזמין או לרכוש לשירות הזה, אם יש תמיכה בכרטיסים האלה. (אופציונלי)
relatedMedia[]

object (RelatedMedia)

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

object (ServiceAttributeValueId)

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

object (WaitlistRules)

כללי הצטרפות לרשימת ההמתנה.
ticketingVerticalSpecificData

object (TicketingVerticalSpecificData)

מידע נוסף שייחודי לתעשיית הכרטיסים לאירועים. (אופציונלי)
integrationType

enum (IntegrationType)

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

object (PerOrderFee)

העמלות ברמת ההזמנה על רכישת השירות הזה. (אופציונלי)
toursAndActivitiesContent

object (ToursAndActivitiesContent)

שדות תוכן שספציפיים לסיורים ולפעילויות.
location[]

object (Location)

מיקומים שקשורים לשירות הזה. הערות חשובות: אם קיימים מספר מיקומים שבהם ביקרת, הקשורים לשירות זה, או ש-START_LOCATION שונה מ-VISITED_LOCATION, יש לציין את START_LOCATION. דוגמה: סיור מודרך ברכיבה על אופניים שמבקרים בשלושה מקומות. יש לציין את נקודת ההתחלה. - פגישה של סיור באוטובוס בלובי של המלון, ולאחר מכן נסיעה למקום שבו ביקרת. צריך לציין את מיקום הפגישה.
rating

object (Rating)

דירוג המשתמשים של השירות הזה כמדד מצטבר לכל הביקורות.
homeServiceData

object (HomeServiceData)

מידע נוסף שייחודי לקטגוריית השירות הביתי. (אופציונלי)
virtualSession

object (VirtualSession)

זה שינוי אופציונלי. מידע על סשן וירטואלי. הוא נדרש כדי להפעיל שירותים וירטואליים.
directMerchantPayment

object (DirectMerchantPayment)

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

PriceInterpretation

מתאר את האופן שבו יש לפרש את המחיר ולהציג אותו למשתמש.

טיפוסים בני מנייה (enum)
PRICE_INTERPRETATION_UNSPECIFIED לא צוין פרשנות מחיר, ברירת המחדל היא EXACT_AMOUNT.
EXACT_AMOUNT

מקרים שבהם יש לפרש את המחיר כערך ספציפי.

דוגמאות: 80 ש"ח לשיעור יוגה. 60 ש"ח לתספורת לילד
STARTS_AT

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

לידיעתך, כל שירות שמשתמש בפירוש המחיר הזה חייב להשתמש ב-PrepaymentType NOT_SUPPORTED.

דוגמאות: 120 ש"ח לטיפוח כלבים, אבל אפשרויות נוספות של צרכנים עשויות להעלות את המחיר
NOT_DISPLAYED

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

לתשומת ליבך, כל שירות שמשתמש בפירוש המחיר הזה חייב להשתמש ב-PrepaymentType NOT_SUPPORTED ובמחיר צריך להיות ריק.

דוגמאות: ייעוץ לגבי שירות ביתי

SchedulingRules

כללי התזמון של שירות.

ייצוג JSON 
{
  "minAdvanceOnlineCanceling": string,
  "lateCancellationFee": {
    object (Price)
  },
  "noshowFee": {
    object (Price)
  },
  "admissionPolicy": enum (AdmissionPolicy),
  "cancellationPolicy": {
    object (CancellationPolicy)
  },

  // Union field min_booking_buffer can be only one of the following:
  "minAdvanceBooking": string,
  "minBookingBufferBeforeEndTime": string
  // End of list of possible types for union field min_booking_buffer.
}
שדות
minAdvanceOnlineCanceling

string (int64 format)

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

object (Price)

עמלת הביטול בתוך פרק הזמן המינימלי להודעה מראש.
noshowFee
(deprecated)

object (Price)

העמלה על אי-הגעה ללא ביטול.
admissionPolicy

enum (AdmissionPolicy)

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

object (CancellationPolicy)

מדיניות הביטול של כללים לתזמון. (חובה לפלטפורמת 'דברים שאפשר לעשות')

שדה איחוד min_booking_buffer. משך הזמן (בשניות) מרגע ביצוע ההזמנה האחרונה ועד שהמשבצת של משבצת הזמינות מתחילה או מסתיימת.

אם 'min_advance_booking' מוגדרת, הזמן האחרון שבו ניתן להזמין מחושב באופן הבא (<slot start time> - "min_advance_booking"). אם 'min_booking_buffer_before_end_time' מוגדרת, הזמן האחרון שבו ניתן להזמין מחושב כך: (<slot end time> - "min_booking_buffer_before_end_time"). יש לשים לב שהערך של 'min_booking_buffer_before_end_time' אם הוא מוגדר, הוא חייב להיות חיובי. אם שתיהן לא מוגדרות, אפשר לשריין את המשבצת עד שעת ההתחלה של המשבצת. אם הגדרתם את שני השדות, רק ערך אחד ייבחר בזמן שהמערכת תתעלם מהערך האחר – לא נוכל לחזות בצורה אמינה איזה ערך ייבחר.

דוגמאות:

  • תספורת שצריך להזמין לפחות שעה לפני שעת ההתחלה. &#39;scheduling_rules{ min_advance_booking: 3600 ...}`

  • מוזיאון שבו אפשר לרכוש את הכרטיס האחרון 30 דקות לפני הסגירה: 'scheduling_כללים{ min_booking_buffer_before_end_time: 1800 ...}'

  • כרטיס קולנוע שצריך לרכוש לפני שעת ההתחלה. 'scheduling_כללים{ ...}' (משאירים את השדה הזה ריק) (אופציונלי) min_booking_buffer יכול להיות רק אחת מהאפשרויות הבאות:
minAdvanceBooking

string (int64 format)

משך הזמן (בשניות) מרגע ביצוע ההזמנה האחרונה ועד לתחילת משבצת הזמינות.
minBookingBufferBeforeEndTime

string (int64 format)

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

AdmissionPolicy

מדיניות הכניסה של השירות הזה.

טיפוסים בני מנייה (enum)
ADMISSION_POLICY_UNSPECIFIED לא בשימוש.
TIME_STRICT הלקוחות נדרשים להיות נוכחים בשעת ההתחלה של משבצת הזמינות, והשירות צפוי להסתיים בשעת הסיום של משבצת הזמן. דוגמאות לתרחישים לדוגמה של TIME_STRICT: * סיור שמתחיל ב-9:00 ומחייב את כל המשתתפים להגיע בשעת ההתחלה, וחוזרת בסביבות השעה 12:00. * הזמנת תספורת ביום שבת בשעה 15:00. התהליך יימשך כ-30 דקות. * שיעור כושר מ-18:00 עד 20:00.
TIME_FLEXIBLE

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

דוגמאות לתרחישים לדוגמה של TIME_FLEXIBLE: * כרטיס למוזיאון שאפשר להשתמש בו בכל זמן בתאריך הרכישה. * כרטיס כניסה אחר הצהריים לפארק שעשועים שאפשר להשתמש בו בין 12:00 ל-21:00.
TIMED_ENTRY_WITH_FLEXIBLE_DURATION

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

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

CancellationPolicy

מדיניות ביטולים של שירות.

ייצוג JSON 
{
  "refundCondition": [
    {
      object (RefundCondition)
    }
  ]
}
שדות
refundCondition[]

object (RefundCondition)

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

RefundCondition

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

ייצוג JSON 
{
  "minDurationBeforeStartTime": string,
  "refundPercent": integer
}
שדות
minDurationBeforeStartTime

string (Duration format)

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

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

integer (uint32 format)

אחוז ההחזר הכספי שניתן לקבל עליו החזר כספי, כל עוד הזמנת השירות בוטלה לפחות minDurationBeforeStartTime לפני שעת ההתחלה של השירות, בטווח של [0, 100]. כאשר הערך מוגדר ל-0 (ברירת המחדל), לא ניתן לקבל החזר כספי על השירות. כשהשירות מוגדר ל-100, ניתן לקבל החזר כספי מלא עבור השירות הזה.

PrepaymentType

ערכי ה-Enum לציון סוג התשלום מראש.

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

PrepaymentTerms

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

ייצוג JSON 
{
  "chargeTiming": enum (ChargeTiming),
  "chargeTimeBeforeStartTimeSec": string
}
שדות
chargeTiming

enum (ChargeTiming)

מתי החיוב יתבצע ביחס לזמן הרכישה.
chargeTimeBeforeStartTimeSec

string (int64 format)

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

ChargeTiming

מיון שמציין מתי החיוב יתבצע ביחס לזמן הרכישה.

טיפוסים בני מנייה (enum)
CHARGE_TIMING_UNSPECIFIED לא בשימוש.
CHARGE_NOW הלקוח יחויב באופן מיידי.
CHARGE_LATER הלקוח יחויב במועד מאוחר יותר.

ServiceIntakeForm

מגדיר טופס איסוף פרטים להתאמה אישית של השירות שהמוכר מספק.

ייצוג JSON 
{
  "field": [
    {
      object (ServiceIntakeFormField)
    }
  ],
  "firstTimeCustomers": boolean,
  "returningCustomers": boolean
}
שדות
field[]

object (ServiceIntakeFormField)

השדות שיוצגו למשתמש.
firstTimeCustomers
(deprecated)

boolean

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

boolean

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

ServiceIntakeFormField

מגדירה שדה שנכלל ב-ServiceIntakeForm.

ייצוג JSON 
{
  "id": string,
  "type": enum (FieldType),
  "label": string,
  "localizedLabel": {
    object (Text)
  },
  "value": [
    string
  ],
  "choiceText": [
    {
      object (Text)
    }
  ],
  "isRequired": boolean,
  "allowCustomAnswer": boolean,
  "additionalOption": [
    {
      object (Text)
    }
  ],
  "ticketTypeRestrict": [
    string
  ],
  "hint": {
    object (Text)
  }
}
שדות
id

string

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

enum (FieldType)

סוג השדה הזה.
label

string

הטקסט שמוצג למשתמש בשדה הזה. הוצא משימוש. במקומו צריך להשתמש ב-localizedLabel.
localizedLabel

object (Text)

הטקסט שמוצג למשתמש בשדה הזה. אפשר לספק את השדה בכמה לוקאלים. (חובה)
value[]

string

יש להגדיר אם ורק אם סוג השדה הוא LOCATION_SEARCH. יש להשתמש ב-"locationId" ב"מיקום" כדי לציין את ערך המיקום.
choiceText[]

object (Text)

יש להגדיר אך ורק אם סוג השדה הוא MULTIPLE_CHOICE, CHECKBOXES או DROPDOWN. משמש לספירת אפשרויות אפשריות.
isRequired

boolean

מציין אם המשתמש ביקש לענות בשדה הזה.
allowCustomAnswer

boolean

מציינת אם אפשר להשתמש בערך מותאם אישית בנוסף לתשובות שהוגדרו מראש. הדבר רלוונטי רק כאשר סוג השדה הוא LOCATION_SEARCH. (אופציונלי)
additionalOption[]

object (Text)

אפשרויות נוספות ניתנות בנוסף לערכים שסופקו. רלוונטי רק כאשר סוג השדה הוא LOCATION_SEARCH. לדוגמה בנוסף לרשימת המיקומים שסופקה, אפשרות זמינה נוספת היא "אצור קשר עם הספק מאוחר יותר". (אופציונלי)
ticketTypeRestrict[]

string

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

object (Text)

טקסט הרמז לקלט, שמוצג בתור placeholder של טקסט. הדבר רלוונטי רק כאשר סוג השדה הוא SHORT_ANSWER או GMC. (אופציונלי)

FieldType

טיפוסים בני מנייה (enum) כדי לציין את סוג השדה.

טיפוסים בני מנייה (enum)
FIELD_TYPE_UNSPECIFIED המערכת תתעלם משדות מסוג שלא צוין או מסוג לא ידוע.
SHORT_ANSWER שדה להזנת טקסט, בן שורה אחת.
PARAGRAPH שדה להזנת טקסט עם כמה שורות.
MULTIPLE_CHOICE קבוצה של לחצני בחירה שמחייבת בחירה אחת מתוך אפשרויות רבות.
CHECKBOXES פריט ספירה אחד או יותר עם תיבות סימון.
DROPDOWN בחירה מתוך תפריט נפתח.
BOOLEAN לחצן כן/לא.

ServiceType

סוגי שירות מוגדרים מראש.

טיפוסים בני מנייה (enum)
SERVICE_TYPE_UNSPECIFIED לא בשימוש.
SERVICE_TYPE_DINING_RESERVATION הזמנת מקום במסעדה.
SERVICE_TYPE_FOOD_ORDERING הזמנת אוכל, יכולה להיות משלוחי אוכל, טייק אוויי או שניהם.
SERVICE_TYPE_FOOD_DELIVERY משלוחי אוכל.
SERVICE_TYPE_FOOD_TAKEOUT טייק אוויי.
SERVICE_TYPE_EVENT_TICKET כרטיס לאירוע.
SERVICE_TYPE_TRIP_TOUR סיור בנסיעה.
SERVICE_TYPE_APPOINTMENT שירות שמספק פגישות או שיעורים. מומלץ: (1) שירותי בריאות וכושר, (2) ספא ויופי, ו-(3) שירותי ייעוץ והערכה פיננסיים. אלה סוגי השירותים הנתמכים: https://developers.google.com/maps-booking/guides/end-to-end-integration/overview
SERVICE_TYPE_ONLINE_APPOINTMENT שירות שמספק פגישה אונליין לשיעור או לסשן באופן וירטואלי לחלוטין. חובה להגדיר אם מפעילים הזמנות של שירותים וירטואליים.
SERVICE_TYPE_SHOPPING שירות שמאפשר למשתמשים לקנות מהמוכר הנתון. ההזמנה יכולה להיות במשלוח או באיסוף עצמי.

TicketType

TicketType משמש להבחנה בין כרטיסים עם מחירים ו/או זמינות שונים עקב סוגי משתמשים שונים, מאפייני שירות שונים או אפשרויות או תוספים שונים.

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

ייצוג JSON 
{
  "ticketTypeId": string,
  "shortDescription": string,
  "localizedShortDescription": {
    object (Text)
  },
  "price": {
    object (Price)
  },
  "perTicketFee": {
    object (PerTicketFee)
  },
  "optionDescription": string,
  "localizedOptionDescription": {
    object (Text)
  }
}
שדות
ticketTypeId

string

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

string

תיאור קצר של TicketType זה.

השם יכול להיות גלוי למשתמש, לדוגמה, 'adult', 'ילד', 'veteran', 'שורה J' וכו'. חובה, לכל סוג כרטיס צריך להיות תיאור שיוצג למשתמשים. הוצא משימוש. במקומו צריך להשתמש ב-localizedShortDescription.
localizedShortDescription

object (Text)

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

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

object (Price)

המחיר של כרטיס יחיד מהסוג הזה, לא כולל מיסים. שיעור המס של השירות חל על הכרטיסים שלו.
perTicketFee

object (PerTicketFee)

עמלות נוספות על רכישת הכרטיס הזה. (אופציונלי)
optionDescription

string

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

object (Text)

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

אפשרויות נוספות שימושיות כאשר סוג הכרטיס מייצג כמה מאפיינים.

דוגמה 1: כרטיס כניסה עם סוגים שונים 'למבוגרים', 'ילד' והשפה כאפשרות נוספת, רשימת ה-TickType הצפויה תהיה: - {ticketTypeId: "ticket_type_1" localizedShortDescription { value: "adult" } localizedOptionDescription { value: "english" } } - {ticketTypeId: "ticket_type_2" localizedShortDescription { value: "adult" } localizedOptionDescription { value: "spanish" } } - {ticketTypeId: "ticket_type_3" localizedShortDescription { value: "child" } localizedOptionDescription { value: "english" } } - { TicketTypeId: "ticket_type_4" localizedShortDescription { value: "child" } localizedOptionDescription { value: "spanish" } }

דוגמה 2: השכרת קיאק למספר שעות עם תוסף אופציונלי של שקיות יבש, התיאור הקצר (shortDescription) יכול להיות "3 שעות" וה-OptionDescription יכול להיות "עם שקית יבש" או "ללא שקית יבש": - {ticketTypeId: "ticket_type_1" localizedShortDescription { value: "2 hours" } localizedOptionDescription { value: "english" } } - {ticketTypeId: "ticket_type_2" localizedShortDescription { value: "2 hours" } localizedOptionDescription { value: "spanish" } } - {ticketTypeId: "ticket_type_3" localizedShortDescription { value: "3 hours" } localizedOptionDescription { value: "english" } } - {ticketTypeId: "ticket_type_4" localizedShortDescription { value: "3 hours" } localizedOptionDescription { value: "spanish" } }

אופציונלי, אבל אם השדה הזה מוגדר לסוג כרטיס בשירות, אנחנו מצפים שהשדה הזה יהיה מוגדר גם בכל סוגי הכרטיסים האחרים (ניתן להשתמש ב-OptionDescription כברירת מחדל). לדוגמה הרשימה [{ticket_type_1, Adult, english}, {ticket_type_1, Adult, ''}] לא חוקית.

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

PerTicketFee

העמלות שחייבים לשלם על כל כרטיס שהמשתמש רוכש.

ייצוג JSON 
{
  "serviceCharge": {
    object (Price)
  },
  "facilityFee": {
    object (Price)
  },
  "taxes": {
    object (Price)
  }
}
שדות
serviceCharge

object (Price)

החיוב הנוסף המשוער על שירות.
facilityFee

object (Price)

תשלום שיועבר למקום או למתקן.
taxes

object (Price)

מיסים לפי כרטיס.

RelatedMedia

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

ייצוג JSON 
{
  "url": string,
  "type": enum (MediaType),
  "localizedCaption": {
    object (Text)
  },
  "attribution": {
    object (Attribution)
  },
  "caption": string
}
שדות
url

string

כתובת ה-URL של מקור המדיה הזה. Google תסרוק את המדיה שמתארחת בכתובת ה-URL הזו.
type

enum (MediaType)

הסוג של מקור המדיה הזה.
localizedCaption

object (Text)

כיתוב של מדיה שתומכת ב-i18n, יש תמיכה רק בטקסט פשוט. כל רכיבי ה-HTML יוסרו. (אופציונלי)
attribution

object (Attribution)

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

string

הוצא משימוש, אני רוצה להשתמש ב-localizedCaption.

MediaType

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

טיפוסים בני מנייה (enum)
TYPE_UNSPECIFIED לא בשימוש.
PHOTO מציין שהמדיה שסופקה בכתובת ה-URL היא תמונה.

שיוך (Attribution)

פרטי השיוך של המדיה הזו.

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

object (Text)

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

string

הוצא משימוש, אני רוצה להשתמש ב-localizedText.

ServiceAttributeValueId

מזהה ערך מסוים של מאפיין שירות שיש להחיל על שירות.

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

string

מזהה של מאפיין כפי שמוגדר במאפיין Merchant.service_ , למשל: 'service-type'.
valueId

string

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

WaitlistRules

כללים שקשורים להצטרפות לרשימת ההמתנה.

ייצוג JSON 
{
  "minPartySize": integer,
  "maxPartySize": integer,
  "supportsAdditionalRequest": boolean,
  "aboveMaxPartySizeOptions": [
    {
      object (UnsupportedPartySizeOption)
    }
  ]
}
שדות
minPartySize

integer

חובה. חייב להיות מספר שלם חיובי לשירותים שמספקים פונקציונליות של רשימת המתנה. אם השירות או המוכר לא מספקים פונקציונליות של רשימת המתנה, אסור לאכלס אותה.
maxPartySize

integer

חובה. חייב להיות מספר שלם חיובי לשירותים שמספקים פונקציונליות של רשימת המתנה. אם השירות או המוכר לא מספקים פונקציונליות של רשימת המתנה, אסור לאכלס אותה.
supportsAdditionalRequest

boolean

אם True, המשתמש יוכל לשלוח בקשת טקסט נוספת כשיצטרף לרשימת ההמתנה לשירות הזה.
aboveMaxPartySizeOptions[]

object (UnsupportedPartySizeOption)

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

UnsupportedPartySizeOption

אפשרויות למסיבות מחוץ לטווח.

ייצוג JSON 
{
  "callMerchant": {
    object (CallMerchant)
  }
}
שדות
callMerchant

object (CallMerchant)

אנשים שנמצאים מחוץ לטווח יכולים להתקשר לעסק. תוצג למשתמש הודעה מוגדרת מראש. טקסט לדוגמה שיוצג: "במסיבות גדולות יותר מ-{waitlistRules.max_party_size}, נא להתקשר למסעדה בכתובת {phone}". חובה להגדיר את CallMerchant, אבל היא תהיה ריקה.

CallMerchant

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

TicketingVerticalSpecificData

מידע נוסף שייחודי לתעשיית הכרטיסים לאירועים.

ייצוג JSON 
{
  "eventCategory": enum (EventCategory),
  "eventUrl": string,
  "entity": [
    {
      object (Entity)
    }
  ],
  "eventAttendanceMode": enum (AttendanceMode),
  "eventVirtualLocationUrl": [
    string
  ],
  "eventOrganizer": {
    object (Text)
  },
  "eventOrganizerUrl": string,
  "eventOrganizerType": enum (OrganizerType),
  "eventSourceUrl": [
    string
  ],
  "eventState": enum (EventState)
}
שדות
eventCategory

enum (EventCategory)

קטגוריית האירוע. צריך להגדיר את האירוע רק כשהאירוע משתייך לאחת מהקטגוריות המוגדרות מראש. (אופציונלי)
eventUrl

string

כתובת ה-URL של האירוע באתר של השותף. (אופציונלי)
entity[]

object (Entity)

רשימת ישויות שקשורות לאירוע. (אופציונלי)
eventAttendanceMode

enum (AttendanceMode)

חובה. סוג הנוכחות באירוע.
eventVirtualLocationUrl[]

string

זה שינוי אופציונלי. כתובת ה-URL שבה ניתן לצפות באירוע.
eventOrganizer

object (Text)

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

string

זה שינוי אופציונלי. כתובת ה-URL של מארגן האירוע שמארח את האירוע.
eventOrganizerType

enum (OrganizerType)

זה שינוי אופציונלי. סוג המארגן.
eventSourceUrl[]

string

חובה. כתובת ה-URL של הדפים שבהם ניתן למצוא את פרטי האירוע או התיאורים.
eventState

enum (EventState)

זה שינוי אופציונלי. מצב האירוע.

EventCategory

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

טיפוסים בני מנייה (enum)
EVENT_CATEGORY_UNSPECIFIED לא צוין. אין להשתמש בו.
EVENT_CATEGORY_CONCERT הופעות.
EVENT_CATEGORY_SPORTS אירועי ספורט.
EVENT_CATEGORY_THEATRE אירועי תיאטרון.
EVENT_CATEGORY_EXHIBITS מוצגים.
EVENT_CATEGORY_WORKSHOPS_AND_CLASSES סדנאות ושיעורים.

ישות

מייצג ישות שקשורה לאירוע.

ייצוג JSON 
{
  "id": string,
  "name": string,
  "url": string,
  "entityType": enum (EntityType),
  "entityRole": enum (EntityRole),
  "publicIdentificationData": {
    object (PublicIdentificationData)
  }
}
שדות
id

string

המזהה הייחודי של הישות במסד הנתונים של השותף. (אופציונלי)
name

string

שם הישות. (חובה)
url

string

כתובת ה-URL של דף האינטרנט שמתאר באופן חד-משמעי את הישות. זהו דף האינטרנט באתר של השותף עבור הישות, אם יש כזה. בכתובות URL ציבוריות אחרות של הישות, צריך להשתמש ב- relevantUrl ב-publicIdentificationData. (אופציונלי)
entityType

enum (EntityType)

סוג הישות. (אופציונלי)
entityRole

enum (EntityRole)

תפקיד הישות באירוע. (אופציונלי)
publicIdentificationData

object (PublicIdentificationData)

הפניות ציבוריות של הישות. (אופציונלי)

EntityType

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

טיפוסים בני מנייה (enum)
ENTITY_TYPE_UNSPECIFIED לא צוין. אין להשתמש בו.
ENTITY_TYPE_PERFORMER הישות מייצגת את האומן או את הקבוצה שמופיעים בהופעה או בהופעה. המאפיין הזה רלוונטי רק אם קטגוריית האירוע היא 'צפייה' או 'תיאטרון'.
ENTITY_TYPE_PLAYER הישות מייצגת את קבוצת הספורט או השחקן באירוע. רלוונטי רק כאשר קטגוריית האירוע היא 'ספורט'.
ENTITY_TYPE_CONCERT_TOUR הישות מייצגת את הסיור שאליו שייך האירוע הזה. רלוונטי רק כאשר קטגוריית האירוע היא CONCERT.
ENTITY_TYPE_SPORTS_SERIES הישות מייצגת טורניר ספורט שהאירוע הזה שייך אליו. רלוונטי רק כאשר קטגוריית האירוע היא 'ספורט'.
ENTITY_TYPE_PLAY הישות מייצגת את סוג ההצגה (למשל: מוזיקה, קומדיה, בלט וכו') שהתרחשה באירוע. השדה הזה רלוונטי רק כשקטגוריית האירוע היא 'תיאטרון'.

EntityRole

תפקיד הישות באירוע.

טיפוסים בני מנייה (enum)
ENTITY_ROLE_UNSPECIFIED לא צוין.
ENTITY_ROLE_HEADLINER הישות מייצגת לייבל או חברה מובילה באירוע.
ENTITY_ROLE_SUPPORTER הישות מייצגת משתתף/ת שתומך/ת באירוע.
ENTITY_ROLE_HOME_TEAM הישות מייצגת את הקבוצה הביתית באירוע (הספורט).
ENTITY_ROLE_AWAY_TEAM הישות מייצגת את קבוצת הנחיתה באירוע (ספורט).

PublicIdentificationData

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

ייצוג JSON 
{
  "relevantUrl": [
    string
  ],
  "musicbrainzId": string
}
שדות
relevantUrl[]

string

כתובת URL ציבורית של כל דף אינטרנט שמוקדש לנושא בלבד. לדוגמה: אתרים רשמיים, דיסקוגים, פלטפורמות של רשתות חברתיות, דפי ויקיפדיה או דפי imdb. https://www.discogs.com/artist/1124645-Taylor-Swift, https://www.wikidata.org/wiki/Q19320959, https://twitter.com/acmilan. (אופציונלי)
musicbrainzId

string

מזהה Musicbrainz באורך 36 תווים של האומן או של ישויות מוזיקה אחרות, אם רלוונטי. פרטים נוספים זמינים בכתובת https://musicbrainz.org/doc/MusicBrainz_Identifier. (אופציונלי)

AttendanceMode

סוג הנוכחות באירוע.

טיפוסים בני מנייה (enum)
ATTENDANCE_MODE_UNSPECIFIED לא צוין.
ONLINE לאירועים וירטואליים.
PHYSICAL לאירועים פיזיים.
PHYSICAL_ONLINE_MIXED לאירועים שהם גם פיזיים וגם וירטואליים.

OrganizerType

סוג המארגן.

טיפוסים בני מנייה (enum)
ORGANIZER_TYPE_UNSPECIFIED לא צוין.
PERSON מיועד למארגן/ת שהוא אדם.
ORGANIZATION למארגנים שהם ארגון.

EventState

מצב האירוע.

טיפוסים בני מנייה (enum)
EVENT_STATE_UNSPECIFIED לא צוין.
SCHEDULED האירוע נקבע.
RESCHEDULED המועד של האירוע השתנה.
CANCELLED האירוע בוטל.
POSTPONED האירוע נדחה.

IntegrationType

עומק השילוב שנתמך.

טיפוסים בני מנייה (enum)
INTEGRATION_TYPE_UNSPECIFIED ברירת המחדל היא END_TO_END.
INTEGRATION_TYPE_END_TO_END השלמת השילוב שמאפשר לסיים את ההזמנות דרך Google.
INTEGRATION_TYPE_INVENTORY_ONLY שרת ההזמנות לא צריך לתמוך בשירות הזה. צריך לשלוח רק נתוני מוכרים, שירותים ונתוני זמינות (אופציונלי).

PerOrderFee

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

ייצוג JSON 
{
  "deliveryFee": {
    object (Price)
  },
  "processingFee": {
    object (Price)
  }
}
שדות
deliveryFee

object (Price)

עמלה שיכולה להשתנות לפי שיטת המשלוח.
processingFee

object (Price)

עמלה על עיבוד אמצעי התשלום של המשתמש.

ToursAndActivitiesContent

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

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

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

כל שאר התגים והסגנונות המותאמים אישית אינם מותרים והם יוסרו. כל כתובות ה-URL, העוגנים והקישורים יוסרו ואף פעם לא יוצגו למשתמשי הקצה.

הערות חשובות: * אין לשכפל נתונים שכבר סופקו בשדות highlights, exclusion ושדות אחרים, ספציפיים יותר, בתיאור השירות. * מומלץ להימנע משימוש בתגים אחרים, חוץ מהתגים הנתמכים שצוינו למעלה, כי התוכן בתגים שלא נתמכים יוסר, מה שעלול להוביל לחוויית משתמש לא רצויה.

ייצוג JSON 
{
  "highlights": [
    {
      object (Text)
    }
  ],
  "inclusions": [
    {
      object (Text)
    }
  ],
  "exclusions": [
    {
      object (Text)
    }
  ],
  "mustKnow": [
    {
      object (Text)
    }
  ]
}
שדות
highlights[]

object (Text)

רשימת נתוני השימוש הגלויים למשתמש.
inclusions[]

object (Text)

רשימת ההכללות הגלויה למשתמשים.
exclusions[]

object (Text)

רשימת ההחרגות שגלויה למשתמש.
mustKnow[]

object (Text)

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

מיקום

מידע גיאוגרפי על מיקום.

ייצוג JSON 
{
  "placeId": string,
  "name": string,
  "telephone": string,
  "url": string,
  "geo": {
    object (GeoCoordinates)
  },
  "locationType": enum (LocationType),
  "locationId": string
}
שדות
placeId

string

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

string

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

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

string

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

string

כתובת ה-URL של האתר הציבורי של המיקום. (אופציונלי)
geo

object (GeoCoordinates)

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

enum (LocationType)

יש לספק את סוג המיקום אם המיקום הזה מסופק עבור שירות.
locationId

string

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

LocationType

הסוג של המיקום הזה.

טיפוסים בני מנייה (enum)
LOCATION_TYPE_UNSPECIFIED לא צוין סוג מיקום.
VISITED_LOCATION המיקום שבו השירות הזה מבקר.
START_LOCATION המיקום שבו השירות הזה מתחיל, משמש גם כ-MEETING_LOCATION.
END_LOCATION המיקום שבו השירות הזה מסתיים.

Rating

מגדיר דירוג לישות.

ייצוג JSON 
{
  "value": number,
  "numberOfRatings": string
}
שדות
value

number

ערך דירוג ממוצע (חובה כאשר numberOfRatings > 0). הערך חייב להיות בטווח של [1, 5] ואפשר להשמיט אותו אם ורק אם numberOfRatings הוא אפס.
numberOfRatings

string

מספר הדירוגים שמשמשים לחישוב הערך (חובה).

HomeServiceData

יש לספק מידע נוסף עבור קטגוריית השירות הביתי.

ייצוג JSON 
{
  "categoryType": string,
  "jobType": string
}
שדות
categoryType

string

הקטגוריה ברמה הגבוהה שאליה משתייך השירות הביתי הזה. לדוגמה שרברבים, חשמלאים וכו'
jobType

string

סוג העבודה בקטגוריה שאליה שייך השירות הביתי הנתון. לדוגמה unclog_drain, install_faucet הם סוגי העבודות בקטגוריית 'שרברבים'.

VirtualSession

מידע על סשן וירטואלי/אונליין. לדוגמה שיעור יוגה אונליין, שיעור בישול וירטואלי וכו'

ייצוג JSON 
{
  "sessionInstructions": {
    object (Text)
  },
  "sessionRequirements": {
    object (Text)
  },
  "virtualPlatformInfo": {
    object (VirtualPlatformInfo)
  },
  "isSessionPrerecorded": boolean
}
שדות
sessionInstructions

object (Text)

ההוראות להגדרה של המחלקה הווירטואלית הזו. אם השותף לא כולל את כתובת ה-URL של הסרטון בהזמנה, צריך לציין בטקסט מתי כתובת ה-URL של הסרטון תשותף עם המשתמש. לדוגמה: "כתובת ה-URL של Zoom תישלח 30 דקות לפני השיעור". (השיטה המומלצת)
sessionRequirements

object (Text)

דרישות לסשן הווירטואלי הנתון. דוגמה מזרן יוגה, כלי בישול וכו' (מומלץ)
virtualPlatformInfo

object (VirtualPlatformInfo)

מידע על הפלטפורמה הווירטואלית שבה נעשה שימוש בסשן הזה. (נדרש כדי להפעיל שירותים וירטואליים)
isSessionPrerecorded

boolean

חובה. יש להגדיר את הערך כ-True אם הסשן הווירטואלי לא בשידור חי ומוקלט מראש.

VirtualPlatformInfo

מידע על הפלטפורמה שתשמש בסשן הווירטואלי הזה.

ייצוג JSON 
{
  "platform": enum (Platform),
  "otherPlatformName": {
    object (Text)
  }
}
שדות
platform

enum (Platform)

הפלטפורמה שמשמשת לסשן וירטואלי.
otherPlatformName

object (Text)

שם הפלטפורמה, אם הפלטפורמה מוגדרת כ-OTHER. (חובה אם הפלטפורמה מוגדרת כ-OTHER)

פלטפורמה

מספר שמציין באיזו פלטפורמה וירטואלית המוכר ישתמש.

טיפוסים בני מנייה (enum)
PLATFORM_UNSPECIFIED לא בשימוש.
FLEXIBLE המוכר גמיש באיזו פלטפורמת וידאו הוא משתמש.
GOOGLE_HANGOUTS מוצר של Google Hangouts.
GOOGLE_MEET מוצר של Google Meet.
ZOOM תקשורת וידאו של Zoom.
SKYPE Skype.
YOUTUBE סטרימינג בשידור חי ב-YouTube.
OTHER יש להגדיר זאת אם פלטפורמת הסרטונים שבה נעשה שימוש שונה מאלה שצוינו כאן.

DirectMerchantPayment

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

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

object (Text)

אנחנו ממליצים למשתמשים לשלם רק באמצעות אמצעי התשלום המפורטים בהמשך.

שיטות

create

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

delete

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

patch

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