Requisitos del Conector de socios

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

Apps Script

Antes de enviar el conector a revisión, completa lo siguiente en Apps Script:

  1. Comparte el acceso de lectura de tu proyecto de Apps Script con lo siguiente:
  2. Crea una implementación llamada Production y actualiza la implementación Production a la versión de código que deseas publicar.
  3. Confirma que actualizaste la implementación de Production a la versión de código que deseas revisar.
  4. Confirma que el archivo de manifiesto sea 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.

Manifest

Incluye lo siguiente en el manifiesto del 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 la comunidad para obtener más información.

dataStudio

  1. description debe proporcionar información e instrucciones para una comprensión básica del conector y de cómo usarlo. Se rechazarán los conectores con descripciones incompletas y imprecisas.
  2. addOnUrl debe ser una página alojada dedicada sobre tu conector, preferentemente alojada en tu propio dominio. La página debe incluir lo siguiente:
    • Una Política de Privacidad y las Condiciones de Uso o un vínculo a este contenido, en el mismo dominio que addOnUrl.
    • Detalles que el usuario deberá conocer para usar el conector
    • El vínculo de registro, si se requiere una cuenta para usar el conector.
    • Contenido alojado preferentemente en tu dominio. No se permite alojar en https://sites.google.com/.
    • Consulta páginas de ejemplo de socios existentes: Funnel, Supermetrics y CallRail.
  3. supportUrl debe ser una página alojada a fin de obtener asistencia para tu conector. Este 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 entregan los servicios de Google en dominios como *.gstatic.com, *.ggpht.com, *.google.com o *.googleusercontent.com. El uso de Google Cloud Storage para entregar imágenes desde el dominio *.googleapis.com es aceptable y es una opción de hosting recomendada.
    • Se rechazarán los conectores con íconos animados. Usa imágenes estáticas.
    • Se recomienda usar una imagen de 48 × 48 píxeles como mínimo.
    • Evita las imágenes de solo texto que sean difíciles de leer cuando se reduzcan a 48 x 48 píxeles.
  5. Propaga la propiedad sources con todas las fuentes a las que se conecta tu conector. Para obtener más detalles, consulta la referencia de Fuentes en el manifiesto.
    • Puedes ver la lista existente de fuentes en el Repositorio de 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 de Data Registry para agregar la fuente. El conector no pasará el proceso de revisión si las fuentes de tu manifiesto no existen en el repositorio.
    • Estos son los metadatos adicionales del 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, dado 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 de alterar su posición.
  8. No uses nombres cortos para Looker 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étera). En general, no incluyas caracteres especiales o no visibles con la intención de atraer la atención a tu conector.
  10. Si tu conector tiene un esquema fijo, crea una plantilla de informe para el conector y agrégala al manifiesto. Habilita Uso compartido mediante vínculos para el informe.

urlFetchWhitelist

  1. Limita la cantidad de extremos a los que UrlFetchApp llama a aquellos que sean 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, configura urlFetchWhitelist como 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 del formulario Excepción para urlFetchWhitelist cuando envíes la solicitud de revisión.

oauthScopes

  1. Establece permisos de OAuth explícitos en el manifiesto. Se rechazarán los conectores sin alcances 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. El conector no puede estar en estado Beta o sin terminar. Debes publicar un conector completo y funcional. Siempre puedes actualizar el conector, pero la implementación de producción que se lanza a los usuarios se debe probar y completar las funciones.
  3. Proporciona mensajes de error prácticos y significativos a los usuarios cuando encuentren un error interno del conector. Esto incluye los casos en los que un usuario proporciona una entrada no válida o en blanco en la configuración.
  4. shortDescription, description, addOnUrl, vínculo supportUrl y página de OAuth (si corresponde) no deben tener errores ortográficos ni gramaticales.
  5. shortDescription no puede contener URLs.
  6. Usa los métodos de autenticación que proporciona getAuthType(). No solicites credenciales a través de getConfig().
  7. Completa el proceso de verificación del cliente OAuth. La verificación es obligatoria para todos los conectores, sin importar el método de autenticación en getAuthType(). El proceso de verificación es diferente de la revisión del conector, y lo controla otro equipo, no Looker Studio. Consulta las Preguntas frecuentes de verificación de la API de OAuth para obtener más información. Tu conector se rechazará 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 necesarios del conector como parte de la configuración de la pantalla de consentimiento de OAuth. Si no agregas todos los alcances obligatorios, puedes pasar el proceso de verificación de OAuth, pero el conector seguirá mostrando la pantalla de la app sin verificar. Esto hará que falle el proceso de verificación del conector de socio.
      Autoriza y prueba tu conector con una cuenta nueva después de pasar el proceso de verificación de OAuth para asegurarte de que no se muestre Pantalla de la app sin verificar a los usuarios.
  8. Asegúrate de cumplir con las Condiciones del Servicio de Galerías de Looker Studio (Remitente).

Una vez que hayas cumplido con todos los requisitos, haz clic en el siguiente botón para solicitar una revisión del conector:

Publica tu conector de socios