Method: advertisers.lineItems.bulkUpdate

อัปเดตรายการโฆษณาหลายรายการ

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

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

คำขอ HTTP

POST https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/lineItems:bulkUpdate

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

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

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

string (int64 format)

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

เนื้อหาของคำขอ

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

การแสดง JSON 
{
  "lineItemIds": [
    string
  ],
  "targetLineItem": {
    object (LineItem)
  },
  "updateMask": string
}
ช่อง
lineItemIds[]

string (int64 format)

ต้องระบุ รหัสของรายการโฆษณาที่จะอัปเดต
targetLineItem

object (LineItem)

ต้องระบุ ออบเจ็กต์รายการโฆษณาที่มีช่องที่จะอัปเดตและค่าใหม่ที่จะกำหนดให้กับรายการโฆษณาทั้งหมดที่ระบุไว้ใน lineItemIds"
updateMask

string (FieldMask format)

ต้องระบุ ฟิลด์มาสก์ที่ระบุว่าต้องอัปเดตช่องใด

ขณะนี้ระบบรองรับเฉพาะช่องต่อไปนี้เท่านั้น

ซึ่งเป็นรายการชื่อฟิลด์ที่สมบูรณ์ในตัวเองซึ่งคั่นด้วยคอมมา ตัวอย่าง: "user.displayName,photo"

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

ข้อความตอบกลับสำหรับ LineItemService.BulkUpdateLineItems

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

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

string (int64 format)

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

string (int64 format)

รหัสของรายการโฆษณาที่อัปเดตไม่สำเร็จ
skippedLineItemIds[]

string (int64 format)

รหัสของรายการโฆษณาที่จะข้ามเพื่ออัปเดต เช่น การเปลี่ยนแปลงที่ไม่จำเป็นซึ่งจะส่งผลให้ไม่มีการเปลี่ยนแปลงรายการโฆษณาอย่างมีประสิทธิภาพจะถูกข้ามได้ และคุณสามารถติดตามรหัสรายการโฆษณาที่เกี่ยวข้องได้ที่นี่
errors[]

object (Status)

ข้อผิดพลาดที่แสดงผลโดยรายการโฆษณาที่ไม่สามารถอัปเดตได้

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

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

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

โปรดดูข้อมูลเพิ่มเติมที่ภาพรวมของ OAuth 2.0