- משאב: שירות
- PriceInterpretation
- SchedulingRules
- AdmissionPolicy
- CancellationPolicy
- RefundCondition
- PrepaymentType
- PrepaymentTerms
- ChargeTiming
- ServiceIntakeForm
- ServiceIntakeFormField
- FieldType
- ServiceType
- TicketType
- PerTicketFee
- RelatedMedia
- MediaType
- שיוך (Attribution)
- ServiceAttributeValueId
- WaitlistRules
- UnsupportedPartySizeOption
- CallMerchant
- TicketingVerticalSpecificData
- EventCategory
- ישות
- EntityType
- EntityRole
- PublicIdentificationData
- AttendanceMode
- OrganizerType
- EventState
- IntegrationType
- PerOrderFee
- ToursAndActivitiesContent
- מיקום
- LocationType
- דירוג
- HomeServiceData
- VirtualSession
- VirtualPlatformInfo
- פלטפורמה
- DirectMerchantPayment
- שיטות
משאב: שירות
מידע על שירות שניתן על ידי המוכר, למשל תספורת.
ייצוג JSON |
---|
{ "name": string, "serviceName": string, "localizedServiceName": { object ( |
שדות | |
---|---|
name |
שם משאב השירות, בפורמט |
serviceName |
שם השירות, למשל "תספורת לגברים". הוצא משימוש. במקומו צריך להשתמש ב-localizedServiceName. |
localizedServiceName |
שם השירות, למשל "תספורת לגברים". ייתכן בכמה מקומות. |
description |
תיאור השירות שגלוי למשתמש. הוצא משימוש. במקומה יש להשתמש ב-localizedDescription. |
localizedDescription |
תיאור השירות שגלוי למשתמש. שדה זה תומך בעיצוב של טקסט פשוט וגם בפורמט דמוי HTML. בניגוד לקטעי טקסט פשוט, ניתן ליצור כאן פריסות מותאמות אישית באמצעות כותרות, פסקאות, רשימות ותגים של ביטויים. כדי להבטיח את חוויית המשתמש הטובה ביותר, יש לקרוא את ההוראות וההערות הבאות בקפידה. תגי עיצוב נתמכים דמויי HTML: תגי כותרת: <h1>, <h2>, <h3>, <h4>, <h5>, <h6> תג פסקה: <p> תגי רשימה: <ul>, <ol>, <li> תג חילוק: <div> תגי ביטוי: <br>, <strong>, <em>: תגים לא נתמכים:
הערות חשובות:
|
price |
מחיר השירות. |
priceInterpretation |
מתאר את האופן שבו המחיר מפורש ומוצג למשתמש. יכול לשמש לכל ענף תעשייה חוץ ממסעדות ודברים שאפשר לעשות כדי להגדיר את התצוגה של מחיר השירות. |
rules |
כללים לקביעת פגישה/ביטול פגישה. |
prepaymentType |
האם נדרש תשלום מראש, אופציונלי או לא נתמך. |
prepaymentTerms |
התנאים שחלים על ביצוע התשלום מראש. |
form[] |
הוּצא משימוש. יש להשתמש ב-intakeForm וב-perTicketIntakeForm. |
intakeForm |
טופס שמבקש מידע נוסף מהמשתמש כדי להזמין את השירות הזה. (אופציונלי) |
perTicketIntakeForm |
טופס שמבקש מידע נוסף מהמשתמש כדי להזמין את השירות הזה. יש למלא את הטופס הזה פעם אחת לכל כרטיס שהמשתמש מזמין. (אופציונלי) |
taxRate |
שיעור המס של השירות. אם השדה הזה קיים, הוא מבטל כל שיעור מס שהוגדר ברמת המוכר. הודעה ריקה (כלומר TaxRate { }) תאפס את שיעור המס שהוחל לאפס. |
paymentOptionId[] |
רשימת מזהים שמפנים לאפשרויות תשלום שבהן אפשר להשתמש כדי לשלם על השירות הזה. אפשרויות התשלום בפועל מוגדרות ברמת המוכר, ואפשר לשתף אותן בין כמה מוכרים. |
deposit |
הגדרת האופן שבו המשתמש מחויב בסכום הפקדה. מבטלת את ההפקדה לשירות, אם צוינה כזו. אם מגדירים את ההגדרה כהודעת הפקדה ריקה, יוסרו כל הפקדה ברמת השירות. (אופציונלי) |
noShowFee |
הגדרת עמלה על אי-הצגה, שייתכן שתיגבה מהמשתמש. ההגדרה הזאת מבטלת את עמלת ההצגה של השירות אם צוינה אותה. אם מגדירים את ההגדרה כהודעת NoShowFee ריקה, כל העמלה על אי-הצגה ברמת השירות תוסר. (אופציונלי) |
requireCreditCard |
מציין אם המשתמש צריך לספק כרטיס אשראי כדי להזמין את השירות הזה. אפשר לבטל את השדה הזה ברמת הזמינות. (אופציונלי) |
actionLink[] |
קישור לפעולה שקשור לשירות הזה. אם קיים קישור לפעולה, חובה להגדיר בשירות את הסוג (ראו למטה). |
type |
הסוג המוגדר מראש של השירות הזה. (אופציונלי) |
ticketType[] |
סוגי הכרטיסים שאפשר להזמין או לרכוש במסגרת השירות הזה, אם יש תמיכה בכרטיסים. (אופציונלי) |
relatedMedia[] |
תמונות שקשורות לשירות הזה. Google תסרוק ותאחסן את המדיה כדי להבטיח שהיא תוצג למשתמשי הקצה בדרך היעילה ביותר. (אופציונלי) |
serviceAttributeValueId[] |
הערכים של מאפייני השירות שחלים על השירות הזה (אופציונלי). לכל שירות יכולים להיות אפס ערכים או יותר לכל מאפיין שירות שהוגדר אצל המוכר הרלוונטי. (אופציונלי) |
waitlistRules |
כללים להצטרפות לרשימת ההמתנה. |
ticketingVerticalSpecificData |
מידע נוסף הייחודי לקטגוריית הכרטיסים לאירועים. (אופציונלי) |
integrationType |
עומק השילוב שאנחנו תומכים בו במסגרת השירות הזה. (אופציונלי) לא רלוונטי לשותפים שיש להם שילוב של סימן לתחילת פעולה. ההגדרה 'קצה לקצה' תמיד תהיה מושבתת לשותפים האלה. |
perOrderFee |
עמלות ברמת ההזמנה על רכישת השירות הזה. (אופציונלי) |
toursAndActivitiesContent |
שדות תוכן שספציפיים לסיורים ולפעילויות. |
location[] |
מיקומים הקשורים לשירות הזה. הערות חשובות: אם ישנם מספר מיקומים שבהם ביקרת הקשורים לשירות זה, או ש-START_LOCATION שונה מ-VISITED_LOCATION, יש לציין את ה-START_LOCATION. דוגמה: סיור מודרך לרכיבה על אופניים שמבקר בשלושה מקומות, ויש לציין את נקודת ההתחלה. - פגישה של סיור באוטובוס בלובי של מלון, ולאחר מכן הגעה למקום שבו ביקרתם. צריך לציין את מיקום הפגישה. |
rating |
דירוג המשתמשים של השירות הזה כמדד מצטבר מתוך כל הביקורות. |
homeServiceData |
מידע נוסף הייחודי לקטגוריית השירותים הביתיים. (אופציונלי) |
virtualSession |
אפשרות. מידע על סשן וירטואלי. הוא נדרש לצורך הפעלת שירותים וירטואליים. |
directMerchantPayment |
אפשרות. מידע נוסף שצריך להוסיף אם השירות דורש מהמשתמש לשלם ישירות למוכר. הערה חשובה: RwG לא יהיה מעורב בעסקה הזו. הוא נדרש אם הווירטואליSession מוגדר והשירות אינו בחינם או ש-preorderType לא מוגדר כ-REQUIRED. |
PriceInterpretation
מתאר את האופן שבו יש לפרש ולהציג מחיר למשתמש.
טיפוסים בני מנייה (enums) | |
---|---|
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 ( |
שדות | |
---|---|
minAdvanceOnlineCanceling |
ההודעה מראש המינימלית, בשניות, שנדרשת לביטול פגישה שנקבעה אונליין. (אופציונלי) |
lateCancellationFee |
העמלה על ביטול במהלך התקופה המינימלית של ההודעה מראש. |
noshowFee |
התשלום על אי-הגעה ללא ביטול. |
admissionPolicy |
מדיניות הכניסה שחלה על השירות הזה. אם המדיניות לא מוגדרת, ברירת המחדל היא TIME_STRICT. (אופציונלי) |
cancellationPolicy |
מדיניות הביטול של כללי תזמון. (חובה ל'דברים שאפשר לעשות') |
שדה איחוד אם האפשרות "min_advance_booking" מוגדרת, השעה האחרונה שבה ניתן להזמין מחושבת באופן הבא (<שעת ההתחלה של המשבצת> - "min_advance_booking"). אם מוגדר הערך "min_booking_buffer_before_end_time", השעה האחרונה שבה ניתן להזמין תחושב כך: (<שעת סיום המשבצת> - "min_booking_buffer_before_end_time"). חשוב לשים לב שהערך של "min_booking_buffer_before_end_time" חייב להיות חיובי. אם שתי הכתובות לא מוגדרות, אפשר לשמור יחידת קיבולת (Slot) עד לשעת ההתחלה של יחידת הקיבולת. אם הגדרתם את שני השדות, רק ערך אחד ייבחר בזמן שהמערכת תתעלם מהערך השני – לא ניתן לחזות בצורה אמינה איזה ערך ייבחר. דוגמאות:
|
|
minAdvanceBooking |
משך הזמן (בשניות) מרגע ביצוע ההזמנה האחרונה ועד התחלת משבצת הזמינות. |
minBookingBufferBeforeEndTime |
משך הזמן (בשניות) ממועד ביצוע ההזמנה האחרונה ועד לסיום של משבצת הזמינות. אם השדה הזה מוגדר, יש להגדיר את השדה admissionPolicy כ-TIME_FLEXIBLE כדי לציין שמשתמשים יכולים להשתמש בכרטיסים שנרכשו לאחר תחילת משבצות הזמן. |
AdmissionPolicy
מדיניות הכניסה של השירות הזה.
טיפוסים בני מנייה (enums) | |
---|---|
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
מגדיר תנאי יחיד להחזר כספי. אפשר להשתמש בכמה תנאים להחזר כספי ביחד כדי לתאר את 'שלבי ההחזר הכספי' בתור פרקי זמן שונים לפני שעת ההתחלה של השירות.
ייצוג JSON |
---|
{ "minDurationBeforeStartTime": string, "refundPercent": integer } |
שדות | |
---|---|
minDurationBeforeStartTime |
התקופה לפני שעת ההתחלה, עד שהלקוח יוכל לקבל החזר כספי על חלק מעלות השירות שצוינה ב- משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, המסתיים ב-' |
refundPercent |
האחוז שניתן לקבל עליו החזר כספי, כל עוד הזמנת השירות בוטלה לפחות |
PrepaymentType
Enum כדי לציין את סוג התשלום מראש.
טיפוסים בני מנייה (enums) | |
---|---|
PREPAYMENT_TYPE_UNSPECIFIED |
כברירת מחדל, נניח שהתשלום מראש הוא NOT_SUPPORTED. |
REQUIRED |
המשתמש צריך לשלם על השירות הזה בזמן ההזמנה. |
OPTIONAL |
המשתמשים יכולים לבחור לשלם מראש על השירות הזה במועד ההזמנה או מאוחר יותר, אבל אין חובה לבצע את ההזמנה כדי להזמין. |
NOT_SUPPORTED |
התשלום מראש אינו נתמך עבור שירות זה. |
PrepaymentTerms
מידע ספציפי בנוגע להשלמת התשלום מראש.
ייצוג JSON |
---|
{
"chargeTiming": enum ( |
שדות | |
---|---|
chargeTiming |
מתי החיוב יתבצע ביחס לזמן הרכישה. |
chargeTimeBeforeStartTimeSec |
הזמן בשניות לפני שעת ההתחלה של השירות שבו המשתמש מחויב בתשלום. יש להגדיר את השדה הזה רק כאשר ChargeTiming הוא CHARGE_LATER. |
ChargeTiming
דוגמאות לציין מתי יתבצע החיוב ביחס לזמן הרכישה.
טיפוסים בני מנייה (enums) | |
---|---|
CHARGE_TIMING_UNSPECIFIED |
לא בשימוש. |
CHARGE_NOW |
הלקוח יחויב באופן מיידי. |
CHARGE_LATER |
הלקוח יחויב מאוחר יותר. |
ServiceIntakeForm
מגדיר טופס איסוף שמתאים אישית את השירות שהמוֹכר מספק.
ייצוג JSON |
---|
{
"field": [
{
object ( |
שדות | |
---|---|
field[] |
שדות שיוצגו למשתמש. |
firstTimeCustomers |
אם הערך הוא True, הטופס יוצג ללקוחות חדשים. הוּצא משימוש. הפונקציונליות הזו לא נתמכת בטופסי קבלה. |
returningCustomers |
אם הערך הוא True, הטופס יוצג ללקוחות חוזרים. הוּצא משימוש. הפונקציונליות הזו לא נתמכת בטופסי קבלה. |
ServiceIntakeFormField
מגדיר שדה שנכלל ב-ServiceIntakeForm.
ייצוג JSON |
---|
{ "id": string, "type": enum ( |
שדות | |
---|---|
id |
מחרוזת משותף אתר אגרגטור שמזהה שדה טופס באופן ייחודי. המזהה הזה צריך להיות זהה למזהה שמופיע בתשובה המתאימה בשדה הטופס, ועליו להיות ייחודי גם ברמת השירות וגם בטופס הזנת הפרטים של כל כרטיס. (חובה) |
type |
סוג השדה הזה. |
label |
הטקסט שיוצג למשתמש עבור השדה הזה. הוצא משימוש. במקומה יש להשתמש במדיניות |
localizedLabel |
הטקסט שיוצג למשתמש עבור השדה הזה. ניתן לספק את השדה במספר לוקאלים. (חובה) |
value[] |
מוגדר אם ורק אם סוג השדה הוא LOCATION_SEARCH. יש להשתמש ב-"locationId" בשדה "location" כדי לציין את הערך של המיקום. |
choiceText[] |
יש להגדיר רק אם סוג השדה הוא MULTIPLE_CHOICE, CHECKBOXES או DROPDOWN. משמש לספירת האפשרויות השונות. |
isRequired |
הערך הזה מציין אם המשתמש חייב לענות על השדה הזה. |
allowCustomAnswer |
מציינת אם מותר ערך מותאם אישית בנוסף לתשובות שהוגדרו מראש. הדבר ישים רק כאשר סוג השדה הוא LOCATION_SEARCH. (אופציונלי) |
additionalOption[] |
אפשרויות נוספות שסופקו בנוסף לערכים שסופקו. רלוונטי רק כאשר סוג השדה הוא LOCATION_SEARCH. למשל, בנוסף לרשימת המיקומים שצוינה, אפשרות זמינה נוספת יכולה להיות 'אצור קשר עם הספק מאוחר יותר'. (אופציונלי) |
ticketTypeRestrict[] |
אם צריך להציג את השאלה הזו רק כשהמשתמש מזמין סוגי כרטיסים מסוימים, צריך להגדיר את השדה הזה כקבוצת המזהים של סוגי הכרטיסים הרלוונטיים. אם השאלה רלוונטית תמיד, יש להשאיר את השדה ריק. |
hint |
הטקסט של הרמז לקלט, שמופיע כ-placeholder של טקסט. הדבר רלוונטי רק כאשר סוג השדה הוא Short_ANSWER או PARAGRAPH. (אופציונלי) |
FieldType
טיפוסים בני מנייה (Enum) לציון סוג השדה.
טיפוסים בני מנייה (enums) | |
---|---|
FIELD_TYPE_UNSPECIFIED |
המערכת תתעלם משדות מסוג שלא צוין או לא ידוע. |
SHORT_ANSWER |
שדה להזנת טקסט עם שורה אחת. |
PARAGRAPH |
שדה להזנת טקסט עם מספר שורות. |
MULTIPLE_CHOICE |
קבוצת לחצני בחירה שמחייבת בחירה אחת מתוך אפשרויות רבות. |
CHECKBOXES |
פריט אחד או יותר ממוספר עם תיבות סימון. |
DROPDOWN |
בחירה מתוך תפריט נפתח. |
BOOLEAN |
לחצן כן/לא. |
LOCATION_SEARCH |
תיבת חיפוש שתומכת באיתור מיקום תואם על סמך קלט של משתמש מרשימת המיקומים שסופקה. |
ServiceType
סוגי שירות מוגדרים מראש
טיפוסים בני מנייה (enums) | |
---|---|
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 ( |
שדות | |
---|---|
ticketTypeId |
מזהה הכרטיס משמש להבחנה בין סוגי כרטיסים שונים של אותו שירות, והוא צפוי להיות ייחודי רק בתוך שירות. |
shortDescription |
תיאור קצר של TicketType הזה. האתר יכול להיות גלוי למשתמש, לדוגמה, "מבוגרים", "ילד", "ותי", "שורה J" וכו'. חובה, לכל סוג כרטיס צריך להיות תיאור שיוצג למשתמשים. הוצא משימוש. במקומו צריך להשתמש ב-localizedShortDescription. |
localizedShortDescription |
תיאור קצר של TicketType בתמיכה ב-i18n. האתר יכול להיות גלוי למשתמש, לדוגמה, "מבוגרים", "ילד", "ותי", "שורה J" וכו'. חובה, לכל סוג כרטיס צריך להיות תיאור שיוצג למשתמשים. ניתן לספק ערכים נפרדים לכל מקום. |
price |
המחיר של כרטיס יחיד מהסוג הזה, לא כולל מיסים. שיעור המס על השירות חל על הכרטיסים שלו. |
perTicketFee |
עמלות נוספות לרכישת הכרטיס הזה. (אופציונלי) |
optionDescription |
תיאור של כל אפשרות נוספת שסוג הכרטיס הזה מייצג, אם יש. הוצא משימוש. במקומה יש להשתמש ב-localizedOptionDescription. |
localizedOptionDescription |
תיאור של כל אפשרות נוספת שסוג הכרטיס הזה מייצג, אם יש. ניתן לספק ערכים נפרדים לכל מקום. אפשרויות נוספות יכולות להיות שימושיות כאשר סוג הכרטיס מייצג כמה מאפיינים. Example 1: a admission card with different types 'adult', 'child' and language as an additional option, the צפוי TicketType list יהיה: - {ticketTypeId: "ticket_type_1" localizedShortDescription { value: "adult" } localizedOptionDescription { value: "english" } } - {ticketTypeId: "adult_type_Description_2" } דוגמה 2: "ticket_width-OptionId {ticket' localized-option } "ticket_Option {/2} " > "כרטיסים_לתיאור_כרטיסים" } ": תוכל localized_Option } "ticket_Edit } " Ticket_Option _ לעצור } אופציונלי, אבל אם השדה הזה מוגדר עבור סוג כרטיס כלשהו בשירות, אנחנו מצפים שהשדה הזה יוגדר גם בכל סוגי הכרטיסים האחרים (ניתן להשתמש באפשרות 'תיאור' המוגדרת כברירת מחדל). לדוגמה: [{ticket_type_1, adult, english}, {ticket_type_1, adult, ''}] אינה רשימה תקינה. רק שני תגי עיצוב של HTML נתמכים: ו- |
PerTicketFee
העמלות שצריך לשלם עבור כל כרטיס שהמשתמש קונה.
ייצוג JSON |
---|
{ "serviceCharge": { object ( |
שדות | |
---|---|
serviceCharge |
הערכה של חיוב נוסף עבור שירות. |
facilityFee |
התשלום מועבר למקום או למתקן. |
taxes |
לפי מיסי כרטיס. |
RelatedMedia
תמונות שקשורות לשירות הזה. Google תסרוק את פריטי המדיה האלה כדי להבטיח שהם יוצגו כראוי למשתמשי הקצה. (אופציונלי)
ייצוג JSON |
---|
{ "url": string, "type": enum ( |
שדות | |
---|---|
url |
כתובת ה-URL של מקור המדיה הזה. Google תסרוק את המדיה שמתארחת בכתובת ה-URL הזו. |
type |
הסוג של מקור המדיה הזה. |
localizedCaption |
כתוביות של המדיה התומכת ב-i18n. ניתן להשתמש רק בטקסט פשוט. כל רכיבי ה-HTML יוסרו. (אופציונלי) |
attribution |
פרטי ייחוס של מקור המדיה. לתשומת ליבכם: אם יש דרישה להציג את השיוך עם המדיה כדי לתת קרדיט לצלם או לסוכנות, יש להגדיר את השדה הזה. (אופציונלי) |
caption |
הוצא משימוש. עדיף להשתמש בכיתוב localizedCaption. |
MediaType
טיפוסים בני מנייה (enum) לציון הסוג של מקור המדיה הזה. יש תמיכה רק בתמונות. אם יש צורך לתמוך במדיה אחרת מלבד תמונות, יש לפנות לצוות של 'Google הזמנת מקומות'.
טיפוסים בני מנייה (enums) | |
---|---|
TYPE_UNSPECIFIED |
לא בשימוש. |
PHOTO |
מציין שהמדיה שסופקה על ידי כתובת האתר היא תמונה. |
שיוך (Attribution)
פרטי השיוך של המדיה הזו.
ייצוג JSON |
---|
{
"localizedText": {
object ( |
שדות | |
---|---|
localizedText |
הטקסט שיש לתת קרדיט לצלם או לסוכנות התומכים ב-i18n. הטקסט הזה יוצג יחד עם מדיית המקור. הערה: השדה הזה תומך בטקסט פשוט בלבד. רכיבי HTML יוסרו (אין תמיכה בייחוס המבוסס על היפר-קישור). |
text |
הוצא משימוש. עדיף להשתמש ב-localizedText. |
ServiceAttributeValueId
מזהה ערך מסוים של מאפיין שירות שיש להחיל על שירות.
ייצוג JSON |
---|
{ "attributeId": string, "valueId": string } |
שדות | |
---|---|
attributeId |
מזהה של מאפיין כפי שמוגדר ב-Merchant.service_attribute, למשל "service-type". |
valueId |
המזהה של הערך במאפיין הזה. למשל, 'תסרוקת'. חייב להתאים ל-valueId בהגדרת מאפיין השירות. |
WaitlistRules
כללים שקשורים להצטרפות לרשימת ההמתנה.
ייצוג JSON |
---|
{
"minPartySize": integer,
"maxPartySize": integer,
"supportsAdditionalRequest": boolean,
"aboveMaxPartySizeOptions": [
{
object ( |
שדות | |
---|---|
minPartySize |
חובה. צריך להיות מספר שלם חיובי לשירותים שמספקים פונקציונליות של רשימת המתנה. אם השירות או המוכר לא מספקים פונקציונליות של רשימת המתנה, אי אפשר לאכלס אותה. |
maxPartySize |
חובה. צריך להיות מספר שלם חיובי לשירותים שמספקים פונקציונליות של רשימת המתנה. אם השירות או המוכר לא מספקים פונקציונליות של רשימת המתנה, אי אפשר לאכלס אותה. |
supportsAdditionalRequest |
אם הערך הוא True, המשתמש יוכל לשלוח בקשה בטקסט נוסף בניסוח חופשי בעת ההצטרפות לרשימת ההמתנה של השירות הזה. |
aboveMaxPartySizeOptions[] |
אפשר להגדיר אפשרויות לצדדים שגדולים מהערך שהוגדר ב-maxPartySize. אם לא רוצים לספק למפלגות גדולות יותר אפשרויות להצטרפות לרשימת המתנה, יש להשאיר את השדה ריק. |
UnsupportedPartySizeOption
אפשרויות למסיבות שנמצאות מחוץ לטווח.
ייצוג JSON |
---|
{
"callMerchant": {
object ( |
שדות | |
---|---|
callMerchant |
אם המספר לא תואם את קהל היעד, יכולים להתקשר לעסק. תוצג למשתמש הודעה מוגדרת מראש. טקסט לדוגמה שיוצג: "למסיבות שגדולות מ-{waitlistRules.max_party_size}, להתקשר למסעדה בטלפון {phone}". יש להגדיר את CallMerchant, אבל הוא יהיה ריק. |
CallMerchant
הודעה ריקה שתופיע ב-supportedPartySizeOption. הגדרה זו תציג למשתמשים אפשרות להתקשר לעסק לצורך הזמנה.
TicketingVerticalSpecificData
מידע נוסף הייחודי לקטגוריית הכרטיסים לאירועים.
ייצוג JSON |
---|
{ "eventCategory": enum ( |
שדות | |
---|---|
eventCategory |
קטגוריית האירוע. מוגדר רק כאשר האירוע משתייך לאחת מהקטגוריות המוגדרות מראש. (אופציונלי) |
eventUrl |
כתובת ה-URL של האירוע באתר של השותף. (אופציונלי) |
entity[] |
רשימת ישויות שקשורות לאירוע. (אופציונלי) |
eventAttendanceMode |
חובה. סוג הנוכחות באירוע. |
eventVirtualLocationUrl[] |
אפשרות. כתובת ה-URL שבה ניתן לצפות באירוע. |
eventOrganizer |
אפשרות. המארגן שמארח את האירוע. |
eventOrganizerUrl |
אפשרות. כתובת ה-URL של המארגן שמארח את האירוע. |
eventOrganizerType |
אפשרות. סוג המארגן. |
eventSourceUrl[] |
חובה. כתובות ה-URL של הדפים שבהם ניתן למצוא את פרטי האירוע או את תיאורי האירוע. |
eventState |
אפשרות. מצב האירוע. |
EventCategory
קבוצת משנה של קטגוריות אירועים שעבורן אנחנו מתאימים אישית את חוויית המוצר. הערה: לא מיועדת להיות אונטולוגיה אוניברסלית של אירועים.
טיפוסים בני מנייה (enums) | |
---|---|
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 ( |
שדות | |
---|---|
id |
המזהה הייחודי של הישות במסד הנתונים של השותף. (אופציונלי) |
name |
שם הישות. (חובה) |
url |
כתובת ה-URL של דף האינטרנט שמתאר את הישות באופן חד-משמעי. זהו דף האינטרנט באתר של השותף של הישות, אם יש כזו. בכתובות URL ציבוריות אחרות של הישות, צריך להשתמש ב- relevantUrl ב-publicIdentificationData. (אופציונלי) |
entityType |
סוג הישות. (אופציונלי) |
entityRole |
תפקיד הישות באירוע. (אופציונלי) |
publicIdentificationData |
הפניות ציבוריות של הישות. (אופציונלי) |
EntityType
סוג הישות. הערה: לא מיועדת להיות אונטולוגיה אוניברסלית.
טיפוסים בני מנייה (enums) | |
---|---|
ENTITY_TYPE_UNSPECIFIED |
לא צוין. אין להשתמש בו. |
ENTITY_TYPE_PERFORMER |
הישות מייצגת את האומן או את הקבוצה שמופיעים בהופעה או במופע. רלוונטי רק כשקטגוריית האירוע היא 'הופעה' או 'תיאטרון'. |
ENTITY_TYPE_PLAYER |
היישות מייצגת את קבוצת הספורט או את שחקן הספורט באירוע. רלוונטי רק כאשר קטגוריית האירוע היא SPORTS. |
ENTITY_TYPE_CONCERT_TOUR |
הישות מייצגת את הסיור שהאירוע הזה שייך אליו. רלוונטי רק כשקטגוריית האירוע היא CONCERT. |
ENTITY_TYPE_SPORTS_SERIES |
הישות מייצגת טורניר ספורט שהאירוע הזה שייך אליו. רלוונטי רק כאשר קטגוריית האירוע היא SPORTS. |
ENTITY_TYPE_PLAY |
הישות מייצגת את סוג ההצגה (למשל, מחזמר, קומדיה, בלט וכו') שמבוצע באירוע. רלוונטי רק כאשר קטגוריית האירוע היא 'theATRE'. |
EntityRole
תפקיד הישות באירוע.
טיפוסים בני מנייה (enums) | |
---|---|
ENTITY_ROLE_UNSPECIFIED |
לא צוין. |
ENTITY_ROLE_HEADLINER |
היישות מייצגת כוכבת ראשית או אומן מוביל באירוע. |
ENTITY_ROLE_SUPPORTER |
הישות מייצגת אמן שמבצע תמיכה באירוע. |
ENTITY_ROLE_HOME_TEAM |
הישות מייצגת את הקבוצה הביתית באירוע (ספורט). |
ENTITY_ROLE_AWAY_TEAM |
הישות מייצגת את קבוצת השחקנים מחוץ לאירוע באירוע (ספורט). |
PublicIdentificationData
מזהים, דפי אינטרנט או כל מקור ציבורי אחר המתייחס לישות.
ייצוג JSON |
---|
{ "relevantUrl": [ string ], "musicbrainzId": string } |
שדות | |
---|---|
relevantUrl[] |
כתובת URL ציבורית של כל דף אינטרנט שמוקדש לנושא בלבד. דוגמאות לאתרים רשמיים, דפי דיסקוגים, פלטפורמות של רשתות חברתיות, דפי ויקיפדיה או imdb, לדוגמה: https://www.discogs.com/artist/1124645-Taylor-Swift, https://www.wikidata.org/wiki/Q19320959, https://twitter.com/acmilan. (אופציונלי) |
musicbrainzId |
מזהה musicbrainz באורך 36 תווים של האומן או של ישויות מוזיקה אחרות, אם רלוונטי. פרטים נוספים זמינים בכתובת https://musicbrainz.org/doc/MusicBrainz_Identifier. (אופציונלי) |
AttendanceMode
סוג הנוכחות באירוע.
טיפוסים בני מנייה (enums) | |
---|---|
ATTENDANCE_MODE_UNSPECIFIED |
לא צוין. |
ONLINE |
לאירועים וירטואליים. |
PHYSICAL |
לאירועים פיזיים. |
PHYSICAL_ONLINE_MIXED |
לאירועים שהם פיזיים וגם וירטואליים. |
OrganizerType
סוג המארגן.
טיפוסים בני מנייה (enums) | |
---|---|
ORGANIZER_TYPE_UNSPECIFIED |
לא צוין. |
PERSON |
מיועד למארגן שהוא אדם. |
ORGANIZATION |
מיועד למארגן שהוא ארגון. |
EventState
מצב האירוע.
טיפוסים בני מנייה (enums) | |
---|---|
EVENT_STATE_UNSPECIFIED |
לא צוין. |
SCHEDULED |
האירוע נקבע. |
RESCHEDULED |
לאירוע נקבע מחדש. |
CANCELLED |
האירוע בוטל. |
POSTPONED |
האירוע נדחה. |
IntegrationType
יש תמיכה בעומק השילוב.
טיפוסים בני מנייה (enums) | |
---|---|
INTEGRATION_TYPE_UNSPECIFIED |
ברירת המחדל היא END_TO_END. |
INTEGRATION_TYPE_END_TO_END |
יש להשלים את השילוב שמאפשר הזמנה מקצה לקצה דרך Google. |
INTEGRATION_TYPE_INVENTORY_ONLY |
שרת ההזמנות לא צריך לתמוך בשירות הזה. צריך לשלוח רק מוכרים, שירותים ונתוני זמינות (אופציונלי). |
PerOrderFee
עמלות שצריך לשלם פעם אחת לכל הזמנה, ללא קשר למספר הכרטיסים.
ייצוג JSON |
---|
{ "deliveryFee": { object ( |
שדות | |
---|---|
deliveryFee |
עמלה שיכולה להשתנות בהתאם לשיטת המשלוח. |
processingFee |
עמלה בגין עיבוד אמצעי התשלום של המשתמש. |
ToursAndActivitiesContent
שדות תוכן שספציפיים לסיורים ולפעילויות. כל רכיב בשדה החוזר צריך להיות עצמאי כדי לאפשר עיבוד נפרד (למשל, בתור נקודת תבליט).
מומלץ מאוד לאכלס סיורים ופעילויות ב-ToursAndactiveitiesContent, אבל לא חובה לעשות זאת בצורה מחמירה. כל השדות תומכים בטקסט פשוט וגם בטקסט דמוי-HTML לעיצוב בסיסי. תגי עיצוב נתמכים דמויי HTML:
תגי ביטוי:
, , , : רק שלושת התגים שהוזכרו למעלה נתמכים. אפשר להשתמש ב
כדי לשבור שורות בפסקאות, ובעזרת // להדגיש טקסט חשוב. המערכת תתעלם מתגי ביטויים אחרים.
כל שאר התגים והסגנונות המותאמים אישית אסורים והם יוסרו. כל כתובות ה-URL, העוגן והקישורים יוסרו, ואף פעם לא יוצגו למשתמשי קצה.
הערות חשובות: * אין לשכפל נתונים שכבר סופקו ב-highlights
, exclusion
ובשדות אחרים וספציפיים יותר בתיאור השירות. * אין להשתמש בתגים אחרים מלבד אלו שנתמכים שצוינו למעלה, כי התוכן שבתוך התגים שאינם נתמכים יוסר מהזיכרון, ויכול להיות שחוויית המשתמש תהיה בלתי רצויה.
ייצוג JSON |
---|
{ "highlights": [ { object ( |
שדות | |
---|---|
highlights[] |
רשימת הדגשות שגלויות למשתמשים. |
inclusions[] |
רשימת ההכללות הגלויות למשתמש. |
exclusions[] |
רשימת ההחרגות הגלויה למשתמשים. |
mustKnow[] |
רשימה גלויה למשתמש של הערות חשובות. היא משמשת לפרטים כמו הגבלות גיל או תנאים אחרים שבגללם השירות הזה לא מתאים. |
מיקום
מידע גיאוגרפי על מיקום מסוים.
ייצוג JSON |
---|
{ "placeId": string, "name": string, "telephone": string, "url": string, "geo": { object ( |
שדות | |
---|---|
placeId |
מזהה המקום של מקום מסוים במסד הנתונים של מקומות Google ובמפות Google. מידע נוסף על מזהי מקומות זמין בכתובת https://developers.google.com/places/web-service/place-id. אם תספקו את הפרטים האלה, Google תתאים את המיקום למקום הזה. |
name |
השם, מספר הטלפון, כתובת ה-URL והמיקום הגיאוגרפי של המיקום משמשים לתמיכה בהתאמת המיקום למקומות שכבר נמצאים במפות Google. השדה הזה הוא אופציונלי, אבל יכול להיות שהוא נדרש בהקשרים מסוימים. לדוגמה, Service.location ללא שם לא יותאם לישות עסקית, גם אם הם ממוקמים באותה כתובת. (אופציונלי) |
telephone |
מספר הטלפון הציבורי של המיקום, כולל קידומת המדינה והאזור, למשל +14567891234. (אופציונלי) |
url |
כתובת האתר הציבורי של המיקום. (אופציונלי) |
geo |
המידע הגיאוגרפי של המיקום, כולל קו רוחב, קו אורך וכתובת. (אופציונלי) |
locationType |
אם המיקום הזה סופק עבור שירות, יש לספק את סוג המיקום. |
locationId |
הפניה ייחודית של המיקום בתוך השירות. המזהה הזה יכול לשמש לאזכור המיקום הזה בשדות שירות אחרים. למשל, בטופס קליטת הנתונים המותאם אישית, אפשר להשתמש בקבוצה של מזהי מיקומים כדי לציין אפשרויות של מיקום איסוף. אם מגדירים את המזהה, המזהה צריך להיות ייחודי באותו שירות. (אופציונלי) |
LocationType
הסוג של המיקום הזה.
טיפוסים בני מנייה (enums) | |
---|---|
LOCATION_TYPE_UNSPECIFIED |
לא צוין סוג מיקום. |
VISITED_LOCATION |
המיקום שבו השירות יכול לבקר. |
START_LOCATION |
המיקום שבו השירות מתחיל משמש גם כ-MEETING_LOCATION. |
END_LOCATION |
המיקום שבו השירות הזה מסתיים. |
Rating
הגדרת דירוג לישות.
ייצוג JSON |
---|
{ "value": number, "numberOfRatings": string } |
שדות | |
---|---|
value |
ערך הדירוג הממוצע (נדרש כאשר numberOfRatings > 0). הערך חייב להיות בטווח של [1, 5] וניתן להשמיט אותו אם ורק אם numberOfRatings הוא אפס. |
numberOfRatings |
מספר הדירוגים שמשמשים לחישוב הערך (חובה). |
HomeServiceData
מידע נוסף שנדרש כדי לספק עבור התעשייה של שירות ביתי.
ייצוג JSON |
---|
{ "categoryType": string, "jobType": string } |
שדות | |
---|---|
categoryType |
הקטגוריה ברמה הגבוהה שאליה שייך השירות הביתי הזה. למשל, שרברבים, חשמלאים וכו' |
jobType |
סוג העבודה בקטגוריה שאליה שייך השירות הביתי הנתון. לדוגמה, unclog_drain, install_faucet הם סוגי העבודות בקטגוריה 'שרברב'. |
VirtualSession
מידע על סשן וירטואלי או אונליין. למשל, שיעור יוגה באינטרנט, שיעור בישול וירטואלי וכו'.
ייצוג JSON |
---|
{ "sessionInstructions": { object ( |
שדות | |
---|---|
sessionInstructions |
הוראות להגדרה של הכיתה הווירטואלית. אם השותף לא מוסיף להזמנה את כתובת ה-URL של הסרטון, הוא צריך לכלול את המועד שבו כתובת ה-URL של הסרטון תשותף עם המשתמש. דוגמה "כתובת ה-URL של Zoom תישלח 30 דקות לפני השיעור". (מומלץ) |
sessionRequirements |
הדרישות לסשן הווירטואלי הנתון. לדוגמה, מזרן יוגה, כלי בישול וכו' (מומלץ) |
virtualPlatformInfo |
מידע על הפלטפורמה הווירטואלית שנעשה בה שימוש בסשן הזה. (נדרש להפעלת שירותים וירטואליים) |
isSessionPrerecorded |
חובה. יש להגדיר את הערך הזה כ-True אם הסשן הווירטואלי לא בשידור חי ומוקלט מראש. |
VirtualPlatformInfo
מידע על הפלטפורמה שתשמש בסשן הווירטואלי הזה.
ייצוג JSON |
---|
{ "platform": enum ( |
שדות | |
---|---|
platform |
פלטפורמה שמשמשת לסשן וירטואלי. |
otherPlatformName |
שם הפלטפורמה אם ההגדרה של הפלטפורמה היא OTHER. (חובה אם הפלטפורמה מוגדרת כ-OTHER) |
הפלטפורמה
טיפוסים בני מנייה (enum) לציון הפלטפורמה הווירטואלית שהמוכר ישתמש בה.
טיפוסים בני מנייה (enums) | |
---|---|
PLATFORM_UNSPECIFIED |
לא בשימוש. |
FLEXIBLE |
המוכר מציע גמישות רבה באיזו פלטפורמת וידאו הוא משתמש. |
GOOGLE_HANGOUTS |
המוצר Google Hangouts. |
GOOGLE_MEET |
מוצר של Google Meet. |
ZOOM |
תקשורת וידאו ב-Zoom. |
SKYPE |
Skype. |
YOUTUBE |
סטרימינג בשידור חי ב-YouTube. |
OTHER |
צריך להגדיר אם פלטפורמת הסרטון שבה נעשה שימוש שונה מאלה שצוינו כאן. |
DirectMerchantPayment
מידע על האופן שבו המשתמש יכול לשלם ישירות למוכר במקום לשלם מראש על השירות דרך RwG.
ייצוג JSON |
---|
{
"paymentMethods": [
{
object ( |
שדות | |
---|---|
paymentMethods[] |
המשתמשים יומלצו לשלם רק באמצעות אמצעי התשלום המפורטים בהמשך. |
שיטות |
|
---|---|
|
הפונקציה יוצרת Service חדש של מוכר שמנוהל על ידי אתר האגרגטור שצוין ומחזירה אותו. |
|
מחיקת Service קיים של מוכר שמנוהל על ידי אתר האגרגטור שצוין. |
|
עדכון Service קיים של מוכר שמנוהל על ידי אתר האגרגטור שצוין ומחזיר אותו. |