Partner Connector requirements

You should first review the Publishing overview to understand the different publishing options as well as their differences in benefits and required level of commitment. This will help you to choose the right publishing option for your connector.

If you want to publish your connector as a Partner Connector, you must meet the following requirements before requesting a review.

Apps Script

  1. Enable link sharing for the Apps Script project to provide read access.
  2. Create a deployment named Production and update the Production deployment to contain the version of code you want to publish.
  3. If you have updated your code since creating the Production deployment, ensure that the desired version of the code is provided under that deployment before you submit your connector.

Manifest

You must include the following in your connector's manifest. View manifest reference for more information about each property in manifest.

  1. In description, make sure you provide all info/instructions necessary to have a basic understanding of the connector and how to use it.
  2. addonUrl should be a dedicated hosted page about your connector, preferably hosted on your own domain. This page must contain or link to both your Privacy Policy and Terms of Use. This page should contain any details the user will need to know to use your connector. See example pages from existing partners: Funnel, Supermetrics, CallRail.
  3. supportUrl should be a hosted page where users can go to get support for your connector.
  4. You should populate the sources property with all the sources your connector connects to. See Sources in Manifest reference for details.
    • You can view the existing list of sources at our Data Registry Repository. If the source you are connecting to does not exist in the repository, send a [pull request to the Data Registry Repository] to add the source. Your connector will fail the review process if the sources in your manifest do not exist in the repository.
    • This is additional metadata for the connector that will be indexed for search feature in the gallery. You connector will show up in the search results when users search for a specific data source in the gallery.
    • The gallery will let users discover connectors by data sources by providing a Connectors by Data Source interface.
  5. You should limit the number of endpoints called by UrlFetchApp in your connector to those absolutely required for connector functionality. Add the
    urlFetchWhitelist property to the root level of your manifest. View the
    urlFetchWhitelist reference for more info.
    • This property should contain all URLs your connector connects to using the UrlFetchApp call.
    • If your connector does not execute a UrlFetchApp call then set the property value to an empty list [].
  6. Manifest should contain values for shortDescription, authType, and feeType. Starting from May 01, 2018, manifest should also contain values for privacyPolicyUrl and termsOfServiceUrl.

Template and report

  1. If you connector has a fixed schema, create a report template for your connector and add it to the manifest.
  2. Create at least one demo report using your connector and submit the report to Data Studio gallery. This report can be a replica of your template report or a separate report that displays even broader functionalities of your connector.
  3. Adding the demo reports makes your connector eligible for promotional opportunities (getting featured, mentions in newsletters and blog posts, case studies etc).

Connector

  1. If the user needs an account to use the connector, make sure the connector description or the Learn More page provides a link or instructions to help the user create one.
  2. Your connector cannot be in unfinished or beta status. You have to publish a complete and functional connector. You can always update your connector but the production deployment that is released to users should be tested and feature complete.
  3. Provide meaningful and actionable error messages to users when users encounter a Connector internal error. This includes cases when a user provides invalid/blank input at configuration.
  4. You connector's short description, description, OAuth page (if applicable), Learn more page, and Support page should be free of spelling and grammatical errors.
  5. Ensure you and your connector adhere to the Data Studio Galleries Terms of Service (Submitter).

Once you have met all the requirements, click the following button to request a review for your connector:

Publish your Partner Connector