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.

EventMetadata

מידע נוסף על קישור הפעולה, שהוא ייחודי לתחום האירועים.

Surface

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

string

מזהה. שם המשאב של ה-AdsAccountLink. פורמט: partners/{partner}/adsAccountLinks/{ads_account_link}

string

חובה. רשימת המזהים של הפריטים במלאי שיקושרו לחשבון Google Ads.

State

פלט בלבד. מצב הקישור לחשבון Google Ads.

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.
• הודעת ScheduleException מתייחסת ל-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_ids שצוינו בהודעת השירות. באופן דומה, מזהי payment_option_ids שצוינו כאן לא חייבים להופיע בהודעת השירות, אבל הם חייבים להיות מוגדרים ברמת המוכר.

Recurrence

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

ScheduleException

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

Deposit

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

NoShowFee

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

Prepayment

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

RequireCreditCard

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

string

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

• שירות עם ארבעה סוגי כרטיסים: TicketType {ticket_type_id: "adult_1" short_description: "Adult weekdays"} TicketType {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: "Senior"}

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

LinkoutRequiredReason

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

Timestamp

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

Duration

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

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

TimeRange

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

דוגמה: אם בתזמון החוזר מצוין משך זמן של 20 דקות, ערך של repeat_every‏ (כל כמה זמן) של 30 דקות, ערך של start_time‏ (שעת ההתחלה) של 9:00 ו-repeat_until‏ (עד מתי) של 11:00, אז ScheduleException עם ערך של time_range‏ (טווח זמן) של 9:45 עד 11:00 יהפוך את המרווחים הזמינים ללא זמינים בשעות 9:30 עד 9:50, 10:00 עד 10:20 ו-10:30 עד 10:50.

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

int64

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

int64

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

int64

אם הערך מוגדר, זהו המועד האחרון (בשניות מתחילת זמן Unix) שבו אפשר לבטל את חלון הזמן הספציפי הזה לפגישה דרך '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

בקשת PaymentAuthentication. הטופס יופיע בטופס 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

חובה. המשאב הראשי שבו ייווצר הקישור לחשבון Google Ads הזה. מספר החשבון הזה זהה למספר החשבון במרכז השותפים. פורמט: partners/{partner}

string

חובה. המזהה שישמש לקישור לחשבון Google Ads. זהו אותו מספר כמו מספר הלקוח ב-Google Ads. פרטים נוספים זמינים בכתובת https://support.google.com/google-ads/answer/1704344. הפורמט: xxx-xxx-xxxx.

AdsAccountLink

חובה. ה-AdsAccountLink ליצירה.

string

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

string

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

Merchant

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

string

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

string

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

Service

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

CreditCardType

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

string

חובה. השם של AdsAccountLink שרוצים למחוק. פורמט: Partners/{partner}/adsAccountLinks/{ads_account_link}

string

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

string

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

Price

סכום ההפקדה.

int64

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

PriceType

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

Text

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

Duration

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

Duration

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

Text

חובה. השם, הכתובת, מספר הטלפון וכתובת האימייל של המפעיל הכלכלי, המוגדר כמייצר, הנציג המורשה, היבואן, המפיץ, ספק שירותי המילוי או כל אדם טבעי או משפטי אחר שכפוף לחובות שקשורות לייצור מוצרים, להפצתם או להפעלתם. ייצוג של מחרוזת בפורמט חופשי של Economic_operator. ייתכן שהמידע הזה מעוצב באמצעות " " וגם '\n'.

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

אם מוגדרת הודעת resources_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_restrict אם לא מגדירים את 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

לפידים מבוססי-proto.

double

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

double

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

PostalAddress

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

string

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

string

חובה. שם הקישור לחשבון Google Ads שצריך לאחזר. פורמט: partners/{partner}/adsAccountLinks/{ads_account_link}

string

חובה. שם המשאב, בפורמט partners/{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

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

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

string

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

int64

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

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

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

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

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

אם השותף...

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

האם הוגדרו כמה מותגים?

  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 בייטים.

EconomicOperator

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

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 ו-activation_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, למשל 'IL' (חובה)

string

שם היישוב, למשל 'רמת גן'. (חובה)

string

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

string

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

string

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

PriceInfo

קונטיינר לפרטי המחיר.

int64

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

string

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

string

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

PriceType

הגדרת אופן היישום של מחיר או טווח מחירים (לאדם או קבוע)

Price

המחיר של שירות או עמלה.

PriceRange

הגבול העליון ו/או התחתון של שירות או עמלה.

Price

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

Price

הסכום המקסימלי. תמיד צריך להיות > min_price.

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

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

string

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

ServiceAvailability

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

string

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

string

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

string

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

string

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

int32

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

Text

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

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

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

UriTemplate

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

ChargeTiming

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

int64

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

string

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

string

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

Value

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

string

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

string

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

string

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

string

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

string

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

Timestamp

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

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

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

  availability.duration == duration_restrict

אם מוגדרת הודעת resources_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_restrict אם לא מגדירים את 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 בשדה location כדי לציין את ערך המיקום.

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

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

PriceDisplayType

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

string

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

Text

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

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

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

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

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

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

InventoryType

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

EventCategory

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

string

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

Entity

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

AttendanceMode

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

string

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

Text

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

string

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

OrganizerType

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

string

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

EventState

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

Text

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

EventCreator

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

string

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

string

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

string

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

EntityType

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

EntityRole

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

PublicIdentificationData

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

string

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

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>

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

שאר הפרמטרים תלויים במעבד. מידע נוסף זמין במסמכים של 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: &quot;braintree:merchantId&quot; 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 { key: "gateway" value: "adyen" } tokenization_parameter { key: "gatewayMerchantId" value: "yourId" }

BillingInformationFormat

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