Package google.maps.booking.v1alpha

string

כתובת ה-URL של נקודת הכניסה לקישור לפעולה הזו.

string

תג השפה BCP-47 שמזהה את השפה שבה זמין התוכן מה-URI הזה.

string

קוד מדינה לפי תקן ISO 3166-1 alpha-2. צריך להשאיר את השדה ריק כדי לאפשר חשיפה בלתי מוגבלת.

ActionPlatform

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

ActionLinkType

סוג הפעולה שנקבע מראש.

OrderOnlineMetadata

מטא-נתונים של הקישור להזמנה אונליין. תומכת בפעולה עם ActionLinkType של ACTION_LINK_TYPE_SHOP_Online.

FoodOrderingMetadata

מטא-נתונים של קישורים להזמנות ממסעדות. תומכת בסוג הפעולה: * ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY * ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT לא תומך ב-ACTION_LINK_TYPE_ORDER_FOOD.

Text

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

Timestamp

שעת ההתחלה של משבצת הזמן לפגישה.

Duration

משך המשבצת לפגישה ששוריינה

int64

מספר המקומות הכולל והמקומות הפנויים הזמינים. דוגמאות:

• שיעור יוגה עם 10 מקומות שבהם 3 מקומות מוזמנים: availability {spots_total: 10, spots_open: 7 ...}
• שיעור עיסוי בכיסא שכבר הוזמן: availability {spots_total: 1, spots_open: 0 ...}

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

• חזרה מתייחסת ל-spots_total=1 ול-spots_open=1.
• חריג של לוח זמנים חל על spots_total=1 ועל spots_open=0.

int64

מספר המקומות הפתוחים.

string

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

Resources

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

לדוגמה אותו שיעור יוגה עם שני מורים:

availability { resources { staff_id: "1" staff_name: "Amy" }
               spots_total: 10 spots_open: 7 }
availability { resources { staff_id: "2" staff_name: "John" }
               spots_total: 5 spots_open: 2 }

string

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

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

Recurrence

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

ScheduleException

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

Deposit

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

NoShowFee

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

RequireCreditCard

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

string

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

• שירות עם ארבעה סוגי כרטיסים: TicketType {ticket_type_id: "adult_1" Short_description: "adult weekdays"} כרטיס מסוג {ticket_type_id: "adult_2" Short_description: "Adult weekends"} TicketType {ticket_type_id: "youth_1" Short_description: "Youth weekdays"} TicketType {ticket_type_id: "youth_2" Short_description: "Youth weekends"}

כדי לייצג את המלאי במהלך ימי השבוע: availability {ticket_type_id: "adult_1" ticket_type_id: "youth_1"...}. כדי לייצג את המלאי בתקופת החגים: availability {ticket_type_id: "adult_2" ticket_type_id: "youth_2"...}.

• שירות עם שלושה סוגי כרטיסים: TicketType {ticket_type_id: "adult" Short_description: "adult"} TicketType {ticket_type_id: "youth" Short_description: "Youth"} TicketType {ticket_type_id: "senior" Short_description: "Executive"}

כדי לציין שכל שלושת סוגי הכרטיסים זמינים למשבצת הזמן הזו, צריך להשתמש במאפיין availability {ticket_type_id: "adult" ticket_type_id: "youth" ticket_type_id: "senior" ...} או במאפיין 'availability {...}' (אל תגדירו כרטיס Ticket_type_id במשבצת הזו).

(אופציונלי)

DurationRequirement

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

SchedulingRuleOverrides

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

ConfirmationMode

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

Timestamp

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

Duration

הגדרת משך הזמן בין משבצות זמינות עוקבות.

לדוגמה: אם התכונה זמינה למשך זמן של 20 דקות, חזרה_למשך 30 דקות, זמן התחלה של 9:00 ושעת התחלה שוב ושוב בשעה 11:00 יתקבלו משבצות זמן בשעות 9:00, 9:30-9:50, 10-10:20, 10:30 עד 10:20. (חובה)

