REST Resource: inventory.partners.merchants.services.availability

{
  "startTime": string,
  "duration": string,
  "spotsTotal": string,
  "spotsOpen": string,
  "availabilityTag": string,
  "resources": {
    object (Resources)
  },
  "paymentOptionId": [
    string
  ],
  "recurrence": {
    object (Recurrence)
  },
  "scheduleException": [
    {
      object (ScheduleException)
    }
  ],
  "deposit": {
    object (Deposit)
  },
  "noShowFee": {
    object (NoShowFee)
  },
  "prepayment": {
    object (Prepayment)
  },
  "requireCreditCard": enum (RequireCreditCard),
  "ticketTypeId": [
    string
  ],
  "durationRequirement": enum (DurationRequirement),
  "schedulingRuleOverrides": {
    object (SchedulingRuleOverrides)
  },
  "confirmationMode": enum (ConfirmationMode),
  "linkoutRequiredReason": enum (LinkoutRequiredReason)
}

string (Timestamp format)

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

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

string (Duration format)

משך המשבצת לפגישה

משך הזמן בשניות, עם עד תשע ספרות עשרוניות, שמסתיימים ב-'s'. דוגמה: "3.5s".

string (int64 format)

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

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

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

• חזרה מתייחסת ל-spotsTotal=1 ול-spotsOpen=1.
• הודעת ScheduleException מתייחסת ל-spotsTotal=1 ול-spotsOpen=0.

string (int64 format)

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

string

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

object (Resources)

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

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

availability { resources { staffId: "1" staffName: "Amy" }
               spotsTotal: 10 spotsOpen: 7 }
availability { resources { staffId: "2" staffName: "John" }
               spotsTotal: 5 spotsOpen: 2 }

string

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

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

object (Recurrence)

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

object (ScheduleException)

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

object (Deposit)

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

object (NoShowFee)

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

object (Prepayment)

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

enum (RequireCreditCard)

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

string

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

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

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

• שירות עם שלושה סוגי כרטיסים: TicketType {ticketTypeId: "adult" shortDescription: "Adult"} TicketType {ticketTypeId: "youth" shortDescription: "Youth"} TicketType {ticketTypeId: "senior" shortDescription: "Senior"}

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

(אופציונלי)

enum (DurationRequirement)

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

object (SchedulingRuleOverrides)

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

enum (ConfirmationMode)

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

enum (LinkoutRequiredReason)

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

{
  "staffId": string,
  "staffName": string,
  "roomId": string,
  "roomName": string,
  "partySize": integer,
  "roomDescription": {
    object (Text)
  }
}

string

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

string

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

string

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

string

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

integer

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

object (Text)

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

{
  "repeatUntil": string,
  "repeatEvery": string
}

string (Timestamp format)

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

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

string (Duration format)

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

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

משך הזמן בשניות, עם עד תשע ספרות עשרוניות, שמסתיימים ב-'s'. דוגמה: "3.5s".

{
  "timeRange": {
    object (TimeRange)
  }
}

object (TimeRange)

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

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

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

{
  "priceInfo": {
    object (PriceInfo)
  }
}

object (PriceInfo)

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

{
  "priceType": enum (PriceType),

  // Union field price_options can be only one of the following:
  "price": {
    object (Price)
  },
  "priceRange": {
    object (PriceRange)
  }
  // End of list of possible types for union field price_options.
}

enum (PriceType)

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

object (Price)

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

object (PriceRange)

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

{
  "minPrice": {
    object (Price)
  },
  "maxPrice": {
    object (Price)
  }
}

object (Price)

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

object (Price)

הסכום המקסימלי. הערך תמיד צריך להיות גדול מ-minPrice.

{
  "lastBookableSec": string,
  "firstBookableSec": string,
  "lastOnlineCancellableSec": string
}

string (int64 format)

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

string (int64 format)

הפעם הראשונה (בשניות) שבה אפשר להזמין את המרווח הזה. חותמת הזמן הזו חייבת להיות לפני startSec של המשבצת, או לפני lastBookableSec אם צוין.

string (int64 format)

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