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

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

Surface

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

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 צריכים להידחות באופן מיידי או להיווצר עם הסטטוס PENDING.

LinkoutRequiredReason

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

Timestamp

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

Duration

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

דוגמה: אם מציינים זמינות עם משך של 20 דקות, repeat_every של 30 דקות, start_time של 9:00 ו-repeat_until של 11:00, ייווצרו משבצות בשעות 9:00-9:20,‏ 9:30-9:50,‏ 10:00-10:20,‏ 10:30-10:50 ו-11:00-11: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 של SchedulingRules של השירות המתאים.

int64

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

int64

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

חובה. משאב האב שבו ייווצר הקישור לחשבון 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 שרוצים למחוק. ‫Format: partners/{partner}/adsAccountLinks/{ads_account_link}

string

שם המשאב של המוכר שרוצים למחוק. בפורמט partners/{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_restrict, המערכת מפרשת את זה כאילו מדובר בכל הזמן עד ל-end_time_restrict.

Duration

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

Resources

ההגדרה resources_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

סכום קבוע. לדוגמה, ‎3.5 USD.

MoneyRange

טווח הסכומים. דוגמאות: * ‎3.5 USD to 5.5 USD * At least 3.5 USD * At most 5.5 USD

bool

סכום לא ידוע.

FulfillmentType

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

AvailableDay

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

FeeDetails

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

Price

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

Date

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

Timestamp

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

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

NoFee

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

MinimumFee

עמלת הבסיס שמשויכת לשיטת האספקה.

FixedFee

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

Price

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

Price

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

Timestamp

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

bytes

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

Any

לפידים מבוססי-פרוטוקול.

Timestamp

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

bytes

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

Any

לפידים מבוססי-פרוטוקול.

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

string

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

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

string

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

int64

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

int64

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

OrderedTickets

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

Price

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

BookingStatus

הסטטוס של פריט.

string

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

int32

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

string

תבנית ה-URI צריכה להיות בהתאם ל-RFC 6570, כפי שמתואר בכתובת https://datatracker.ietf.org/doc/html/rfc6570. תמיכה בתבניות ברמה 1 ובכל התבניות המורכבות ברמה 4. למשל: http://example.com/book/{foo}?b={bar} * foo = 2 * bar = abc https://example.com/book/2?b=abc

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 שהוחזר מבקשת List קודמת, אם יש כזה.

State

אופציונלי: אפשר להגביל את התוצאות לפי מצב הפיד.

TimeRange

אופציונלי: אפשר להגביל את התוצאות באמצעות סינון לפי גבול עליון ותחתון. אם לא מגדירים את start_time, ברירת המחדל היא תחילת הזמן ב-Unix. אם לא מגדירים את 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, ‏ telephone, ‏ url ו-geo משמשים להתאמת מלאי של שותפים למוכרים שכבר מופיעים במפות Google. המידע הזה לא יוצג.

שם המוכר.

string

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

string

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

GeoCoordinates

המידע הגיאוגרפי של המוֹכר, כולל קו רוחב, קו אורך וכתובת.

string

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

int64

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

uint32

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

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

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

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

TaxRate

שיעור המס של המוכר. אם השדה הזה קיים, הוא מחליף את השדה tax_rate_basis_points שהוצא משימוש. הודעה ריקה (כלומר tax_rate { }) תאפס את שיעור המס שהוחל לאפס. הוצא משימוש כי אין יותר תמיכה בתשלומים מקצה לקצה.

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

LinkoutTemplate

אופציונלי. תבנית הקישור ליציאה מהאפליקציה שמציינת איך Google צריכה ליצור את כתובת ה-URL של השותף כדי להזמין שולחן בפלטפורמה שלו.

הערה: נכון לעכשיו, אם תספקו כמה ערכים, המערכת תשתמש רק בערך הראשון.

תבנית ה-URI תומכת בשדות שיאוכלסו על סמך בחירות ההזמנה של המשתמש. כל השדות הנדרשים נחוצים כדי ליצור כתובת ה-URL להזמנת מקום בהצלחה: * (חובה) party_size, int: גודל הקבוצה שעבורה המשתמש מבקש לבצע הזמנה. ‫* (חובה) selected_date_time, תאריך ושעה בפורמט ISO 8601 (https://en.wikipedia.org/wiki/ISO_8601): השעה שבה המשתמש מבקש לבצע הזמנה. ‫* (אופציונלי) merchant_id, מחרוזת: מזהה המוכר שהמשתמש מבקש לבצע הזמנה אצלו. לא נדרש אם התבנית כבר כוללת מזהה מוכר. ‫* (אופציונלי) room_id, מחרוזת: המזהה של החדר שהמשתמש מבקש להזמין.

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

קטגוריות של שירותים מקומיים (ענפים). לדוגמה, plumber ו-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

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

string

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

string

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

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

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

string

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

string

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

Price

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

TaxRate

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

string

היישוב, לדוגמה: 'Mountain View'. (חובה)

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]. אפשר להשמיט את הערך רק אם מספר הדירוגים הוא אפס.

uint64

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

string

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

MediaType

סוג מקור המדיה.

Text

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

Attribution

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

string

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

Text

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

string

המאפיין הזה הוצא משימוש. עדיף להשתמש במאפיין localized_text.

ServiceAvailability

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

string

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

string

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

string

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

string

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

int32

רלוונטי רק להזמנת מקומות במסעדות: מספר הסועדים שאפשר להושיב במשבצת הזמן הזו. מסעדה יכולה להיות משויכת לכמה משבצות זמן לאותה שעה, כשבכל אחת מהן מצוין מספר שונה של אנשים (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>Itinerary</h1> יציג את הטקסט בתוך שורה ככותרת הכי חשובה של הקטע. שימו לב: המערכת תתעלם מכל תגי HTML פנימיים, סגנונות או מאפיינים. לדוגמה, התג <h1 style=".."> יטופל כמו התג <h1>. רק טקסט טהור יישמר.

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

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

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

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

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

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

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

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

Price

מחיר השירות.

PriceInterpretation

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

SchedulingRules

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

PrepaymentType

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

PrepaymentTerms

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

ServiceIntakeForm

הוצא משימוש. צריך להשתמש בטפסים intake_form ו-per_ticket_intake_form.

ServiceIntakeForm

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

ServiceIntakeForm

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

TaxRate

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

string

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

Deposit

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

NoShowFee

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

RequireCreditCard

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

ActionLink

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

ServiceType

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

TicketType

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

RelatedMedia

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

ServiceAttributeValueId

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

WaitlistRules

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

TicketingVerticalSpecificData

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

IntegrationType

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

PerOrderFee

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

ToursAndActivitiesContent

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

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

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

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

Duration

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

Resources

ההגדרה resources_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

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

int32

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

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

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

string

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

string

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

Text

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

string

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

LocalizedString

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

string

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

string

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

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

Text

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

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

Price

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

PerTicketFee

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

PriceDisplayType

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

string

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

Text

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

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

דוגמה 1: כרטיס כניסה עם סוגים שונים (adult,‏ child) ושפה כאפשרות נוספת. רשימת TicketType הצפויה תהיה: ‪- { 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: "child" } localized_option_description { value: "english" } } ‪- { ticket_type_id: "ticket_type_4" 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: "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" } }

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

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

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

דוגמה ל-Braintree: ‏ tokenization_parameter { key: "gateway" value: "braintree" } tokenization_parameter { key: "braintree:apiVersion" value: "v1" } tokenization_parameter { key: "braintree:sdkVersion" value: "2.30.0" } tokenization_parameter { key: "braintree:merchantId" value: "abcdef" } tokenization_parameter { key: "braintree:clientKey" value: "production_xxx_yyy" }

דוגמה ל-Stripe: ‏ tokenization_parameter { key: "gateway" value: "stripe" } tokenization_parameter { key: "stripe:version" value: "2018-02-28" } tokenization_parameter { key: "stripe:publishableKey" value: "pk_1234" }

דוגמה ל-Adyen: ‏ tokenization_parameter { key: "gateway" value: "adyen" } tokenization_parameter { key: "gatewayMerchantId" value: "yourId" }

BillingInformationFormat

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