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

جداول محوری، جداول محوری

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

جدول محوری چیست؟

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

برای مثال، مجموعه داده‌های فروش زیر را در نظر بگیرید:

	الف	ب	سی	دی	ای	ف	جی
۱	دسته بندی کالا	شماره مدل	هزینه	مقدار	منطقه	فروشنده	تاریخ ارسال
۲	چرخ	W-24	۲۰.۵۰ دلار	۴	غرب	بث	۱/۳/۲۰۱۶
۳	درب	D-01X	۱۵٫۰۰ دلار	۲	جنوب	امیر	۱۵/۳/۲۰۱۶
۴	موتور	ENG-0134	۱۰۰٫۰۰ دلار	۱	شمال	کارمن	۲۰/۳/۲۰۱۶
۵	قاب	FR-0B1	۳۴٫۰۰ دلار	۸	شرق	هانا	۳/۱۲/۲۰۱۶
۶	پنل	پ-034	۶٫۰۰ دلار	۴	شمال	دوین	۴/۲/۲۰۱۶
۷	پنل	پ-۰۵۲	۱۱.۵۰ دلار	۷	شرق	اریک	۱۶/۵/۲۰۱۶
۸	چرخ	W-24	۲۰.۵۰ دلار	۱۱	جنوب	شلدون	۳۰/۴/۲۰۱۶
۹	موتور	ENG-0161	۳۳۰٫۰۰ دلار	۲	شمال	جسی	۷/۲/۲۰۱۶
۱۰	درب	D-01Y	۲۹٫۰۰ دلار	۶	غرب	آرماندو	۱۳/۳/۲۰۱۶
۱۱	قاب	FR-0B1	۳۴٫۰۰ دلار	۹	جنوب	یولیانا	۲۷/۲/۲۰۱۶
۱۲	پنل	پ-۱۰۲	۳٫۰۰ دلار	۱۵	غرب	کارمن	۱۸/۴/۲۰۱۶
۱۳	پنل	پ-۱۰۵	۸.۲۵ دلار	۱۳	غرب	جسی	۲۰/۶/۲۰۱۶
۱۴	موتور	ENG-0211	۲۸۳٫۰۰ دلار	۱	شمال	امیر	۲۱/۶/۲۰۱۶
۱۵	درب	D-01X	۱۵٫۰۰ دلار	۲	غرب	آرماندو	۷/۳/۲۰۱۶
۱۶	قاب	FR-0B1	۳۴٫۰۰ دلار	۶	جنوب	کارمن	۱۵/۷/۲۰۱۶
۱۷	چرخ	W-25	۲۰٫۰۰ دلار	۸	جنوب	هانا	۵/۲/۲۰۱۶
۱۸	چرخ	W-11	۲۹٫۰۰ دلار	۱۳	شرق	اریک	۱۹/۵/۲۰۱۶
۱۹	درب	دی-۰۵	۱۷.۷۰ دلار	۷	غرب	بث	۶/۲۸/۲۰۱۶
۲۰	قاب	FR-0B1	۳۴٫۰۰ دلار	۸	شمال	شلدون	۳۰/۳/۲۰۱۶

شما می‌توانید از یک جدول محوری برای ایجاد گزارشی استفاده کنید که نشان می‌دهد از هر شماره مدل در هر منطقه چه تعداد فروخته شده است:

تصویر یک جدول محوری که تعداد شماره مدل را بر اساس منطقه نشان می‌دهد

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

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

کار با جداول محوری

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

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

برای اضافه کردن یک جدول محوری، از متد batchUpdate استفاده کنید و یک درخواست updateCells ارائه دهید. شما از این درخواست برای ارائه تعریف PivotTable به عنوان محتوای یک سلول، همانطور که در زیر نشان داده شده است، استفاده می‌کنید:

{
  "updateCells": {
    "rows": {
      "values": [
        {
          "pivotTable": "MyPivotTable"
        }
      ],
      "start": {
        "sheetId": "sheetId",
        "rowIndex": 0,
        "columnIndex": 0
      },
      "fields": "pivotTable"
    }
  }
}

این جدول محوری توصیف شده توسط MyPivotTable را در برگه مشخص شده قرار می‌دهد، به طوری که گوشه بالا سمت چپ در سلول A1 قرار گیرد. (ارتفاع و عرض جدول محوری پویا هستند؛ شما فقط مبدا را مشخص می‌کنید.)

