Method: advertisers.lineItems.bulkEditAssignedTargetingOptions

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

คำขอไปยังปลายทางนี้จะส่งพร้อมกับคำขอต่อไปนี้ที่อัปเดตรายการโฆษณาเดียวกันไม่ได้

สร้างหรืออัปเดตรายการโฆษณา YouTube และพาร์ทเนอร์โดยใช้ API ไม่ได้

คำขอ HTTP

POST https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/lineItems:bulkEditAssignedTargetingOptions

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

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

พารามิเตอร์
advertiserId

string (int64 format)

ต้องระบุ รหัสของผู้ลงโฆษณาที่รายการโฆษณาเป็นของ

เนื้อความของคำขอ

เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "lineItemIds": [
    string
  ],
  "deleteRequests": [
    {
      object (DeleteAssignedTargetingOptionsRequest)
    }
  ],
  "createRequests": [
    {
      object (CreateAssignedTargetingOptionsRequest)
    }
  ]
}
ฟิลด์
lineItemIds[]

string (int64 format)

ต้องระบุ รหัสของรายการโฆษณาที่กำลังอัปเดตการกำหนดเป้าหมาย
deleteRequests[]

object (DeleteAssignedTargetingOptionsRequest)

ตัวเลือกการกำหนดเป้าหมายที่กำหนดเพื่อลบเป็นกลุ่ม โดยระบุเป็นรายการของ DeleteAssignedTargetingOptionsRequest

ประเภทการกำหนดเป้าหมายที่รองรับมีดังนี้

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_APP
  • TARGETING_TYPE_APP_CATEGORY
  • TARGETING_TYPE_AUDIENCE_GROUP
  • TARGETING_TYPE_AUDIO_CONTENT_TYPE
  • TARGETING_TYPE_AUTHORIZED_SELLER_STATUS
  • TARGETING_TYPE_BROWSER
  • TARGETING_TYPE_BUSINESS_CHAIN
  • TARGETING_TYPE_CARRIER_AND_ISP
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_CHANNEL
  • TARGETING_TYPE_CONTENT_DURATION
  • TARGETING_TYPE_CONTENT_GENRE
  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_STREAM_TYPE
  • TARGETING_TYPE_DAY_AND_TIME
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
  • TARGETING_TYPE_ENVIRONMENT
  • TARGETING_TYPE_EXCHANGE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_INVENTORY_SOURCE
  • TARGETING_TYPE_INVENTORY_SOURCE_GROUP
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_NATIVE_CONTENT_POSITION
  • TARGETING_TYPE_NEGATIVE_KEYWORD_LIST
  • TARGETING_TYPE_OMID
  • TARGETING_TYPE_ON_SCREEN_POSITION
  • TARGETING_TYPE_OPERATING_SYSTEM
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_POI
  • TARGETING_TYPE_PROXIMITY_LOCATION_LIST
  • TARGETING_TYPE_REGIONAL_LOCATION_LIST
  • TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
  • TARGETING_TYPE_SUB_EXCHANGE
  • TARGETING_TYPE_THIRD_PARTY_VERIFIER
  • TARGETING_TYPE_URL
  • TARGETING_TYPE_USER_REWARDED_CONTENT
  • TARGETING_TYPE_VIDEO_PLAYER_SIZE
  • TARGETING_TYPE_VIEWABILITY
createRequests[]

object (CreateAssignedTargetingOptionsRequest)

ตัวเลือกการกำหนดเป้าหมายที่กำหนดเพื่อสร้างเป็นกลุ่ม โดยระบุเป็นรายการของ CreateAssignedTargetingOptionsRequest

ประเภทการกำหนดเป้าหมายที่รองรับมีดังนี้

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_APP
  • TARGETING_TYPE_APP_CATEGORY
  • TARGETING_TYPE_AUDIENCE_GROUP
  • TARGETING_TYPE_AUDIO_CONTENT_TYPE
  • TARGETING_TYPE_AUTHORIZED_SELLER_STATUS
  • TARGETING_TYPE_BROWSER
  • TARGETING_TYPE_BUSINESS_CHAIN
  • TARGETING_TYPE_CARRIER_AND_ISP
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_CHANNEL
  • TARGETING_TYPE_CONTENT_DURATION
  • TARGETING_TYPE_CONTENT_GENRE
  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_STREAM_TYPE
  • TARGETING_TYPE_DAY_AND_TIME
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
  • TARGETING_TYPE_ENVIRONMENT
  • TARGETING_TYPE_EXCHANGE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_INVENTORY_SOURCE
  • TARGETING_TYPE_INVENTORY_SOURCE_GROUP
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_NATIVE_CONTENT_POSITION
  • TARGETING_TYPE_NEGATIVE_KEYWORD_LIST
  • TARGETING_TYPE_OMID
  • TARGETING_TYPE_ON_SCREEN_POSITION
  • TARGETING_TYPE_OPERATING_SYSTEM
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_POI
  • TARGETING_TYPE_PROXIMITY_LOCATION_LIST
  • TARGETING_TYPE_REGIONAL_LOCATION_LIST
  • TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
  • TARGETING_TYPE_SUB_EXCHANGE
  • TARGETING_TYPE_THIRD_PARTY_VERIFIER
  • TARGETING_TYPE_URL
  • TARGETING_TYPE_USER_REWARDED_CONTENT
  • TARGETING_TYPE_VIDEO_PLAYER_SIZE
  • TARGETING_TYPE_VIEWABILITY

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "updatedLineItemIds": [
    string
  ],
  "failedLineItemIds": [
    string
  ],
  "errors": [
    {
      object (Status)
    }
  ]
}
ช่อง
updatedLineItemIds[]

string (int64 format)

เอาต์พุตเท่านั้น รหัสของรายการโฆษณาที่อัปเดตเรียบร้อยแล้ว
failedLineItemIds[]

string (int64 format)

เอาต์พุตเท่านั้น รหัสของสินค้าในรายการสั่งซื้อที่ไม่สำเร็จ
errors[]

object (Status)

ข้อมูลข้อผิดพลาดสำหรับรายการโฆษณาแต่ละรายการที่อัปเดตไม่สำเร็จ

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

ดูข้อมูลเพิ่มเติมได้ที่OAuth 2.0 Overview