Method: sellers.adPlays.create

יוצר הפעלת מודעה.

  • הקלט יכול להיות קבוצה של שמות משאבים או קבוצה של מזהים חיצוניים.
  • הפונקציה מחזירה את הפעלות המודעה החדשות שנוצרו, אם הן הושלמו.
  • מחזירה קוד שגיאה 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

string

חובה. שם המשאב של בית העסק פורמט: sellers/{seller}

גוף הבקשה

גוף הבקשה מכיל מופע של AdPlay.

גוף התגובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע חדש של AdPlay שנוצר.

היקפי הרשאות

נדרש היקף OAuth הבא:

  • https://www.googleapis.com/auth/doubleclickbidmanager

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.