Method: customers.describeValidFrequencyLimitingEventMatchers

แสดงตัวจับคู่เหตุการณ์ที่ถูกต้อง พร้อมด้วยข้อมูลเมตาสําหรับรายการกลุ่มเป้าหมายที่ใช้การกําหนดความถี่สูงสุด ตัวจับคู่เหตุการณ์แต่ละรายการมีข้อมูลเมตาที่ประกอบด้วย AdsDataLink.Entity ที่เป็นเจ้าของ และชื่อสําหรับแคมเปญหรือรายการโฆษณาที่เกี่ยวข้อง

คำขอ HTTP

GET https://adsdatahub.googleapis.com/v1/{customer=customers/*}:describeValidFrequencyLimitingEventMatchers

URL ใช้ไวยากรณ์ gRPC Transcoding

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

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

string

ชื่อทรัพยากรของลูกค้า เช่น 'customers/123'

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

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

string (int64 format)

ข้อมูลการเป็นเจ้าของโฆษณา'เช่น 456
pageSize

integer

จํานวนสูงสุดของสินค้าที่ส่งคืน หากเป็น 0 เซิร์ฟเวอร์จะกําหนดจํานวนลูกค้าที่ลิงก์ที่จะกลับมาใช้งาน
pageToken

string

โทเค็นหน้าเว็บ ซึ่งแสดงผลตามการเรียกก่อนหน้า ซึ่งใช้เพื่อขอหน้าถัดไปของผลการค้นหา (หากมี)
filter

string

จํากัดตัวแสดงเหตุการณ์ที่แสดง ยอมรับตัวกรองในช่องย่อยทั้งหมดของ eventMatcher, eventMatcherMetadata.entity และ eventMatcherMetadata.parent_event_matcher ตัวกรองตัวอย่าง: eventMatcher.value = 1234 eventMatcher.match_type = DV360_LINE_ITEM_ID OR eventMatcher.match_type = DV360_INSERTION_ORDER_ID eventMatcherMetadata.display_name = "Campaign 456" eventMatcherMetadata.entity.entity_id =eventEventererer_Metadata.Event_Event_หลายต้องการจับคู่เหตุการณ์จับคู่รายการที่ตรงกัน)

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

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

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

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

การตอบสนองต่อคําขอ ExplainvalidWidthLimitingEventMatchersRequest

การแสดง JSON 
{
  "eventMatcherInfos": [
    {
      object (EventMatcherInfo)
    }
  ],
  "nextPageToken": string
}
ช่อง
eventMatcherInfos[]

object (EventMatcherInfo)

รายชื่อหน่วยโฆษณา โดยแต่ละหน่วยจะมีตัวจับคู่เหตุการณ์พร้อมกับข้อมูลเมตา
nextPageToken

string

โทเค็นที่ใช้ขอหน้าผลการค้นหาถัดไปได้ ช่องนี้ว่างเปล่าหากไม่มีผลลัพธ์เพิ่มเติม

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

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

  • https://www.googleapis.com/auth/adsdatahub

ข้อมูลเหตุการณ์ตัวจับคู่

ตัวจับคู่เหตุการณ์พร้อมข้อมูลเมตา

การแสดง JSON 
{
  "eventMatcher": {
    object (EventMatcher)
  },
  "eventMatcherMetadata": {
    object (EventMatcherMetadata)
  }
}
ช่อง
eventMatcher

object (EventMatcher)

ตัวจับคู่เหตุการณ์ที่มีประเภทข้อจํากัดและรหัสข้อจํากัดที่ถูกต้อง
eventMatcherMetadata

object (EventMatcherMetadata)

ข้อมูลเมตาสําหรับตัวจับคู่เหตุการณ์

ข้อมูลเมตาของเหตุการณ์จับคู่

ข้อมูลเมตาสําหรับตัวจับคู่เหตุการณ์

การแสดง JSON 
{
  "entity": {
    object (Entity)
  },
  "displayName": string,
  "parentEventMatcher": {
    object (EventMatcher)
  }
}
ช่อง
entity

object (Entity)

เอนทิตีที่ลิงก์จาก AdsDataLink
displayName

string

ชื่อในที่เก็บข้อมูลที่เกี่ยวข้องสําหรับข้อจํากัด ซึ่งอาจเป็นชื่อแคมเปญ ชื่อรายการโฆษณา เป็นต้น
parentEventMatcher

object (EventMatcher)

EventMatcher ระดับบนสุดที่เกี่ยวข้อง หากมี หาก eventMatcher เป็นรายการโฆษณา DV360 ช่องนี้จะดูที่ EventMatcher สําหรับใบสั่งซื้อการใส่โฆษณา DV360 ที่เกี่ยวข้องของรายการโฆษณานั้น