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)

ลักษณะสี

ค่าสี

การแสดง 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)

สีธีม

ประเภทสี

ประเภทสีธีม

SpreadsheetProperties มี SpreadsheetTheme ที่กําหนดการแมปประเภทสีเหล่านี้ไปยังสีคอนกรีต

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

จัดข้อความแนวนอน

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

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

รูปแบบข้อความ

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

การแสดง 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

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

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

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

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

object (DataSourceColumnReference)

การอ้างอิงคอลัมน์

formula

string

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

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

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

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

string

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

สถานะการดําเนินการข้อมูล

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

สร้างการดําเนินการกับข้อมูลเพื่อซิงค์ออบเจ็กต์แหล่งข้อมูลกับข้อมูลล่าสุดจาก 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)

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

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

การแจกแจงสถานะการประมวลผลข้อมูล

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 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

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

stringValue

string

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

boolValue

boolean

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

formulaValue

string

แสดงสูตร

errorValue

object (ErrorValue)

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

ค่าข้อผิดพลาด

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

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

enum (ErrorType)

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

message

string

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

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

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

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

enum (ConditionType)

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

values[]

object (ConditionValue)

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

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

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

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 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 ต้องกําหนดค่าของเงื่อนไข value ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
relativeDate

enum (RelativeDate)

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

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

userEnteredValue

string

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

วันที่สัมพัทธ์

ควบคุมวิธีประเมินเงื่อนไขวันที่

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

integer

ชีตของช่วงนี้เปิดอยู่

startRowIndex

integer

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

endRowIndex

integer

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

startColumnIndex

integer

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

endColumnIndex

integer

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

SortOrder

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

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

ข้อมูลจําเพาะของตัวกรอง

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

การแสดง 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

ดัชนีคอลัมน์

dataSourceColumnReference

object (DataSourceColumnReference)

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

เกณฑ์ตัวกรอง

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

การแสดง 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 ด้วย ช่องนี้จะมีความสําคัญเหนือกว่า

จัดเรียงสเปค

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

การแสดง 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)

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

ตําแหน่งของออบเจ็กต์แบบฝัง

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

การแสดง 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

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

ตําแหน่งโฆษณาซ้อนทับ

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

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

object (GridCoordinate)

เซลล์ที่ยึดวัตถุกับเซลล์

offsetXPixels

integer

ออฟเซ็ตแนวนอนในหน่วยพิกเซลซึ่งออบเจ็กต์ออฟเซ็ตจากเซลล์จุดยึด

offsetYPixels

integer

ออฟเซ็ตแนวตั้งเป็นพิกเซลที่ออบเจ็กต์ออฟเซ็ตจากเซลล์ Anchor

widthPixels

integer

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

heightPixels

integer

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

แผนที่ประสานงาน

พิกัดในแผ่นงาน ดัชนีทั้งหมดเป็นแบบศูนย์

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

integer

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

rowIndex

integer

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

columnIndex

integer

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