สี
แสดงสีในพื้นที่สี RGBA การนำเสนอนี้ออกแบบมาให้ง่ายต่อการแปลงเป็นและจากการแสดงสีในภาษาต่างๆ ที่กระชับได้ใจความ ตัวอย่างเช่น ฟิลด์ของการแสดงนี้สามารถใส่เพียงเล็กน้อยให้กับเครื่องมือสร้างของ
java.awt.Color
ใน Java ก็ยังอาจใส่เล็กน้อยให้กับ UIColor
วันที่ +colorWithRed:green:blue:alpha
ใน 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 แทนสเกลาร์แบบ Float ที่เรียบง่ายที่สุด เพื่อให้คุณแยกความแตกต่างระหว่างค่าเริ่มต้นกับค่าที่ไม่ได้ตั้งค่าได้ หากไม่ระบุ ออบเจ็กต์สีนี้จะแสดงเป็นสีทึบ (เสมือนว่าค่าอัลฟ่าได้รับค่าเป็น 1.0 อย่างชัดเจน) |
ColorStyle
ค่าสี
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ฟิลด์ Union
kind ชนิดของค่าสี
kind
ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้
|
|
rgbColor
|
|
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 |
ช่อง | |
---|---|
ฟิลด์ Union
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 |
ช่อง | |
---|---|
ฟิลด์ Union
value ประเภทของค่าในเซลล์ หากไม่ได้ตั้งค่าช่องไว้ เซลล์นั้นจะไม่มีข้อมูล
value
ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้
|
|
numberValue
|
แสดงค่า Double หมายเหตุ: วันที่ เวลา และวันที่และเวลาจะแสดงเป็นเลขคู่ใน
|
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
สำหรับตัวกรองในออบเจ็กต์แหล่งข้อมูล
|
NUMBER_NOT_EQ
|
ค่าของเซลล์ต้องไม่เท่ากับค่าของเงื่อนไข รองรับโดยการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ต้องใช้รายการเดียว
ConditionValue
สำหรับการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรองในออบเจ็กต์ที่ไม่ใช่แหล่งข้อมูล และ
วันที่ ConditionValue
สำหรับตัวกรองในออบเจ็กต์แหล่งข้อมูล
|
NUMBER_BETWEEN
|
ค่าของเซลล์ต้องอยู่ระหว่างค่าเงื่อนไข 2 รายการ รองรับโดยการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ต้องใช้ 2 อย่างเท่านั้น
ConditionValues
|
NUMBER_NOT_BETWEEN
|
ค่าของเซลล์ต้องไม่อยู่ระหว่างค่าเงื่อนไข 2 รายการ รองรับโดยการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ต้องใช้ 2 อย่างเท่านั้น
ConditionValues
|
TEXT_CONTAINS
|
ค่าของเซลล์ต้องมีค่าของเงื่อนไข รองรับโดยการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ต้องใช้รายการเดียว
ConditionValue
|
TEXT_NOT_CONTAINS
|
ค่าของเซลล์ต้องไม่มีค่าของเงื่อนไข รองรับโดยการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ต้องใช้รายการเดียว
ConditionValue
|
TEXT_STARTS_WITH
|
ค่าของเซลล์ต้องขึ้นต้นด้วยค่าของเงื่อนไข รองรับโดยการจัดรูปแบบตามเงื่อนไขและตัวกรอง ต้องใช้รายการเดียว
ConditionValue
|
TEXT_ENDS_WITH
|
ค่าของเซลล์ต้องลงท้ายด้วยค่าของเงื่อนไข รองรับโดยการจัดรูปแบบตามเงื่อนไขและตัวกรอง ต้องใช้รายการเดียว
ConditionValue
|
TEXT_EQ
|
ค่าของเซลล์ต้องตรงกับค่าของเงื่อนไขทุกประการ รองรับโดยการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ต้องใช้รายการเดียว
ConditionValue
สำหรับการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรองในออบเจ็กต์ที่ไม่ใช่แหล่งข้อมูล และ
วันที่ ConditionValue
สำหรับตัวกรองในออบเจ็กต์แหล่งข้อมูล
|
TEXT_IS_EMAIL
|
ค่าของเซลล์ต้องเป็นอีเมลที่ถูกต้อง รองรับโดยการตรวจสอบข้อมูล ไม่จำเป็นต้องระบุ
ConditionValues
|
TEXT_IS_URL
|
ค่าของเซลล์ต้องเป็น URL ที่ถูกต้อง รองรับโดยการตรวจสอบข้อมูล ไม่จำเป็นต้องระบุ
ConditionValues
|
DATE_EQ
|
ค่าของเซลล์ต้องเป็นวันที่เดียวกับค่าของเงื่อนไข รองรับโดยการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ต้องใช้รายการเดียว
ConditionValue
สำหรับการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรองในออบเจ็กต์ที่ไม่ใช่แหล่งข้อมูล และ
วันที่ ConditionValue
สำหรับตัวกรองในออบเจ็กต์แหล่งข้อมูล
|
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 รายการ รองรับโดยการตรวจสอบข้อมูล ต้องใช้ 2 อย่างเท่านั้น
ConditionValues
|
DATE_NOT_BETWEEN
|
ค่าของเซลล์ต้องอยู่นอกช่วงวันที่ของค่าเงื่อนไขทั้ง 2 รายการ รองรับโดยการตรวจสอบข้อมูล ต้องใช้ 2 อย่างเท่านั้น
ConditionValues
|
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 หรือในรายการค่าเงื่อนไข รองรับโดยการตรวจสอบข้อมูล แสดงผลเป็นช่องทำเครื่องหมายเซลล์ รองรับ 0, 1 หรือ 2
ConditionValues ไม่มีค่าที่ระบุว่าเซลล์ต้องเป็น TRUE หรือ FALSE โดยที่ TRUE จะแสดงผลเป็นเลือกแล้ว และ FALSE จะแสดงผลเป็นยกเลิกการเลือก ค่าหนึ่งระบุว่าเซลล์จะแสดงผลเป็นเลือกแล้วเมื่อมีค่านั้นและยกเลิกการเลือกเมื่อเซลล์นั้นว่างเปล่า ค่า 2 ค่าจะบ่งบอกว่าเซลล์จะแสดงผลเป็น "เลือกแล้ว" เมื่อเซลล์มีค่าแรกเป็น "ยกเลิกการเลือกแล้ว" เมื่อมีค่าที่ 2 อยู่แล้ว เช่น ["Yes", "No"] บ่งบอกว่าเซลล์จะแสดงช่องที่ทำเครื่องหมายไว้เมื่อมีค่า "Yes" และช่องที่ไม่ได้เลือกไว้เมื่อมีค่าเป็น "No"
|
TEXT_NOT_EQ
|
ค่าของเซลล์ต้องไม่เท่ากับค่าของเงื่อนไข ตัวกรองในออบเจ็กต์แหล่งข้อมูลรองรับ ต้องมีอย่างน้อย 1 รูป
ConditionValue
|
DATE_NOT_EQ
|
ค่าของเซลล์ต้องไม่เท่ากับค่าของเงื่อนไข ตัวกรองในออบเจ็กต์แหล่งข้อมูลรองรับ ต้องมีอย่างน้อย 1 รูป
ConditionValue
|
FILTER_EXPRESSION
|
ค่าของเซลล์ต้องเป็นไปตามรูปแบบที่ระบุ ต้องใช้รายการเดียว
ConditionValue
|
ConditionValue
ค่าของเงื่อนไข
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ฟิลด์ Union
value ต้องตั้งเงื่อนไขเพียง 1 รายการเท่านั้น
value
ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้
|
|
relativeDate
|
วันที่สัมพัทธ์ (อิงตามวันที่ปัจจุบัน) ใช้ได้เฉพาะเมื่อ
ไม่รองรับวันที่สัมพัทธ์ในการตรวจสอบข้อมูล โดยจะรองรับเฉพาะในตัวกรองการจัดรูปแบบตามเงื่อนไขและตัวกรองแบบมีเงื่อนไขเท่านั้น |
userEnteredValue
|
ค่าที่เงื่อนไขอ้างอิง ค่านี้จะแยกวิเคราะห์เสมือนว่าผู้ใช้พิมพ์ลงในเซลล์ สูตรต่างๆ ได้รับการรองรับ (และต้องขึ้นต้นด้วยแท็ก
|
RelativeDate
ควบคุมวิธีประเมินเงื่อนไขวันที่
Enum | |
---|---|
RELATIVE_DATE_UNSPECIFIED
|
ค่าเริ่มต้น อย่านำไปใช้ |
PAST_YEAR
|
ค่านี้คือ 1 ปีก่อนถึงวันนี้ |
PAST_MONTH
|
ค่านี้คือ 1 เดือนก่อนถึงวันนี้ |
PAST_WEEK
|
ค่าคือ 1 สัปดาห์ก่อนวันนี้ |
YESTERDAY
|
ค่าเป็นของเมื่อวาน |
TODAY
|
ค่าคือวันนี้ |
TOMORROW
|
ค่าคือวันพรุ่งนี้ |
GridRange
ช่วงในชีต ดัชนีทั้งหมดอิงตามศูนย์ ดัชนีเปิดครึ่งเดียว นั่นคือดัชนีเริ่มต้นรวม และดัชนีสิ้นสุดเป็นแบบไม่เฉพาะเจาะจง -- [startIndex, endIndex) ไม่มีดัชนีหมายความว่าช่วงนั้นไม่มีขอบเขตที่ด้านนั้น
ตัวอย่างเช่น หาก
"Sheet1"
คือ ID ของแผ่นงาน 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
|
จัดเรียงจากมากไปหาน้อย (Z ถึง A) |
FilterSpec
เกณฑ์ตัวกรองที่เชื่อมโยงกับคอลัมน์หนึ่งๆ
การแสดง JSON |
---|
{ "filterCriteria": { object ( |
ช่อง | |
---|---|
filterCriteria
|
เกณฑ์สำหรับคอลัมน์ |
ฟิลด์ Union
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
|
สีเติมพื้นหลังที่จะจัดเรียง เซลล์ที่มีสีเติมนี้จะจัดเรียงไว้ที่ด้านบน พิเศษร่วมกันกับ
|
ฟิลด์ Union
reference การอ้างอิงมิติข้อมูลที่จัดเรียง
reference
ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้
|
|
dimensionIndex
|
มิติข้อมูลที่ต้องใช้การจัดเรียง |
dataSourceColumnReference
|
การอ้างอิงคอลัมน์แหล่งข้อมูล |
EmbeddedObjectPosition
ตำแหน่งของวัตถุที่ฝัง เช่น แผนภูมิ
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ฟิลด์ Union
location ตำแหน่งของออบเจ็กต์ ต้องตั้งค่า 1 ค่าเท่านั้น
location
ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้
|
|
sheetId
|
แผ่นงานที่เปิดอยู่ ตั้งค่าเฉพาะในกรณีที่วัตถุที่ฝังอยู่ในชีตของตัวเองเท่านั้น ต้องไม่เป็นค่าลบ |
overlayPosition
|
ตำแหน่งที่วัตถุซ้อนทับอยู่บนตารางกริด |
newSheet
|
หากเป็นจริง ระบบจะวางออบเจ็กต์ที่ฝังในชีตใหม่ที่เลือกรหัสให้คุณ ใช้เมื่อเขียนเท่านั้น |
OverlayPosition
ตำแหน่งที่วางวัตถุซ้อนทับอยู่บนตารางกริด
การแสดง JSON |
---|
{
"anchorCell": {
object (
|
ช่อง | |
---|---|
anchorCell
|
เซลล์ที่ยึดวัตถุ |
offsetXPixels
|
ออฟเซ็ตแนวนอนในหน่วยพิกเซลที่มีออฟเซ็ตวัตถุจากเซลล์จุดยึด |
offsetYPixels
|
ค่าออฟเซ็ตแนวตั้งในหน่วยพิกเซลที่ค่าชดเชยวัตถุจากเซลล์จุดยึด |
widthPixels
|
ความกว้างของวัตถุในหน่วยพิกเซล ค่าเริ่มต้นคือ 600 |
heightPixels
|
ความสูงของวัตถุในหน่วยพิกเซล ค่าเริ่มต้นคือ 371 |
GridCoordinate
พิกัดในชีต ดัชนีทั้งหมดอิงตามศูนย์
การแสดง JSON |
---|
{ "sheetId": integer, "rowIndex": integer, "columnIndex": integer } |
ช่อง | |
---|---|
sheetId
|
แผ่นงานที่พิกัดนี้เปิดอยู่ |
rowIndex
|
ดัชนีแถวของพิกัด |
columnIndex
|
ดัชนีคอลัมน์ของพิกัด |