La API anterior de Search Ads 360 Reporting dejará de estar disponible y se retirará el 30 de junio de 2024. Ten en cuenta que la API de conversiones de Search Ads 360 no se ve afectada y seguirá siendo compatible. Todo el desarrollo de informes nuevo debe usar la nueva API de Search Ads 360 Reporting.

A partir de abril de 2024, se mostrará un error supportedApiVersion cuando se solicite un informe. Consulte los detalles aquí.

También te recomendamos que migres todas las implementaciones existentes de Search Ads 360 a la nueva API. Consulta la introducción y la guía de migración de la nueva API de Search Ads 360 Reporting para obtener más información.

Se usó la API de Cloud Translation para traducir esta página.

Solución de problemas

Si tienes problemas al usar la API de Search Ads 360, consulta esta sección de solución de problemas.

Si no puedes resolver un problema después de leer los recursos de este sitio, comunícate con el equipo de asistencia y ten lista la siguiente información:

ID de agencia de Search Ads 360 y ID de anunciante al que intenta acceder
Número de proyecto de la Consola de API de Google
El nombre de usuario de la Cuenta de Google que usas para acceder a la API.
Esta es la cuenta a la que se le otorgó permiso para acceder a Search Ads 360, que es la misma que usa para configurar la autorización.
Fragmento de código de tu solicitud
Respuesta JSON
Si la respuesta es un error, asegúrate de incluir el mensaje de error, no solo el código numérico de error.

Errores de autorización

Estos son algunos errores de autorización que se encuentran comúnmente:

Mensaje	Descripción
`Access Not Configured. Please use Google API Console to activate the API for your project.`	Este error se produce si no habilitó la API de Search Ads 360 para su cuenta. Asegúrate de haber hecho lo siguiente: Ve a la Consola de API de Google. Selecciona tu proyecto. Si aún no creaste un proyecto, consulta Crea un proyecto para tu cliente. En la barra lateral izquierda, expande API y autenticación. Luego, haz clic en API. En la lista de APIs, asegúrate de que el estado sea ON para la API de Search Ads 360.
`Invalid grant`	Este error se produce cuando el token de actualización no es válido. Puedes obtener un token de actualización si invocas la secuencia de comandos de utilidad de Search Ads 360 de la siguiente manera: `sa360Api.py --login` Obtén más información sobre el flujo de trabajo recomendado para la autorización.
`Invalid client no application name`	Este error ocurre si no especificaste un nombre de producto cuando configuraste tu proyecto en la Consola de API de Google. Para corregir este error, ingresa el nombre de tu producto en la Pantalla de consentimiento de la consola de la API de Google.
Otros tipos de errores de autorización	Asegúrate de usar una Cuenta de Google que tenga acceso a Search Ads 360 cuando accedas a la Consola de API de Google para recuperar tu ID de cliente y tu secreto del cliente, y cuando obtengas un token de actualización.

Errores de carga de conversiones

En la siguiente tabla, se enumeran los errores que puede encontrar durante la carga de conversiones. Ten en cuenta que los códigos de error hexadecimales son inmutables, por lo que puedes usarlos en tus propias secuencias de comandos para identificar errores.