TimeRange

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

דוגמה: אם חזרה מציינת משך זמן של 20 דקות, חזרה_לחזרה 30 דקות, שעת התחלה של 9:00 ומשך חזרה 11:00 בבוקר, אירוע חריגים עם טווח זמן של 9:45 עד 11:00 יוביל לכך שהמשבצות לא יהיו זמינות בשעות 9:30-9:50 וב- 9:30-9:50

חשוב לדעת שמאחר שטווח הזמן סגור, לא תהיה לכך השפעה על משבצת הזמן שמתחילה במשבצת של 11:00.

int64

הפעם האחרונה (בשניות) שבה ניתן להזמין את המשבצת הזאת. כדי לכבד את חותמת הזמן הזו, חותמת הזמן צריכה להיות לפני start_sec של המשבצת (אם המשתמשים יכולים לבצע הזמנה אחרי שעת ההתחלה, יש להשתמש ב-SchedulingRules.min_booking_before_end_time). אם הוא קיים, הוא יבטל כל דבר שצוין ב-min_booking_buffer של כללי התזמון של השירות המתאים.

int64

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

int64

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

string

שם המשאב בפורמט הבא: partners/{partner_id}/feeds/{feed_name}.

GenericDeleteRecord

הרשומות למחיקה. אפשר להוסיף עד 1,000 רשומות בקריאה אחת לממשק ה-API.

string

שם המשאב בפורמט הבא: partners/{partner_id}/feeds/{feed_name}.

GenericRecord

רשומות להוספה ו/או לעדכון. אפשר להוסיף עד 1,000 רשומות בקריאה אחת לממשק ה-API.

string

פורמט של partners/{partner_id}.

ExtendedServiceAvailability

הזמינות המורחבת של השירות, שמשמשת להחלפת משבצות הזמינות הקיימות.

ExtendedServiceAvailability

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

string

שם מקור המידע בהזמנה: partners/{partner ID}/bookings/{booking ID}

string

המזהה של המוכר במשבצת

string

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

Timestamp

שעת ההתחלה של המשבצת לפגישה

Duration

משך המשבצת לפגישה ששוריינה

ClientInformation

מידע אישי של הלקוח שקובע את הפגישה

BookingStatus

סטטוס ההזמנה

PaymentInformation

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

int64

מספר הסועדים של ההזמנה

Cause

הסיבה שבגללה ההזמנה נכשלה. (חובה)

CreditCardType

(נדרש רק אם הסיבה היא PAYMENT_ERROR_CARD_TYPE_REJECTED)

string

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

PaymentFailureInformation

מידע על כשלים בתשלום.

ThreeDS1Parameters

פרמטרים שמשמשים את אתר האגרגטור של RwG כדי להפעיל פרוטוקול אימות 3DS1 עם המשתמש. המערכת תתעלם, אלא אם השדה BookingFailure.cause יוגדר כ-PAYMENT_REQUIRES_3DS1.

string

כתובת ה-URL שממנה לטעון טופס להצגה למשתמש לצורך אימות.

string

בקשה לאימות תשלום. כדי לפרסם בטופס ACSUrl, אם צוין.

string

מזהה שמשמש את ספק ה-ACS. כדי לפרסם בטופס ACSUrl, אם צוין.

string

נתוני מוכרים. כדי לפרסם בטופס ACSUrl, אם צוין.

RefundCondition

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

Duration

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

uint32

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

string

השם הפרטי של הלקוח

string

שם המשפחה של הלקוח

PostalAddress

כתובת הלקוח

string

מספר הטלפון של הלקוח

string

כתובת האימייל של הלקוח

string

שם משאב ההורה של השותף שהוא הבעלים של המוכר הזה, בפורמט partners/{partner_id}.

string

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

Merchant

המוֹכר שרוצים ליצור.

