Cells

CellData

داده های مربوط به یک سلول خاص

نمایندگی JSON
{
  "userEnteredValue": {
    object (ExtendedValue)
  },
  "effectiveValue": {
    object (ExtendedValue)
  },
  "formattedValue": string,
  "userEnteredFormat": {
    object (CellFormat)
  },
  "effectiveFormat": {
    object (CellFormat)
  },
  "hyperlink": string,
  "note": string,
  "textFormatRuns": [
    {
      object (TextFormatRun)
    }
  ],
  "dataValidation": {
    object (DataValidationRule)
  },
  "pivotTable": {
    object (PivotTable)
  },
  "dataSourceTable": {
    object (DataSourceTable)
  },
  "dataSourceFormula": {
    object (DataSourceFormula)
  }
}
زمینه های
userEnteredValue

object ( ExtendedValue )

مقداری که کاربر در سلول وارد کرده است. به عنوان مثال، 1234 ، 'Hello' ، یا =NOW() توجه: تاریخ ها، زمان ها و DateTimes به صورت دوتایی در قالب serial number نمایش داده می شوند.

effectiveValue

object ( ExtendedValue )

ارزش موثر سلول برای سلول های دارای فرمول، این مقدار محاسبه شده است. برای سلول‌های دارای لفظ، این همان userEnteredValue است. این فیلد فقط خواندنی است.

formattedValue

string

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

userEnteredFormat

object ( CellFormat )

قالبی که کاربر برای سلول وارد کرده است.

هنگام نوشتن، قالب جدید با قالب موجود ادغام می شود.

effectiveFormat

object ( CellFormat )

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

note

string

هر یادداشتی روی سلول

textFormatRuns[]

object ( TextFormatRun )

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

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

dataValidation

object ( DataValidationRule )

یک قانون اعتبارسنجی داده در سلول، در صورت وجود.

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

pivotTable

object ( PivotTable )

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

dataSourceTable

object ( DataSourceTable )

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

dataSourceFormula

object ( DataSourceFormula )

فقط خروجی اطلاعات مربوط به فرمول منبع داده در سلول. اگر userEnteredValue فرمولی باشد که به برگه DATA_SOURCE ارجاع می دهد، این فیلد تنظیم می شود، به عنوان مثال =SUM(DataSheet!Column) .

قالب سلولی

قالب یک سلول