نوع PivotTable به شما امکان می‌دهد موارد زیر را مشخص کنید:

محدوده داده‌های منبع
یک یا چند فیلد که داده‌های آنها سطرهای جدول محوری را تشکیل می‌دهند
یک یا چند فیلد که داده‌های آنها ستون‌های جدول محوری را تشکیل می‌دهند
معیارهای فیلترینگ و تجمیع
طرح‌بندی جدول محوری

اصلاح و حذف جداول محوری

هیچ درخواست صریحی برای تغییر یا حذف جدول محوری وجود ندارد. در عوض، از یک درخواست updateCells با محتوای سلول متفاوت استفاده کنید:

برای تغییر یک جدول محوری، یک تعریف PivotTable اصلاح‌شده ایجاد کنید و سلول را با استفاده از آن به‌روزرسانی کنید، مشابه اضافه کردن یک جدول محوری جدید.
برای حذف یک جدول محوری، سلول را با مقادیر خالی به‌روزرسانی کنید. برای مثال، به نمونه حذف یک جدول محوری مراجعه کنید.

موارد استفاده

کاربردهای بسیار متنوعی برای جداول محوری در طیف وسیعی از زمینه‌ها از جمله تحلیل آماری، برنامه‌های ERP، گزارش‌های مالی و موارد دیگر وجود دارد. موارد استفاده کلاسیک از جداول محوری شامل مواردی مانند موارد زیر است:

کل فروش بر اساس منطقه و فصل
میانگین حقوق بر اساس عنوان و محل سکونت
تعداد حوادث بر اساس محصول و زمان روز

تعداد کاربردهای بالقوه جداول محوری بسیار زیاد است و توانایی تولید آنها به صورت برنامه‌نویسی قدرتمند است. شما می‌توانید جداول محوری ایجاد کنید که از کاوش تعاملی پشتیبانی می‌کنند اما متناسب با شرایط خاص هستند، به عنوان مثال:

داده‌های حادثه را برای آخرین دوره ۲۴ ساعته کاوش کنید
مشاهده یا تجزیه و تحلیل داده‌های جمع‌آوری‌شده مربوط به حساب انتخاب‌شده
داده‌های فروش مربوط به قلمروهای متعلق به کاربر فعلی را بررسی کنید

مثال

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

اسکریپت برنامه‌ها

sheets/api/spreadsheet_snippets.gs

مشاهده در گیت‌هاب

/**
 * Create pivot table
 * @param {string} spreadsheetId spreadsheet ID
 * @returns {*} pivot table's spreadsheet
 */
Snippets.prototype.pivotTable = (spreadsheetId) => {
  try {
    const spreadsheet = SpreadsheetApp.openById(spreadsheetId);

    // Create two sheets for our pivot table, assume we have one.
    const sheet = spreadsheet.getSheets()[0];
    sheet.copyTo(spreadsheet);

    const sourceSheetId = spreadsheet.getSheets()[0].getSheetId();
    const targetSheetId = spreadsheet.getSheets()[1].getSheetId();

    // Create pivot table
    const pivotTable = Sheets.newPivotTable();

    const gridRange = Sheets.newGridRange();
    gridRange.sheetId = sourceSheetId;
    gridRange.startRowIndex = 0;
    gridRange.startColumnIndex = 0;
    gridRange.endRowIndex = 20;
    gridRange.endColumnIndex = 7;
    pivotTable.source = gridRange;

    const pivotRows = Sheets.newPivotGroup();
    pivotRows.sourceColumnOffset = 1;
    pivotRows.showTotals = true;
    pivotRows.sortOrder = "ASCENDING";
    pivotTable.rows = pivotRows;

    const pivotColumns = Sheets.newPivotGroup();
    pivotColumns.sourceColumnOffset = 4;
    pivotColumns.sortOrder = "ASCENDING";
    pivotColumns.showTotals = true;
    pivotTable.columns = pivotColumns;

    const pivotValue = Sheets.newPivotValue();
    pivotValue.summarizeFunction = "COUNTA";
    pivotValue.sourceColumnOffset = 4;
    pivotTable.values = [pivotValue];

    // Create other metadata for the updateCellsRequest
    const cellData = Sheets.newCellData();
    cellData.pivotTable = pivotTable;

    const rows = Sheets.newRowData();
    rows.values = cellData;

    const start = Sheets.newGridCoordinate();
    start.sheetId = targetSheetId;
    start.rowIndex = 0;
    start.columnIndex = 0;

    const updateCellsRequest = Sheets.newUpdateCellsRequest();
    updateCellsRequest.rows = rows;
    updateCellsRequest.start = start;
    updateCellsRequest.fields = "pivotTable";

    // Batch update our spreadsheet
    const batchUpdate = Sheets.newBatchUpdateSpreadsheetRequest();
    const updateCellsRawRequest = Sheets.newRequest();
    updateCellsRawRequest.updateCells = updateCellsRequest;
    batchUpdate.requests = [updateCellsRawRequest];
    const response = Sheets.Spreadsheets.batchUpdate(
      batchUpdate,
      spreadsheetId,
    );

    return response;
  } catch (err) {
    // TODO (developer) - Handle exception
    console.log("Failed with error %s", err.message);
  }
};