string

שם משאב ההורה של המוכר שהשירות הזה בבעלותו, בפורמט partners/{partner_id}/merchants/{merchant_id}.

string

מזהה השירות שבו יש להשתמש עבור השירות הזה.

Service

השירות שיש ליצור.

CreditCardType

רשימה של כרטיסי האשראי הנתמכים. אם השדה ריק, אין תמיכה בכרטיסי אשראי.

string

שם המשאב של המוכר שרוצים למחוק. בפורמט של שותפים/{partner_id}/merchants/{merchant_id}

string

שם המשאב של השירות שרוצים למחוק. בפורמט partners/{partner_id}/merchants/{merchant_id}/services/{service_id}

Price

סכום ההפקדה

int64

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

PriceType

מגדיר איך ההפקדה נקבעת לפי הזמינות.

Text

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

Duration

משך זמן מינימלי.

Duration

משך זמן מקסימלי.

string

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

string

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

Timestamp

אם סופקו, ישויות הזמינות שסופקו ייחשבו כתמונת מצב מלאה מ-[start_time_restrict, end_time_restrict). כלומר, כל נתוני הזמינות הקיימים יימחקו אם מתקיים התנאי הבא:

   start_time_restrict <= availability.start_sec &&
   availability.start_sec < end_time_restrict

אם הוגדרה הודעה לגבי משך הזמן, התנאי מוגבל עוד יותר:

  availability.duration == duration_restrict

אם מוגדרת הודעה resource_restrict, התנאי מוגבל עוד יותר:

   availability.resources.staff_id == resources_restrict.staff_id &&
   availability.resources.room_id == resources_restrict.room_id

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

אם מגדירים את הערך start_time_restrict אם לא מגדירים את הערך end_time_restrict, המערכת תפרש את כל התאריכים החל מ-start_time_restrict.

Timestamp

אם מגדירים את הערך end_time_restriction אם לא מגדירים את start_time_restriction, המערכת תפרש את כל הזמנים עד ל-end_time_restrict.

Duration

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

Resources

הגדרת resource_restrict מגבילה עוד יותר את היקף העדכון לקבוצת המשאבים הזו בלבד. כל שדות המזהה של המשאבים חייבים להיות זהים.

Availability

רשימת הזמינות החדשה.

int64

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

int64

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

int64

הפריטים כבר לא קיימים בפיד הזה וכתוצאה מכך הוסרו.

string

שם משאב הפיד, בפורמט הבא:

• partners/{partner_id}/feeds/merchants/{file_name}
• partners/{partner_id}/feeds/services/{file_name}
• partners/{partner_id}/feeds/availability/{file_name}

State

מצב העיבוד של הפיד הזה.

string

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

FeedStatistics

נתונים סטטיסטיים ספציפיים לעדכון הזה.

FeeDetails

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

AdvanceOrderDetails

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

Duration

משך זמן קבוע. לדוגמה: 30 דקות.

DurationRange

טווח זמן. דוגמאות: * 30 דקות עד 45 דקות * יותר מ-30 דקות * פחות מ-50 דקות

bool

הערך הוא True אם יש תמיכה בהזמנות מראש, שנקראת גם 'הזמנה מראש'. (חובה)

FeeType

סוג העמלה. (חובה)

FeeAmount

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

QuantitativeValue

העמלה במונחים של אחוז מערך עגלת הקניות. תומכת בטווח (מוגבל ולא מוגבל) או באחוז קבוע. הערך צריך להיות בין 0 ל-100. דוגמאות: * קבוע 5.5% * 5.5% לפחות * 5.5% * 4.5% עד 5.5%

Money

סכום קבוע. למשל, USD 3.5.

MoneyRange

טווח הסכום. דוגמאות: * 3.5 USD עד USD 5.5 * לפחות USD 3.5 * לכל היותר 5.5 USD

bool

סכום לא ידוע.

FulfillmentType

