Vínculo directo

Puedes compartir cualquier implementación de tu Community Connector con un vínculo. Cuando un elemento usuario sigue el vínculo, lo llevará directamente a Looker Studio con tu conector seleccionado.

Para obtener un vínculo directo al conector de tu comunidad, sigue estos pasos:

  1. Ve a Apps Script y abre el proyecto de la comunidad Conector para compartir. Haz clic en Implementar > Administra implementaciones
  2. Haz clic en la implementación Activa para compartirla. En URL del complemento de Looker Studio, aparecerá una Se muestra un vínculo directo a Looker Studio para la implementación seleccionada, haz clic en Copiar. Como alternativa, en ID de implementación, haz clic en Copiar y agrega el copiaste el ID de implementación en la siguiente URL para formar un vínculo directo: 
    https://lookerstudio.google.com/datasources/create?connectorId=DEPLOYMENT_ID
  3. The direct link can be shared with users. For example, send it via email, post it on a website, blog, social media, etc.

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.

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, and SELECT_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"
}

Paso 2: Codifica la URL

Después de crear el archivo JSON de configuración, codifica el objeto como URL. Una opción sencilla es usar la función encodeURIComponent de JavaScript.

URL de codificación

// get a reference to the jsonConfig
var jsonConfig;
var encoded = encodeURIComponent(jsonConfig);

El resultado es la siguiente cadena codificada:

"%7B%22tagged%22%3A%22looker-studio%22%2C%22pagesize%22%3A%2225%22%2C%22sort%22%3A%22activity%22%7D"

Paso 3: Crea la URL

Con el siguiente código, se compila el vínculo directo. Ten en cuenta que necesitarás el ID de implementación del conector para compilar la URL.

data-studio/links.gs
// These variables should be filled in as necessary for your connector.
var configJSON;
var templateId;
var deploymentId;

var params = [];

const jsonString = JSON.stringify(configJSON);
const encoded = encodeURIComponent(jsonString);
params.push('connectorConfig=' + encoded);

params.push('reportTemplateId=' + templateId);

params.push('connectorId=' + deploymentId);

const joinedParams = params.join('&');
const URL = 'https://datastudio.google.com/datasources/create?' + joinedParams;

De esta forma, se muestra la siguiente URL codificada, un vínculo directo completado previamente para el conector:

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