Other

สี

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

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 แทนสเกลาร์แบบลอยตัวอย่างง่ายเพื่อให้แยกความแตกต่างระหว่างค่าเริ่มต้นกับค่าที่ไม่ได้ตั้งค่าได้ หากละเว้นไว้ ระบบจะแสดงออบเจ็กต์สีนี้เป็นสีทึบ (ราวกับว่าค่าอัลฟ่าได้รับค่า 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.
}
ช่อง
ฟิลด์ Union 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.
}
ช่อง
ฟิลด์ Union value ประเภทของค่าในเซลล์ หากไม่ได้ตั้งค่าฟิลด์ใด เซลล์จะไม่มีข้อมูล value ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
numberValue

number

แสดงค่าแบบ Double หมายเหตุ: วันที่ เวลา และวันที่เวลาจะแสดงเป็นจำนวนทศนิยมในรูปแบบ 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

เงื่อนไขที่ประเมินค่าเป็นจริงหรือเท็จได้ การจัดรูปแบบตามเงื่อนไข การตรวจสอบข้อมูล และเกณฑ์ในตัวกรองใช้ BooleanCondition

การแสดง 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 อย่างน้อย 1 รายการ สำหรับตัวกรองในออบเจ็กต์แหล่งข้อมูล
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 อย่างน้อย 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.
}
ช่อง
ฟิลด์ Union value ต้องตั้งค่าเงื่อนไข 1 รายการ 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

ช่วงในชีต ดัชนีทั้งหมดเป็นแบบ Zero-based ดัชนีจะเปิดครึ่งหนึ่ง กล่าวคือ ดัชนีเริ่มต้นจะรวมและดัชนีสิ้นสุดจะไม่รวม -- [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)

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

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

integer

ดัชนีคอลัมน์แบบ Zero-based

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)

เงื่อนไขที่ต้องเป็น true เพื่อให้ค่าแสดง (การดำเนินการนี้จะไม่ลบล้าง 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 ไว้ด้วย ช่องนี้จะมีความสำคัญเหนือกว่า

ฟิลด์ Union 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.
}
ช่อง
ฟิลด์ Union 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

พิกัดในชีต ดัชนีทั้งหมดเป็นแบบ Zero-based

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

integer

ชีตที่พิกัดนี้อยู่

rowIndex

integer

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

columnIndex

integer

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