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)
  },
  "uriTemplate": {
    object (UriTemplate)
  }
}
שדות
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>:
יש תמיכה רק בשלושת התגים שצוינו למעלה. אפשר להשתמש ב-<br> כדי להפריד בין שורות בפסקה, וב-<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)

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

string

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

object (Deposit)

הגדרה של אופן החיוב של המשתמש על הפיקדון. מבטלים את הפיקדון על השירות, אם צוין פיקדון כזה. הגדרה של הודעה ריקה בשדה 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 לא תהיה מעורבת בעסקה הזו. השדה הזה נדרש אם המאפיין virtualSession מוגדר והשירות לא בחינם, או אם הערך של prepaymentType לא מוגדר כ-REQUIRED.
uriTemplate

object (UriTemplate)

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

PriceInterpretation

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

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

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

דוגמאות: 80 ש"ח לשיעור יוגה, 60 ש"ח לחיתוך שיער של ילד
STARTS_AT

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

הערה: כל שירות שמשתמש ב-PriceInterpretation הזה חייב להשתמש ב-PrepaymentType‏ NOT_SUPPORTED.

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

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

לתשומת ליבכם: כל שירות שמשתמש ב-PriceInterpretation הזה חייב להשתמש ב-PrepaymentType NOT_SUPPORTED והשדה Price חייב להיות ריק.

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

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', הוא חייב להיות חיובי. אם לא תגדירו את שני הערכים, אפשר יהיה להזמין את המועד עד לזמן ההתחלה שלו. אם שני השדות מוגדרים, המערכת תבחר רק ערך אחד ותתעלם מהערך השני. אין לנו אפשרות לחזות איזה ערך ייבחרו.

דוגמאות:

  • תספורת שצריך לקבוע לה תור לפחות שעה אחת לפני שעת ההתחלה. 'scheduling_rules{ min_advance_booking: 3600 ...}`

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

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

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

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)
  },
  "priceDisplayType": enum (PriceDisplayType),
  "optionDescription": string,
  "localizedOptionDescription": {
    object (Text)
  },
  "inventoryType": enum (InventoryType)
}
שדות
ticketTypeId

string

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

string

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

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

object (Text)

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

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

object (Price)

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

object (PerTicketFee)

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

enum (PriceDisplayType)

זה שינוי אופציונלי. סוג תצוגה מוגדר מראש של מחיר של כרטיס יחיד מהסוג הזה.
optionDescription

string

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

object (Text)

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

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

דוגמה 1: כרטיס כניסה עם סוגים שונים 'adult',‏ 'child' ושפה כאפשרות נוספת, רשימת TicketType הצפויה תהיה: - { 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: ו-
. הם מיועדים לציון אפשרויות עם שם ועם תיאור מפורט, לדוגמה: 'Premium Seating
האפשרות הזו כוללת מושבים בתיבת VIP, כולל מושבים מרופדים, טלוויזיות פרטיות, שירות אוכל ומשקאות במושב. מהמושבים האלה נשקפים נופים ציוריים של המגרש".
inventoryType

enum (InventoryType)

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

PerTicketFee

עמלות שצריך לשלם על כל כרטיס שהמשתמש רוכש.

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

object (Price)

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

object (Price)

עמלה שמיועדת למיקום או למתקן.
taxes

object (Price)

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

PriceDisplayType

הפורמט של המחיר שמוצג בדף הנחיתה.

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

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

טיפוסים בני מנייה (enum)
PRICE_DISPLAY_TYPE_UNSPECIFIED לא צוין סוג התצוגה של המחיר. Google תקבע איזה פורמט יוצג.
PRICE_DISPLAY_TYPE_BASE המחיר שמוצג בדף הנחיתה הוא מחיר הבסיס.
PRICE_DISPLAY_TYPE_ALL_IN המחיר שמוצג בדף הנחיתה כולל את כל העמלות והמיסים.

InventoryType

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

טיפוסים בני מנייה (enum)
INVENTORY_TYPE_UNSPECIFIED לא צוין סוג המלאי.
INVENTORY_TYPE_PRIMARY מלאי ראשי.
INVENTORY_TYPE_VERIFIED_RESALE מלאי מאומת למכירה חוזרת.
INVENTORY_TYPE_RESALE מלאי למכירה חוזרת.
INVENTORY_TYPE_AGGREGATOR מלאי של אתר אגרגטור.

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)

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

