Method: advertisers.audit

ตรวจสอบผู้ลงโฆษณา แสดงผลจํานวนเอนทิตีที่ใช้ต่อประเภททรัพยากรภายใต้ผู้ลงโฆษณาที่ระบุ รายการที่ใช้จะนับรวมในขีดจํากัดของทรัพยากรที่เกี่ยวข้อง ดูข้อมูลได้ที่ https://support.google.com/displayvideo/answer/6071450

คำขอ HTTP

GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}:audit

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

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

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

string (int64 format)

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

พารามิเตอร์การค้นหา

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

string (FieldMask format)

ไม่บังคับ ฟิลด์ที่เฉพาะเจาะจงที่จะแสดงผล หากไม่ได้ระบุมาสก์ไว้ ระบบจะกรอกข้อมูลในช่องทั้งหมดในโปรโตคอลการตอบกลับ ค่าที่ใช้ได้มีดังนี้

  • usedLineItemsCount
  • usedInsertionOrdersCount
  • usedCampaignsCount
  • channelsCount
  • negativelyTargetedChannelsCount
  • negativeKeywordListsCount
  • adGroupCriteriaCount
  • campaignCriteriaCount

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

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

เนื้อหาของคำขอต้องว่างเปล่า

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

ข้อความตอบกลับสําหรับ AdvertiserService.AuditAdvertiser

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

การแสดง JSON 
{
  "usedLineItemsCount": string,
  "usedInsertionOrdersCount": string,
  "usedCampaignsCount": string,
  "channelsCount": string,
  "negativelyTargetedChannelsCount": string,
  "negativeKeywordListsCount": string,
  "adGroupCriteriaCount": string,
  "campaignCriteriaCount": string
}
ช่อง
usedLineItemsCount

string (int64 format)

จํานวนรายการโฆษณาที่ใช้งานอยู่ หยุดชั่วคราว และฉบับร่างภายใต้ผู้ลงโฆษณารายนี้ รายการโฆษณาเหล่านี้จะนับรวมในขีดจํากัด 9,999 รายการโฆษณาต่อผู้ลงโฆษณา 1 ราย
usedInsertionOrdersCount

string (int64 format)

จำนวนใบสั่งซื้อการใส่โฆษณาที่ใช้งานอยู่ หยุดชั่วคราว และฉบับร่างภายใต้ผู้ลงโฆษณารายนี้ ใบสั่งซื้อการใส่โฆษณาเหล่านี้จะนับรวมในขีดจํากัดใบสั่งซื้อการใส่โฆษณา 9,999 รายการต่อผู้ลงโฆษณา 1 ราย
usedCampaignsCount

string (int64 format)

จํานวนแคมเปญที่ใช้งานอยู่และหยุดชั่วคราวภายใต้ผู้ลงโฆษณารายนี้ แคมเปญเหล่านี้จะนับรวมในขีดจํากัด 9999 แคมเปญต่อผู้ลงโฆษณา 1 ราย
channelsCount

string (int64 format)

จำนวนช่องที่สร้างภายใต้ผู้ลงโฆษณารายนี้ แชแนลเหล่านี้นับรวมในขีดจำกัด 1,000 ช่องต่อผู้ลงโฆษณา 1 ราย
negativelyTargetedChannelsCount

string (int64 format)

จํานวนแชแนลที่กำหนดเป้าหมายเชิงลบซึ่งสร้างขึ้นภายใต้ผู้ลงโฆษณารายนี้ ช่องที่กำหนดเป้าหมายเชิงลบเหล่านี้จะนับรวมกับขีดจำกัดช่องที่กำหนดเป้าหมายเชิงลบได้ 5 ช่องต่อผู้ลงโฆษณา 1 ราย
negativeKeywordListsCount

string (int64 format)

จำนวนรายการคีย์เวิร์ดเชิงลบที่สร้างขึ้นภายใต้ผู้ลงโฆษณารายนี้ รายการคีย์เวิร์ดเชิงลบเหล่านี้จะนับรวมอยู่ในขีดจํากัดรายการคีย์เวิร์ดเชิงลบ 20 รายการต่อผู้ลงโฆษณา 1 ราย
adGroupCriteriaCount

string (int64 format)

จำนวนของตัวเลือกการกำหนดเป้าหมายแต่ละตัวเลือกจากประเภทการกำหนดเป้าหมายต่อไปนี้ ซึ่งถูกกำหนดให้กับรายการโฆษณาภายใต้ผู้ลงโฆษณารายนี้ ตัวเลือกการกำหนดเป้าหมายแต่ละอย่างเหล่านี้นับรวมในขีดจำกัดตัวเลือกการกำหนดเป้าหมายกลุ่มโฆษณา 4500000 รายการต่อผู้ลงโฆษณา 1 ราย

ประเภทการกำหนดเป้าหมายที่มีสิทธิ์

  • แชแนล, URL, แอป และคอลเล็กชัน
  • ข้อมูลประชากร
  • กลุ่มเป้าหมายของ Google รวมถึงผู้สนใจ กลุ่มเป้าหมายตามกลุ่มความสนใจที่กำหนดเอง และกลุ่มเป้าหมายที่มีแผนจะซื้อ
  • แหล่งที่มาของพื้นที่โฆษณา
  • คีย์เวิร์ด
  • หมวดหมู่แอปบนอุปกรณ์เคลื่อนที่
  • รายการผู้ใช้
  • การกำหนดเป้าหมายวิดีโอ
  • การมองเห็นโฆษณา
campaignCriteriaCount

string (int64 format)

จํานวนตัวเลือกการกําหนดเป้าหมายแต่ละรายการจากประเภทการกําหนดเป้าหมายต่อไปนี้ซึ่งกําหนดให้กับรายการโฆษณาภายใต้ผู้ลงโฆษณารายนี้ ตัวเลือกการกำหนดเป้าหมายแต่ละอย่างเหล่านี้นับรวมในขีดจำกัดตัวเลือกการกำหนดเป้าหมายแคมเปญ 900,000 ตัวเลือกต่อผู้ลงโฆษณา 1 ราย

ประเภทการกำหนดเป้าหมายที่มีสิทธิ์

  • ตำแหน่ง
  • เบราว์เซอร์
  • ความเร็วในการเชื่อมต่อ
  • วันและเวลา
  • อุปกรณ์และระบบปฏิบัติการ
  • ป้ายกำกับเนื้อหาดิจิทัล
  • หมวดหมู่ที่ละเอียดอ่อน
  • สภาพแวดล้อม
  • ภูมิศาสตร์ รวมถึงเชนธุรกิจ และสถานที่ใกล้เคียง
  • ISP
  • ภาษา
  • การยืนยันบุคคลที่สาม

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

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

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

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