API 구조 가이드의 설명대로 Google Ads API의 각 최상위 리소스에는 다음을 지원하는 해당 리소스 유형별 서비스가 있습니다.
- 리소스 인스턴스 수정
- 검사할 리소스의 단일 인스턴스 검색
이 가이드에서는 CampaignService
를 사용하여 Campaign
객체를 수정하고 검사하는 방법을 설명하지만 다른 모든 리소스 유형별 서비스에도 동일한 개념이 적용됩니다.
객체 변경
각 리소스 유형별 서비스에는 change 요청을 허용하는 mutate 메서드가 있습니다. 이 요청은 다음으로 구성됩니다.
customerId
- 작업 모음
- 변경 후 변경 가능한 리소스를 반환해야 하는지 아니면 리소스 이름만 반환해야 하는지 결정하는 응답 콘텐츠 유형 설정입니다.
예를 들어 CampaignService
의 MutateCampaigns
메서드는 다음으로 구성된 MutateCampaignsRequest
를 허용합니다.
customerId
CampaignOperation
객체 컬렉션- 선호하는 응답 유형을 나타내는
response_content_type
필드
운영
CampaignOperation
와 같은 작업 객체를 사용하면 operation
필드를 설정하여 단일 리소스에 수행할 작업을 지정할 수 있습니다. 이 필드는 유형이 리소스 유형인 다음 속성으로 구성된 oneof field입니다.
create
- 리소스의 새 인스턴스를 만듭니다.
update
update
리소스의 속성과 일치하도록 리소스를 업데이트합니다. 이 필드를 설정하면 작업의update_mask
도 설정해야 합니다. 이렇게 하면 업데이트 작업 중에 수정할 속성을 Google Ads API에 알릴 수 있습니다. 각 클라이언트 라이브러리에는 클라이언트 라이브러리에 설명된 대로update_mask
를 자동으로 생성하는 유틸리티 또는 도우미 메서드가 있습니다.remove
- 리소스를 삭제합니다.
operation
필드는 oneof
필드이므로 단일 작업으로 여러 객체를 수정할 수 없습니다. 예를 들어 하나의 캠페인을 만들고 다른 캠페인을 삭제하려면 create
가 설정된 인스턴스와 remove
가 설정된 인스턴스 두 개를 요청에 추가합니다.CampaignOperation
일괄 처리 작업
단일 작업은 리소스 하나만 생성, 업데이트 또는 삭제할 수 있지만, 단일 변경 요청에 여러 연산이 포함될 수 있습니다. 각각 하나의 연산이 포함된 여러 개의 변경 요청을 보내는 대신 여러 작업을 하나의 변경 요청으로 바꾸어야 합니다.
예를 들어 10개의 캠페인을 만들려면 10개의 CampaignOperation
객체가 있는 단일 MutateCampaignsRequest
를 전송해야 합니다.
대답 변경
응답에 반환되는 내용은 변경 요청의 response_content_type
에 전송된 내용에 따라 다릅니다. 예를 들어 MUTABLE_RESOURCE
가 지정된 경우 응답에는 캠페인의 변경 가능한 필드만 포함됩니다. 그러면 해당 리소스 객체를 재구성할 필요 없이 해당 리소스 객체에 대해 후속 변경을 수행할 수 있습니다.
오류 변형
지정된 변경 요청의 연산은 요청의 모든 연산이 성공한 경우에만 Google Ads 계정에 적용됩니다. 일반적인 오류 목록과 해결 방법은 일반적인 오류 가이드를 참고하세요.
get으로 객체 검사 (지원 중단됨)
각 리소스 유형별 서비스에는 객체 변경 외에 단일 리소스의 모든 속성을 검색하기 위한 get 메서드도 있습니다.
이 메서드는 유일한 속성이 resource_name
인 get 요청을 허용합니다.
get 메서드는 Google Ads API에서 단일 객체의 모든 속성을 손쉽게 검색할 수 있도록
제공하는 편리한 기능입니다. 이는 API를 학습하거나 디버깅 또는 교육용 목적으로 개별 객체를 검사하는 데 유용한 도구이지만 앱에서 처리 또는 보고를 위해 get 메서드를 사용하여 객체를 검색해서는 안 됩니다. 대신 GoogleAdsService
를 사용하세요. 객체의 특정 속성만 검색하고 성능 측정항목 검색을 지원하며 대규모 결과 집합을 스트리밍할 수 있습니다. 앱이 get 요청을 많이 제출하는 경우 비율 제한이 발생할 수 있습니다.