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>Itinerary</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)

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

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

object (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)

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

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

דוגמאות: ‫20$ לשיעור יוגה; 15$ לתספורת לילד
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' מוגדר, השעה האחרונה שבה אפשר להזמין מחושבת כך: (<שעת ההתחלה של משבצת הזמן> – 'min_advance_booking'). אם הערך של 'min_booking_buffer_before_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)
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)

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

תיאור קצר של סוג הכרטיס.

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

object (Text)

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

התיאור יכול להיות גלוי למשתמשים, למשל: 'מבוגר', 'ילד', 'חייל משוחרר', 'שורה י' וכו'. חובה לציין תיאור לכל סוג כרטיס שיהיה גלוי למשתמשים. אפשר לספק ערכים נפרדים לכל לוקאל.
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: השכרת קיאק למספר שעות עם אפשרות להוסיף תיק אטום למים. הערך של מאפיין localizedShortDescription יכול להיות '3 שעות', והערך של מאפיין localizedOptionDescription יכול להיות 'עם תיק אטום למים' או 'בלי תיק אטום למים': ‪- { 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: ‏ ו-
. הם מיועדים לציון אפשרויות עם שם ותיאור מפורט, למשל: מושבים מובחרים
האפשרות הזו כוללת מושבים בתאים פרטיים עם ריפוד מלא, טלוויזיות פרטיות ושירות הזמנת אוכל ושתייה למושב. המושבים האלה מספקים נוף ציורי של המגרש".
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 מלאי של אתר אגרגטור. אגרגטור (לדוגמה, www.bandsintown.com) – השותף מספק מידע על אירועים וכרטיסים. אבל השותף לא מוכר את הכרטיסים ישירות. המוכר בפועל של הכרטיסים יכול להיות ספק ראשי, מוכר מאומת של כרטיסים מיד שנייה או מוכר של כרטיסים מיד שנייה. מעכשיו אנחנו מבחינים רק בין סוגי מלאי של שותפים ברמה העליונה, ומתעלמים מסוג המלאי של מוכר הכרטיסים בפועל באתר אגרגטור.

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

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

string

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

WaitlistRules

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

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

integer

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

integer

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

boolean

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

object (UnsupportedPartySizeOption)

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

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)

קבוצות עם מספר אנשים שלא נמצא בטווח יכולות להתקשר לעסק. הודעה מוגדרת מראש תוצג למשתמש. טקסט לדוגמה שיוצג: "להזמנות של יותר מ-{waitlistRules.max_party_size} סועדים, צריך להתקשר למסעדה במספר {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 הישות מייצגת את האומן או את הקבוצה שמופיעים בקונצרט או במופע. המאפיין הזה רלוונטי רק אם קטגוריית האירוע היא CONCERT או THEATRE.
ENTITY_TYPE_PLAYER הישות מייצגת את קבוצת הספורט או את השחקן באירוע. ההגדרה הזו רלוונטית רק אם קטגוריית האירוע היא ספורט.
ENTITY_TYPE_CONCERT_TOUR הישות מייצגת את הסיור שהאירוע הזה שייך אליו. ההגדרה הזו רלוונטית רק אם קטגוריית האירוע היא CONCERT.
ENTITY_TYPE_SPORTS_SERIES הישות מייצגת טורניר ספורט שהאירוע הזה שייך אליו. ההגדרה הזו רלוונטית רק אם קטגוריית האירוע היא ספורט.
ENTITY_TYPE_PLAY הישות מייצגת את סוג ההצגה (למשל, מחזמר, קומדיה, בלט וכו') שמוצגת באירוע. התכונה הזו רלוונטית רק אם קטגוריית האירוע היא THEATRE.

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, בפלטפורמות של מדיה חברתית, בדפים של ויקיפדיה או ב-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. (חובה אם הפלטפורמה מוגדרת כ-OTHER)

פלטפורמה

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

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

DirectMerchantPayment

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

ייצוג ב-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. הפרמטרים האלה יומרו לערכים שצוינו בישויות המתאימות.

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

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