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)

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