Fields

Query fields can be provided either as a comma delimited string, list of strings, or a list of objects. Only the last one can contain additional field properties.

{"fields": "date, impressions"}
{"fields": ["date", "impressions"]}
{"fields": [{"id": "date"}, {"id": "impressions"}]}

Please refer to data source specific field documentation for accepted ID values.

Field properties

PropertyTypeDescription
idstringRequired. Field ID
keystringOptional. Custom key to use for field value in output formats which provide data as key-value paired JSON objects. Defaults to the value of id.
namestringOptional. Custom field name. Appears in the response field_name property and in the header row of the query results. Not allowed to contain any HTML.
splitstring
Optional. Field split by type. Defaults to row.
rowField value will be placed into rows
columnField value will be used as a column (pivoting)
transformstringOptional. Transformations to apply to this field. See transformations for more.
visibleboolOptional. Whether field should be visible in query results. Field data is still queried and used e.g. to split rows, but just not returned in final query results. See related setting no_dimensions. Defaults to true.
Last updated 2022-10-25 UTC.