שאלות נפוצות

כללי

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

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

מי יכול לגשת ל-API?

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

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

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

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

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

שימוש ב-API

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

https://displayvideo.googleapis.com

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

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

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

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

Python

אפשר להשתמש בספריית הלקוח של Google API ל-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)