שיפור הביצועים

במסמך הזה מפורטות שיטות שיכולות לעזור לכם לשפר את ביצועי האפליקציה. התיעוד של ממשק ה-API הספציפי שבו אתם משתמשים צריך לכלול אותו דף עם פרטים נוספים על חלק מהנושאים האלה. לדוגמה, אפשר לעיין ב דף טיפים לשיפור ביצועים ב-Google Drive API.

מידע על gzip

ספריית הלקוח הזו מבקשת דחיסת נתונים מסוג gzip לכל התגובות וביטולי ה-ZIP של ה-API של הנתונים בשבילכם. על אף שהפעולה הזו דורשת זמן CPU (מעבד) נוסף כדי לבטל את הדחיסה של התוצאות, השילוב בין עלויות הרשת בדרך כלל משתלם.

תגובה חלקית (פרמטר של שדות)

כברירת מחדל, השרת שולח חזרה ייצוג מלא של משאב לאחר עיבוד בקשות. כדי לשפר את הביצועים, תוכלו לבקש מהשרת לשלוח רק את השדות שנחוצים לכם ולקבל במקום זאת תגובה חלקית.

כדי לבקש תשובה חלקית: מוסיפים את הפרמטר הרגיל Fields לכל method של API. הערך של הפרמטר הזה מציין את השדות שרוצים להחזיר. אפשר להשתמש בפרמטר הזה בכל בקשה שמחזירה נתוני תגובה.

בקטע הקוד הבא, קוראים לשיטה GetRest של שירות הגילוי. ערך הפרמטר Fields מוגדר כ-description,title. כתוצאה מכך, האובייקט המוחזר יכלול רק את שדות התיאור והכותרת.

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

שימו לב איך פסיקים להפרדה בין השדות הרצויים וקווים נטויים משמשים כדי לציין שדות שנכללים בשדות הורה. יש אפשרויות עיצוב נוספות לפרמטר Fields; לקבלת פרטים, ראו "טיפים בנושא ביצועים" דף בתיעוד של ממשק ה-API שבו אתם משתמשים.

עדכון חלקי (תיקון)

אם ה-API שאליו התקשרתם תומך בתיקון, תוכלו להימנע משליחת נתונים מיותרים כשמשנים משאבים. עבור ממשקי ה-API האלה, אפשר לקרוא ל-method Patch ו מספקים את הארגומנטים שרוצים לשנות במשאב.

למידע נוסף על סמנטיקה של תיקונים: לצפייה ב"טיפים לשיפור ביצועים" בתיעוד של ממשק ה-API שבו אתם משתמשים.

Batch

אם תשלחו הרבה בקשות קטנות, יכול להיות שכדאי לכם באצווה, שמאפשר לקבץ את הבקשות האלה בבקשת HTTP אחת.