สี
แสดงสีในพื้นที่สี RGBA การนำเสนอนี้ออกแบบมาเพื่อความเรียบง่ายในการแปลงค่าเป็นและเปลี่ยนจากการแสดงสีในภาษาต่างๆ มากกว่าความกะทัดรัด เช่น อาจระบุช่องของการนำเสนอนี้ให้กับตัวสร้างของ java.awt.Color
ใน Java ได้เล็กน้อย และยังระบุได้ในเมธอด +colorWithRed:green:blue:alpha
ของ UIColor ใน iOS เพียงเล็กน้อย และปรับการจัดรูปแบบเป็นสตริง CSS rgba()
ใน JavaScript ได้ง่ายๆ ด้วยการดำเนินการเพียงเล็กน้อย
หน้าข้อมูลอ้างอิงนี้ไม่มีข้อมูลเกี่ยวกับพื้นที่สีสัมบูรณ์ที่ควรใช้ในการตีความค่า RGB เช่น sRGB, Adobe RGB, DCI-P3 และ BT.2020 โดยค่าเริ่มต้น แอปพลิเคชันควรใช้พื้นที่สี sRGB
เมื่อต้องตัดสินใจเรื่องความเท่าเทียมของสี การติดตั้งใช้งานจะถือว่า 2 สีเท่ากันหากค่าสีแดง เขียว น้ำเงิน และอัลฟ่าทั้งหมดต่างกันไม่เกิน 1e-5
สี เว้นแต่จะระบุไว้เป็นอย่างอื่น
ตัวอย่าง (Java):
import com.google.type.Color;
// ...
public static java.awt.Color fromProto(Color protocolor) {
float alpha = protocolor.hasAlpha()
? protocolor.getAlpha().getValue()
: 1.0;
return new java.awt.Color(
protocolor.getRed(),
protocolor.getGreen(),
protocolor.getBlue(),
alpha);
}
public static Color toProto(java.awt.Color color) {
float red = (float) color.getRed();
float green = (float) color.getGreen();
float blue = (float) color.getBlue();
float denominator = 255.0;
Color.Builder resultBuilder =
Color
.newBuilder()
.setRed(red / denominator)
.setGreen(green / denominator)
.setBlue(blue / denominator);
int alpha = color.getAlpha();
if (alpha != 255) {
result.setAlpha(
FloatValue
.newBuilder()
.setValue(((float) alpha) / denominator)
.build());
}
return resultBuilder.build();
}
// ...
ตัวอย่าง (iOS / Obj-C):
// ...
static UIColor* fromProto(Color* protocolor) {
float red = [protocolor red];
float green = [protocolor green];
float blue = [protocolor blue];
FloatValue* alpha_wrapper = [protocolor alpha];
float alpha = 1.0;
if (alpha_wrapper != nil) {
alpha = [alpha_wrapper value];
}
return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
}
static Color* toProto(UIColor* color) {
CGFloat red, green, blue, alpha;
if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
return nil;
}
Color* result = [[Color alloc] init];
[result setRed:red];
[result setGreen:green];
[result setBlue:blue];
if (alpha <= 0.9999) {
[result setAlpha:floatWrapperWithValue(alpha)];
}
[result autorelease];
return result;
}
// ...
ตัวอย่าง (JavaScript):
// ...
var protoToCssColor = function(rgbColor) {
var redFrac = rgbColor.red || 0.0;
var greenFrac = rgbColor.green || 0.0;
var blueFrac = rgbColor.blue || 0.0;
var red = Math.floor(redFrac * 255);
var green = Math.floor(greenFrac * 255);
var blue = Math.floor(blueFrac * 255);
if (!('alpha' in rgbColor)) {
return rgbToCssColor(red, green, blue);
}
var alphaFrac = rgbColor.alpha.value || 0.0;
var rgbParams = [red, green, blue].join(',');
return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
};
var rgbToCssColor = function(red, green, blue) {
var rgbNumber = new Number((red << 16) | (green << 8) | blue);
var hexString = rgbNumber.toString(16);
var missingZeros = 6 - hexString.length;
var resultBuilder = ['#'];
for (var i = 0; i < missingZeros; i++) {
resultBuilder.push('0');
}
resultBuilder.push(hexString);
return resultBuilder.join('');
};
// ...
การแสดง JSON |
---|
{ "red": number, "green": number, "blue": number, "alpha": number } |
ช่อง | |
---|---|
red
|
จํานวนสีแดงในสีเป็นค่าในช่วง [0, 1] |
green
|
ปริมาณสีเขียวในสีเป็นค่าในช่วง [0, 1] |
blue
|
ปริมาณสีน้ำเงินในสีเป็นค่าในช่วง [0, 1] |
alpha
|
ส่วนของสีนี้ที่ควรนำไปใช้กับพิกเซล นั่นคือ สีพิกเซลสุดท้ายจะกำหนดด้วยสมการต่อไปนี้
หมายความว่าค่า 1.0 จะสอดคล้องกับสีทึบ ขณะที่ค่า 0.0 คือสีที่โปร่งใสโดยสมบูรณ์ วิธีนี้ใช้ข้อความ Wrapper แทนที่จะเป็นสเกลาร์ลอยตัวแบบง่ายเพื่อให้แยกความแตกต่างระหว่างค่าเริ่มต้นกับค่าที่ไม่ได้ตั้งค่าได้ หากไม่ระบุ วัตถุสีนี้จะแสดงเป็นสีทึบ (เสมือนว่าค่าอัลฟ่าได้รับการระบุอย่างชัดเจนว่าเป็น 1.0) |
ColorStyle
ค่าสี
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ช่องการรวม kind ชนิดของค่าสี
kind
ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น
|
|
rgbColor
|
สี RGB โดยทั่วไปแล้ว ระบบไม่รองรับค่า |
themeColor
|
สีของธีม |
ThemeColorType
ประเภทสีธีม
SpreadsheetProperties
มี SpreadsheetTheme
ที่กำหนดการแมปประเภทสีธีมเหล่านี้กับสีคอนกรีต
Enum | |
---|---|
THEME_COLOR_TYPE_UNSPECIFIED
|
สีธีมที่ไม่ระบุ |
TEXT
|
แสดงสีข้อความหลัก |
BACKGROUND
|
แสดงสีพื้นหลังหลัก |
ACCENT1
|
แสดงสีเฉพาะจุดสีแรก |
ACCENT2
|
แสดงสีเฉพาะจุดที่สอง |
ACCENT3
|
แสดงสีเฉพาะจุดที่สาม |
ACCENT4
|
แสดงสีเฉพาะจุดที่ 4 |
ACCENT5
|
แสดงสีเฉพาะจุดที่ 5 |
ACCENT6
|
แสดงสีเฉพาะจุดที่ 6 |
LINK
|
แสดงสีที่ใช้สำหรับไฮเปอร์ลิงก์ |
HorizontalAlign
การจัดข้อความแนวนอนในเซลล์
Enum | |
---|---|
HORIZONTAL_ALIGN_UNSPECIFIED
|
ไม่ได้ระบุการจัดข้อความแนวนอน ห้ามใช้ |
LEFT
|
ข้อความจะอยู่ทางด้านซ้ายของเซลล์อย่างชัดเจน |
CENTER
|
จัดข้อความให้อยู่ในแนวกึ่งกลางของเซลล์อย่างชัดเจน |
RIGHT
|
จัดข้อความให้อยู่ด้านขวาของเซลล์อย่างชัดเจน |
TextFormat
รูปแบบของการแสดงข้อความในเซลล์ ค่าที่ขาดหายไปหมายความว่าไม่ได้ระบุช่องนี้
การแสดง JSON |
---|
{ "foregroundColor": { object ( |
ช่อง | |
---|---|
foregroundColor
|
สีพื้นหน้าของข้อความ เลิกใช้งาน: ใช้ |
foregroundColorStyle
|
สีพื้นหน้าของข้อความ หากมีการตั้งค่า |
fontFamily
|
ชุดแบบอักษร |
fontSize
|
ขนาดของแบบอักษร |
bold
|
เป็นจริงหากข้อความเป็นตัวหนา |
italic
|
เป็นจริงหากข้อความเป็นตัวเอียง |
strikethrough
|
เป็นจริงหากข้อความมีขีดทับ |
underline
|
เป็นจริงหากมีการขีดเส้นใต้ข้อความ |
link
|
ปลายทางของลิงก์ของข้อความ หากมี การตั้งค่าช่องลิงก์ใน |
ลิงก์
ข้อมูลอ้างอิงภายนอกหรือภายใน
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ช่องการรวม destination ปลายทางของลิงก์
destination
ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น
|
|
uri
|
ตัวระบุลิงก์ |
DataSourceColumn
คอลัมน์ในแหล่งข้อมูล
การแสดง JSON |
---|
{
"reference": {
object (
|
ช่อง | |
---|---|
reference
|
ข้อมูลอ้างอิงของคอลัมน์ |
formula
|
สูตรของคอลัมน์ที่คำนวณ |
DataSourceColumnReference
ตัวระบุที่ไม่ซ้ำกันที่อ้างอิงคอลัมน์แหล่งข้อมูล
การแสดง JSON |
---|
{ "name": string } |
ช่อง | |
---|---|
name
|
ชื่อที่แสดงของคอลัมน์ ค่าต้องไม่ซ้ำกันภายในแหล่งข้อมูล |
DataExecutionStatus
สถานะการดำเนินการกับข้อมูล
ระบบจะสร้างการดำเนินการกับข้อมูลเพื่อซิงค์ออบเจ็กต์แหล่งข้อมูลกับข้อมูลล่าสุดจาก DataSource
โดยปกติแล้วมีการกำหนดเวลาให้ทำงานในเบื้องหลัง คุณตรวจสอบ state
ได้เพื่อดูว่าการดำเนินการเสร็จสมบูรณ์หรือไม่
มีหลายสถานการณ์ที่ข้อมูลจะทริกเกอร์ให้เรียกใช้ ดังนี้
-
Adding a data source
สร้างชีตแหล่งข้อมูลที่เกี่ยวข้องและการดำเนินการข้อมูลเพื่อซิงค์ข้อมูลจากแหล่งข้อมูลไปยังชีต -
Updating a data source
จะสร้างการดำเนินการข้อมูลเพื่อรีเฟรชชีตแหล่งข้อมูลที่เกี่ยวข้องในทำนองเดียวกัน -
คุณสามารถส่ง
refresh request
เพื่อรีเฟรชออบเจ็กต์แหล่งข้อมูลอย่างน้อย 1 รายการอย่างชัดเจน
การแสดง JSON |
---|
{ "state": enum ( |
ช่อง | |
---|---|
state
|
สถานะของการดำเนินการกับข้อมูล |
errorCode
|
รหัสข้อผิดพลาด |
errorMessage
|
ข้อความแสดงข้อผิดพลาด ซึ่งอาจว่างเปล่า |
lastRefreshTime
|
รับเวลาที่รีเฟรชข้อมูลสำเร็จครั้งล่าสุด |
DataExecutionState
การแจกแจงสถานะการดำเนินการกับข้อมูล
Enum | |
---|---|
DATA_EXECUTION_STATE_UNSPECIFIED
|
ค่าเริ่มต้น อย่าใช้ |
NOT_STARTED
|
ยังไม่เริ่มเรียกใช้ข้อมูล |
RUNNING
|
การดำเนินการกับข้อมูลได้เริ่มขึ้นแล้วและกำลังทำงานอยู่ |
CANCELLING
|
กำลังยกเลิกการดำเนินการกับข้อมูล |
SUCCEEDED
|
การดำเนินการกับข้อมูลเสร็จสมบูรณ์แล้ว |
FAILED
|
การดำเนินการกับข้อมูลเสร็จสมบูรณ์แล้วโดยมีข้อผิดพลาด |
DataExecutionErrorCode
การแจกแจงรหัสข้อผิดพลาดการดำเนินการข้อมูล
Enum | |
---|---|
DATA_EXECUTION_ERROR_CODE_UNSPECIFIED
|
ค่าเริ่มต้น อย่าใช้ |
TIMED_OUT
|
หมดเวลาการเรียกใช้ข้อมูลแล้ว |
TOO_MANY_ROWS
|
การดำเนินการกับข้อมูลแสดงผลจำนวนแถวที่เกินขีดจำกัด |
TOO_MANY_COLUMNS
|
การดำเนินการกับข้อมูลจะส่งกลับคอลัมน์ที่เกินขีดจำกัด |
TOO_MANY_CELLS
|
การดำเนินการกับข้อมูลแสดงผลเซลล์เกินจำนวนสูงสุด |
ENGINE
|
ได้รับข้อผิดพลาดจากเครื่องมือดำเนินการข้อมูลแบ็กเอนด์ (เช่น BigQuery) ดูรายละเอียดได้ที่ errorMessage
|
PARAMETER_INVALID
|
พารามิเตอร์แหล่งข้อมูลที่ระบุอย่างน้อย 1 รายการไม่ถูกต้อง |
UNSUPPORTED_DATA_TYPE
|
การดำเนินการกับข้อมูลแสดงผลเป็นประเภทข้อมูลที่ไม่รองรับ |
DUPLICATE_COLUMN_NAMES
|
การดำเนินการกับข้อมูลจะแสดงชื่อหรือชื่อแทนคอลัมน์ที่ซ้ำกัน |
INTERRUPTED
|
การดำเนินการกับข้อมูลถูกขัดจังหวะ โปรดรีเฟรชในภายหลัง |
CONCURRENT_QUERY
|
การเรียกใช้ข้อมูลอยู่ระหว่างดำเนินการ ทำให้รีเฟรชไม่ได้จนกว่าจะเสร็จสมบูรณ์ |
OTHER
|
ข้อผิดพลาดอื่นๆ |
TOO_MANY_CHARS_PER_CELL
|
การดำเนินการกับข้อมูลจะแสดงผลค่าที่เกินจำนวนอักขระสูงสุดที่อนุญาตในเซลล์เดียว |
DATA_NOT_FOUND
|
ไม่พบฐานข้อมูลที่แหล่งข้อมูลอ้างอิง */ |
PERMISSION_DENIED
|
ผู้ใช้ไม่มีสิทธิ์เข้าถึงฐานข้อมูลที่แหล่งข้อมูลอ้างอิง |
MISSING_COLUMN_ALIAS
|
การดำเนินการกับข้อมูลจะแสดงคอลัมน์ที่ไม่มีชื่อแทน |
OBJECT_NOT_FOUND
|
ออบเจ็กต์แหล่งข้อมูลไม่มีอยู่ |
OBJECT_IN_ERROR_STATE
|
ออบเจ็กต์แหล่งข้อมูลอยู่ในสถานะข้อผิดพลาด หากต้องการบังคับรีเฟรช ให้ตั้งค่า force ใน RefreshDataSourceRequest
|
OBJECT_SPEC_INVALID
|
ข้อกำหนดของออบเจ็กต์แหล่งข้อมูลไม่ถูกต้อง |
DATA_EXECUTION_CANCELLED
|
ยกเลิกการดำเนินการกับข้อมูลแล้ว |
ExtendedValue
ชนิดของค่าที่เซลล์ในสเปรดชีตสามารถมีได้
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ช่องการรวม value ประเภทของค่าในเซลล์ หากไม่มีการตั้งค่าฟิลด์ไว้ เซลล์จะไม่มีข้อมูล
value
ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น
|
|
numberValue
|
แสดงค่าทศนิยม หมายเหตุ: วันที่ เวลา และวันที่และเวลาจะแสดงเป็นเลขคู่ในรูปแบบ |
stringValue
|
แสดงค่าสตริง โดยไม่รวมเครื่องหมายคำพูดเดี่ยวนำหน้า เช่น หากผู้ใช้พิมพ์ |
boolValue
|
แสดงค่าบูลีน |
formulaValue
|
แสดงสูตร |
errorValue
|
แสดงข้อผิดพลาด ช่องนี้เป็นแบบอ่านอย่างเดียว |
ErrorValue
ข้อผิดพลาดในเซลล์
การแสดง JSON |
---|
{
"type": enum (
|
ช่อง | |
---|---|
type
|
ประเภทของข้อผิดพลาด |
message
|
ข้อความที่มีข้อมูลเพิ่มเติมเกี่ยวกับข้อผิดพลาด (ในภาษาของสเปรดชีต) |
ErrorType
ประเภทของข้อผิดพลาด
Enum | |
---|---|
ERROR_TYPE_UNSPECIFIED
|
ประเภทข้อผิดพลาดเริ่มต้น โปรดอย่าใช้ตัวเลือกนี้ |
ERROR
|
สอดคล้องกับข้อผิดพลาด #ERROR!
|
NULL_VALUE
|
สอดคล้องกับข้อผิดพลาด #NULL!
|
DIVIDE_BY_ZERO
|
สอดคล้องกับข้อผิดพลาด #DIV/0
|
VALUE
|
สอดคล้องกับข้อผิดพลาด #VALUE!
|
REF
|
สอดคล้องกับข้อผิดพลาด #REF!
|
NAME
|
สอดคล้องกับข้อผิดพลาด #NAME?
|
NUM
|
สอดคล้องกับข้อผิดพลาด #NUM!
|
N_A
|
สอดคล้องกับข้อผิดพลาด #N/A
|
LOADING
|
สอดคล้องกับสถานะ Loading...
|
BooleanCondition
เงื่อนไขที่ประเมินค่าเป็นจริงหรือเท็จได้ BooleanConditions จะใช้โดยการจัดรูปแบบตามเงื่อนไข การตรวจสอบข้อมูล และเกณฑ์ในตัวกรอง
การแสดง JSON |
---|
{ "type": enum ( |
ช่อง | |
---|---|
type
|
ประเภทของเงื่อนไข |
values[]
|
ค่าของเงื่อนไข จำนวนค่าที่รองรับขึ้นอยู่กับ |
ConditionType
ประเภทของเงื่อนไข
Enum | |
---|---|
CONDITION_TYPE_UNSPECIFIED
|
ค่าเริ่มต้น โปรดอย่าใช้ |
NUMBER_GREATER
|
ค่าของเซลล์ต้องมากกว่าค่าของเงื่อนไข รองรับโดยการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ต้องใช้ ConditionValue รายการเดียว
|
NUMBER_GREATER_THAN_EQ
|
ค่าของเซลล์ต้องมากกว่าหรือเท่ากับค่าของเงื่อนไข รองรับโดยการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ต้องใช้ ConditionValue รายการเดียว
|
NUMBER_LESS
|
ค่าของเซลล์ต้องน้อยกว่าค่าของเงื่อนไข รองรับโดยการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ต้องใช้ ConditionValue รายการเดียว
|
NUMBER_LESS_THAN_EQ
|
ค่าของเซลล์ต้องน้อยกว่าหรือเท่ากับค่าของเงื่อนไข รองรับโดยการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ต้องใช้ ConditionValue รายการเดียว
|
NUMBER_EQ
|
ค่าของเซลล์ต้องเท่ากับค่าของเงื่อนไข รองรับโดยการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ต้องใช้ ConditionValue รายการเดียวสำหรับการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรองในออบเจ็กต์ที่ไม่ใช่แหล่งข้อมูล และมี ConditionValue อย่างน้อย 1 รายการสำหรับตัวกรองในออบเจ็กต์แหล่งข้อมูล
|
NUMBER_NOT_EQ
|
ค่าของเซลล์ต้องไม่เท่ากับค่าของเงื่อนไข รองรับโดยการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ต้องใช้ ConditionValue รายการเดียวสำหรับการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรองในออบเจ็กต์ที่ไม่ใช่แหล่งข้อมูล และมี ConditionValue อย่างน้อย 1 รายการสำหรับตัวกรองในออบเจ็กต์แหล่งข้อมูล
|
NUMBER_BETWEEN
|
ค่าของเซลล์ต้องอยู่ระหว่างค่าเงื่อนไข 2 ค่า รองรับโดยการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ต้องใช้ ConditionValues 2 รายการเท่านั้น
|
NUMBER_NOT_BETWEEN
|
ค่าของเซลล์ต้องไม่อยู่ระหว่างค่าเงื่อนไข 2 ค่า รองรับโดยการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ต้องใช้ ConditionValues 2 รายการเท่านั้น
|
TEXT_CONTAINS
|
ค่าของเซลล์ต้องมีค่าของเงื่อนไข รองรับโดยการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ต้องใช้ ConditionValue รายการเดียว
|
TEXT_NOT_CONTAINS
|
ค่าของเซลล์ต้องไม่มีค่าของเงื่อนไข รองรับโดยการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ต้องใช้ ConditionValue รายการเดียว
|
TEXT_STARTS_WITH
|
ค่าของเซลล์ต้องขึ้นต้นด้วยค่าของเงื่อนไข รองรับโดยการจัดรูปแบบตามเงื่อนไขและตัวกรอง ต้องใช้ ConditionValue รายการเดียว
|
TEXT_ENDS_WITH
|
ค่าของเซลล์ต้องลงท้ายด้วยค่าของเงื่อนไข รองรับโดยการจัดรูปแบบตามเงื่อนไขและตัวกรอง ต้องใช้ ConditionValue รายการเดียว
|
TEXT_EQ
|
ค่าของเซลล์ต้องตรงกับค่าของเงื่อนไข รองรับโดยการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ต้องใช้ ConditionValue รายการเดียวสำหรับการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรองในออบเจ็กต์ที่ไม่ใช่แหล่งข้อมูล และมี ConditionValue อย่างน้อย 1 รายการสำหรับตัวกรองในออบเจ็กต์แหล่งข้อมูล
|
TEXT_IS_EMAIL
|
ค่าของเซลล์ต้องเป็นอีเมลที่ถูกต้อง รองรับโดยการตรวจสอบข้อมูล ไม่จำเป็นต้องมี ConditionValues
|
TEXT_IS_URL
|
ค่าของเซลล์ต้องเป็น URL ที่ถูกต้อง รองรับโดยการตรวจสอบข้อมูล ไม่จำเป็นต้องมี ConditionValues
|
DATE_EQ
|
ค่าของเซลล์ต้องเป็นวันที่เดียวกับค่าของเงื่อนไข รองรับโดยการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ต้องใช้ ConditionValue รายการเดียวสำหรับการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรองในออบเจ็กต์ที่ไม่ใช่แหล่งข้อมูล และมี ConditionValue อย่างน้อย 1 รายการสำหรับตัวกรองในออบเจ็กต์แหล่งข้อมูล
|
DATE_BEFORE
|
ค่าของเซลล์ต้องอยู่ก่อนวันที่ค่าของเงื่อนไข รองรับโดยการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ต้องใช้ ConditionValue รายการเดียวซึ่งอาจเป็น relative date
|
DATE_AFTER
|
ค่าของเซลล์ต้องอยู่หลังจากวันที่ค่าของเงื่อนไข รองรับโดยการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ต้องใช้ ConditionValue รายการเดียวซึ่งอาจเป็น relative date
|
DATE_ON_OR_BEFORE
|
ค่าของเซลล์ต้องเป็นวันที่หรือก่อนวันที่ค่าของเงื่อนไข รองรับโดยการตรวจสอบข้อมูล ต้องใช้ ConditionValue รายการเดียวซึ่งอาจเป็น relative date
|
DATE_ON_OR_AFTER
|
ค่าของเซลล์ต้องเป็นวันที่เดียวกับหรือหลังวันที่ในค่าของเงื่อนไข รองรับโดยการตรวจสอบข้อมูล ต้องใช้ ConditionValue รายการเดียวซึ่งอาจเป็น relative date
|
DATE_BETWEEN
|
ค่าของเซลล์ต้องอยู่ระหว่างวันที่ของค่าเงื่อนไข 2 รายการ รองรับโดยการตรวจสอบข้อมูล ต้องใช้ ConditionValues 2 รายการเท่านั้น
|
DATE_NOT_BETWEEN
|
ค่าของเซลล์ต้องอยู่นอกวันที่ของค่าเงื่อนไข 2 รายการ รองรับโดยการตรวจสอบข้อมูล ต้องใช้ ConditionValues 2 รายการเท่านั้น
|
DATE_IS_VALID
|
ค่าของเซลล์ต้องเป็นวันที่ รองรับโดยการตรวจสอบข้อมูล ไม่จำเป็นต้องมี ConditionValues
|
ONE_OF_RANGE
|
ค่าของเซลล์ต้องแสดงอยู่ในตารางกริดในช่วงของค่าเงื่อนไข รองรับโดยการตรวจสอบข้อมูล ต้องใช้ ConditionValue ค่าเดียวและค่าต้องเป็นช่วงที่ถูกต้องในรูปแบบ A1
|
ONE_OF_LIST
|
ค่าของเซลล์ต้องอยู่ในรายการค่าของเงื่อนไข รองรับโดยการตรวจสอบข้อมูล รองรับ condition values กี่รายการก็ได้ 1 รายการต่อรายการ ระบบไม่รองรับสูตรในค่า
|
BLANK
|
ค่าของเซลล์ต้องว่างเปล่า รองรับโดยการจัดรูปแบบตามเงื่อนไขและตัวกรอง ไม่จำเป็นต้องมี ConditionValues
|
NOT_BLANK
|
ค่าของเซลล์ต้องไม่ว่างเปล่า รองรับโดยการจัดรูปแบบตามเงื่อนไขและตัวกรอง ไม่จำเป็นต้องมี ConditionValues
|
CUSTOM_FORMULA
|
สูตรของเงื่อนไขต้องประเมินเป็นจริง รองรับโดยการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ตัวกรองชีตแหล่งข้อมูลไม่รองรับ ต้องใช้ ConditionValue รายการเดียว
|
BOOLEAN
|
ค่าของเซลล์ต้องเป็น TRUE/FALSE หรือในรายการค่าของเงื่อนไข รองรับโดยการตรวจสอบข้อมูล แสดงผลเป็นช่องทำเครื่องหมายเซลล์ รองรับ ConditionValues เป็น 0, 1 หรือ 2 ไม่มีค่าที่ระบุว่าเซลล์ต้องเป็น TRUE หรือ FALSE โดยที่ TRUE จะแสดงผลเป็นรายการที่เลือก และ FALSE จะแสดงผลเป็นไม่เลือก ค่า 1 ค่าบ่งชี้ว่าเซลล์จะแสดงผลเป็น "เลือกไว้" เมื่อมีค่าดังกล่าว และจะยกเลิกการเลือกเมื่อเป็นค่าว่าง ค่า 2 ค่าบ่งชี้ว่าเซลล์จะแสดงผลเป็น "เลือกแล้ว" เมื่อมีค่าแรกและไม่ได้เลือกไว้เมื่อมีค่าที่ 2 เช่น ["Yes","No"] บ่งชี้ว่าเซลล์จะแสดงช่องที่ทำเครื่องหมายเมื่อมีค่าเป็น "Yes" และเลือกช่องที่ไม่ได้ทำเครื่องหมายเมื่อมีค่าเป็น "No"
|
TEXT_NOT_EQ
|
ค่าของเซลล์ต้องไม่ใช่ค่าของเงื่อนไข รองรับโดยตัวกรองในออบเจ็กต์แหล่งข้อมูล ต้องมี ConditionValue อย่างน้อย 1 รายการ
|
DATE_NOT_EQ
|
ค่าของเซลล์ต้องไม่ใช่ค่าของเงื่อนไข รองรับโดยตัวกรองในออบเจ็กต์แหล่งข้อมูล ต้องมี ConditionValue อย่างน้อย 1 รายการ
|
FILTER_EXPRESSION
|
ค่าของเซลล์ต้องเป็นไปตามรูปแบบที่ระบุ ต้องใช้ ConditionValue รายการเดียว
|
ConditionValue
ค่าของเงื่อนไข
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ช่องการรวม value ค่าของเงื่อนไข ต้องตั้งค่าเท่านั้น
value
ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น
|
|
relativeDate
|
วันที่ที่เกี่ยวข้อง (อิงตามวันที่ปัจจุบัน) ใช้ได้เฉพาะในกรณีที่ ระบบไม่รองรับวันที่สัมพัทธ์ในการตรวจสอบข้อมูล ซึ่งรองรับเฉพาะการจัดรูปแบบตามเงื่อนไขและตัวกรองตามเงื่อนไข |
userEnteredValue
|
ค่าที่เงื่อนไขจะอิงตาม ระบบจะแยกวิเคราะห์ค่าเสมือนว่าผู้ใช้พิมพ์ลงในเซลล์ รองรับสูตร (และต้องขึ้นต้นด้วย |
RelativeDate
ควบคุมวิธีประเมินเงื่อนไขวันที่
Enum | |
---|---|
RELATIVE_DATE_UNSPECIFIED
|
ค่าเริ่มต้น อย่าใช้ |
PAST_YEAR
|
ค่าคือ 1 ปีก่อนวันนี้ |
PAST_MONTH
|
มูลค่าคือ 1 เดือนก่อนวันนี้ |
PAST_WEEK
|
ค่าคือ 1 สัปดาห์ก่อนวันนี้ |
YESTERDAY
|
ค่าคือเมื่อวาน |
TODAY
|
ค่าคือวันนี้ |
TOMORROW
|
ค่าคือพรุ่งนี้ |
GridRange
ช่วงในชีต ดัชนีทั้งหมดมีฐาน 0 ดัชนีจะเปิดครึ่งหนึ่ง กล่าวคือ รวมดัชนีเริ่มต้นและดัชนีสิ้นสุดเป็นเอกสิทธิ์ นั่นคือ [startIndex, endIndex) ดัชนีที่ไม่มีดัชนีหมายความว่าช่วงไม่มีขอบเขตที่ด้านนั้น
ตัวอย่างเช่น หาก "Sheet1"
คือรหัสชีต 123456 ให้ทำดังนี้
Sheet1!A1:A1 == sheetId: 123456,
startRowIndex: 0, endRowIndex: 1,
startColumnIndex: 0, endColumnIndex: 1
Sheet1!A3:B4 == sheetId: 123456,
startRowIndex: 2, endRowIndex: 4,
startColumnIndex: 0, endColumnIndex: 2
Sheet1!A:B == sheetId: 123456,
startColumnIndex: 0, endColumnIndex: 2
Sheet1!A5:B == sheetId: 123456,
startRowIndex: 4,
startColumnIndex: 0, endColumnIndex: 2
Sheet1 == sheetId: 123456
ดัชนีเริ่มต้นต้องน้อยกว่าหรือเท่ากับดัชนีสิ้นสุดเสมอ หากดัชนีเริ่มต้นเท่ากับดัชนีสิ้นสุด ช่วงจะว่างเปล่า โดยทั่วไปช่วงที่ว่างเปล่าจะไม่มีความหมายและมักจะแสดงผลใน UI เป็น #REF!
การแสดง JSON |
---|
{ "sheetId": integer, "startRowIndex": integer, "endRowIndex": integer, "startColumnIndex": integer, "endColumnIndex": integer } |
ช่อง | |
---|---|
sheetId
|
แผ่นงานที่ช่วงนี้เปิดอยู่ |
startRowIndex
|
แถวเริ่มต้น (รวม) ของช่วง หรือไม่ตั้งค่าหากไม่มีขอบเขต |
endRowIndex
|
แถวสิ้นสุด (ไม่รวม) ของช่วง หรือไม่ตั้งค่าหากไม่มีขอบเขต |
startColumnIndex
|
คอลัมน์เริ่มต้น (รวม) ของช่วง หรือไม่ตั้งค่าหากไม่มีขอบเขต |
endColumnIndex
|
คอลัมน์สิ้นสุด (ไม่รวม) ของช่วง หรือไม่ตั้งค่าหากไม่มีขอบเขต |
SortOrder
ลำดับการจัดเรียง
Enum | |
---|---|
SORT_ORDER_UNSPECIFIED
|
ค่าเริ่มต้น อย่าใช้ค่านี้ |
ASCENDING
|
จัดเรียงจากน้อยไปหามาก |
DESCENDING
|
จัดเรียงจากมากไปหาน้อย |
FilterSpec
เกณฑ์ตัวกรองที่เชื่อมโยงกับคอลัมน์หนึ่งๆ
การแสดง JSON |
---|
{ "filterCriteria": { object ( |
ช่อง | |
---|---|
filterCriteria
|
เกณฑ์สำหรับคอลัมน์ |
ช่องการรวม reference การอ้างอิงคอลัมน์ที่กรอง
reference
ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น
|
|
columnIndex
|
ดัชนีคอลัมน์ฐาน 0 |
dataSourceColumnReference
|
การอ้างอิงคอลัมน์แหล่งข้อมูล |
FilterCriteria
เกณฑ์ในการแสดง/ซ่อนแถวในตัวกรองหรือมุมมองตัวกรอง
การแสดง JSON |
---|
{ "hiddenValues": [ string ], "condition": { object ( |
ช่อง | |
---|---|
condition
|
เงื่อนไขที่ต้องเป็น "จริง" จึงจะแสดงค่าได้ (การดำเนินการนี้ไม่ได้ลบล้าง |
visibleBackgroundColor
|
สีเติมพื้นหลังที่ใช้กรองจะแสดงเฉพาะเซลล์ที่มีสีเติมนี้เท่านั้น พิเศษร่วมกับ |
visibleBackgroundColorStyle
|
สีเติมพื้นหลังที่ใช้กรองจะแสดงเฉพาะเซลล์ที่มีสีเติมนี้เท่านั้น ช่องนี้ใช้ร่วมกันไม่ได้กับ |
visibleForegroundColor
|
สีพื้นหน้าที่ต้องการกรอง ระบบจะแสดงเฉพาะเซลล์ที่มีสีพื้นหน้าเท่านั้น พิเศษร่วมกับ |
visibleForegroundColorStyle
|
สีพื้นหน้าที่ต้องการกรอง ระบบจะแสดงเฉพาะเซลล์ที่มีสีพื้นหน้าเท่านั้น ช่องนี้ใช้ร่วมกันไม่ได้กับ |
SortSpec
ลำดับการจัดเรียงที่เชื่อมโยงกับคอลัมน์หรือแถวหนึ่งๆ
การแสดง JSON |
---|
{ "sortOrder": enum ( |
ช่อง | |
---|---|
sortOrder
|
ควรจัดเรียงข้อมูลลำดับ |
foregroundColor
|
สีพื้นหน้าที่จะจัดเรียง โดยเซลล์ที่มีสีพื้นหน้านี้จะจัดเรียงไว้ที่ด้านบนสุด พิเศษร่วมกับ |
foregroundColorStyle
|
สีพื้นหน้าที่จะจัดเรียง โดยเซลล์ที่มีสีพื้นหน้านี้จะจัดเรียงไว้ที่ด้านบนสุด ใช้กับ |
backgroundColor
|
สีเติมพื้นหลังที่จะจัดเรียง โดยเซลล์ที่มีสีเติมนี้จะถูกจัดเรียงไว้ที่ด้านบนสุด พิเศษร่วมกับ |
backgroundColorStyle
|
สีเติมพื้นหลังที่จะจัดเรียง โดยเซลล์ที่มีสีเติมนี้จะถูกจัดเรียงไว้ที่ด้านบนสุด ใช้กับ |
ช่องการรวม reference การอ้างอิงมิติข้อมูลที่จัดเรียง
reference
ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น
|
|
dimensionIndex
|
มิติข้อมูลที่ควรใช้การจัดเรียง |
dataSourceColumnReference
|
การอ้างอิงคอลัมน์แหล่งข้อมูล |
EmbeddedObjectPosition
ตำแหน่งของวัตถุที่ฝัง เช่น แผนภูมิ
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ช่องการรวม location ตำแหน่งของออบเจ็กต์ ต้องตั้งค่าเพียงค่าเดียว
location
ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น
|
|
sheetId
|
ชีตที่กำลังใช้อยู่ ตั้งค่าต่อเมื่อออบเจ็กต์ที่ฝังอยู่ในชีตของตัวเองเท่านั้น ต้องไม่เป็นค่าลบ |
overlayPosition
|
ตำแหน่งที่วัตถุวางซ้อนบนตารางกริด |
newSheet
|
หากเป็น "จริง" ระบบจะวางออบเจ็กต์ที่ฝังอยู่ในชีตใหม่ซึ่งระบบจะเลือกรหัสให้คุณ ใช้เมื่อเขียนเท่านั้น |
OverlayPosition
ตำแหน่งที่วัตถุวางซ้อนบนตารางกริด
การแสดง JSON |
---|
{
"anchorCell": {
object (
|
ช่อง | |
---|---|
anchorCell
|
เซลล์ที่ออบเจ็กต์ยึดตำแหน่งไว้ |
offsetXPixels
|
ค่าออฟเซ็ตแนวนอน (หน่วยเป็นพิกเซล) ที่ออบเจ็กต์ถูกออฟเซ็ตจากเซลล์ยึด |
offsetYPixels
|
ค่าออฟเซ็ตแนวตั้ง (หน่วยเป็นพิกเซล) ที่ออบเจ็กต์ดังกล่าวถูกออฟเซ็ตจากเซลล์ยึด |
widthPixels
|
ความกว้างของวัตถุ หน่วยเป็นพิกเซล ค่าเริ่มต้นคือ 600 |
heightPixels
|
ความสูงของวัตถุในหน่วยพิกเซล ค่าเริ่มต้นคือ 371 |
GridCoordinate
พิกัดในชีต ดัชนีทั้งหมดมีฐาน 0
การแสดง JSON |
---|
{ "sheetId": integer, "rowIndex": integer, "columnIndex": integer } |
ช่อง | |
---|---|
sheetId
|
แผ่นงานที่พิกัดนี้เปิดอยู่ |
rowIndex
|
ดัชนีแถวของพิกัด |
columnIndex
|
ดัชนีคอลัมน์ของพิกัด |