Connectors changelog
Stay organized with collections
Save and categorize content based on your preferences.
2022-11-02
- Field grouping is now displayed in the Data panel. If using the
Looker Studio Service to define a field, the group is
set with the
setGroup
method. If you define fields using
JSON, the group is defined by the group
property.
2022-05-03
- Added the
PATH_KEY
AuthType
to support authentication methods that
require a path and key/token. See Authentication for details.
- The manifest
dataStudio.authType
property now supports the
PATH_USER_PASS
and PATH_KEY
auth types.
2022-03-24
- Chart cross-filtering is turned on by default for charts based on community
connectors. When turned ON, cross-filtering may increase user interactions
and the number of requests sent to your connector. For more information see
Release notes: March 24, 2022.
2020-10-06
2020-01-08
- Overriding config parameters via URL now uses a flattened JSON structure.
Existing parameterized URLs will continue to work. See
Modifying parameter values.
2019-09-09
2019-08-28
2019-07-25
- Filter information is now passed to connectors via the
getData() request object. This allows connectors to apply filters which
can drastically improve performance in some cases. Existing connectors are
backwards compatible with this change and do not require any changes. See
the Filters guide for more details.
2019-06-25
- Removed
cachedData
from the getData
response.
2019-04-18
- Added a local development guide for community connectors. This guide
outlines best practices & scripts that can be used to improve the quality of
your connectors.
2019-04-16
2019-04-03
2019-02-27
- Added advanced services. If your connector uses BigQuery, you can now have
Looker Studio fetch the data for you.
- Added the
useQueryConfig
property to the manifest.
2019-01-22
2018-12-19
2018-12-14
- Updated error handling and debugging guides with new error handling
functionality.
- Deprecatated
DS_USER
prefix for throwing user-facing errors. Will be
removed in June 2019.
2018-11-30
- Added support for the
USER_TOKEN
authentication type. See
Authentication and Authorization for details.
helpUrl
can be set for USER_TOKEN
, USER_PASS
, or KEY
AuthType
s.
This optional url can be provided to give users more details on how to
authenticate the connector.
- Added support to force viewer's credentials for data sources created from a
community connector. See the
forceViewersCredentials
key in the
manifest reference
2018-11-28
- Fixed an issue where
resetAuth()
wasn't being called when a connector
was removed from the gallery.
2018-10-18
- Added the option to hide a field. See
Field
for details.
2018-10-16
- Links in the manifest
description
and INFO
config entries are now
clickable.
2018-10-11
- Added Apps Script Service. This service provides builders for creating a
config and schema, and has helper functions for many common connector
patterns. See announcement for details on new features and how to migrate.
2018-09-26
2018-08-29
- Enhanced error handling. Error messages are now shown to users for errors
that happen during the execution of
getSchema
, getConfig
, and
getAuthType
. See error handling and messages for additional details.
2018-07-30
2018-07-19
- Clarified OSCC requirements.
2018-07-11
- Added functionality to connector links. Connector configuration can now be
populated through query parameters. See Creating A Pre-Populated Link for
details.
2018-06-19
- Added support for
USER_PASS
and KEY
authentication. See
Authentication for details.
2018-05-29
- Added parameters support to the connector configuration. If enabled by the
data source creator, config entries can be changed after data source
configuration. See Overriding connector parameters in reports for details.
2017-12-13
2017-11-02
2017-09-06
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-09-18 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-09-18 UTC."],[[["\u003cp\u003eLooker Studio Community Connectors launched in September 2017, enabling developers to build and share custom data connectors.\u003c/p\u003e\n"],["\u003cp\u003eConnectors can be configured with various authentication types, including \u003ccode\u003eUSER_TOKEN\u003c/code\u003e, \u003ccode\u003eUSER_PASS\u003c/code\u003e, \u003ccode\u003eKEY\u003c/code\u003e, and \u003ccode\u003ePATH_KEY\u003c/code\u003e, and support advanced services for data fetching.\u003c/p\u003e\n"],["\u003cp\u003eData Studio now supports field grouping, chart cross-filtering by default for community connectors, and stepped configuration for dynamic user input.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can leverage the Apps Script Service for creating connector configurations and schemas, along with helper functions for common patterns.\u003c/p\u003e\n"],["\u003cp\u003eSemantic types and metadata enrich data fields, offering features like default aggregation types, formulas, and descriptions for enhanced visualization.\u003c/p\u003e\n"]]],[],null,["# Connectors changelog\n\n2022-11-02\n----------\n\n- Field grouping is now displayed in the [Data panel](https://support.google.com/looker-studio/answer/12253817#data-panel). If using the [Looker Studio Service](/looker-studio/connector/reference#looker-studio-service_3) to define a field, the group is set with the `setGroup` method. If you define fields using [JSON](/looker-studio/connector/reference#legacy_3), the group is defined by the `group` property.\n\n2022-05-03\n----------\n\n- Added the `PATH_KEY` [`AuthType`](/looker-studio/connector/reference#authtype) to support authentication methods that require a path and key/token. See [Authentication](/looker-studio/connector/auth) for details.\n- The manifest [`dataStudio.authType`](/looker-studio/connector/reference#authtype) property now supports the `PATH_USER_PASS` and `PATH_KEY` auth types.\n - Fixes [Issue #198756420](https://issuetracker.google.com/198756420) appscript.json won't save with authType PATH_USER_PASS.\n\n2022-03-24\n----------\n\n- Chart cross-filtering is turned on by default for charts based on community connectors. When turned ON, cross-filtering may increase user interactions and the number of requests sent to your connector. For more information see [Release notes: March 24, 2022](https://support.google.com/looker-studio/answer/11521624#mar-24-2022).\n\n2020-10-06\n----------\n\n- Query config for [`getSchema()`](/looker-studio/connector/reference#getschema) is now supported with [advanced services](/looker-studio/connector/advanced-services).\n- Deprecated `useQueryConfig` in [manifest](/looker-studio/connector/manifest) and replaced it with `advancedServices.data` and `advancedServices.schema`\n- Added support for new [`AuthType`](/looker-studio/connector/reference#authtype): `PATH_USER_PASS`. See [Authentication](/looker-studio/connector/auth) for details.\n\n2020-01-08\n----------\n\n- Overriding config parameters via URL now uses a flattened JSON structure. Existing parameterized URLs will continue to work. See [Modifying parameter values](/looker-studio/connector/data-source-parameters#modifying_parameter_values).\n\n2019-09-09\n----------\n\n- Added support for `YEAR_MONTH_DAY_SECOND` [SemanticType](/looker-studio/connector/reference#semantictype).\n\n2019-08-28\n----------\n\n- Added [Stepped Configuration](/looker-studio/connector/stepped-configuration). Connector configurations can now be dynamic based on user provided input.\n\n2019-07-25\n----------\n\n- Filter information is now passed to connectors via the [getData() request object](/looker-studio/connector/reference#dimensionsfilters). This allows connectors to apply filters which can drastically improve performance in some cases. Existing connectors are backwards compatible with this change and do not require any changes. See the [Filters](/looker-studio/connector/filters) guide for more details.\n\n2019-06-25\n----------\n\n- Removed `cachedData` from the `getData` response.\n\n2019-04-18\n----------\n\n- Added a [local development](/looker-studio/connector/local-development) guide for community connectors. This guide outlines best practices \\& scripts that can be used to improve the quality of your connectors.\n\n2019-04-16\n----------\n\n- Added support for `HYPERLINK`, `IMAGELINK`, and `IMAGE` semantic types. See [Formula Semantic Types](/looker-studio/connector/reference#formula_semantic_types).\n\n2019-04-03\n----------\n\n- Improved the user experience for connectors using viewer's credentials. See the [Improved Viewer's Credentials Authorization Flow](https://groups.google.com/forum/#!topic/data-studio-developers/MWLV6QwkOpw) announcement post for more details.\n\n2019-02-27\n----------\n\n- Added [advanced services](/looker-studio/connector/advanced-services). If your connector uses BigQuery, you can now have Looker Studio fetch the data for you.\n- Added the `useQueryConfig` property to the [manifest](/looker-studio/connector/manifest).\n\n2019-01-22\n----------\n\n- Updated [Authentication and Authorization](/looker-studio/connector/auth) to use the [newAuthTypeResponse()](/apps-script/reference/data-studio/community-connector#newauthtyperesponse) builder.\n\n2018-12-19\n----------\n\n- Concluded the developer preview. See [The Year in Looker Studio Community Connectors](https://blog.google/products/marketingplatform/analytics/2018-year-data-studio-community-connectors/?linkId=61339390) for a reflection on 2018!\n\n2018-12-14\n----------\n\n- Updated [error handling](/looker-studio/connector/error-handling) and [debugging](/looker-studio/connector/debug) guides with new error handling functionality.\n- Deprecatated `DS_USER` prefix for throwing user-facing errors. Will be removed in June 2019.\n\n2018-11-30\n----------\n\n- Added support for the `USER_TOKEN` authentication type. See [Authentication and Authorization](/looker-studio/connector/auth) for details.\n- `helpUrl` can be set for `USER_TOKEN`, `USER_PASS`, or `KEY` `AuthType`s. This optional url can be provided to give users more details on how to authenticate the connector.\n- Added support to force viewer's credentials for data sources created from a community connector. See the `forceViewersCredentials` key in the [manifest reference](/looker-studio/connector/manifest)\n\n2018-11-28\n----------\n\n- Fixed an issue where [`resetAuth()`](/looker-studio/connector/auth#resetauth) wasn't being called when a connector was removed from the gallery.\n\n2018-10-18\n----------\n\n- Added the option to hide a field. See [`Field`](/looker-studio/connector/reference#field) for details.\n\n2018-10-16\n----------\n\n- Links in the [manifest](/looker-studio/connector/manifest) `description` and [`INFO`](/looker-studio/connector/reference#configtype) config entries are now clickable.\n\n2018-10-11\n----------\n\n- Added [Apps Script Service](/apps-script/reference/data-studio). This service provides builders for creating a config and schema, and has helper functions for many common connector patterns. See [announcement](https://groups.google.com/forum/#!topic/data-studio-developers/onR-075lJy8) for details on new features and how to migrate.\n\n2018-09-26\n----------\n\n- Updated [Using calculated fields](/looker-studio/connector/calculated-fields) to clarify that a `$` must be prepended before names of fields in formulas.\n\n2018-08-29\n----------\n\n- Enhanced error handling. Error messages are now shown to users for errors that happen during the execution of `getSchema`, `getConfig`, and `getAuthType`. See [error handling and messages](/looker-studio/connector/error-handling) for additional details.\n\n2018-07-30\n----------\n\n- The Community Connector Gallery has been moved and is now available at \u003chttps://lookerstudio.google.com/data\u003e.\n\n2018-07-19\n----------\n\n- Clarified [OSCC](/looker-studio/connector/oscc-requirements) requirements.\n\n2018-07-11\n----------\n\n- Added functionality to connector links. Connector configuration can now be populated through query parameters. See [Creating A Pre-Populated Link](/looker-studio/connector/direct-links#creating_a_pre-populated_link) for details.\n\n2018-06-19\n----------\n\n- Added support for `USER_PASS` and `KEY` authentication. See [Authentication](/looker-studio/connector/auth) for details.\n\n2018-05-29\n----------\n\n- Added parameters support to the connector configuration. If enabled by the data source creator, config entries can be changed after data source configuration. See [Overriding connector parameters in reports](/looker-studio/connector/data-source-parameters) for details.\n\n2017-12-13\n----------\n\n- Added support for new metadata for schema fields.\n\n - [`semanticType`](/looker-studio/connector/reference#semantictype)\n - [`semanticGroup`](/looker-studio/connector/reference#semanticgroup)\n - [`defaultAggregationType`](/looker-studio/connector/reference#defaultaggregationtype)\n - [`description`](/looker-studio/connector/reference#field.description)\n - [`formula`](/looker-studio/connector/reference#field.formula)\n - [`isDefault`](/looker-studio/connector/reference#field.isdefault)\n - [`group`](/looker-studio/connector/reference#field.group)\n- Added detail to\n [Data types and semantic types](/looker-studio/connector/semantics#manual-semantic-types)\n to explain how to manually define semantic types.\n\n2017-11-02\n----------\n\n- Launched [Open Source repo on GitHub](https://github.com/google/datastudio) and added the [Open Source Community Connectors](/looker-studio/connector/open-source) page.\n\n2017-09-06\n----------\n\n- [Developer Launch](/looker-studio/connector/developer-launch) for Looker Studio Community Connectors!"]]