Cells

داده سلولی

اطلاعات مربوط به یک سلول خاص.

نمایش 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)
  },
  "chipRuns": [
    {
      object (ChipRun)
    }
  ]
}
فیلدها
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 )

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

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

dataValidation

object ( DataValidationRule )

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

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

pivotTable

object ( PivotTable )

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

dataSourceTable

object ( DataSourceTable )

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

dataSourceFormula

object ( DataSourceFormula )

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

chipRuns[]

object ( ChipRun )

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

هنگام خواندن، تمام نسخه‌های چیپ‌دار و بدون چیپ لحاظ می‌شوند. نسخه‌های بدون چیپ دارای یک Chip خالی خواهند بود.

هنگام نوشتن، فقط اجراهایی که دارای چیپ هستند لحاظ می‌شوند. اجراهایی که حاوی چیپ هستند، طول ۱ دارند و در متن وارد شده توسط کاربر با نماد "@" نمایش داده می‌شوند. اجراهای جدید، اجراهای قبلی را بازنویسی می‌کنند. نوشتن یک userEnteredValue جدید، اجراهای قبلی را پاک می‌کند.

قالب سلولی

قالب یک سلول.

نمایش 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 )

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

textDirection

enum ( TextDirection )

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

textFormat

object ( TextFormat )

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

textRotation

object ( TextRotation )

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

قالب شماره

قالب عددی یک سلول.

نمایش JSON 
{
  "type": enum (NumberFormatType),
  "pattern": string
}
فیلدها
type

enum ( NumberFormatType )

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

pattern

string

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

نوع قالب شماره

قالب عددی سلول. در این مستندات، فرض بر این است که زبان محلی en_US است، اما قالب واقعی به زبان محلی صفحه گسترده بستگی دارد.

انوم‌ها
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

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

color
(deprecated)

object ( Color )

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

colorStyle

object ( ColorStyle )

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

سبک

سبک حاشیه.

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

بالشتک

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

نمایش JSON 
{
  "top": integer,
  "right": integer,
  "bottom": integer,
  "left": integer
}
فیلدها
top

integer

لایه گذاری بالای سلول.

right

integer

فاصله‌گذاری مناسب سلول.

bottom

integer

لایه گذاری پایین سلول.

left

integer

فاصله‌ی سمت چپ سلول.

تراز عمودی

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

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

استراتژی Wrap

نحوه قرار دادن متن در یک سلول.

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

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

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

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

| 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.  |

جهت متن

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

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

نوع نمایش هایپرلینک

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

انوم‌ها
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 فیلد Union. نوع چرخش، عمودی یا زاویه‌دار. type می‌تواند فقط یکی از موارد زیر باشد:
angle

integer

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

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

vertical

boolean

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

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

اجرای قالب متن

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

نمایش JSON 
{
  "startIndex": integer,
  "format": {
    object (TextFormat)
  }
}
فیلدها
startIndex

integer

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

format

object ( TextFormat )

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

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

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

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

object ( BooleanCondition )

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

inputMessage

string

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

strict

boolean

اگر داده‌های نامعتبر باید رد شوند، صحیح است.

showCustomUi

boolean

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

جدول منبع داده

یک جدول منبع داده، که به کاربر اجازه می‌دهد یک جدول استاتیک از داده‌ها را از 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

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

dataExecutionStatus

object ( DataExecutionStatus )

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

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

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

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

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

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

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

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

نمایش JSON 
{
  "dataSourceId": string,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
فیلدها
dataSourceId

string

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

dataExecutionStatus

object ( DataExecutionStatus )

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

چیپ ران

اجرای یک تراشه. تراشه تا شاخص شروع اجرای بعدی ادامه می‌یابد.

نمایش JSON 
{
  "startIndex": integer,
  "chip": {
    object (Chip)
  }
}
فیلدها
startIndex

integer

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

chip

object ( Chip )

اختیاری. تراشه این اجرا.

تراشه

تراشه هوشمند.

نمایش JSON 
{

  // Union field properties can be only one of the following:
  "personProperties": {
    object (PersonProperties)
  },
  "richLinkProperties": {
    object (RichLinkProperties)
  }
  // End of list of possible types for union field properties.
}
فیلدها
properties فیلد Union. ویژگی‌های تراشه. properties می‌توانند فقط یکی از موارد زیر باشند:
personProperties

object ( PersonProperties )

ویژگی‌های یک شخص مرتبط.

ویژگی‌های شخص

ویژگی‌های مختص به یک شخص لینک‌شده.

نمایش JSON 
{
  "email": string,
  "displayFormat": enum (DisplayFormat)
}
فیلدها
email

string

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

displayFormat

enum ( DisplayFormat )

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

قالب نمایش

قالب نمایش ترجیحی در صورت وجود.

انوم‌ها
DISPLAY_FORMAT_UNSPECIFIED مقدار پیش‌فرض، استفاده نکنید.
DEFAULT قالب نمایش پیش‌فرض.
LAST_NAME_COMMA_FIRST_NAME قالب نمایش نام خانوادگی، نام.
EMAIL قالب نمایش ایمیل

RichLinkProperties

ویژگی‌های یک لینک به یک منبع گوگل (مانند یک فایل در درایو، یک ویدیوی یوتیوب، یک آدرس نقشه یا یک رویداد تقویم). فقط فایل‌های درایو را می‌توان به صورت چیپ نوشت. سایر انواع لینک‌های غنی فقط خواندنی هستند.

URI ها هنگام نوشتن نمی‌توانند از 2000 بایت تجاوز کنند.

نکته: نوشتن چیپ‌های فایل درایو حداقل به یکی از حوزه‌های drive.file ، drive.readonly یا drive OAuth نیاز دارد.

نمایش JSON 
{
  "uri": string,
  "mimeType": string
}
فیلدها
uri

string

الزامی. آدرس اینترنتی (URI) لینک. این آدرس همیشه وجود دارد.

mimeType

string

فقط خروجی. نوع MIME لینک، در صورت وجود (مثلاً وقتی فایلی در Drive است).