המסמך מכיל פרטי אימות והרשאה ספציפיים ל-API של מרכז ההתראות. לפני שתקראו את המסמך הזה, כדאי לקרוא את המידע הכללי בנושא אימות והרשאה של Google Workspace במאמר מידע על אימות והרשאה.
הגדרת OAuth 2.0 להרשאה
צריך להגדיר את מסך ההסכמה ל-OAuth ולבחור היקפים כדי להגדיר איזה מידע יוצג למשתמשים ולבודקים של האפליקציות, ולרשום את האפליקציה כדי שתוכלו לפרסם אותה מאוחר יותר.
היקפי API של דוחות
כדי להגדיר את רמת הגישה שהוענקה לאפליקציה, עליכם לזהות היקפי הרשאות ולהצהיר עליהם. היקף הרשאה הוא מחרוזת URI של OAuth 2.0 שכוללת את השם של אפליקציית Google Workspace, סוגי הנתונים שאליהם האפליקציה ניגשת ורמת הגישה. היקפים הם הבקשות של האפליקציה לעבוד עם נתוני Google Workspace, כולל נתונים של חשבונות Google של משתמשים.
כשמתקינים את האפליקציה, המשתמשים מתבקשים לאמת את ההיקפים שבהם האפליקציה משתמשת. באופן כללי, כדאי לבחור את ההיקף הצר ביותר שאפשר, ולהימנע מבקשות להיקפים שלא נדרשים לאפליקציה. המשתמשים מעניקים גישה להיקפים מוגבלים ומתוארים בצורה ברורה יותר.
ה-Reports API תומך בהיקפים הבאים:
| רמות | משמעות |
|---|---|
https://www.googleapis.com/auth/admin.reports.audit.readonly |
הצגת דוחות ביקורת לדומיין שלך ב-Google Workspace |
https://www.googleapis.com/auth/admin.reports.usage.readonly |
הצגת דוחות שימוש לדומיין שלך ב-Google Workspace |