REST Resource: properties.subpropertyEventFilters

แหล่งข้อมูล: SubpropertyEventFilter

ข้อความทรัพยากรที่แสดงตัวกรองเหตุการณ์ของพร็อพเพอร์ตี้ย่อย GA4

การแสดง JSON
{
  "name": string,
  "filterClauses": [
    {
      object (SubpropertyEventFilterClause)
    }
  ],
  "applyToProperty": string
}
ช่อง
name

string

เอาต์พุตเท่านั้น รูปแบบ: พร็อพเพอร์ตี้/{ordinary_property_id}/subpropertyEventFilter/{sub_property_event_filter} ตัวอย่าง: พร็อพเพอร์ตี้/1234/subpropertyEventFilters/5678

filterClauses[]

object (SubpropertyEventFilterClause)

ต้องระบุ รายการที่ไม่เรียงลำดับ วลีของตัวกรองที่ระบุ SubpropertyEventFilter วลีทั้งหมดจะใช้ "และ" ร่วมกันเพื่อกำหนดว่าข้อมูลใดจะส่งไปยังพร็อพเพอร์ตี้ย่อย

applyToProperty

string

เปลี่ยนแปลงไม่ได้ ชื่อทรัพยากรของพร็อพเพอร์ตี้ย่อยที่ใช้ตัวกรองนี้

SubpropertyEventFilterClause

วลีสำหรับกำหนดตัวกรอง ตัวกรองอาจรวม (เหตุการณ์ที่เป็นไปตามเงื่อนไขตัวกรองรวมอยู่ในข้อมูลของพร็อพเพอร์ตี้ย่อย) หรือแบบเฉพาะตัว (เหตุการณ์ที่เป็นไปตามเงื่อนไขตัวกรองจะไม่รวมอยู่ในข้อมูลของพร็อพเพอร์ตี้ย่อย)

การแสดง JSON
{
  "filterClauseType": enum (FilterClauseType),
  "filterExpression": {
    object (SubpropertyEventFilterExpression)
  }
}
ช่อง
filterClauseType

enum (FilterClauseType)

ต้องระบุ ประเภทของวลีตัวกรอง

filterExpression

object (SubpropertyEventFilterExpression)

ต้องระบุ นิพจน์เชิงตรรกะสำหรับเหตุการณ์ที่ส่งไปยังพร็อพเพอร์ตี้ย่อย

FilterClauseType

ระบุว่านี่เป็นเงื่อนไขตัวกรอง "รวม" หรือ "ยกเว้น"

Enum
FILTER_CLAUSE_TYPE_UNSPECIFIED ไม่ทราบประเภทวลีตัวกรองหรือไม่ได้ระบุ
INCLUDE เหตุการณ์จะรวมอยู่ในพร็อพเพอร์ตี้ย่อยหากเป็นไปตามเงื่อนไขตัวกรอง
EXCLUDE ระบบจะยกเว้นเหตุการณ์จากพร็อพเพอร์ตี้ย่อยหากเป็นไปตามเงื่อนไขตัวกรอง

SubpropertyEventFilterExpression

นิพจน์เชิงตรรกะของตัวกรองเหตุการณ์ของพร็อพเพอร์ตี้ย่อย

การแสดง JSON
{

  // Union field expr can be only one of the following:
  "orGroup": {
    object (SubpropertyEventFilterExpressionList)
  },
  "notExpression": {
    object (SubpropertyEventFilterExpression)
  },
  "filterCondition": {
    object (SubpropertyEventFilterCondition)
  }
  // End of list of possible types for union field expr.
}
ช่อง
ช่องการรวม expr นิพจน์ที่ใช้กับตัวกรอง expr ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
orGroup

object (SubpropertyEventFilterExpressionList)

รายการนิพจน์ที่ใช้ OR ร่วมกัน ต้องมีเฉพาะนิพจน์ notExpression หรือ filterCondition

