يتناول هذا المستند الأساليب التي يمكنك استخدامها لتحسين أداء تطبيقك. يجب أن تحتوي المستندات الخاصة بواجهة برمجة التطبيقات التي تستخدمها على صفحة مشابهة تحتوي على مزيد من التفاصيل حول بعض هذه المواضيع. على سبيل المثال، يمكنك الاطّلاع على صفحة "نصائح حول الأداء" لواجهة Google Drive API.
لمحة عن gzip
تطلب مكتبة البرامج هذه ضغط gzip لجميع ردود واجهة برمجة التطبيقات وفك ضغط البيانات نيابةً عنك. وعلى الرغم من أنّ هذا الإجراء يتطلّب وقتًا إضافيًا في وحدة المعالجة المركزية لفك ضغط النتائج، فإنّ المفاضلة مع تكاليف الشبكة عادةً ما تجعل الأمر مجديًا.
استجابة جزئية (مَعلمة الحقول)
وبشكل افتراضي، يرسل الخادم التمثيل الكامل للمورد بعد معالجة الطلبات. للحصول على أداء أفضل، يمكنك أن تطلب من الخادم إرسال الحقول التي تحتاجها فقط والحصول على رد جزئي بدلاً من ذلك.
لطلب ردّ جزئي، يمكنك إضافة المَعلمة Fields العادية إلى أي طريقة من طرق واجهة برمجة التطبيقات.
تحدّد قيمة هذه المَعلمة الحقول التي تريد عرضها.
يمكنك استخدام هذه المَعلمة مع أي طلب يعرض بيانات الاستجابة.
في مقتطف الرمز التالي، يتم استدعاء طريقة GetRest لخدمة Discovery.
يتم ضبط قيمة المعلَمة Fields على description,title.
ونتيجةً لذلك، سيتضمّن الكائن المعروض حقلَي الوصف والعنوان فقط.
var service = new DiscoveryService();
var request = service.Apis.GetRest("calendar", "v3");
request.Fields = "description,title";
var result = request.Execute();
لاحِظ كيفية استخدام الفواصل لتحديد الحقول المطلوبة، والشرطات المائلة للإشارة إلى الحقول المضمّنة في الحقول الرئيسية.
هناك خيارات تنسيق أخرى للمَعلمة Fields.
لمعرفة التفاصيل، يُرجى الاطّلاع على صفحة "نصائح الأداء"
في مستندات واجهة برمجة التطبيقات التي تستخدمها.
تحديث جزئي (تصحيح)
إذا كانت واجهة برمجة التطبيقات التي تطلبها توفّر رمز التصحيح،
يمكنك تجنُّب إرسال بيانات غير ضرورية عند تعديل الموارد.
بالنسبة إلى واجهات برمجة التطبيقات هذه، يمكنك استدعاء الطريقة Patch وتقديم الوسيطات التي تريد تعديلها للمورد.
للاطّلاع على مزيد من المعلومات حول دلالات رموز التصحيح، يمكنك الاطّلاع على صفحة "نصائح الأداء" في المستندات الخاصة بواجهة برمجة التطبيقات التي تستخدمها.
مجمّعة
إذا كنت ترسل العديد من الطلبات الصغيرة، يمكنك الاستفادة من ميزة التجميع، ما يسمح بتجميع هذه الطلبات في طلب HTTP واحد.