# Leitura de entidades do Google Search Console
<a name="google-search-console-reading-from-entities"></a>

**Pré-requisito**

Um objeto do Google Search Console do qual você deseja ler. Você precisará do nome do objeto.

**Entidades compatíveis quanto à origem**:


| Entidade | Pode ser filtrada | Oferece suporte a limite | Oferece suporte a Ordenar por | Oferece suporte a Selecionar \* | Oferece suporte a particionamento | 
| --- | --- | --- | --- | --- | --- | 
| Análise de pesquisas | Sim | Sim | Não | Sim | Não | 
| Sites | Não | Não | Não | Sim | Não | 
| Mapas de sites | Não | Não | Não | Sim | Não | 

**Exemplo:**

```
googleSearchConsole_read = glueContext.create_dynamic_frame.from_options(
    connection_type="googlesearchconsole",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "entityName",
        "API_VERSION": "v3"
    }
```

**Detalhes de entidade e campo do Google Search Console**:

O Google Search Console fornece endpoints para a busca de metadados de forma dinâmica para entidades com suporte. Portanto, o suporte do operador é capturado no nível do tipo de dados.



- **Análise de pesquisas**
  - **Campo:** keys / **Tipo de dados:** Lista / **Operadores compatíveis:** N/D / **Observação:** 
  - **Campo:** cliques / **Tipo de dados:** Duplo / **Operadores compatíveis:** N/D / **Observação:** 
  - **Campo:** impressões / **Tipo de dados:** Duplo / **Operadores compatíveis:** N/D / **Observação:** 
  - **Campo:** ctr / **Tipo de dados:** BigDecimal / **Operadores compatíveis:** N/D / **Observação:** Para o tipo de dados BigDecimal, o valor '0' é formatado como '0E-18'
  - **Campo:** position / **Tipo de dados:** Duplo / **Operadores compatíveis:** N/D / **Observação:** 
  - **Campo:** start\_end\_date / **Tipo de dados:** Data / **Operadores compatíveis:** BETWEEN / **Observação:** O valor padrão para start\_end\_date está entre <30 dias antes da data atual> AND <ontem: ou seja, 1 dia antes da data atual> Observação: é esperado que você passe um valor de data UTC.<br />Exemplo: start\_end\_date entre '2022-01-01' AND '2024-09-09'
  - **Campo:** country / **Tipo de dados:** String / **Operadores compatíveis:** EQUAL\_TO, NOT\_EQUAL\_TO, CONTAINS / **Observação:** Os valores válidos são "IND", "CAN" etc.
  - **Campo:** type / **Tipo de dados:** String / **Operadores compatíveis:** EQUAL\_TO, NOT\_EQUAL\_TO / **Observação:** Os valores válidos são "discover", "googleNews", "news", "image", "video", "web"
  - **Campo:** searchAppearance / **Tipo de dados:** String / **Operadores compatíveis:** EQUAL\_TO, NOT\_EQUAL\_TO, CONTAINS / **Observação:** Consulte [Aparência da pesquisa](https://support.google.com/webmasters/answer/7576553#by_search_appearance) para obter uma lista de valores válidos.
  - **Campo:** Dispositivo / **Tipo de dados:** String / **Operadores compatíveis:** EQUAL\_TO, NOT\_EQUAL\_TO, CONTAINS / **Observação:** Os valores válidos são "DESKTOP", "MOBILE", "TABLET"
  - **Campo:** dimensões / **Tipo de dados:** String / **Operadores compatíveis:** EQUAL\_TO / **Observação:** Os valores válidos são "country", "device"
  - **Campo:** page / **Tipo de dados:** String / **Operadores compatíveis:** EQUAL\_TO, NOT\_EQUAL\_TO, CONTAINS / **Observação:** 
  - **Campo:** consulta / **Tipo de dados:** String / **Operadores compatíveis:** EQUAL\_TO, NOT\_EQUAL\_TO, CONTAINS / **Observação:** 
  - **Campo:** dataState / **Tipo de dados:** String / **Operadores compatíveis:** EQUAL\_TO / **Observação:** Os valores válidos são "all" e "final"

- **Sites**
  - **Campo:** siteUrl / **Tipo de dados:** String / **Operadores compatíveis:** N/D / **Observação:** 
  - **Campo:** permissionLevel / **Tipo de dados:** String / **Operadores compatíveis:** N/D / **Observação:** 

- **Mapas de sites**
  - **Campo:** caminho / **Tipo de dados:** String / **Operadores compatíveis:** N/D / **Observação:** 
  - **Campo:** type / **Tipo de dados:** String / **Operadores compatíveis:** N/D / **Observação:** 
  - **Campo:** lastSubmitted / **Tipo de dados:** DateTime / **Operadores compatíveis:** N/D / **Observação:** 
  - **Campo:** isPending / **Tipo de dados:** Booleano / **Operadores compatíveis:** N/D / **Observação:** 
  - **Campo:** isSitemapsIndex / **Tipo de dados:** Booleano / **Operadores compatíveis:** N/D / **Observação:** 
  - **Campo:** lastDownloaded / **Tipo de dados:** DateTime / **Operadores compatíveis:** N/D / **Observação:** 
  - **Campo:** avisos / **Tipo de dados:** Longo / **Operadores compatíveis:** N/D / **Observação:** 
  - **Campo:** erros / **Tipo de dados:** Longo / **Operadores compatíveis:** N/D / **Observação:** 
  - **Campo:** tópicos / **Tipo de dados:** Lista / **Operadores compatíveis:** N/D / **Observação:** 



**nota**  
Para ver uma lista atualizada de valores válidos para filtros, consulte os documentos da API do [Google Search Console](https://developers.google.com/webmaster-tools/v1/searchanalytics/query).  
O campo `start_end_date` é uma combinação de `start_date` e `end_date`.

## Particionamento de consultas
<a name="google-search-console-reading-partitioning-queries"></a>

Não há suporte para o particionamento baseado em filtros e o particionamento baseado em registros.