Method: advertisers.audit

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

คำขอ HTTP

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

จำนวนใบสั่งซื้อการใส่โฆษณา ACTIVE, PAUSED และ ฉบับร่าง ของผู้ลงโฆษณารายนี้ ใบสั่งซื้อการใส่โฆษณาเหล่านี้จะนับรวมในขีดจำกัดใบสั่งซื้อการใส่โฆษณา 9,999 รายการต่อผู้ลงโฆษณา
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)

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

การตรวจสอบคุณสมบัติของประเภทการกำหนดเป้าหมาย

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

string (int64 format)

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

การตรวจสอบคุณสมบัติของประเภทการกำหนดเป้าหมาย

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

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

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

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

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