Other

สี

แสดงสีในพื้นที่สี 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

number

ปริมาณสีแดงในสีเป็นค่าในช่วง [0, 1]

green

number

ปริมาณสีเขียวในสีเป็นค่าในช่วง [0, 1]

blue

number

ปริมาณสีน้ำเงินในสีเป็นค่าในช่วง [0, 1]

alpha

number

ส่วนหนึ่งของสีนี้ที่ควรใช้กับพิกเซล กล่าวคือ สีพิกเซลสุดท้ายจะกำหนดโดยสมการต่อไปนี้

pixel color = alpha * (this color) + (1.0 - alpha) * (background color)

หมายความว่าค่า 1.0 จะเท่ากับสีทึบ ในขณะที่ค่า 0.0 คือสีที่โปร่งใสทั้งหมด การดำเนินการนี้จะใช้ข้อความ Wrapper แทนสเกลาร์ Float แบบง่ายเพื่อให้แยกความแตกต่างระหว่างค่าเริ่มต้นกับค่าที่ไม่ได้ตั้งค่าได้ หากไม่ระบุ ระบบจะแสดงผลออบเจ็กต์สีนี้เป็นสีพื้น (เหมือนกับว่าค่าอัลฟ่าได้รับค่า 1.0 อย่างชัดแจ้ง)

ColorStyle

ค่าสี

การแสดง JSON 
{

  // Union field kind can be only one of the following:
  "rgbColor": {
    object (Color)
  },
  "themeColor": enum (ThemeColorType)
  // End of list of possible types for union field kind.
}
ช่อง
ฟิลด์สหภาพ kind ประเภทของค่าสี kind ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
rgbColor

object (Color)

สี RGB ระบบโดยทั่วไปไม่รองรับค่า alpha ในออบเจ็กต์ Color

themeColor

enum (ThemeColorType)

สีของธีม

ThemeColorType

ประเภทสีธีม

SpreadsheetProperties มี SpreadsheetTheme ที่กําหนดการแมปประเภทสีธีมเหล่านี้กับสีที่เฉพาะเจาะจง

Enum
THEME_COLOR_TYPE_UNSPECIFIED สีธีมที่ไม่ระบุ
TEXT แสดงสีข้อความหลัก
BACKGROUND แสดงสีพื้นหลังหลัก
ACCENT1 แสดงสีเฉพาะจุดแรก
ACCENT2 แสดงสีเฉพาะจุดที่ 2
ACCENT3 แสดงสีเฉพาะจุดที่ 3
ACCENT4 แสดงสีเฉพาะจุดที่ 4
ACCENT5 แสดงสีเฉพาะจุดที่ 5
ACCENT6 แสดงสีเฉพาะจุดที่ 6

HorizontalAlign

การจัดแนวข้อความในแนวนอนของเซลล์

Enum
HORIZONTAL_ALIGN_UNSPECIFIED ไม่ได้ระบุการจัดแนวนอน อย่าใช้
LEFT ข้อความจะจัดชิดซ้ายของเซลล์อย่างชัดเจน
CENTER ข้อความจะจัดกึ่งกลางกับตรงกลางของเซลล์อย่างชัดเจน
RIGHT ข้อความจะจัดชิดขวาของเซลล์อย่างชัดเจน

TextFormat

รูปแบบของข้อความในเซลล์ ค่าที่ไม่มีอยู่หมายความว่าไม่ได้ระบุฟิลด์

การแสดง JSON 
{
  "foregroundColor": {
    object (Color)
  },
  "foregroundColorStyle": {
    object (ColorStyle)
  },
  "fontFamily": string,
  "fontSize": integer,
  "bold": boolean,
  "italic": boolean,
  "strikethrough": boolean,
  "underline": boolean,
  "link": {
    object (Link)
  }
}
ช่อง
foregroundColor
(deprecated)

object (Color)

สีพื้นหน้าของข้อความ เลิกใช้งานแล้ว: ใช้ foregroundColorStyle

foregroundColorStyle

object (ColorStyle)

สีพื้นหน้าของข้อความ หากมีการตั้งค่า foregroundColor ด้วย ช่องนี้จะมีความสำคัญเหนือกว่า

fontFamily

string

ชุดแบบอักษร

fontSize

integer

ขนาดแบบอักษร

bold

boolean

จริง หากข้อความเป็นตัวหนา

italic

boolean

เป็นจริงหากข้อความเป็นตัวเอียง

strikethrough

boolean

