Vous pouvez partager n'importe quel déploiement de votre connecteur de communauté à l'aide d'un lien. Lorsqu'un utilisateur clique sur le lien, il est directement redirigé vers Looker Studio, où votre connecteur est sélectionné.
Pour obtenir un lien direct vers votre connecteur de communauté, procédez comme suit:
- Accédez à Apps Script et ouvrez le projet du connecteur de communauté à partager. Cliquez sur Déployer > Gérer les déploiements.
- Cliquez sur le déploiement Actif à partager. Sous URL du module complémentaire Looker Studio, un lien direct vers Looker Studio pour le déploiement sélectionné s'affiche. Cliquez sur Copier. Vous pouvez également cliquer sur Copier sous ID de déploiement et ajouter l'ID de déploiement copié à l'URL suivante pour créer un lien direct :
https://lookerstudio.google.com/datasources/create?connectorId=DEPLOYMENT_ID
- The direct link can be shared with users. For example, send it via email, post it on a website, blog, social media, etc.
Preconfigure a direct link
If you know the configuration values that your users will want ahead of time, you can provide additional query parameters to pre-populate the connector configuration. The pre-populated configuration can still be modified by users.
Create a preconfigured direct Link
To create a preconfigured direct link, add the following optional query parameters:
connectorConfig
- A URL encoded JSON string containing key-value pairs to use to pre-populate the connector configuration.- Key names must match the parameter names defined in the connector config.
TEXTINPUT
,TEXTAREA
, andSELECT_SINGLE
values should be strings.CHECKBOX
values should be a boolean.SELECT_MULTIPLE
values should be an array of strings.
reportTemplateId
- An identifier for the default reporting template to use for the connector. If a default template is set in the connector manifest, this value will override the manifest. See How To Add The Report Template for the value to use.
Example
The following example illustrates how to create a direct link to the
StackOverflow Questions community connector. The direct link
pre-populates the connector configuration to use the looker-studio
tag on
Stack Overflow.
Step 1: Create the config JSON
The keys for the config JSON are the names of each configuration item. For the
Stack Overflow config, these names are tagged
, pagesize
, and
sort
.
JSON before encoding
{
"tagged": "looker-studio",
"pagesize": 25,
"sort": "activity"
}
Étape 2: Encoder l'URL
Une fois le fichier de configuration JSON créé, vous devez encoder l'objet en URL. Une option simple consiste à utiliser la fonction JavaScript encodeURIComponent
.
URL d'encodage
// get a reference to the jsonConfig
var jsonConfig;
var encoded = encodeURIComponent(jsonConfig);
Le résultat est la chaîne encodée suivante:
"%7B%22tagged%22%3A%22looker-studio%22%2C%22pagesize%22%3A%2225%22%2C%22sort%22%3A%22activity%22%7D"
Étape 3: Créez l'URL
Le code suivant crée le lien direct. Notez que vous aurez besoin de l'ID de déploiement du connecteur pour créer l'URL.
Cette opération renvoie l'URL encodée suivante, qui est un lien direct prérempli pour le connecteur:
https://lookerstudio.google.com/datasources/create?connectorConfig=%7B%22tagged%22%3A%22looker-studio%22%2C%22pagesize%22%3A%2225%22%2C%22sort%22%3A%22activity%22%7D&reportTemplateId=1lR9CGfx3uyQp6oz7oAgA1rsqZViA-IQs&connectorId=AKfycbwGMj-oe532y-NEbMHo-KLUCEz0EEGOZj-3lhEgw7q65-hs-T_F9B3Qjw