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 แทนที่จะเป็นสเกลาร์ลอยตัวแบบง่ายเพื่อให้แยกความแตกต่างระหว่างค่าเริ่มต้นกับค่าที่ไม่ได้ตั้งค่าได้ หากไม่ระบุ วัตถุสีนี้จะแสดงเป็นสีทึบ (เสมือนว่าค่าอัลฟ่าได้รับการระบุอย่างชัดเจนว่าเป็น 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 แสดงสีเฉพาะจุดที่สอง
ACCENT3 แสดงสีเฉพาะจุดที่สาม
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 อย่างน้อย 1 รายการสำหรับตัวกรองในออบเจ็กต์แหล่งข้อมูล
NUMBER_BETWEEN ค่าของเซลล์ต้องอยู่ระหว่างค่าเงื่อนไข 2 ค่า รองรับโดยการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ต้องใช้ ConditionValues 2 รายการเท่านั้น
NUMBER_NOT_BETWEEN ค่าของเซลล์ต้องไม่อยู่ระหว่างค่าเงื่อนไข 2 ค่า รองรับโดยการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ต้องใช้ ConditionValues 2 รายการเท่านั้น
TEXT_CONTAINS ค่าของเซลล์ต้องมีค่าของเงื่อนไข รองรับโดยการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ต้องใช้ ConditionValue รายการเดียว
TEXT_NOT_CONTAINS ค่าของเซลล์ต้องไม่มีค่าของเงื่อนไข รองรับโดยการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ต้องใช้ ConditionValue รายการเดียว
TEXT_STARTS_WITH ค่าของเซลล์ต้องขึ้นต้นด้วยค่าของเงื่อนไข รองรับโดยการจัดรูปแบบตามเงื่อนไขและตัวกรอง ต้องใช้ ConditionValue รายการเดียว
TEXT_ENDS_WITH ค่าของเซลล์ต้องลงท้ายด้วยค่าของเงื่อนไข รองรับโดยการจัดรูปแบบตามเงื่อนไขและตัวกรอง ต้องใช้ ConditionValue รายการเดียว
TEXT_EQ ค่าของเซลล์ต้องตรงกับค่าของเงื่อนไข รองรับโดยการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ต้องใช้ ConditionValue รายการเดียวสำหรับการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรองในออบเจ็กต์ที่ไม่ใช่แหล่งข้อมูล และมี ConditionValue อย่างน้อย 1 รายการสำหรับตัวกรองในออบเจ็กต์แหล่งข้อมูล
TEXT_IS_EMAIL ค่าของเซลล์ต้องเป็นอีเมลที่ถูกต้อง รองรับโดยการตรวจสอบข้อมูล ไม่จำเป็นต้องมี ConditionValues
TEXT_IS_URL ค่าของเซลล์ต้องเป็น URL ที่ถูกต้อง รองรับโดยการตรวจสอบข้อมูล ไม่จำเป็นต้องมี ConditionValues
DATE_EQ ค่าของเซลล์ต้องเป็นวันที่เดียวกับค่าของเงื่อนไข รองรับโดยการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ต้องใช้ ConditionValue รายการเดียวสำหรับการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรองในออบเจ็กต์ที่ไม่ใช่แหล่งข้อมูล และมี ConditionValue อย่างน้อย 1 รายการสำหรับตัวกรองในออบเจ็กต์แหล่งข้อมูล
DATE_BEFORE ค่าของเซลล์ต้องอยู่ก่อนวันที่ค่าของเงื่อนไข รองรับโดยการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ต้องใช้ ConditionValue รายการเดียวซึ่งอาจเป็น relative date
DATE_AFTER ค่าของเซลล์ต้องอยู่หลังจากวันที่ค่าของเงื่อนไข รองรับโดยการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ต้องใช้ ConditionValue รายการเดียวซึ่งอาจเป็น relative date
DATE_ON_OR_BEFORE ค่าของเซลล์ต้องเป็นวันที่หรือก่อนวันที่ค่าของเงื่อนไข รองรับโดยการตรวจสอบข้อมูล ต้องใช้ ConditionValue รายการเดียวซึ่งอาจเป็น relative date
DATE_ON_OR_AFTER ค่าของเซลล์ต้องเป็นวันที่เดียวกับหรือหลังวันที่ในค่าของเงื่อนไข รองรับโดยการตรวจสอบข้อมูล ต้องใช้ ConditionValue รายการเดียวซึ่งอาจเป็น relative date
DATE_BETWEEN ค่าของเซลล์ต้องอยู่ระหว่างวันที่ของค่าเงื่อนไข 2 รายการ รองรับโดยการตรวจสอบข้อมูล ต้องใช้ ConditionValues 2 รายการเท่านั้น
DATE_NOT_BETWEEN ค่าของเซลล์ต้องอยู่นอกวันที่ของค่าเงื่อนไข 2 รายการ รองรับโดยการตรวจสอบข้อมูล ต้องใช้ ConditionValues 2 รายการเท่านั้น
DATE_IS_VALID ค่าของเซลล์ต้องเป็นวันที่ รองรับโดยการตรวจสอบข้อมูล ไม่จำเป็นต้องมี ConditionValues
ONE_OF_RANGE ค่าของเซลล์ต้องแสดงอยู่ในตารางกริดในช่วงของค่าเงื่อนไข รองรับโดยการตรวจสอบข้อมูล ต้องใช้ ConditionValue ค่าเดียวและค่าต้องเป็นช่วงที่ถูกต้องในรูปแบบ A1
ONE_OF_LIST ค่าของเซลล์ต้องอยู่ในรายการค่าของเงื่อนไข รองรับโดยการตรวจสอบข้อมูล รองรับ condition values กี่รายการก็ได้ 1 รายการต่อรายการ ระบบไม่รองรับสูตรในค่า
BLANK ค่าของเซลล์ต้องว่างเปล่า รองรับโดยการจัดรูปแบบตามเงื่อนไขและตัวกรอง ไม่จำเป็นต้องมี ConditionValues
NOT_BLANK ค่าของเซลล์ต้องไม่ว่างเปล่า รองรับโดยการจัดรูปแบบตามเงื่อนไขและตัวกรอง ไม่จำเป็นต้องมี ConditionValues
CUSTOM_FORMULA สูตรของเงื่อนไขต้องประเมินเป็นจริง รองรับโดยการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ตัวกรองชีตแหล่งข้อมูลไม่รองรับ ต้องใช้ ConditionValue รายการเดียว
BOOLEAN ค่าของเซลล์ต้องเป็น TRUE/FALSE หรือในรายการค่าของเงื่อนไข รองรับโดยการตรวจสอบข้อมูล แสดงผลเป็นช่องทำเครื่องหมายเซลล์ รองรับ ConditionValues เป็น 0, 1 หรือ 2 ไม่มีค่าที่ระบุว่าเซลล์ต้องเป็น TRUE หรือ FALSE โดยที่ TRUE จะแสดงผลเป็นรายการที่เลือก และ FALSE จะแสดงผลเป็นไม่เลือก ค่า 1 ค่าบ่งชี้ว่าเซลล์จะแสดงผลเป็น "เลือกไว้" เมื่อมีค่าดังกล่าว และจะยกเลิกการเลือกเมื่อเป็นค่าว่าง ค่า 2 ค่าบ่งชี้ว่าเซลล์จะแสดงผลเป็น "เลือกแล้ว" เมื่อมีค่าแรกและไม่ได้เลือกไว้เมื่อมีค่าที่ 2 เช่น ["Yes","No"] บ่งชี้ว่าเซลล์จะแสดงช่องที่ทำเครื่องหมายเมื่อมีค่าเป็น "Yes" และเลือกช่องที่ไม่ได้ทำเครื่องหมายเมื่อมีค่าเป็น "No"
TEXT_NOT_EQ ค่าของเซลล์ต้องไม่ใช่ค่าของเงื่อนไข รองรับโดยตัวกรองในออบเจ็กต์แหล่งข้อมูล ต้องมี ConditionValue อย่างน้อย 1 รายการ
DATE_NOT_EQ ค่าของเซลล์ต้องไม่ใช่ค่าของเงื่อนไข รองรับโดยตัวกรองในออบเจ็กต์แหล่งข้อมูล ต้องมี ConditionValue อย่างน้อย 1 รายการ
FILTER_EXPRESSION ค่าของเซลล์ต้องเป็นไปตามรูปแบบที่ระบุ ต้องใช้ ConditionValue รายการเดียว

ConditionValue

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

การแสดง JSON 
{

  // Union field value 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 ตำแหน่งของออบเจ็กต์ ต้องตั้งค่าเพียงค่าเดียว 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

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