لینک مستقیم

می‌توانید هر گونه استقرار Connector Community خود را با یک پیوند به اشتراک بگذارید. هنگامی که کاربر پیوند را دنبال می کند، او را با انتخاب رابط شما مستقیماً به استودیوی Looker می برد.

برای دریافت پیوند مستقیم برای رابط انجمن خود، این مراحل را دنبال کنید:

  1. به Apps Scripts بروید و پروژه Community Connector را برای اشتراک‌گذاری باز کنید. روی Deploy > Manage Deployments کلیک کنید.
  2. برای اشتراک‌گذاری روی Active Deployment کلیک کنید. در نشانی اینترنتی افزونه Looker Studio ، یک پیوند مستقیم به Looker Studio برای استقرار انتخاب شده نمایش داده می‌شود، روی Copy کلیک کنید. یا در زیر Deployment ID روی Copy کلیک کنید و شناسه استقرار کپی شده را به 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 است.

کدگذاری آدرس اینترنتی

// 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 را بسازید

کد زیر لینک مستقیم را ایجاد می کند. توجه داشته باشید که برای ساخت 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;

این نشانی اینترنتی کدگذاری شده زیر را باز می گرداند، یک پیوند مستقیم از پیش پر شده برای رابط:

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