Link direto

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

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.