notExpression

object (SubpropertyEventFilterExpression)

นิพจน์ตัวกรองที่จะเป็น "ไม่" (กลับสี เสริม) มีได้เฉพาะตัวกรองเท่านั้น โดยจะตั้งค่าเป็น SubpropertyEventFilterExpression ระดับบนสุดไม่ได้

filterCondition

object (SubpropertyEventFilterCondition)

สร้างตัวกรองที่ตรงกับเหตุการณ์ที่เฉพาะเจาะจง โดยจะตั้งค่าเป็น SubpropertyEventFilterExpression ระดับบนสุดไม่ได้

SubpropertyEventFilterExpressionList

รายการนิพจน์ตัวกรองเหตุการณ์ของพร็อพเพอร์ตี้ย่อย

การแสดง JSON
{
  "filterExpressions": [
    {
      object (SubpropertyEventFilterExpression)
    }
  ]
}
ช่อง
filterExpressions[]

object (SubpropertyEventFilterExpression)

ต้องระบุ รายการที่ไม่เรียงลำดับ รายการนิพจน์ตัวกรองเหตุการณ์ของพร็อพเพอร์ตี้ย่อย

SubpropertyEventFilterCondition

นิพจน์ตัวกรองที่เฉพาะเจาะจง

การแสดง JSON
{
  "fieldName": string,

  // Union field one_filter can be only one of the following:
  "nullFilter": boolean,
  "stringFilter": {
    object (StringFilter)
  }
  // End of list of possible types for union field one_filter.
}
ช่อง
fieldName

string

ต้องระบุ ช่องที่ถูกกรองออก

ช่องการรวม one_filter

one_filter ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้

nullFilter

boolean

ตัวกรองสำหรับค่า Null

stringFilter

object (StringFilter)

ตัวกรองสำหรับมิติข้อมูลประเภทสตริงที่ตรงกับรูปแบบเฉพาะ

StringFilter

ตัวกรองสำหรับมิติข้อมูลประเภทสตริงที่ตรงกับรูปแบบเฉพาะ

การแสดง JSON
{
  "matchType": enum (MatchType),
  "value": string,
  "caseSensitive": boolean
}
ช่อง
matchType

enum (MatchType)

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

value

string

ต้องระบุ ค่าสตริงที่ใช้สำหรับการจับคู่

caseSensitive

boolean

ไม่บังคับ หากเป็น "จริง" ค่าสตริงจะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ หากเป็น "เท็จ" การจับคู่จะไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่

MatchType

วิธีใช้ตัวกรองเพื่อระบุการจับคู่

Enum
MATCH_TYPE_UNSPECIFIED ไม่รู้จักหรือไม่ได้ระบุประเภทการทำงานของคีย์เวิร์ด
EXACT ค่าสตริงที่ตรงกันทั้งหมด
BEGINS_WITH เริ่มต้นด้วยค่าสตริง
ENDS_WITH ลงท้ายด้วยค่าสตริง
CONTAINS มีค่าสตริง
FULL_REGEXP นิพจน์ทั่วไปแบบเต็มจะจับคู่กับค่าสตริง
PARTIAL_REGEXP นิพจน์ทั่วไปบางส่วนจะจับคู่กับค่าสตริง

เมธอด

create

สร้างตัวกรองเหตุการณ์ของพร็อพเพอร์ตี้ย่อย

delete

ลบตัวกรองเหตุการณ์ของพร็อพเพอร์ตี้ย่อย

get

ค้นหาตัวกรองเหตุการณ์ของพร็อพเพอร์ตี้ย่อยรายการเดียว

list

แสดงรายการตัวกรองเหตุการณ์ของพร็อพเพอร์ตี้ย่อยทั้งหมดในพร็อพเพอร์ตี้

patch

อัปเดตตัวกรองเหตุการณ์ของพร็อพเพอร์ตี้ย่อย