直リンク

コミュニティ コネクタのデプロイは、リンクで共有することができます。特定の リンクをクリックすると、直接 Looker Studio が表示され、 コネクタが選択されています

コミュニティ コネクタの直接リンクを取得する手順は以下のとおりです。

  1. Apps Scripts に移動し、コミュニティのプロジェクトを開きます。 共有するコネクタ。[デプロイ >Deployment を管理するをご覧ください。
  2. 共有する [Active] デプロイメントをクリックします。[Looker Studio のアドオン URL] で、 選択したデプロイメントの Looker Studio への直接リンクが表示されたら、 コピー。または、[デプロイ ID] で [コピー] をクリックし、 Deployment ID を次の URL にコピーして、直接リンクを作成します。
    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"
}

ステップ 2: URL をエンコードする

構成 JSON が作成されたら、オブジェクトを URL エンコードします。簡単なオプション encodeURIComponent JavaScript 関数を使用する方法があります。

URL のエンコード

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

次のように文字列がエンコードされます。

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

ステップ 3: URL を構築する

次のコードは、直接リンクを構築します。なお、 コネクタのデプロイ ID を使用して 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;

次のように、エンコードされた URL(事前入力されたコネクタの直接リンク)が返されます。

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