# Google Search Console 엔터티에서 읽기
<a name="google-search-console-reading-from-entities"></a>

**사전 조건**

읽으려는 Google Ads 객체입니다. 객체 이름이 필요합니다.

**소스에 대해 지원되는 엔터티**:


| 개체 | 필터링 가능 | 제한 지원 | 정렬 기준 지원 | Select \* 지원 | 분할 지원 | 
| --- | --- | --- | --- | --- | --- | 
| Search Analytics | 예 | 예 | 아니요 | 예 | 아니요 | 
| Sites | 아니요 | 아니요 | 아니요 | 예 | 아니요 | 
| Sitemaps | 아니요 | 아니요 | 아니요 | 예 | 아니요 | 

**예시:**

```
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에서는 지원되는 엔터티에 대해 메타데이터를 동적으로 가져오도록 엔드포인트를 제공합니다. 따라서 운영자 지원은 데이터 유형 수준에서 캡처됩니다.



- **Search Analytics**
  - **필드:** keys / **데이터 유형:** 나열 / **지원되는 연산자:** N/A / **Note:** 
  - **필드:** clicks / **데이터 유형:** 배정밀도 실수 / **지원되는 연산자:** N/A / **Note:** 
  - **필드:** impressions / **데이터 유형:** 배정밀도 실수 / **지원되는 연산자:** N/A / **Note:** 
  - **필드:** ctr / **데이터 유형:** BigDecimal / **지원되는 연산자:** N/A / **Note:** BigDecimal 데이터 형식의 경우 '0' 값은 '0E-18' 형식입니다.
  - **필드:** position / **데이터 유형:** 배정밀도 실수 / **지원되는 연산자:** N/A / **Note:** 
  - **필드:** start\_end\_date / **데이터 유형:** 날짜 / **지원되는 연산자:** BETWEEN / **Note:** start\_end\_date의 기본값은 <현재 날짜로부터 30일 전>과 <어제: 즉, 현재 날짜로부터 1일 전> 사이입니다.참고: UTC 날짜 값을 전달할 것으로 예상합니다.<br />예: start\_end\_date가 '2022-01-01'와 '2024-09-09' 사이
  - **필드:** country / **데이터 유형:** String / **지원되는 연산자:** EQUAL\_TO, NOT\_EQUAL\_TO, CONTAINS / **Note:** 유효한 값은 'IND', 'CAN' 등입니다.
  - **필드:** type / **데이터 유형:** String / **지원되는 연산자:** EQUAL\_TO, NOT\_EQUAL\_TO / **Note:** 유효한 값은 'discover', 'googleNews', 'news', 'image', 'video', 'web'입니다.
  - **필드:** searchAppearance / **데이터 유형:** String / **지원되는 연산자:** EQUAL\_TO, NOT\_EQUAL\_TO, CONTAINS / **Note:** 유효한 값 목록은 [검색 표시](https://support.google.com/webmasters/answer/7576553#by_search_appearance)를 참조하세요.
  - **필드:** device / **데이터 유형:** String / **지원되는 연산자:** EQUAL\_TO, NOT\_EQUAL\_TO, CONTAINS / **Note:** 유효한 값은 'DESKTOP', 'MOBILE', 'TABLET'입니다.
  - **필드:** dimensions / **데이터 유형:** String / **지원되는 연산자:** EQUAL\_TO / **Note:** 유효한 값은 'country', 'device'입니다.
  - **필드:** page / **데이터 유형:** String / **지원되는 연산자:** EQUAL\_TO, NOT\_EQUAL\_TO, CONTAINS / **Note:** 
  - **필드:** 쿼리 / **데이터 유형:** String / **지원되는 연산자:** EQUAL\_TO, NOT\_EQUAL\_TO, CONTAINS / **Note:** 
  - **필드:** dataState / **데이터 유형:** String / **지원되는 연산자:** EQUAL\_TO / **Note:** 유효한 값은 'all' 및 'final'입니다.

- **Sites**
  - **필드:** siteUrl / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음 / **Note:** 
  - **필드:** permissionLevel / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음 / **Note:** 

- **Sitemaps**
  - **필드:** 경로 / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음 / **Note:** 
  - **필드:** type / **데이터 유형:** String / **지원되는 연산자:** 해당 사항 없음 / **Note:** 
  - **필드:** lastSubmitted / **데이터 유형:** DateTime / **지원되는 연산자:** N/A / **Note:** 
  - **필드:** isPending / **데이터 유형:** 불 / **지원되는 연산자:** N/A / **Note:** 
  - **필드:** isSitemapsIndex / **데이터 유형:** 불 / **지원되는 연산자:** N/A / **Note:** 
  - **필드:** lastDownloaded / **데이터 유형:** DateTime / **지원되는 연산자:** N/A / **Note:** 
  - **필드:** warnings / **데이터 유형:** Long / **지원되는 연산자:** N/A / **Note:** 
  - **필드:** errors / **데이터 유형:** Long / **지원되는 연산자:** N/A / **Note:** 
  - **필드:** contents / **데이터 유형:** 나열 / **지원되는 연산자:** N/A / **Note:** 



**참고**  
필터에 대한 유효한 값의 업데이트된 목록은 [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>

필터 기반 분할 및 레코드 기반 분할은 지원되지 않습니다.