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