Insert
|
|||||
|
|
Create a new filter
Authorization
To use this building block you will have to grant access to at least one of the following scopes:
- Edit Google Analytics management entities
Input
This building block consumes 52 input parameters
Name | Format | Description |
---|---|---|
accountId Required |
STRING |
Account ID to create filter for |
accountId |
STRING |
Account ID to which this filter belongs |
advancedDetails |
OBJECT |
Details for the filter of the type ADVANCED |
advancedDetails.caseSensitive |
BOOLEAN |
Indicates if the filter expressions are case sensitive |
advancedDetails.extractA |
STRING |
Expression to extract from field A |
advancedDetails.extractB |
STRING |
Expression to extract from field B |
advancedDetails.fieldA |
STRING |
Field A |
advancedDetails.fieldAIndex |
INTEGER |
The Index of the custom dimension. Required if field is a CUSTOM_DIMENSION |
advancedDetails.fieldARequired |
BOOLEAN |
Indicates if field A is required to match |
advancedDetails.fieldB |
STRING |
Field B |
advancedDetails.fieldBIndex |
INTEGER |
The Index of the custom dimension. Required if field is a CUSTOM_DIMENSION |
advancedDetails.fieldBRequired |
BOOLEAN |
Indicates if field B is required to match |
advancedDetails.outputConstructor |
STRING |
Expression used to construct the output value |
advancedDetails.outputToField |
STRING |
Output field |
advancedDetails.outputToFieldIndex |
INTEGER |
The Index of the custom dimension. Required if field is a CUSTOM_DIMENSION |
advancedDetails.overrideOutputField |
BOOLEAN |
Indicates if the existing value of the output field, if any, should be overridden by the output expression |
created |
DATE_TIME |
Time this filter was created |
excludeDetails |
OBJECT |
JSON template for an Analytics filter expression |
excludeDetails.caseSensitive |
BOOLEAN |
Determines if the filter is case sensitive |
excludeDetails.expressionValue |
STRING |
Filter expression value |
excludeDetails.field |
STRING |
Field to filter. Possible values:
|
excludeDetails.fieldIndex |
INTEGER |
The Index of the custom dimension. Set only if the field is a is CUSTOM_DIMENSION |
excludeDetails.kind |
STRING |
Kind value for filter expression |
excludeDetails.matchType |
STRING |
Match type for this filter. Possible values are BEGINS_WITH, EQUAL, ENDS_WITH, CONTAINS, or MATCHES. GEO_DOMAIN, GEO_IP_ADDRESS, PAGE_REQUEST_URI, or PAGE_HOSTNAME filters can use any match type; all other filters must use MATCHES |
id |
STRING |
Filter ID |
includeDetails |
OBJECT |
JSON template for an Analytics filter expression |
includeDetails.caseSensitive |
BOOLEAN |
Determines if the filter is case sensitive |
includeDetails.expressionValue |
STRING |
Filter expression value |
includeDetails.field |
STRING |
Field to filter. Possible values:
|
includeDetails.fieldIndex |
INTEGER |
The Index of the custom dimension. Set only if the field is a is CUSTOM_DIMENSION |
includeDetails.kind |
STRING |
Kind value for filter expression |
includeDetails.matchType |
STRING |
Match type for this filter. Possible values are BEGINS_WITH, EQUAL, ENDS_WITH, CONTAINS, or MATCHES. GEO_DOMAIN, GEO_IP_ADDRESS, PAGE_REQUEST_URI, or PAGE_HOSTNAME filters can use any match type; all other filters must use MATCHES |
kind |
STRING |
Resource type for Analytics filter |
lowercaseDetails |
OBJECT |
Details for the filter of the type LOWER |
lowercaseDetails.field |
STRING |
Field to use in the filter |
lowercaseDetails.fieldIndex |
INTEGER |
The Index of the custom dimension. Required if field is a CUSTOM_DIMENSION |
name |
STRING |
Name of this filter |
parentLink |
OBJECT |
Parent link for this filter. Points to the account to which this filter belongs |
parentLink.href |
STRING |
Link to the account to which this filter belongs |
parentLink.type |
STRING |
Value is "analytics#account" |
searchAndReplaceDetails |
OBJECT |
Details for the filter of the type SEARCH_AND_REPLACE |
searchAndReplaceDetails.caseSensitive |
BOOLEAN |
Determines if the filter is case sensitive |
searchAndReplaceDetails.field |
STRING |
Field to use in the filter |
searchAndReplaceDetails.fieldIndex |
INTEGER |
The Index of the custom dimension. Required if field is a CUSTOM_DIMENSION |
searchAndReplaceDetails.replaceString |
STRING |
Term to replace the search term with |
searchAndReplaceDetails.searchString |
STRING |
Term to search |
selfLink |
STRING |
Link for this filter |
type |
STRING |
Type of this filter. Possible values are INCLUDE, EXCLUDE, LOWERCASE, UPPERCASE, SEARCH_AND_REPLACE and ADVANCED |
updated |
DATE_TIME |
Time this filter was last modified |
uppercaseDetails |
OBJECT |
Details for the filter of the type UPPER |
uppercaseDetails.field |
STRING |
Field to use in the filter |
uppercaseDetails.fieldIndex |
INTEGER |
The Index of the custom dimension. Required if field is a CUSTOM_DIMENSION |
= Parameter name
= Format
accountId STRING Required Account ID to create filter for |
accountId STRING Account ID to which this filter belongs |
advancedDetails OBJECT Details for the filter of the type ADVANCED |
advancedDetails.caseSensitive BOOLEAN Indicates if the filter expressions are case sensitive |
advancedDetails.extractA STRING Expression to extract from field A |
advancedDetails.extractB STRING Expression to extract from field B |
advancedDetails.fieldA STRING Field A |
advancedDetails.fieldAIndex INTEGER The Index of the custom dimension. Required if field is a CUSTOM_DIMENSION |
advancedDetails.fieldARequired BOOLEAN Indicates if field A is required to match |
advancedDetails.fieldB STRING Field B |
advancedDetails.fieldBIndex INTEGER The Index of the custom dimension. Required if field is a CUSTOM_DIMENSION |
advancedDetails.fieldBRequired BOOLEAN Indicates if field B is required to match |
advancedDetails.outputConstructor STRING Expression used to construct the output value |
advancedDetails.outputToField STRING Output field |
advancedDetails.outputToFieldIndex INTEGER The Index of the custom dimension. Required if field is a CUSTOM_DIMENSION |
advancedDetails.overrideOutputField BOOLEAN Indicates if the existing value of the output field, if any, should be overridden by the output expression |
created DATE_TIME Time this filter was created |
excludeDetails OBJECT JSON template for an Analytics filter expression |
excludeDetails.caseSensitive BOOLEAN Determines if the filter is case sensitive |
excludeDetails.expressionValue STRING Filter expression value |
excludeDetails.field STRING Field to filter. Possible values:
|
excludeDetails.fieldIndex INTEGER The Index of the custom dimension. Set only if the field is a is CUSTOM_DIMENSION |
excludeDetails.kind STRING Kind value for filter expression |
excludeDetails.matchType STRING Match type for this filter. Possible values are BEGINS_WITH, EQUAL, ENDS_WITH, CONTAINS, or MATCHES. GEO_DOMAIN, GEO_IP_ADDRESS, PAGE_REQUEST_URI, or PAGE_HOSTNAME filters can use any match type; all other filters must use MATCHES |
id STRING Filter ID |
includeDetails OBJECT JSON template for an Analytics filter expression |
includeDetails.caseSensitive BOOLEAN Determines if the filter is case sensitive |
includeDetails.expressionValue STRING Filter expression value |
includeDetails.field STRING Field to filter. Possible values:
|
includeDetails.fieldIndex INTEGER The Index of the custom dimension. Set only if the field is a is CUSTOM_DIMENSION |
includeDetails.kind STRING Kind value for filter expression |
includeDetails.matchType STRING Match type for this filter. Possible values are BEGINS_WITH, EQUAL, ENDS_WITH, CONTAINS, or MATCHES. GEO_DOMAIN, GEO_IP_ADDRESS, PAGE_REQUEST_URI, or PAGE_HOSTNAME filters can use any match type; all other filters must use MATCHES |
kind STRING Resource type for Analytics filter |
lowercaseDetails OBJECT Details for the filter of the type LOWER |
lowercaseDetails.field STRING Field to use in the filter |
lowercaseDetails.fieldIndex INTEGER The Index of the custom dimension. Required if field is a CUSTOM_DIMENSION |
name STRING Name of this filter |
parentLink OBJECT Parent link for this filter. Points to the account to which this filter belongs |
parentLink.href STRING Link to the account to which this filter belongs |
parentLink.type STRING Value is "analytics#account" |
searchAndReplaceDetails OBJECT Details for the filter of the type SEARCH_AND_REPLACE |
searchAndReplaceDetails.caseSensitive BOOLEAN Determines if the filter is case sensitive |
searchAndReplaceDetails.field STRING Field to use in the filter |
searchAndReplaceDetails.fieldIndex INTEGER The Index of the custom dimension. Required if field is a CUSTOM_DIMENSION |
searchAndReplaceDetails.replaceString STRING Term to replace the search term with |
searchAndReplaceDetails.searchString STRING Term to search |
selfLink STRING Link for this filter |
type STRING Type of this filter. Possible values are INCLUDE, EXCLUDE, LOWERCASE, UPPERCASE, SEARCH_AND_REPLACE and ADVANCED |
updated DATE_TIME Time this filter was last modified |
uppercaseDetails OBJECT Details for the filter of the type UPPER |
uppercaseDetails.field STRING Field to use in the filter |
uppercaseDetails.fieldIndex INTEGER The Index of the custom dimension. Required if field is a CUSTOM_DIMENSION |
Output
This building block provides 51 output parameters
Name | Format | Description |
---|---|---|
accountId |
STRING |
Account ID to which this filter belongs |
advancedDetails |
OBJECT |
Details for the filter of the type ADVANCED |
advancedDetails.caseSensitive |
BOOLEAN |
Indicates if the filter expressions are case sensitive |
advancedDetails.extractA |
STRING |
Expression to extract from field A |
advancedDetails.extractB |
STRING |
Expression to extract from field B |
advancedDetails.fieldA |
STRING |
Field A |
advancedDetails.fieldAIndex |
INTEGER |
The Index of the custom dimension. Required if field is a CUSTOM_DIMENSION |
advancedDetails.fieldARequired |
BOOLEAN |
Indicates if field A is required to match |
advancedDetails.fieldB |
STRING |
Field B |
advancedDetails.fieldBIndex |
INTEGER |
The Index of the custom dimension. Required if field is a CUSTOM_DIMENSION |
advancedDetails.fieldBRequired |
BOOLEAN |
Indicates if field B is required to match |
advancedDetails.outputConstructor |
STRING |
Expression used to construct the output value |
advancedDetails.outputToField |
STRING |
Output field |
advancedDetails.outputToFieldIndex |
INTEGER |
The Index of the custom dimension. Required if field is a CUSTOM_DIMENSION |
advancedDetails.overrideOutputField |
BOOLEAN |
Indicates if the existing value of the output field, if any, should be overridden by the output expression |
created |
DATE_TIME |
Time this filter was created |
excludeDetails |
OBJECT |
JSON template for an Analytics filter expression |
excludeDetails.caseSensitive |
BOOLEAN |
Determines if the filter is case sensitive |
excludeDetails.expressionValue |
STRING |
Filter expression value |
excludeDetails.field |
STRING |
Field to filter. Possible values:
|
excludeDetails.fieldIndex |
INTEGER |
The Index of the custom dimension. Set only if the field is a is CUSTOM_DIMENSION |
excludeDetails.kind |
STRING |
Kind value for filter expression |
excludeDetails.matchType |
STRING |
Match type for this filter. Possible values are BEGINS_WITH, EQUAL, ENDS_WITH, CONTAINS, or MATCHES. GEO_DOMAIN, GEO_IP_ADDRESS, PAGE_REQUEST_URI, or PAGE_HOSTNAME filters can use any match type; all other filters must use MATCHES |
id |
STRING |
Filter ID |
includeDetails |
OBJECT |
JSON template for an Analytics filter expression |
includeDetails.caseSensitive |
BOOLEAN |
Determines if the filter is case sensitive |
includeDetails.expressionValue |
STRING |
Filter expression value |
includeDetails.field |
STRING |
Field to filter. Possible values:
|
includeDetails.fieldIndex |
INTEGER |
The Index of the custom dimension. Set only if the field is a is CUSTOM_DIMENSION |
includeDetails.kind |
STRING |
Kind value for filter expression |
includeDetails.matchType |
STRING |
Match type for this filter. Possible values are BEGINS_WITH, EQUAL, ENDS_WITH, CONTAINS, or MATCHES. GEO_DOMAIN, GEO_IP_ADDRESS, PAGE_REQUEST_URI, or PAGE_HOSTNAME filters can use any match type; all other filters must use MATCHES |
kind |
STRING |
Resource type for Analytics filter |
lowercaseDetails |
OBJECT |
Details for the filter of the type LOWER |
lowercaseDetails.field |
STRING |
Field to use in the filter |
lowercaseDetails.fieldIndex |
INTEGER |
The Index of the custom dimension. Required if field is a CUSTOM_DIMENSION |
name |
STRING |
Name of this filter |
parentLink |
OBJECT |
Parent link for this filter. Points to the account to which this filter belongs |
parentLink.href |
STRING |
Link to the account to which this filter belongs |
parentLink.type |
STRING |
Value is "analytics#account" |
searchAndReplaceDetails |
OBJECT |
Details for the filter of the type SEARCH_AND_REPLACE |
searchAndReplaceDetails.caseSensitive |
BOOLEAN |
Determines if the filter is case sensitive |
searchAndReplaceDetails.field |
STRING |
Field to use in the filter |
searchAndReplaceDetails.fieldIndex |
INTEGER |
The Index of the custom dimension. Required if field is a CUSTOM_DIMENSION |
searchAndReplaceDetails.replaceString |
STRING |
Term to replace the search term with |
searchAndReplaceDetails.searchString |
STRING |
Term to search |
selfLink |
STRING |
Link for this filter |
type |
STRING |
Type of this filter. Possible values are INCLUDE, EXCLUDE, LOWERCASE, UPPERCASE, SEARCH_AND_REPLACE and ADVANCED |
updated |
DATE_TIME |
Time this filter was last modified |
uppercaseDetails |
OBJECT |
Details for the filter of the type UPPER |
uppercaseDetails.field |
STRING |
Field to use in the filter |
uppercaseDetails.fieldIndex |
INTEGER |
The Index of the custom dimension. Required if field is a CUSTOM_DIMENSION |
= Parameter name
= Format
accountId STRING Account ID to which this filter belongs |
advancedDetails OBJECT Details for the filter of the type ADVANCED |
advancedDetails.caseSensitive BOOLEAN Indicates if the filter expressions are case sensitive |
advancedDetails.extractA STRING Expression to extract from field A |
advancedDetails.extractB STRING Expression to extract from field B |
advancedDetails.fieldA STRING Field A |
advancedDetails.fieldAIndex INTEGER The Index of the custom dimension. Required if field is a CUSTOM_DIMENSION |
advancedDetails.fieldARequired BOOLEAN Indicates if field A is required to match |
advancedDetails.fieldB STRING Field B |
advancedDetails.fieldBIndex INTEGER The Index of the custom dimension. Required if field is a CUSTOM_DIMENSION |
advancedDetails.fieldBRequired BOOLEAN Indicates if field B is required to match |
advancedDetails.outputConstructor STRING Expression used to construct the output value |
advancedDetails.outputToField STRING Output field |
advancedDetails.outputToFieldIndex INTEGER The Index of the custom dimension. Required if field is a CUSTOM_DIMENSION |
advancedDetails.overrideOutputField BOOLEAN Indicates if the existing value of the output field, if any, should be overridden by the output expression |
created DATE_TIME Time this filter was created |
excludeDetails OBJECT JSON template for an Analytics filter expression |
excludeDetails.caseSensitive BOOLEAN Determines if the filter is case sensitive |
excludeDetails.expressionValue STRING Filter expression value |
excludeDetails.field STRING Field to filter. Possible values:
|
excludeDetails.fieldIndex INTEGER The Index of the custom dimension. Set only if the field is a is CUSTOM_DIMENSION |
excludeDetails.kind STRING Kind value for filter expression |
excludeDetails.matchType STRING Match type for this filter. Possible values are BEGINS_WITH, EQUAL, ENDS_WITH, CONTAINS, or MATCHES. GEO_DOMAIN, GEO_IP_ADDRESS, PAGE_REQUEST_URI, or PAGE_HOSTNAME filters can use any match type; all other filters must use MATCHES |
id STRING Filter ID |
includeDetails OBJECT JSON template for an Analytics filter expression |
includeDetails.caseSensitive BOOLEAN Determines if the filter is case sensitive |
includeDetails.expressionValue STRING Filter expression value |
includeDetails.field STRING Field to filter. Possible values:
|
includeDetails.fieldIndex INTEGER The Index of the custom dimension. Set only if the field is a is CUSTOM_DIMENSION |
includeDetails.kind STRING Kind value for filter expression |
includeDetails.matchType STRING Match type for this filter. Possible values are BEGINS_WITH, EQUAL, ENDS_WITH, CONTAINS, or MATCHES. GEO_DOMAIN, GEO_IP_ADDRESS, PAGE_REQUEST_URI, or PAGE_HOSTNAME filters can use any match type; all other filters must use MATCHES |
kind STRING Resource type for Analytics filter |
lowercaseDetails OBJECT Details for the filter of the type LOWER |
lowercaseDetails.field STRING Field to use in the filter |
lowercaseDetails.fieldIndex INTEGER The Index of the custom dimension. Required if field is a CUSTOM_DIMENSION |
name STRING Name of this filter |
parentLink OBJECT Parent link for this filter. Points to the account to which this filter belongs |
parentLink.href STRING Link to the account to which this filter belongs |
parentLink.type STRING Value is "analytics#account" |
searchAndReplaceDetails OBJECT Details for the filter of the type SEARCH_AND_REPLACE |
searchAndReplaceDetails.caseSensitive BOOLEAN Determines if the filter is case sensitive |
searchAndReplaceDetails.field STRING Field to use in the filter |
searchAndReplaceDetails.fieldIndex INTEGER The Index of the custom dimension. Required if field is a CUSTOM_DIMENSION |
searchAndReplaceDetails.replaceString STRING Term to replace the search term with |
searchAndReplaceDetails.searchString STRING Term to search |
selfLink STRING Link for this filter |
type STRING Type of this filter. Possible values are INCLUDE, EXCLUDE, LOWERCASE, UPPERCASE, SEARCH_AND_REPLACE and ADVANCED |
updated DATE_TIME Time this filter was last modified |
uppercaseDetails OBJECT Details for the filter of the type UPPER |
uppercaseDetails.field STRING Field to use in the filter |
uppercaseDetails.fieldIndex INTEGER The Index of the custom dimension. Required if field is a CUSTOM_DIMENSION |