使用资源的专用服务是在 Google Ads API 中创建、更新或移除单个资源类型的实体的最直接方式。
Mutate 端点
每个可变资源都有对应的服务和操作类型。如需使用资源的专用服务来更改资源，请在操作中填充以下某个字段，然后将其发送到服务的更改端点：
- 创建 (
create)：要创建的新资源对象。 - 更新 (
update)：修改后的资源对象，附带一个update_mask，用于指定已更改的字段。 - 移除 (
remove)：要移除的目标资源的resource_name字符串。
例如，如需创建新的 Campaign，请完成以下步骤：
- 使用所选属性构造
Campaign对象。 - 将其分配给
CampaignOperation的create字段。 - 以
MutateCampaignsRequest的形式将操作发送到CampaignService.MutateCampaigns。
此模式适用于 Google Ads API 中的所有特定于资源的服务：
AdGroup：将AdGroupOperation传递给AdGroupService.MutateAdGroups。CampaignCriterion：将CampaignCriterionOperation传递给CampaignCriterionService.MutateCampaignCriteria。
以下 REST JSON 载荷展示了对 CampaignService.MutateCampaigns 的请求：
{
"customerId": "CUSTOMER_ID",
"operations": [
{
"create": {
"name": "Interplanetary Cruise #1",
"advertisingChannelType": "SEARCH",
"status": "PAUSED",
"manualCpc": {},
"campaignBudget": "customers/CUSTOMER_ID/campaignBudgets/BUDGET_ID",
"containsEuPoliticalAdvertising": "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING"
}
}
],
"partialFailure": false,
"validateOnly": false
}
多项操作和限制
大多数特定于资源的 mutate 请求都接受重复的 operations 字段，因此单个请求可以包含针对相应资源类型的多个操作（每个请求最多 10,000 个操作，对于 AdGroupCriterionService.MutateAdGroupCriteria 为 20,000 个；CustomerService.MutateCustomer 接受单个 operation 字段）。默认情况下，请求中的所有操作都会以原子方式执行，除非服务支持 partial_failure 并且您将其设置为 true。
不过，各个资源服务存在两个重要限制：
- 单一资源类型：对资源服务的请求只能更改由该特定服务管理的资源。
- 没有跨资源的临时 ID：由于特定于资源的 mutate 调用仅接受一种资源类型，因此您无法为父资源（例如
customers/CUSTOMER_ID/campaigns/-1）分配临时负 ID，并在同一请求中从不同类型的子资源（例如AdGroup）引用该 ID。（对于分层树，例如AdGroupCriterion商品详情组和AssetGroupListingGroupFilter节点，支持同一资源类型内的自引用临时 ID。）
如果您需要在单个请求中更改多种资源类型，或者在不同资源类型之间引用临时资源名称，请改用 GoogleAdsService.Mutate。
版本特定的差异
在变异资源时，请注意以下支持的 Google Ads API 版本之间的差异：
- 生命周期目标服务：客户留存目标通过
GoalService.MutateGoals(retention_goal_settings) 和CampaignGoalConfigService.MutateCampaignGoalConfigs(campaign_retention_settings) 在所有受支持的版本中进行变动，使用标准的重复operations字段。在 v25 及更高版本中，新客户获取 (new_customer_acquisition_goal_settings/campaign_new_customer_acquisition_settings) 和忠诚度留存 (loyalty_retention_goal_settings/campaign_loyalty_retention_settings) 也会通过GoalService.MutateGoals和CampaignGoalConfigService.MutateCampaignGoalConfigs进行变异。此属性取代了CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals和CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals，这两个属性用于 v23 和 v24 中的“新客户获取”，并接受单个operation字段。