Antes de lanzar tu acción para los usuarios, debes probarla a fondo, especificar las plataformas de destino, las ubicaciones y los dispositivos, y verificar que cumpla con las políticas de Google para las Acciones. En esta página, se proporciona una descripción general de las tareas que debes realizar mientras te preparas para enviar tu acción a revisión y obtener la aprobación para publicarla en los canales beta o de producción.
Verifica si hay incumplimientos de políticas
Verifica que tu acción cumpla con las políticas de Actions on Google. En general, sigue estos lineamientos para tu contenido:
- Sé específico: Los usuarios deben poder invocar tu acción específicamente. No seas demasiado amplio ni general cuando elijas un nombre visible o una pronunciación. Por ejemplo, usa "Hablar con WeatherApp para verificar el clima de [city]" en lugar de "Consulta el clima de [city]" como una frase de acción. Sigue los lineamientos para proporcionar buenas frases de acción.
- Evita el contenido prohibido: A menos que el objetivo sea científico, artístico, documental o educativo, las Acciones con contenido sexual, violento, ilegal o que incite al odio incumplen las políticas de Actions on Google. También se rechazarán o eliminarán las acciones que fomenten el bullying o el acoso.
- Respeta los derechos de autor y la propiedad intelectual: Asegúrate de tener los derechos adecuados para usar el contenido que ofrece tu Acción.
- Sé honesto: No engañes ni engañes a los usuarios con declaraciones falsas.
- Proteger la privacidad y la seguridad de los usuarios: Sé transparente en la forma en que administras los datos de los usuarios, los transmites de forma segura y proporcionas una política de privacidad.
- No escuches a los usuarios sin previo aviso: Los usuarios deben comprender cuándo la acción espera su entrada. Dejar el micrófono abierto sin pedirle al usuario es un error común que se describe en nuestras políticas. Asegúrate de que tu acción notifique al usuario cuando esté esperando un comando para reducir el riesgo de que se rechace.
- Revisa los nombres visibles y de la invocación: Asegúrate de que el nombre de la invocación sea coherente con el nombre visible que aparece en la página del directorio de Asistente. Asegúrate de que ambos nombres sean lo suficientemente específicos para que los usuarios puedan invocarlos con facilidad. Los nombres de invocación y visualización también deben seguir las políticas de Actions on Google.
Consulta la lista completa de políticas y asegúrate de cumplir con ellas para agilizar la revisión y aprobación de tu acción.
Establecer nombre visible
El nombre visible define cómo los usuarios invocan explícitamente tu acción. Este nombre también se usa en el directorio de Asistente.
Para establecer tu nombre visible, sigue estos pasos:
- Ve a Develop > Invocation > Settings.
- Ingresa el nombre visible de tu acción.
- Haz clic en el ícono de Reproducir play_circle_filled para escuchar cómo se pronuncia el nombre.
Cómo cambiar tu nombre visible
Puedes cambiar el nombre visible de tu acción en cualquier momento. Sin embargo, esta pasará por otro proceso de revisión completo antes de que los usuarios puedan invocarla con el nombre nuevo.
Opcional: Especifique la segmentación geográfica
De forma predeterminada, la acción está disponible en todas las regiones, siempre y cuando la configuración regional del dispositivo del usuario esté configurada en un idioma "inglés" (por ejemplo, inglés estadounidense o inglés británico).
El parámetro de configuración Segmentación geográfica controla la disponibilidad regional de tu acción.
Obtén más información sobre la publicación localizada.
Opcional: Especifica las capacidades de la superficie
La acción puede aparecer en una variedad de plataformas compatibles con Asistente, como teléfonos (iOS y Android) y pantallas inteligentes.
Las capacidades de Surface te permiten controlar si los usuarios pueden o no invocar tu acción en función de la superficie que usan. Si los usuarios intentan invocar tu acción en una plataforma no compatible, recibirán un mensaje de error en el que se les indicará que su dispositivo no es compatible.
Obtén más información sobre las capacidades de la superficie.
Opcional: Especifica las opciones de Interactive Canvas
Si tu acción usa Interactive Canvas, debes habilitar y establecer algunas opciones en Develop > Interactive Canvas en el panel de navegación izquierdo.
- Habilita la opción para usar Interactive Canvas con tu acción.
- Ingrese la URL de la aplicación web que aloja las imágenes de su acción.
Cómo realizar pruebas con el simulador
Antes de lanzar tu acción, usa el simulador para probar la experiencia del usuario de tu acción y asegúrate de que todo funcione.
Verifica los siguientes errores y incumplimientos comunes:
- El transporte de webhook debe ser seguro: Verifica que uses la encriptación HTTPS (TLS) en el transporte para tus webhooks.
- Verifica solicitudes de webhook: Asegúrate de firmar tus solicitudes de webhook con el SDK de Actions y de verificarlas en el webhook.
- Prueba el nombre de tu acción: Asegúrate de que el nombre de la acción que hayas establecido active la acción de manera coherente. Usa un dispositivo de hardware o el simulador web y di tu nombre de manera repetida en diferentes situaciones del mundo real (es decir, con ruido de fondo o a diferentes distancias del dispositivo). Si es posible, pídeles a las personas de diferentes géneros o con diferentes acentos que invoquen tu acción. Si el nombre de tu invocación no se reconoce de manera coherente, te recomendamos que lo cambies.
- Prueba en dispositivos físicos: Aunque el simulador web es ideal para probar una acción con rapidez mientras desarrollas, siempre debes probar la invocación y los diálogos en dispositivos reales. Esta es la mejor manera de comprender cómo funciona tu acción en la vida real y te ayuda a mejorar la experiencia del usuario.
Para probar el borrador actual de tu proyecto de Actions, ve a Test en la navegación principal. Esto garantiza que se use la versión actual de tu acción en el simulador, la consola y los dispositivos compatibles con Asistente.
Obtén más información sobre el simulador de Actions.
Lanza tu proyecto
Una vez que hayas probado el borrador de tu proyecto y estés satisfecho con los resultados, puedes implementarlo en los canales alfa o beta para pruebas adicionales. Como alternativa, puedes enviarla a revisión y publicarla para los usuarios del Asistente.
En la sección Implementar > Versión de la consola, encontrarás las siguientes opciones para las actualizaciones:
- Alfa: Se usa mejor para iteraciones de prueba rápida. Tu acción se distribuye a un pequeño conjunto de usuarios que defines sin pasar por una revisión completa de Google.
- Beta: Es la mejor opción para distribuir tu acción a un conjunto limitado de usuarios después de una revisión completa de Google. Debido a que la acción aprobó una revisión completa, puedes elegir que sea pública en cualquier momento.
- Producción: Envía tu acción para que se revise en su totalidad en Google. Una vez que se apruebe, la acción estará disponible para los usuarios de Asistente.
Obtén más información sobre las versiones.
Estado de implementación
En la siguiente tabla, se describen los diferentes estados de implementación de un proyecto y los pasos adicionales que puedes seguir:
| Estado de implementación | Descripción |
|---|---|
| En proceso de revisión |
Cuando envías una implementación nueva, esta pasa por un proceso de aprobación. Los revisores prueban su acción y verifican que usted no haya incumplido ninguna política. Recibirás un correo electrónico cuando se complete una revisión, en el que se te informa si se aprobó o no la implementación. |
| Se rechazó | El estado denegado significa que la implementación no se aprobó. Deberías recibir un correo electrónico en el que se explique el motivo del rechazo. También puedes hacer clic en ¿Por qué? junto al estado Rechazado en la consola para ver la justificación del rechazo. |
| Implementado | Una acción aprobada que está activa y se publica para los usuarios. Puedes “quitar” una versión implementada en cualquier momento desde la consola. |
| Approved | Una acción que pasó la revisión y que no se está publicando actualmente para los usuarios. Cuando una acción ya pasó por la revisión, se puede publicar en cualquier momento desde la consola, sin pasar por una revisión adicional. |
| En mal estado | Google envía solicitudes con frecuencia al extremo de tu acción y comprueba que obtengamos una respuesta adecuada. Si detectamos que el extremo no está disponible o no responde, dejaremos de publicar tu acción para los usuarios temporalmente. En este caso, recibirás un correo electrónico en el que se te informará que tu extremo está en mal estado y tu acción pasó a un estado En mal estado. Tan pronto como detectemos que tu extremo vuelve a responder, reanudaremos la publicación de tu acción para los usuarios. Cuando esto suceda, recibirás un correo electrónico y el estado de la implementación debería ser Implementada. |
| Eliminado | Google puede eliminar tu acción si detectamos un incumplimiento de política después de la implementación. Si esto sucede, recibirás un correo electrónico y también verás un banner en la consola para desarrolladores en el que se te informará que se quitó tu acción. Puedes hacer clic en ¿Por qué? para ver los motivos y ver tus opciones a fin de corregir el incumplimiento de política o apelar la decisión. |
Control de versiones del proyecto
Con el tiempo, es posible que quieras actualizar la información sobre tu acción. Algunos cambios en una acción generan una versión nueva del proyecto. Cada versión nueva debe volver a enviarse y pasar por el proceso de revisión completo antes de que se lance la acción actualizada y se entregue al público.
Para realizar cualquiera de los siguientes cambios, debes volver a enviar una acción para su revisión:
- Se realiza un cambio en la consola para modificar la descripción, el ícono y otros metadatos del proyecto.
- Con Actions Builder o el SDK de Actions, realizó cambios en su proyecto de Actions.
- Con el SDK de Actions heredado, hiciste cambios en tu paquete de Acciones.
- Con Dialogflow, hiciste cambios en tu agente de Dialogflow.
No necesita volver a enviar su proyecto para las siguientes situaciones:
- Solo realizaste cambios en tu código en un webhook alojado a nivel externo, el editor de webhook intercalado en Actions Builder o en el editor directo de Dialogflow.
- Usas plantillas y actualizaste los datos de tu plantilla mediante la carga de contenido a Hojas de cálculo de Google.
Si quieres enviar tu acción actualizada para su revisión, ve a Implementar > Versión y haz clic en Crear una versión. Si se aprueba, se anulará la implementación de la versión anterior y la última versión estará disponible para los usuarios de Asistente.
Cómo hacer un seguimiento de las versiones y modificarlas
Para realizar un seguimiento de tus versiones y obtener información sobre ellas, ve a Implementar > Versión y haz clic en la versión sobre la que deseas obtener información.
En la tabla, se muestra la fecha de la última modificación y el estado actual de la versión. Puedes realizar cambios específicos en el estado, según el estado actual de la versión.
- Si una versión está en proceso de revisión, puedes seleccionar retirar la versión de revisión.
- Si se implementa una versión, puedes seleccionar Anular la implementación de la producción para quitar tu acción.
- Cuando se anula la implementación de una versión anterior, puedes seleccionar Implementar en producción para volver a esa versión.