Requisitos del Conector de socios

Revisa la descripción general de la publicación para comprender los beneficios y el nivel de compromiso requerido para publicar un conector. Para publicar un conector de socio, tu conector debe cumplir con todos los requisitos que se describen a continuación.

Apps Script

Antes de enviar tu conector para su revisión, completa los siguientes pasos en Apps Script:

  1. Comparte el acceso de lectura de tu proyecto de Apps Script con los siguientes usuarios:
  2. Crea una implementación llamada Production y actualiza la implementación de Production a la versión del código que deseas publicar.
  3. Confirma que actualizaste la implementación de Production a la versión de código que deseas que se revise.
  4. Confirma que el archivo de manifiesto esté visible en Apps Script. A la izquierda, haz clic en Configuración del proyecto . Selecciona la casilla de verificación Mostrar el archivo de manifiesto "appsscript.json" en el editor.

Manifiesto

Incluye lo siguiente en el manifiesto de tu conector y confirma que tu proyecto de Apps Script esté configurado para mostrar el archivo de manifiesto appsscript.json en el editor.

Consulta la referencia del manifiesto del conector de comunidad para obtener más información.

dataStudio

  1. description debe proporcionar información e instrucciones para comprender los conceptos básicos del conector y cómo usarlo. Se rechazarán los conectores con descripciones vagas e incompletas.
  2. addOnUrl debe ser una página alojada dedicada a tu conector, preferentemente alojada en tu propio dominio. La página debe incluir lo siguiente:
    • Una Política de Privacidad y unas Condiciones de Uso, o un vínculo a este contenido, en el mismo dominio que el addOnUrl
    • Detalles que el usuario deberá conocer para usar tu conector.
    • Es el vínculo de registro, si se requiere una cuenta para usar tu conector.
    • El contenido debe alojarse, de preferencia, en tu dominio. No se permite el alojamiento en https://sites.google.com/.
    • Consulta las páginas de ejemplo de socios existentes: Funnel, Supermetrics y CallRail.
  3. supportUrl debe ser una página alojada para obtener asistencia para tu conector. No puede ser un vínculo de correo electrónico o mailto.
  4. logoUrl debe apuntar a una imagen estática alojada bajo tu control. No puedes usar imágenes que se publican en los servicios de Google en dominios como *.gstatic.com, *.ggpht.com, *.google.com y *.googleusercontent.com. Se acepta usar Google Cloud Storage para publicar imágenes desde el dominio *.googleapis.com, y es una opción de hosting recomendada.
    • Se rechazarán los conectores con íconos animados. Usa imágenes estáticas.
    • Se recomienda usar, como mínimo, una imagen de 48 × 48 píxeles.
    • Evita las imágenes que solo contienen texto y que son difíciles de leer cuando se reducen a 48 x 48 píxeles.
  5. Completa la propiedad sources con todas las fuentes a las que se conecta tu conector. Consulta Fuentes en la referencia del manifiesto para obtener más detalles.
    • Puedes ver la lista existente de fuentes en el repositorio del Registro de datos. Si la fuente a la que te conectas no existe en el repositorio, envía una solicitud de extracción al repositorio del Registro de datos para agregarla. Tu conector no superará el proceso de revisión si las fuentes de tu manifiesto no existen en el repositorio.
    • Son metadatos adicionales para el conector que se indexarán para la función de búsqueda en la galería. Tu conector aparecerá en los resultados de la búsqueda cuando los usuarios busquen una fuente específica en la galería.
  6. Proporciona valores para shortDescription, authType, feeType, privacyPolicyUrl y termsOfServiceUrl.
  7. name debe representar directamente el propósito del conector. Un nombre claro ayudará a los usuarios a determinar si tu conector satisface sus necesidades. Evita usar la palabra conector en el nombre, ya que los usuarios ya saben que están viendo un conector.
    • No incluyas caracteres especiales o no visibles con la intención de llamar la atención sobre el conector o alterar su posición.
  8. No uses nombres abreviados para Data Studio en ninguna parte del manifiesto (p. ej., GDS, DS, etcétera).
  9. No se permiten emojis en ningún campo del manifiesto (description, shortDescription, name, etc.). En general, no incluyas caracteres especiales o no visibles con la intención de llamar la atención sobre tu conector.
  10. Si tu conector tiene un esquema fijo, crea una plantilla de informe para tu conector y agrégala al manifiesto. Habilita la opción Compartir por vínculo para el informe.

urlFetchWhitelist

  1. Limita la cantidad de extremos a los que llama UrlFetchApp a los que son absolutamente necesarios para la funcionalidad del conector. Agrega la propiedad urlFetchWhitelist al nivel raíz de tu manifiesto. Consulta la referencia de urlFetchWhitelist para obtener más información.
    • Incluye todos los extremos que se usan con el servicio UrlFetchApp.
    • Si tu conector no recupera recursos con el servicio UrlFetchApp, establece urlFetchWhitelist en una lista vacía [].
    • Si tu conector no se conecta a un conjunto de extremos fijos o el prefijo del extremo varía, omite la propiedad urlFetchWhitelist y proporciona detalles en el campo de formulario Excepción para urlFetchWhitelist cuando envíes la solicitud de revisión.

oauthScopes

  1. Configura permisos de OAuth explícitos en el manifiesto. Se rechazarán los conectores sin permisos de OAuth explícitos.

Conector

  1. Si el usuario necesita una cuenta para usar el conector, asegúrate de que el conector description o el vínculo addOnUrl proporcionen instrucciones para ayudar al usuario a crear una.
  2. Tu conector no puede estar en estado beta o sin terminar. Debes publicar un conector completo y funcional. Siempre puedes actualizar tu conector, pero la implementación de producción que se lanza para los usuarios debe probarse y tener todas las funciones.
  3. Proporciona mensajes de error significativos y prácticos a los usuarios cuando se encuentren con un error interno del conector. Esto incluye los casos en los que un usuario proporciona una entrada no válida o en blanco durante la configuración.
  4. Los vínculos shortDescription, description y addOnUrl, el vínculo supportUrl y la página de OAuth (si corresponde) no deben tener errores ortográficos ni gramaticales.
  5. shortDescription no puede contener URLs.
  6. Usar los métodos de autenticación proporcionados por getAuthType() No solicites credenciales a través de getConfig().
  7. Completa el proceso de verificación del cliente de OAuth. La verificación es obligatoria para todos los conectores, independientemente del método de autenticación en getAuthType(). El proceso de verificación es diferente del proceso de revisión del conector y lo lleva a cabo un equipo independiente, no Data Studio. Consulta las Preguntas frecuentes sobre la verificación de la API de OAuth para obtener más información. Se rechazará tu conector si no se completa el proceso de verificación del cliente de OAuth.
    • Durante el proceso de verificación de OAuth, agrega los permisos de OAuth obligatorios de tu conector como parte de la configuración de la pantalla de consentimiento de OAuth. Si no agregas todos los permisos obligatorios, es posible que pases el proceso de verificación de OAuth, pero tu conector seguirá mostrando la pantalla de app no verificada. Esto provocará un error en el proceso de verificación del conector de socios.
      Autoriza y prueba tu conector con una cuenta nueva después de aprobar el proceso de verificación de OAuth para asegurarte de que no se muestre la pantalla de app no verificada a tus usuarios.
  8. Asegúrate de cumplir con las Condiciones del Servicio de las Galerías de Data Studio (Remitente).

Una vez que cumplas con todos los requisitos, haz clic en el siguiente botón para solicitar una revisión de tu conector:

Publica tu conector de socio