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