本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 從 Google Search Console 實體中讀取
<a name="google-search-console-reading-from-entities"></a>

**必要條件**

您想要從中讀取的 Google Search Console 物件。將需要物件名稱。

**來源的支援實體**：


| 實體 | 可以篩選 | 支援限制 | 支援排序依據 | 支援選取 \* | 支援分區 | 
| --- | --- | --- | --- | --- | --- | 
| 搜尋分析 | 是 | 是 | 否 | 是 | 否 | 
| 網站 | 否 | 否 | 否 | 是 | 否 | 
| 網站地圖 | 否 | 否 | 否 | 是 | 否 | 

**範例**：

```
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 提供端點，可動態擷取支援實體的中繼資料。因此，運算子支援是在資料類型層級擷取的。



- **搜尋分析**
  - **欄位:** keys / **資料類型:** 清單 / **支援的運算子:** N/A / **注意:** 
  - **欄位:** 點按數 / **資料類型:** Double / **支援的運算子:** N/A / **注意:** 
  - **欄位:** impressions / **資料類型:** Double / **支援的運算子:** N/A / **注意:** 
  - **欄位:** ctr / **資料類型:** BigDecimal / **支援的運算子:** N/A / **注意:** 對於 BigDecimal 資料類型，值 '0' 格式為 '0E-18'
  - **欄位:** position / **資料類型:** Double / **支援的運算子:** N/A / **注意:** 
  - **欄位:** start\_end\_date / **資料類型:** Date / **支援的運算子:** BETWEEN / **注意:** start\_end\_date 的預設值介於 <距目前日期 30 天前> 至 <昨天：即距目前日期 1 天前> 之間 注意：預期您會傳遞 UTC 日期值。<br />範例：start\_end\_date 介於 '2022-01-01' 至 '2024-09-09' 之間
  - **欄位:** 國家/地區 / **資料類型:** String / **支援的運算子:** EQUAL\_TO, NOT\_EQUAL\_TO, CONTAINS / **注意:** 有效值為 "IND"、"CAN" 等。
  - **欄位:** type / **資料類型:** String / **支援的運算子:** EQUAL\_TO, NOT\_EQUAL\_TO / **注意:** 有效值為 "discover"、"googleNews"、"news"、"image"、"video"、"web"
  - **欄位:** searchAppearance / **資料類型:** String / **支援的運算子:** EQUAL\_TO, NOT\_EQUAL\_TO, CONTAINS / **注意:** 如需有效值的清單，請參閱[搜尋外觀](https://support.google.com/webmasters/answer/7576553#by_search_appearance)。
  - **欄位:** device / **資料類型:** String / **支援的運算子:** EQUAL\_TO, NOT\_EQUAL\_TO, CONTAINS / **注意:** 有效值為 "DESKTOP"、"MOBILE"、"TABLET"
  - **欄位:** 維度 / **資料類型:** String / **支援的運算子:** EQUAL\_TO / **注意:** 有效值為 "country"、"device"
  - **欄位:** page / **資料類型:** String / **支援的運算子:** EQUAL\_TO, NOT\_EQUAL\_TO, CONTAINS / **注意:** 
  - **欄位:** query / **資料類型:** String / **支援的運算子:** EQUAL\_TO, NOT\_EQUAL\_TO, CONTAINS / **注意:** 
  - **欄位:** dataState / **資料類型:** String / **支援的運算子:** EQUAL\_TO / **注意:** 有效值為 "all" 和 "final"

- **網站**
  - **欄位:** siteUrl / **資料類型:** String / **支援的運算子:** N/A / **注意:** 
  - **欄位:** permissionLevel / **資料類型:** String / **支援的運算子:** N/A / **注意:** 

- **網站地圖**
  - **欄位:** 路徑 / **資料類型:** String / **支援的運算子:** N/A / **注意:** 
  - **欄位:** type / **資料類型:** String / **支援的運算子:** N/A / **注意:** 
  - **欄位:** lastSubmitted / **資料類型:** DateTime / **支援的運算子:** N/A / **注意:** 
  - **欄位:** isPending / **資料類型:** Boolean / **支援的運算子:** N/A / **注意:** 
  - **欄位:** isSitemapsIndex / **資料類型:** Boolean / **支援的運算子:** N/A / **注意:** 
  - **欄位:** lastDownloaded / **資料類型:** DateTime / **支援的運算子:** N/A / **注意:** 
  - **欄位:** warnings / **資料類型:** Long / **支援的運算子:** N/A / **注意:** 
  - **欄位:** 錯誤 / **資料類型:** Long / **支援的運算子:** N/A / **注意:** 
  - **欄位:** 型錄 / **資料類型:** 清單 / **支援的運算子:** N/A / **注意:** 



**注意**  
如需篩選條件有效值的更新清單，請參閱 [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>

不支援篩選條件型分區和記錄型分區。