直接链接

您可以通过链接共享社区连接器的任何部署。用户点击该链接时,会直接转到数据洞察,其中您的连接器已被选定。

要获取社区连接器的直接链接,请按以下步骤操作:

  1. 转到 Apps 脚本,打开您要共享的社区连接器项目。点击发布 > 从清单部署
  2. 对于要共享的具体部署,请点击部署名称或“获取 ID”链接旁边的数据洞察图标。它将显示此连接器在数据洞察中的直接链接。或者,您也可以点击“获取 ID”来获取部署 ID,然后将此 ID 附加到以下网址,以组成直接链接:
    https://datastudio.google.com/datasources/create?connectorId=YOUR_DEPLOYMENT_ID
  3. 可以与用户共享直接链接。例如,您可以将其发布到您的网站、博客或社交媒体上。

预填充配置

如果您提前知道用户需要的配置值,则可以多提供一些查询参数来预填充连接器配置。预填充配置仍可修改,但您的用户无需手动输入。

要创建预填充直接链接,可以将以下可选查询参数添加到连接器的直接链接中:

  • connectorConfig - 网址编码的 JSON 字符串,包含用于预填充连接器配置的键值对。

    • 键名必须与连接器配置中定义的参数名称匹配。
    • TEXTINPUTTEXTAREASELECT_SINGLE 的值应为字符串。
    • CHECKBOX 的值应为布尔值。
    • SELECT_MULTIPLE 的值应为字符串数组。
  • reportTemplateId - 用于连接器的默认报告模板的标识符。如果在连接器清单中设置了默认模板,则此值将替换清单。请参阅如何为要使用的值添加报告模板

示例

以下示例说明了如何创建指向 StackOverflow Questions 社区连接器的直接链接。直接链接会预填充连接器配置,以使用 Stack Overflow 上的 google-data-studio 代码。

试用 StackOverflow 连接器的直接链接

第 1 步:创建配置 JSON

配置 JSON 的键是每个配置项的名称。对于 StackOverflow 配置,这些名称为 taggedpagesizesort

编码前的 JSON

{
        "tagged": "google-data-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%22google-data-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);
    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;

这将返回以下编码网址,即连接器的预填充直接链接:

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
    

试用此链接,了解其在配置中的填充方式。