Google Ads API의 디자인은 기존의 list, get, create, update, delete 메서드 대신 search 및 mutate, 같은 커스텀 메서드를 주로 사용하기 때문에 기존 REST 아키텍처와 다릅니다.
이러한 작업은 커스텀 동사를 URL의 나머지 부분과 분리하기 위해 :의 HTTP 매핑 규칙을 사용하여 REST URL로 표현됩니다.
예를 들어 캠페인 mut API 호출은 다음 URL을 사용합니다.
https://googleads.googleapis.com/v16/customers/1234567890/campaigns:mutate
API가 커스텀 메서드를 사용하는 한 가지 이유는 여러 작업을 단일 API 요청으로 일괄 처리하기 위해서입니다. 엄격한 REST 시맨틱스는 한 번에 하나의 캠페인만 업데이트할 수 있습니다. 예를 들어 기존 REST update는 캠페인에 리소스 리소스당 하나의 HTTP PATCH 요청을 전송해야 합니다.
Google Ads API는 여러 작업을 단일 요청 본문에 번들로 묶을 수 있도록
대부분 대부분의 리소스에 맞춤 mutate 메서드를 정의합니다.
마찬가지로 API는 일괄 읽기 (한 번에 여러 객체 가져오기)를 사용 설정하기 위해 SQL과 유사한 Google Ads 쿼리 언어가 있는 맞춤 search 메서드를 사용합니다.
일반적인 방법 페이지에서는 Google Ads API에서 가장 자주 사용하는 방법을 자세히 설명합니다.