התחלה מהירה של JavaScript

במדריך למתחילים מוסבר איך מגדירים בקשה פשוטה לשליחת בקשות ל-YouTube Data API. במדריך למתחילים מוסבר למעשה איך ליצור שתי בקשות API:

  1. תשתמשו במפתח API, שמזהה את האפליקציה שלכם, כדי לאחזר מידע על ערוץ YouTube של Google Developers.
  2. כדי לשלוח בקשה מורשית לאחזור מידע על ערוץ YouTube שלכם, עליכם להשתמש במספר לקוח OAuth 2.0.

דרישות מוקדמות

כדי להריץ את המדריך המהיר הזה, צריך:

  • Python 2.4 ואילך (כדי לספק שרת אינטרנט)
  • גישה לאינטרנט ולדפדפן אינטרנט.
  • חשבון Google.

שלב 1: מגדירים את הפרויקט ופרטי הכניסה

יוצרים או בוחרים פרויקט ב-API Console. ב-API Console מבצעים את המשימות הבאות עבור הפרויקט שלכם:

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

  2. בחלונית פרטי הכניסה, צרו שני פרטי כניסה:

    1. יצירת מפתח API משתמשים במפתח ה-API כדי לשלוח בקשות API שלא דורשות הרשאת משתמש. לדוגמה, אין צורך בהרשאת משתמש כדי לאחזר מידע על ערוץ YouTube ציבורי.

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

      בשדה מקורות JavaScript מורשים, מזינים את כתובת ה-URL http://localhost:8000. תוכלו להשאיר את השדה URIs מורשים להפניה מחדש ריק.

שלב 2: הגדרה והפעלה של הדוגמה

בעזרת הווידג'ט של APIs Explorer בחלונית הצדדית תוכלו לקבל קוד לדוגמה לאחזור מידע על ערוץ YouTube של Google Developers. הבקשה הזו משתמשת במפתח API כדי לזהות את האפליקציה שלכם, והיא לא דורשת הרשאה של משתמש או הרשאות מיוחדות מהמשתמש שמריץ את הדוגמה.

  1. פותחים את התיעוד לגבי שיטת channels.list ב-API.

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

    לוחצים על סמל הקוד של פרופיל העסק הראשון כדי לפתוח ולמלא את ה-API במסך מלא.

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

  3. צד ימין של APIs במסך מלא של Explorer מציג את הדברים הבאים:

    1. מתחת לכותרת בקשת פרמטרים, מופיעה רשימה של פרמטרים שנתמכים בשיטה. יש להגדיר את ערכי הפרמטרים part ו-id. ערך הפרמטר id, UC_x5XG1OV2P6uZZ5FSM9Ttw, הוא המזהה של ערוץ YouTube ב-Google Developers.

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

      תמונה שמוצגת עבורה 'Credentials' ב-APIs במסך מלא, ובתפריט הנפתח עם האפשרות 'מפתח API'.

  4. בצד שמאל של ה-APIs של מסך מלא מוצגות כרטיסיות עם דוגמאות קוד בשפות שונות. בוחרים בכרטיסייה JavaScript.

  5. מעתיקים את דוגמת הקוד ושומרים אותה בקובץ בשם example.html.

  6. בדוגמה שהורדתם, מאתרים את המחרוזת YOUR_API_KEY ומחליפים אותה במפתח ה-API שיצרתם בשלב 1 של המדריך למתחילים.

  7. הפעל את שרת האינטרנט באמצעות הפקודה הבאה מספריית העבודה שלך:

    Python

    python -m SimpleHTTPServer 8000

    Python

    python -m http.server 8000

  8. פותחים את הקובץ example.html בדפדפן. פותחים גם את הכלים למפתחים בדפדפן, כמו 'כלים למפתחים' בדפדפן Chrome.

    1. לחצו על הלחצן load בדף כדי לטעון את ספריית הלקוח של Google APIs ל-JavaScript. אחרי הלחיצה על הלחצן, במסוף המפתחים צריכה להופיע הערה המציינת שהלקוח GAPI נטען.

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

שלב 3: הרצת בקשה מורשית

בשלב הזה, תערכו שינויים בדוגמת הקוד כך שבמקום לאחזר מידע על ערוץ YouTube של Google Developers, הוא יאחזר מידע על ערוץ שלכם ב-YouTube. לבקשה זו נדרשת הרשאת משתמש.

  1. חזרו למסמכי התיעוד של שיטת channels.list ב-API.

  2. בקטע "תרחישים נפוצים", לחצו על סמל הקוד של הדף השלישי בטבלה. תרחיש לדוגמה כזה הוא להפעיל את השיטה list ל'ערוץ שלי'.

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

    1. בקטע הפרמטרים, במקום הערך של הפרמטר id, צריך להגדיר את ערך הפרמטר mine כ-true. כך השרת של ה-API יכול לאחזר מידע על הערוץ של המשתמש המאומת כרגע.

    2. בקטע Credentials, התפריט הנפתח צריך לבחור את האפשרות של Google OAuth 2.0.

      כמו כן, אם לוחצים על הקישור Show scopes, צריך לסמן את ההיקף בכתובת https://www.googleapis.com/auth/youtube.readonly.

      תמונה שמציגה היקפים ב-APIs Explorer במסך מלא, ואת האפשרות להשתמש בפרטי הכניסה 'Google OAuth 2.0'.

  4. כמו בדוגמה הקודמת, בחרו בכרטיסייה JavaScript, העתיקו את דוגמת הקוד ושמרו אותה ב-example.html.

    בקוד, מאתרים את המחרוזת YOUR_CLIENT_ID ומחליפים אותה במזהה הלקוח שיצרתם בשלב 1 של המדריך למתחילים.

  5. הפעל את שרת האינטרנט באמצעות הפקודה הבאה מספריית העבודה שלך:

    Python

    python -m SimpleHTTPServer 8000

    Python

    python -m http.server 8000

  6. יש לעבור אל הקובץ http://localhost:8000/example.html בדפדפן. פותחים את הכלים למפתחים בדפדפן, כמו 'כלים למפתחים' בדפדפן Chrome.

  7. לוחצים על הלחצן Authorized and load בדף כדי לטעון את ספריית Google APIs Client for JavaScript ולהתחיל את תהליך ההרשאה. אמורה להופיע בקשה להעניק לאפליקציה הרשאה לקרוא נתונים מחשבון YouTube שלכם.

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

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

קריאה נוספת