במסמך הזה מפורט מידע על הרשאות ואימות שספציפיים ל-Alert Center API. לפני שקוראים את המסמך הזה, חשוב לקרוא את המידע הכללי על אימות והרשאה ב-Google Workspace במאמר מידע על אימות והרשאה.
הגדרת OAuth 2.0 למתן הרשאות
מגדירים את מסך ההסכמה של OAuth ובוחרים היקפי הרשאה כדי להגדיר איזה מידע יוצג למשתמשים ולבודקי האפליקציה, ורושמים את האפליקציה כדי שתוכלו לפרסם אותה בהמשך.
היקפי הגישה של Alert Center API
כדי להגדיר את רמת הגישה שניתנת לאפליקציה, צריך לזהות ולהצהיר על היקפי הרשאות. היקף הרשאות הוא מחרוזת URI של OAuth 2.0 שמכילה את שם אפליקציית Google Workspace, את סוג הנתונים שהאפליקציה ניגשת אליהם ואת רמת הגישה. ההיקפים הם הבקשות של האפליקציה לעבוד עם נתוני Google Workspace, כולל נתוני חשבון Google של המשתמשים.
כשמתקינים את האפליקציה, המשתמש מתבקש לאמת את ההיקפים שבהם נעשה שימוש באפליקציה. בדרך כלל, מומלץ לבחור את ההיקף הממוקד ביותר האפשרי ולהימנע מבקשת היקפים שהאפליקציה לא צריכה. המשתמשים נוטים יותר להעניק גישה להיקפים מוגבלים שמתוארים בצורה ברורה.
ה-API של מרכז ההתראות תומך בהיקפי ההרשאות הבאים:
| טווחים | משמעות |
|---|---|
https://www.googleapis.com/auth/apps.alerts |
גישת קריאה וכתיבה ל-Alert Center API |
יצירה של חשבון שירות
כדי להשתמש ב-Alert Center API, צריך להשתמש בחשבון שירות ולהגדיר הענקת גישה ברמת הדומיין. פרטים נוספים זמינים במאמר בנושא יצירת פרטי כניסה לגישה.