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.