เป็นจริงหากข้อความมีขีดทับ

underline

boolean

จริง หากข้อความขีดเส้นใต้

DataSourceColumn

คอลัมน์ในแหล่งข้อมูล

การแสดง JSON 
{
  "reference": {
    object (DataSourceColumnReference)
  },
  "formula": string
}
ช่อง
reference

object (DataSourceColumnReference)

ข้อมูลอ้างอิงคอลัมน์

formula

string

สูตรของคอลัมน์ที่คำนวณ

DataSourceColumnReference

ตัวระบุที่ไม่ซ้ำกันซึ่งอ้างอิงคอลัมน์แหล่งข้อมูล

การแสดง JSON 
{
  "name": string
}
ช่อง
name

string

ชื่อที่แสดงของคอลัมน์ โดยควรไม่ซ้ำกันภายในแหล่งข้อมูล

DataExecutionStatus

สถานะการเรียกใช้ข้อมูล

ระบบจะสร้างการเรียกใช้ข้อมูลเพื่อซิงค์ออบเจ็กต์แหล่งข้อมูลกับข้อมูลล่าสุดจาก DataSource โดยปกติแล้วจะมีการกำหนดเวลาให้ทำงานในเบื้องหลัง คุณสามารถตรวจสอบ state ของไลบรารีเพื่อดูว่าการดำเนินการเสร็จสมบูรณ์หรือไม่

มีหลายกรณีที่ทริกเกอร์การเรียกใช้ข้อมูลให้ทํางาน ดังนี้

  • Adding a data source สร้างชีตแหล่งข้อมูลที่เชื่อมโยง รวมถึงการเรียกใช้ข้อมูลเพื่อซิงค์ข้อมูลจากแหล่งข้อมูลไปยังชีต
  • Updating a data source สร้างการเรียกใช้ข้อมูลเพื่อรีเฟรชชีตแหล่งข้อมูลที่เชื่อมโยงในลักษณะเดียวกัน
  • คุณสามารถส่ง refresh request เพื่อรีเฟรชออบเจ็กต์แหล่งข้อมูลอย่างน้อย 1 รายการอย่างชัดเจน
การแสดง JSON 
{
  "state": enum (DataExecutionState),
  "errorCode": enum (DataExecutionErrorCode),
  "errorMessage": string,
  "lastRefreshTime": string
}
ช่อง
state

enum (DataExecutionState)

สถานะของการเรียกใช้ข้อมูล

errorCode

enum (DataExecutionErrorCode)

รหัสข้อผิดพลาด

errorMessage

string

ข้อความแสดงข้อผิดพลาด ซึ่งอาจว่างเปล่า

lastRefreshTime

string (Timestamp format)

รับเวลาที่รีเฟรชข้อมูลครั้งล่าสุดได้สําเร็จ

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 can be only one of the following:
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "formulaValue": string,
  "errorValue": {
    object (ErrorValue)
  }
  // End of list of possible types for union field value.
}
ช่อง
ฟิลด์สหภาพ value ประเภทของค่าในเซลล์ หากไม่ได้ตั้งค่าฟิลด์ เซลล์จะไม่มีข้อมูล value ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
numberValue

number

แสดงค่าตัวเลขทศนิยม หมายเหตุ: วันที่ เวลา และวันที่และเวลาจะแสดงเป็นเลขคู่ในรูปแบบ SERIAL_NUMBER

stringValue

string

แสดงค่าสตริง โดยไม่รวมเครื่องหมายคำพูดเดี่ยวนำหน้า เช่น หากผู้ใช้พิมพ์ '123 ใน UI ระบบจะแสดงค่านี้เป็นรูป stringValue ของ "123"

boolValue

boolean

แสดงค่าบูลีน

formulaValue

string

แสดงสูตร

errorValue

object (ErrorValue)

แสดงถึงข้อผิดพลาด ช่องนี้เป็นแบบอ่านอย่างเดียว

ErrorValue

ข้อผิดพลาดในเซลล์

การแสดง JSON 
{
  "type": enum (ErrorType),
  "message": string
}
ช่อง
type

enum (ErrorType)

ประเภทข้อผิดพลาด

message

string

ข้อความที่มีข้อมูลเพิ่มเติมเกี่ยวกับข้อผิดพลาด (ในภาษาของสเปรดชีต)

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 (ConditionType),
  "values": [
    {
      object (ConditionValue)
    }
  ]
}
ช่อง
type

enum (ConditionType)

ประเภทของเงื่อนไข

