Ottimizzare le prestazioni

Questo documento descrive le tecniche che puoi utilizzare per migliorare le prestazioni della tua applicazione. La documentazione dell'API specifica che stai utilizzando deve avere una pagina simile con ulteriori dettagli su alcuni di questi argomenti. Ad esempio, consulta la pagina Suggerimenti sulle prestazioni per l'API Google Drive.

Informazioni su gzip

Questa libreria client richiede la compressione gzip per tutte le risposte dell'API e decomprime i dati per te. Anche se ciò richiede più tempo di CPU per decomprimere i risultati, il compromesso con i costi di rete di solito ne vale la pena.

Risposta parziale (parametro dei campi)

Per impostazione predefinita, il server restituisce la rappresentazione completa di una risorsa dopo l'elaborazione delle richieste. Per ottenere prestazioni migliori, puoi chiedere al server di inviare solo i campi effettivamente necessari e ottenere invece una risposta parziale.

Per richiedere una risposta parziale, aggiungi il parametro standard Fields a qualsiasi metodo API. Il valore di questo parametro specifica i campi che vuoi restituire. Puoi utilizzare questo parametro con qualsiasi richiesta che restituisce dati di risposta.

Nel seguente snippet di codice viene richiamato il metodo GetRest del servizio di rilevamento. Il valore del parametro Fields è impostato su description,title. Di conseguenza, l'oggetto restituito includerà solo i campi descrizione e titolo.

var service = new DiscoveryService();
var request = service.Apis.GetRest("calendar", "v3");
request.Fields = "description,title";
var result = request.Execute();
  

Nota come le virgole vengono utilizzate per delimitare i campi desiderati e le barre vengono utilizzate per indicare i campi contenuti nei campi padre. Sono disponibili altre opzioni di formattazione per il parametro Fields. Per informazioni dettagliate, consulta la pagina "Suggerimenti per il rendimento" nella documentazione dell'API in uso.

Aggiornamento parziale (patch)

Se l'API che stai chiamando supporta le patch, puoi evitare di inviare dati non necessari quando modifichi le risorse. Per queste API, puoi chiamare il metodo Patch e fornire gli argomenti che vuoi modificare per la risorsa.

Per maggiori informazioni sulla semantica delle patch, consulta la pagina "Suggerimenti sulle prestazioni" nella documentazione dell'API che stai utilizzando.

Batch

Se invii molte richieste di piccole dimensioni, puoi trarre vantaggio dal batch, che consente di raggruppare le richieste in una singola richiesta HTTP.