Method: adPlays.createWithExternalIds

יצירת הפעלה של מודעה עם מזהים חיצוניים.

  • הפונקציה מחזירה את ההפעלה החדשה של המודעה אם היא הצליחה.
  • הפונקציה מחזירה קוד שגיאה INVALID_ARGUMENT אם צוינו מזהה חיצוני, מזהה חיצוני של הזמנה, מזהה חיצוני של שורה או מזהה חיצוני של נכס קריאייטיב, שאינם חוקיים.
  • מחזירה את קוד השגיאה INVALID_ARGUMENT אם כבר קיימת מודעה שמופעלת עבור אותה יחידת מודעות, אותה הזמנה, שורה וקריאייטיב עם אותו זמן התחלה.
  • הפונקציה מחזירה את קוד השגיאה NOT_FOUND אם לא נמצאו מזהה חיצוני של יחידת מודעות, מזהה חיצוני של הזמנה, מזהה חיצוני של שורה או מזהה חיצוני של נכס קריאייטיב.

בקשת HTTP

POST https://dv360outofhomeseller.googleapis.com/v1beta1/adPlays:createWithExternalIds

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "lineExternalId": string,
  "orderExternalId": string,
  "adUnitExternalId": string,
  "creativeAssetExternalId": string,
  "startTime": string,
  "endTime": string,
  "recordTime": string,
  "impressions": number
}
שדות
lineExternalId

string

חובה. המזהה החיצוני של השורה שאליה שייכת הצגת המודעה הזו. פורמט: 123
orderExternalId

string

חובה. המזהה החיצוני של ההזמנה שאליה שייכת הפעלת המודעה הזו. פורמט: 456
adUnitExternalId

string

חובה. המזהה החיצוני של יחידת המודעות שבה הוצגה הצגת המודעות הזו. פורמט: 789
creativeAssetExternalId

string

חובה. המזהה החיצוני של הקריאייטיב שבו הוצגה המודעה הזו. פורמט: 3210
startTime

string (Timestamp format)

חובה. השעה שבה המודעה התחילה לפעול (כולל). התאריך הזה צריך להיות בעבר וב-3 הימים האחרונים.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
endTime

string (Timestamp format)

חובה. השעה שבה הסתיימה ההפעלה של המודעה (לא כולל). תאריך ההתחלה צריך להיות בעבר ואחרי שעת ההתחלה.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
recordTime

string (Timestamp format)

זה שינוי אופציונלי. השעה שבה הופעלה המודעה הזו. תאריך ההתחלה צריך להיות בעבר ואחרי שעת הסיום.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
impressions

number

חובה. מספר החשיפות הכולל.

גוף התשובה

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

היקפי הרשאות

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

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

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