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

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

הגדרת OAuth 2.0 להרשאה

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

היקפי ההרשאות של Slides API

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

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

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

Slides API תומך בהיקפים הבאים:

קוד היקף ההרשאות תיאור שימוש
https://www.googleapis.com/auth/presentations הצגה, עריכה, יצירה ומחיקה של כל המצגות שלך ב-Google Slides. רגישות
https://www.googleapis.com/auth/presentations.readonly הצגת כל המצגות שלך ב-Google Slides. רגישות
https://www.googleapis.com/auth/spreadsheets ראייה, עריכה, יצירה ומחיקה של כל הגיליונות האלקטרוניים שלך ב-Google Sheets. רגישות
https://www.googleapis.com/auth/spreadsheets.readonly הצגת כל הגיליונות האלקטרוניים שלך ב-Google Sheets. רגישות
https://www.googleapis.com/auth/drive.file להציג, לערוך, ליצור ולמחוק רק את הקבצים הספציפיים ב-Google Drive שאתם לשימוש עם האפליקציה הזו. מומלץ
לא רגיש
https://www.googleapis.com/auth/drive להציג, לערוך, ליצור ולמחוק את כל הקבצים שלך ב-Google Drive. מוצר שהצפייה בו הוגבלה
https://www.googleapis.com/auth/drive.readonly הצגה והורדה של כל הקבצים שלך ב-Google Drive. מוצר שהצפייה בו הוגבלה

העמודה 'שימוש' בטבלה מציינת את הרגישות של כל היקף, בהתאם להגדרות הבאות:

  • לא רגיש: ההיקפים האלה מספקים את היקף ההרשאה הקטן ביותר נדרשת גישה ורק לאימות בסיסי של אפליקציות. לקבלת מידע נוסף לעיון בדרישות, אפשר לעיין במאמר שליחת האפליקציה אימות.

  • רגיש: ההיקפים האלה מספקים גישה לנתוני משתמשים ספציפיים ב-Google שאושר על ידי המשתמש עבור האפליקציה שלך. נדרשות לבצע אימות נוסף של אפליקציות. מידע נוסף על הדרישה הזו זמין במאמר היקף רגיש ומוגבל דרישות.

  • מוגבלת: ההיקפים האלה מספקים גישה רחבה לנתוני המשתמשים ב-Google וגם יידרשו לעבור תהליך אימות בהיקף מוגבל. עבור כדי ללמוד על הדרישה הזו, ראו נתוני משתמש בשירותי Google API מדיניות ודרישות נוספות ל-API ספציפי היקפים. אם אתם מאחסנים נתונים בהיקף מוגבל בשרתים (או משדרים), עליך לעבור הערכת אבטחה.

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

למידע נוסף על היקפים ספציפיים של OAuth 2.0, ראו היקפי OAuth 2.0 עבור Google APIs.