הוצאה משימוש של YouTube Data API גרסה 2: שאלות נפוצות

האפליקציה שלי מסתמכת על תגובות, כתוביות או פונקציונליות אחרת שלא קיימת ב-YouTube Data API גרסה 3. מה לעשות?

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

בנוסף, ככל ש-YouTube ממשיך להתפתח, לא תהיה התאמה מלאה בין התכונות של API גרסה 2 לבין התכונות של API גרסה 3. פרטים נוספים על הפונקציונליות שנתמכת בגרסה 3 זמינים במסמכי התיעוד של v3 API.

בגרסה 2, אפשר לבצע אימות באמצעות כתובת אימייל + סיסמה דרך ClientLogin. איך אפשר לעבור ל-OAuth 2.0?

מומלץ לעיין במדריך שלנו בנושא מעבר מ-ClientLogin ל-OAuth 2.0.

מה ההבדל בין מכסת השימוש בגרסה 2 לבין מכסת השימוש בגרסה 3? מה הדמיון ביניהם?

גם בגרסה 2 וגם בגרסה 3 נעשה שימוש במערכת מכסות שמבוססת על עלות, שבה פעולות מסוימות (כמו העלאות) צורכות כמות גדולה יותר של מכסה מאשר פעולות אחרות (כמו חיפושים).

ההבדל המשמעותי ביותר בין מערכות v2 ו-v3 הוא שבמערכת v3 יש מאגר גלובלי של מכסות, שלא היה קיים במערכת v2. במערכת v2, בקשות שבוצעו באמצעות מפתח מפתח יחיד, אבל הגיעו מכתובות IP שונות או ממשתמשים מאומתים שונים, לא יכלו לגרום לשגיאות מכסה גלובליות עבור מפתח המפתח הזה. המקרה הכי גרוע שיכול היה לקרות הוא שגיאת מכסה מקומית שמשויכת לכתובת ה-IP או לערוץ YouTube.

בגרסה 3, יש מאגר מכסות גלובלי (של 50 מיליון יחידות ביום), וכל קריאות ה-API שמשויכות לפרויקט ספציפי ב-Developers Console מפחיתות את המכסה מהמאגר הזה. לכן, באופן תיאורטי, יכול להיות שכתובת IP או ערוץ יחידים ינצלו את כל המכסה שמשויכת לרישום API, מה שעלול לגרום להפסקת שירות שתשפיע על משתמשים אחרים.

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

‫Data API גרסה 2 תמך בגישה אנונימית ל-API עבור שאילתות לקריאה בלבד, כמו חיפושי סרטונים. למה צריך להירשם כדי לבצע קריאות לקריאה בלבד בגרסה 3?

‫v3 API מבוסס על התשתית המודרנית של Google API, שבה השימוש בממשקי API רבים ושונים יכול להיות קשור לרישום ספציפי ב-Developer Console. כך המפתחים מקבלים תצוגה מאוחדת של טכנולוגיות Google שבהן הם משתמשים.

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

מפתחים יכולים לקבל מפתחות API פשוטים ואת פרטי הכניסה שנדרשים ליצירת אסימוני OAuth 2.0 ב-Google Developers Console. מפתחים יכולים גם לבדוק את ה-API בלי ליצור פרויקט קודם באמצעות APIs Explorer.

אחרי המעבר לגרסה 3, האם אפשר להמשיך להשתמש באותן ספריות לקוח שבהן השתמשתי בגרסה 2?

ממשק v3 API שונה באופן מהותי מ-v2, ויש להשתמש בסדרה חדשה של ספריות לקוח. כולן זמינות בכתובת https://developers.google.com/youtube/v3/libraries, וכולן כוללות תמיכה מקורית בהרשאה של OAuth 2.

בעבר השתמשתי ב-YouTube Insight API, שהוא חלק מגרסה 2. מה האפשרות החלופית שלי?

מומלץ לכל המפתחים לעבור מ-YouTube Insight API, שהוצא משימוש בנפרד בספטמבר 2013, אל YouTube Analytics API החדש.

אני מסתמך על GData API (גרסה 1 או גרסה 2) כדי לקבל פידים של RSS/Atom של סרטוני YouTube. האם יש לי חלופות אחרי שהם יוצאו משימוש?

אין כרגע חלופה ישירה. אנחנו ממליצים לספק למשתמשי האפליקציה את האפשרות לנהל את המינויים שלהם ל-YouTube ולאחזר אותם באמצעות השיטות של שירות המינויים ב-YouTube Data API v3.

מכיוון שאני עדיין משתמש בחלק מהתכונות של גרסה 2 שלא זמינות עדיין בגרסה 3, אני צריך לגשת לשתי גרסאות ה-API באותה אפליקציה. מהן כמה שיטות מומלצות?

אפשר להשתמש בתמיכה ב-OAuth 2.0 בספריות הלקוח של גרסה 3 כדי לקבל אסימוני הרשאה שיפעלו לפעולות כתיבה גם בגרסה 2 וגם בגרסה 3. כל טוקן עם ההיקף https://gdata.youtube.com או https://www.googleapis.com/auth/youtube יפעל בשני ממשקי ה-API.

לקריאות ל-API שלא דורשות אסימוני OAuth 2.0, צריך לקבל מפתח API מגרסה 3 מכתובת https://cloud.google.com/console ולהשתמש בו גם לגרסה 2 וגם לגרסה 3.

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