El diseño de la API de Google Ads difiere de una arquitectura de REST tradicional, ya que usa principalmente métodos personalizados, como search y mutate,, en lugar de los métodos list, get, create, update y delete más tradicionales.
Estas acciones se expresan en las URL de REST con la convención de asignación HTTP de un : para separar el verbo personalizado del resto de la URL.
Por ejemplo, una llamada a la API de mutación de campaña utiliza la siguiente URL:
https://googleads.googleapis.com/v13/customers/1234567890/campaigns:mutate
Una de las razones por las que la API usa métodos personalizados es habilitar el procesamiento por lotes de varias operaciones en una sola solicitud a la API. La semántica estricta de REST solo permitiría actualizar una campaña a la vez. Por ejemplo, una update de REST tradicional a una campaña requeriría enviar una solicitud HTTP PATCH por recurso de campaña.
Para permitir que se agrupen muchas operaciones dentro de un solo cuerpo de solicitud, la API de Google Ads define un método mutate personalizado para la mayoría de los recursos.
De manera similar, para habilitar lecturas por lotes (recuperar muchos objetos a la vez) desde la API, la API usa un método search personalizado con un lenguaje de consulta de Google Ads similar a SQL.
La página Métodos comunes detalla los métodos más utilizados en la API de Google Ads.