이 페이지에서는 리소스 중심 디자인 및 리소스 이름 개발자 가이드에 대한 숙련도를 전제로 하며 Google Ads API의 구체적인 구현 세부정보로 이를 보완합니다.
리소스 중심 디자인
일반적으로 Google Ads API는 개별적으로 주소 지정이 가능한 리소스 (API의 명사)의 컬렉션 으로 모델링되는 리소스 중심 디자인을 따릅니다. 리소스는 리소스 이름으로 참조되며 적은 수의 메서드 (동사 또는 작업 으로도 알려짐)를 사용하여 조작됩니다. 이러한 리소스 이름과 메서드는 특정 API 버전 프리픽스와 결합되어 REST 인터페이스의 URL을 구성합니다. 예를 들어 이 예시 URL은 다음 표에 따라 이러한 개별 구성요소로 분류할 수 있습니다.
https://googleads.googleapis.com/v25/customers/1234567890:mutate
| API 버전 프리픽스 | 리소스 이름 (상대적) | 메서드 |
|---|---|---|
https://googleads.googleapis.com/v25
|
customers/1234567890
|
mutate
|
특정 API 버전 (예: v25)의 모든 REST URL은 공통 API 버전 프리픽스를 공유합니다. 리소스 이름과 메서드는 함께 호출되는 API 서비스를 식별합니다.
Google Ads API는 list, get,
create, update, delete와 같은 표준 REST 메서드를 사용하는 대부분의
REST API와 달리 커스텀 메서드를 많이 사용합니다. Google Ads API의 커스텀 메서드로는
search, searchStream, mutate 등이 있습니다.
다음 페이지에서는 Google Ads API의 리소스 이름, 서비스 메서드, JSON 이름 지정 규칙에 대해 자세히 설명하여 REST 인터페이스 엔드포인트를 정의하는 데 함께 사용되는 방법을 보여줍니다.
오류 관리
발생하는 오류를 분석하고 디버깅하는 방법에 관한 안내는 API 오류 이해를 참고하세요.
탐색 문서
Google Ads API에서 사용 가능한 메서드의 검색을 용이하게 하고 자동화하려면 각 버전에 게시된 탐색 문서를 사용하면 됩니다.
https://googleads.googleapis.com/$discovery/rest?version=<API_VERSION>에서 사용할 수 있습니다.
예를 들어 다음은 최신 버전의 Google Ads API에 대한
탐색 문서
입니다.