جاوا

sheets/snippets/src/main/java/PivotTables.java

مشاهده در گیت‌هاب

import com.google.api.client.googleapis.json.GoogleJsonError;
import com.google.api.client.googleapis.json.GoogleJsonResponseException;
import com.google.api.client.http.HttpRequestInitializer;
import com.google.api.client.http.javanet.NetHttpTransport;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.sheets.v4.Sheets;
import com.google.api.services.sheets.v4.SheetsScopes;
import com.google.api.services.sheets.v4.model.AddSheetRequest;
import com.google.api.services.sheets.v4.model.BatchUpdateSpreadsheetRequest;
import com.google.api.services.sheets.v4.model.BatchUpdateSpreadsheetResponse;
import com.google.api.services.sheets.v4.model.CellData;
import com.google.api.services.sheets.v4.model.GridCoordinate;
import com.google.api.services.sheets.v4.model.GridRange;
import com.google.api.services.sheets.v4.model.PivotGroup;
import com.google.api.services.sheets.v4.model.PivotTable;
import com.google.api.services.sheets.v4.model.PivotValue;
import com.google.api.services.sheets.v4.model.Request;
import com.google.api.services.sheets.v4.model.RowData;
import com.google.api.services.sheets.v4.model.UpdateCellsRequest;
import com.google.auth.http.HttpCredentialsAdapter;
import com.google.auth.oauth2.GoogleCredentials;
import com.google.common.collect.Lists;
import java.io.IOException;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;

/* Class to demonstrate the use of Spreadsheet Create Pivot Tables API */
public class PivotTables {
  /**
   * Create pivot table.
   *
   * @param spreadsheetId - Id of the spreadsheet.
   * @return pivot table's spreadsheet
   * @throws IOException - if credentials file not found.
   */
  public static BatchUpdateSpreadsheetResponse pivotTables(String spreadsheetId)
      throws IOException {
        /* Load pre-authorized user credentials from the environment.
           TODO(developer) - See https://developers.google.com/identity for
            guides on implementing OAuth2 for your application. */
    GoogleCredentials credentials = GoogleCredentials.getApplicationDefault()
        .createScoped(Collections.singleton(SheetsScopes.SPREADSHEETS));
    HttpRequestInitializer requestInitializer = new HttpCredentialsAdapter(
        credentials);

    // Create the sheets API client
    Sheets service = new Sheets.Builder(new NetHttpTransport(),
        GsonFactory.getDefaultInstance(),
        requestInitializer)
        .setApplicationName("Sheets samples")
        .build();

    // Create two sheets for our pivot table.
    List<Request> sheetsRequests = new ArrayList<>();
    BatchUpdateSpreadsheetResponse result = null;
    try {
      sheetsRequests.add(new Request().setAddSheet(new AddSheetRequest()));
      sheetsRequests.add(new Request().setAddSheet(new AddSheetRequest()));

      BatchUpdateSpreadsheetRequest createSheetsBody = new BatchUpdateSpreadsheetRequest()
          .setRequests(sheetsRequests);
      BatchUpdateSpreadsheetResponse createSheetsResponse = service.spreadsheets()
          .batchUpdate(spreadsheetId, createSheetsBody).execute();
      int sourceSheetId = createSheetsResponse.getReplies().get(0).getAddSheet().getProperties()
          .getSheetId();
      int targetSheetId = createSheetsResponse.getReplies().get(1).getAddSheet().getProperties()
          .getSheetId();

      PivotTable pivotTable = new PivotTable()
          .setSource(
              new GridRange()
                  .setSheetId(sourceSheetId)
                  .setStartRowIndex(0)
                  .setStartColumnIndex(0)
                  .setEndRowIndex(20)
                  .setEndColumnIndex(7)
          )
          .setRows(Collections.singletonList(
              new PivotGroup()
                  .setSourceColumnOffset(1)
                  .setShowTotals(true)
                  .setSortOrder("ASCENDING")
          ))
          .setColumns(Collections.singletonList(
              new PivotGroup()
                  .setSourceColumnOffset(4)
                  .setShowTotals(true)
                  .setSortOrder("ASCENDING")
          ))
          .setValues(Collections.singletonList(
              new PivotValue()
                  .setSummarizeFunction("COUNTA")
                  .setSourceColumnOffset(4)
          ));
      List<Request> requests = Lists.newArrayList();
      Request updateCellsRequest = new Request().setUpdateCells(new UpdateCellsRequest()
          .setFields("*")
          .setRows(Collections.singletonList(
              new RowData().setValues(
                  Collections.singletonList(
                      new CellData().setPivotTable(pivotTable))
              )
          ))
          .setStart(new GridCoordinate()
              .setSheetId(targetSheetId)
              .setRowIndex(0)
              .setColumnIndex(0)

          ));

      requests.add(updateCellsRequest);
      BatchUpdateSpreadsheetRequest updateCellsBody = new BatchUpdateSpreadsheetRequest()
          .setRequests(requests);
      result = service.spreadsheets().batchUpdate(spreadsheetId, updateCellsBody).execute();
    } catch (GoogleJsonResponseException e) {
      // TODO(developer) - handle error appropriately
      GoogleJsonError error = e.getDetails();
      if (error.getCode() == 404) {
        System.out.printf("Spreadsheet not found with id '%s'.\n", spreadsheetId);
      } else {
        throw e;
      }
    }
    return result;
  }
}

