REST Resource: inventory.partners.merchants.services

משאב: שירות

מידע על שירות שניתן על ידי המוכר, למשל תספורת.

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

string

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

string

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

object (Text)

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

string

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

object (Text)

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

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

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

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

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

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

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

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

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

  • אין להשתמש בתגים <html>, <header> ו-<body>.
  • תגים אחרים שלא צוינו למעלה אינם נתמכים (לדוגמה <table>, <td> ...).
    כתובות אתרים, עוגנים וקישורים יוסרו ואף פעם לא יוצגו למשתמשי קצה. רוצה להשתמש בתמונות כדי ליצור חוויית משתמש עשירה,? עליך להשתמש בשדה 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 { }) תאפס את שיעור המס שהוחל לאפס.
paymentOptionId[]

string

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

object (Deposit)

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

object (NoShowFee)

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

enum (RequireCreditCard)

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

enum (ServiceType)

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

object (TicketType)

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

object (RelatedMedia)

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

object (ServiceAttributeValueId)

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

object (WaitlistRules)

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

object (TicketingVerticalSpecificData)

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

enum (IntegrationType)

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

object (PerOrderFee)

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

object (ToursAndActivitiesContent)

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

object (Location)

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

object (Rating)

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

object (HomeServiceData)

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

object (VirtualSession)

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

object (DirectMerchantPayment)

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

דוגמאות:

  • תספורת שצריך להזמין לפחות שעה לפני שעת ההתחלה. '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

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

טיפוסים בני מנייה (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[]

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 כדי לציין את סוג התשלום מראש.

טיפוסים בני מנייה (enums)
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

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

טיפוסים בני מנייה (enums)
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) לציון סוג השדה.

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

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 (Text)
  },
  "price": {
    object (Price)
  },
  "perTicketFee": {
    object (PerTicketFee)
  },
  "optionDescription": string,
  "localizedOptionDescription": {
    object (Text)
  }
}
שדות
ticketTypeId

string

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

string

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

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

object (Text)

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

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

object (Price)

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

object (PerTicketFee)

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

string

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

object (Text)

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

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

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 (Price)
  },
  "facilityFee": {
    object (Price)
  },
  "taxes": {
    object (Price)
  }
}
שדות
serviceCharge

object (Price)

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

object (Price)

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

object (Price)

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

RelatedMedia

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

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

string

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

enum (MediaType)

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

object (Text)

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

object (Attribution)

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

string

הוצא משימוש. עדיף להשתמש בכיתוב localizedCaption.

MediaType

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

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

שיוך (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

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

WaitlistRules

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

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

integer

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

integer

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

boolean

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

object (UnsupportedPartySizeOption)

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

UnsupportedPartySizeOption

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

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

object (CallMerchant)

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

CallMerchant

הודעה ריקה שתופיע ב-supportedPartySizeOption. הגדרה זו תציג למשתמשים אפשרות להתקשר לעסק לצורך הזמנה.

TicketingVerticalSpecificData

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

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

enum (EventCategory)

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

string

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

object (Entity)

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

enum (AttendanceMode)

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

string

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

object (Text)

אפשרות. המארגן שמארח את האירוע.
eventOrganizerUrl

string

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

enum (OrganizerType)

אפשרות. סוג המארגן.
eventSourceUrl[]

string

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

enum (EventState)

אפשרות. מצב האירוע.

EventCategory

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

טיפוסים בני מנייה (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 (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

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

טיפוסים בני מנייה (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[]

string

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

string

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

AttendanceMode

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

טיפוסים בני מנייה (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 (Price)
  },
  "processingFee": {
    object (Price)
  }
}
שדות
deliveryFee

object (Price)

עמלה שיכולה להשתנות בהתאם לשיטת המשלוח.
processingFee

object (Price)

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

ToursAndActivitiesContent

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

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

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

object (GeoCoordinates)

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

enum (LocationType)

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

string

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

LocationType

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

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

Rating

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

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

number

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

string

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

HomeServiceData

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

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

string

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

string

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

VirtualSession

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

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

object (Text)

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

object (Text)

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

object (VirtualPlatformInfo)

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

boolean

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

VirtualPlatformInfo

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

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

enum (Platform)

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

object (Text)

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

הפלטפורמה

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

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

DirectMerchantPayment

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

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

object (Text)

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

שיטות

create

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

delete

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

patch

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