התחלה מהירה ב-Python

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

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

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

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

  • Python

  • הכלי לניהול חבילות של pip

  • ספריית הלקוח של Google APIs ל-Python:

    pip install --upgrade google-api-python-client

  • הספריות google-auth-oauthlib ו-google-auth-httplib2 למתן הרשאה למשתמשים

    pip install --upgrade google-auth-oauthlib google-auth-httplib2

שלב 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 של המשתמש המאומת.

      יש להוריד את קובץ ה-JSON שמכיל את פרטי הכניסה של OAuth 2.0. לקובץ יש שם כמו client_secret_CLIENTID.json, שבו CLIENTID הוא מזהה הלקוח של הפרויקט.

שלב 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 של מסך מלא מוצגות כרטיסיות עם דוגמאות קוד בשפות שונות. בוחרים בכרטיסייה Python.

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

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

  7. הרצת הדוגמה משורת הפקודה. בספריית העבודה:

    python example.py

  8. הדוגמה צריכה לבצע את הבקשה ולהדפיס את התגובה ב-STDOUT.

שלב 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. כמו בדוגמה הקודמת, בחרו בכרטיסייה Python, העתיקו את דוגמת הקוד ושמרו אותה ב-example.py.

    בקוד, מאתרים את המחרוזת YOUR_CLIENT_SECRET_FILE.json ומחליפים אותה במיקום של הקובץ הסודי של הלקוח שהורדתם בשלב 1 של המדריך למתחילים.

  5. הרצת הדוגמה משורת הפקודה. בספריית העבודה:

    python example.py

  6. מעתיקים את כתובת ה-URL מהמסוף ופותחים אותה בדפדפן.

    אם אתם עדיין לא מחוברים לחשבון Google, תתבקשו להתחבר. אם אתם מחוברים למספר חשבונות Google, תתבקשו לבחור חשבון אחד שישמש להרשאה.

  7. לחצו על הלחצן כדי לתת לאפליקציה גישה להיקפים שצוינו בדוגמת הקוד.

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

    תגובת ה-API צריכה להיות מודפסת שוב אל STDOUT.

קריאה נוספת