Method: advertisers.adGroups.bulkEditAssignedTargetingOptions

แก้ไขตัวเลือกการกำหนดเป้าหมายเป็นกลุ่มสำหรับกลุ่มโฆษณาหลายกลุ่ม

ระบบจะใช้คำขอลบและสร้างชุดเดียวกันกับกลุ่มโฆษณาที่ระบุทั้งหมด โดยเฉพาะอย่างยิ่ง การดำเนินการนี้จะลบตัวเลือกการกำหนดเป้าหมายที่กำหนดไว้ซึ่งระบุใน BulkEditAdGroupAssignedTargetingOptionsRequest.delete_requests ออกจากกลุ่มโฆษณาแต่ละกลุ่ม แล้วสร้างตัวเลือกการกำหนดเป้าหมายที่กำหนดไว้ซึ่งระบุใน BulkEditAdGroupAssignedTargetingOptionsRequest.create_requests

วิธีนี้ใช้ได้กับกลุ่มโฆษณา Demand Gen เท่านั้น

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลงรหัส gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
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