Ce document présente des techniques que vous pouvez utiliser pour améliorer les performances de votre application. La documentation de l'API spécifique que vous utilisez devrait proposer une page similaire avec plus de détails sur certains de ces sujets. Par exemple, consultez la page Conseils sur l'amélioration des performances pour l'API Google Drive.
À propos de gzip
Cette bibliothèque cliente demande la compression gzip pour toutes les réponses de l'API et décompresse les données à votre place. Bien que la décompression des résultats nécessite un temps CPU supplémentaire, la compression est généralement intéressante en termes de coûts de réseau.
Réponse partielle (paramètre de champs)
Par défaut, le serveur renvoie la représentation complète d'une ressource après avoir traité les requêtes. Pour de meilleures performances, vous pouvez demander au serveur de n'envoyer que les champs dont vous avez vraiment besoin afin d'obtenir une réponse partielle.
Pour demander une réponse partielle, ajoutez le paramètre Fields standard à n'importe quelle méthode API.
La valeur de ce paramètre spécifie les champs qui doivent être renvoyés.
Vous pouvez définir ce paramètre pour toute requête qui affiche des données de réponse.
Dans l'extrait de code suivant, la méthode GetRest du service de découverte est appelée.
La valeur du paramètre Fields est définie sur description,title.
Par conséquent, l'objet renvoyé n'inclura que les champs de description et de titre.
var service = new DiscoveryService();
var request = service.Apis.GetRest("calendar", "v3");
request.Fields = "description,title";
var result = request.Execute();
Notez que les virgules sont utilisées pour délimiter les champs souhaités, et que les barres obliques sont utilisées pour indiquer les champs contenus dans les champs parents.
Il existe d'autres options de mise en forme pour le paramètre Fields. Pour en savoir plus, consultez la page "Conseils sur l'amélioration des performances" dans la documentation de l'API que vous utilisez.
Mise à jour partielle (correctif)
Si l'API que vous appelez est compatible avec patch, vous pouvez éviter d'envoyer des données inutiles lors de la modification des ressources.
Pour ces API, vous pouvez appeler la méthode Patch et fournir les arguments que vous souhaitez modifier pour la ressource.
Pour en savoir plus sur la sémantique des correctifs, consultez la page "Conseils sur l'amélioration des performances" dans la documentation de l'API que vous utilisez.
Lot
Si vous envoyez de nombreuses requêtes de petite taille, vous pouvez bénéficier du traitement par lot, qui permet de les regrouper en une seule requête HTTP.