חובה. סוג האספקה.

AvailableDay

חובה. רשימת ימים שבהם יש זמינות לשיטת מילוי ההזמנות הזו (עדיף 2 לפחות).

FeeDetails

חובה. פרטי העמלות של שיטת מילוי ההזמנות.

Price

חובה. הזמנה מינימלית לשיטת מילוי ההזמנות שמשויכת לקישור הפעולה.

Date

חובה. תאריך זמין לשיטת מילוי ההזמנה. ההנחה היא באזור הזמן של המוכר.

Timestamp

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

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

NoFee

אין עמלה על שיטת מילוי ההזמנה.

MinimumFee

העמלה הבסיסית שמשויכת לשיטת מילוי ההזמנות.

FixedFee

העמלה הקבועה שמשויכת לשיטת מילוי ההזמנות.

Price

חובה. סכום העמלה הקבועה של שיטת מילוי ההזמנה.

Price

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

Timestamp

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

bytes

בפידים שלא מבוססים על Proto.

Any

לפידים המבוססים על אב-טיפוס.

Timestamp

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

bytes

בפידים שלא מבוססים על Proto.

Any

לפידים המבוססים על אב-טיפוס.

double

קו רוחב במעלות. (אופציונלי)

double

קו האורך במעלות. (אופציונלי)

PostalAddress

הכתובת לדברי דואר של המיקום, מועדף.

string

אפשר גם לספק כתובת לא מובנית כחלופה. לדוגמה "1600 amphitheatre Parkway mountain view, ca 94043"

string

חובה. שם המשאב, בפורמט partner/{partner_id}/merchants/{merchant_id}/status.

string

שם משאב הפיד, בפורמט הבא:

• partners/{partner_id}/feeds/merchants/{file_name}
• partners/{partner_id}/feeds/services/{file_name}
• partners/{partner_id}/feeds/availability/{file_name}

string

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

string

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

string

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

לדוגמה, עבור משאב 'איסוף', השם צריך להיות בפורמט partners/{partner_id}/pickups/{pickup_id}. הטמעות חייבות להסיר גרסאות שנשמרו במטמון של המשאב שזוהה.

string

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

int64

שעת ההתחלה של משבצת הפגישה בשניות מזמן UTC מאז תאריך יוניקס (Unix epoch).

int64

משך הזמן של משבצת הפגישה, בשניות.

OrderedTickets

מספר הכרטיסים שהוזמנו לפי סוג הכרטיס.

Price

המחיר הכולל (לא כולל מיסים) של הפריט הזה.

BookingStatus

סטטוס הפריט.

string

המזהה של סוג הכרטיס.

int32

מספר הכרטיסים שהוזמנו לסוג הזה.

string

חובה. ההורה שהוא הבעלים של האוסף הזה של סטטוס מוכר. פורמט: partners/{partner_id}/merchants

int32

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

string

זה שינוי אופציונלי. הערך NextPageToken שהוחזר מ-ListMerchantStatusResponse הקודם, אם יש כזה.

BookingInventoryStatus

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

WaitlistInventoryStatus

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

GeoMatchingStatus

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

MerchantStatus

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

string

אסימון לאחזור דף התוצאות הבא. אין עוד תוצאות ברשימה אם היא ריקה.

string

שם משאב הפיד, בפורמט הבא:

• partners/{partner_id}/feeds/merchants
• partners/{partner_id}/feeds/services
• partners/{partner_id}/feeds/availability

int32

המספר המקסימלי של פריטים שצריך להחזיר.

string

הערך next_page_token שהוחזר מבקשת רשימה קודמת, אם קיימת.

State

הגבלה אופציונלית כדי לסנן את התוצאות לפי מצב הפיד.

TimeRange

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

FeedStatus

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

string

אסימון לאחזור דף התוצאות הבא. אין עוד תוצאות ברשימה אם היא ריקה.

string

