Conditions requises pour les connecteurs partenaires

Consultez la section Vue d'ensemble de la publication pour comprendre les avantages et le niveau d'engagement requis pour la publication d'un connecteur. Pour que vous puissiez publier un connecteur partenaire, celui-ci doit répondre à toutes les exigences décrites ci-dessous.

Apps Script ;

Avant d'envoyer votre connecteur pour examen, procédez comme suit dans Apps Script:

  1. Partagez l'accès en lecture de votre projet Apps Script avec les éléments suivants :
  2. Créez un déploiement nommé Production et mettez-le à jour Production en fonction de la version de code que vous souhaitez publier.
  3. Confirmez que vous avez mis à jour le déploiement Production vers la version du code que vous souhaitez examiner.
  4. Vérifiez que le fichier manifeste est visible dans Apps Script. Sur la gauche, cliquez sur Paramètres du projet . Cochez la case Afficher le fichier manifeste "appsscript.json" dans l'éditeur.

Manifest

Incluez les éléments suivants dans le fichier manifeste de votre connecteur et vérifiez que votre projet Apps Script est configuré pour afficher le fichier manifeste appsscript.json dans l'éditeur.

Pour en savoir plus, consultez la documentation de référence du fichier manifeste du connecteur de communauté.

dataStudio

  1. description doit fournir des informations et des instructions permettant de mieux comprendre le connecteur et son utilisation. Les connecteurs dont les descriptions sont vagues et incomplètes seront refusés.
  2. addOnUrl devrait être une page hébergée dédiée au connecteur, de préférence hébergée sur votre propre domaine. Cette page doit inclure les éléments suivants :
    • Des Règles de confidentialité et des Conditions d'utilisation, ou un lien vers ce contenu, sur le même domaine que addOnUrl.
    • Informations dont l'utilisateur aura besoin pour utiliser le connecteur
    • Lien d'inscription, si un compte est nécessaire pour utiliser le connecteur.
    • Contenu hébergé de préférence sur votre domaine. L'hébergement sur https://sites.google.com/ n'est pas autorisé.
    • Consultez des exemples de pages de partenaires existants: Funnel, Supermetrics et CallRail.
  3. supportUrl devrait être une page hébergée permettant d'obtenir de l'aide pour votre connecteur. Il ne peut pas s'agir d'un e-mail ou d'un lien mailto.
  4. logoUrl doit pointer vers une image statique hébergée sous votre contrôle. Vous ne pouvez pas utiliser des images diffusées par les services Google sur des domaines tels que *.gstatic.com, *.ggpht.com, *.google.com ou *.googleusercontent.com. L'utilisation de Google Cloud Storage pour diffuser des images à partir du domaine *.googleapis.com est acceptable et constitue une option d'hébergement recommandée.
    • Les connecteurs avec des icônes animées seront refusés. Utilisez des images statiques.
    • Nous vous recommandons d'utiliser au minimum une image de 48 x 48 pixels.
    • Évitez les images textuelles uniquement difficiles à lire lorsqu'elles sont réduites au format 48 x 48 pixels.
  5. Renseignez la propriété sources avec toutes les sources auxquelles votre connecteur se connecte. Pour en savoir plus, consultez la documentation de référence sur les sources dans les fichiers manifestes.
    • Vous pouvez afficher la liste des sources existantes dans le dépôt Data Registry. Si la source à laquelle vous vous connectez n'existe pas dans le dépôt, envoyez une demande d'extraction au dépôt Data Registry pour ajouter la source. Votre connecteur échouera au processus d'examen si les sources de votre fichier manifeste n'existent pas dans le dépôt.
    • Il s'agit de métadonnées supplémentaires pour le connecteur qui seront indexées pour la fonctionnalité de recherche dans la galerie. Votre connecteur s'affiche dans les résultats de recherche lorsque les utilisateurs recherchent une source spécifique dans la galerie.
  6. Indiquez des valeurs pour shortDescription, authType, feeType, privacyPolicyUrl et termsOfServiceUrl.
  7. name doit représenter directement l'objectif du connecteur. En indiquant un nom clair, vous aiderez les utilisateurs à déterminer si votre connecteur répond à leurs besoins. Évitez d'utiliser le mot connecteur dans le nom, car les utilisateurs savent déjà qu'ils consultent un connecteur.
    • N'incluez pas de caractères spéciaux ou non visibles dans le but d'attirer l'attention sur le connecteur ou de le modifier.
  8. N'utilisez pas de noms abrégés pour Looker Studio dans le fichier manifeste (par exemple, GDS, DS, etc.).
  9. Les emoji ne sont autorisés dans aucun champ du fichier manifeste (description, shortDescription, name, etc.). En règle générale, n'incluez pas de caractères spéciaux ou non visibles dans le but d'attirer l'attention sur le connecteur.
  10. Si votre connecteur a un schéma fixe, créez un modèle de rapport pour votre connecteur et ajoutez-le au fichier manifeste. Activez l'option Partage via un lien pour le rapport.

