Method: advertisers.audit

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

คำขอ HTTP

GET https://displayvideo.googleapis.com/v4/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)

จํานวนแคมเปญที่ใช้งานอยู่และหยุดชั่วคราวภายใต้ผู้ลงโฆษณารายนี้ แคมเปญเหล่านี้จะนับรวมในขีดจํากัด 9,999 แคมเปญต่อผู้ลงโฆษณา 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 Overview