Sheets

ورق

یک برگه در یک صفحه گسترده.

نمایندگی JSON
{
  "properties": {
    object (SheetProperties)
  },
  "data": [
    {
      object (GridData)
    }
  ],
  "merges": [
    {
      object (GridRange)
    }
  ],
  "conditionalFormats": [
    {
      object (ConditionalFormatRule)
    }
  ],
  "filterViews": [
    {
      object (FilterView)
    }
  ],
  "protectedRanges": [
    {
      object (ProtectedRange)
    }
  ],
  "basicFilter": {
    object (BasicFilter)
  },
  "charts": [
    {
      object (EmbeddedChart)
    }
  ],
  "bandedRanges": [
    {
      object (BandedRange)
    }
  ],
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "rowGroups": [
    {
      object (DimensionGroup)
    }
  ],
  "columnGroups": [
    {
      object (DimensionGroup)
    }
  ],
  "slicers": [
    {
      object (Slicer)
    }
  ]
}
زمینه های
properties

object ( SheetProperties )

خواص ورق.

data[]

object ( GridData )

داده ها در شبکه، اگر این یک صفحه شبکه است.

تعداد اشیاء GridData برگردانده شده به تعداد محدوده های درخواست شده در این برگه بستگی دارد. به عنوان مثال، اگر صفحه‌گسترده نشان‌دهنده Sheet1 باشد، و صفحه‌گسترده با محدوده‌های Sheet1!A1:C10 و Sheet1!D15:E20 درخواست شده باشد، اولین GridData دارای startRow / startColumn 0 خواهد بود، در حالی که دومین صفحه دارای startRow 14 ( ردیف 15 مبتنی بر صفر)، و startColumn 3 (ستون D مبتنی بر صفر).

برای یک برگه DATA_SOURCE ، نمی‌توانید محدوده خاصی را درخواست کنید، GridData شامل تمام مقادیر است.

merges[]

object ( GridRange )

محدوده هایی که با هم ادغام می شوند.

conditionalFormats[]

object ( ConditionalFormatRule )

قوانین قالب مشروط در این برگه.

filterViews[]

object ( FilterView )

فیلتر در این برگه مشاهده می شود.

protectedRanges[]

object ( ProtectedRange )

محدوده های محافظت شده در این برگه

basicFilter

object ( BasicFilter )

فیلتر موجود در این برگه، در صورت وجود.

charts[]

object ( EmbeddedChart )

مشخصات هر نمودار در این برگه.

bandedRanges[]

object ( BandedRange )

محدوده نواری (رنگ های متناوب) در این برگه است.

developerMetadata[]

object ( DeveloperMetadata )

ابرداده توسعه‌دهنده مرتبط با یک برگه.

rowGroups[]

object ( DimensionGroup )

همه گروه‌های ردیف در این برگه، با افزایش شاخص شروع محدوده، سپس بر اساس عمق گروه مرتب شده‌اند.

columnGroups[]

object ( DimensionGroup )

همه گروه‌های ستون در این برگه، با افزایش شاخص شروع محدوده، سپس بر اساس عمق گروه مرتب شده‌اند.

slicers[]

object ( Slicer )

برش های موجود در این برگه

SheetProperties

خواص یک ورق

نمایندگی JSON
{
  "sheetId": integer,
  "title": string,
  "index": integer,
  "sheetType": enum (SheetType),
  "gridProperties": {
    object (GridProperties)
  },
  "hidden": boolean,
  "tabColor": {
    object (Color)
  },
  "tabColorStyle": {
    object (ColorStyle)
  },
  "rightToLeft": boolean,
  "dataSourceSheetProperties": {
    object (DataSourceSheetProperties)
  }
}
زمینه های
sheetId

integer

شناسه برگه. باید غیر منفی باشد. این فیلد پس از تنظیم قابل تغییر نیست.

title

string

نام برگه.

index

integer

