این سند تکنیک هایی را پوشش می دهد که می توانید از آنها برای بهبود عملکرد برنامه خود استفاده کنید. مستندات API خاصی که استفاده می کنید باید صفحه مشابهی با جزئیات بیشتر در مورد برخی از این موضوعات داشته باشد. برای مثال، به صفحه نکات عملکرد برای Google Drive API مراجعه کنید.
درباره gzip
این کتابخانه مشتری فشرده سازی gzip را برای همه پاسخ های API درخواست می کند و داده ها را برای شما از حالت فشرده خارج می کند. اگرچه این امر به زمان اضافی CPU برای فشرده سازی نتایج نیاز دارد، معاوضه با هزینه های شبکه معمولاً آن را ارزشمند می کند.
پاسخ جزئی (پارامتر فیلدها)
به طور پیش فرض، سرور پس از پردازش درخواست ها، نمایش کامل یک منبع را پس می فرستد. برای عملکرد بهتر، میتوانید از سرور بخواهید فقط فیلدهایی را که واقعاً به آن نیاز دارید ارسال کند و در عوض پاسخی جزئی دریافت کنید.
برای درخواست پاسخ جزئی، پارامتر Fields
استاندارد را به هر روش API اضافه کنید. مقدار این پارامتر فیلدهایی را که می خواهید برگردانید را مشخص می کند. می توانید از این پارامتر با هر درخواستی که داده های پاسخ را برمی گرداند استفاده کنید.
در قطعه کد زیر، متد 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
وجود دارد. برای جزئیات، به صفحه "نکات عملکرد" در اسناد API مورد استفاده خود مراجعه کنید.
به روز رسانی جزئی (پچ)
اگر API مورد نظر از وصله پشتیبانی میکند، میتوانید هنگام اصلاح منابع از ارسال دادههای غیرضروری خودداری کنید. برای این APIها، میتوانید متد Patch
را فراخوانی کنید و آرگومانهایی را که میخواهید برای منبع تغییر دهید ارائه کنید.
برای اطلاعات بیشتر در مورد معانی وصله، صفحه "نکات عملکرد" را در مستندات API مورد استفاده خود ببینید.
دسته ای
اگر درخواستهای کوچک زیادی ارسال میکنید، ممکن است از دستهبندی سود ببرید، که اجازه میدهد این درخواستها در یک درخواست HTTP واحد جمع شوند.