Stay organized with collectionsSave and categorize content based on your preferences.
The manifest (appsscript.json) is a JSON file in your Apps Script connector
project. It contains certain information about your Community Connector
that is required to deploy and use your connector in Looker Studio. Read more
aboutmanifests in Apps Script.
Your manifest should contain the following information:
property name
Type
Description
Required(under thedataStudioproperty)
name
string
Name of your connector. Limited to 28 characters
company
string
Name of the organization or developer.
companyUrl
string (link)
Link to the organization or developer's website.
logoUrl
string (image link)
The URL to an icon for your connector. The required dimensions are 40px by 40px.
addOnUrl
string (link)
Link to a dedicated 'Learn More' page that should explain what your
connector does and the data it accesses. You should host and maintain this
page. This page must contain or link to your Terms of Service and Privacy
Policy.
supportUrl
string (link)
Link to the support page for supporting this connector. Users
should be able to report issues with your connector at this link. You
should host and maintain this page.
description
string
The description for your connector. Users will see the full description in your connector
configuration page. Links will be clickable.
Optional(under thedataStudioproperty)
shortDescription
string
Limit: 114 characters.If your connector is published,
this short description will be visible in the gallery card for your
connector. Use this to briefly describe what your connector does. Users
will be able to view this when they browse through connectors in the
gallery.
privacyPolicyUrl
string (link)
Link to the Privacy Policy for the connector / developer organization.
termsOfServiceUrl
string (link)
Link to the Terms of Services for the connector / developer organization.
The list of data sources that this connector can connect to. SeeSourcesbelow.
templates
Object
List of templates that can be used with this connector. Only one default
template is supported, identified by setting adefaultkey. The value should be the report ID for the Looker
Studio report that will be used as the template. See the guide onProviding
report templates.
forceViewersCredentials
boolean
Whether or not viewer's credentials should be forced for data sources
created from this connector. This property is optional and defaults tofalse. SeeData
source credentialsfor more details on viewer's credentials.
useQueryConfig
boolean
DEPRECATED: Whether or not this connector will return a query config for
`getData()`. Use `advancedServices` instead.
advancedServices.data
boolean
Whether or not this connector will return a query config for
`getData()`. Seeadvanced
services.
advancedServices.schema
boolean
Whether or not this connector will return a query config for
`getSchema()`. Seeadvanced
services.
Optional(Root level property)
urlFetchWhitelist
list(string)
A list of HTTPS URL prefixes which your connector uses. Any URL endpoint
fetched must match one of the prefixes in this list. This can help to
protect user data. SeeSafelisting
URLsfor more details.
AuthType
The values for authentication method type can be one of the following:
Enum Value
Description
NONE
Indicates there is no authentication required for the
connector.
OAUTH2
Indicates the connector uses OAuth 2.0.
KEY
Indicates the connector uses API key.
USER_PASS
Indicates the connector uses username/password.
USER_TOKEN
Indicates the connector uses username/token.
PATH_USER_PASS
Indicates the connector uses path/username/password.
PATH_KEY
Indicates the connector uses path/key.
FeeType
The values for fee type can be any of the following:
Enum Value
Description
FREE
Indicates the connector is completely free to use.
FREE_TRIAL
Indicates the connector has a free trial option.
PAID
Indicates the user will need to pay to use the connector.
Sources
Sources is a list of enums for sources. You can view the existing list of
sources at ourData Registry Repository. If the source you are connecting to
does not exist in the repository, send apull request to the Data Registry
Repositoryto add the source. The source name can contain only uppercase
characters and underscores (e.g. Google Analytics will beGOOGLE_ANALYTICS).
In your Community Connector manifest, use thevalueof the data source id
property, e.g.GOOGLE_ANALYTICS.
Example manifest for a Community Connector
The following is an example of a completed manifest:
{"dataStudio":{"name":"Nucleus by Hooli","company":"Hooli Inc.","companyUrl":"https://hooli.xyz","logoUrl":"https://hooli.xyz/middle-out-optimized/nucleus/logo.png","addonUrl":"https://hooli.xyz/data-studio-connector","supportUrl":"https://hooli.xyz/data-studio-connector/support","description":"Nucleus by Hooli connector lets you connect to your data in Data Studio using Nucleus middle out optimization. You will need an account on hooli.xyz to use this connector. Create your account at https://hooli.xyz/signup","shortDescription":"Connect to your data using Nucleus middle out optimization","privacyPolicyUrl":"https://hooli.xyz/privacy","termsOfServiceUrl":"https://hooli.xyz/tos","authType":["NONE"],"feeType":["PAID"],"sources":["HOOLI_CHAT_LOG","ENDFRAME_SERVER_STREAM","RETINABYTE_USER_ANALYTICS"],"templates":{"default":"872223s89f5fdkjnd983kjf"}},"urlFetchWhitelist":["https://api.hooli.xyz/","https://hooli.xyz/"]}
[[["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 2025-07-23 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eappsscript.json\u003c/code\u003e manifest file provides essential information about your Apps Script connector for deployment and usage in Looker Studio.\u003c/p\u003e\n"],["\u003cp\u003eIt includes required fields like connector name, company details, URLs, description, and optional fields for enhanced functionality and user experience.\u003c/p\u003e\n"],["\u003cp\u003eThe manifest supports specifying authentication type, fee type, data sources, and report templates, allowing for customization and integration.\u003c/p\u003e\n"],["\u003cp\u003eYou need to whitelist any external URLs your connector accesses using the \u003ccode\u003eurlFetchWhitelist\u003c/code\u003e property for security purposes.\u003c/p\u003e\n"],["\u003cp\u003eAll information included in the manifest file is publicly accessible, so avoid including any sensitive data.\u003c/p\u003e\n"]]],[],null,[]]