نمایه ورق در صفحه گسترده. هنگام افزودن یا به‌روزرسانی ویژگی‌های برگه، اگر این قسمت حذف شود، برگه اضافه یا به انتهای فهرست برگه منتقل می‌شود. هنگام به‌روزرسانی شاخص‌های برگه یا درج برگه‌ها، حرکت در شاخص‌های «قبل از حرکت» در نظر گرفته می‌شود. برای مثال، اگر سه صفحه (S1، S2، S3) وجود داشته باشد تا S1 جلوتر از S2 حرکت کند، شاخص باید روی 2 تنظیم شود. اگر نمایه درخواستی با برگه‌های فعلی یکسان باشد، درخواست به‌روزرسانی فهرست برگه نادیده گرفته می‌شود. ایندکس یا اگر نمایه جدید درخواستی برابر با شاخص صفحه فعلی + 1 باشد.

sheetType

enum ( SheetType )

نوع ورق. پیش فرض GRID است. این فیلد پس از تنظیم قابل تغییر نیست.

gridProperties

object ( GridProperties )

خواص اضافی ورق اگر این ورق شبکه ای باشد. (اگر برگه یک شیت شیت است که حاوی نمودار یا تصویر است، این فیلد وجود ندارد.) هنگام نوشتن، تنظیم هر گونه ویژگی شبکه در برگه های غیرشبکه ای خطا است.

اگر این برگه یک برگه DATA_SOURCE باشد، این فیلد فقط خروجی است، اما حاوی ویژگی هایی است که نحوه نمایش یک صفحه منبع داده را در رابط کاربری نشان می دهد، به عنوان مثال rowCount .

hidden

boolean

اگر برگه در رابط کاربری پنهان باشد صحیح است، اگر قابل مشاهده باشد نادرست است.

tabColor
(deprecated)

object ( Color )

رنگ برگه در UI. منسوخ شده: از tabColorStyle استفاده کنید.

tabColorStyle

object ( ColorStyle )

رنگ برگه در UI. اگر tabColor نیز تنظیم شده باشد، این فیلد اولویت دارد.

rightToLeft

boolean

اگر برگه به ​​جای برگه LTR یک ورق RTL باشد درست است.

dataSourceSheetProperties

object ( DataSourceSheetProperties )

فقط خروجی در صورت وجود، فیلد حاوی ویژگی‌های خاص برگه DATA_SOURCE است.

نوع برگه

نوع ورق.

Enums
SHEET_TYPE_UNSPECIFIED مقدار پیش فرض، استفاده نکنید.
GRID ورق یک شبکه است.
OBJECT ورق شبکه ای ندارد و در عوض دارای یک شی مانند نمودار یا تصویر است.
DATA_SOURCE برگه با یک DataSource خارجی متصل می شود و پیش نمایش داده ها را نشان می دهد.

GridProperties

ویژگی های یک شبکه

نمایندگی JSON
{
  "rowCount": integer,
  "columnCount": integer,
  "frozenRowCount": integer,
  "frozenColumnCount": integer,
  "hideGridlines": boolean,
  "rowGroupControlAfter": boolean,
  "columnGroupControlAfter": boolean
}
زمینه های
rowCount

integer

تعداد ردیف ها در شبکه.

columnCount

integer

تعداد ستون ها در شبکه

frozenRowCount

integer

تعداد ردیف هایی که در شبکه ثابت شده اند.

frozenColumnCount

integer

تعداد ستون هایی که در شبکه ثابت شده اند.

hideGridlines

boolean

درست است اگر شبکه خطوط شبکه را در رابط کاربری نشان ندهد.

rowGroupControlAfter

boolean

درست است اگر کلید کنترل گروه بندی ردیف بعد از گروه نشان داده شود.

columnGroupControlAfter

boolean

درست است اگر کلید کنترل گروه بندی ستون بعد از گروه نشان داده شود.

DataSourceSheetProperties

ویژگی های اضافی یک برگه DATA_SOURCE .

