יוצר הפעלת מודעה.
- הקלט יכול להיות קבוצה של שמות משאבים או קבוצה של מזהים חיצוניים.
- הפונקציה מחזירה את הפעלות המודעה החדשות שנוצרו, אם הן הושלמו.
- מחזירה קוד שגיאה
INVALID_ARGUMENTאם צוינו יחידת מודעות, סדר, שורה או קריאייטיב לא חוקיים. לדוגמה, שם המשאב של יחידת המודעות אינו בפורמטsellers/111/adUnits/123. - הפונקציה מחזירה את קוד השגיאה
ALREADY_EXISTSאם כבר קיימת מודעה שמופעלת עבור אותה יחידת מודעות, אותה שורה, אותה שורה וקריאייטיב עם אותו זמן התחלה. - הפונקציה מחזירה את קוד השגיאה
NOT_FOUNDאם לא נמצאו יחידות מודעות, סדר, שורה או נכס קריאייטיב תואמים. - מחזירה את קוד השגיאה
FAILED_PRECONDITIONאם הבקשה מכילה גם את שם המשאב וגם את המזהה החיצוני.
בקשת HTTP
POST https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*}/adPlays
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
| פרמטרים | |
|---|---|
parent |
חובה. שם המשאב של בית העסק פורמט: sellers/{seller} |
גוף הבקשה
גוף הבקשה מכיל מופע של AdPlay.
גוף התגובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע חדש של AdPlay שנוצר.
היקפי הרשאות
נדרש היקף OAuth הבא:
https://www.googleapis.com/auth/doubleclickbidmanager
למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.