object (Attribution)

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

string

הוצא משימוש. מומלץ להשתמש ב-localizedCaption.

MediaType

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

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

שיוך (Attribution)

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

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

object (Text)

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

string

הוצא משימוש. מומלץ להשתמש ב-localizedText.

ServiceAttributeValueId

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

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

string

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

string

המזהה של הערך של המאפיין הזה, למשל 'haircut'. צריך להתאים ל-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 
{

  // Union field kind can be only one of the following:
  "callMerchant": {
    object (CallMerchant)
  }
  // End of list of possible types for union field kind.
}
שדות
שדה האיחוד kind. האפשרויות הזמינות לשיחות עם משתתפים מחוץ לטווח. הערך של kind יכול להיות רק אחת מהאפשרויות הבאות:
callMerchant

object (CallMerchant)

קבוצות גדולות יותר יכולות להתקשר לעסק. תוצג למשתמש הודעה מוגדרת מראש. טקסט לדוגמה שיוצג: "For parties larger than {waitlistRules.max_party_size} please call the restaurant at {phone}". צריך להגדיר את CallMerchant, אבל הוא יהיה ריק.

CallMerchant

אין שדות לסוג הזה.

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

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),
  "brandName": {
    object (Text)
  },
  "eventCreator": {
    object (EventCreator)
  }
}
שדות
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)

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

object (Text)

זה שינוי אופציונלי. שם המותג המותאם לשוק המקומי.
eventCreator

object (EventCreator)

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

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

EventCreator

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

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

string

זה שינוי אופציונלי. השם של יוצר האירוע. אין הגבלת תווים.

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

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

מומלץ מאוד לאכלס את הנכס ToursAndActivitiesContent עבור סיורים ופעילויות, אבל זה לא חובה. כל השדות תומכים בטקסט פשוט ובטקסט שדומה ל-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 המיקום שבו השירות מסתיים.

דירוג

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

ייצוג ב-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 הם סוגי המשימות בקטגוריה plumber.

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)

פלטפורמה

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

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

DirectMerchantPayment

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

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

object (Text)

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

UriTemplate

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

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

string

זה שינוי אופציונלי. תבנית ה-URI חייבת לעמוד בדרישות של RFC6570. אפשר לקרוא על כך במאמר https://datatracker.ietf.org/doc/html/rfc6570. תמיכה בתבניות ברמה 2. הפרמטרים האלה ימולאו בערכים שצוינו בישויות המתאימות.

5 הפרמטרים הזמינים להפניה ישירה להזמנת מקום במסעדה: 1) (חובה) {availability_slot_start_seconds} :: מאוכלס מהשדה startSec בפיד הזמינות 2) (חובה) {availability_slot_duration_seconds} :: מאוכלס מהשדה durationSec בפיד הזמינות 3) (אופציונלי) {resources_party_size} :: מאוכלס מהשדה partySize בפיד הזמינות 4) (אופציונלי) {availability_availability_tag} :: מאוכלס מהשדה availabilityTag בפיד הזמינות 5) (אופציונלי) {resources_room_id} :: מאוכלס מהשדה roomId בפיד הזמינות

דוגמה לשימוש: http://example.com/book/restaurant?start={availability_slot_start_seconds} &num_guests={resources_party_size} * startSec = 123456 * partySize = 2 https://example.com/book/restaurant?start=123456&num_guests=2

Methods

create

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

delete

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

patch

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