Direkter Link

Sie können jede Bereitstellung Ihres Community-Connectors über einen Link teilen. Wenn ein Nutzer dem Link folgt, wird er direkt zu Looker Studio weitergeleitet, wobei der Connector ausgewählt ist.

So erhalten Sie einen direkten Link für Ihren Community-Connector:

  1. Gehen Sie zu Apps Scripts und öffnen Sie das Projekt des Community-Connectors, das Sie freigeben möchten. Klicken Sie auf Bereitstellen > Bereitstellungen verwalten.
  2. Klicken Sie auf Aktive Bereitstellung, die Sie freigeben möchten. Unter URL des Looker Studio-Add-ons wird ein direkter Link zu Looker Studio für die ausgewählte Bereitstellung angezeigt. Klicken Sie auf Kopieren. Alternativ können Sie unter Bereitstellungs-ID auf Kopieren klicken und die kopierte Bereitstellungs-ID an die folgende URL anhängen, um einen direkten Link zu erstellen: 
    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"
}

Schritt 2: URL codieren

Nachdem die JSON-Konfigurationsdatei erstellt wurde, führen Sie eine URL-Codierung des Objekts durch. Eine einfache Möglichkeit ist die Verwendung der JavaScript-Funktion encodeURIComponent.

URL-Codierung

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

Das Ergebnis ist der folgende codierte String:

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

Schritt 3: URL erstellen

Mit dem folgenden Code wird der direkte Link erstellt. Sie benötigen die Bereitstellungs-ID des Connectors, um die URL zu erstellen.

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;

Dadurch wird die folgende codierte URL zurückgegeben. Dabei handelt es sich um einen vorab ausgefüllten direkten Link für den Connector:

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