W tym dokumencie opisujemy techniki, które możesz wykorzystać do poprawy wydajności swojej aplikacji. Dokumentacja używanego przez Ciebie interfejsu API powinna zawierać ze szczegółowymi informacjami na temat niektórych z tych tematów. Przykładem może być strony z poradami dotyczącymi wydajności interfejsu Google Drive API.
Informacje o gzip
Ta biblioteka klienta prosi o kompresję gzip dla wszystkich odpowiedzi interfejsu API i rozpakowuje dane za Ciebie. Chociaż zdekompresowanie wyników wymaga dodatkowego czasu pracy procesora, kompromis z kosztami sieciowymi zwykle jest opłacalny.
Odpowiedź częściowa (parametr pól)
Po przetworzeniu żądań serwer domyślnie odsyła pełną reprezentację zasobu. Aby zwiększyć wydajność, możesz poprosić serwer, by wysłał tylko te pola, których potrzebujesz, i uzyskał odpowiedź częściową.
Aby wysłać takie żądanie, dodaj standardowy parametr Fields do dowolnej metody interfejsu API.
Wartość tego parametru określa pola, które mają być zwracane.
Tego parametru możesz użyć w każdym żądaniu, które zwraca dane odpowiedzi.
W tym 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 description i title.
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 oddzielania wybranych pól.
i ukośniki służą do oznaczania pól znajdujących się w polach nadrzędnych.
Parametr Fields może mieć inne opcje formatowania. Więcej informacji znajdziesz na stronie „Wskazówki dotyczące wydajności” w dokumentacji interfejsu API, którego używasz.
Częściowa aktualizacja (poprawka)
Jeśli interfejs API, który wywołujesz, obsługuje metodę patch, 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ć w zasobie.
Więcej informacji o semantyce poprawki znajdziesz w artykule przeczytaj „Wskazówki dotyczące skuteczności”, znajdziesz w dokumentacji używanego interfejsu API.
Wsad
Jeśli wysyłasz wiele małych próśb, możesz odnieść korzyści łączeniu wsadowe, który pozwala połączyć te żądania w jedno żądanie HTTP.