ใน Google Ads API การอัปเดตจะทำโดยใช้มาสก์ช่อง รายการมาสก์ของช่อง ช่องทั้งหมดที่คุณตั้งใจจะเปลี่ยนแปลงในการอัปเดต และช่องที่ระบุ ที่ไม่ได้อยู่ในฟิลด์มาสก์จะถูกละเว้น แม้ว่าจะส่งไปยังเซิร์ฟเวอร์
ตัวช่วยมาสก์ฟิลด์
วิธีที่แนะนำในการสร้างมาสก์ของช่องคือการใช้ตัวช่วยของ field_mask
ฟังก์ชันที่รวมอยู่ในแพ็กเกจ google.api_core
ยอมรับโปรโตบูฟ 2 ตัว
ออบเจ็กต์และแสดงผลออบเจ็กต์มาสก์ฟิลด์ที่มีช่อง list
ที่มีทั้งหมด
ในฟิลด์ที่ไม่เหมือนกันระหว่างวัตถุทั้งสอง
หากมีการส่ง None
เป็นพารามิเตอร์แรก รายการมาสก์ฟิลด์จะ
มีทุกฟิลด์ในออบเจ็กต์ Protobuf รายการที่ 2 ที่ไม่ได้ตั้งค่า
ค่าเริ่มต้น
เมื่อสร้างแล้ว ควรคัดลอกออบเจ็กต์มาสก์ฟิลด์ไปยังการดำเนินการ ที่จะส่งไปยังเซิร์ฟเวอร์:
ตัวอย่างการอัปเดตแคมเปญมีดังนี้
from google.api_core import protobuf_helpers
from google.ads.googleads.client import GoogleAdsClient
# Retrieve a GoogleAdsClient instance.
client = GoogleAdsClient.load_from_storage()
# Create a new campaign operation.
campaign_operation = client.get_type('CampaignOperation')
# Retrieve a new campaign object from its update field.
campaign = campaign_operation.update
# Mutate the campaign.
campaign.network_settings.target_search_network.value = False
# Create a field mask using the updated campaign.
# The field_mask helper is only compatible with raw protobuf message
# instances, which we can access using the ._pb attribute.
field_mask = protobuf_helpers.field_mask(None, campaign._pb)
# Copy the field_mask onto the operation's update_mask field.
client.copy_from(campaign_operation.update_mask, field_mask)
ขั้นแรก เราจะสร้างออบเจ็กต์ CampaignOperation ที่ว่างเปล่า จากนั้น เราจะตั้งค่าการเรียก
ว่างจากออบเจ็กต์แคมเปญ จากนั้นเราอัปเดตออบเจ็กต์แคมเปญนั้นและสร้าง
มาสก์ฟิลด์ใหม่ โดยเปรียบเทียบกับ None
ซึ่งจะสร้างรายการมาสก์ของช่อง
ที่มีเฉพาะฟิลด์ network_settings.target_search_network
ที่
มีการเปลี่ยนแปลง
นี่คือตัวอย่างการอัปเดตแคมเปญที่มีอยู่ ในที่นี้เราจะสมมติว่าสคริปต์มี
ระบุพารามิเตอร์ resource_name
ซึ่งเป็นชื่อทรัพยากรที่ถูกต้องของ
แคมเปญ และ customer_id
ที่ถูกต้อง:
import proto
from google.api_core import protobuf_helpers
from google.ads.googleads.client import GoogleAdsClient
# Retrieve a GoogleAdsClient instance.
client = GoogleAdsClient.load_from_storage()
# Retrieve an instance of the GoogleAdsService.
googleads_service = client.get_service('GoogleAdsService')
# Search query to retrieve campaign.
query = f"""
SELECT
campaign.network_settings.target_search_network,
campaign.resource_name
FROM campaign
WHERE campaign.resource_name = {resource_name}"""
# Submit a query to retrieve a campaign instance.
response = googleads_service.search_stream(customer_id=customer_id, query=query)
# Iterate over results to retrieve the campaign.
for batch in response:
for row in batch.results:
initial_campaign = row.campaign
# Create a new campaign operation.
campaign_operation = client.get_type('CampaignOperation')
# Set the copied campaign object to a variable for easy reference.
updated_campaign = campaign_operation.update
# Copy the retrieved campaign into the new campaign.
# Here we use the proto.Message.copy_from method because of its simple
# compatibility with the protobuf message instances, which are wrapped
# by the proto-plus library.
proto.Message.copy_from(updated_campaign, initial_campaign)
# Mutate the new campaign.
updated_campaign.network_settings.target_search_network = False
# Create a field mask using the updated campaign.
field_mask = protobuf_helpers.field_mask(
initial_campaign._pb, updated_campaign._pb
)
# Copy the field mask onto the operation's update_mask field.
# Note that the client's copy_from method is designed to work with both native
# messages and messages wrapped by proto-plus, so it works here for the
# update_mask, even though it's an instance of the native message class
# google.protobuf.field_mask_pb2.FieldMask.
client.copy_from(campaign_operation.update_mask, field_mask)
สำหรับกลยุทธ์นี้ updated_campaign
จะแชร์ฟิลด์ทั้งหมดกับ
initial_campaign
ที่ดึงมาจาก API ซึ่งก็คือชื่อทรัพยากร
มาสก์ฟิลด์ที่สร้างขึ้นจะบอก API ว่า เฉพาะฟิลด์
ต้องเปลี่ยนแปลงฟิลด์ network_settings.target_search_network