W tym dokumencie opisujemy techniki, które możesz zastosować, aby poprawić wydajność swojej aplikacji. Dokumentacja konkretnego interfejsu API, którego używasz, powinna mieć podobną stronę ze szczegółowymi informacjami o niektórych z tych tematów. Na przykład poczytaj o stronie Wskazówki dotyczące wydajności interfejsu Google Drive API.
Informacje o Gzip
Ta biblioteka klienta żąda kompresji wszystkich odpowiedzi interfejsu API za pomocą narzędzia gzip i rozpakowuje dane za Ciebie. Mimo że zdekompresowanie wyników wymaga więcej czasu procesora, zwykle warto obniżyć koszty sieci.
Odpowiedź częściowa (parametr Fields)
Po przetworzeniu żądań serwer domyślnie odsyła pełną reprezentację zasobu. Aby uzyskać lepszą wydajność, możesz wysłać do serwera żądanie, by wysyłał tylko te pola, których potrzebujesz, i otrzymywał odpowiedź częściową.
Aby zażądać odpowiedzi częściowej, dodaj standardowy parametr Fields do dowolnej metody interfejsu API.
Wartość tego parametru określa pola, które chcesz zwrócić.
Tego parametru możesz użyć w przypadku każdego żądania, które zwraca dane odpowiedzi.
W poniższym fragmencie kodu wywoływana jest metoda GetRest usługi wykrywania.
Wartość parametru Fields jest ustawiona na description,title.
W rezultacie zwrócony obiekt będzie zawierał tylko pola opisu i tytułu.
var service = new DiscoveryService();
var request = service.Apis.GetRest("calendar", "v3");
request.Fields = "description,title";
var result = request.Execute();
Zwróć uwagę, jak przecinki służą do ograniczania wymaganych pól, a ukośniki służą do wskazywania pól, które znajdują się w polach nadrzędnych.
Parametr Fields ma też inne opcje formatowania. Szczegółowe informacje znajdziesz na stronie „Wskazówki dotyczące wydajności” w dokumentacji używanego interfejsu API.
Częściowa aktualizacja (poprawka)
Jeśli wywoływany interfejs API obsługuje poprawkę, możesz uniknąć wysyłania niepotrzebnych danych podczas modyfikowania zasobów.
W przypadku tych interfejsów API możesz wywołać metodę Patch i podać argumenty, które chcesz zmodyfikować dla zasobu.
Więcej informacji o semantyce poprawki znajdziesz na stronie „Wskazówki dotyczące wydajności” w dokumentacji używanego interfejsu API.
Wsad
Jeśli wysyłasz wiele małych żądań, może Ci się przydać funkcja zbiorczego, która pozwoli połączyć te żądania w jedno żądanie HTTP.