API 구조 가이드의 설명대로 Google Ads API의 각 최상위 리소스에는 다음을 지원하는 해당 리소스 유형별 서비스가 있습니다.
- 리소스 인스턴스 수정
- 검사할 리소스의 단일 인스턴스 검색
이 가이드에서는 CampaignService를 사용하여 Campaign 객체를 수정하고 검사하는 방법을 설명하지만 다른 모든 리소스 유형별 서비스에도 동일한 개념이 적용됩니다.
객체 변경
각 리소스 유형별 서비스에는 change 요청을 허용하는 mutate 메서드가 있습니다. 이 요청은 다음으로 구성됩니다.
customerId- 작업 모음
- 변경 후 변경 가능한 리소스를 반환해야 하는지 아니면 리소스 이름만 반환해야 하는지 결정하는 응답 콘텐츠 유형 설정입니다.
예를 들어 CampaignService의 MutateCampaigns 메서드는 다음으로 구성된 MutateCampaignsRequest를 허용합니다.
customerIdCampaignOperation객체 컬렉션- 선호하는 응답 유형을 나타내는
response_content_type필드
운영
CampaignOperation와 같은 작업 객체를 사용하면 operation 필드를 설정하여 단일 리소스에 수행할 작업을 지정할 수 있습니다. 이 필드는 유형이 리소스 유형인 다음 속성으로 구성된 oneof field입니다.
create- 리소스의 새 인스턴스를 만듭니다.
updateupdate리소스의 속성과 일치하도록 리소스를 업데이트합니다. 이 필드를 설정하면 작업의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 요청을 많이 제출하는 경우 비율 제한이 발생할 수 있습니다.