# Cómo leer de entidades de SendGrid
<a name="sendgrid-reading-from-entities"></a>

**Requisito previo**

Un objeto de SendGrid desde el que desea leer. Necesitará el nombre del objeto, como `lists`, `singlesends` o `segments`.

**Entidades compatibles como origen:**


| Entidad | Se puede filtrar | Admite límite | Admite Ordenar por | Admite Seleccionar \* | Admite partición | 
| --- | --- | --- | --- | --- | --- | 
| Listas | No | Sí | No | Sí | No | 
| Envíos únicos | Sí | Sí | No | Sí | No | 
| Estadísticas y automatizaciones de campañas de marketing | Sí | Sí | No | Sí | No | 
| Estadísticas de la campaña de marketing: envíos únicos | Sí | Sí | No | Sí | No | 
| Segmentos | Sí | No | No | Sí | No | 
| Contactos | Sí | No | No | Sí | No | 
| Categoría | No | No | No | Sí | No | 
| Estadísticas | Sí | No | No | Sí | No | 
| Anular la suscripción de grupos | Sí | No | No | Sí | No | 

**Ejemplo:**

```
sendgrid_read = glueContext.create_dynamic_frame.from_options(
    connection_type="sendgrid",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "lists",
        "API_VERSION": "v3",
        "INSTANCE_URL": "instanceUrl"
    }
```

**Detalles de la entidad y el campo de SendGrid**:

Entidades con metadatos estáticos:



- **Listas**
  - **Campo:** id / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** nombre / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** contact\_count / **Tipo de datos::** Entero / **Operadores admitidos:** N/A
  - **Campo:** \_metadata / **Tipo de datos::** Struct / **Operadores admitidos:** N/A

- **Envíos únicos**
  - **Campo:** id / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** nombre / **Tipo de datos::** Cadena / **Operadores admitidos:** EQUAL\_TO
  - **Campo:** abtest / **Tipo de datos::** Struct / **Operadores admitidos:** N/A
  - **Campo:** status / **Tipo de datos::** Cadena / **Operadores admitidos:** EQUAL\_TO
  - **Campo:** categories / **Tipo de datos::** Enumeración / **Operadores admitidos:** EQUAL\_TO
  - **Campo:** send\_at / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** is\_abtest / **Tipo de datos::** Booleano / **Operadores admitidos:** N/A
  - **Campo:** updated\_at / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** created\_at / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** canales / **Tipo de datos::** Enumeración / **Operadores admitidos:** N/A

- **Estadísticas y automatizaciones de campañas de marketing**
  - **Campo:** id / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** agregación / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** step\_id / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** stats / **Tipo de datos::** Struct / **Operadores admitidos:** N/A
  - **Campo:** automation\_ids / **Tipo de datos::** Enumeración / **Operadores admitidos:** EQUAL\_TO

- **Estadísticas de la campaña de marketing: envíos únicos**
  - **Campo:** id / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** ab\_variation / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** ab\_phase / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** agregación / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** stats / **Tipo de datos::** Struct / **Operadores admitidos:** N/A
  - **Campo:** singlesend\_ids / **Tipo de datos::** Enumeración / **Operadores admitidos:** EQUAL\_TO

- **Segmentos**
  - **Campo:** id / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** nombre / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** query\_version / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** contacts\_count / **Tipo de datos::** Entero / **Operadores admitidos:** N/A
  - **Campo:** sample\_updated\_at / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** next\_sample\_update / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** created\_at / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** updated\_at / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** parent\_list\_id / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** status / **Tipo de datos::** Struct / **Operadores admitidos:** N/A
  - **Campo:** parent\_list\_ids / **Tipo de datos::** Cadena / **Operadores admitidos:** EQUAL\_TO
  - **Campo:** no\_parent\_list\_id / **Tipo de datos::** Booleano / **Operadores admitidos:** EQUAL\_TO

- **Contactos**
  - **Campo:** id / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** first\_name / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** last\_name / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** unique\_name / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** correo electrónico / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** alternate\_emails / **Tipo de datos::** Enumeración / **Operadores admitidos:** N/A
  - **Campo:** address\_line\_1 / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** address\_line\_2 / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** ciudad / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** state\_province\_region / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** país / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** postal\_code / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** phone\_number / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** whatsapp / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** línea / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** facebook / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** list\_ids / **Tipo de datos::** Enumeración / **Operadores admitidos:** N/A
  - **Campo:** custom\_fields / **Tipo de datos::** Struct / **Operadores admitidos:** N/A
  - **Campo:** created\_at / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** updated\_at / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** \_metadata / **Tipo de datos::** Struct / **Operadores admitidos:** N/A
  - **Campo:** event\_timestamp / **Tipo de datos::** DateTime / **Operadores admitidos:** BETWEEN

- **Categoría**
  - **Campo:** categories
  - **Tipo de datos::** Enumeración
  - **Operadores admitidos:** N/A

- **Estadísticas**
  - **Campo:** date / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** stats / **Tipo de datos::** Enumeración / **Operadores admitidos:** N/A
  - **Campo:** start\_date / **Tipo de datos::** DateTime / **Operadores admitidos:** EQUAL\_TO, BETWEEN
  - **Campo:** aggregated\_by / **Tipo de datos::** Cadena / **Operadores admitidos:** EQUAL\_TO

- **Anular la suscripción de grupos**
  - **Campo:** id / **Tipo de datos::** Entero / **Operadores admitidos:** EQUAL\_TO
  - **Campo:** nombre / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** Descripción / **Tipo de datos::** Cadena / **Operadores admitidos:** N/A
  - **Campo:** last\_email\_sent\_at / **Tipo de datos::** Entero / **Operadores admitidos:** N/A
  - **Campo:** is\_default / **Tipo de datos::** Booleano / **Operadores admitidos:** N/A
  - **Campo:** anulaciones de suscripciones / **Tipo de datos::** Entero / **Operadores admitidos:** N/A



**nota**  
Los tipos de datos de estructura y enumeración se convierten en cadenas, y los de fecha y hora se convierten en marcas de tiempo en la respuesta de los conectores.

## Consultas de partición
<a name="sendgrid-reading-partitioning-queries"></a>

SendGrid no admite la partición basada en filtros ni la partición basada en registros.