Consultar gasto diario de la cuenta publicitaria de Meta

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "desde": {
      "description": "Primer día (AAAA-MM-DD, día calendario en la zona horaria de la cuenta publicitaria). Omítelo para no filtrar.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "hasta": {
      "description": "Último día, incluido (AAAA-MM-DD, día calendario en la zona horaria de la cuenta publicitaria). Omítelo para no filtrar.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "cursor": {
      "description": "Puntero opaco a la página siguiente. Reenvía tal cual el 'cursor' que devolvió la llamada anterior; nunca lo construyas a mano. Omítelo para pedir la primera página.",
      "type": "string"
    },
    "limit": {
      "default": 100,
      "description": "Cuántas filas trae la página, entre 1 y 500. Por omisión, 100.",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  }
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "cuenta": {
      "type": "object",
      "properties": {
        "cuentaId": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "El id de la cuenta publicitaria en Meta, sin el prefijo 'act_', como texto. null si la conexión todavía no sincronizó."
        },
        "moneda": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "La moneda de la cuenta (ISO 4217) en la última sincronización. Cada fila trae además la suya."
        },
        "zonaHoraria": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "La zona horaria IANA de la cuenta (por ejemplo 'America/Santiago'): en ella corta Meta los días."
        }
      },
      "required": [
        "cuentaId",
        "moneda",
        "zonaHoraria"
      ],
      "additionalProperties": false,
      "description": "La cuenta publicitaria fijada a esta conexión. Una conexión lee UNA sola cuenta publicitaria."
    },
    "filas": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "fecha": {
            "type": "string",
            "description": "El día (AAAA-MM-DD) en la zona horaria de 'zonaHoraria', la de la cuenta publicitaria. No es un día de Chile si la cuenta usa otra zona."
          },
          "moneda": {
            "type": "string",
            "description": "La moneda del gasto (ISO 4217, la de la cuenta publicitaria). Nunca sumes gastos de monedas distintas."
          },
          "zonaHoraria": {
            "type": "string",
            "description": "La zona horaria IANA con que Meta cortó este día."
          },
          "gasto": {
            "type": "string",
            "description": "Gasto estimado del día según Meta, decimal en texto en 'moneda' (por ejemplo \"15990\" o \"12.34\"). Es una métrica de entrega publicitaria, NO un comprobante: no es lo facturado ni lo cobrado, y no incluye impuestos."
          },
          "impresiones": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991,
            "description": "Veces que se mostraron los anuncios ese día."
          },
          "alcance": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "Personas únicas (cuentas del Centro de cuentas) que vieron los anuncios ese día, estimado por Meta. NO se suma entre días ni entre campañas: una persona puede repetirse. null si Meta no lo informó; null no es cero."
          },
          "clics": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "Clics de todo tipo según Meta. null si no lo informó."
          },
          "clicsEnlace": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "Clics en el enlace del anuncio según Meta (inline_link_clicks). Es una métrica de interacción, no una conversión ni una venta. null si no lo informó."
          },
          "diaCerrado": {
            "type": "boolean",
            "description": "false si al leerlo el día todavía no terminaba en la zona de la cuenta: sus cifras pueden crecer."
          },
          "versionApi": {
            "type": "string",
            "description": "La versión de la Marketing API con que se leyó la fila (por ejemplo 'v26.0')."
          },
          "sincronizadoEn": {
            "type": "string",
            "description": "Cuándo guardó Connect esta versión de la fila (ISO 8601, UTC). Meta puede corregir días de hasta 28 días atrás; la relectura reemplaza la fila."
          }
        },
        "required": [
          "fecha",
          "moneda",
          "zonaHoraria",
          "gasto",
          "impresiones",
          "alcance",
          "clics",
          "clicsEnlace",
          "diaCerrado",
          "versionApi",
          "sincronizadoEn"
        ],
        "additionalProperties": false
      },
      "description": "Un día por fila, del más reciente al más antiguo: el total de la cuenta publicitaria ese día."
    },
    "cobertura": {
      "type": "object",
      "properties": {
        "desde": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "Primer día (AAAA-MM-DD, zona de la cuenta) desde el que están guardados los dos niveles. null si nunca se sincronizó."
        },
        "hasta": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "Último día leído (AAAA-MM-DD). Puede ser hoy: las filas con 'diaCerrado' en false todavía pueden crecer."
        },
        "completa": {
          "type": "boolean",
          "description": "true sólo si el histórico llegó al horizonte del conector (~13 meses), no quedó ningún tramo sin leer y la última sincronización no quedó a medias. En false, una lista vacía NO prueba que no hubo gasto: dilo así."
        },
        "diasSinLeer": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "desde": {
                "type": "string",
                "description": "Primer día del tramo (AAAA-MM-DD)."
              },
              "hasta": {
                "type": "string",
                "description": "Último día del tramo (AAAA-MM-DD)."
              },
              "motivo": {
                "type": "string",
                "description": "Por qué no se leyó: 'demasiados_datos', 'datos_ilegibles' o 'agrupada'."
              }
            },
            "required": [
              "desde",
              "hasta",
              "motivo"
            ],
            "additionalProperties": false
          },
          "description": "Tramos dentro de la cobertura que no se pudieron leer: ahí el gasto es DESCONOCIDO, no cero."
        },
        "pendiente": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "presupuesto",
                "error_transitorio"
              ]
            },
            {
              "type": "null"
            }
          ],
          "description": "Si la última sincronización terminó con trabajo pendiente: 'presupuesto' (quedó historia por leer) o 'error_transitorio' (Meta limitó o no respondió). null si terminó todo lo que tenía."
        },
        "sincronizadoEn": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "Cuándo terminó la última sincronización que guardó datos (ISO 8601, UTC). null si nunca."
        }
      },
      "required": [
        "desde",
        "hasta",
        "completa",
        "diasSinLeer",
        "pendiente",
        "sincronizadoEn"
      ],
      "additionalProperties": false,
      "description": "Qué cubre lo guardado. Dentro de [desde, hasta], un día SIN fila significa que Meta no informó entrega ese día (gasto cero), salvo que caiga en 'diasSinLeer'. Fuera de la cobertura, el gasto es desconocido."
    },
    "cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Puntero a la página siguiente. Si viene distinto de null hay más filas: vuelve a llamar reenviándolo tal cual en 'cursor'. Un null significa que no queda nada por traer."
    }
  },
  "required": [
    "cuenta",
    "filas",
    "cobertura",
    "cursor"
  ],
  "additionalProperties": false
}