קוד שפה IETF BCP 47, כמו 'en', 'mas', 'zh-Hant', 'de-CH-1901'. פרטים נוספים זמינים בכתובת http://www.w3.org/International/articles/language-tags/.

string

הודעה באזור שלמעלה (UTF-8).

string

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

string

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

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

string

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

string

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

GeoCoordinates

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

LocationType

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

string

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

string

שם המשאב של המוכר, בפורמט partners/{partner_id}/merchants/{merchant_id}.

string

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

שם המוֹכר.

string

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

string

כתובת ה-URL של האתר הציבורי של המוכר.

GeoCoordinates

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

string

הקטגוריה של העסק בפלטפורמה של האגרגטור.

int64

השדה הזה הוצא משימוש.

uint32

שיעור המס של המוכר בנקודות הבסיס (מאות אחוז אחד). לדוגמה, אם שיעור המס הוא 7.5%, יש להגדיר את השדה הזה ל-750.

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

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

השדה הזה הוצא משימוש. במקומו צריך להשתמש ב-tax_rate.

TaxRate

שיעור המס של המוכר. אם השדה הזה קיים, הוא מבטל את השדה Tax_rate_basis_points שהוצא משימוש. הודעה ריקה (למשל מס_שיעור { }) תאפס את שיעור המס שהוחל.

PaymentRestrictions

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

PaymentOption

אפשרויות התשלום הזמינות למוכר הזה. שירותים של המוכר הזה יוכלו להגביל בנפרד את אפשרויות התשלום שהם מאפשרים.

PaymentProcessorConfig

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

TokenizationConfig

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

Terms

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

string

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

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

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

אם השותף...

אין לך כמה מותגים שמיועדים לצרכנים? --> התעלמות מהשדה הזה

האם בחשבון הוגדרו כמה מותגים?

  If this field is set
    --> Associated consumer-facing brand attribution is used

  If this field is unset or the empty string
    --> Default consumer-facing brand attribution is used

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

MerchantMatchingHints

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

ServiceAttribute

הגדרות של מאפייני שירות שמשמשים לתיאור השירותים של המוכר הזה. (אופציונלי)

ActionLink

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

Advisement

זה שינוי אופציונלי. עצות כלליות ממוכר ספציפי לגבי משתמש שהצטרף לרשימת המתנה דרך 'Google הזמנת מקומות'. שדות טקסט בודדים בייעוץ צריכים להיות מוגבלים לאורך של 100 בייטים.

string

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

string

שם המשאב של סטטוס המוכר, בפורמט partners/{partner_id}/merchants/{merchant_id}/status

string

שם המוכר שסופק על ידי השותפים.

GeoCoordinates

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

ProcessingStatus

סטטוס עיבוד המוכר.

BookingStatus

הסטטוס שקשור לשילוב של ההזמנה מקצה לקצה.

WaitlistStatus

הסטטוס קשור לשילוב עם רשימת ההמתנה.

PlaceInfo

מקום גיאוגרפי תואם של מוכר זה. ריק אם אין התאמה גיאוגרפית למוכר.

LocalServicesMatchInfo

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

DirectUrl

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

bool

הערך הוא True אם למוכר יש מלאי ב-30 הימים הבאים. לא מובטח שהמוכר יקבל שירות בפועל.

UrlType

הסוג של כתובת ה-URL הזו.

string

כתובת ה-URL שעשויה להציג את המוכר הזה.

MatchedProvider

ספקי שירות תואמים. אפשר להתאים בין מוכר לכמה ספקי שירות.

int64

מספר לקוח חיצוני של 'Google בעלי מקצוע'.

string

קטגוריות של שירות מקומי (קטגוריות). לדוגמה "שרברב" ו-"carpet_cleaning"

string

שם המקום.

string

כתובת בפורמט המתאים בשפה המקומית.

string

