Direct Link

Puoi condividere qualsiasi deployment del tuo connettore della community tramite un link. Quando un utente segue il link, verrà indirizzato direttamente a Looker Studio con il connettore selezionato.

Per ottenere un link diretto per il tuo connettore della community, segui questi passaggi:

  1. Vai ad Apps Script e apri il progetto di Community Connector da condividere. Fai clic su Esegui il deployment > Gestisci i deployment.
  2. Fai clic sul deployment Attivo da condividere. In URL del componente aggiuntivo di Looker Studio, viene visualizzato un link diretto a Looker Studio per il deployment selezionato. Fai clic su Copia. In alternativa, in ID deployment, fai clic su Copia e aggiungi l'ID deployment copiato al seguente URL per creare un link diretto: 
    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"
}

Passaggio 2: codifica l'URL

Una volta creato il codice JSON di configurazione, l'oggetto viene codificato tramite URL. Un'opzione semplice è quella di utilizzare la funzione JavaScript encodeURIComponent.

URL di codifica

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

Il risultato è la seguente stringa codificata:

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

Passaggio 3: crea l'URL

Il seguente codice crea il link diretto. Tieni presente che per creare l'URL avrai bisogno dell'ID deployment del connettore.

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;

Questo restituisce il seguente URL codificato, un link diretto precompilato per il connettore:

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