REST 인터페이스 디자인

이 페이지는 리소스 중심 디자인리소스 이름 개발자 가이드 및 Google Ads API의 구체적인 구현 세부정보로 이를 보완합니다.

리소스 중심 디자인

일반적으로 Google Ads API는 개별적으로 주소 지정 가능한 리소스컬렉션 (API의 명사) 리소스는 리소스 이름으로 참조되고 작은 리소스 이름을 사용하여 조작됩니다. 메서드 집합 (동사 또는 연산이라고도 함).

이러한 리소스 이름메서드를 결합하면 특정 API 버전 프리픽스를 사용해 REST 인터페이스의 URL을 구성합니다. 예를 들어 아래 URL은 이러한 개별 구성요소로 세분화할 수 있습니다. 다음과 같습니다.

https://googleads.googleapis.com/v17/customers/1234567890:mutate
API 버전 프리픽스 리소스 이름 (상대) 메서드
https://googleads.googleapis.com/v17 customers/1234567890 mutate

특정 버전의 API에 대한 모든 REST URL (예: v17) 공통 API 버전 프리픽스를 공유합니다 리소스 이름 및 메서드 호출 중인 API 서비스를 식별합니다.

Google Ads API는 대부분의 맞춤 메서드와 달리 커스텀 메서드를 많이 사용합니다. list, get, create, update, delete Google Ads API의 맞춤 메서드의 예 search, searchStream, mutate가 포함됩니다.

Google Ads API의 리소스에 대한 자세한 내용은 다음 페이지를 참조하십시오. , 서비스 메서드JSON 이름 지정 규칙을 통한 사용 방법 설명 결합하여 REST 인터페이스 엔드포인트를 정의합니다