שאלות נפוצות

כללי

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

הגרסה העדכנית ביותר של ה-API שמתואר במסמך הזה היא v4.

האם אפשר לאחזר נתוני ביצועים באמצעות ה-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 ישירות.

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

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

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

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

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

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

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

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

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

• 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, אבל איך מעלים אותם?

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

תמיכה

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

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