# 从 Google Search Console 实体读取内容
<a name="google-search-console-reading-from-entities"></a>

**先决条件**

要从中读取内容的 Google Search Console 对象。您将需要对象名称。

**源支持的实体**：


| 实体 | 可以筛选 | 支持限制 | 支持排序依据 | 支持 Select \* | 支持分区 | 
| --- | --- | --- | --- | --- | --- | 
| 搜索分析 | 支持 | 是 | 否 | 是 | 否 | 
| 站点 | 否 | 否 | 否 | 是 | 否 | 
| 站点地图 | 否 | 否 | 否 | 是 | 否 | 

**示例：**

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

**Google Search Console 实体和字段详细信息**：

Google Search Console 提供了端点，用于为所支持实体动态获取元数据。因此，可在数据类型级别捕获运算符支持。



- **搜索分析**
  - **字段:** 键 / **数据类型:** 列表 / **支持的运算符:** 不适用 / **注意:** 
  - **字段:** clicks / **数据类型:** 双精度 / **支持的运算符:** 不适用 / **注意:** 
  - **字段:** 展示 / **数据类型:** 双精度 / **支持的运算符:** 不适用 / **注意:** 
  - **字段:** ctr / **数据类型:** BigDecimal / **支持的运算符:** 不适用 / **注意:** 对于 BigDecimal 数据类型，值“0”的格式设置为“0E-18”
  - **字段:** position / **数据类型:** 双精度 / **支持的运算符:** 不适用 / **注意:** 
  - **字段:** start\_end\_date / **数据类型:** 日期 / **支持的运算符:** BETWEEN / **注意:** start\_end\_date 的默认值介于 <当前日期前 30 天> 和 <昨天：即当前日期前 1 天> 之间 注意：需要传递 UTC 日期值。<br />示例：start\_end\_date 介于“2022-01-01”和“2024-09-09”之间
  - **字段:** country / **数据类型:** 字符串 / **支持的运算符:** EQUAL\_TO、NOT\_EQUAL\_TO、CONTAINS / **注意:** 有效值为“印度”、“加拿大”等。
  - **字段:** type / **数据类型:** 字符串 / **支持的运算符:** EQUAL\_TO、NOT\_EQUAL\_TO / **注意:** 有效值为“发现”、“googleNews”、“新闻”、“图片”、“视频”、“Web”
  - **字段:** searchAppearance / **数据类型:** 字符串 / **支持的运算符:** EQUAL\_TO、NOT\_EQUAL\_TO、CONTAINS / **注意:** 有关有效值的列表，请参阅[搜索结果呈现](https://support.google.com/webmasters/answer/7576553#by_search_appearance)。
  - **字段:** 设备 / **数据类型:** 字符串 / **支持的运算符:** EQUAL\_TO、NOT\_EQUAL\_TO、CONTAINS / **注意:** 有效值为“桌面”、“移动”、“平板电脑”
  - **字段:** 维度 / **数据类型:** 字符串 / **支持的运算符:** EQUAL\_TO / **注意:** 有效值为“国家”、“设备”
  - **字段:** page / **数据类型:** 字符串 / **支持的运算符:** EQUAL\_TO、NOT\_EQUAL\_TO、CONTAINS / **注意:** 
  - **字段:** 查询 / **数据类型:** 字符串 / **支持的运算符:** EQUAL\_TO、NOT\_EQUAL\_TO、CONTAINS / **注意:** 
  - **字段:** dataState / **数据类型:** 字符串 / **支持的运算符:** EQUAL\_TO / **注意:** 有效值为“全部”和“最终”

- **站点**
  - **字段:** siteUrl / **数据类型:** 字符串 / **支持的运算符:** 不适用 / **注意:** 
  - **字段:** permissionLevel / **数据类型:** 字符串 / **支持的运算符:** 不适用 / **注意:** 

- **站点地图**
  - **字段:** path / **数据类型:** 字符串 / **支持的运算符:** 不适用 / **注意:** 
  - **字段:** type / **数据类型:** 字符串 / **支持的运算符:** 不适用 / **注意:** 
  - **字段:** lastSubmitted / **数据类型:** 日期时间 / **支持的运算符:** 不适用 / **注意:** 
  - **字段:** isPending / **数据类型:** 布尔值 / **支持的运算符:** 不适用 / **注意:** 
  - **字段:** isSitemapsIndex / **数据类型:** 布尔值 / **支持的运算符:** 不适用 / **注意:** 
  - **字段:** lastDownloaded / **数据类型:** 日期时间 / **支持的运算符:** 不适用 / **注意:** 
  - **字段:** warnings / **数据类型:** 长整型 / **支持的运算符:** 不适用 / **注意:** 
  - **字段:** 错误 / **数据类型:** 长整型 / **支持的运算符:** 不适用 / **注意:** 
  - **字段:** 内容 / **数据类型:** 列表 / **支持的运算符:** 不适用 / **注意:** 



**注意**  
如需更新后的筛选条件有效值列表，请参阅 [Google Search Console](https://developers.google.com/webmaster-tools/v1/searchanalytics/query) API 文档。  
字段 `start_end_date` 是 `start_date` 和 `end_date` 的组合。

## 对查询进行分区
<a name="google-search-console-reading-partitioning-queries"></a>

不支持基于筛选条件的分区和基于记录的分区。