نمایندگی JSON
{
  "dataSourceId": string,
  "columns": [
    {
      object (DataSourceColumn)
    }
  ],
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
زمینه های
dataSourceId

string

شناسه DataSource که برگه به ​​آن متصل است.

columns[]

object ( DataSourceColumn )

ستون های نمایش داده شده بر روی صفحه، مربوط به مقادیر در RowData .

dataExecutionStatus

object ( DataExecutionStatus )

وضعیت اجرای داده ها

GridData

داده ها در شبکه، و همچنین ابرداده در مورد ابعاد.

نمایندگی JSON
{
  "startRow": integer,
  "startColumn": integer,
  "rowData": [
    {
      object (RowData)
    }
  ],
  "rowMetadata": [
    {
      object (DimensionProperties)
    }
  ],
  "columnMetadata": [
    {
      object (DimensionProperties)
    }
  ]
}
زمینه های
startRow

integer

اولین ردیفی که این GridData به آن اشاره دارد، مبتنی بر صفر است.

startColumn

integer

اولین ستونی که این GridData به آن اشاره دارد، مبتنی بر صفر است.

rowData[]

object ( RowData )

داده های شبکه، یک ورودی در هر ردیف، با ردیف در startRow شروع می شود. مقادیر در RowData با ستون هایی که از startColumn شروع می شوند مطابقت دارد.

rowMetadata[]

object ( DimensionProperties )

ابرداده در مورد ردیف های درخواستی در شبکه، که با ردیف در startRow شروع می شود.

columnMetadata[]

object ( DimensionProperties )

ابرداده در مورد ستون های درخواستی در شبکه، که با ستون در startColumn شروع می شود.

RowData

داده های مربوط به هر سلول در یک ردیف.

نمایندگی JSON
{
  "values": [
    {
      object (CellData)
    }
  ]
}
زمینه های
values[]

object ( CellData )

مقادیر در سطر، یک در هر ستون.

ویژگی های ابعاد

خواص در مورد یک بعد

نمایندگی JSON
{
  "hiddenByFilter": boolean,
  "hiddenByUser": boolean,
  "pixelSize": integer,
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
}
زمینه های
hiddenByFilter

boolean

اگر این بعد فیلتر شود درست است. این فیلد فقط خواندنی است.

hiddenByUser

boolean

اگر این بعد به صراحت پنهان باشد درست است.

pixelSize

integer

ارتفاع (اگر یک ردیف) یا عرض (اگر یک ستون) ابعاد بر حسب پیکسل.

developerMetadata[]

object ( DeveloperMetadata )

ابرداده توسعه‌دهنده مرتبط با یک ردیف یا ستون.

dataSourceColumnReference

object ( DataSourceColumnReference )

فقط خروجی اگر تنظیم شود، این یک ستون در برگه منبع داده است.

ConditionalFormatRule

قاعده ای که یک قالب مشروط را توصیف می کند.

نمایندگی JSON
{
  "ranges": [
    {
      object (GridRange)
    }
  ],

  // Union field rule can be only one of the following:
  "booleanRule": {
    object (BooleanRule)
  },
  "gradientRule": {
    object (GradientRule)
  }
  // End of list of possible types for union field rule.
}
زمینه های
ranges[]

object ( GridRange )

محدوده هایی که در صورت درست بودن شرط فرمت می شوند. همه محدوده ها باید روی یک شبکه باشند.

rule میدان اتحادیه قانون کنترل کننده این قالب شرطی، دقیقاً باید یکی تنظیم شود. rule فقط می تواند یکی از موارد زیر باشد:
booleanRule

object ( BooleanRule )

قالب بندی طبق قانون یا "روشن" یا "خاموش" است.

gradientRule

object ( GradientRule )

قالب بندی بر اساس گرادیان در قانون متفاوت خواهد بود.

قانون بولی

قانونی که بسته به شرایط ممکن است مطابقت داشته باشد یا نباشد.

نمایندگی JSON
{
  "condition": {
    object (BooleanCondition)
  },
  "format": {
    object (CellFormat)
  }
}
زمینه های
condition

object ( BooleanCondition )

شرط قاعده. اگر شرط به درستی ارزیابی شود، قالب اعمال می شود.

format

object ( CellFormat )

فرمت برای اعمال قالب‌بندی شرطی فقط می‌تواند زیرمجموعه‌ای از قالب‌بندی را اعمال کند: bold ، italic ، strikethrough ، foreground color و background color .

GradientRule

قاعده ای که یک قالب مقیاس رنگی گرادیان را بر اساس نقاط درونیابی فهرست شده اعمال می کند. قالب یک سلول بر اساس محتوای آن در مقایسه با مقادیر نقاط درونیابی متفاوت خواهد بود.

نمایندگی JSON
{
  "minpoint": {
    object (InterpolationPoint)
  },
  "midpoint": {
    object (InterpolationPoint)
  },
  "maxpoint": {
    object (InterpolationPoint)
  }
}
زمینه های
minpoint

object ( InterpolationPoint )

نقطه شروع درون یابی

midpoint

object ( InterpolationPoint )

یک نقطه میان یابی اختیاری.

maxpoint

object ( InterpolationPoint )

نقطه درون یابی نهایی

نقطه درون یابی

یک نقطه درونیابی منفرد در قالب شرطی گرادیان. اینها مقیاس رنگ گرادیان را با توجه به رنگ، نوع و مقدار انتخاب شده پین ​​می کنند.

نمایندگی JSON
{
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  },
  "type": enum (InterpolationPointType),
  "value": string
}
زمینه های
color
(deprecated)

