Google Ads API에서 일부 메시지 필드는 빈 메시지 객체(예: campaign.manual_cpm
)로 정의되거나
설정할 필요가 없는 선택사항 필드(예: campaign.manual_cpc
)만
포함될 수 있습니다.
이러한 필드를 설정하는 것은 API에 특정 캠페인에 사용할 입찰 전략을 알려주는 데 중요하지만 메시지가 비어 있으면 직관적이지 않습니다.
문자열인 campaign.name
필드를 업데이트할 때는 마치 일반 Python 객체 속성인 것처럼 직접 업데이트하여 필드를 설정합니다.
campaign.name = "Test campaign value"
campaign.manual_cpc
는 중첩된 필드입니다. 즉, 문자열과 같은 원시 유형이 아닌 다른 protobuf 메시지가 포함됩니다. 필드를 직접 업데이트할 수도 있습니다.
campaign.manual_cpc.enhanced_cpc_enabled = True
이렇게 하면 API에 이 캠페인의 입찰 전략이 manual_cpc
이고 향상된 CPC가 사용 설정되어 있다고 알립니다.
하지만 비어 있는 manual_cpm
를 사용하려면 어떻게 해야 할까요? 아니면 향상된 CPC를 사용 설정하지 않은 manual_cpc
인가요? 이렇게 하려면 클래스의 별도의 빈 인스턴스를 캠페인에 복사해야 합니다. 예를 들면 다음과 같습니다.
client = GoogleAdsClient.load_from_storage()
empty_cpm = client.get_type('ManualCpm')
client.copy_from(campaign.manual_cpm, empty_cpm)
campaign
객체에 manual_cpm
가 지정되는 방식을 확인합니다.
name {
value: "Test campaign value"
}
manual_cpm {
}
manual_cpm
필드는 설정되어 있지만 해당 필드에 값이 없습니다. 이 패턴을 사용하는 API에 요청을 전송할 때 로깅을 사용 설정하고 요청 페이로드를 검사하여 빈 메시지 객체를 올바르게 설정하고 있는지 확인할 수 있습니다.
마지막으로 이 필드를 요청 객체의 update_mask
에 수동으로 추가해야 합니다. 필드 마스크 도우미에는 명시적으로 빈 객체로 설정된 필드와 설정되지 않은 필드의 차이를 판단하는 메커니즘이 없습니다.
from google.api_core.protobuf_helpers import field_mask
campaign_operation.create = campaign
campaign_operation.update_mask = field_mask(None, campaign)
# Here we manually add the "manual_cpm" field
campaign_operation.update_mask.append("manual_cpm")