דף זה תורגם על ידי Cloud Translation API.

Events: watch

לעקוב אחרי שינויים במשאבים של Events.

בקשה

POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/watch

שם הפרמטר	ערך	תיאור
פרמטרים של נתיב
`calendarId`	`string`	מזהה היומן. כדי לאחזר מזהי יומנים, צריך להפעיל את השיטה calendarList.list. כדי לגשת ליומן הראשי של המשתמש שמחובר כרגע, משתמשים במילות המפתח `primary`.
פרמטרים אופציונליים של שאילתות
`eventTypes`	`string`	סוגי האירועים של המשאבים שרוצים לעקוב אחריהם. זה שינוי אופציונלי. אפשר לחזור על הפרמטר הזה כמה פעמים כדי לעקוב אחרי משאבים מסוגים שונים. אם לא מגדירים ערך, המערכת מחזירה את כל סוגי האירועים. הערכים הקבילים הם: '`birthday`': אירועים מיוחדים של יום שלם עם חזרה שנתית. '`default`': אירועים רגילים. '`focusTime`': אירועי 'זמן לעצמי'. '`fromGmail`': אירועים מ-Gmail. '`outOfOffice`': אירועים מסוג 'לא בעבודה'. "`workingLocation`": אירועים של מיקום עבודה.

הבקשה הזו מאפשרת הרשאה עם לפחות אחד מההיקפים הבאים:

היקף
`https://www.googleapis.com/auth/calendar.readonly`
`https://www.googleapis.com/auth/calendar`
`https://www.googleapis.com/auth/calendar.events.readonly`
`https://www.googleapis.com/auth/calendar.events`

מידע נוסף זמין בדף אימות והרשאה.

בגוף הבקשה, מספקים נתונים במבנה הבא:

{
  "id": string,
  "token": string,
  "type": string,
  "address": string,
  "params": {
    "ttl": string
  }
}

שם הנכס	ערך	תיאור
`id`	`string`	מזהה ייחודי אוניברסלי (UUID) או מחרוזת ייחודית דומה המזהה את הערוץ הזה.
`token`	`string`	מחרוזת שרירותית שנשלחת לכתובת היעד עם כל התראה שנשלחת דרך הערוץ הזה. זה שינוי אופציונלי.
`type`	`string`	סוג מנגנון הצגת המודעות שבו נעשה שימוש בערוץ הזה. הערכים החוקיים הם `web_hook` (או `webhook`). שני הערכים מתייחסים לערוץ שבו נעשה שימוש בבקשות Http כדי להעביר הודעות.
`address`	`string`	הכתובת שאליה יישלחו ההתראות מהערוץ הזה.
`params`	`object`	פרמטרים נוספים ששולטים בהתנהגות של ערוץ הצגת המודעות. זה שינוי אופציונלי.
`params.ttl`	`string`	אורך החיים בשניות בערוץ ההתראות. ברירת המחדל היא 604,800 שניות.

אם הפעולה בוצעה ללא שגיאות, ה-method מחזיר גוף תגובה עם המבנה הבא:

{
  "kind": "api#channel",
  "id": string,
  "resourceId": string,
  "resourceUri": string,
  "token": string,
  "expiration": long
}

שם הנכס	ערך	תיאור
`kind`	`string`	זהו ערוץ התראות שמשמש למעקב אחרי שינויים במשאב '`api#channel`'.
`id`	`string`	מזהה ייחודי אוניברסלי (UUID) או מחרוזת ייחודית דומה המזהה את הערוץ הזה.
`resourceId`	`string`	מזהה אטום שמזהה את המשאב שצופים בו בערוץ הזה. יציבה בגרסאות שונות של ה-API.
`resourceUri`	`string`	מזהה ספציפי לגרסה של המשאב במעקב.
`token`	`string`	מחרוזת שרירותית שנשלחת לכתובת היעד עם כל התראה שנשלחת דרך הערוץ הזה. זה שינוי אופציונלי.
`expiration`	`long`	התאריך והשעה של תפוגת ערוץ ההתראות, כפי שמוצגים כחותמת זמן של מערכת Unix, באלפיות שנייה. זה שינוי אופציונלי.