object ( Color )

رنگی که این نقطه درون یابی باید استفاده کند. منسوخ شده: از colorStyle استفاده کنید.

colorStyle

object ( ColorStyle )

رنگی که این نقطه درون یابی باید استفاده کند. اگر color نیز تنظیم شده باشد، این قسمت اولویت دارد.

type

enum ( InterpolationPointType )

ارزش چگونه باید تفسیر شود.

value

string

مقداری که این نقطه درونیابی استفاده می کند. ممکن است یک فرمول باشد. اگر type MIN یا MAX باشد، استفاده نمی شود.

InterpolationPointType

نوع نقطه درونیابی.

Enums
INTERPOLATION_POINT_TYPE_UNSPECIFIED مقدار پیش فرض، استفاده نکنید.
MIN نقطه درونیابی از حداقل مقدار در سلول ها در محدوده قالب شرطی استفاده می کند.
MAX نقطه درونیابی از حداکثر مقدار در سلول ها در محدوده قالب شرطی استفاده می کند.
NUMBER نقطه درونیابی دقیقاً از مقدار InterpolationPoint.value استفاده می کند.
PERCENT

نقطه درون یابی درصد داده شده در تمام سلول ها در محدوده قالب شرطی است. این معادل NUMBER =(MAX(FLATTEN(range)) * (value / 100)) + (MIN(FLATTEN(range)) * (1 - (value / 100))) هنگام مسطح کردن، محدوده نادیده گرفته می شود).

PERCENTILE نقطه درون یابی صدک داده شده در تمام سلول ها در محدوده قالب شرطی است. اگر این مقدار برابر با NUMBER است: =PERCENTILE(FLATTEN(range), value / 100) (که در آن خطاهای محدوده هنگام صاف کردن نادیده گرفته می شوند).

FilterView

نمای فیلتر

