À propos de la création d'actions de données d'API HTTP

Vous pouvez créer des actions de données d'API HTTP pour vous connecter à une API REST à partir d'un classeur.

Vous configurez une action de données d'API HTTP pour transmettre des valeurs de colonne sélectionnées d'un classeur à une API REST qui retourne une réponse. Notez ce qui suit :

  • Le nombre d'actions de données que vous pouvez créer est illimité.

  • Une URL peut contenir des jetons qui transmettent des valeurs contextuelles à une action de données, par exemple, des valeurs de données, un nom d'utilisateur, un chemin d'accès de classeur, un nom de canevas.

    L'exemple d'URL d'API REST suivant inclut une valeur de jeton de colonne Category qui affiche l'API Livres Google : http://www.googleapis.com/books/v1/volumes?q=${valuesForColumn:"Category"}. La valeur que vous sélectionnez dans une cellule de la colonne Category, par exemple, "Books", est transmise à l'API REST, qui affiche la page demandée.

  • Si vous utilisez une méthode POST ou bien un en-tête HTTP personnalisé qui remplace l'en-tête HTTP, les considérations suivantes s'appliquent :

    • Entrez chaque paramètre sous forme de paire nom-valeur, en séparant le nom et la valeur par le signe "=".
    • Vous pouvez utiliser la même syntaxe de jeton d'URL dans les paires nom-valeur comme requis par l'API que vous appelez. Par exemple :
      • paramName1=paramValue1
      • paramName2=${valuesForColumn:"Product"}
    • Un en-tête personnalisé fonctionne si la cible de la demande HTTP permet de définir dans celle-ci les en-têtes HTTP que vous utilisez. Si les en-têtes ne sont pas autorisés, le navigateur bloque la demande et affiche un message d'erreur, par exemple, un en-tête de témoin contenant Content-Type=application/json sera bloqué.