בחירת היקפים של ממשק ה-API של יומן Google

במסמך הזה מפורט מידע על אימות והרשאות שספציפיים ל-Google Calendar API. לפני שקוראים את המסמך הזה, חשוב לקרוא את המידע הכללי על אימות והרשאה ב-Google Workspace במאמר מידע על אימות והרשאה.

הגדרת OAuth 2.0 למתן הרשאות

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

היקפי הגישה של Calendar API

כדי להגדיר את רמת הגישה שניתנת לאפליקציה, צריך לזהות ולהצהיר על היקפי הרשאות. היקף הרשאות הוא מחרוזת URI של OAuth 2.0 שמכילה את שם אפליקציית Google Workspace, את סוג הנתונים שהיא ניגשת אליהם ואת רמת הגישה. ההיקפים הם הבקשות של האפליקציה לעבוד עם נתוני Google Workspace, כולל נתוני חשבון Google של המשתמשים.

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

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

‫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	לראות את האירועים ביומנים גלויים לכולם.