מזהה המקום של המקום הזה ב-Google. אפשר להשתמש בו כדי ליצור כתובת URL של מפות Google או לאחזר פרטים נוספים על המקום. דוגמאות לשימוש זמינות בכתובת https://developers.google.com/places/web-service/place-id.

bool

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

Money

סכום מינימלי.

Money

סכום מקסימלי.

Price

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

PriceType

מגדיר איך העמלה נקבעת לפי הזמינות.

string

שם המשאב בהזמנה: partners/{partner ID}/orders/{order ID}

ClientInformation

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

PaymentInformation

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

string

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

LineItem

פריטים בהזמנה הזו.

FulfillmentOption

אפשרויות זמינות למילוי הזמנות עבור קישור לפעולה אונליין של הזמנה.

PrepaymentStatus

סטטוס התשלום מראש של ההזמנה. אם הערך payment_status הוא PREPAYMENT_PROVIDED או PREPAYMENT_REFUNDED, אז המאפיין payment_transaction_id מכיל את מזהה העסקה הייחודי שמשויך לו.

string

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

string

המזהה הזה משמש לזיהוי אפשרות התשלום הזו.

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

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

string

השם של אפשרות התשלום. התווית יכולה להיות גלויה למשתמש.

string

תיאור של אפשרות התשלום. התווית יכולה להיות גלויה למשתמש.

Price

המחיר של אפשרות התשלום.

TaxRate

שיעור המס לאפשרות התשלום הזו. אם השדה הזה קיים, הוא מבטל את השדה Tax_rate של המוכר או השירות. הודעה ריקה (למשל מס_שיעור { }) תאפס את שיעור המס שהוחל.

PaymentOptionType

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

int64

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

TimeRange

ניתן לרכוש את אפשרות התשלום במרווח הזמן הזה.

TimeRange

ניתן להשתמש באפשרות התשלום בפרק הזמן הזה (למשל, מחיר מיוחד בינואר 2017). אם השדה הזה קיים, ההגדרות האלה מבטלות את valid_duration ו-Activate_type.

Duration

משך התוקף של אפשרות התשלום (למשל, חברות ל-30 יום).

ActivationType

הגדרה זו קובעת את תאריך התחלת התוקף של אפשרות התשלום הזו.

UserPurchaseRestriction

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

Processor

מגדיר את השותף לעיבוד תשלומים שעליו חלה ההגדרה הזו.

string

המפתח שמשמש לזיהוי המוכר הזה מול ספק שירותי התשלומים.

מידע על Stripe זמין בכתובת: https://stripe.com/docs/dashboard#api-keys לגבי Braintree: מידע נוסף זמין בכתובת https://articles.braintreepayments.com/control-panel/important-gateway-credentials

string

מספר גרסת ה-API שנשלח למעבד התשלומים יחד עם בקשות תשלום.

CreditCardRestrictions

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

Price

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

Price

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

Price

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

Price

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

Price

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

string

המדינה, שצוינה באמצעות קוד מדינה מסוג ISO 3166-1 alpha-2, לדוגמה. "US" (שדה חובה)

string

הרשות המוניציפאלית, למשל "מאונטן ויו". (חובה)

string

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

string

המיקוד, למשל '94043'. (חובה)

string

הרחוב, למשל " 1600 Amphitheatre Pkwy". (חובה)

int64

המחיר במיקרו יחידות של המטבע. שברים של יחידת המטבע הקטנה ביותר יעוגלו באמצעות העיגול השווה הקרוב ביותר. (למשל: 2.5 דולר מעוגל ל-2 סנט, 3.5 סנט מעוגלים ל-4 סנט, 0.5 סנט מעוגלים ל-0 סנט, 2.51 סנט מעוגלים ל-3 סנט).

string

מטבע המחיר, שמוגדר בתקן ISO 4217.

string

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

double

ערך יחיד. לדוגמה: 5.6

RangeValue

