- منبع: صفحه گسترده
- ویژگی های صفحه گسترده
- بازه محاسبه مجدد
- قالب سلولی
- فرمت شماره
- NumberFormatType
- رنگ
- ColorStyle
- نوع رنگ تم
- مرز ها
- مرز
- سبک
- لایه گذاری
- Horizontal Align
- Vertical Align
- WrapStrategy
- جهت متن
- فرمت متن
- ارتباط دادن
- HyperlinkDisplayType
- چرخش متن
- IterativeCalculationSettings
- قالب صفحه گسترده
- ThemeColorPair
- ورق
- SheetProperties
- نوع برگه
- GridProperties
- DataSourceSheetProperties
- DataSourceColumn
- DataSourceColumnReference
- DataExecutionStatus
- DataExecutionState
- DataExecutionErrorCode
- GridData
- RowData
- CellData
- ExtendedValue
- ErrorValue
- نوع خطا
- TextFormatRun
- Data ValidationRule
- شرایط بولی
- نوع شرط
- ConditionValue
- RelativeDate
- جدول محوری
- GridRange
- PivotGroup
- PivotGroupValueMetadata
- مرتب سازی
- PivotGroupSortValueBucket
- PivotGroupRule
- ManualRule
- ManualRuleGroup
- قانون هیستوگرام
- DateTimeRule
- DateTimeRuleType
- PivotGroupLimit
- معیارهای PivotFilter
- PivotFilterSpec
- PivotValue
- PivotValueSummarizeFunction
- PivotValueCalculatedDisplayType
- PivotValueLayout
- DataSourceTable
- DataSourceTableColumnSelectionType
- FilterSpec
- معیارهای فیلتر
- SortSpec
- DataSourceFormula
- ویژگی های ابعاد
- ConditionalFormatRule
- قانون بولی
- GradientRule
- نقطه درون یابی
- InterpolationPointType
- FilterView
- محدوده محافظت شده
- ویراستاران
- BasicFilter
- EmbeddedChart
- ChartSpec
- موقعیت متن
- DataSourceChartProperties
- BasicChartSpec
- BasicChartType
- BasicChartLegendPosition
- BasicChartAxis
- BasicChartAxisPosition
- ChartAxisViewWindowOptions
- ViewWindowMode
- BasicChartDomain
- نمودار دیتا
- ChartSourceRange
- ChartGroupRule
- ChartDateTimeRule
- ChartDateTimeRuleType
- قانون نمودار هیستوگرام
- ChartAggregateType
- BasicChartSeries
- لاین استایل
- LineDashType
- DataLabel
- DataLabelType
- DataLabel Placement
- PointStyle
- شکل نقطه
- BasicSeriesDataPointStyleOverride
- BasicChartStackedType
- BasicChartCompareMode
- PieChartSpec
- PieChartLegendPosition
- BubbleChartSpec
- BubbleChartLegendPosition
- CandlestickChartSpec
- CandlestickDomain
- CandlestickData
- Candlestick Series
- OrgChartSpec
- OrgChartNodeSize
- HistogramChartSpec
- سری هیستوگرام
- HistogramChartLegendPosition
- WaterfallChartSpec
- WaterfallChartDomain
- WaterfallChart Series
- WaterfallChartColumnStyle
- WaterfallChartCustomSubtotal
- WaterfallChartStackedType
- TreemapChartSpec
- TreemapChartColorScale
- ScorecardChartSpec
- KeyValueFormat
- BaselineValueFormat
- نوع مقایسه
- ChartNumberFormatSource
- ChartCustomNumberFormatOptions
- ChartHiddenDimensionStrategy
- EmbeddedObjectPosition
- Overlay Position
- GridCoordinate
- EmbeddedObjectBorder
- BandedRange
- BandingProperties
- DimensionGroup
- برش دهنده
- SlicerSpec
- Named Range
- منبع اطلاعات
- DataSourceSpec
- BigQueryDataSourceSpec
- BigQueryQuerySpec
- BigQueryTableSpec
- LookerDataSourceSpec
- DataSourceParameter
- DataSourceRefreshSchedule
- DataSourceRefreshScope
- DataSourceRefreshDailySchedule
- TimeOfDay
- DataSourceRefreshWeeklySchedule
- روز هفته
- DataSourceRefreshMonthlySchedule
- فاصله
- مواد و روش ها
منبع: صفحه گسترده
منبعی که یک صفحه گسترده را نشان می دهد.
نمایندگی JSON |
---|
{ "spreadsheetId": string, "properties": { object ( |
زمینه های | |
---|---|
spreadsheetId | شناسه صفحه گسترده. این فیلد فقط خواندنی است. |
properties | ویژگی های کلی یک صفحه گسترده |
sheets[] | برگه هایی که بخشی از یک صفحه گسترده هستند. |
namedRanges[] | محدوده های نامگذاری شده در یک صفحه گسترده تعریف شده است. |
spreadsheetUrl | آدرس صفحه گسترده. این فیلد فقط خواندنی است. |
developerMetadata[] | ابرداده توسعهدهنده مرتبط با صفحهگسترده. |
dataSources[] | فهرستی از منابع داده خارجی مرتبط با صفحه گسترده. |
dataSourceSchedules[] | فقط خروجی فهرستی از برنامههای بهروزرسانی منبع داده. |
ویژگی های صفحه گسترده
ویژگی های صفحه گسترده
نمایندگی JSON |
---|
{ "title": string, "locale": string, "autoRecalc": enum ( |
زمینه های | |
---|---|
title | عنوان صفحه گسترده. |
locale | محل صفحه گسترده در یکی از قالب های زیر:
توجه: هنگام بهروزرسانی این فیلد، همه زبانها/زبانها پشتیبانی نمیشوند. |
autoRecalc | مدت زمان انتظار قبل از محاسبه مجدد توابع فرار. |
timeZone | منطقه زمانی صفحه گسترده، در قالب CLDR مانند |
defaultFormat | قالب پیشفرض همه سلولهای صفحهگسترده. اگر قالب سلول با این فرمت پیش فرض برابر باشد |
iterativeCalculationSettings | تعیین می کند که آیا و چگونه مراجع دایره ای با محاسبه تکراری حل می شوند. عدم وجود این فیلد به این معنی است که ارجاعات دایره ای منجر به خطاهای محاسباتی می شود. |
spreadsheetTheme | طرح زمینه در صفحه گسترده اعمال شد. |
importFunctionsExternalUrlAccessAllowed | اجازه دسترسی به URL خارجی برای توابع تصویر و وارد کردن. فقط وقتی درست است بخوانید. وقتی غلط است، میتوانید روی true تنظیم کنید. |
بازه محاسبه مجدد
شمارشی از گزینه های احتمالی فاصله محاسبه مجدد.
Enums | |
---|---|
RECALCULATION_INTERVAL_UNSPECIFIED | مقدار پیش فرض. این مقدار نباید استفاده شود. |
ON_CHANGE | توابع فرار در هر تغییر به روز می شوند. |
MINUTE | توابع فرار در هر تغییر و هر دقیقه به روز می شوند. |
HOUR | توابع فرار در هر تغییر و ساعتی به روز می شوند. |
IterativeCalculationSettings
تنظیماتی برای کنترل نحوه حل وابستگی های دایره ای با محاسبه تکراری.
نمایندگی JSON |
---|
{ "maxIterations": integer, "convergenceThreshold": number } |
زمینه های | |
---|---|
maxIterations | وقتی محاسبه تکراری فعال است، حداکثر تعداد دورهای محاسبه برای انجام. |
convergenceThreshold | وقتی محاسبه تکراری فعال است و نتایج متوالی کمتر از این مقدار آستانه متفاوت است، دورهای محاسبه متوقف میشوند. |
قالب صفحه گسترده
موضوع صفحه گسترده را نشان می دهد
نمایندگی JSON |
---|
{
"primaryFontFamily": string,
"themeColors": [
{
object ( |
زمینه های | |
---|---|
primaryFontFamily | نام خانواده فونت اصلی |
themeColors[] | جفت رنگ تم صفحه گسترده. برای بهروزرسانی، باید همه جفتهای رنگ تم را ارائه کنید. |
ThemeColorPair
یک جفت یک نوع رنگ تم صفحهگسترده را به رنگ بتنی که نشان میدهد نگاشت میکند.
نمایندگی JSON |
---|
{ "colorType": enum ( |
زمینه های | |
---|---|
colorType | نوع رنگ تم صفحهگسترده. |
color | رنگ بتن مربوط به نوع رنگ تم. |
Named Range
محدوده ای با نام
نمایندگی JSON |
---|
{
"namedRangeId": string,
"name": string,
"range": {
object ( |
زمینه های | |
---|---|
namedRangeId | شناسه محدوده نامگذاری شده |
name | نام محدوده نامگذاری شده. |
range | محدوده ای که این نشان می دهد. |
منبع اطلاعات
اطلاعات مربوط به یک منبع داده خارجی در صفحه گسترده.
نمایندگی JSON |
---|
{ "dataSourceId": string, "spec": { object ( |
زمینه های | |
---|---|
dataSourceId | شناسه منحصر به فرد با دامنه صفحه گسترده که منبع داده را شناسایی می کند. مثال: 1080547365. |
spec | |
calculatedColumns[] | تمام ستون های محاسبه شده در منبع داده. |
sheetId | شناسه هنگام ایجاد یک منبع داده، یک برگه |
DataSourceSpec
این جزئیات منبع داده را مشخص می کند. به عنوان مثال، برای BigQuery، این اطلاعات مربوط به منبع BigQuery را مشخص می کند.
نمایندگی JSON |
---|
{ "parameters": [ { object ( |
زمینه های | |
---|---|
parameters[] | پارامترهای منبع داده که هنگام پرس و جو از منبع داده استفاده می شود. |
spec میدان اتحادیه مشخصات واقعی برای هر نوع منبع داده. spec می تواند تنها یکی از موارد زیر باشد: | |
bigQuery | |
looker | یک |
BigQueryDataSourceSpec
مشخصات یک منبع داده BigQuery که به یک برگه متصل است.
نمایندگی JSON |
---|
{ "projectId": string, // Union field |
زمینه های | |
---|---|
projectId | شناسه پروژه Google Cloud فعال BigQuery با یک حساب صورتحساب پیوست شده است. برای هر درخواستی که علیه منبع داده اجرا می شود، پروژه هزینه می شود. |
spec میدان اتحادیه مشخصات واقعی spec می تواند تنها یکی از موارد زیر باشد: | |
querySpec | یک |
tableSpec | یک |
BigQueryQuerySpec
یک کوئری سفارشی BigQuery را مشخص می کند.
نمایندگی JSON |
---|
{ "rawQuery": string } |
زمینه های | |
---|---|
rawQuery | رشته پرس و جو خام. |
BigQueryTableSpec
تعریف جدول BigQuery را مشخص می کند. فقط جداول بومی مجاز هستند.
نمایندگی JSON |
---|
{ "tableProjectId": string, "tableId": string, "datasetId": string } |
زمینه های | |
---|---|
tableProjectId | شناسه پروژه BigQuery که جدول به آن تعلق دارد. اگر مشخص نشده باشد، |
tableId | شناسه جدول BigQuery. |
datasetId | شناسه مجموعه داده BigQuery. |
LookerDataSourceSpec
مشخصات یک منبع داده Looker.
نمایندگی JSON |
---|
{ "instanceUri": string, "model": string, "explore": string } |
زمینه های | |
---|---|
instanceUri | URL نمونه Looker. |
model | نام یک مدل Looker. |
explore | نام یک مدل Looker کاوش. |
DataSourceParameter
یک پارامتر در پرس و جو منبع داده. این پارامتر به کاربر اجازه می دهد تا مقادیر را از صفحه گسترده به یک پرس و جو منتقل کند.
نمایندگی JSON |
---|
{ // Union field |
زمینه های | |
---|---|
identifier فیلد اتحادیه شناسه پارامتر identifier می تواند تنها یکی از موارد زیر باشد: | |
name | پارامتر نامگذاری شده باید یک شناسه قانونی برای |
value فیلد اتحادیه مقدار پارامتر value فقط می تواند یکی از موارد زیر باشد: | |
namedRangeId | شناسه یک |
range | محدوده ای که حاوی مقدار پارامتر است. اندازه آن باید 1x1 باشد. |
DataSourceRefreshSchedule
زمانبندی برای تازه کردن منبع داده.
منابع داده در صفحه گسترده در یک بازه زمانی به روز می شوند. میتوانید زمان شروع را با کلیک کردن روی دکمه بازخوانی زمانبندی شده در ویرایشگر برگهها مشخص کنید، اما فاصله زمانی 4 ساعت ثابت است. به عنوان مثال، اگر زمان شروع را 8 صبح مشخص کنید، بازخوانی هر روز بین ساعت 8 صبح تا 12 بعد از ظهر انجام می شود.
نمایندگی JSON |
---|
{ "enabled": boolean, "refreshScope": enum ( |
زمینه های | |
---|---|
enabled | اگر برنامه بازخوانی فعال باشد درست است یا در غیر این صورت نادرست است. |
refreshScope | دامنه تجدید. باید |
nextRun | فقط خروجی فاصله زمانی اجرای بعدی. |
فیلد اتحادیه schedule_config . تنظیمات زمانبندی schedule_config تنها می تواند یکی از موارد زیر باشد: | |
dailySchedule | برنامه به روز رسانی روزانه. |
weeklySchedule | برنامه به روز رسانی هفتگی |
monthlySchedule | برنامه به روز رسانی ماهانه. |
DataSourceRefreshScope
حوزه های تازه سازی منبع داده.
Enums | |
---|---|
DATA_SOURCE_REFRESH_SCOPE_UNSPECIFIED | مقدار پیش فرض، استفاده نکنید. |
ALL_DATA_SOURCES | همه منابع داده و اشیاء منبع داده مرتبط با آنها را در صفحه گسترده بازخوانی می کند. |
DataSourceRefreshDailySchedule
برنامه ای برای به روز رسانی داده ها هر روز در یک بازه زمانی معین.
نمایندگی JSON |
---|
{
"startTime": {
object ( |
زمینه های | |
---|---|
startTime | زمان شروع یک بازه زمانی که در آن یک به روز رسانی منبع داده برنامه ریزی شده است. فقط قسمت |
TimeOfDay
یک زمان از روز را نشان می دهد. تاریخ و منطقه زمانی یا مهم نیستند یا در جای دیگری مشخص شده اند. یک API ممکن است اجازه دهد ثانیه های کبیسه را مجاز کند. انواع مرتبط عبارتند از google.type.Date
و google.protobuf.Timestamp
.
نمایندگی JSON |
---|
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer } |
زمینه های | |
---|---|
hours | ساعات روز در قالب 24 ساعته. باید از 0 تا 23 باشد. یک API ممکن است برای سناریوهایی مانند زمان بسته شدن کسب و کار، مقدار "24:00:00" را مجاز کند. |
minutes | دقیقه از ساعت روز. باید از 0 تا 59 باشد. |
seconds | ثانیه های دقیقه از زمان. معمولاً باید از 0 تا 59 باشد. یک API ممکن است مقدار 60 را مجاز کند اگر ثانیه های کبیسه را مجاز کند. |
nanos | کسری از ثانیه در نانوثانیه. باید از 0 تا 999,999,999 باشد. |
DataSourceRefreshWeeklySchedule
یک برنامه هفتگی برای بازنگری داده ها در روزهای خاص در یک بازه زمانی معین.
نمایندگی JSON |
---|
{ "startTime": { object ( |
زمینه های | |
---|---|
startTime | زمان شروع یک بازه زمانی که در آن یک به روز رسانی منبع داده برنامه ریزی شده است. فقط قسمت |
daysOfWeek[] | روزهای هفته برای تازه کردن. حداقل یک روز باید مشخص شود. |
روز هفته
یک روز از هفته را نشان می دهد.
Enums | |
---|---|
DAY_OF_WEEK_UNSPECIFIED | روز هفته نامشخص است. |
MONDAY | دوشنبه |
TUESDAY | سهشنبه |
WEDNESDAY | چهار شنبه |
THURSDAY | پنج شنبه |
FRIDAY | جمعه |
SATURDAY | شنبه |
SUNDAY | یکشنبه |
DataSourceRefreshMonthlySchedule
یک برنامه ماهانه برای بازخوانی داده ها در روزهای خاصی در ماه در یک بازه زمانی معین.
نمایندگی JSON |
---|
{
"startTime": {
object ( |
زمینه های | |
---|---|
startTime | زمان شروع یک بازه زمانی که در آن یک به روز رسانی منبع داده برنامه ریزی شده است. فقط قسمت |
daysOfMonth[] | روزهای ماه برای تازه کردن. فقط 1-28 پشتیبانی می شود، نقشه برداری از روز 1 تا 28. حداقل یک روز باید مشخص شود. |
فاصله
یک بازه زمانی را نشان میدهد که بهعنوان شروع مهر زمانی (شامل) و پایان مهر زمانی (انحصاری) کدگذاری میشود.
شروع باید کمتر یا مساوی با پایان باشد. هنگامی که شروع برابر با پایان است، فاصله خالی است (هیچ زمانی مطابقت ندارد). وقتی شروع و پایان هر دو نامشخص هستند، فاصله زمانی با هر زمانی مطابقت دارد.
نمایندگی JSON |
---|
{ "startTime": string, "endTime": string } |
زمینه های | |
---|---|
startTime | اختیاری. شروع فراگیر فاصله اگر مشخص شده باشد، مهر زمانی مطابق با این بازه زمانی باید یکسان یا پس از شروع باشد. |
endTime | اختیاری. پایان انحصاری فاصله اگر مشخص شده باشد، یک مهر زمانی مطابق با این فاصله باید قبل از پایان باشد. |
مواد و روش ها | |
---|---|
| یک یا چند به روز رسانی را در صفحه گسترده اعمال می کند. |
| یک صفحه گسترده ایجاد می کند و صفحه گسترده ایجاد شده جدید را برمی گرداند. |
| صفحه گسترده را در شناسه داده شده برمی گرداند. |
| صفحه گسترده را در شناسه داده شده برمی گرداند. |