המסמך הזה מכיל מידע ספציפי לגבי הרשאות ואימות ב-Google Calendar API. לפני קריאת המסמך הזה, חשוב לקרוא את המידע הכללי על אימות והרשאה ב-Google Workspace במאמר מידע על אימות והרשאה.
הגדרת OAuth 2.0 להרשאה
מגדירים את מסך ההסכמה של OAuth ובוחרים היקפי הרשאה כדי לקבוע איזה מידע יוצג למשתמשים ולבודקים של האפליקציה, ומרשמים את האפליקציה כדי שתוכלו לפרסם אותה בהמשך.
היקפי הרשאה של Calendar API
כדי להגדיר את רמת הגישה שמוענקת לאפליקציה, צריך לזהות ולדווח על היקפי הרשאה. היקף הרשאה הוא מחרוזת URI של OAuth 2.0 שמכילה את שם האפליקציה ב-Google Workspace, את סוג הנתונים שהיא ניגשת אליהם ואת רמת הגישה. היקפים הם הבקשות של האפליקציה לעבוד עם נתוני Google Workspace, כולל נתונים מחשבון Google של המשתמשים.
כשהאפליקציה מותקנת, המשתמש מתבקש לאמת את ההיקפים שבהם האפליקציה משתמשת. באופן כללי, כדאי לבחור את ההיקף המצומצם ביותר האפשרי ולהימנע מבקשות להיקפים שלא נדרשים לאפליקציה. משתמשים נותנים גישה בקלות רבה יותר להיקפים מוגבלים ומתוארים בבירור.
ה-Calendar API תומך בהיקפים הבאים:
| היקף | משמעות |
|---|---|
https://www.googleapis.com/auth/calendar |
הצגה, עריכה ומחיקה סופית של כל היומנים שאליהם יש לכם גישה דרך יומן Google. |
https://www.googleapis.com/auth/calendar.readonly |
הצגה והורדה של כל יומן שאליו יש לך גישה דרך יומן Google. |
https://www.googleapis.com/auth/calendar.freebusy |
הצגת הזמינות שלכם ביומנים שלכם. |
https://www.googleapis.com/auth/calendar.events |
הצגה ועריכה של אירועים בכל היומנים שלכם. |
https://www.googleapis.com/auth/calendar.events.readonly |
הצגת אירועים בכל היומנים שלכם. |
https://www.googleapis.com/auth/calendar.settings.readonly |
הצגת ההגדרות של יומן Google. |
https://www.googleapis.com/auth/calendar.addons.execute |
הפעלה בתור תוסף ליומן Google. |
https://www.googleapis.com/auth/calendar.addons.current.event.read |
הצגת האירועים שפתחתם ביומן Google. |
https://www.googleapis.com/auth/calendar.addons.current.event.write |
לערוך את האירועים שפותחים ביומן Google. |
https://www.googleapis.com/auth/calendar.events.owned |
לראות, ליצור, לשנות ולמחוק אירועים ביומני Google שבבעלותכם. |
https://www.googleapis.com/auth/calendar.events.owned.readonly |
לראות אירועים ביומני Google שבבעלותכם. |
https://www.googleapis.com/auth/calendar.events.freebusy |
לראות את הזמינות ביומני Google שיש לכם גישה אליהם. |
https://www.googleapis.com/auth/calendar.app.created |
ליצור יומני Google משניים ולראות, ליצור, לשנות ולמחוק אירועים בהם. |
https://www.googleapis.com/auth/calendar.calendarlist |
לראות, להוסיף ולהסיר יומני Google שיש לכם מינוי אליהם. |
https://www.googleapis.com/auth/calendar.calendarlist.readonly |
לראות את הרשימה של יומני Google שיש לכם מינוי אליהם. |
https://www.googleapis.com/auth/calendar.calendars |
לראות ולשנות את התכונות של יומני Google שאליהם יש לכם גישה, וליצור יומנים משניים. |
https://www.googleapis.com/auth/calendar.calendars.readonly |
לראות את הכותרת, התיאור, אזור הזמן בברירת מחדל ומאפיינים אחרים של יומני Google שיש לכם גישה אליהם. |
https://www.googleapis.com/auth/calendar.acls |
לראות ולשנות את הרשאות השיתוף של יומני Google שבבעלותכם. |
https://www.googleapis.com/auth/calendar.acls.readonly |
לראות את הרשאות השיתוף של יומני Google שבבעלותך. |
https://www.googleapis.com/auth/calendar.events.public.readonly |
לראות את האירועים ביומנים גלויים לכולם. |