جداول

این راهنما نحوه و دلیل استفاده از API گوگل شیت برای ایجاد جداول در صفحات گسترده شما را شرح می‌دهد.

میز چیست؟

با استفاده از جداول، می‌توانید ایجاد داده‌ها را ساده کنید و با اعمال خودکار قالب و ساختار به محدوده‌ای از داده‌ها، نیاز به قالب‌بندی، ورود و به‌روزرسانی مکرر داده‌ها را کاهش دهید.

جداول ویژگی‌های زیادی دارند، مانند سرصفحه، پاصفحه، انواع ستون، فیلترها، نماها، ارجاعات جدول و نام جدول. برای اطلاعات بیشتر به اطلاعیه ویژگی مراجعه کنید و در مورد استفاده از جداول در Sheets اطلاعات کسب کنید .

شما می‌توانید از جداول برای کارهایی مانند پیگیری پروژه، برنامه‌ریزی رویداد و مدیریت موجودی استفاده کنید.

اضافه کردن جدول

برای اضافه کردن یک جدول، از متد batchUpdate استفاده کنید و یک درخواست addTable ارسال کنید. شما از این درخواست برای اضافه کردن یک جدول به صفحه گسترده استفاده می‌کنید.

مثال زیر جدولی با نام "Project Tracker" در range مشخص شده با دو ستون تنظیم شده ایجاد می‌کند. یک ستون درصد در ستون اول و یک ستون از نوع کشویی در ستون دوم.

{
  "addTable": {
    "table": {
      "name": "Project Tracker",
      "tableId": "123",
      "range": {
        "sheetId": 0,
        "startColumnIndex": 0,
        "endColumnIndex": 5,
        "startRowIndex": 0,
        "endRowIndex": 5,
      },
      "columnProperties": [
        {
          "columnIndex": 0,
          "columnName": "Column 1",
          "columnType": "PERCENT"
        },
        {
          "columnIndex": 1,
          "columnName": "Column 2",
          "columnType": "DROPDOWN",
          "dataValidationRule": {
            "condition": {
              "type": "ONE_OF_LIST",
              "values": [
                {
                  "userEnteredValue": "Not Started"
                },
                {
                  "userEnteredValue": "In Progress"
                },
                {
                  "userEnteredValue": "Complete"
                }
              ]
            }
          }
        }
      ],
    }
  }
}

انواع ستون

جداول دارای انواع ستون مانند عددی، تاریخ، کشویی، تراشه هوشمند و کادر انتخاب هستند. انواع ستون‌های رتبه‌بندی و کادر انتخاب به ترتیب با مقادیر پیش‌فرض ۰ و FALSE پر می‌شوند.

نوع ستون کشویی

نوع ستون کشویی، یک منوی کشویی چیپ ایجاد می‌کند. اگر نوع ستونی به صورت کشویی تنظیم شود، dataValidationRule برای ستون باید با شرط ONE_OF_LIST تنظیم شود. سایر انواع ستون نباید فیلد `dataValidationRule` را تنظیم کنند.

به‌روزرسانی یک جدول

از متد spreadsheets.batchUpdate استفاده کنید و یک UpdateTableRequest ارائه دهید.

تغییر اندازه جدول

از متد UpdateTableRequest برای تغییر range که جدول برای افزودن سطرها/ستون‌های جدید دارد، استفاده کنید.

اگر نیاز به اضافه کردن یک ردیف یا ستون جدید در جدول دارید، از InsertRangeRequest یا InsertDimensionRequest استفاده کنید.

اگر نیاز به حذف یک ردیف جدول دارید، می‌توانید از DeleteRangeRequest استفاده کنید، در غیر این صورت می‌توانید از DeleteDimensionRequest برای حذف کل یک ردیف از صفحه گسترده استفاده کنید.

نکته: اگر از InsertRangeRequest/DeleteRangeRequest استفاده می‌کنید، محدوده درخواست باید در صورت حذف یک ردیف، کل ردیف (ها) و در صورت حذف یک ستون، کل ستون (ها) را پوشش دهد.

تغییر وضعیت پاورقی جدول

اگر جدول موجود بدون پاورقی را به‌روزرسانی می‌کنید تا پاورقی اضافه شود، range ۱ ردیف افزایش می‌یابد. اگر جدول موجود دارای پاورقی را به‌روزرسانی می‌کنید و پاورقی را حذف می‌کنید، range ۱ ردیف کاهش می‌یابد.

اضافه کردن مقادیر به جدول

از AppendCellsRequest به همراه tableId برای اضافه کردن سطر به انتهای جدول استفاده کنید. این تابع مقادیر را به اولین سطر خالی اضافه می‌کند و از سطرها و پاورقی‌های پر آگاه است. اگر سطر خالی وجود نداشته باشد، سطرها را به انتهای جدول و قبل از هرگونه پاورقی، در صورت وجود، اضافه می‌کند.

حذف یک جدول

از متد spreadsheets.batchUpdate استفاده کنید و یک DeleteTableRequest ارائه دهید. از DeleteTableRequest برای حذف کل جدول و محتویات آن استفاده کنید.

از DeleteBandingRequest برای حذف قالب‌بندی جدول اما نگه داشتن داده‌ها استفاده کنید.

استفاده از جداول با سایر ویژگی‌های Sheets

سایر ویژگی‌های API که از جداول به عنوان داده‌های پشتیبان خود پشتیبانی می‌کنند شامل فیلترها ، نماهای فیلتر و محدوده‌های محافظت‌شده هستند.