Conectores comunitarios de código abierto

En el repositorio de Data Studio de GitHub puedes consultar todos los conectores comunitarios de código abierto y publicar los tuyos.

Estos complementos son un ejemplo de los distintos casos prácticos y de las recomendaciones que deberías seguir; consultar el código te servirá para entender mejor los conectores comunitarios. Si lo deseas, también puedes implementarlos y usarlos en Data Studio.

Publicar conectores propios como conectores comunitarios de código abierto

Si quieres publicar un conector como conector comunitario de código abierto, debes cumplir los siguientes requisitos antes de enviar la solicitud de extracción.

  1. Añade un archivo readme.md a tu código. Para ver un ejemplo, consulta el archivo readme de las descargas de NPM. En este documento se debe explicar cómo los usuarios pueden implementar el conector y usarlo.
  2. Añade comentarios JSDoc.
  3. El archivo de manifiesto debe contener valores de las propiedades siguientes:
    • shortDescription
    • authType
    • supportUrl
    • feeType
  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.
  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 [].
  6. Si el conector tiene un esquema fijo, crea una plantilla de informe para tu conector y añádela al archivo de manifiesto.
  7. 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.
  8. Asegúrate de cumplir con las condiciones de servicio de las galerías de Data Studio (contrato para la parte que publica productos en las galerías).

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

Publicar conector comunitario de código abierto