שאלות נפוצות

כללי

מהי הגרסה האחרונה של ה-API?

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

למי יש גישה ל-API?

v1beta2 הגישה זמינה רק לפרויקטים ברשימת ההיתרים של Google APIs Console. הגישה למאמרי העזרה של ה-API נשלטת על ידי רשימת משתמשים נפרדת שמותרת לה גישה.

איך אפשר לדעת אם הפרויקט שלי במסוף נכלל ברשימת ההיתרים?

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

https://displayvideo.googleapis.com/$discovery/rest?version=v1beta2&labels=V1BETA2_TRUSTED_TESTER&key=API_KEY

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

שימוש ב-API

באיזו כתובת URL צריך להשתמש כדי לגשת ל-API?

https://displayvideo.googleapis.com

אילו שיטות אימות נתמכות?

‫OAuth 2.0 היא שיטת האימות הנתמכת היחידה. כל הבקשות צריכות להיות מאושרות להיקף הבא:

• https://www.googleapis.com/auth/display-video

אני רוצה לכתוב קוד. איפה אפשר למצוא ספריות לקוח?

Python

אפשר להשתמש ב-Google API Client Library for Python שזמינה לציבור כדי לגשת ל-API הזה. כדי להתקין את הספרייה וליצור אובייקט שירות מורשה, פועלים לפי השלבים הבאים.

1. התקנה של google-api-python-client

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

2. קבלת אובייקט מורשה מסוג credentials. דוגמה מופיעה במאמר הגדרת האפליקציה.

3. יוצרים אובייקט שירות מורשה באמצעות שירות הגילוי.

   api_key = 'API_KEY'
   api_name = 'displayvideo'
   api_url = 'https://%s.googleapis.com/' % api_name
   api_version = 'v1beta2'
   
   discovery_url = (
       '%s/$discovery/rest?key=%s&version=%s&labels=%s'
       % (api_url, api_key, api_version, 'V1BETA2_TRUSTED_TESTER')
   )
   
   service = discovery.build(api_name, api_version,
                             discoveryServiceUrl=discovery_url,
                             http=credentials)