values[]

object (ConditionValue)

ค่าของเงื่อนไข จำนวนค่าที่รองรับจะขึ้นอยู่กับ condition type บางรายการรองรับค่า 0 ส่วนบางรายการรองรับ 1 หรือ 2 ค่า และ ConditionType.ONE_OF_LIST รองรับค่าจํานวนเท่าใดก็ได้

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 รายการเป็นอย่างน้อยสําหรับตัวกรองกับออบเจ็กต์แหล่งข้อมูล
NUMBER_BETWEEN ค่าของเซลล์ต้องอยู่ระหว่างค่าเงื่อนไข 2 ค่า รองรับโดยการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ต้องใช้ ConditionValues เพียง 2 รายการเท่านั้น
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 อย่างน้อย 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 รายการ รองรับการตรวจสอบข้อมูล ต้องระบุ 2 รายการเท่านั้น ConditionValues
DATE_NOT_BETWEEN ค่าของเซลล์ต้องอยู่นอกวันที่ของค่าเงื่อนไข 2 ค่า รองรับการตรวจสอบข้อมูล ต้องระบุ 2 รายการเท่านั้น ConditionValues
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 ค่าบ่งบอกว่าเซลล์จะแสดงผลเป็น "เลือก" เมื่อมีค่าแรก และแสดงผลเป็น "ไม่ได้เลือก" เมื่อมีค่าที่ 2 เช่น ["Yes","No"] บ่งบอกว่าเซลล์จะแสดงผลช่องทําเครื่องหมายเมื่อมีค่าเป็น "Yes" และช่องที่ไม่ได้ทําเครื่องหมายเมื่อมีค่าเป็น "No"
TEXT_NOT_EQ ค่าของเซลล์ต้องไม่ตรงกับค่าของเงื่อนไข ตัวกรองในออบเจ็กต์แหล่งข้อมูลรองรับ ต้องใช้ ConditionValue อย่างน้อย 1 รายการ
DATE_NOT_EQ ค่าของเซลล์ต้องไม่ตรงกับค่าของเงื่อนไข ตัวกรองในออบเจ็กต์แหล่งข้อมูลรองรับ ต้องมีConditionValueอย่างน้อย 1 รายการ
FILTER_EXPRESSION ค่าของเซลล์ต้องเป็นไปตามรูปแบบที่ระบุ ต้องใช้ ConditionValue รายการเดียว

ConditionValue

ค่าของเงื่อนไข

การแสดง JSON 
{

  // Union field value can be only one of the following:
  "relativeDate": enum (RelativeDate),
  "userEnteredValue": string
  // End of list of possible types for union field value.
}
ช่อง
ฟิลด์สหภาพ value ต้องตั้งค่าค่าของเงื่อนไขเพียงค่าเดียว value อาจเป็นได้เพียงค่าใดค่าหนึ่งต่อไปนี้
relativeDate

enum (RelativeDate)

วันที่แบบสัมพัทธ์ (อิงตามวันที่ปัจจุบัน) ใช้ได้เฉพาะในกรณีที่ type คือ DATE_BEFORE, DATE_AFTER, DATE_ON_OR_BEFORE หรือ DATE_ON_OR_AFTER

การตรวจสอบข้อมูลไม่รองรับวันที่แบบสัมพัทธ์ โดยจะรองรับเฉพาะในตัวกรองการจัดรูปแบบตามเงื่อนไขและตัวกรองแบบมีเงื่อนไขเท่านั้น

userEnteredValue

string

ค่าที่เงื่อนไขอ้างอิง ค่านี้จะแยกวิเคราะห์เสมือนว่าผู้ใช้พิมพ์ลงในเซลล์ ระบบรองรับสูตร (และต้องขึ้นต้นด้วย = หรือ '+')

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

integer

แผ่นงานช่วงนี้เปิดอยู่

startRowIndex

integer

แถวเริ่มต้น (รวม) ของช่วง หรือไม่ได้ตั้งค่าไว้หากไม่มีขอบเขต

endRowIndex

integer

แถวสุดท้าย (ไม่รวม) ของช่วง หรือไม่ได้ตั้งค่าหากไม่มีขอบเขต

startColumnIndex

integer

คอลัมน์เริ่มต้น (รวม) ของช่วง หรือไม่ได้ตั้งค่าหากไม่มีขอบเขต

endColumnIndex

integer

คอลัมน์สิ้นสุด (ไม่รวม) ของช่วง หรือไม่ได้ตั้งค่าหากไม่มีขอบเขต

