El diseño de la API de Google Ads difiere de una arquitectura de REST tradicional porque 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 URLs de REST mediante 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ñas utiliza la siguiente URL:
https://googleads.googleapis.com/v16/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 la actualización de una campaña a la vez. Por ejemplo, una update tradicional de REST requeriría enviar una solicitud PATCH HTTP por recurso de campaña.
A fin de permitir que se agrupen muchas operaciones en un solo cuerpo de solicitud, la API de Google Ads define un método mutate personalizado para la mayoría de los recursos.
Del mismo modo, para habilitar lecturas por lotes (recuperar muchos objetos a la vez) de la API, la API usa un método search personalizado con un lenguaje de consulta de Google Ads similar a SQL.
En la página Métodos comunes, se describen en detalle los métodos de uso más frecuente en la API de Google Ads.