שאלות נפוצות

כללי

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

הגרסה האחרונה של ה-API שהמסמך הזה מטפל בה היא v3.

האם אוכל לאחזר נתוני ביצועים באמצעות ה-API הזה?

לא. אפשר להשתמש ב-Bid Manager API כדי ליצור, לאחזר ולהריץ דוחות אופליין של Display & Video 360.

שימוש ב-API

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

https://displayvideo.googleapis.com

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

OAuth 2.0 היא שיטת האימות היחידה הנתמכת.

חובה להעניק הרשאה לבקשות API של Display & Video 360 עבור ההיקף הבא:

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

כמו כן, צריך להעניק הרשאה לבקשות לשירות users בהיקף הנוסף הבא:

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

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

מומלץ לעיין במדריך של ספריית הלקוח.

מה קורה אם לא רוצים להשתמש בספריית לקוח?

מומלץ להשתמש באחת מספריות הלקוח שלנו, אבל תוכלו גם להשתמש ב-Display & Video 360 API באמצעות בקשות HTTP ישירות.

בחלק מהשיטות הנוספות, כמו advertisers.assets.upload ו-media.upload, קשה יותר לתרגם ישירות לבקשות HTTP. במדריכים שלנו בנושא קריאייטיב ובידינג בהתאמה אישית, תוכלו לראות דוגמאות לבקשות HTTP לשיטות האלה באמצעות cURL.

אילו הרשאות ב-Display & Video 360 צריך?

כדי להשתמש ב-Display & Video 360 API, חשבון Google לאימות צריך להיות משתמש ב-Display & Video 360 עם גישה לשותפים או למפרסמים רלוונטיים.

כדי שהשותפים או המפרסמים הרלוונטיים יוכלו לבצע את הפעולות הבאות, למשתמש ב-Display & Video 360 חייב להיות אחד מתפקידי המשתמשים הבאים:

  • קריאה בלבד: אחזור משאבים באמצעות קריאות get או list, לא כולל user משאבים.
  • הרשאה רגילה: אחזור, יצירה ועדכון של משאבים. אחזור משאבים של user עם הרשאות לאותם שותפים או מפרסמים.
  • ניהול: אחזור, יצירה ועדכון של משאבים. אחזור, יצירה והענקת גישה למשאבים של user לשותפים או למפרסמים שבניהולכם.

איך אפשר לעדכן את המשאבים של YouTube ו-Partners באמצעות ממשק ה-API?

Display & Video 360 API לא תומך ביצירה או בעדכון של משאבים ב-YouTube ובשותפים. יוצרים או מעדכנים כמות גדולה של משאבים ב-YouTube ובשותפים על ידי העלאת קובצי נתונים מובְנים (SDF) בממשק של Display & Video 360. למידע נוסף על השימוש בהעלאת SDF, מומלץ לקרוא את דף המדריך שלנו על המשאבים של YouTube ו-Partners.

איך מטרגטים מיקומים גיאוגרפיים?

ניתן להקצות מיקוד גיאוגרפי לפריטים באמצעות סוגי המיקוד הבאים:

  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_POI
  • TARGETING_TYPE_BUSINESS_CHAIN
  • TARGETING_TYPE_REGIONAL_LOCATION_LIST
  • TARGETING_TYPE_PROXIMITY_LOCATION_LIST

אחזור מזהים של אפשרויות מיקוד עבור שלושת סוגי המיקוד הראשונים באמצעות targetingTypes.targetingOptions.search. אחזור וניהול של המשאבים ברשימת המיקומים באמצעות השירות advertisers.locationLists.

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

אני רואה שאפשר להוריד קובצי נתונים מובנים (SDF) באמצעות ה-API, אבל איך אפשר להעלות אותם?

Display & Video 360 API לא תומך בהעלאה באמצעות SDF. במקום זאת, מומלץ לנהל את המשאבים דרך השיטות CREATE, PATCH ו-DELETE שה-API מספק. אם אתם בכל זאת רוצים לנהל משאבים באמצעות SDF, תוכלו לעדכן את הקבצים האלה בממשק של Display & Video 360.

תמיכה

האם יש בעיות או מגבלות ידועות ב-API?

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