Method: sellers.adPlays.batchCreate

יצירת הפעלות חדשות של מודעות בבת אחת.

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

בקשת HTTP

POST https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*}/adPlays:batchCreate

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

פרמטרים של נתיב

פרמטרים
parent

string

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

גוף הבקשה

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

ייצוג JSON 
{
  "requests": [
    {
      object (CreateAdPlayRequest)
    }
  ]
}
שדות
requests[]

object (CreateAdPlayRequest)

חובה. המודעה מופעלת כדי ליצור אותה.

המספר המרבי המותר של הפעלות מודעות בכמות גדולה הוא 1,000. שעת ההתחלה צריכה להיות בעבר, ולכל היותר 3 ימים לפני תאריך היצירה. שעת הסיום צריכה להיות בעבר ואחרי שעת ההתחלה.

גוף התשובה

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

תגובה ליצירת הפעלות של מודעות בבת אחת.

ייצוג JSON 
{
  "adPlays": [
    {
      object (AdPlay)
    }
  ]
}
שדות
adPlays[]

object (AdPlay)

הצגת המודעה שנוצרה.

היקפי הרשאות

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

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

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

CreateAdPlayRequest

בקשת הודעה עבור AdPlayService.CreateAdPlay.

ייצוג JSON 
{
  "parent": string,
  "adPlay": {
    object (AdPlay)
  }
}
שדות
parent

string

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

object (AdPlay)

חובה. ההפעלה של המודעה ליצירה.

המערכת תיצור את השם של הפעלת המודעות ואין להגדיר אותו. שעת ההתחלה צריכה להיות בעבר, ולכל היותר 3 ימים לפני תאריך היצירה. שעת הסיום צריכה להיות בעבר ואחרי שעת ההתחלה.