جاوا اسکریپت

sheets/snippets/sheets_pivot_tables.js

مشاهده در گیت‌هاب

function pivotTable(spreadsheetId, callback) {
  // Create two sheets for our pivot table
  const requests = [{
    addSheet: {},
  }, {
    addSheet: {},
  }];
  const batchUpdateRequest = {requests: requests};
  try {
    gapi.client.sheets.spreadsheets.batchUpdate({
      spreadsheetId: spreadsheetId,
      resource: batchUpdateRequest,
    }).then((response) => {
      const sourceSheetId = response.result.replies[0].addSheet.properties.sheetId;
      const targetSheetId = response.result.replies[1].addSheet.properties.sheetId;

      const requests = [{
        updateCells: {
          rows: {
            values: [{
              pivotTable: {
                source: {
                  sheetId: sourceSheetId,
                  startRowIndex: 0,
                  startColumnIndex: 0,
                  endRowIndex: 20,
                  endColumnIndex: 7,
                },
                rows: [{
                  sourceColumnOffset: 1,
                  showTotals: true,
                  sortOrder: 'ASCENDING',
                }],
                columns: [{
                  sourceColumnOffset: 4,
                  sortOrder: 'ASCENDING',
                  showTotals: true,
                }],
                values: [{
                  summarizeFunction: 'COUNTA',
                  sourceColumnOffset: 4,
                }],
                valueLayout: 'HORIZONTAL',
              },
            },
            ],
          },
          start: {
            sheetId: targetSheetId,
            rowIndex: 0,
            columnIndex: 0,
          },
          fields: 'pivotTable',
        },
      }];

      const body = {
        requests,
      };
      gapi.client.sheets.spreadsheets.batchUpdate({
        spreadsheetId: spreadsheetId,
        resource: body,
      }).then((response) => {
        if (callback) callback(response);
      });
    });
  } catch (err) {
    document.getElementById('content').innerText = err.message;
    return;
  }
}

نود جی اس

sheets/snippets/sheets_pivot_table.js

مشاهده در گیت‌هاب

import {GoogleAuth} from 'google-auth-library';
import {google} from 'googleapis';

/**
 * Creates a pivot table in a spreadsheet.
 * @param {string} spreadsheetId The ID of the spreadsheet.
 * @return {Promise<object>} The response from the batch update.
 */
