מדריך למתחילים בנושא Java

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

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

הערה: באופן כללי, אפשר לפעול לפי ההוראות בדוגמה הראשונה לכל תרחיש שימוש שבו נעשה שימוש במפתח API, או לפי ההוראות בדוגמה השנייה לכל תרחיש שימוש שבו נדרש אישור באמצעות OAuth 2.0. כאן תוכלו לראות עוד דוגמאות לתרחישי שימוש ודוגמאות קוד.

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

כדי להפעיל את המדריך למתחילים הזה, אתם צריכים:

• ‫Java 1.7 ואילך.
• ‫Gradle 2.3 ואילך.
• גישה לאינטרנט ולדפדפן אינטרנט.
• חשבון Google.

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

יוצרים פרויקט או בוחרים פרויקט במסוף Cloud. מבצעים את המשימות הבאות במסוף Cloud בפרויקט:

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

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

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

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

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

שלב 2: הכנת הפרויקט

כדי להכין את פרויקט Gradle, מבצעים את השלבים הבאים:

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

   $ gradle init --type basic
   $ mkdir -p src/main/java src/main/resources
   

2. מעבירים את קובץ ה-JSON שהורדתם אחרי שיצרתם את מזהה הלקוח OAuth 2.0 לספרייה src/main/resources שמתחת לספריית העבודה, ומשנים את שם הקובץ ל-client_secret.json.

3. פותחים את הקובץ build.gradle בספריית העבודה ומחליפים את התוכן שלו בתוכן הבא:

   apply plugin: 'java'
   apply plugin: 'application'
   
   mainClassName = 'ApiExample'
   sourceCompatibility = 1.7
   targetCompatibility = 1.7
   version = '1.0'
   
   repositories {
       mavenCentral()
   }
   
   dependencies {
       compile 'com.google.api-client:google-api-client:1.23.0'
       compile 'com.google.oauth-client:google-oauth-client-jetty:1.23.0'
       compile 'com.google.apis:google-api-services-youtube:v3-revREVISION-CL_VERSION'
   }

4. בקובץ build.gradle צריך להחליף את המשתנים REVISION ו-CL_VERSION בשני ערכים ממסמכי ספריית הלקוח של YouTube Data API. בצילום המסך שלמטה, שבו מוצגת התיעוד של YouTube Analytics API, אפשר לראות איפה מופיעים שני המשתנים בדף.

   

שלב 3: מגדירים ומריצים את הדוגמה

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

1. פותחים את מאמרי העזרה של ה-API בנושא השיטה channels.list.

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

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

   

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

   1. מתחת לכותרת Request parameters (פרמטרים של בקשה), מופיעה רשימה של פרמטרים שהשיטה תומכת בהם. צריך להגדיר את ערכי הפרמטרים part ו-id. ערך הפרמטר id, UC_x5XG1OV2P6uZZ5FSM9Ttw, הוא המזהה של ערוץ YouTube של GoogleDevelopers.

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

      

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

5. מעתיקים את הקוד לדוגמה ושומרים אותו בקובץ בשם src/main/java/ApiExample.java. כל דוגמה משתמשת באותו שם מחלקה (ApiExample) כדי שלא תצטרכו לשנות את הקובץ build.gradle כדי להריץ דוגמאות שונות.

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

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

   gradle -q run

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

שלב 4: הפעלת בקשה מורשית

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

1. חוזרים למאמרי העזרה של ה-API של השיטה channels.list.

2. בקטע 'תרחישי שימוש נפוצים', לוחצים על סמל הקוד של הרישום השלישי בטבלה. תרחיש השימוש הזה הוא קריאה לשיטה list עבור 'my channel'.

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

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

   2. בקטע Credentials (פרטי כניסה), בתפריט הנפתח, בוחרים באפשרות Google OAuth 2.0.

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

      

4. כמו בדוגמה הקודמת, בוחרים בכרטיסייה Java, מעתיקים את דוגמת הקוד ושומרים אותה ב-src/main/java/ApiExample.java.

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

   gradle -q run

6. הדוגמה אמורה לנסות לפתוח חלון או כרטיסייה חדשים בדפדפן ברירת המחדל. אם הפעולה נכשלת, מעתיקים את כתובת ה-URL מהטרמינל ופותחים אותה בדפדפן באופן ידני.

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

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

8. הדגימה תמשיך באופן אוטומטי, ואפשר לסגור את כרטיסיית הדפדפן שבה נעשה שימוש בתהליך האימות.

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

קריאה נוספת

• מאמרי העזרה של Google Developers Console
• מאמרי העזרה של Google APIs Client Library for Java
• מאמרי העזרה של YouTube Data API Javadoc
• מאמרי עזרה בנושא YouTube Data API