从 SendGrid 实体读取内容
先决条件
要从中读取内容的 SendGrid 对象。需要 lists、singlesends 或 segments 等对象名称。
源支持的实体:
| 实体 | 可以筛选 | 支持限制 | 支持排序依据 | 支持 Select * | 支持分区 |
|---|---|---|---|---|---|
| Lists | 否 | 是 | 否 | 是 | 否 |
| 单次发送 | 支持 | 是 | 否 | 是 | 否 |
| 营销活动统计数据-自动化 | 支持 | 是 | 否 | 是 | 否 |
| 营销活动统计数据-单次发送 | 支持 | 是 | 否 | 是 | 否 |
| Segments | 是 | 否 | 否 | 是 | 否 |
| 联系人 | 是 | 否 | 否 | 是 | 否 |
| 类别 | 否 | 否 | 否 | 是 | 否 |
| 统计信息 | 是 | 否 | 否 | 是 | 否 |
| 取消订阅组 | 是 | 否 | 否 | 是 | 否 |
示例:
sendgrid_read = glueContext.create_dynamic_frame.from_options( connection_type="sendgrid", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "lists", "API_VERSION": "v3", "INSTANCE_URL": "instanceUrl" }
SendGrid 实体和字段详细信息:
具有静态元数据的实体:
| 实体 | 字段 | 数据类型 | 支持的运算符 |
|---|---|---|---|
| Lists | id | 字符串 | 不适用 |
| 名称 | 字符串 | 不适用 | |
| contact_count | 整数 | 不适用 | |
| _metadata | 结构体 | 不适用 | |
| 单次发送 | id | 字符串 | 不适用 |
| 名称 | 字符串 | EQUAL_TO | |
| abtest | 结构体 | 不适用 | |
| 状态 | 字符串 | EQUAL_TO | |
| categories | 列表 | EQUAL_TO | |
| send_at | 字符串 | 不适用 | |
| is_abtest | 布尔值 | 不适用 | |
| updated_at | 字符串 | 不适用 | |
| created_at | 字符串 | 不适用 | |
| 通道 | 列表 | 不适用 | |
| 营销活动统计数据-自动化 | id | 字符串 | 不适用 |
| 聚合 | 字符串 | 不适用 | |
| step_id | 字符串 | 不适用 | |
| stats | 结构体 | 不适用 | |
| automation_ids | 列表 | EQUAL_TO | |
| 营销活动统计数据-单次发送 | id | 字符串 | 不适用 |
| ab_variation | 字符串 | 不适用 | |
| ab_phase | 字符串 | 不适用 | |
| 聚合 | 字符串 | 不适用 | |
| stats | 结构体 | 不适用 | |
| singlesend_ids | 列表 | EQUAL_TO | |
| Segments | id | 字符串 | 不适用 |
| 名称 | 字符串 | 不适用 | |
| query_version | 字符串 | 不适用 | |
| contacts_count | 整数 | 不适用 | |
| sample_updated_at | 字符串 | 不适用 | |
| next_sample_update | 字符串 | 不适用 | |
| created_at | 字符串 | 不适用 | |
| updated_at | 字符串 | 不适用 | |
| parent_list_id | 字符串 | 不适用 | |
| 状态 | 结构体 | 不适用 | |
| parent_list_ids | 字符串 | EQUAL_TO | |
| no_parent_list_id | 布尔值 | EQUAL_TO | |
| 联系人 | id | 字符串 | 不适用 |
| first_name | 字符串 | 不适用 | |
| last_name | 字符串 | 不适用 | |
| unique_name | 字符串 | 不适用 | |
| 电子邮件 | 字符串 | 不适用 | |
| alternate_emails | 列表 | 不适用 | |
| address_line_1 | 字符串 | 不适用 | |
| address_line_2 | 字符串 | 不适用 | |
| city | 字符串 | 不适用 | |
| state_province_region | 字符串 | 不适用 | |
| country | 字符串 | 不适用 | |
| postal_code | 字符串 | 不适用 | |
| phone_number | 字符串 | 不适用 | |
| 字符串 | 不适用 | ||
| 折线图 | 字符串 | 不适用 | |
| 字符串 | 不适用 | ||
| list_ids | 列表 | 不适用 | |
| custom_fields | 结构体 | 不适用 | |
| created_at | 字符串 | 不适用 | |
| updated_at | 字符串 | 不适用 | |
| _metadata | 结构体 | 不适用 | |
| event_timestamp | 日期时间 | BETWEEN | |
| 类别 | categories | 列表 | 不适用 |
| 统计信息 | date | 字符串 | 不适用 |
| stats | 列表 | 不适用 | |
| start_date | 日期时间 | EQUAL_TO、BETWEEN | |
| aggregated_by | 字符串 | EQUAL_TO | |
| 取消订阅组 | id | 整数 | EQUAL_TO |
| 名称 | 字符串 | 不适用 | |
| description | 字符串 | 不适用 | |
| last_email_sent_at | 整数 | 不适用 | |
| is_default | 布尔值 | 不适用 | |
| 取消订阅 | 整数 | 不适用 |
注意
在连接器的响应中,“结构体”和“列表”数据类型将转换为“字符串”数据类型,“日期时间”数据类型将转换为“时间戳”数据类型。
对查询进行分区
SendGrid 不支持基于筛选条件的分区或基于记录的分区。