جداول

این راهنما نحوه و چرایی استفاده از Google Sheets API را برای ایجاد جداول در صفحات گسترده توضیح می دهد.

میز چیست؟

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

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

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

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

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

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

{
  "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"
                }
              ]
            }
          }
        }
      ],
    }
  }
}

انواع ستون

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

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

نوع ستون کشویی یک کرکره تراشه ایجاد می کند. اگر یک نوع ستون به عنوان کشویی تنظیم شود، dataValidationRule برای ستون باید با یک شرط ONE_OF_LIST تنظیم شود. سایر انواع ستون نباید فیلد «dataValidationRule» را تنظیم کنند.

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

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

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

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

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

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

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

پاورقی جدول را تغییر دهید

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

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

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

حذف یک جدول

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

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

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

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