async function pivotTable(spreadsheetId) {
  // Authenticate with Google and get an authorized client.
  const auth = new GoogleAuth({
    scopes: 'https://www.googleapis.com/auth/spreadsheets',
  });

  const service = google.sheets({version: 'v4', auth});

  // Create two new sheets for the pivot table.
  // One for the source data and one for the pivot table itself.
  let requests = [
    {
      addSheet: {},
    },
    {
      addSheet: {},
    },
  ];
  let resource = {requests};
  let response = await service.spreadsheets.batchUpdate({
    spreadsheetId,
    resource,
  });

  // Get the IDs of the newly created sheets.
  const sourceSheetId = response.data.replies[0].addSheet.properties.sheetId;
  const targetSheetId = response.data.replies[1].addSheet.properties.sheetId;

  // Add a pivot table to the new sheet.
  requests = [
    {
      updateCells: {
        rows: {
          values: [
            {
              pivotTable: {
                // The source data for the pivot table.
                source: {
                  sheetId: sourceSheetId,
                  startRowIndex: 0,
                  startColumnIndex: 0,
                  endRowIndex: 20,
                  endColumnIndex: 7,
                },
                // The rows of the pivot table.
                rows: [
                  {
                    sourceColumnOffset: 1,
                    showTotals: true,
                    sortOrder: 'ASCENDING',
                  },
                ],
                // The columns of the pivot table.
                columns: [
                  {
                    sourceColumnOffset: 4,
                    sortOrder: 'ASCENDING',
                    showTotals: true,
                  },
                ],
                // The values to display in the pivot table.
                values: [
                  {
                    summarizeFunction: 'COUNTA',
                    sourceColumnOffset: 4,
                  },
                ],
                valueLayout: 'HORIZONTAL',
              },
            },
          ],
        },
        // The location to place the pivot table.
        start: {
          sheetId: targetSheetId,
          rowIndex: 0,
          columnIndex: 0,
        },
        fields: 'pivotTable',
      },
    },
  ];
  resource = {
    requests,
  };

  // Send the batch update request to create the pivot table.
  response = service.spreadsheets.batchUpdate({
    spreadsheetId,
    resource,
  });
  return response;
}

پی اچ پی

sheets/snippets/src/SpreadsheetPivotTables.php

مشاهده در گیت‌هاب

<?php
use Google\Client;
use Google\Service\Drive;
use Google\Service\Sheets\BatchUpdateSpreadsheetRequest;


function pivotTables($spreadsheetId)
    {
        /* Load pre-authorized user credentials from the environment.
           TODO(developer) - See https://developers.google.com/identity for
            guides on implementing OAuth2 for your application. */
        $client = new Google\Client();
        $client->useApplicationDefaultCredentials();
        $client->addScope(Google\Service\Drive::DRIVE);
        $service = new Google_Service_Sheets($client);
        try{
            $requests = [
                new Google_Service_Sheets_Request([
                    'addSheet' => [
                        'properties' => [
                            'title' => 'Sheet 1'
                            ]
                ]
            ]),
            new Google_Service_Sheets_Request([
                'addSheet' => [
                    'properties' => [
                        'title' => 'Sheet 2'
                        ]
                        ]
                        ])
                    ];
                    // Create two sheets for our pivot table
                    $batchUpdateRequest = new Google_Service_Sheets_BatchUpdateSpreadsheetRequest([
                        'requests' => $requests
                    ]);
        $batchUpdateResponse = $service->spreadsheets->batchUpdate($spreadsheetId, $batchUpdateRequest);
        $sourceSheetId = $batchUpdateResponse->replies[0]->addSheet->properties->sheetId;
        $targetSheetId = $batchUpdateResponse->replies[1]->addSheet->properties->sheetId;
        $requests = [
            'updateCells' => [
                'rows' => [
                    'values' => [
                        [
                            'pivotTable' => [
                                'source' => [
                                    'sheetId' => $sourceSheetId,
                                    'startRowIndex' => 0,
                                    'startColumnIndex' => 0,
                                    'endRowIndex' => 20,
                                    'endColumnIndex' => 7
                                ],
                                'rows' => [
                                    [
                                        'sourceColumnOffset' => 1,
                                        'showTotals' => true,
                                        'sortOrder' => 'ASCENDING',
                                    ],
                                ],
                                'columns' => [
                                    [
                                        'sourceColumnOffset' => 4,
                                        'sortOrder' => 'ASCENDING',
                                        'showTotals' => true,
                                    ]
                                ],
                                'values' => [
                                    [
                                        'summarizeFunction' => 'COUNTA',
                                        'sourceColumnOffset' => 4
                                        ]
                                    ],
                                'valueLayout' => 'HORIZONTAL'
                            ]
                        ]
                        ]
                ],
                'start' => [
                    'sheetId' => $targetSheetId,
                    'rowIndex' => 0,
                    'columnIndex' => 0
                ],
                'fields' => 'pivotTable'
            ]
        ];
        return $batchUpdateResponse;
    }
        catch(Exception $e) {
            // TODO(developer) - handle error appropriately
            echo 'Message: ' .$e->getMessage();
        }
    }

