直接連結

您可以透過連結分享社群連結器的任何部署作業。使用者點選連結後，系統會直接將他們帶往 Looker Studio，並選取您的連接器。

如要取得社群連結器的直接連結，請按照下列步驟操作：

  1. 前往 Apps Script，開啟要共用的社群連結器專案。依序點選「Deploy」(部署) >「Manage Deployments」(管理部署作業)。
  2. 按一下要分享的「有效」部署作業。「Looker Studio 外掛程式網址」下方會顯示所選部署作業的 Looker Studio 直接連結，請按一下「複製」。或者，在「部署 ID」下方按一下「複製」，然後將複製的部署 ID 附加至下列網址，即可形成直接連結：
    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：編碼網址

建立設定 JSON 後，請對物件進行網址編碼。簡單的做法是使用 encodeURIComponent JavaScript 函式。

編碼網址

// 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：建構網址

以下程式碼會建立直接連結。請注意，您需要連接器的部署 ID 才能建構網址。

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;

這會傳回下列已編碼的網址，也就是連接器的預先填入直接連結：

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