Google Ads API 的设计与传统 REST 架构不同
因为它主要使用自定义方法,例如 search
和 mutate,
比较传统的 list
、get
、create
、update
和 delete
方法之一。
这些操作使用 HTTP 映射在 REST 网址中表示
一种 :
惯例,将自定义动词与网址的其余部分隔开。
例如,广告系列 mutate API 调用使用以下网址:
https://googleads.googleapis.com/v17/customers/1234567890/campaigns:mutate
该 API 使用自定义方法的一个原因是
单个 API 请求。严格的 REST 语义只允许
一次更新一个广告系列。传统 REST
update
更改为
需要为每个广告系列发送一个 HTTP PATCH 请求
资源。
要允许将多个操作捆绑到一个请求正文中,
而是为大多数资源定义了一个自定义 mutate
方法。
同样,如需从 API 启用批量读取(一次提取多个对象),
该 API 将自定义 search
方法与类似于 SQL 的 Google Ads 查询结合使用
语言。
常用方法页面详细介绍了 Google Ads API 中最常用的方法。