Métodos de servicio

El diseño de la API de Google Ads difiere de una arquitectura de REST tradicional ya que, en su lugar, usa métodos personalizados, como search y mutate,. de los métodos list, get, create, update y delete más tradicionales. Estas acciones se expresan en URLs de REST mediante la asignación HTTP de una : para separar el verbo personalizado del resto de la URL.

Por ejemplo, una llamada a la API de modificación de campaña utiliza la siguiente URL:

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

Una de las razones por las que la API usa métodos personalizados es la habilitación de la agrupación en lotes de varios operaciones en una sola solicitud a la API. Una semántica de REST estricta solo permitiría actualizar una campaña a la vez. Una instancia de REST tradicional update a una campaña, por ejemplo, requeriría el envío de una solicitud PATCH HTTP por campaña recurso.

Para permitir que se agrupen muchas operaciones en un solo cuerpo de solicitud, En cambio, la API de Google Ads define un método mutate personalizado para la mayoría de los recursos. De manera similar, para habilitar las lecturas por lotes (recuperar muchos objetos a la vez) de la API, la API usa un método search personalizado con una consulta de Google Ads similar a SQL Idioma.

En la página Métodos comunes, se detalla la siguiente información: los métodos más usados en la API de Google Ads.