نمونه ها

این بخش یک کد لبه را ارائه می دهد که می توانید از آن برای آشنایی با Google Sheets API استفاده کنید. همچنین مجموعه‌ای از نمونه‌های «دستور العمل» ارائه شده است که نشان می‌دهد چگونه یک عملکرد Google Sheets مورد نظر را به یک درخواست API ترجمه کنید.

اغلب بیش از یک راه برای تکمیل یک کار معین با API وجود دارد. هنگامی که تصمیم می گیرید چگونه به یک کار نزدیک شوید، موارد زیر را در نظر داشته باشید:

• اگر نیاز به خواندن یا نوشتن مقادیر سلول دارید، مجموعه spreadsheets.values ​​انتخاب بهتری نسبت به مجموعه spreadsheets است. استفاده از رابط اولی برای عملیات خواندن/نوشتن ساده‌تر است.

• در صورت امکان، از روش‌های دسته‌ای ( spreadsheet.batchUpdate ، spreadsheet.values.batchGet ، و spreadsheet.values.batchUpdate ) برای دسته‌بندی چندین درخواست در یک فراخوانی متد استفاده کنید. استفاده از این روش های دسته ای کارایی را بهبود می بخشد زیرا:

  • سربار HTTP مشتری را کاهش دهید.
  • تعداد پرس و جوهای انجام شده را کاهش دهید.
  • تعداد بازبینی های سند را کاهش دهید.
  • از اتمی بودن تمام تغییرات در دسته اطمینان حاصل کنید.

دستور العمل ها

مثال‌های فهرست‌شده در این بخش نحوه بیان کنش‌های رایج در Sheets را به‌عنوان درخواست‌های Sheets API v4 نشان می‌دهند.

این نمونه ها در قالب درخواست های HTTP برای خنثی بودن زبان ارائه شده اند. برای آشنایی با نحوه پیاده‌سازی پروتکل‌های درخواست Sheets API در یک زبان خاص با استفاده از کتابخانه‌های سرویس گیرنده Google API، به راهنمای خواندن و نوشتن مقادیر سلول و به‌روزرسانی صفحات گسترده مراجعه کنید.

دستور غذاها در این بخش به دسته های زیر تقسیم می شوند:

• خواندن پایه — دستور العمل هایی که نحوه خواندن مقادیر از یک برگه را نشان می دهد.
• نوشتن پایه - دستور العمل هایی که نحوه نوشتن مقادیر در یک برگه را نشان می دهد.
• قالب بندی اولیه — دستور العمل هایی که نحوه تغییر ظاهر برگه ها و سلول ها را نشان می دهد.
• نمودارها - دستور العمل هایی که نحوه ایجاد و تغییر نمودارها را در یک برگه نشان می دهد.
• قالب بندی مشروط - دستور العمل هایی که نحوه تغییر ظاهر سلول را بر اساس شرایط نشان می دهد.
• عملیات داده - دستور العمل هایی که نحوه ایجاد، انتقال و دستکاری داده ها را در یک صفحه گسترده نشان می دهد.
• محدوده‌های نام‌گذاری‌شده و محافظت‌شده - دستور العمل‌هایی که نحوه ایجاد، به‌روزرسانی، و حذف محدوده‌های نام‌گذاری‌شده و محافظت‌شده را در یک صفحه‌گسترده نشان می‌دهند.
• جداول محوری - دستور العمل هایی که نحوه ایجاد جداول محوری در یک برگه را نشان می دهد.
• عملیات سطر و ستون — دستور العمل هایی که نحوه افزودن، حذف و جابجایی سطرها و ستون ها و به روز رسانی ویژگی های آنها را نشان می دهد.
• عملیات برگه - دستور العمل هایی که نحوه ایجاد، پاک کردن، کپی و حذف برگه ها و همچنین کنترل خواص آنها را نشان می دهد.