Method: advertisers.adGroups.bulkEditAssignedTargetingOptions

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

אותו סט של בקשות מחיקה ויצירה יוחל על כל קבוצות המודעות שצוינו. באופן ספציפי, הפעולה תמחק את אפשרויות הטירגוט שהוקצו ומפורטות ב-BulkEditAdGroupAssignedTargetingOptionsRequest.delete_requests מכל קבוצת מודעות, ואז תיצור את אפשרויות הטירגוט שהוקצו ומפורטות ב-BulkEditAdGroupAssignedTargetingOptionsRequest.create_requests.

השיטה הזו נתמכת רק בקבוצות של מודעות ליצירת ביקוש.

בקשת HTTP

POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/adGroups:bulkEditAssignedTargetingOptions

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

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

פרמטרים
advertiserId

string (int64 format)

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

גוף הבקשה

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

ייצוג JSON 
{
  "adGroupIds": [
    string
  ],
  "deleteRequests": [
    {
      object (DeleteAssignedTargetingOptionsRequest)
    }
  ],
  "createRequests": [
    {
      object (CreateAssignedTargetingOptionsRequest)
    }
  ]
}
שדות
adGroupIds[]

string (int64 format)

חובה. המזהים של קבוצות המודעות שאליהן ישתייכו אפשרויות הטירגוט שהוקצו. אפשר לציין עד 25 מזהים של קבוצות של מודעות.
deleteRequests[]

object (DeleteAssignedTargetingOptionsRequest)

אופציונלי. אפשרויות הטירגוט שהוקצו למחיקה באצווה, שצוינו כרשימה של DeleteAssignedTargetingOptionsRequest.

סוגי טירגוט נתמכים:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_APP
  • TARGETING_TYPE_APP_CATEGORY
  • TARGETING_TYPE_AUDIENCE_GROUP
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_URL
  • TARGETING_TYPE_YOUTUBE_CHANNEL
  • TARGETING_TYPE_YOUTUBE_VIDEO
createRequests[]

object (CreateAssignedTargetingOptionsRequest)

אופציונלי. אפשרויות הטירגוט שהוקצו ליצירה באצווה, מפורטות כרשימה של CreateAssignedTargetingOptionRequest.

סוגי טירגוט נתמכים:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_APP
  • TARGETING_TYPE_APP_CATEGORY
  • TARGETING_TYPE_AUDIENCE_GROUP
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_URL
  • TARGETING_TYPE_YOUTUBE_CHANNEL
  • TARGETING_TYPE_YOUTUBE_VIDEO

גוף התשובה

הודעת תגובה ל-adGroups.bulkEditAssignedTargetingOptions.

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

ייצוג JSON 
{
  "updatedAdGroupIds": [
    string
  ],
  "failedAdGroupIds": [
    string
  ],
  "errors": [
    {
      object (Status)
    }
  ]
}
שדות
updatedAdGroupIds[]

string (int64 format)

פלט בלבד. המזהים של קבוצות המודעות שעודכנו בהצלחה.
failedAdGroupIds[]

string (int64 format)

פלט בלבד. המזהים של קבוצות המודעות שלא ניתן היה לעדכן.
errors[]

object (Status)

פלט בלבד. פרטי השגיאה של כל קבוצת מודעות שהעדכון שלה נכשל.

היקפי הרשאות

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

  • https://www.googleapis.com/auth/display-video

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.