Como se explica en la guía de estructura de la API, cada recurso de nivel superior de la API de Google Ads tiene un servicio correspondiente específico según el tipo de recurso que admite lo siguiente:
- Modifica instancias del recurso
- Cómo recuperar una sola instancia del recurso para su inspección
En esta guía, se usará CampaignService
para demostrar la modificación y la inspección de objetos Campaign
, pero los mismos conceptos se aplican a todos los demás servicios específicos de un tipo de recurso.
Cambia objetos
Cada servicio específico según el tipo de recurso tendrá un método mutate que acepta una solicitud de mutación. Esta solicitud consiste en lo siguiente:
- A
customerId
- Una colección de operaciones
- Una configuración de tipo de contenido de respuesta que determina si el recurso mutable o solo el nombre del recurso se debe mostrar después de la mutación.
Por ejemplo, el método MutateCampaigns
de CampaignService
acepta un objeto MutateCampaignsRequest
que consta de lo siguiente:
- A
customerId
- Una colección de objetos
CampaignOperation
- El campo
response_content_type
que indica el tipo de respuesta preferido.
Operaciones
Un objeto de operación, como CampaignOperation
, te permite especificar la acción que deseas realizar en un solo recurso mediante la configuración de su campo operation
. Este campo es un uno de los campos que consta de los siguientes atributos cuyo tipo es el tipo de recurso:
create
- Crea una instancia nueva del recurso.
update
- Actualiza el recurso para que coincida con los atributos del recurso
update
. Cuando se configura este campo, también debes establecer elupdate_mask
de la operación, que le indica a la API de Google Ads qué atributos modificar durante la operación de actualización. Cada biblioteca cliente tiene una utilidad o un método auxiliar que generará elupdate_mask
por ti, como se muestra en nuestras bibliotecas cliente. remove
- Quita el recurso.
Dado que el campo operation
es oneof
, no puedes usar una sola operación para modificar varios objetos. Por ejemplo, si deseas crear una campaña y quitar otra, agrega dos instancias de CampaignOperation
a tu solicitud: una con create
establecido y otra con remove
establecido.
Operaciones de agrupación en lotes
Aunque una sola operación puede crear, actualizar o quitar un solo recurso, una sola solicitud de mutación puede contener varias operaciones. Debes combinar tus operaciones en una sola solicitud de mutación en lugar de enviar varias solicitudes de mutación que contengan una sola operación.
Por ejemplo, si deseas crear diez campañas, debes enviar una única MutateCampaignsRequest
que tenga diez objetos CampaignOperation
.
Modificación de respuestas
Lo que se muestra en la respuesta depende de lo que se envió en el response_content_type
de la solicitud de mutación. Por ejemplo, si se especificara MUTABLE_RESOURCE
, la respuesta contendrá solo los campos mutables de la campaña. Luego, puedes hacer mutaciones de seguimiento en ese objeto de recurso sin tener que reconstruirlo.
Modificación de errores
Las operaciones en una solicitud de modificación dada solo se aplicarán a tu cuenta de Google Ads si todas las operaciones de la solicitud se ejecutan correctamente. Consulta la guía de errores comunes para obtener una lista de errores comunes y cómo abordarlos.
Cómo inspeccionar objetos con get (obsoleto)
Además de cambiar los objetos, cada servicio específico del tipo de recurso también tiene un método get para recuperar todos los atributos de un único recurso.
Este método acepta una solicitud get cuyo único atributo es resource_name
.
Los métodos get son una ventaja que ofrece la API de Google Ads para facilitar la recuperación de todos los atributos de un solo objeto. Si bien esta es una gran herramienta para aprender a usar la API o inspeccionar un objeto individual con fines de depuración o educación, la app no debe usar métodos get para recuperar objetos y procesarlos o generar informes. En su lugar, usa GoogleAdsService
, ya que te permite recuperar solo atributos específicos de objetos, admite la recuperación de métricas de rendimiento y permite la transmisión a través de grandes conjuntos de resultados. Si tu app envía una gran cantidad de solicitudes GET, es posible que se produzcan límites de frecuencia.