Link direto

Você pode usar um link para compartilhar qualquer implantação do seu conector da comunidade. Quando um usuário clicar nele, ele será direcionado ao Data Studio com o conector selecionado.

Para fazer essa configuração, siga estas etapas:

  1. Acesse o Apps Script e abra o projeto do conector da comunidade que você quer compartilhar. Clique em Publicar > Implantar pelo manifesto...
  2. Clique no nome da implantação específica que você quer compartilhar ou no ícone do Data Studio ao lado do link Obter código. O link direto do conector será exibido no Data Studio. Se preferir, você pode recuperar o código da implantação clicando em Obter código. O código precisa ser anexado ao seguinte URL para formar um link direto:
    https://datastudio.google.com/datasources/create?connectorId=YOUR_DEPLOYMENT_ID
  3. É possível compartilhar o link direto com os usuários. Por exemplo, você pode postá-lo no seu site, blog ou mídias sociais.

Preencher automaticamente a configuração

Se você já sabe com antecedência que valores de configuração seus usuários querem usar, é possível incluir outros parâmetros de consulta para preencher a configuração do conector automaticamente. O preenchimento poderá ser editado, mas não é preciso que o usuário digite manualmente.

Para criar um link direto que é preenchido automaticamente, você pode adicionar os seguintes parâmetros de consulta opcionais:

  • connectorConfig: uma string JSON codificada em URL com os pares de chave-valor para pré-preencher a configuração do conector.

    • Os nomes das chaves precisam coincidir com aqueles dos parâmetros definidos na configuração do conector.
    • Os valores TEXTINPUT, TEXTAREA e SELECT_SINGLE precisam ser strings.
    • Os valores CHECKBOX precisam ser booleanos.
    • Os valores SELECT_MULTIPLE precisam ser um conjunto de strings.
  • reportTemplateId: um identificador para o modelo de relatório padrão a ser usado para o conector. Se um modelo padrão for definido no manifesto do conector, o valor substituirá o manifesto. Consulte Como adicionar o modelo de relatório para ver o valor a ser usado.

Exemplo

O exemplo a seguir mostra como criar um link direto para o conector da comunidade StackOverflow Questions. O link direto preenche a configuração do conector automaticamente para usar a tag google-data-studio no Stack Overflow.

Teste o link direto para o conector StackOverflow.

Etapa 1: criar o JSON de configuração

As chaves para o JSON de configuração são os nomes de cada item de configuração. Para a configuração StackOverflow, eles são tagged, pagesize e sort.

JSON antes da codificação

{
        "tagged": "google-data-studio",
        "pagesize": 25,
        "sort": "activity"
    }
    

Etapa 2: codificar o URL

Depois que a configuração JSON for criada, você precisará codificar o objeto em URL. A maneira mais fácil de fazer isso é com a função JavaScript encodeURIComponent.

Codificação do URL

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

O resultado é a string codificada a seguir:

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

Etapa 3: criar o URL

O código a seguir cria o link direto. É importante ressaltar que você precisará do código de implantação do seu conector para criar o URL.

data-studio/links.gs
Ver no GitHub (em inglês)
// 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;

O seguinte URL codificado será retornado, um link direto preenchido automaticamente para o conector:

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
    

Teste o link para ver como ele preenche a configuração.