Código de error	Mensaje	Descripción
`0x00000101`	`Click ID '{ID}' is not found`	El id de clic que especificaste en una solicitud `update` no es válido. Vuelva a subir las conversiones después de hacer lo siguiente: Verificamos que el ID de clic se generó 4 horas antes de que se subieran las conversiones. Activaste el servicio de conversión de la API. Si atribuye las conversiones a visitas específicas, espere al menos 30 minutos después de la visita antes de subir la conversión. Es posible que Search Ads 360 no reconozca el clickID de la visita si sube ese archivo antes de los 30 minutos posteriores. En raras ocasiones, es posible que debas esperar hasta 4 horas para que Search Ads 360 pueda reconocer el clickId. Se confirmó que el clic proviene de una fuente válida, como se indica mediante el parámetro `gclsrc`. Confirmaste que especificaste el anunciante correcto en la columna advertiserId. Verificaste que tu ID de clic se haya generado en los últimos 90 días.
`0x0000010E`	`Floodlight activity name '{name}' is not found`	El nombre de la actividad de Floodlight especificada en la columna `segmentationName` es incorrecto o aún no está disponible. Si ves este error, comprueba los siguientes problemas comunes: En los nombres, se distingue entre mayúsculas y minúsculas. Asegúrate de que la solicitud coincida exactamente con el caso. Asegúrate de no incluir ningún carácter Unicode imprimible ni espacios dobles en el nombre de la actividad de Floodlight. Asegúrate de especificar el nombre de una actividad de Floodlight, no de una columna de Floodlight. Comprueba que la actividad de Floodlight exista para el anunciante que especificaste en la columna `advertiserId`. (Es posible que haya especificado el anunciante incorrecto). Después de crear o editar una actividad de Floodlight, espere un par de horas antes de subir las conversiones para esta.
`0x00000115`	`Custom dimension '{name}' is not found`	Asegúrate de que la variable personalizada de Floodlight que especificaste se haya configurado como una dimensión (no una métrica) para el anunciante asociado con `clickId`, `criterionId` o `productGroupId` que atribuyes a la conversión.
`0x00000116`	`Custom metric '{name}' is not found`	Asegúrate de que la variable personalizada de Floodlight que especificaste se haya configurado como una métrica (no una dimensión) para el anunciante asociado con `clickId`, `criterionId` o `productGroupId` que atribuyes a la conversión.
`0x0000011A`	`The advertiser conversion ID is already specified for a conversion with Search Ads 360 conversion ID {ID}`	Alguien ya subió una conversión para el mismo permiso y el mismo ID de conversión del anunciante especificado en la columna `conversionId`. El "ID de conversión del anunciante" es un ID que usted genera. Search Ads 360 requiere que este ID sea único para un alcance determinado. Search Ads 360 genera el ID de conversión de Search Ads 360 y se garantiza que es único.
`0x0000011B`	`Advertiser conversion ID '{ID}' is not found`	Su solicitud `update` intentó actualizar un ID de conversión del anunciante que no existe. Asegúrese de que especificó el ID correcto.
`0x0000011D`	`User does not have permission to view advertiser {advertiser ID}`	La Cuenta de Google que usa tu cliente no tiene permiso para ver el anunciante especificado en la solicitud. Cuando accedas a la Consola de API de Google para recuperar tu ID de cliente y tu secreto del cliente, y cuando obtengas un token de actualización, asegúrate de usar una Cuenta de Google que se otorgó acceso al anunciante que especificaste.
`0x0000011F`	`Advertiser conversion ID is already specified in this request`	Dos o más conversiones en la solicitud especifican el mismo permiso y el mismo ID de conversión del anunciante. El ID de conversión del anunciante es un ID que generas y especificas en la columna `conversionId`. Search Ads 360 requiere que este ID sea único para un alcance determinado.
`0x0000011E`	`The requested Floodlight activity '{name}' does not match the conversion type (ACTION/TRANSACTION)`	El ID o nombre de la actividad de Floodlight que proporcionó no coincide con el tipo de conversión que especificó.

Cómo informar sobre códigos de respuesta y mensajes de error

Si solicitas un informe y la respuesta es un mensaje de error, consulta Códigos de respuesta en la API de Search Ads 360 y Respuestas de errores estándar para obtener más información sobre el error.

Los datos de la IU de Search Ads 360 no coinciden con ningún informe que muestre la API

Los datos de la IU de Search Ads 360 deben coincidir con los datos que muestra la API de forma predeterminada. Si configuras includeRemovedEntities como true en una solicitud de informe, asegúrate de que la casilla de verificación Show removed también esté seleccionada en la IU.