Method: advertisers.audit

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

คำขอ HTTP

GET https://displayvideo.googleapis.com/v5/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 รายการต่อผู้ลงโฆษณา
usedInsertionOrdersCount

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

ประเภทการกำหนดเป้าหมายที่เข้าเกณฑ์

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

string (int64 format)

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

ประเภทการกำหนดเป้าหมายที่เข้าเกณฑ์

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

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

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

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

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