نمایندگی JSON
{
  "filterViewId": integer,
  "title": string,
  "range": {
    object (GridRange)
  },
  "namedRangeId": string,
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
زمینه های
filterViewId

integer

شناسه نمای فیلتر.

title

string

نام نمای فیلتر.

range

object ( GridRange )

محدوده ای که این نمای فیلتر پوشش می دهد.

هنگام نوشتن، فقط یکی از range یا namedRangeId ممکن است تنظیم شود.

namedRangeId

string

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

هنگام نوشتن، فقط یکی از range یا namedRangeId ممکن است تنظیم شود.

sortSpecs[]

object ( SortSpec )

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

criteria
(deprecated)

map (key: integer, value: object ( FilterCriteria ))

معیارهای نمایش / پنهان کردن مقادیر در هر ستون. کلید نقشه، نمایه ستون است و مقدار، معیار آن ستون است.

این فیلد به نفع filterSpecs منسوخ شده است.

filterSpecs[]

object ( FilterSpec )

معیارهای فیلتر برای نمایش/پنهان کردن مقادیر در هر ستون.

هم criteria و هم filterSpecs در پاسخ ها پر شده اند. اگر هر دو فیلد در یک درخواست به روز رسانی مشخص شده باشند، این فیلد اولویت دارد.

محدوده محافظت شده

یک محدوده محافظت شده

نمایندگی JSON
{
  "protectedRangeId": integer,
  "range": {
    object (GridRange)
  },
  "namedRangeId": string,
  "description": string,
  "warningOnly": boolean,
  "requestingUserCanEdit": boolean,
  "unprotectedRanges": [
    {
      object (GridRange)
    }
  ],
  "editors": {
    object (Editors)
  }
}
زمینه های
protectedRangeId

integer

شناسه محدوده حفاظت شده این فیلد فقط خواندنی است.

range

object ( GridRange )

محدوده ای که محافظت می شود. محدوده ممکن است کاملاً نامحدود باشد، در این صورت این یک صفحه محافظت شده در نظر گرفته می شود.

هنگام نوشتن، فقط یکی از range یا namedRangeId ممکن است تنظیم شود.

namedRangeId

string

محدوده نامگذاری شده این محدوده محافظت شده در صورت وجود، توسط آن پشتیبانی می شود.

هنگام نوشتن، فقط یکی از range یا namedRangeId ممکن است تنظیم شود.

description

string

شرح این محدوده حفاظت شده

warningOnly

boolean

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

هنگام نوشتن: اگر این فیلد درست باشد، editors نادیده گرفته می شوند. علاوه بر این، اگر این فیلد از درست به نادرست تغییر کند و فیلد editors تنظیم نشده باشد (و در ماسک فیلد گنجانده نشده باشد)، ویرایشگرها روی همه ویرایشگرهای سند تنظیم خواهند شد.

requestingUserCanEdit

boolean

درست است اگر کاربری که این محدوده محافظت شده را درخواست کرده است بتواند منطقه محافظت شده را ویرایش کند. این فیلد فقط خواندنی است.

unprotectedRanges[]

object ( GridRange )

لیست محدوده های محافظت نشده در یک صفحه محافظت شده. محدوده های محافظت نشده فقط در برگه های محافظت شده پشتیبانی می شوند.

editors

object ( Editors )

کاربران و گروه هایی با دسترسی ویرایش به محدوده محافظت شده. این قسمت فقط برای کاربرانی که دسترسی ویرایش به محدوده محافظت شده و سند دارند قابل مشاهده است. ویرایشگرها با حفاظت warningOnly پشتیبانی نمی شوند.

ویراستاران

ویرایشگرهای یک محدوده محافظت شده

نمایندگی JSON
{
  "users": [
    string
  ],
  "groups": [
    string
  ],
  "domainUsersCanEdit": boolean
}
زمینه های
users[]

string

آدرس ایمیل کاربران با دسترسی ویرایش به محدوده محافظت شده.

groups[]

string

آدرس‌های ایمیل گروه‌هایی که دسترسی ویرایش به محدوده محافظت شده دارند.

domainUsersCanEdit

boolean

اگر کسی در دامنه سند دسترسی ویرایش به محدوده محافظت شده داشته باشد درست است. حفاظت از دامنه فقط در اسناد داخل یک دامنه پشتیبانی می شود.

BasicFilter

فیلتر پیش‌فرض مرتبط با یک صفحه.

نمایندگی JSON
{
  "range": {
    object (GridRange)
  },
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
زمینه های
range

object ( GridRange )

محدوده ای که فیلتر پوشش می دهد.

sortSpecs[]

object ( SortSpec )

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

criteria
(deprecated)

map (key: integer, value: object ( FilterCriteria ))

معیارهای نمایش / پنهان کردن مقادیر در هر ستون. کلید نقشه، نمایه ستون است و مقدار، معیار آن ستون است.

این فیلد به نفع filterSpecs منسوخ شده است.

filterSpecs[]

object ( FilterSpec )

معیارهای فیلتر در هر ستون

هم criteria و هم filterSpecs در پاسخ ها پر شده اند. اگر هر دو فیلد در یک درخواست به روز رسانی مشخص شده باشند، این فیلد اولویت دارد.

BandedRange

محدوده نواری (رنگ های متناوب) در یک صفحه.

نمایندگی JSON
{
  "bandedRangeId": integer,
  "range": {
    object (GridRange)
  },
  "rowProperties": {
    object (BandingProperties)
  },
  "columnProperties": {
    object (BandingProperties)
  }
}
زمینه های
bandedRangeId

integer

شناسه محدوده نواری.

range

object ( GridRange )

محدوده ای که این ویژگی ها در آن اعمال می شوند.

rowProperties

object ( BandingProperties )

خواص برای نوارهای ردیف. این ویژگی ها به صورت ردیف به ردیف در تمام ردیف های محدوده اعمال می شوند. حداقل یکی از rowProperties یا columnProperties باید مشخص شود.

columnProperties

object ( BandingProperties )

ویژگی های باندهای ستون. این ویژگی ها بر اساس ستون به ستون در تمام ستون های محدوده اعمال می شوند. حداقل یکی از rowProperties یا columnProperties باید مشخص شود.

BandingProperties

ویژگی هایی که به یک بعد منفرد (اعم از ردیف یا ستون) اشاره می کنند. اگر هر دو BandedRange.row_properties و BandedRange.column_properties تنظیم شده باشند، رنگ های پر بر اساس قوانین زیر به سلول ها اعمال می شود:

به عنوان مثال، رنگ ردیف اول بر رنگ ستون اول اولویت دارد، اما رنگ ستون اول بر رنگ ردیف دوم اولویت دارد. به طور مشابه، سرصفحه سطر بر سر ستون در سلول بالا سمت چپ اولویت دارد، اما اگر سرصفحه سطر تنظیم نشده باشد، سرصفحه ستون بر رنگ سطر اول اولویت دارد.

نمایندگی JSON
{
  "headerColor": {
    object (Color)
  },
  "headerColorStyle": {
    object (ColorStyle)
  },
  "firstBandColor": {
    object (Color)
  },
  "firstBandColorStyle": {
    object (ColorStyle)
  },
  "secondBandColor": {
    object (Color)
  },
  "secondBandColorStyle": {
    object (ColorStyle)
  },
  "footerColor": {
    object (Color)
  },
  "footerColorStyle": {
    object (ColorStyle)
  }
}
زمینه های
headerColor
(deprecated)

object ( Color )

رنگ سطر یا ستون اول. اگر این فیلد تنظیم شده باشد، سطر یا ستون اول با این رنگ پر می شود و رنگ ها از ردیف یا ستون دوم به طور متناوب بین firstBandColor و secondBandColor قرار می گیرند. در غیر این صورت، سطر یا ستون اول با firstBandColor پر می شود و رنگ ها به طور معمول تغییر می کنند. منسوخ شده: از headerColorStyle استفاده کنید.

headerColorStyle

object ( ColorStyle )

رنگ سطر یا ستون اول. اگر این فیلد تنظیم شده باشد، سطر یا ستون اول با این رنگ پر می شود و رنگ ها از ردیف یا ستون دوم به طور متناوب بین firstBandColor و secondBandColor قرار می گیرند. در غیر این صورت، سطر یا ستون اول با firstBandColor پر می شود و رنگ ها به طور معمول تغییر می کنند. اگر headerColor نیز تنظیم شده باشد، این فیلد اولویت دارد.

firstBandColor
(deprecated)

object ( Color )

اولین رنگی که متناوب است. (الزامی) منسوخ شده: از firstBandColorStyle استفاده کنید.

firstBandColorStyle

object ( ColorStyle )

اولین رنگی که متناوب است. (الزامی) اگر firstBandColor نیز تنظیم شده باشد، این فیلد اولویت دارد.

secondBandColor
(deprecated)

object ( Color )

رنگ دوم که متناوب است. (الزامی) منسوخ شده: از secondBandColorStyle استفاده کنید.

secondBandColorStyle

object ( ColorStyle )

رنگ دوم که متناوب است. (الزامی) اگر secondBandColor نیز تنظیم شده باشد، این فیلد اولویت دارد.

footerColor
(deprecated)

object ( Color )

رنگ آخرین سطر یا ستون. اگر این فیلد تنظیم نشده باشد، بسته به رنگ سطر یا ستون قبلی، آخرین سطر یا ستون با firstBandColor یا secondBandColor پر می شود. منسوخ شده: از footerColorStyle استفاده کنید.

footerColorStyle

object ( ColorStyle )

رنگ آخرین سطر یا ستون. اگر این فیلد تنظیم نشده باشد، بسته به رنگ سطر یا ستون قبلی، آخرین سطر یا ستون با firstBandColor یا secondBandColor پر می شود. اگر footerColor نیز تنظیم شده باشد، این فیلد اولویت دارد.

DimensionGroup

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

نمایندگی JSON
{
  "range": {
    object (DimensionRange)
  },
  "depth": integer,
  "collapsed": boolean
}
زمینه های
range

object ( DimensionRange )

محدوده ای که این گروه در آن وجود دارد.

depth

integer

عمق گروه، نشان‌دهنده تعداد گروه‌هایی است که محدوده‌ای دارند که به طور کامل شامل محدوده این گروه است.

collapsed

boolean

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

یک مقدار واقعی به این معنی نیست که همه ابعاد در گروه پنهان هستند، زیرا نمایان بودن یک بعد می تواند مستقل از این ویژگی گروه تغییر کند. با این حال، هنگامی که این ویژگی به روز می شود، تمام ابعاد درون آن در صورت درست بودن این فیلد مخفی و در صورت نادرست بودن این فیلد روی قابل مشاهده تنظیم می شود.

برش دهنده

یک برش در یک ورق.

نمایندگی JSON
{
  "slicerId": integer,
  "spec": {
    object (SlicerSpec)
  },
  "position": {
    object (EmbeddedObjectPosition)
  }
}
زمینه های
slicerId

integer

شناسه اسلایسر.

spec

object ( SlicerSpec )

مشخصات دستگاه اسلایسر.

position

object ( EmbeddedObjectPosition )

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

SlicerSpec

مشخصات دستگاه اسلایسر

نمایندگی JSON
{
  "dataRange": {
    object (GridRange)
  },
  "filterCriteria": {
    object (FilterCriteria)
  },
  "columnIndex": integer,
  "applyToPivotTables": boolean,
  "title": string,
  "textFormat": {
    object (TextFormat)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "horizontalAlignment": enum (HorizontalAlign)
}
زمینه های
dataRange

object ( GridRange )

محدوده داده های برش دهنده.

filterCriteria

object ( FilterCriteria )

معیارهای فیلتر اسلایسر.

columnIndex

integer

شاخص ستون مبتنی بر صفر در جدول داده ای که فیلتر روی آن اعمال می شود.

applyToPivotTables

boolean

اگر فیلتر باید روی جداول محوری اعمال شود درست است. اگر تنظیم نشد، پیش‌فرض روی True است.

title

string

عنوان برش دهنده.

textFormat

object ( TextFormat )

قالب متن عنوان در اسلایسر. فیلد پیوند پشتیبانی نمی شود.

backgroundColor
(deprecated)

object ( Color )

رنگ پس زمینه اسلایسر. منسوخ شده: از backgroundColorStyle استفاده کنید.

backgroundColorStyle

object ( ColorStyle )

رنگ پس زمینه اسلایسر. اگر backgroundColor نیز تنظیم شده باشد، این فیلد اولویت دارد.

horizontalAlignment

enum ( HorizontalAlign )

تراز افقی عنوان در برش دهنده. اگر مشخص نشده باشد، پیش‌فرض روی LEFT است