GoogleAdsService를 사용하여 스트리밍 보고

Google Ads API 항목 및 보고 데이터를 가져오려면 다음 방법 중 하나를 사용하세요.

두 메서드의 대략적인 구분은 다음과 같습니다.

GoogleAdsService.SearchStream GoogleAdsService.Search
프로덕션 코드에 적합 예 예
서비스 GoogleAdsService GoogleAdsService
시나리오 객체 및 보고서 가져오기 객체 및 보고서 가져오기
응답 스트림 of GoogleAdsRow 객체 GoogleAdsRow 객체의 페이지
응답의 필드 쿼리에 지정된 필드만 쿼리에 지정된 필드만
일일 한도 액세스 수준에 따른 일일 한도 액세스 수준에 따른 일일 한도

Search는 전체 보고서를 다운로드하기 위해 여러 페이지로 나뉜 요청을 전송할 수 있지만 SearchStream은 보고서 크기와 관계없이 단일 요청을 전송하고 Google Ads API와의 지속적인 연결을 시작합니다.

SearchStream의 경우 데이터 패킷이 데이터 버퍼에 전체 결과가 캐시된 상태로 즉시 다운로드되기 시작합니다. 전체 스트림이 완료될 때까지 기다리지 않고도 코드가 버퍼링된 데이터를 읽기 시작할 수 있습니다.

앱에 따라 SearchStream은 Search 응답의 각 개별 페이지를 요청하는 데 필요한 왕복 네트워크 시간을 없애므로 특히 더 큰 보고서의 경우 페이징보다 성능이 향상될 수 있습니다.

예

이 예에서는 100,000개의 행으로 구성된 보고서를 살펴봅니다. 다음 표는 두 메서드 간의 회계 차이를 보여줍니다.

SearchStream Search
페이지 크기 해당 없음 페이지당 10,000개의 행
API 요청 수 요청 1개 요청 10개
API 응답 수 연속 스트림 1개 응답 10개

성능 요인

대부분의 사용 사례에서는 다음과 같은 이유로 Search보다 SearchStream을 사용하는 것이 좋습니다.

  • 단일 페이지 보고서 (10,000개 미만의 행): 두 메서드 간에 성능 차이가 크지 않습니다.

  • 여러 페이지 보고서: SearchStream은 일반적으로 여러 왕복을 피하고 디스크 캐시에서 읽거나 쓰는 것이 덜 중요하므로 더 빠릅니다.

비율 제한

두 메서드의 일일 한도는 개발자 토큰의 표준 한도 및 액세스 수준을 준수합니다. 단일 쿼리 또는 보고서는 결과가 페이징되거나 스트리밍되는지와 관계없이 하나의 작업으로 계산됩니다.

이전
라벨
다음
Paging