서비스 메서드

Google Ads API의 설계는 기존의 list, get, create, update, delete 메서드 대신 주로 search 및 mutate,와 같은 맞춤 메서드를 사용하기 때문에 기존 REST 아키텍처와 다릅니다. 이러한 작업은 :의 HTTP 매핑 규칙을 사용하여 맞춤 동사를 나머지 URL과 구분하여 REST URL로 표현됩니다.

예를 들어 캠페인 수정 API 호출은 다음 URL을 사용합니다.

https://googleads.googleapis.com/v19/customers/1234567890/campaigns:mutate

API에서 맞춤 메서드를 사용하는 한 가지 이유는 여러 작업을 단일 API 요청으로 일괄 처리할 수 있도록 하기 위해서입니다. 엄격한 REST 시맨틱스는 한 번에 하나의 캠페인만 업데이트할 수 있습니다. 예를 들어 캠페인에 대한 기존 REST update을 사용하려면 캠페인 리소스당 하나의 HTTP PATCH 요청을 전송해야 합니다.

Google Ads API는 여러 작업을 단일 요청 본문 내에 번들로 묶을 수 있도록 대신 대부분의 리소스에 맞춤 mutate 메서드를 정의합니다. 마찬가지로 API에서 일괄 읽기 (한 번에 여러 객체 가져오기)를 사용 설정하기 위해 API는 SQL과 유사한 Google Ads 쿼리 언어를 사용하는 맞춤 search 메서드를 사용합니다.

일반 메서드 페이지에서는 Google Ads API에서 가장 자주 사용되는 메서드에 대해 자세히 설명합니다.