Enviar subidas de POM Forms a Google Drive

Un campo Google Drive Upload envía los archivos de los visitantes a una carpeta disponible para la cuenta de Google conectada. Úsalo cuando el flujo de trabajo aprobado sea dueño de sus archivos en Drive, en lugar de tratarlos como subidas locales de POM Forms.

Requisitos

Prepara:

  • Acceso de administrador de WordPress
  • Un proyecto de Google Cloud
  • La API de Google Drive habilitada en ese proyecto
  • Un cliente OAuth 2.0 con tipo de aplicación Web application
  • Una cuenta de Google con permiso para añadir archivos a la carpeta de destino
  • El ID de la carpeta de destino

Las referencias actuales de Google cubren la Drive API, el OAuth para aplicaciones de servidor web, las subidas a Drive y los límites de uso.

Crear el cliente OAuth

  1. Abre Google Cloud Console y selecciona el proyecto previsto.
  2. Habilita Google Drive API.
  3. Configura la información de consentimiento de Google Auth Platform requerida por el proyecto.
  4. Crea un cliente OAuth 2.0.
  5. Selecciona Web application.
  6. En WordPress, abre Settings → POM Theme → Integrations → Google Drive.
  7. Copia la Authorized redirect URI exacta que muestra POM.
  8. Añade esa URI entre las URI de redireccionamiento autorizadas del cliente de Google.
  9. Copia el ID de cliente y el secreto de cliente.

La URI de redireccionamiento debe coincidir exactamente. Usa el valor mostrado por el sitio de producción al conectar producción.

Conectar la cuenta de Google

  1. Vuelve a Settings → POM Theme → Integrations → Google Drive.
  2. Introduce OAuth Client ID.
  3. Introduce OAuth Client Secret.
  4. Guarda los ajustes del tema.
  5. Elige Connect Google Drive.
  6. Inicia sesión con la cuenta que debe recibir las subidas del formulario.
  7. Aprueba el permiso de Drive solicitado.
  8. Vuelve a WordPress y elige Test connection.

La pantalla también ofrece Reconnect account y Disconnect. En una instalación multisitio, configura la conexión en el sitio que es dueño del formulario.

Mantén el secreto de cliente en privado. No lo pongas en un campo de formulario, página, repositorio de código, captura de pantalla ni mensaje de soporte.

Encontrar el ID de la carpeta

Abre la carpeta de destino en Google Drive. La URL de una carpeta se parece a:

https://drive.google.com/drive/folders/1AbCDefGhIjKlMnOpQrStUvWxYz

Copia únicamente:

1AbCDefGhIjKlMnOpQrStUvWxYz

La cuenta conectada debe poder añadir archivos a esa carpeta.

Añadir el campo de subida

  1. Abre Forms → All Forms y selecciona el formulario.
  2. En Builder, añade Google Drive Upload.
  3. Configura Label, Name y Upload Prompt.
  4. Pega el ID de la carpeta en Drive Folder ID.
  5. Decide si el campo es Required.
  6. Configura Multiple Files cuando corresponda.
  7. Establece las restricciones necesarias de tamaño, tipos MIME y número de archivos.
  8. Opcionalmente, configura:
    • Prepend to File Name
    • Append to File Name
    • Remove Original File Name
  9. Guarda el formulario.

El campo solo está disponible cuando Google Drive está configurado. El builder actual usa un ID de carpeta manual; no ofrece un selector de carpetas.

Establecer límites seguros

El máximo predeterminado para un campo de Google Drive es de 100 MB. Un campo puede establecer un tamaño más restrictivo y una lista de MIME permitidos. Si la lista está vacía, POM sigue bloqueando extensiones peligrosas de scripts o ejecutables.

También se aplican la disponibilidad del servicio y las cuotas de Google Drive. Mantén los límites tan ajustados como permita el flujo de trabajo y explícalos en el texto de ayuda del campo.

Las subidas a Drive son independientes del almacenamiento local de Store Uploaded Files. Cuando el almacenamiento de envíos de POM está habilitado, la entrada almacenada puede incluir la información verificada del archivo de Drive y el enlace de visualización. Los archivos de Drive permanecen remotos y no se adjuntan a los correos de notificación como archivos locales.

Verificar antes del lanzamiento

  1. Ejecuta Test connection.
  2. Abre el formulario activo sin haber iniciado sesión.
  3. Sube un archivo pequeño permitido.
  4. Confirma que aparece en la carpeta de Drive seleccionada.
  5. Confirma que el nombre del archivo enviado se representa correctamente en cualquier notificación requerida.
  6. Cuando el almacenamiento de envíos esté habilitado, revisa la entrada en Forms → Submissions.
  7. Prueba un tipo prohibido, un archivo demasiado grande y varios archivos cuando estén habilitados.
  8. Repite desde el dominio de producción.

Resolver problemas comunes

La prueba de conexión falla

Confirma que la API de Drive está habilitada, que la URI de redireccionamiento es exacta y que el cliente OAuth guardado pertenece al mismo proyecto de Google Cloud. Usa Reconnect account después de corregir las credenciales.

No se puede usar la carpeta

Copia de nuevo el ID de la carpeta y confirma que la cuenta conectada puede añadir un archivo normal a esa carpeta.

El archivo es rechazado

Revisa el tamaño máximo del campo, los tipos MIME y el número de archivos. Prueba con un único archivo pequeño permitido antes de ampliar cualquier límite.

La subida no se completa

Comprueba la conexión de Drive y el estado del servicio de Google; a continuación, prueba sin extensiones del navegador ni políticas de red que puedan bloquear el tráfico de Google Drive.

Los archivos remotos de Drive no se eliminan automáticamente cuando una acción posterior del formulario falla. Incluye Drive en el proceso de acceso y retención de la organización.