SortOrder

ลำดับการจัดเรียง

Enum
SORT_ORDER_UNSPECIFIED ค่าเริ่มต้น อย่าใช้ค่านี้
ASCENDING จัดเรียงจากน้อยไปหามาก
DESCENDING จัดเรียงจากมากไปน้อย

FilterSpec

เกณฑ์ตัวกรองที่เชื่อมโยงกับคอลัมน์หนึ่งๆ

การแสดง JSON 
{
  "filterCriteria": {
    object (FilterCriteria)
  },

  // Union field reference can be only one of the following:
  "columnIndex": integer,
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field reference.
}
ช่อง
filterCriteria

object (FilterCriteria)

เกณฑ์สําหรับคอลัมน์

ช่องการรวม reference การอ้างอิงคอลัมน์ที่กรอง reference ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
columnIndex

integer

ดัชนีคอลัมน์แบบ 0

dataSourceColumnReference

object (DataSourceColumnReference)

การอ้างอิงคอลัมน์แหล่งข้อมูล

FilterCriteria

เกณฑ์สำหรับแสดง/ซ่อนแถวในตัวกรองหรือมุมมองตัวกรอง

การแสดง JSON 
{
  "hiddenValues": [
    string
  ],
  "condition": {
    object (BooleanCondition)
  },
  "visibleBackgroundColor": {
    object (Color)
  },
  "visibleBackgroundColorStyle": {
    object (ColorStyle)
  },
  "visibleForegroundColor": {
    object (Color)
  },
  "visibleForegroundColorStyle": {
    object (ColorStyle)
  }
}
ช่อง
hiddenValues[]

string

ค่าที่ควรซ่อน

condition

object (BooleanCondition)

เงื่อนไขที่ต้องเป็นจริงเพื่อให้ค่าแสดง (การดำเนินการนี้จะไม่ลบล้าง hiddenValues หากมีการแสดงค่าในรายการดังกล่าว ค่าดังกล่าวจะยังคงซ่อนอยู่)

visibleBackgroundColor
(deprecated)

object (Color)

สีเติมพื้นหลังที่จะกรอง โดยระบบจะแสดงเฉพาะเซลล์ที่มีสีเติมนี้ ใช้ร่วมกันไม่ได้กับ visibleForegroundColor เลิกใช้งานแล้ว: ใช้ visibleBackgroundColorStyle

visibleBackgroundColorStyle

object (ColorStyle)

สีเติมพื้นหลังที่จะกรอง ระบบจะแสดงเฉพาะเซลล์ที่มีสีเติมนี้เท่านั้น ช่องนี้ใช้ร่วมกันไม่ได้กับ visibleForegroundColor และต้องตั้งค่าเป็นสีประเภท RGB หากมีการตั้งค่า visibleBackgroundColor ไว้ด้วย ช่องนี้จะมีลำดับความสำคัญเหนือกว่า

visibleForegroundColor
(deprecated)

object (Color)

สีพื้นหน้าที่จะกรอง โดยระบบจะแสดงเฉพาะเซลล์ที่มีสีพื้นหน้านี้ พิเศษสำหรับ visibleBackgroundColor เลิกใช้งานแล้ว: ใช้ visibleForegroundColorStyle

visibleForegroundColorStyle

object (ColorStyle)

สีพื้นหน้าที่จะกรอง โดยระบบจะแสดงเฉพาะเซลล์ที่มีสีพื้นหน้านี้ ช่องนี้ใช้ร่วมกันไม่ได้กับ visibleBackgroundColor และต้องตั้งค่าเป็นสีประเภท RGB หากมีการตั้งค่า visibleForegroundColor ด้วย ช่องนี้จะมีความสำคัญเหนือกว่า

SortSpec

ลำดับการจัดเรียงที่เชื่อมโยงกับคอลัมน์หรือแถวหนึ่งๆ

การแสดง JSON 
{
  "sortOrder": enum (SortOrder),
  "foregroundColor": {
    object (Color)
  },
  "foregroundColorStyle": {
    object (ColorStyle)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },

  // Union field reference can be only one of the following:
  "dimensionIndex": integer,
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field reference.
}
ช่อง
sortOrder

enum (SortOrder)

ควรจัดเรียงข้อมูลคำสั่งซื้อ

foregroundColor
(deprecated)

object (Color)

