更改和检查对象

正如 API 结构指南中所述，Google Ads API 中的每个顶级资源都有相应的特定于资源类型的服务，且该服务支持以下操作：

• 修改资源实例
• 检索单个资源实例供检查使用

本指南将使用 CampaignService 演示如何修改和检查 Campaign 对象，但这些概念同样适用于所有其他特定于资源类型的服务。

更改对象

每个特定于资源类型的服务都有一个 mutate 方法，可接受 mutate 请求。此请求包括：

• customerId
• 操作的集合
• 响应内容类型设置，用于确定在更改后应返回可变资源还是仅返回资源名称。

例如，CampaignService 的 MutateCampaigns 方法接受由以下内容组成的 MutateCampaignsRequest：

• customerId
• CampaignOperation 对象的集合
• response_content_type 字段，用于指明首选响应类型。

操作

CampaignOperation 等操作对象支持您指定自己希望在单个资源上执行的操作，具体方法是设置其 operation 字段。此字段是 oneof 字段，由以下类型为资源类型的属性组成：

create

创建资源的新实例。

update

更新资源以匹配 update 资源的属性。设置此字段后，您还必须设置相关操作的 update_mask，让 Google Ads API 了解应在更新操作期间修改哪些属性。每个客户端库都有一个实用程序或帮助程序方法，可为您生成 update_mask，一如我们的客户端库中所示。

remove

移除资源。

由于 operation 字段为 oneof 字段，因此您无法使用单个操作来修改多个对象。例如，如果要制作一个广告系列并移除另一个广告系列，那么应在您的请求中添加两个 CampaignOperation 实例，并将其中一个设置为 create，另一个设置为 remove。

批处理操作

虽然一个操作只能创建、更新或移除一个资源，但是一个 mutate 请求中可包含多个操作。您应将多个操作组合到一个 mutate 请求中，而不是发送多个 mutate 请求，让其中每个请求只包含一个操作。

例如，如果您想制作 10 个广告系列，则应该发送一个 MutateCampaignsRequest，让其中包含 10 个 CampaignOperation 对象。

Mutate 响应

响应中返回的内容取决于更新请求的 response_content_type 中发送的内容。例如，如果指定了 MUTABLE_RESOURCE，则响应将仅包含广告系列中的可变字段。然后，您可以对该资源对象进行后续更改，而无需对其进行重构。

Mutate 错误

只有当给定 mutate 请求中的每个操作都获得成功时，该请求中的操作才会应用于您的 Google Ads 账号。有关常见错误列表及其解决方法，请查看常见错误指南。