בחירת היקפים של Google Drive Labels API

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

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

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

היקפי ההרשאות של Google Drive Labels API

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

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

במידת האפשר, מומלץ להשתמש בהיקפי גישה לא רגישים, כי הם מאפשרים גישה לכל קובץ ומצמצמים את הגישה לפונקציונליות ספציפית שנדרשת לאפליקציה.

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

אפשר להשתמש בהיקפי ההרשאות הבאים של OAuth 2.0 כדי לקרוא, לחפש ולשנות מטא נתונים של תוויות שמוחלות על פריטים ב-Drive:

היקף	משמעות
https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive.metadata	לקרוא, לחפש ולשנות מטא-נתונים של תוויות שהוחלו על פריטים ב-Drive.
https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly	קריאה וחיפוש של מטא-נתונים של תוויות שהוחלו על פריטים ב-Drive שהאפליקציה קיבלה הרשאה לגשת אליהם.

מידע נוסף זמין במאמרים בנושא היקפי OAuth 2.0 ב-Drive API והרשאה ספציפית ל-Drive API.

היקפים של תוויות

אפשר להשתמש בהיקפי ההרשאות הבאים של OAuth כדי להציג ולנהל תוויות:

היקף	משמעות
https://www.googleapis.com/auth/drive.labels	הצגה, שימוש וניהול של תוויות ב-Drive. ההיקף הזה מאפשר גישת משתמשים, והוא נדרש לפעולות כתיבה כשההגדרה use_admin_access לא מוגדרת. פעולות כתיבה בהיקף הזה תקפות לתוויות עם SHARED סוג התווית.
https://www.googleapis.com/auth/drive.labels.readonly	הצגה ושימוש בתוויות ב-Drive. ההיקף הזה מאפשר גישת משתמשים, והוא נדרש לפעולות קריאה אם לא מוגדר use_admin_access.
https://www.googleapis.com/auth/drive.admin.labels	הצגה, עריכה, יצירה ומחיקה של כל התוויות ב-Drive בארגון שלכם, והצגה של מדיניות הניהול שקשורה לתוויות בארגון. ההיקף הזה מאפשר גישת אדמין, והוא נדרש לפעולות כתיבה כשההגדרה use_admin_access מופעלת. ההיקף הזה מעניק גם הרשאת קריאה. פעולות כתיבה בהיקף הזה תקפות לתוויות עם SHARED או ADMIN סוג התווית.
https://www.googleapis.com/auth/drive.admin.labels.readonly	הצגת כל התוויות ב-Drive ומדיניות הניהול שקשורה לתוויות בארגון. ההיקף הזה מאפשר גישת אדמין, והוא נדרש לפעולות קריאה כשההגדרה use_admin_access מוגדרת.

הרשאת אדמין

הערה: אי אפשר להשתמש בתווית EDITOR LabelRole עם תוויות ADMIN. כדי לנהל תוויות ADMIN

נדרשות הרשאות אדמין.

כדי לנהל תוויות של ADMIN, צריך לציין:

• ‫useAdminAccess is true כדי להשתמש בפרטי הכניסה של האדמין של המשתמש.
• אדמינים בחשבון עם ההרשאה ניהול תוויות.

useAdminAccess

אדמינים צריכים להגדיר את הפרמטר useAdminAccess כדי להפעיל את הרשאות האדמין שלהם. ההגדרה useAdminAccess מאפשרת צפייה בכל תווית שנמצאת בבעלות הלקוח ועריכה שלה. הנתונים האלה כוללים גם לייבלים של ADMIN וגם לייבלים של SHARED.

אם לא מגדירים את useAdminAccess, בקשות כתיבה מותרות רק לתוויות עם SHARED label type ולמשתמשים עם התפקיד המתאים EDITOR לתווית הזו.

מידע נוסף זמין במאמר בנושא יצירת פרטי גישה.