این بخش یک آزمایشگاه کد ارائه میدهد که میتوانید از آن برای آشنایی با API گوگل شیت استفاده کنید. همچنین مجموعهای از مثالهای «دستورالعمل» ارائه شده است که نحوه تبدیل یک اقدام گوگل شیت مورد نظر به یک درخواست API را نشان میدهد.
اغلب بیش از یک راه برای انجام یک کار مشخص با API وجود دارد. هنگام تصمیمگیری در مورد نحوه انجام یک کار، موارد زیر را در نظر داشته باشید:
- اگر نیاز به خواندن یا نوشتن مقادیر سلول دارید، مجموعه
spreadsheets.valuesانتخاب بهتری نسبت به مجموعهspreadsheetsاست. رابط کاربری اولی برای عملیات خواندن/نوشتن ساده آسانتر است. هر جا که ممکن است، از متدهای دستهای (
spreadsheet.batchUpdate،spreadsheet.values.batchGetوspreadsheet.values.batchUpdate) برای دستهبندی چندین درخواست در یک فراخوانی متد واحد استفاده کنید. استفاده از این متدهای دستهای کارایی را بهبود میبخشد زیرا:- کاهش سربار HTTP کلاینت.
- تعداد درخواستهای ارسالی را کاهش دهید.
- تعداد ویرایشهای سند را کاهش دهید.
- از اتمی بودن تمام تغییرات در دسته اطمینان حاصل کنید.
دستور پختها
مثالهای ذکر شده در این بخش، نحوه بیان اقدامات رایج در Sheets را به عنوان درخواستهای Sheets API نسخه ۴ نشان میدهند.
این مثالها به صورت درخواستهای HTTP ارائه شدهاند تا از نظر زبانی بیطرف باشند. برای یادگیری نحوه پیادهسازی پروتکلهای درخواست API صفحات وب در یک زبان خاص با استفاده از کتابخانههای کلاینت API گوگل، به راهنماهای « خواندن و نوشتن مقادیر سلول» و «بهروزرسانی صفحات گسترده» مراجعه کنید.
دستور پختهای این بخش به دستههای زیر تقسیم میشوند:
- خواندن مقدماتی - دستورالعملهایی که نحوه خواندن مقادیر از یک برگه را نشان میدهند.
- نوشتن مقدماتی - دستورالعملهایی که نحوه نوشتن مقادیر در یک برگه را نشان میدهند.
- قالببندی اولیه - دستورالعملهایی که نحوه تغییر ظاهر صفحات و سلولها را نشان میدهند.
- نمودارها - دستورالعملهایی که نحوه ایجاد و تغییر نمودارها را در یک برگه نشان میدهند.
- قالببندی شرطی - دستورالعملهایی که نحوه تغییر ظاهر سلول را بر اساس شرایط نشان میدهند.
- عملیات داده - دستورالعملهایی که نحوه ایجاد، جابجایی و دستکاری دادهها را در یک صفحه گسترده نشان میدهند.
- محدودههای نامگذاری شده و محافظت شده - دستورالعملهایی که نحوه ایجاد، بهروزرسانی و حذف محدودههای نامگذاری شده و محافظت شده را در یک صفحه گسترده نشان میدهند.
- جداول محوری - دستورالعملهایی که نحوه ایجاد جداول محوری را در یک صفحه نشان میدهند.
- عملیات سطر و ستون - دستورالعملهایی که نحوه اضافه کردن، حذف و جابجایی سطرها و ستونها و بهروزرسانی ویژگیهای آنها را نشان میدهند.
- عملیات روی برگهها - دستورالعملهایی که نحوه ایجاد، پاک کردن، کپی و حذف برگهها و همچنین کنترل ویژگیهای آنها را نشان میدهند.