YouTube Reporting API ו-YouTube Analytics API תומכים בפרוטוקול OAuth 2.0 להרשאת גישה לנתוני משתמשים פרטיים. ברשימה הבאה מוסבר על כמה מהמושגים המרכזיים של OAuth 2.0:
-
כשמשתמש מנסה בפעם הראשונה להשתמש בפונקציה באפליקציה שמחייבת אותו להתחבר ל-Google Account or YouTube account, האפליקציה מפעילה את תהליך ההרשאה של OAuth 2.0.
-
האפליקציה מפנה את המשתמש לשרת ההרשאות של Google. הקישור לדף מציין את
scopeשל הרשאת הגישה שהאפליקציה שלך מבקשת עבור חשבון המשתמש. השדהscopeמציין את המשאבים שהאפליקציה יכולה לאחזר, להוסיף, לעדכן או למחוק כשהיא פועלת בתור המשתמש המאומת. -
אם המשתמש מסכים לאשר לאפליקציה גישה למשאבים האלה, Google מחזירה לאפליקציה אסימון. בהתאם לסוג האפליקציה, האסימון מאומת או מוחלף באסימון מסוג אחר.
לדוגמה, אפליקציית אינטרנט בצד השרת ממירה את האסימון שהוחזר לאסימון גישה ולאסימון רענון. אסימון הגישה מאפשר לאפליקציה לאשר בקשות בשם המשתמש, ואסימון הרענון מאפשר לאפליקציה לאחזר אסימון גישה חדש כשפג התוקף של אסימון הגישה המקורי.
חשוב: כדי להשתמש בהרשאה של OAuth 2.0, צריך לקבל את פרטי הכניסה להרשאה במסוף Google API.
פרטים נוספים זמינים במדריך ההרשאות של OAuth 2.0.
תהליכים של OAuth 2.0
ממשקי Google API תומכים בכמה תרחישים לדוגמה של OAuth 2.0:
- התהליך אפליקציות אינטרנט בצד השרת תומך באפליקציות אינטרנט שיכולות לאחסן מידע קבוע באופן מאובטח.
- התהליך אפליקציות אינטרנט של JavaScript תומך באפליקציות JavaScript שפועלות בדפדפן.
- התהליך אפליקציות לנייד ולמחשב תומך באפליקציות שמותקנות במכשיר, כמו טלפון או מחשב.
- התהליך של OAuth 2.0 לטלוויזיות ולמכשירים עם יכולות קלט מוגבלות תומך במכשירים עם יכולות קלט מוגבלות, כמו קונסולות משחקים ומצלמות וידאו. The YouTube Reporting and YouTube Analytics APIs do not currently support the OAuth 2.0 flow for devices.
- תהליך OAuth 2.0 לזרימת חשבון שירות תומך באינטראקציות שרת-אל-שרת שלא ניגשות לפרטי משתמשים. עם זאת, הווידג'טים YouTube Reporting API ו-YouTube Analytics API לא תומכים בתהליך הזה. Since there is no way to link a Service Account to a YouTube account, attempts to authorize requests with this flow will generate an error.
זיהוי היקפי הגישה
היקפי הרשאות מאפשרים לאפליקציה לבקש גישה רק למשאבים שנחוצים לה, וגם מאפשרים למשתמשים לקבוע את רמת הגישה שהם מעניקים לאפליקציה. לכן, יכול להיות שיש קשר הפוך בין מספר ההיקפים המבוקשים לבין הסבירות לקבלת הסכמה מהמשתמשים.
לפני שמתחילים להטמיע הרשאה מסוג OAuth 2.0, מומלץ לזהות את היקפי ההרשאות שאליהם האפליקציה תצטרך גישה.
ממשק ה-API של YouTube Analytics משתמש בהיקפים הבאים:
| טווחים | |
|---|---|
| https://www.googleapis.com/auth/youtube | ניהול חשבון YouTube שלך |
| https://www.googleapis.com/auth/youtube.readonly | הצגת חשבון YouTube שלך |
| https://www.googleapis.com/auth/youtubepartner | הצגה וניהול של הנכסים והתכנים הקשורים שלך ב-YouTube |
| https://www.googleapis.com/auth/yt-analytics-monetary.readonly | הצגת דוחות כספיים ואחרים של YouTube Analytics לתוכן שלך ב-YouTube |
| https://www.googleapis.com/auth/yt-analytics.readonly | עיון בדוחות YouTube Analytics עבור התוכן שלך ב-YouTube |
ב-YouTube Reporting API נעשה שימוש בהיקפים הבאים:
| טווחים | |
|---|---|
| https://www.googleapis.com/auth/yt-analytics-monetary.readonly | הצגת דוחות כספיים ואחרים של YouTube Analytics לתוכן שלך ב-YouTube |
| https://www.googleapis.com/auth/yt-analytics.readonly | עיון בדוחות YouTube Analytics עבור התוכן שלך ב-YouTube |
המסמך היקפי API של OAuth 2.0 מכיל רשימה מלאה של היקפים שבהם תוכלו להשתמש כדי לגשת ל-Google APIs.