Importar items mediante inserción, upsert o reemplazo de registros vigentes.

Carga un lote en una sola llamada, y su comportamiento cambia por completo según mandes keyField o no. Con keyField hace upsert: la fila que ya exista con ese valor se actualiza en vez de duplicarse — es lo que quieres para espejar un catálogo o un inventario y poder reejecutarlo. Sin keyField inserta todo tal cual, sin deduplicar: repetir la llamada crea los items otra vez. Con mode=replace_active, el archivo completo pasa a ser la versión vigente: primero se valida, luego se crean o actualizan sus filas y se archivan las ausentes dentro de una única transacción. keyFields permite una identidad compuesta; la confirmación debe reenviar el previewToken de la vista previa y declarar allowHighArchive=true cuando archivará 30 % o más. Este modo no admite colecciones globales, internas o protegidas.