สี
แสดงสีในพื้นที่สี RGBA รูปแบบนี้ได้รับการออกแบบมาสําหรับความเรียบง่ายของการแปลงเป็นและมาจากการแสดงสีในภาษาต่างๆ มากกว่ากะทัดรัด เช่น ช่องของการนําเสนอนี้จะให้ข้อมูลกับตัวสร้างของ
java.awt.Color
ใน Java ก็ได้ โดยอาจระบุเป็นเมธอด +colorWithRed:green:blue:alpha
ของ UIColor ใน iOS
ด้วยรูปแบบเล็กๆ น้อยๆ จะมีการจัดรูปแบบเป็นสตริง
rgba()
CSS
ใน 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) |
ลักษณะสี
ค่าสี
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ช่อง Union
kind ชนิดของค่าสี
kind
ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
|
|
rgbColor
|
|
themeColor
|
สีธีม |
ประเภทสี
ประเภทสีธีม
SpreadsheetProperties
มี SpreadsheetTheme
ที่กําหนดการแมปประเภทสีเหล่านี้ไปยังสีคอนกรีต
Enum | |
---|---|
THEME_COLOR_TYPE_UNSPECIFIED
|
สีธีมที่ไม่ระบุ |
TEXT
|
แสดงสีข้อความหลัก |
BACKGROUND
|
แสดงสีพื้นหลังหลัก |
ACCENT1
|
แสดงสีเฉพาะจุดแรก |
ACCENT2
|
แสดงสีเฉพาะจุดที่สอง |
ACCENT3
|
แสดงสีเฉพาะจุดที่สาม |
ACCENT4
|
แสดงสีเฉพาะจุดสีที่สี่ |
ACCENT5
|
แสดงสีเฉพาะจุดสีที่ห้า |
ACCENT6
|
แสดงสีเฉพาะจุดสีที่หก |
LINK
|
แสดงสีที่จะใช้สําหรับไฮเปอร์ลิงก์ |
จัดข้อความแนวนอน
การจัดแนวข้อความตามแนวนอนในเซลล์
Enum | |
---|---|
HORIZONTAL_ALIGN_UNSPECIFIED
|
ไม่ได้ระบุการจัดข้อความแนวนอน อย่าใช้ |
LEFT
|
ข้อความจะถูกจัดชิดไว้ทางด้านซ้ายของเซลล์อย่างชัดเจน |
CENTER
|
ข้อความจะถูกจัดแนวไว้ตรงกลางของเซลล์อย่างชัดเจน |
RIGHT
|
ข้อความปรับแนวชิดด้านขวาของเซลล์อย่างชัดเจน |
รูปแบบข้อความ
รูปแบบของการเรียกใช้ข้อความในเซลล์ ค่าที่ไม่มีเครื่องหมายนั้นระบุว่าไม่ได้ระบุช่องดังกล่าว
การแสดง JSON |
---|
{ "foregroundColor": { object ( |
ช่อง | |
---|---|
foregroundColor
|
สีพื้นหน้าของข้อความ เลิกใช้งานแล้ว: ใช้ |
foregroundColorStyle
|
สีพื้นหน้าของข้อความ หากมีการตั้งค่า |
fontFamily
|
ชุดแบบอักษร |
fontSize
|
ขนาดของแบบอักษร |
bold
|
เป็นจริงถ้าข้อความเป็นตัวหนา |
italic
|
เป็นจริงถ้าข้อความเป็นตัวเอียง |
strikethrough
|
เป็นจริงถ้าข้อความมีขีดทับ |
underline
|
จริง หากขีดเส้นใต้ข้อความ |
link
|
ปลายทางของลิงก์ของข้อความ ถ้ามี การตั้งค่าช่องลิงก์ใน |
ลิงก์
การอ้างอิงภายนอกหรือภายใน
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ช่อง Union
destination ปลายทางของลิงก์
destination
ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
|
|
uri
|
ตัวระบุลิงก์ |
คอลัมน์แหล่งข้อมูล
คอลัมน์ในแหล่งข้อมูล
การแสดง JSON |
---|
{
"reference": {
object (
|
ช่อง | |
---|---|
reference
|
การอ้างอิงคอลัมน์ |
formula
|
สูตรของคอลัมน์ที่คํานวณ |
ข้อมูลอ้างอิงคอลัมน์ข้อมูล
ตัวระบุที่ไม่ซ้ํากันซึ่งอ้างอิงคอลัมน์แหล่งข้อมูล
การแสดง JSON |
---|
{ "name": string } |
ช่อง | |
---|---|
name
|
ชื่อที่แสดงของคอลัมน์ และไม่ควรซ้ํากันในแหล่งข้อมูล |
สถานะการดําเนินการข้อมูล
สถานะการเรียกใช้ข้อมูล
สร้างการดําเนินการกับข้อมูลเพื่อซิงค์ออบเจ็กต์แหล่งข้อมูลกับข้อมูลล่าสุดจาก DataSource
ซึ่งโดยปกติจะมีกําหนดการให้ทํางานในเบื้องหลัง คุณสามารถตรวจสอบ state
เพื่อให้ทราบว่าการดําเนินการเสร็จสมบูรณ์หรือไม่
มีหลายสถานการณ์ที่จะมีการทริกเกอร์การเรียกใช้ข้อมูล:
-
Adding a data source
สร้างชีตแหล่งข้อมูลที่เกี่ยวข้อง รวมถึงการเรียกใช้ข้อมูลเพื่อซิงค์ข้อมูลจากแหล่งข้อมูลไปยังชีต -
Updating a data source
สร้างการดําเนินการของข้อมูลเพื่อรีเฟรชชีตแหล่งข้อมูลที่เกี่ยวข้องในลักษณะเดียวกัน -
คุณส่ง
refresh request
เพื่อรีเฟรชออบเจ็กต์แหล่งข้อมูลได้อย่างน้อย 1 รายการ
การแสดง JSON |
---|
{ "state": enum ( |
ช่อง | |
---|---|
state
|
สถานะของการเรียกใช้ข้อมูล |
errorCode
|
รหัสข้อผิดพลาด |
errorMessage
|
ข้อความแสดงข้อผิดพลาด ซึ่งอาจว่างเปล่า |
lastRefreshTime
|
รับเวลาที่รีเฟรชข้อมูลครั้งล่าสุด |
สถานะการเรียกใช้ข้อมูล
การแจกแจงสถานะการประมวลผลข้อมูล
Enum | |
---|---|
DATA_EXECUTION_STATE_UNSPECIFIED
|
ค่าเริ่มต้น ไม่ใช้ |
NOT_STARTED
|
ยังไม่ได้เริ่มการเรียกใช้ข้อมูล |
RUNNING
|
การดําเนินการข้อมูลได้เริ่มขึ้นแล้วและกําลังทํางานอยู่ |
SUCCEEDED
|
การเรียกใช้ข้อมูลเสร็จสมบูรณ์แล้ว |
FAILED
|
การเรียกใช้ข้อมูลเสร็จสมบูรณ์แล้วโดยมีข้อผิดพลาด |
รหัสข้อผิดพลาดของ DataExecution
การแจงนับรหัสข้อผิดพลาดของการเรียกใช้ข้อมูล
Enum | |
---|---|
DATA_EXECUTION_ERROR_CODE_UNSPECIFIED
|
ค่าเริ่มต้น ไม่ใช้ |
TIMED_OUT
|
หมดเวลาการเรียกใช้ข้อมูล |
TOO_MANY_ROWS
|
การดําเนินการกับข้อมูลแสดงผลแถวมากกว่าขีดจํากัด |
TOO_MANY_COLUMNS
|
การเรียกใช้ข้อมูลจะแสดงคอลัมน์มากกว่าขีดจํากัด |
TOO_MANY_CELLS
|
การดําเนินการกับข้อมูลจะแสดงผลเซลล์เกินจํานวนที่กําหนด |
ENGINE
|
ได้รับข้อผิดพลาดจากเครื่องมือการดําเนินการข้อมูลแบ็กเอนด์ (เช่น BigQuery) ดูรายละเอียดได้ที่ errorMessage
|
PARAMETER_INVALID
|
พารามิเตอร์แหล่งข้อมูลที่ระบุอย่างน้อยหนึ่งรายการไม่ถูกต้อง |
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
|
ข้อกําหนดของออบเจ็กต์แหล่งข้อมูลไม่ถูกต้อง |
ค่าที่เพิ่มมา
ชนิดของเซลล์ที่สเปรดชีตมีได้
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ช่อง Union
value ประเภทของค่าในเซลล์ ถ้าไม่ได้ตั้งค่าช่องใดไว้ เซลล์นั้นจะไม่มีข้อมูล
value
ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
|
|
numberValue
|
แสดงค่าคู่ หมายเหตุ: วันที่ เวลา และ วันที่และเวลา จะแสดงเป็นสองเท่าในรูปแบบ |
stringValue
|
แสดงค่าสตริง ไม่รวมอัญประกาศเดี่ยวที่นําหน้า เช่น หากผู้ใช้พิมพ์ |
boolValue
|
แสดงค่าบูลีน |
formulaValue
|
แสดงสูตร |
errorValue
|
แสดงถึงข้อผิดพลาด ช่องนี้เป็นแบบอ่านอย่างเดียว |
ค่าข้อผิดพลาด
ข้อผิดพลาดในเซลล์
การแสดง JSON |
---|
{
"type": enum (
|
ช่อง | |
---|---|
type
|
ประเภทของข้อผิดพลาด |
message
|
ข้อความที่มีข้อมูลเพิ่มเติมเกี่ยวกับข้อผิดพลาด (ในภาษาของสเปรดชีต) |
ประเภทข้อผิดพลาด
ประเภทของข้อผิดพลาด
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...
|
สภาพบูลีน
เงื่อนไขที่สามารถประเมินเป็นจริงหรือเท็จ บูลีนจะใช้การจัดรูปแบบตามเงื่อนไข การตรวจสอบข้อมูล และเกณฑ์ในตัวกรอง
การแสดง JSON |
---|
{ "type": enum ( |
ช่อง | |
---|---|
type
|
ประเภทของเงื่อนไข |
values[]
|
ค่าของเงื่อนไข จํานวนค่าที่รองรับขึ้นอยู่กับ |
ประเภทเงื่อนไข
ประเภทของเงื่อนไข
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
|
ค่าของเซลล์ต้องไม่ใช่ค่าระหว่างเงื่อนไขทั้งสอง รองรับการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ต้องมี 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
|
ค่าของเซลล์ต้องอยู่ระหว่างวันที่ของค่าเงื่อนไขสองค่า รองรับการตรวจสอบข้อมูล ต้องมี ConditionValues จํานวน 2 รายการ
|
DATE_NOT_BETWEEN
|
ค่าของเซลล์ต้องอยู่นอกวันที่ของค่าเงื่อนไข 2 ค่า รองรับการตรวจสอบข้อมูล ต้องมี ConditionValues จํานวน 2 รายการ
|
DATE_IS_VALID
|
ค่าของเซลล์ต้องเป็นวันที่ รองรับการตรวจสอบข้อมูล ไม่ต้องใช้ ConditionValues
|
ONE_OF_RANGE
|
ค่าของเซลล์ต้องอยู่ในตารางกริดในช่วงของค่าเงื่อนไข รองรับการตรวจสอบข้อมูล ต้องมี ConditionValue ค่าเดียว และค่าต้องเป็นช่วงที่ถูกต้องในรูปแบบ A1
|
ONE_OF_LIST
|
ค่าของเซลล์ต้องอยู่ในรายการค่าของเงื่อนไข รองรับการตรวจสอบข้อมูล รองรับ condition values กี่หมายเลขก็ได้ 1 รหัสต่อ 1 กลุ่มในรายการ ระบบไม่รองรับสูตรในค่า
|
BLANK
|
ค่าของเซลล์ต้องว่างเปล่า รองรับโดยการจัดรูปแบบและตัวกรองตามเงื่อนไข ไม่ต้องใช้ ConditionValues
|
NOT_BLANK
|
ค่าของเซลล์ต้องไม่เว้นว่าง รองรับโดยการจัดรูปแบบและตัวกรองตามเงื่อนไข ไม่ต้องใช้ ConditionValues
|
CUSTOM_FORMULA
|
สูตรของเงื่อนไขต้องประเมินค่าเป็นจริง รองรับการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ตัวกรองแผ่นงานแหล่งข้อมูลไม่ได้รับการสนับสนุน ต้องมี ConditionValue รายการเดียว
|
BOOLEAN
|
ค่าของเซลล์ต้องเป็น TRUE/FALSE หรือในรายการค่าของเงื่อนไข รองรับการตรวจสอบข้อมูล แสดงผลเป็นช่องทําเครื่องหมายเซลล์ รองรับ 0, 1 หรือ 2
ConditionValues ไม่มีค่าที่ระบุว่าเซลล์ต้องเป็น TRUE หรือ FALSE โดยที่ TRUE แสดงผลเป็นทําเครื่องหมายเลือก และ FALSE จะแสดงผลว่าไม่ได้เลือก ค่าหนึ่งบ่งชี้ว่าเซลล์จะแสดงผลเป็นทําเครื่องหมายเมื่อค่านั้นถูกเลือกและค่าเมื่อเว้นว่างไว้ ค่า 2 ค่าบ่งชี้ว่าเซลล์จะแสดงผลเป็น "ทําเครื่องหมายแล้ว" เมื่อมีค่าแรกและยกเลิกการเลือกเมื่อมีค่าที่สอง เช่น ["ใช่","ไม่"] แสดงว่าเซลล์จะแสดงช่องทําเครื่องหมายเมื่อมีค่าเป็น "ใช่" และช่องที่ไม่ได้ทําเครื่องหมายเมื่อมีค่าเป็น "ไม่"
|
TEXT_NOT_EQ
|
ค่าของเซลล์ต้องไม่ใช่ค่าของเงื่อนไขที่แน่นอน รองรับโดยตัวกรองในออบเจ็กต์แหล่งข้อมูล ต้องมี ConditionValue อย่างน้อย 1 รายการ
|
DATE_NOT_EQ
|
ค่าของเซลล์ต้องไม่ใช่ค่าของเงื่อนไขที่แน่นอน รองรับโดยตัวกรองในออบเจ็กต์แหล่งข้อมูล ต้องมี ConditionValue อย่างน้อย 1 รายการ
|
FILTER_EXPRESSION
|
ค่าของเซลล์ต้องเป็นไปตามรูปแบบที่ระบุไว้ ต้องมี ConditionValue รายการเดียว
|
ค่าแบบมีเงื่อนไข
ค่าของเงื่อนไข
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ช่อง Union
value ต้องกําหนดค่าของเงื่อนไข
value
ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
|
|
relativeDate
|
วันที่สัมพัทธ์ (อิงตามวันที่ปัจจุบัน) ใช้ได้เฉพาะเมื่อ
วันที่สัมพัทธ์ไม่ได้รับการสนับสนุนในการตรวจสอบข้อมูล ตัวกรองใช้ได้ในการจัดรูปแบบตามเงื่อนไขและตัวกรองตามเงื่อนไขเท่านั้น |
userEnteredValue
|
ค่าที่เงื่อนไขอ้างอิง ระบบจะแยกวิเคราะห์ค่าเหมือนกับว่าผู้ใช้พิมพ์ไปยังเซลล์ ระบบรองรับสูตร (และต้องขึ้นต้นด้วย |
วันที่สัมพัทธ์
ควบคุมวิธีประเมินเงื่อนไขวันที่
Enum | |
---|---|
RELATIVE_DATE_UNSPECIFIED
|
ค่าเริ่มต้น ไม่ใช้ |
PAST_YEAR
|
โดยค่าเป็น 1 ปีก่อนหน้าวันนี้ |
PAST_MONTH
|
ค่านี้คือ 1 เดือนก่อนวันนี้ |
PAST_WEEK
|
ค่าคือ 1 สัปดาห์ก่อนหน้าวันนี้ |
YESTERDAY
|
ค่าคือเมื่อวาน |
TODAY
|
ค่าคือวันนี้ |
TOMORROW
|
ค่าคือพรุ่งนี้ |
กริดช่วง
ช่วงในแผ่นงาน ดัชนีทั้งหมดเป็นแบบศูนย์ ดัชนีเปิดอยู่ครึ่งหนึ่ง กล่าวคือ ดัชนีเริ่มต้นเป็นแบบรวม และดัชนีปิดท้ายไม่รวม - [startIndex, endIndex) ส่วนดัชนีที่หายไปนั้นระบุว่าไม่มีช่วงของด้านนั้น
เช่น หาก "Sheet1"
คือ Sheets 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
|
จัดเรียงจากมากไปน้อย |
ข้อมูลจําเพาะของตัวกรอง
เกณฑ์ตัวกรองที่เชื่อมโยงกับคอลัมน์ใดคอลัมน์หนึ่ง
การแสดง JSON |
---|
{ "filterCriteria": { object ( |
ช่อง | |
---|---|
filterCriteria
|
เกณฑ์สําหรับคอลัมน์ |
ช่อง Union
reference การอ้างอิงไปยังคอลัมน์ที่กรอง
reference
ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
|
|
columnIndex
|
ดัชนีคอลัมน์ |
dataSourceColumnReference
|
มีการอ้างถึงคอลัมน์แหล่งข้อมูล |
เกณฑ์ตัวกรอง
เกณฑ์ในการแสดง/ซ่อนแถวในมุมมองตัวกรองหรือมุมมองตัวกรอง
การแสดง JSON |
---|
{ "hiddenValues": [ string ], "condition": { object ( |
ช่อง | |
---|---|
condition
|
เงื่อนไขที่ต้องเป็นจริงสําหรับค่าต่างๆ จึงจะแสดง (โดยจะไม่ลบล้าง |
visibleBackgroundColor
|
สีพื้นหลังของสิ่งที่จะกรองเพื่อแสดงเฉพาะเซลล์ที่มีสีเติมนี้ ใช้ได้กับ |
visibleBackgroundColorStyle
|
สีพื้นหลังของสิ่งที่จะกรองเพื่อแสดงเฉพาะเซลล์ที่มีสีเติมนี้ ช่องนี้จะมี |
visibleForegroundColor
|
สีพื้นหน้าที่จะใช้กรอง จะแสดงเฉพาะเซลล์สีพื้นหน้าเท่านั้น ใช้ได้กับ |
visibleForegroundColorStyle
|
สีพื้นหน้าที่จะใช้กรอง จะแสดงเฉพาะเซลล์สีพื้นหน้าเท่านั้น ช่องนี้จะมี |
จัดเรียงสเปค
ลําดับการจัดเรียงที่เชื่อมโยงกับคอลัมน์หรือแถวที่ต้องการ
การแสดง JSON |
---|
{ "sortOrder": enum ( |
ช่อง | |
---|---|
sortOrder
|
ข้อมูลคําสั่งซื้อควรจัดเรียง |
foregroundColor
|
สีพื้นหน้าจะจัดเรียงตาม เซลล์ที่มีสีพื้นหน้านี้จะจัดเรียงตามด้านบน ใช้ได้กับ |
foregroundColorStyle
|
สีพื้นหน้าจะจัดเรียงตาม เซลล์ที่มีสีพื้นหน้านี้จะจัดเรียงตามด้านบน ใช้กับ |
backgroundColor
|
สีเติมพื้นหลังจะจัดเรียงตาม เซลล์ที่มีสีเติมนี้จะจัดเรียงไปด้านบนสุด ใช้ได้กับ |
backgroundColorStyle
|
สีเติมพื้นหลังจะจัดเรียงตาม เซลล์ที่มีสีเติมนี้จะจัดเรียงไปด้านบนสุด ใช้กับ |
ช่อง Union
reference อ้างอิงไปยังมิติข้อมูลที่จัดเรียง
reference
ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
|
|
dimensionIndex
|
มิติข้อมูลที่ควรใช้ |
dataSourceColumnReference
|
มีการอ้างถึงคอลัมน์แหล่งข้อมูล |
ตําแหน่งของออบเจ็กต์แบบฝัง
ตําแหน่งของวัตถุที่ฝังไว้ เช่น แผนภูมิ
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ช่อง Union
location ตําแหน่งของวัตถุ ต้องตั้งค่า 1 ค่าเท่านั้น
location
ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
|
|
sheetId
|
แผ่นงานนี้อยู่ ตั้งค่าเมื่อวัตถุที่ฝังอยู่บนแผ่นงานของตนเองเท่านั้น ต้องไม่เป็นจํานวนที่เป็นลบ |
overlayPosition
|
ตําแหน่งที่วางวัตถุซ้อนทับบนตารางกริด |
newSheet
|
หากเป็น "จริง" ระบบจะวางออบเจ็กต์ที่ฝังในแผ่นงานใหม่ซึ่งจะเลือกรหัสให้คุณ ใช้เมื่อเขียนเท่านั้น |
ตําแหน่งโฆษณาซ้อนทับ
ตําแหน่งที่วัตถุวางซ้อนบนตารางกริด
การแสดง JSON |
---|
{
"anchorCell": {
object (
|
ช่อง | |
---|---|
anchorCell
|
เซลล์ที่ยึดวัตถุกับเซลล์ |
offsetXPixels
|
ออฟเซ็ตแนวนอนในหน่วยพิกเซลซึ่งออบเจ็กต์ออฟเซ็ตจากเซลล์จุดยึด |
offsetYPixels
|
ออฟเซ็ตแนวตั้งเป็นพิกเซลที่ออบเจ็กต์ออฟเซ็ตจากเซลล์ Anchor |
widthPixels
|
ความกว้างของวัตถุในหน่วยพิกเซล ค่าเริ่มต้นคือ 600 |
heightPixels
|
ความสูงของวัตถุในหน่วยพิกเซล ค่าเริ่มต้นคือ 371 |
แผนที่ประสานงาน
พิกัดในแผ่นงาน ดัชนีทั้งหมดเป็นแบบศูนย์
การแสดง JSON |
---|
{ "sheetId": integer, "rowIndex": integer, "columnIndex": integer } |
ช่อง | |
---|---|
sheetId
|
ชีตที่พิกัดนี้เปิดอยู่ |
rowIndex
|
ดัชนีแถวของพิกัด |
columnIndex
|
ดัชนีคอลัมน์ของพิกัด |