服务方法

Google Ads API 的设计与传统 REST 架构不同 因为它主要使用自定义方法,例如 searchmutate, 比较传统的 listgetcreateupdatedelete 方法之一。 这些操作使用 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 中最常用的方法。