POST
https://api.nexscope.ai/api/skill-api/v1/skills/amazon-ads-manager/runEjecutar esta API
Envía una solicitud JSON para ejecutar esta API y recibir los datos de respuesta documentados.
Endpoint
| Método | POST |
| Ruta | https://api.nexscope.ai/api/skill-api/v1/skills/amazon-ads-manager/run |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Guía de operaciones de Amazon Ads
Selecciona un ID de operación de la tabla y envíalo con un connectionId que te pertenezca. Las operaciones de lectura devuelven el resultado sujeto a los controles establecidos. Las operaciones de creación y actualización requieren payload y una vista previa seguida de una confirmación independiente con el confirmationToken de un solo uso devuelto. Los filtros POST /list de Sponsored Products deben incluirse en payload, no en queryString.
La tabla enumera los 61 ID de operación aceptados por el catálogo de Nexscope. Usa el endpoint de ejecución de Nexscope mostrado arriba; el backend gestiona las rutas y credenciales del proveedor.
Sponsored Products (28 operaciones)
| operationId | Acción | Acceso |
|---|---|---|
| sp.create_ad_groups | Crear grupos de anuncios | Vista previa y confirmación |
| sp.create_budget_rules | Crear reglas de presupuesto | Vista previa y confirmación |
| sp.create_budget_rules_association | Crear asociación de reglas de presupuesto | Vista previa y confirmación |
| sp.create_campaign_negative_keywords | Crear palabras clave negativas de campaña | Vista previa y confirmación |
| sp.create_campaign_negative_targets | Crear objetivos negativos de campaña | Vista previa y confirmación |
| sp.create_campaigns | Crear campañas | Vista previa y confirmación |
| sp.create_keywords | Crear palabras clave | Vista previa y confirmación |
| sp.create_negative_keywords | Crear palabras clave negativas | Vista previa y confirmación |
| sp.create_negative_targets | Crear objetivos negativos | Vista previa y confirmación |
| sp.create_product_ads | Crear anuncios de producto | Vista previa y confirmación |
| sp.create_targets | Crear objetivos | Vista previa y confirmación |
| sp.list_ad_groups | Listar grupos de anuncios | Lectura |
| sp.list_budget_rules | Listar reglas de presupuesto | Lectura |
| sp.list_campaigns | Listar campañas | Lectura |
| sp.list_keywords | Listar palabras clave | Lectura |
| sp.list_negative_keywords | Listar palabras clave negativas | Lectura |
| sp.list_product_ads | Listar anuncios de producto | Lectura |
| sp.list_targets | Listar objetivos | Lectura |
| sp.update_ad_groups | Actualizar grupos de anuncios | Vista previa y confirmación |
| sp.update_budget_rules | Actualizar reglas de presupuesto | Vista previa y confirmación |
| sp.update_campaign_negative_keywords | Actualizar palabras clave negativas de campaña | Vista previa y confirmación |
| sp.update_campaign_negative_targets | Actualizar objetivos negativos de campaña | Vista previa y confirmación |
| sp.update_campaigns | Actualizar campañas | Vista previa y confirmación |
| sp.update_keywords | Actualizar palabras clave | Vista previa y confirmación |
| sp.update_negative_keywords | Actualizar palabras clave negativas | Vista previa y confirmación |
| sp.update_negative_targets | Actualizar objetivos negativos | Vista previa y confirmación |
| sp.update_product_ads | Actualizar anuncios de producto | Vista previa y confirmación |
| sp.update_targets | Actualizar objetivos | Vista previa y confirmación |
Sponsored Brands (12 operaciones)
| operationId | Acción | Acceso |
|---|---|---|
| sb.create_ad_groups | Crear grupos de anuncios | Vista previa y confirmación |
| sb.create_ads | Crear anuncios | Vista previa y confirmación |
| sb.create_budget_rules | Crear reglas de presupuesto | Vista previa y confirmación |
| sb.create_campaigns | Crear campañas | Vista previa y confirmación |
| sb.list_ad_groups | Listar grupos de anuncios | Lectura |
| sb.list_ads | Listar anuncios | Lectura |
| sb.list_budget_rules | Listar reglas de presupuesto | Lectura |
| sb.list_campaigns | Listar campañas | Lectura |
| sb.update_ad_groups | Actualizar grupos de anuncios | Vista previa y confirmación |
| sb.update_ads | Actualizar anuncios | Vista previa y confirmación |
| sb.update_budget_rules | Actualizar reglas de presupuesto | Vista previa y confirmación |
| sb.update_campaigns | Actualizar campañas | Vista previa y confirmación |
Sponsored Display (21 operaciones)
| operationId | Acción | Acceso |
|---|---|---|
| sd.create_ad_groups | Crear grupos de anuncios | Vista previa y confirmación |
| sd.create_budget_rules | Crear reglas de presupuesto | Vista previa y confirmación |
| sd.create_campaigns | Crear campañas | Vista previa y confirmación |
| sd.create_creatives | Crear creatividades | Vista previa y confirmación |
| sd.create_negative_targets | Crear objetivos negativos | Vista previa y confirmación |
| sd.create_product_ads | Crear anuncios de producto | Vista previa y confirmación |
| sd.create_targets | Crear objetivos | Vista previa y confirmación |
| sd.list_ad_groups | Listar grupos de anuncios | Lectura |
| sd.list_budget_rules | Listar reglas de presupuesto | Lectura |
| sd.list_campaigns | Listar campañas | Lectura |
| sd.list_creatives | Listar creatividades | Lectura |
| sd.list_negative_targets | Listar objetivos negativos | Lectura |
| sd.list_product_ads | Listar anuncios de producto | Lectura |
| sd.list_targets | Listar objetivos | Lectura |
| sd.update_ad_groups | Actualizar grupos de anuncios | Vista previa y confirmación |
| sd.update_budget_rules | Actualizar reglas de presupuesto | Vista previa y confirmación |
| sd.update_campaigns | Actualizar campañas | Vista previa y confirmación |
| sd.update_creatives | Actualizar creatividades | Vista previa y confirmación |
| sd.update_negative_targets | Actualizar objetivos negativos | Vista previa y confirmación |
| sd.update_product_ads | Actualizar anuncios de producto | Vista previa y confirmación |
| sd.update_targets | Actualizar objetivos | Vista previa y confirmación |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
operationId | string | obligatorio | Id. de operación de catálogo exacto, por ejemplo sp.list_campaigns. Ejemplo: sp.list_campaigns |
connectionId | integer | obligatorio | Propiedad de Amazon Ads ID de conexión. Ejemplo: 123 |
payload | object | opcional | Campos documentados para la operación seleccionada; requeridos por operaciones de creación/actualización. SP POST /lista de filtros como campaignIdFilter y stateFilter pertenecen a la carga útil como objetos con no vacío incluyen matrices de cadenas. Ejemplo: {
"campaignIdFilter": {
"include": [
"123456789"
]
},
"maxResults": 10
} |
queryString | string | opcional | Cadena de consulta opcional específica para operación sin un ? principal; no lo use para SP POST /filtros de lista. Ejemplo: |
adType | string | opcional | Requerido sólo por sb.create_ads. Ejemplo: video |
action | string | opcional | previsualizar (predeterminado) o confirmar para las mutaciones; ignorado para las lecturas. Ejemplo: preview |
confirmationToken | string | opcional | Token de un solo uso requerido cuando la acción es confirmada. Ejemplo: opaque-token |
Respuesta de ejemplo
Estructura de respuesta de la plataforma. code 0 indica éxito o aceptación; data contiene el resultado de negocio.
{
"code": 0,
"cost": "-1",
"data": {
"confirmationToken": "opaque-token",
"data": {},
"expiresAt": "1760000000000"
},
"msg": null,
"time": "2026-01-01 00:00:00",
"traceId": null,
"ts": "0"
}Campos de respuesta
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
code | integer | obligatorio | 0 significa aceptado o exitoso; no cero es un error de plataforma. |
cost | string | obligatorio | Se pasó milisegundos, nunca créditos; -1 peticiones externas de la web. |
data | any | obligatorio | Valor de Data usado por esta operación de API. |
msg | string | null | obligatorio | Valor de Msg usado por esta operación de API. |
time | string | obligatorio | Hora local del servidor: aaaa-mm-dd HH:mm:ss. |
traceId | string | null | obligatorio | Valor de Trace id usado por esta operación de API. |
ts | string | obligatorio | Epoch milisegundos. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data | object | obligatorio | Valor de Data usado por esta operación de API. |
data.confirmationToken | string | opcional | Token de confirmación de mutación de un solo uso devuelto por previsualización. Ejemplo: opaque-token |
data.costTime | integer | opcional | Tiempo de ejecución comunicado por el proveedor de aguas arriba. Ejemplo: null |
data.costToken | integer | opcional | Coste de la señal comunicado por el proveedor de aguas arriba. Ejemplo: null |
data.data | object | opcional | Resultado seguro del proveedor de anuncios de Amazon. Ejemplo: {} |
data.dataSnapshotMonth | string | opcional | Mes de instantánea de datos devuelto por el proveedor de aguas arriba. Ejemplo: null |
data.expiresAt | integer | opcional | Fecha de caducidad de la confirmación Ejemplo: 1760000000000 |
data.page | integer | opcional | Página actual devuelta por el proveedor de aguas arriba. Ejemplo: null |
data.pageItemCount | integer | opcional | El artículo cuenta con la página actual devuelta por el proveedor de aguas arriba. Ejemplo: null |
data.pageSize | integer | opcional | Tamaño de página devuelto por el proveedor de aguas arriba. Ejemplo: null |
data.sourceTool | string | opcional | Nombre de la herramienta de fuente específica del proveedor. Ejemplo: null |
data.sourceType | string | opcional | Tipo de plataforma de origen específico para el proveedor. Ejemplo: null |
data.title | string | opcional | Título de respuesta específico del proveedor. Ejemplo: null |
data.totalPage | integer | opcional | El total de páginas devueltas por el proveedor de aguas arriba. Ejemplo: null |
data.type | string | opcional | Rendición específica del proveedor o tipo de carga útil. Ejemplo: null |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data | null | obligatorio | Valor de Data usado por esta operación de API. |
Respuestas
| Código | Descripción |
|---|---|
| 200 | Respuesta HTTP predeterminada tanto para el éxito como para muchos errores de negocio. Solo el código JSON externo 0 indica éxito o aceptación asíncrona; consulta data para obtener el resultado. |
| 429 | Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente. |
| 503 | La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente. |
| Opcional | X-Nexscope-Http-Status: semantic asigna estados HTTP a los errores de negocio gestionados por el controlador en las rutas de ejecución y tareas. Los fallos previos a la autenticación, como la ausencia de una clave API (code 11209), pueden seguir devolviendo HTTP 200 antes de esta asignación. Comprueba siempre el código JSON externo; las solicitudes malformadas y los fallos de infraestructura también pueden devolver respuestas HTTP distintas de 200. |
Fuente de datos, vigencia y limitaciones
La fuente, la vigencia, la cobertura, los límites de frecuencia y las notas de estimación no se especifican en esta definición de API salvo que aparezcan en la documentación de campos de solicitud o respuesta anterior. No supongas datos oficiales del mercado ni actualización en tiempo real cuando no estén documentados explícitamente.