Cómo leer de entidades de SendGrid
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:
| Entidad | Campo | Tipo de datos: | Operadores admitidos |
|---|---|---|---|
| Listas | id | Cadena | N/A |
| nombre | Cadena | N/A | |
| contact_count | Entero | N/A | |
| _metadata | Struct | N/A | |
| Envíos únicos | id | Cadena | N/A |
| nombre | Cadena | EQUAL_TO | |
| abtest | Struct | N/A | |
| status | Cadena | EQUAL_TO | |
| categories | Enumeración | EQUAL_TO | |
| send_at | Cadena | N/A | |
| is_abtest | Booleano | N/A | |
| updated_at | Cadena | N/A | |
| created_at | Cadena | N/A | |
| canales | Enumeración | N/A | |
| Estadísticas y automatizaciones de campañas de marketing | id | Cadena | N/A |
| agregación | Cadena | N/A | |
| step_id | Cadena | N/A | |
| stats | Struct | N/A | |
| automation_ids | Enumeración | EQUAL_TO | |
| Estadísticas de la campaña de marketing: envíos únicos | id | Cadena | N/A |
| ab_variation | Cadena | N/A | |
| ab_phase | Cadena | N/A | |
| agregación | Cadena | N/A | |
| stats | Struct | N/A | |
| singlesend_ids | Enumeración | EQUAL_TO | |
| Segmentos | id | Cadena | N/A |
| nombre | Cadena | N/A | |
| query_version | Cadena | N/A | |
| contacts_count | Entero | N/A | |
| sample_updated_at | Cadena | N/A | |
| next_sample_update | Cadena | N/A | |
| created_at | Cadena | N/A | |
| updated_at | Cadena | N/A | |
| parent_list_id | Cadena | N/A | |
| status | Struct | N/A | |
| parent_list_ids | Cadena | EQUAL_TO | |
| no_parent_list_id | Booleano | EQUAL_TO | |
| Contactos | id | Cadena | N/A |
| first_name | Cadena | N/A | |
| last_name | Cadena | N/A | |
| unique_name | Cadena | N/A | |
| correo electrónico | Cadena | N/A | |
| alternate_emails | Enumeración | N/A | |
| address_line_1 | Cadena | N/A | |
| address_line_2 | Cadena | N/A | |
| ciudad | Cadena | N/A | |
| state_province_region | Cadena | N/A | |
| país | Cadena | N/A | |
| postal_code | Cadena | N/A | |
| phone_number | Cadena | N/A | |
| Cadena | N/A | ||
| línea | Cadena | N/A | |
| Cadena | N/A | ||
| list_ids | Enumeración | N/A | |
| custom_fields | Struct | N/A | |
| created_at | Cadena | N/A | |
| updated_at | Cadena | N/A | |
| _metadata | Struct | N/A | |
| event_timestamp | DateTime | BETWEEN | |
| Categoría | categories | Enumeración | N/A |
| Estadísticas | date | Cadena | N/A |
| stats | Enumeración | N/A | |
| start_date | DateTime | EQUAL_TO, BETWEEN | |
| aggregated_by | Cadena | EQUAL_TO | |
| Anular la suscripción de grupos | id | Entero | EQUAL_TO |
| nombre | Cadena | N/A | |
| Descripción | Cadena | N/A | |
| last_email_sent_at | Entero | N/A | |
| is_default | Booleano | N/A | |
| anulaciones de suscripciones | Entero | 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
SendGrid no admite la partición basada en filtros ni la partición basada en registros.