Enlace directo

Puedes compartir cualquiera de las implementaciones de tu conector comunitario mediante un enlace. Cuando los usuarios acceden a este enlace, se les dirige directamente a Data Studio y el conector aparece seleccionado.

Para obtener un enlace directo a tu conector comunitario, sigue estos pasos:

  1. Ve a Apps Script y abre el proyecto del conector comunitario que quieras compartir. Haz clic en Publicar > Desplegar desde el manifiesto.
  2. Haz clic en el nombre de la implementación concreta que quieras compartir o en el icono de Data Studio que aparece junto al enlace Obtener el ID. Se mostrará el enlace del conector que dirige a Data Studio. Si lo prefieres, puedes obtener el ID de la implementación haciendo clic en Obtener ID. Este ID se debe adjuntar a la siguiente URL para formar un enlace directo:
    https://datastudio.google.com/datasources/create?connectorId=YOUR_DEPLOYMENT_ID
  3. El enlace directo se puede compartir con los usuarios. Por ejemplo, puedes publicarlo en tu sitio web, en tu blog o en las redes sociales.

Rellenar previamente la configuración

Si sabes de antemano qué valores de configuración querrán los usuarios, puedes proporcionar algunos parámetros de consulta más para rellenar previamente la configuración del conector. Los usuarios podrán modificar esta configuración, pero no tendrán que introducirla manualmente.

Para crear un enlace directo rellenado previamente, puedes añadir los siguientes parámetros de consulta opcionales a un enlace directo del conector:

  • connectorConfig: una cadena JSON codificada en URL que contiene los pares clave/valor que se deben utilizar para rellenar previamente la configuración del conector.

    • Los nombres de las claves deben coincidir con los nombres de los parámetros definidos en la configuración del conector.
    • Los valores de TEXTINPUT, TEXTAREA y SELECT_SINGLE deben ser cadenas.
    • Los valores de CHECKBOX deben ser booleanos.
    • Los valores de SELECT_MULTIPLE deben ser un conjunto de cadenas.
  • reportTemplateId: un identificador de la plantilla de informe predeterminada que se debe utilizar para el conector. Si se configura una plantilla predeterminada en el archivo de manifiesto del conector, este valor anulará el manifiesto. Consulte Cómo añadir la plantilla de informe del valor que se va a utilizar.

Ejemplo

El siguiente ejemplo indica cómo crear un enlace directo al conector comunitario StackOverflow Questions. El enlace directo rellena previamente la configuración del conector para utilizar la etiqueta google-data-studio en Stack Overflow.

Prueba el enlace directo al conector de StackOverflow.

Paso 1: Crea la configuración JSON

Las claves de la configuración JSON son los nombres de cada elemento de la configuración. En el caso de la configuración de StackOverflow, estos nombres son tagged, pagesize y sort.

JSON antes de la codificación

{
        "tagged": "google-data-studio",
        "pagesize": 25,
        "sort": "activity"
    }
    

Paso 2: Codifica la URL

Después de crear la configuración JSON, debes codificar el objeto en forma de URL. La forma más sencilla de hacerlo es con la función de JavaScript encodeURIComponent.

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%22google-data-studio%22%2C%22pagesize%22%3A%2225%22%2C%22sort%22%3A%22activity%22%7D"
    

Paso 3: Crea la URL

El siguiente código crea el enlace directo. Ten en cuenta que necesitarás el ID de implementación de tu conector para crear 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);
    let 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;

Este código devuelve la siguiente URL codificada, un enlace directo rellenado previamente para el conector:

https://datastudio.google.com/datasources/create?connectorConfig=%7B%22tagged%22%3A%22google-data-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
    

Prueba el enlace para ver cómo se rellena automáticamente la configuración.