API 구조 가이드에서 설명한 대로 Google Ads API의 각 최상위 리소스에는 리소스의 인스턴스 수정을 지원하는 리소스 유형별 서비스가 있습니다.
이 가이드에서는 CampaignService를 사용하여 Campaign 객체를 수정하는 방법을 보여주지만 다른 모든 리소스 유형별 서비스에도 동일한 개념이 적용됩니다.
객체 변경
각 리소스 유형별 서비스에는 변경 요청을 수락하는 mutate 메서드가 있습니다. 이 요청은 다음으로 구성됩니다.
customerId- 작업 모음
- 변경 후 변경 가능한 리소스 또는 리소스 이름만 반환할지 여부를 결정하는 응답 콘텐츠 유형 설정
예를 들어 MutateCampaigns의 CampaignService 메서드는 다음으로 구성된
MutateCampaignsRequest를 수락합니다.
customerIdCampaignOperation객체 모음- 선호하는 응답 유형을 나타내는
response_content_type필드
작업
CampaignOperation과 같은 작업 객체를 사용하면 operation 필드를 설정하여 단일 리소스에서 수행하려는 작업을 지정할 수 있습니다.
이 필드는 유형이 리소스 유형인 다음 속성으로 구성된 oneof 필드
입니다.
create- 리소스의 새 인스턴스를 만듭니다.
updateupdate의 속성과 일치하도록 리소스를 업데이트합니다.리소스. 이 필드가 설정되면 업데이트 작업 중에 수정할 속성을 Google Ads API에 알리는 작업의
update_mask도 설정해야 합니다. 각 클라이언트 라이브러리에는update_mask를 생성하는 유틸리티 또는 도우미 메서드가 있습니다. 이는 클라이언트 라이브러리에 설명되어 있습니다.remove리소스를 삭제합니다.
operation 필드는 oneof 필드이므로 단일 작업을 사용하여 여러 객체를 수정할 수 없습니다. 예를 들어 캠페인 하나를 만들고 다른 캠페인을 삭제하려면 요청에 CampaignOperation 인스턴스 두 개를 추가합니다. 하나는 create가 설정된 인스턴스이고 다른 하나는 remove가 설정된 인스턴스입니다.
일괄 작업
단일 작업은 단일 리소스만 생성, 업데이트 또는 삭제할 수 있지만 단일 변경 요청에는 여러 작업이 포함될 수 있습니다. 각각 단일 작업을 포함하는 여러 변경 요청을 보내는 대신 작업을 단일 변경 요청으로 결합해야 합니다.
예를 들어 캠페인 10개를 만들려면 CampaignOperation 객체가 10개 있는 단일 MutateCampaignsRequest를 보내야 합니다.
변경 응답
응답에서 반환되는 내용은 변경 요청의
response_content_type
에 전송된 내용에 따라 다릅니다. 예를 들어 MUTABLE_RESOURCE가 지정된 경우
응답에는 캠페인의
변경 가능한 필드만 포함됩니다. 그런 다음 리소스 객체를 재구성하지 않고도 해당 리소스 객체에 후속 변경을 적용할 수 있습니다.
변경 오류
지정된 변경 요청의 작업은 요청의 모든 작업이 성공한 경우에만 Google Ads 계정에 적용됩니다. 일반적인 오류 및 해결 방법을 보려면 일반적인 오류 가이드를 확인하세요.
변경사항 추적
Google Ads 계정에서 객체에 적용된 변경사항을 추적하거나 객체의 현재 상태를 검색하려면 change_status 및 change_event 리소스를 사용하면 됩니다.
change_status는 지정된 기간 내에 변경된 리소스의 요약을 제공합니다.change_event는 변경된 필드의 이전 값과 새 값을 포함하여 변경사항의 세부 기록을 제공합니다.
이러한 리소스를 쿼리하려면 GoogleAdsService.SearchStream 또는 GoogleAdsService.Search 메서드를 사용합니다. GoogleAdsService를 사용한 보고서
스트리밍에 대해 자세히 알아보세요.