# Google 検索コンソールエンティティからの読み取り
<a name="google-search-console-reading-from-entities"></a>

**前提条件**

読み取り元の Google 検索コンソールオブジェクト。オブジェクト名が必要になります。

**ソースに対応するエンティティ**:


| エンティティ | フィルタリング可能 | 制限をサポートする | Order By をサポートする | Select \* をサポートする | パーティション分割をサポートする | 
| --- | --- | --- | --- | --- | --- | 
| [分析] を選択する | はい | あり | なし | あり | なし | 
| サイト | なし | なし | なし | あり | なし | 
| サイトマップ | なし | なし | なし | あり | なし | 

**例**:

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

**Google 検索コンソールのエンティティとフィールドの詳細**:

Google 検索コンソールでは、サポートされているエンティティのメタデータを動的に取得するためのエンドポイントが提供されます。したがって、オペレータのサポートはデータ型レベルでキャプチャされます。



- **[分析] を選択する**
  - **フィールド:** キー / **データ型:** リスト / **サポートされている演算子:** 該当なし / **メモ:** 
  - **フィールド:** clicks / **データ型:** 倍精度 / **サポートされている演算子:** 該当なし / **メモ:** 
  - **フィールド:** IMPRESSION / **データ型:** 倍精度 / **サポートされている演算子:** 該当なし / **メモ:** 
  - **フィールド:** 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 / **メモ:** 有効な値は「IND」、「CAN」などです。
  - **フィールド:** type / **データ型:** 文字列 / **サポートされている演算子:** EQUAL\_TO、NOT\_EQUAL\_TO / **メモ:** 有効な値は、「discover」、「googleNews」、「news」、「image」、「video」、「web」です。
  - **フィールド:** searchAppearance / **データ型:** 文字列 / **サポートされている演算子:** EQUAL\_TO、NOT\_EQUAL\_TO、CONTAINS / **メモ:** 有効な値のリストについては、「[検索表示](https://support.google.com/webmasters/answer/7576553#by_search_appearance)」を参照してください。
  - **フィールド:** デバイス / **データ型:** 文字列 / **サポートされている演算子:** EQUAL\_TO、NOT\_EQUAL\_TO、CONTAINS / **メモ:** 有効な値は「DESKTOP」、「MOBILE」、「TABLET」です
  - **フィールド:** ディメンション / **データ型:** String / **サポートされている演算子:** EQUAL\_TO / **メモ:** 有効な値は「国」、「デバイス」です
  - **フィールド:** page / **データ型:** 文字列 / **サポートされている演算子:** EQUAL\_TO、NOT\_EQUAL\_TO、CONTAINS / **メモ:** 
  - **フィールド:** query / **データ型:** 文字列 / **サポートされている演算子:** EQUAL\_TO、NOT\_EQUAL\_TO、CONTAINS / **メモ:** 
  - **フィールド:** dataState / **データ型:** String / **サポートされている演算子:** EQUAL\_TO / **メモ:** 有効な値は「all」と「final」です

- **サイト**
  - **フィールド:** siteUrl / **データ型:** 文字列 / **サポートされている演算子:** 該当なし / **メモ:** 
  - **フィールド:** permissionLevel / **データ型:** 文字列 / **サポートされている演算子:** 該当なし / **メモ:** 

- **サイトマップ**
  - **フィールド:** パス / **データ型:** 文字列 / **サポートされている演算子:** 該当なし / **メモ:** 
  - **フィールド:** type / **データ型:** 文字列 / **サポートされている演算子:** 該当なし / **メモ:** 
  - **フィールド:** lastSubmitted / **データ型:** DateTime / **サポートされている演算子:** 該当なし / **メモ:** 
  - **フィールド:** isPending / **データ型:** ブール値 / **サポートされている演算子:** 該当なし / **メモ:** 
  - **フィールド:** isSitemapsIndex / **データ型:** ブール値 / **サポートされている演算子:** 該当なし / **メモ:** 
  - **フィールド:** lastDownloaded / **データ型:** DateTime / **サポートされている演算子:** 該当なし / **メモ:** 
  - **フィールド:** warnings / **データ型:** Long / **サポートされている演算子:** 該当なし / **メモ:** 
  - **フィールド:** エラー / **データ型:** Long / **サポートされている演算子:** 該当なし / **メモ:** 
  - **フィールド:** コンテンツ / **データ型:** リスト / **サポートされている演算子:** 該当なし / **メモ:** 



**注記**  
フィルターの有効な値の更新リストについては、「[Google 検索コンソール](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>

フィルターベースのパーティショニングとレコードベースのパーティション分割はサポートされていません。