สีพื้นหน้าที่จะจัดเรียงตาม โดยระบบจะจัดเรียงเซลล์ที่มีสีพื้นหน้านี้ไว้ที่ด้านบน พิเศษสำหรับ backgroundColor เลิกใช้งานแล้ว: ใช้ foregroundColorStyle

foregroundColorStyle

object (ColorStyle)

สีพื้นหน้าที่จะจัดเรียง เซลล์ที่มีสีพื้นหน้านี้จะจัดเรียงไปที่ด้านบนสุด ใช้ร่วมกันไม่ได้กับ backgroundColor และต้องต้องเป็นสีประเภท RGB หากมีการตั้งค่า foregroundColor ไว้ด้วย ช่องนี้จะมีลำดับความสำคัญเหนือกว่า

backgroundColor
(deprecated)

object (Color)

สีเติมพื้นหลังที่จะจัดเรียงตาม โดยระบบจะจัดเรียงเซลล์ที่มีสีเติมนี้ไว้ที่ด้านบน พิเศษสำหรับ foregroundColor เลิกใช้งานแล้ว: ใช้ backgroundColorStyle

backgroundColorStyle

object (ColorStyle)

สีเติมพื้นหลังที่จะจัดเรียงตาม โดยระบบจะจัดเรียงเซลล์ที่มีสีเติมนี้ไว้ที่ด้านบน ใช้ร่วมกับ foregroundColor ไม่ได้ และต้องเป็นสีประเภท RGB หากมีการตั้งค่า backgroundColor ด้วย ช่องนี้จะมีความสำคัญเหนือกว่า

ฟิลด์สหภาพ reference การอ้างอิงถึงมิติข้อมูลที่จัดเรียง reference ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
dimensionIndex

integer

มิติข้อมูลที่ควรใช้การจัดเรียง

dataSourceColumnReference

object (DataSourceColumnReference)

การอ้างอิงคอลัมน์แหล่งข้อมูล

EmbeddedObjectPosition

ตำแหน่งของวัตถุที่ฝัง เช่น แผนภูมิ

การแสดง JSON 
{

  // Union field location can be only one of the following:
  "sheetId": integer,
  "overlayPosition": {
    object (OverlayPosition)
  },
  "newSheet": boolean
  // End of list of possible types for union field location.
}
ช่อง
ฟิลด์สหภาพ location ตำแหน่งของออบเจ็กต์ ต้องตั้งค่าเพียง 1 ค่าเท่านั้น location ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
sheetId

integer

แผ่นงานที่เปิดอยู่ ตั้งค่าเฉพาะในกรณีที่ออบเจ็กต์ที่ฝังอยู่ในชีตของตัวเอง ต้องไม่ติดลบ

overlayPosition

object (OverlayPosition)

ตําแหน่งที่วางซ้อนออบเจ็กต์บนตารางกริด

newSheet

boolean

หากเป็น "จริง" ระบบจะใส่ออบเจ็กต์ที่ฝังไว้ในชีตใหม่ที่มีการเลือกรหัสให้คุณ ใช้เมื่อเขียนเท่านั้น

OverlayPosition

ตำแหน่งที่วัตถุวางซ้อนกันบนตารางกริด

การแสดง JSON 
{
  "anchorCell": {
    object (GridCoordinate)
  },
  "offsetXPixels": integer,
  "offsetYPixels": integer,
  "widthPixels": integer,
  "heightPixels": integer
}
ช่อง
anchorCell

object (GridCoordinate)

เซลล์ที่แอบเฝ้าวัตถุ

offsetXPixels

integer

ระยะห่างแนวนอนเป็นพิกเซลที่ออบเจ็กต์ถูกเลื่อนออกจากเซลล์หลัก

offsetYPixels

integer

ออฟเซ็ตแนวตั้งในหน่วยพิกเซลที่ค่าชดเชยวัตถุจากเซลล์จุดยึด

widthPixels

integer

ความกว้างของวัตถุในหน่วยพิกเซล ค่าเริ่มต้นคือ 600

heightPixels

integer

ความสูงของวัตถุในหน่วยพิกเซล ค่าเริ่มต้นคือ 371

GridCoordinate

พิกัดในชีต ดัชนีทั้งหมดจะนับจาก 0

การแสดง JSON 
{
  "sheetId": integer,
  "rowIndex": integer,
  "columnIndex": integer
}
ช่อง
sheetId

integer

ชีตที่มีพิกัดนี้

rowIndex

integer

ดัชนีแถวของพิกัด

columnIndex

integer

ดัชนีคอลัมน์ของพิกัด