טווח של ערכים שיכולים להיות עם סיום פתוח או מוגבל. דוגמאות: * לפחות 5.5 * 5.5 * 5.5 עד 6.5

double

ערך מינימלי.

double

ערך מקסימלי.

double

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

uint64

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

string

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

MediaType

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

Text

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

Attribution

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

string

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

Text

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

string

הוצא משימוש, כדאי להשתמש ב-localized_text.

ServiceAvailability

זמינות השירות שמשמשת להחלפת השירותים הקיימים.

string

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

string

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

string

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

string

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

int32

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

int64

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

Price

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

Price

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

AdmissionPolicy

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

CancellationPolicy

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

int64

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

int64

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

string

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

string

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

Text

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

string

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

Text

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

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

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

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

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

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

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

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

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

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

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

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

Price

מחיר השירות.

PriceInterpretation

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

SchedulingRules

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

PrepaymentType

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

PrepaymentTerms

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

ServiceIntakeForm

הוצא משימוש. יש להשתמש ב-intake_form וב-per_ticket_intake_form.

ServiceIntakeForm

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

ServiceIntakeForm

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

TaxRate

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

string

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

Deposit

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

NoShowFee

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

RequireCreditCard

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

ActionLink

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

ServiceType

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

TicketType

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

RelatedMedia

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

ServiceAttributeValueId

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

WaitlistRules

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

TicketingVerticalSpecificData

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

IntegrationType

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

PerOrderFee

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

ToursAndActivitiesContent

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

Location

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

Rating

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

HomeServiceData

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

VirtualSession

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

DirectMerchantPayment

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

ChargeTiming

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

int64

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

string

מזהה שמזהה באופן ייחודי את מאפיין השירות הזה יחד עם מאפיינים אחרים של אותו מוכר, למשל: "account-type".

string

שם המאפיין הזה גלוי למשתמש, לדוגמה: 'סוג החשבון'.

Value

כל הערכים האפשריים במאפיין השירות הזה.

string

מזהה שמזהה באופן ייחודי את הערך הזה בין ערכים אחרים של מאפיין השירות הזה, למשל: "אישי".

string

שם הגלוי למשתמש של הערך, לדוגמה: 'אישי'.

string

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

string

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

string

שם המשאב של השירות שעליו רוצים להחיל את המאפיין הזה. בפורמט partners/{partner_id}/merchants/{merchant_id}/services/{service_id}

Timestamp

אם סופקו, ישויות הזמינות שסופקו ייחשבו כתמונת מצב מלאה מ-[start_time_restrict, end_time_restrict). כלומר, כל נתוני הזמינות הקיימים יימחקו אם מתקיים התנאי הבא:

   start_time_restrict <= availability.start_sec &&
   availability.start_sec < end_time_restrict

אם הוגדרה הודעה לגבי משך הזמן, התנאי מוגבל עוד יותר:

  availability.duration == duration_restrict

אם מוגדרת הודעה resource_restrict, התנאי מוגבל עוד יותר:

   availability.resources.staff_id == resources_restrict.staff_id &&
   availability.resources.room_id == resources_restrict.room_id

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

אם מגדירים את הערך start_time_restrict אם לא מגדירים את הערך end_time_restrict, המערכת תפרש את כל התאריכים החל מ-start_time_restrict.

Timestamp

אם מגדירים את הערך end_time_restriction אם לא מגדירים את start_time_restriction, המערכת תפרש את כל הזמנים עד ל-end_time_restrict.

Duration

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

Resources

הגדרת resource_restrict מגבילה עוד יותר את היקף העדכון לקבוצת המשאבים הזו בלבד. כל שדות המזהה של המשאבים חייבים להיות זהים.

Availability

רשימת הזמינות החדשה.

ServiceIntakeFormField

השדות שיוצגו למשתמש.

bool

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

bool

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

string

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

FieldType

סוג השדה הזה.

string

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

Text

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

string

