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:
- Acesse o Apps Script e abra o projeto do conector da comunidade que você quer compartilhar. Clique em Publicar > Implantar pelo manifesto...
- 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
- É 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.
Criação de um link preenchido automaticamente
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
eSELECT_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.
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.