urlFetchWhitelist

  1. Limitez le nombre de points de terminaison appelés par UrlFetchApp à ceux qui sont absolument nécessaires au fonctionnement du connecteur. Ajoutez la propriété urlFetchWhitelist au niveau racine de votre fichier manifeste. Pour en savoir plus, consultez la documentation de référence sur urlFetchListe blanche.
    • Incluez tous les points de terminaison utilisés avec le service UrlFetchApp.
    • Si votre connecteur ne récupère pas de ressources à l'aide du service UrlFetchApp, définissez urlFetchWhitelist sur une liste vide [].
    • Si votre connecteur ne se connecte pas à un ensemble de points de terminaison fixes ou si le préfixe du point de terminaison varie, omettez la propriété urlFetchWhitelist et fournissez des informations dans le champ Exception pour urlFetchListe blanche lorsque vous envoyez la demande d'examen.

oauthScopes

  1. Définissez des champs d'application OAuth explicites dans le fichier manifeste. Les connecteurs sans champ d'application OAuth explicite seront refusés.

Connecteur

  1. Si l'utilisateur a besoin d'un compte pour utiliser le connecteur, assurez-vous que le connecteur description ou le lien addOnUrl fournit des instructions pour l'aider à en créer un.
  2. Votre connecteur ne peut pas être à l'état "inachevé" ou en version bêta. Vous devez publier un connecteur complet et fonctionnel. Vous pouvez toujours mettre à jour votre connecteur, mais le déploiement de production mis à la disposition des utilisateurs doit être testé et toutes les fonctionnalités disponibles.
  3. Communiquez des messages d'erreur pertinents et exploitables aux utilisateurs lorsqu'ils rencontrent une erreur interne du connecteur. Cela inclut les cas où un utilisateur fournit une entrée non valide ou vide au moment de la configuration.
  4. Les liens shortDescription, description, addOnUrl, supportUrl et OAuth (le cas échéant) ne doivent comporter aucune faute d'orthographe ni de grammaire.
  5. shortDescription ne peut pas contenir d'URL.
  6. Utilisez les méthodes d'authentification fournies par getAuthType(). Ne demandez pas d'identifiants via getConfig().
  7. Suivez la procédure de validation du client OAuth. La validation est obligatoire pour tous les connecteurs, quelle que soit la méthode d'authentification définie dans getAuthType(). Le processus de validation est différent de l'examen des connecteurs. Il est géré par une équipe distincte, et non par Looker Studio. Pour en savoir plus, consultez les questions fréquentes sur la validation de l'API OAuth. Votre connecteur sera rejeté si la procédure de validation du client OAuth n'est pas terminée.
    • Au cours du processus de validation OAuth, ajoutez les champs d'application OAuth requis de votre connecteur dans le cadre de la configuration de l'écran d'autorisation OAuth. Si vous ne parvenez pas à ajouter tous les champs d'application requis, vous pouvez réussir le processus de validation OAuth. Toutefois, votre connecteur continuera d'afficher l'écran "Application non validée". Cela entraînera l'échec de la procédure de validation du connecteur partenaire.
      Autorisez et testez votre connecteur à l'aide d'un nouveau compte après avoir réussi le processus de validation OAuth pour vous assurer que les utilisateurs ne voient pas l'écran "Application non validée".
  8. Assurez-vous de respecter les Conditions d'utilisation des galeries Looker Studio (auteur de la demande).

Une fois que vous remplissez toutes les conditions requises, cliquez sur le bouton ci-dessous pour demander un examen de votre connecteur:

Publier votre connecteur partenaire