Other

สี

แสดงสีในพื้นที่สี RGBA การนำเสนอนี้ออกแบบมาให้ง่ายต่อการแปลงเป็นและจากการแสดงสีในภาษาต่างๆ ที่กระชับได้ใจความ ตัวอย่างเช่น ฟิลด์ของการแสดงนี้สามารถใส่เพียงเล็กน้อยให้กับเครื่องมือสร้างของ java.awt.Color ใน Java ก็ยังอาจใส่เล็กน้อยให้กับ UIColor วันที่ +colorWithRed:green:blue:alpha ใน 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.
}
ช่อง
ฟิลด์ Union 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.
}
ช่อง
ฟิลด์ 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

เงื่อนไขที่ประเมินค่าได้เป็นจริงหรือเท็จ ระบบใช้ 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 สำหรับตัวกรองในออบเจ็กต์แหล่งข้อมูล
NUMBER_NOT_EQ ค่าของเซลล์ต้องไม่เท่ากับค่าของเงื่อนไข รองรับโดยการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ต้องใช้รายการเดียว ConditionValue สำหรับการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรองในออบเจ็กต์ที่ไม่ใช่แหล่งข้อมูล และ วันที่ ConditionValue สำหรับตัวกรองในออบเจ็กต์แหล่งข้อมูล
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 สำหรับตัวกรองในออบเจ็กต์แหล่งข้อมูล
TEXT_IS_EMAIL ค่าของเซลล์ต้องเป็นอีเมลที่ถูกต้อง รองรับโดยการตรวจสอบข้อมูล ไม่จำเป็นต้องระบุ ConditionValues
TEXT_IS_URL ค่าของเซลล์ต้องเป็น URL ที่ถูกต้อง รองรับโดยการตรวจสอบข้อมูล ไม่จำเป็นต้องระบุ ConditionValues
DATE_EQ ค่าของเซลล์ต้องเป็นวันที่เดียวกับค่าของเงื่อนไข รองรับโดยการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรอง ต้องใช้รายการเดียว ConditionValue สำหรับการตรวจสอบข้อมูล การจัดรูปแบบตามเงื่อนไข และตัวกรองในออบเจ็กต์ที่ไม่ใช่แหล่งข้อมูล และ วันที่ ConditionValue สำหรับตัวกรองในออบเจ็กต์แหล่งข้อมูล
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 ครั้งต่อรายการ ค่าไม่รองรับสูตร
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 ค่าของเซลล์ต้องไม่เท่ากับค่าของเงื่อนไข ตัวกรองในออบเจ็กต์แหล่งข้อมูลรองรับ ต้องมีอย่างน้อย 1 รูป ConditionValue
DATE_NOT_EQ ค่าของเซลล์ต้องไม่เท่ากับค่าของเงื่อนไข ตัวกรองในออบเจ็กต์แหล่งข้อมูลรองรับ ต้องมีอย่างน้อย 1 รูป ConditionValue
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

ช่วงในชีต ดัชนีทั้งหมดอิงตามศูนย์ ดัชนีเปิดครึ่งเดียว นั่นคือดัชนีเริ่มต้นรวม และดัชนีสิ้นสุดเป็นแบบไม่เฉพาะเจาะจง -- [startIndex, endIndex) ไม่มีดัชนีหมายความว่าช่วงนั้นไม่มีขอบเขตที่ด้านนั้น

ตัวอย่างเช่น หาก "Sheet1" คือ 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 จัดเรียงจากมากไปหาน้อย (Z ถึง A)

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

ดัชนีคอลัมน์ฐาน 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 จะได้รับการตั้งค่าด้วย ฟิลด์นี้จะมีความสำคัญเหนือกว่า

ฟิลด์ 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

พิกัดในชีต ดัชนีทั้งหมดอิงตามศูนย์

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

integer

แผ่นงานที่พิกัดนี้เปิดอยู่

rowIndex

integer

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

columnIndex

integer

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