Method: advertisers.adGroups.bulkEditAssignedTargetingOptions

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

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

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

בקשת HTTP

POST https://displayvideo.googleapis.com/v5/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_CATEGORY
  • TARGETING_TYPE_COMBINED_AUDIENCE
  • TARGETING_TYPE_CUSTOM_LIST
  • TARGETING_TYPE_FIRST_PARTY_AND_PARTNER_AUDIENCE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_GOOGLE_AUDIENCE
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_LOOKALIKE_AUDIENCE
  • 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_CATEGORY
  • TARGETING_TYPE_COMBINED_AUDIENCE
  • TARGETING_TYPE_CUSTOM_LIST
  • TARGETING_TYPE_FIRST_PARTY_AND_PARTNER_AUDIENCE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_GOOGLE_AUDIENCE
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_LOOKALIKE_AUDIENCE
  • 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.