יש להגדיר אם ורק אם סוג השדה הוא LOCATION_SEARCH. יש להשתמש בפרמטר "location_id" ב"מיקום" כדי לציין את ערך המיקום.

Text

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

bool

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

bool

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

Text

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

string

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

Text

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

int32

שיעור מס במיליוניות של אחוז אחד, שמספק בפועל 6 ספרות אחרי הנקודה העשרונית. לדוגמה, אם שיעור המס הוא 7.253%, השדה הזה צריך להיות מוגדר כ-7253000.

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

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

string

אופציונלי: כתובת ה-URL של התנאים וההגבלות.

string

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

Text

הטקסט המותאם לשוק המקומי שיוצג למשתמש.

string

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

LocalizedString

ערכי טקסט לפי אזור. זה שינוי אופציונלי.

string

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

string

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

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

Text

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

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

Price

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

PerTicketFee

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

string

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

Text

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

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

דוגמה 1: כרטיס כניסה עם סוגים שונים 'למבוגרים', 'ילד' והשפה כאפשרות נוספת, רשימת ה-TickType הצפויה תהיה: - {ticket_type_id: "ticket_type_1" localized_short_description { value: "adult" } localized_option_description { value: "english" } } - { Ticket_type_id: "ticket_type_2" localized_short_description { value: "adult" } localized_option_description { value: "spanish" } } - { Ticket_type_id: "ticket_type_3" localized_short_description { value: &quot;child&quot; } localized_option_description { value: "english" } } - { Ticket_type_id: "ticket_type_4" localized_short_description { value: &quot;child&quot; } localized_option_description { value: "spanish" } }

דוגמה 2: השכרת קיאק לכמה שעות עם תוסף אופציונלי של שקיות יבש, התיאור הקצר (short_description) יכול להיות "3 שעות" והפרמטר option_description יכול להיות "עם שקית יבש" או "ללא שקית יבש": - {ticket_type_id: "ticket_type_1" localized_short_description { value: "2 hours" } localized_option_description { value: "english" } } - { Ticket_type_id: "ticket_type_2" localized_short_description { value: "2 hours" } localized_option_description { value: "spanish" } } - { Ticket_type_id: "ticket_type_3" localized_short_description { value: "3 hours" } localized_option_description { value: "english" } } - { Ticket_type_id: "ticket_type_4" localized_short_description { value: "3 hours" } localized_option_description { value: "spanish" } }

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

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

EventCategory

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

string

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

Entity

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

AttendanceMode

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

string

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

Text

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

string

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

OrganizerType

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

string

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

EventState

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

string

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

string

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

string

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

EntityType

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

EntityRole

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

PublicIdentificationData

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

string

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

string

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

Timestamp

הגבול התחתון של טווח הזמן.

Timestamp

הגבול העליון של טווח הזמן.

map<string, string>

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

שאר הפרמטרים תלויים במעבד. מידע נוסף זמין במסמכים של Google Pay.

דוגמה ל-Baintree: Tokenization_parameter { key: "gateway" value: "braintree" } tokenization_parameter { key: &quot;braintree:apiVersion&quot; ערך: "v1" } tokenization_parameter { key: &quot;braintree:sdkVersion&quot; ערך: "2.30.0" } Tokenization_parameter { key: "braintree:merchantId" value: "abcdef" } tokenization_parameter { key: &quot;braintree:clientKey&quot; value: "production_xxx_yyy" }

דוגמה ל-Stripe: Tokenization_parameter { מפתח: "gateway" ערך: 'stripe' } tokenization_parameter { key: &quot;stripe:version&quot; value: "2018-02-28" } tokenization_parameter { key: &quot;stripe:publishableKey&quot; ערך: "pk_1234" }

דוגמה ל-Adyen: Tokenization_parameter { מפתח: "gateway" ערך: "adyen" } Tokenization_parameter { key: "gatewayMerchantId" value: "yourId" }

BillingInformationFormat

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