نمایندگی JSON
{
  "numberFormat": {
    object (NumberFormat)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "borders": {
    object (Borders)
  },
  "padding": {
    object (Padding)
  },
  "horizontalAlignment": enum (HorizontalAlign),
  "verticalAlignment": enum (VerticalAlign),
  "wrapStrategy": enum (WrapStrategy),
  "textDirection": enum (TextDirection),
  "textFormat": {
    object (TextFormat)
  },
  "hyperlinkDisplayType": enum (HyperlinkDisplayType),
  "textRotation": {
    object (TextRotation)
  }
}
زمینه های
numberFormat

object ( NumberFormat )

قالبی که توضیح می دهد چگونه مقادیر عددی باید به کاربر نمایش داده شوند.

backgroundColor
(deprecated)

object ( Color )

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

backgroundColorStyle

object ( ColorStyle )

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

borders

object ( Borders )

مرزهای سلول.

padding

object ( Padding )

لایه بندی سلول.

horizontalAlignment

enum ( HorizontalAlign )

تراز افقی مقدار در سلول.

verticalAlignment

enum ( VerticalAlign )

تراز عمودی مقدار در سلول.

wrapStrategy

enum ( WrapStrategy )

استراتژی wrap برای مقدار موجود در سلول.

textDirection

enum ( TextDirection )

جهت متن در سلول.

textFormat

object ( TextFormat )

قالب متن در سلول (مگر اینکه توسط فرمت اجرا شده لغو شود). تنظیم یک پیوند در سطح سلول در اینجا پیوندهای موجود سلول را پاک می کند. تنظیم فیلد پیوند در TextFormatRun بر پیوند سطح سلول اولویت دارد.

textRotation

object ( TextRotation )

چرخش اعمال شده به متن در سلول.

فرمت شماره

قالب شماره یک سلول

نمایندگی JSON
{
  "type": enum (NumberFormatType),
  "pattern": string
}
زمینه های
type

enum ( NumberFormatType )

نوع قالب اعداد هنگام نوشتن، این فیلد باید تنظیم شود.

pattern

string

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

NumberFormatType

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

Enums
NUMBER_FORMAT_TYPE_UNSPECIFIED قالب شماره مشخص نشده است و بر اساس محتویات سلول است. به صراحت از این استفاده نکنید.
TEXT قالب بندی متن، به عنوان مثال 1000.12
NUMBER قالب بندی اعداد، به عنوان مثال، 1,000.12
PERCENT درصد قالب‌بندی، به عنوان مثال 10.12%
CURRENCY قالب بندی ارز، به عنوان مثال $1,000.12
DATE قالب بندی تاریخ، به عنوان مثال 9/26/2008
TIME قالب بندی زمان، به عنوان مثال 3:59:00 PM
DATE_TIME قالب بندی تاریخ + زمان، به عنوان مثال 9/26/08 15:59:00
SCIENTIFIC قالب بندی اعداد علمی، به عنوان مثال 1.01E+03

مرز ها

مرزهای سلول.

نمایندگی JSON
{
  "top": {
    object (Border)
  },
  "bottom": {
    object (Border)
  },
  "left": {
    object (Border)
  },
  "right": {
    object (Border)
  }
}
زمینه های
top

object ( Border )

حاشیه بالای سلول.

bottom

object ( Border )

حاشیه پایین سلول.

left

object ( Border )

حاشیه سمت چپ سلول.

right

object ( Border )

مرز سمت راست سلول.

مرز

یک مرز در امتداد یک سلول.

نمایندگی JSON
{
  "style": enum (Style),
  "width": integer,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}
زمینه های
style

enum ( Style )

سبک حاشیه.

width
(deprecated)

integer

عرض حاشیه، بر حسب پیکسل. منسوخ؛ عرض توسط فیلد "سبک" تعیین می شود.

color
(deprecated)

object ( Color )

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

colorStyle

object ( ColorStyle )

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

سبک

سبک یک حاشیه.

Enums
STYLE_UNSPECIFIED سبک مشخص نشده است. از این استفاده نکنید.
DOTTED حاشیه نقطه چین است.
DASHED مرز شکسته است.
SOLID حاشیه یک خط جامد نازک است.
SOLID_MEDIUM حاشیه یک خط توپر متوسط ​​است.
SOLID_THICK حاشیه یک خط جامد ضخیم است.
NONE بدون مرز فقط هنگام به روز رسانی یک حاشیه به منظور پاک کردن آن استفاده می شود.
DOUBLE مرز دو خط ثابت است.

لایه گذاری

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

نمایندگی JSON
{
  "top": integer,
  "right": integer,
  "bottom": integer,
  "left": integer
}
زمینه های
top

integer

لایه بالایی سلول.

right

integer

بالشتک سمت راست سلول.

bottom

integer

بالشتک پایین سلول.

left

integer

لایه سمت چپ سلول.

Vertical Align

تراز عمودی متن در یک سلول.

Enums
VERTICAL_ALIGN_UNSPECIFIED تراز عمودی مشخص نشده است. از این استفاده نکنید.
TOP متن به صراحت در بالای سلول تراز شده است.
MIDDLE متن به صراحت در وسط سلول تراز شده است.
BOTTOM متن به صراحت در پایین سلول تراز شده است.

WrapStrategy

نحوه پیچیدن متن در یک سلول

Enums
WRAP_STRATEGY_UNSPECIFIED مقدار پیش فرض، استفاده نکنید.
OVERFLOW_CELL

خطوطی که بیشتر از عرض سلول هستند، تا زمانی که آن خانه خالی باشد، در سلول بعدی روی نوشته می شوند. اگر سلول بعدی خالی نباشد، مانند CLIP عمل می کند. متن هرگز به خط بعدی نمی رسد مگر اینکه کاربر به صورت دستی خط جدیدی را وارد کند. مثال:

| First sentence. |
| Manual newline that is very long. <- Text continues into next cell
| Next newline.   |
LEGACY_WRAP

این استراتژی بسته‌بندی نشان‌دهنده استراتژی بسته‌بندی قدیمی Google Sheets است که در آن کلماتی که طولانی‌تر از یک خط هستند به جای شکستن بریده می‌شوند. این استراتژی در همه پلتفرم ها پشتیبانی نمی شود و در حال حذف شدن است. مثال:

| Cell has a |
| loooooooooo| <- Word is clipped.
| word.      |
CLIP

خطوطی که بیشتر از عرض سلول هستند بریده می شوند. متن هرگز به خط بعدی نمی رسد مگر اینکه کاربر به صورت دستی خط جدیدی را وارد کند. مثال:

| First sentence. |
| Manual newline t| <- Text is clipped
| Next newline.   |
WRAP

کلماتی که طولانی تر از یک خط هستند به جای بریده شدن در سطح کاراکتر پیچیده می شوند. مثال:

| Cell has a |
| loooooooooo| <- Word is broken.
| ong word.  |

جهت متن

جهت متن در یک سلول

Enums
TEXT_DIRECTION_UNSPECIFIED جهت متن مشخص نشده است. از این استفاده نکنید.
LEFT_TO_RIGHT جهت متن از چپ به راست توسط کاربر تنظیم شده است.
RIGHT_TO_LEFT جهت متن از راست به چپ توسط کاربر تنظیم شده است.

HyperlinkDisplayType

آیا باید به طور صریح یک هایپرلینک ارائه شود. اگر مشخص نشده باشد، پیوند پیوند داده می شود.

Enums
LINKED یک هایپرلینک باید به صراحت ارائه شود.
PLAIN_TEXT هایپرلینک نباید ارائه شود.

چرخش متن

چرخش اعمال شده روی متن در یک سلول.

نمایندگی JSON
{

  // Union field type can be only one of the following:
  "angle": integer,
  "vertical": boolean
  // End of list of possible types for union field type.
}
زمینه های
type فیلد اتحادیه نوع چرخش، عمودی یا زاویه دار. type می تواند تنها یکی از موارد زیر باشد:
angle

integer

زاویه بین جهت استاندارد و جهت دلخواه. بر حسب درجه اندازه گیری می شود. مقادیر معتبر بین 90- و 90 هستند. زوایای مثبت به سمت بالا و منفی به سمت پایین زاویه دارند.

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

vertical

boolean

اگر درست باشد، متن از بالا به پایین خوانده می‌شود، اما جهت نویسه‌ها تغییری نکرده است. مثلا:

| V |
| e |
| r |
| t |
| i |
| c |
| a |
| l |

TextFormatRun

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

نمایندگی JSON
{
  "startIndex": integer,
  "format": {
    object (TextFormat)
  }
}
زمینه های
startIndex

integer

شاخص کاراکتر مبتنی بر صفر که این اجرا از آنجا شروع می شود، در واحد کد UTF-16.

format

object ( TextFormat )

فرمت این اجرا مقادیر غایب فرمت سلول را به ارث می برند.

Data ValidationRule

یک قانون اعتبار سنجی داده ها

نمایندگی JSON
{
  "condition": {
    object (BooleanCondition)
  },
  "inputMessage": string,
  "strict": boolean,
  "showCustomUi": boolean
}
زمینه های
condition

object ( BooleanCondition )

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

inputMessage

string

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

strict

boolean

درست است اگر داده های نامعتبر باید رد شوند.

showCustomUi

boolean

درست است اگر UI باید بر اساس نوع شرایط سفارشی شود. اگر درست باشد، شرایط "فهرست" یک کشویی نشان می دهد.

DataSourceTable

یک جدول منبع داده، که به کاربر اجازه می دهد یک جدول استاتیک از داده ها را از DataSource به Sheets وارد کند. این در ویرایشگر Sheets به عنوان "Extract" نیز شناخته می شود.

نمایندگی JSON
{
  "dataSourceId": string,
  "columnSelectionType": enum (DataSourceTableColumnSelectionType),
  "columns": [
    {
      object (DataSourceColumnReference)
    }
  ],
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ],
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "rowLimit": integer,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
زمینه های
dataSourceId

string

شناسه منبع داده که جدول منبع داده با آن مرتبط است.

columnSelectionType

enum ( DataSourceTableColumnSelectionType )

نوع انتخاب ستون‌ها برای جدول منبع داده. پیش‌فرض SELECTED است.

columns[]

object ( DataSourceColumnReference )

ستون های انتخاب شده برای جدول منبع داده. columnSelectionType باید SELECTED شود.

filterSpecs[]

object ( FilterSpec )

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

sortSpecs[]

object ( SortSpec )

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

rowLimit

integer

محدودیت ردیف برای بازگشت. اگر تنظیم نشود، یک محدودیت پیش‌فرض اعمال می‌شود. لطفاً برای اطلاع از حد پیش‌فرض و حداکثر به ویرایشگر Sheets مراجعه کنید.

dataExecutionStatus

object ( DataExecutionStatus )

فقط خروجی وضعیت اجرای داده ها

DataSourceTableColumnSelectionType

انواع انتخاب ستون جدول منبع داده.

Enums
DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED نوع انتخاب ستون پیش فرض، استفاده نکنید.
SELECTED ستون های مشخص شده توسط فیلد columns را انتخاب کنید.
SYNC_ALL

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

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

DataSourceFormula

فرمول منبع داده

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

string

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

dataExecutionStatus

object ( DataExecutionStatus )

فقط خروجی وضعیت اجرای داده ها