服务方法

Google Ads API 的设计与传统的 REST 架构不同,因为它主要使用自定义方法(例如 searchmutate,),而不是更传统的 listgetcreateupdatedelete 方法。这些操作在 REST 网址中表示,使用 :HTTP 映射惯例将自定义动词与网址的其余部分分开。

例如,广告系列转变 API 调用使用以下网址:

https://googleads.googleapis.com/v16/customers/1234567890/campaigns:mutate

该 API 使用自定义方法的一个原因是允许将多个操作批量处理到单个 API 请求中。严格的 REST 语义仅允许一次更新一个广告系列。例如,对于广告系列的传统 REST update,则需要为每个广告系列资源发送一个 HTTP PATCH 请求。

为了使许多操作捆绑到一个请求正文中,Google Ads API 改为定义了大多数资源的一个自定义 mutate 方法。同样,如需启用 API 的批量读取(一次提取许多对象),该 API 会使用自定义 search 方法和 SQL 形式的 Google Ads 查询语言

常用方法页面详细介绍了 Google Ads API 中最常用的方法。