Requisitos de los conectores de partners

En primer lugar, te recomendamos que consultes el artículo de introducción a la publicación de conectores comunitarios para conocer las ventajas de publicar conectores y el compromiso que requiere por tu parte. Si quieres publicar un conector de partner, debes cumplir los requisitos siguientes antes de enviar la solicitud de revisión.

Apps Script

  1. Comparte el acceso de visualización de tu proyecto de Apps Script con estas dos direcciones:
  2. Crea una implementación y asígnale el nombre Production. A continuación, modifica esta implementación Production para que contenga la versión del código que quieras publicar.
  3. Si has actualizado el código después de crear la implementación Production, asegúrate de elegir la versión correcta para esa implementación antes de enviar el conector.

Archivo de manifiesto

Debes incluir lo siguiente en el archivo de manifiesto del conector. Consulta la referencia del archivo de manifiesto para obtener más información sobre cada una de sus propiedades.

  1. Incluye en description toda la información y las instrucciones necesarias para comprender el conector y saber usarlo. Los conectores con descripciones vagas e incompletas se rechazarán durante la revisión.
  2. addOnUrl debe ser una página alojada específica, preferiblemente en tu propio dominio, con información sobre el conector.
    • Esta página debe contener o enlazar a tu Política de privacidad y Términos de uso alojados en el mismo dominio que el addOnUrl.
    • Esta página debe contener todos los detalles que el usuario necesitará saber para usar el conector.
    • Si los usuarios necesitan crear una cuenta para usar el conector, el enlace de registro debe estar disponible en esta página.
    • La página no se puede alojar en https://sites.google.com/.
    • Consulta las páginas de ejemplo de estos partners: Funnel, Supermetrics y CallRail.
  3. supportUrl debe ser una página alojada específica a la que puedan acudir los usuarios para obtener asistencia en relación con el conector. No puede ser un correo electrónico ni un enlace de tipo mailto.
  4. Rellena la propiedad sources con todas las fuentes a las que se conecta tu conector. Consulta más información en la referencia de fuentes en los archivos de manifiesto.
    • Puedes ver la lista de fuentes en nuestro repositorio de registro de datos. Si la fuente a la que te conectas no está en el repositorio, envía una solicitud de obtención al repositorio de registro de datos para añadir la fuente. El conector no superará el proceso de revisión si las fuentes del archivo de manifiesto no están en el repositorio.
    • Se trata de metadatos adicionales del conector que se indexarán para usarlos en la función de búsqueda de la galería. El conector se mostrará en los resultados de búsqueda cuando los usuarios busquen una fuente de datos específica en la galería.
    • La galería permitirá a los usuarios descubrir conectores según las fuentes de datos proporcionando una interfaz en la que encontrarán conectores por fuente de datos.
  5. Limita el número de puntos de conexión de tu conector a los que llama UrlFetchApp al mínimo necesario para que el conector funcione correctamente. Añade la propiedad urlFetchWhitelist al nivel raíz del archivo de manifiesto. Consulta más información en la referencia de urlFetchWhitelist.
    • Esta propiedad debe contener todas las URL a las que se conecta tu conector mediante la llamada UrlFetchApp.
    • Si el conector no ejecuta una llamada UrlFetchApp, haz que el valor de la propiedad sea una lista vacía [].
    • Si el conector no se conecta a un dominio fijo o el prefijo del punto de conexión varía, omite la propiedad urlFetchWhitelist del archivo de manifiesto.
  6. El archivo de manifiesto debe contener valores de shortDescription, authType, feeType, privacyPolicyUrl y termsOfServiceUrl.
  7. El nombre (name) del conector debe describir su función. De esta manera, los usuarios podrán identificar fácilmente el que necesitan y lo que hace.

Plantilla e informe

  1. Si el conector tiene un esquema fijo, crea una plantilla de informe para tu conector y añádela al archivo de manifiesto. Habilita la función de compartir el informe mediante enlace.
  2. Crea al menos un informe de muestra utilizando tu conector y envíalo a la galería de Data Studio. Este informe puede ser una réplica de tu informe de muestra o de otro informe que contenga funciones aún más amplias del conector.
    • Al añadir los informes de demostración, el conector podrá tener ciertas ventajas promocionales (mostrarse como destacado, aparecer en boletines, en publicaciones de blog, en casos de éxito, etc.).

Conector

  1. Si el usuario necesita una cuenta para utilizar el conector, asegúrate de que el conector description o el enlace addOnUrl contengan instrucciones para ayudar al usuario a crear una.
  2. El conector no puede estar sin terminar ni en fase beta. Debes publicar uno completo y que funcione. Siempre puedes actualizar el conector, pero la implementación de producción que se lanza para los usuarios debe estar probada y debe contar con todas las funciones.
  3. Incluye mensajes de error significativos que indiquen a los usuarios qué hacer cuando se produzca un error interno del conector, como cuando los usuarios introduzcan información no válida en la configuración o dejen en blanco algún campo.
  4. No debe haber errores ortográficos ni gramaticales en shortDescription, description, en los enlaces addOnUrl y supportUrl, ni en la página de OAuth del conector, si corresponde.
  5. Usa el método de autenticación adecuado en getAuthType(). No solicites credenciales a través de getConfig().
  6. Lleva a cabo el proceso de verificación del cliente OAuth. La verificación es obligatoria para todos los conectores, independientemente del método de autenticación usado en getAuthType(). El proceso de verificación lo gestiona otro equipo. Consulta más información en las preguntas frecuentes sobre la verificación de la API de OAuth. El conector no se publicará si el proceso de verificación del cliente de OAuth no se completa.
    • Durante el proceso de verificación de OAuth, añade los permisos de OAuth que requiera el conector como parte de la configuración de la pantalla de consentimiento de OAuth. Si no añades todos los permisos requeridos, es posible que superes el proceso de verificación de OAuth, pero el conector seguirá mostrando la pantalla de aplicación sin verificar. En consecuencia, no superarás el proceso de verificación de conectores de partners.
      Autoriza y prueba el conector con una cuenta nueva después de superar el proceso de verificación de OAuth para asegurarte de que la pantalla de aplicación sin verificar no se muestre a tus usuarios.
  7. Asegúrate de cumplir los Términos del Servicio de las Galerías de Data Studio (Remitente).

Cuando cumplas todos los requisitos, haz clic en el botón siguiente para solicitar que se revise tu conector.

Publicar conector de partner