پایتون

sheets/snippets/sheets_pivot_tables.py

مشاهده در گیت‌هاب

import google.auth
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError


def pivot_tables(spreadsheet_id):
  """
  Creates the batch_update the user has access to.
  Load pre-authorized user credentials from the environment.
  TODO(developer) - See https://developers.google.com/identity
  for guides on implementing OAuth2 for the application.
  """
  creds, _ = google.auth.default()
  # pylint: disable=maybe-no-member
  try:
    service = build("sheets", "v4", credentials=creds)
    # Create two sheets for our pivot table.
    body = {"requests": [{"addSheet": {}}, {"addSheet": {}}]}
    batch_update_response = (
        service.spreadsheets()
        .batchUpdate(spreadsheetId=spreadsheet_id, body=body)
        .execute()
    )
    source_sheet_id = (
        batch_update_response.get("replies")[0]
        .get("addSheet")
        .get("properties")
        .get("sheetId")
    )
    target_sheet_id = (
        batch_update_response.get("replies")[1]
        .get("addSheet")
        .get("properties")
        .get("sheetId")
    )
    requests = []
    requests.append(
        {
            "updateCells": {
                "rows": {
                    "values": [
                        {
                            "pivotTable": {
                                "source": {
                                    "sheetId": source_sheet_id,
                                    "startRowIndex": 0,
                                    "startColumnIndex": 0,
                                    "endRowIndex": 20,
                                    "endColumnIndex": 7,
                                },
                                "rows": [
                                    {
                                        "sourceColumnOffset": 1,
                                        "showTotals": True,
                                        "sortOrder": "ASCENDING",
                                    },
                                ],
                                "columns": [{
                                    "sourceColumnOffset": 4,
                                    "sortOrder": "ASCENDING",
                                    "showTotals": True,
                                }],
                                "values": [{
                                    "summarizeFunction": "COUNTA",
                                    "sourceColumnOffset": 4,
                                }],
                                "valueLayout": "HORIZONTAL",
                            }
                        }
                    ]
                },
                "start": {
                    "sheetId": target_sheet_id,
                    "rowIndex": 0,
                    "columnIndex": 0,
                },
                "fields": "pivotTable",
            }
        }
    )
    body = {"requests": requests}
    response = (
        service.spreadsheets()
        .batchUpdate(spreadsheetId=spreadsheet_id, body=body)
        .execute()
    )
    return response

  except HttpError as error:
    print(f"An error occurred: {error}")
    return error


if __name__ == "__main__":
  # Pass: spreadsheet_id
  pivot_tables("1CM29gwKIzeXsAppeNwrc8lbYaVMmUclprLuLYuHog4k")

روبی

sheets/snippets/lib/spreadsheet_snippets.rb

مشاهده در گیت‌هاب

requests = [{
  update_cells: {
    rows:   {
      values: [
        {
          pivot_table: {
            source:       {
              sheet_id:           source_sheet_id,
              start_row_index:    0,
              start_column_index: 0,
              end_row_index:      20,
              end_column_index:   7
            },
            rows:         [
              {
                source_column_offset: 1,
                show_totals:          true,
                sort_order:           'ASCENDING',
              },
            ],
            columns:      [
              {
                source_column_offset: 4,
                sort_order:           'ASCENDING',
                show_totals:          true,
              }
            ],
            values:       [
              {
                summarize_function:   'COUNTA',
                source_column_offset: 4
              }
            ],
            value_layout: 'HORIZONTAL'
          }
        }
      ]
    },
    start:  {
      sheet_id:     target_sheet_id,
      row_index:    0,
      column_index: 0
    },
    fields: 'pivotTable'
  }
}]
result = service.batch_update_spreadsheet(spreadsheet_id, body, {})

جداول محوری، جداول محوری با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

جدول محوری چیست؟

کار با جداول محوری

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

اصلاح و حذف جداول محوری

موارد استفاده

مثال

اسکریپت برنامه‌ها

جاوا

جاوا اسکریپت

نود جی اس

پی اچ پی

پایتون

روبی

جداول محوری، جداول محوری