REST Resource: properties.channelGroups

资源:ChannelGroup

表示渠道组的资源消息。

JSON 表示法
{
  "name": string,
  "displayName": string,
  "description": string,
  "groupingRule": [
    {
      object (GroupingRule)
    }
  ],
  "systemDefined": boolean,
  "primary": boolean
}
字段
name

string

仅限输出。此渠道组资源的资源名称。格式:properties/{property}/channelGroups/{channelGroup}

displayName

string

必需。渠道组的显示名称。长度上限为 80 个字符。

description

string

渠道组的说明。长度上限为 256 个字符。

groupingRule[]

object (GroupingRule)

必需。渠道的分组规则。规则数量上限为 50 个。

systemDefined

boolean

仅限输出。如果为 true,则此渠道组是 Google Analytics 预定义的默认渠道组。无法更新此渠道组的显示名称和分组规则。

primary

boolean

可选。如果为 true,此渠道组将用作报告的默认渠道组。任何时候都只能将一个渠道组设置为 primary。如果为某个渠道组设置了 primary 字段,则系统会取消设置之前的主渠道组的 primary 字段。

Google Analytics 预定义渠道组默认为主要渠道组。

GroupingRule

用于控制如何将流量划分到一个渠道的规则。

JSON 表示法
{
  "displayName": string,
  "expression": {
    object (ChannelGroupFilterExpression)
  }
}
字段
displayName

string

必需。客户为渠道定义的显示名称。

expression

object (ChannelGroupFilterExpression)

必需。用于定义分组规则的过滤条件表达式。

ChannelGroupFilterExpression

渠道组维度过滤条件的逻辑表达式。

JSON 表示法
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (ChannelGroupFilterExpressionList)
  },
  "orGroup": {
    object (ChannelGroupFilterExpressionList)
  },
  "notExpression": {
    object (ChannelGroupFilterExpression)
  },
  "filter": {
    object (ChannelGroupFilter)
  }
  // End of list of possible types for union field expr.
}
字段
联合字段 expr。应用于过滤条件的表达式。expr 只能是下列其中一项:
andGroup

object (ChannelGroupFilterExpressionList)

要通过 AND 运算连接在一起的表达式列表。它只能包含包含 orGroup 的 ChannelGroupFilterExpression。必须为顶级 ChannelGroupFilterExpression 设置此值。

orGroup

object (ChannelGroupFilterExpressionList)

要联接起来的表达式列表。它不能包含包含 andGroup 或 orGroup 的 ChannelGroupFilterExpression。

notExpression

object (ChannelGroupFilterExpression)

要进行 NOT 运算(即取反)的过滤条件表达式。它只能包含 dimensionOrMetricFilter。无法在顶级 ChannelGroupFilterExpression 上进行设置。

filter

object (ChannelGroupFilter)

针对单个维度的过滤条件。无法在顶级 ChannelGroupFilterExpression 上进行设置。

ChannelGroupFilterExpressionList

渠道组过滤条件表达式列表。

JSON 表示法
{
  "filterExpressions": [
    {
      object (ChannelGroupFilterExpression)
    }
  ]
}
字段
filterExpressions[]

object (ChannelGroupFilterExpression)

渠道组过滤条件表达式列表。

ChannelGroupFilter

针对单个维度的特定过滤条件。

JSON 表示法
{
  "fieldName": string,

  // Union field value_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  }
  // End of list of possible types for union field value_filter.
}
字段
fieldName

string

必需。不可变。要过滤的维度名称。

联合字段 value_filter。用于定义此过滤器行为的 StringFilter 或 InListFilter。value_filter 只能是下列其中一项:
stringFilter

object (StringFilter)

用于匹配特定模式的字符串类型维度的过滤条件。

inListFilter

object (InListFilter)

与特定选项列表匹配的字符串维度过滤条件。

StringFilter

过滤出字段值为字符串的行。匹配项不区分大小写。

JSON 表示法
{
  "matchType": enum (MatchType),
  "value": string
}
字段
matchType

enum (MatchType)

必需。字符串过滤条件的匹配类型。

value

string

必需。要匹配的字符串值。

MatchType

系统将如何使用过滤条件来确定匹配。

枚举
MATCH_TYPE_UNSPECIFIED 默认匹配类型。
EXACT 字符串值完全匹配。
BEGINS_WITH 以字符串值开头。
ENDS_WITH 以字符串值结尾。
CONTAINS 包含字符串值。
FULL_REGEXP 与字符串值完全匹配的正则表达式。
PARTIAL_REGEXP 正则表达式与字符串值部分匹配。

InListFilter

与特定选项列表匹配的字符串维度过滤条件。匹配项不区分大小写。

JSON 表示法
{
  "values": [
    string
  ]
}
字段
values[]

string

必需。要匹配的可能字符串值的列表。必须非空。

方法

create

创建 ChannelGroup。

delete

删除媒体资源的 ChannelGroup。

get

查找单个 ChannelGroup。

list

列出媒体资源上的 ChannelGroup。

patch

更新 ChannelGroup。