# Gerar relatório

{% tabs %}
{% tab title="Parâmetros" %}

<figure><img src="/files/aNkHpJcgIKouFlQCkioN" alt=""><figcaption><p>Parâmetros de configuração</p></figcaption></figure>

<table><thead><tr><th width="185">Campo</th><th width="207">Tipo</th><th>Descrição</th></tr></thead><tbody><tr><td>Descrição</td><td>Campo de texto</td><td>Descrição visual do conector no editor de fluxo.</td></tr><tr><td>Conta de serviço</td><td>Seletor</td><td>Permite selecionar a conta Google Analytics em que os dados serão recuperados. A conta de serviço deverá ser do tipo de <strong>Conta de Serviço Google (arquivo JSON)</strong>. <a href="/pages/KDMLQaSZwzIHsu9iJhFK#criacao-de-contas-de-servico">Saiba mais</a> sobre este tipo de conta de serviço.</td></tr><tr><td>ID da conta de serviço</td><td>Campo de texto</td><td><p>Configuração disponível quando selecionada a opção de conta de serviço personalizada. </p><p></p><p>Permite inserir o identificador da conta de serviço Google Analytics. Pode ser usado para aplicar valores dinâmicos utilizando a notação Mustache {{msg}}.</p></td></tr><tr><td>ID da propriedade</td><td>Campo de texto</td><td><p>Define o identificador da propriedade em que os dados serão coletados.  </p><p></p><p>A propriedade pode ser um app e/ou um agrupamento de dados de um site. <a href="https://developers.google.com/analytics/devguides/reporting/data/v1/property-id#google_analytics">Saiba como</a> obter o ID da propriedade no painel Analytics.</p></td></tr><tr><td>Data início</td><td>Campo de texto</td><td>Data de início da coleta de dados para geração do relatório. Utilize o formato YYYY-MM-DD.</td></tr><tr><td>Data até</td><td>Campo de texto</td><td>Data de fim da coleta de dados para geração do relatório. Utilize o formato YYYY-MM-DD.</td></tr><tr><td>Dimensões</td><td>Tabela de parâmetros</td><td>Permite definir os atributos do tipo Dimensão que serão coletadas para montagem do relatório. As dimensões disponíveis para uso podem ser consultadas em <a href="https://developers.google.com/analytics/devguides/reporting/data/v1/api-schema?hl=pt-br">Dimensões e métricas da API</a></td></tr><tr><td>Métricas</td><td>Tabela de parâmetros</td><td>Permite definir os atributos do tipo Métrica que serão coletadas para montagem do relatório. As métricas disponíveis para uso podem ser consultadas em <a href="https://developers.google.com/analytics/devguides/reporting/data/v1/api-schema?hl=pt-br">Dimensões e métricas da API</a></td></tr><tr><td>Output Path</td><td>Campo de texto</td><td>Refere-se a localização do relatório gerado na saída do conector no contexto de execução do fluxo.</td></tr></tbody></table>
{% endtab %}

{% tab title="Payload" %}

## Sucesso

Em casos de sucesso na geração do relatório, os dados serão retornados em formato de **lista**, posicionados no caminho de saída configurado no conector. Junto aos dados do relatório, também serão disponibilizadas informações adicionais da requisição executada, como os **headers**, o conteúdo da **request** enviada e o conteúdo da **response** recebida.&#x20;

<figure><img src="/files/E5F7Aqng1wiDbAftTByD" alt=""><figcaption><p>Sucesso na recuperação de dados de relatório</p></figcaption></figure>

## Erros

Em casos de erro na parametrização do conector — como o uso de **Métricas** ou **Dimensões** inválidas, ou ainda um **ID de propriedade** incorreto — a API do Google retornará um payload contendo os detalhes do erro na requisição.&#x20;

<figure><img src="/files/xjFZKtJ55hsf7BqArdcY" alt=""><figcaption><p>Erro na recuperação de dados de relatório.</p></figcaption></figure>

Caso seja utilizado uma conta de serviço com um arquivo de JSON inválido para autenticação, o conector irá ter um erro durante sua execução e retornará a seguinte mensagem:

<figure><img src="/files/qqvLIdEZMFsYtSw34s4e" alt=""><figcaption><p>Erro de autenticação por arquivo inválido.</p></figcaption></figure>
{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.floui.io/guia/conectores/categorias/servicos-externos/google/google-analytics-ga4/gerar-relatorio.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
