Other

Renk

RGBA renk alanındaki bir rengi temsil eder. Bu gösterim, çeşitli dillerdeki renk gösterimlerine dönüştürme ve bu gösterimlerden dönüştürme işlemlerinin kolaylığı için tasarlanmıştır. Örneğin, bu gösterimin alanları Java'da java.awt.Color oluşturucusuna, iOS'te UIColor'ın +colorWithRed:green:blue:alpha yöntemine kolayca sağlanabilir ve biraz çalışmayla JavaScript'te CSS rgba() dizesi olarak kolayca biçimlendirilebilir.

Bu referans sayfasında, RGB değerini yorumlamak için kullanılması gereken mutlak renk alanı (ör. sRGB, Adobe RGB, DCI-P3 ve BT.2020) hakkında bilgi verilmemektedir. Uygulamalar varsayılan olarak sRGB renk alanını kullanmalıdır.

Renk eşitliğine karar verilmesi gerektiğinde, aksi belgelenmediği sürece uygulamalar, kırmızı, yeşil, mavi ve alfa değerlerinin her biri en fazla 1e-5 farklıysa iki rengi eşit olarak kabul eder.

Örnek (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();
 }
 // ...

Örnek (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;
}
// ...

Örnek (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 gösterimi
{
  "red": number,
  "green": number,
  "blue": number,
  "alpha": number
}
Alanlar
red

number

Renk içindeki kırmızı miktarının [0, 1] aralığındaki değeri.

green

number

Rengin yeşil bileşeninin [0, 1] aralığındaki değeri.

blue

number

Rengin mavi miktarının [0, 1] aralığındaki değeri.

alpha

number

Piksele uygulanması gereken bu rengin oranı. Yani, nihai piksel rengi şu denklemle tanımlanır:

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

Bu nedenle, 1.0 değeri düz bir renge, 0.0 değeri ise tamamen şeffaf bir renge karşılık gelir. Bu, varsayılan değer ile ayarlanmamış değer arasında ayrım yapabilmek için basit bir kayan nokta skaler yerine sarmalayıcı mesaj kullanır. Atlanırsa bu renk nesnesi düz renk olarak oluşturulur (alfa değerine açıkça 1, 0 değeri verilmiş gibi).

ColorStyle

Renk değeri.

JSON gösterimi
{

  // 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.
}
Alanlar
Birleşik alan kind. Renk değerinin türü. kind aşağıdakilerden yalnızca biri olabilir:
rgbColor

object (Color)

RGB rengi. alpha değeri Color nesnesinde genellikle desteklenmez.

themeColor

enum (ThemeColorType)

Tema rengi.

ThemeColorType

Tema rengi türleri.

SpreadsheetProperties Bu tema rengi türlerinin somut renklere eşlemesini tanımlayan bir SpreadsheetTheme içerir.

Sıralamalar
THEME_COLOR_TYPE_UNSPECIFIED Belirtilmeyen tema rengi
TEXT Birincil metin rengini gösterir.
BACKGROUND Birincil arka plan rengini gösterir.
ACCENT1 Birinci vurgu rengini gösterir.
ACCENT2 İkinci vurgu rengini gösterir.
ACCENT3 Üçüncü vurgu rengini gösterir.
ACCENT4 Dördüncü vurgu rengini gösterir.
ACCENT5 Beşinci vurgu rengini gösterir.
ACCENT6 Altıncı vurgu rengini gösterir.

HorizontalAlign

Hücredeki metnin yatay hizalaması.

Sıralamalar
HORIZONTAL_ALIGN_UNSPECIFIED Yatay hizalama belirtilmemiş. Bunu kullanmayın.
LEFT Metin, hücrenin soluna açıkça hizalanır.
CENTER Metin açıkça hücrenin ortasına hizalanır.
RIGHT Metin, hücrenin sağına açıkça hizalanır.

TextFormat

Hücredeki bir metin parçasının biçimi. Olmayan değerler, alanın belirtilmediğini gösterir.

JSON gösterimi
{
  "foregroundColor": {
    object (Color)
  },
  "foregroundColorStyle": {
    object (ColorStyle)
  },
  "fontFamily": string,
  "fontSize": integer,
  "bold": boolean,
  "italic": boolean,
  "strikethrough": boolean,
  "underline": boolean,
  "link": {
    object (Link)
  }
}
Alanlar
foregroundColor
(deprecated)

object (Color)

Metnin ön plan rengi. Desteği sonlandırıldı: foregroundColorStyle kullanın.

foregroundColorStyle

object (ColorStyle)

Metnin ön plan rengi. foregroundColor da ayarlanmışsa bu alan öncelikli olur.

fontFamily

string

Yazı tipi ailesi.

fontSize

integer

Yazı tipinin boyutu.

bold

boolean

Metin kalınsa doğru değerini döndürür.

italic

boolean

Metin italikse doğru değerini döndürür.

strikethrough

boolean

Metin üstü çiziliyse doğru değerini döndürür.

underline

boolean

Metnin altı çiziliyse doğru değerini döndürür.

DataSourceColumn

Veri kaynağındaki bir sütun.

JSON gösterimi
{
  "reference": {
    object (DataSourceColumnReference)
  },
  "formula": string
}
Alanlar
reference

object (DataSourceColumnReference)

Sütun referansı.

formula

string

Hesaplanmış sütunun formülü.

DataSourceColumnReference

Bir veri kaynağı sütununa referans veren benzersiz tanımlayıcı.

JSON gösterimi
{
  "name": string
}
Alanlar
name

string

Sütunun görünen adı. Veri kaynağı içinde benzersiz olmalıdır.

DataExecutionStatus

Veri yürütme durumu.

Bir veri kaynağı nesnesini DataSource'daki en son verilerle senkronize etmek için veri yürütme işlemi oluşturulur. Genellikle arka planda çalışacak şekilde planlanır. Bir yürütmenin tamamlanıp tamamlanmadığını anlamak için state kontrol edebilirsiniz.

Bir veri yürütme işleminin çalıştırılmasını tetikleyen çeşitli senaryolar vardır:

  • Adding a data source Veri kaynağındaki verileri sayfayla senkronize etmek için ilişkili bir veri kaynağı sayfası ve veri yürütme oluşturur.
  • Updating a data source ilişkili veri kaynağı sayfasını benzer şekilde yenilemek için bir veri yürütme işlemi oluşturur.
  • Bir veya daha fazla veri kaynağı nesnesini açıkça yenilemek için refresh request gönderebilirsiniz.
JSON gösterimi
{
  "state": enum (DataExecutionState),
  "errorCode": enum (DataExecutionErrorCode),
  "errorMessage": string,
  "lastRefreshTime": string
}
Alanlar
state

enum (DataExecutionState)

Veri yürütmenin durumu.

errorCode

enum (DataExecutionErrorCode)

Hata kodu.

errorMessage

string

Hata mesajı (boş olabilir).

lastRefreshTime

string (Timestamp format)

Verilerin en son başarılı şekilde yenilendiği zamanı alır.

DataExecutionState

Veri yürütme durumlarının numaralandırılması.

Sıralamalar
DATA_EXECUTION_STATE_UNSPECIFIED Varsayılan değer, kullanmayın.
NOT_STARTED Veri yürütme işlemi başlatılmamıştır.
RUNNING Veri yürütme işlemi başlatıldı ve çalışıyor.
CANCELLING Veri yürütme işlemi şu anda iptal ediliyor.
SUCCEEDED Veri yürütme işlemi başarıyla tamamlandı.
FAILED Veri yürütme işlemi hatalarla tamamlandı.

DataExecutionErrorCode

Veri yürütme hatası kodunun numaralandırılması.

Sıralamalar
DATA_EXECUTION_ERROR_CODE_UNSPECIFIED Varsayılan değer, kullanmayın.
TIMED_OUT Veri yürütme işlemi zaman aşımına uğradı.
TOO_MANY_ROWS Veri yürütme işlemi, sınırdan daha fazla satır döndürüyor.
TOO_MANY_COLUMNS Veri yürütme işlemi, sınırdan daha fazla sütun döndürüyor.
TOO_MANY_CELLS Veri yürütme işlemi, sınırdan daha fazla hücre döndürüyor.
ENGINE Arka uç veri yürütme motorundan (ör. BigQuery) hata alınır. Ayrıntılar için errorMessage adresini ziyaret edin.
PARAMETER_INVALID Sağlanan veri kaynağı parametrelerinden biri veya birkaçı geçersiz.
UNSUPPORTED_DATA_TYPE Veri yürütme işlemi, desteklenmeyen bir veri türü döndürüyor.
DUPLICATE_COLUMN_NAMES Veri yürütme işlemi, mükerrer sütun adları veya takma adlar döndürüyor.
INTERRUPTED Veri yürütme işlemi kesintiye uğradı. Lütfen daha sonra yenileyin.
CONCURRENT_QUERY Veri yürütme işlemi şu anda devam ediyor. İşlem tamamlanana kadar yenilenemez.
OTHER Diğer hatalar.
TOO_MANY_CHARS_PER_CELL Veri yürütme işlemi, tek bir hücrede izin verilen maksimum karakter sayısını aşan değerler döndürüyor.
DATA_NOT_FOUND Veri kaynağının referans verdiği veritabanı bulunamadı. */
PERMISSION_DENIED Kullanıcının, veri kaynağının referans verdiği veritabanına erişimi yok.
MISSING_COLUMN_ALIAS Veri yürütme işlemi, takma adları eksik sütunlar döndürüyor.
OBJECT_NOT_FOUND Veri kaynağı nesnesi mevcut değil.
OBJECT_IN_ERROR_STATE Veri kaynağı nesnesi şu anda hata durumunda. Yenilemeyi zorlamak için force in RefreshDataSourceRequest değerini ayarlayın.
OBJECT_SPEC_INVALID Veri kaynağı nesnesi spesifikasyonu geçersiz.
DATA_EXECUTION_CANCELLED Veri yürütme işlemi iptal edildi.

ExtendedValue

Bir e-tablodaki hücrenin sahip olabileceği değer türleri.

JSON gösterimi
{

  // 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.
}
Alanlar
Birleşik alan value. Bir hücredeki değerin türü. Hiçbir alan ayarlanmamışsa hücrede veri yoktur. value aşağıdakilerden yalnızca biri olabilir:
numberValue

number

Çift değeri temsil eder. Not: Tarihler, saatler ve tarih saatleri SERIAL_NUMBER biçiminde çift olarak gösterilir.

stringValue

string

Bir dize değerini temsil eder. Baştaki tek tırnak işaretleri dahil edilmez. Örneğin, kullanıcı arayüze '123 yazarsa bu, stringValue "123" olarak gösterilir.

boolValue

boolean

Boole değerini gösterir.

formulaValue

string

Formülü temsil eder.

errorValue

object (ErrorValue)

Bir hatayı gösterir. Bu alan salt okunurdur.

ErrorValue

Bir hücrede hata var.

JSON gösterimi
{
  "type": enum (ErrorType),
  "message": string
}
Alanlar
type

enum (ErrorType)

Hatanın türü.

message

string

Hatayla ilgili daha fazla bilgi içeren bir mesaj (tablonun yerel ayarında).

ErrorType

Hatanın türü.

Sıralamalar
ERROR_TYPE_UNSPECIFIED Varsayılan hata türü. Bunu kullanmayın.
ERROR #ERROR! hatasına karşılık gelir.
NULL_VALUE #NULL! hatasına karşılık gelir.
DIVIDE_BY_ZERO #DIV/0 hatasına karşılık gelir.
VALUE #VALUE! hatasına karşılık gelir.
REF #REF! hatasına karşılık gelir.
NAME #NAME? hatasına karşılık gelir.
NUM #NUM! hatasına karşılık gelir.
N_A #N/A hatasına karşılık gelir.
LOADING Loading... durumuna karşılık gelir.

BooleanCondition

Doğru veya yanlış olarak değerlendirilebilen bir koşul. BooleanConditions, koşullu biçimlendirme, veri doğrulama ve filtrelerdeki ölçütler tarafından kullanılır.

JSON gösterimi
{
  "type": enum (ConditionType),
  "values": [
    {
      object (ConditionValue)
    }
  ]
}
Alanlar
type

enum (ConditionType)

Koşulun türü.

values[]

object (ConditionValue)

Koşulun değerleri. Desteklenen değerlerin sayısı condition type bağlıdır. Bazıları sıfır değeri, bazıları bir veya iki değeri, ConditionType.ONE_OF_LIST ise rastgele sayıda değeri destekler.

ConditionType

Koşulun türü.

Sıralamalar
CONDITION_TYPE_UNSPECIFIED Varsayılan değerdir, kullanılmaz.
NUMBER_GREATER Hücrenin değeri, koşulun değerinden büyük olmalıdır. Veri doğrulama, koşullu biçimlendirme ve filtreler tarafından desteklenir. Tek bir ConditionValue gerektirir.
NUMBER_GREATER_THAN_EQ Hücrenin değeri, koşulun değerinden büyük veya bu değere eşit olmalıdır. Veri doğrulama, koşullu biçimlendirme ve filtreler tarafından desteklenir. Tek bir ConditionValue gerektirir.
NUMBER_LESS Hücrenin değeri, koşulun değerinden küçük olmalıdır. Veri doğrulama, koşullu biçimlendirme ve filtreler tarafından desteklenir. Tek bir ConditionValue gerektirir.
NUMBER_LESS_THAN_EQ Hücrenin değeri, koşulun değerinden küçük veya bu değere eşit olmalıdır. Veri doğrulama, koşullu biçimlendirme ve filtreler tarafından desteklenir. Tek bir ConditionValue gerektirir.
NUMBER_EQ Hücrenin değeri, koşulun değerine eşit olmalıdır. Veri doğrulama, koşullu biçimlendirme ve filtreler tarafından desteklenir. Veri kaynağı olmayan nesnelerde veri doğrulama, koşullu biçimlendirme ve filtreler için tek bir ConditionValue, veri kaynağı nesnelerinde filtreler için ise en az bir ConditionValue gerekir.
NUMBER_NOT_EQ Hücrenin değeri, koşulun değerine eşit olmamalıdır. Veri doğrulama, koşullu biçimlendirme ve filtreler tarafından desteklenir. Veri kaynağı olmayan nesnelerde veri doğrulama, koşullu biçimlendirme ve filtreler için tek bir ConditionValue, veri kaynağı nesnelerinde filtreler için ise en az bir ConditionValue gerekir.
NUMBER_BETWEEN Hücrenin değeri, iki koşul değeri arasında olmalıdır. Veri doğrulama, koşullu biçimlendirme ve filtreler tarafından desteklenir. Tam olarak iki ConditionValues gerektirir.
NUMBER_NOT_BETWEEN Hücrenin değeri, iki koşul değeri arasında olmamalıdır. Veri doğrulama, koşullu biçimlendirme ve filtreler tarafından desteklenir. Tam olarak iki ConditionValues gerektirir.
TEXT_CONTAINS Hücrenin değeri, koşulun değerini içermelidir. Veri doğrulama, koşullu biçimlendirme ve filtreler tarafından desteklenir. Tek bir ConditionValue gerektirir.
TEXT_NOT_CONTAINS Hücrenin değeri, koşulun değerini içermemelidir. Veri doğrulama, koşullu biçimlendirme ve filtreler tarafından desteklenir. Tek bir ConditionValue gerektirir.
TEXT_STARTS_WITH Hücrenin değeri, koşulun değeriyle başlamalıdır. Koşullu biçimlendirme ve filtreler tarafından desteklenir. Tek bir ConditionValue gerektirir.
TEXT_ENDS_WITH Hücrenin değeri, koşulun değeriyle bitmelidir. Koşullu biçimlendirme ve filtreler tarafından desteklenir. Tek bir ConditionValue gerektirir.
TEXT_EQ Hücrenin değeri, koşulun değeriyle tam olarak aynı olmalıdır. Veri doğrulama, koşullu biçimlendirme ve filtreler tarafından desteklenir. Veri kaynağı olmayan nesnelerde veri doğrulama, koşullu biçimlendirme ve filtreler için tek bir ConditionValue, veri kaynağı nesnelerinde filtreler için ise en az bir ConditionValue gerekir.
TEXT_IS_EMAIL Hücrenin değeri geçerli bir e-posta adresi olmalıdır. Veri doğrulamasıyla desteklenir. ConditionValues gerektirmez.
TEXT_IS_URL Hücrenin değeri geçerli bir URL olmalıdır. Veri doğrulamasıyla desteklenir. ConditionValues gerektirmez.
DATE_EQ Hücrenin değeri, koşulun değeriyle aynı tarih olmalıdır. Veri doğrulama, koşullu biçimlendirme ve filtreler tarafından desteklenir. Veri kaynağı olmayan nesnelerde veri doğrulama, koşullu biçimlendirme ve filtreler için tek bir ConditionValue, veri kaynağı nesnelerinde filtreler için ise en az bir ConditionValue gerekir.
DATE_BEFORE Hücrenin değeri, koşulun değerinin tarihinden önce olmalıdır. Veri doğrulama, koşullu biçimlendirme ve filtreler tarafından desteklenir. relative date olabilecek tek bir ConditionValue gerekir.
DATE_AFTER Hücrenin değeri, koşulun değerinin tarihinden sonra olmalıdır. Veri doğrulama, koşullu biçimlendirme ve filtreler tarafından desteklenir. relative date olabilecek tek bir ConditionValue gerekir.
DATE_ON_OR_BEFORE Hücrenin değeri, koşulun değerinin tarihinde veya bu tarihten önce olmalıdır. Veri doğrulamasıyla desteklenir. relative date olabilecek tek bir ConditionValue gerekir.
DATE_ON_OR_AFTER Hücrenin değeri, koşulun değerinin tarihine eşit veya bu tarihten sonraki bir tarih olmalıdır. Veri doğrulamasıyla desteklenir. relative date olabilecek tek bir ConditionValue gerekir.
DATE_BETWEEN Hücrenin değeri, iki koşul değerinin tarihleri arasında olmalıdır. Veri doğrulamasıyla desteklenir. Tam olarak iki ConditionValues gerektirir.
DATE_NOT_BETWEEN Hücrenin değeri, iki koşul değerinin tarihleri dışında olmalıdır. Veri doğrulamasıyla desteklenir. Tam olarak iki ConditionValues gerektirir.
DATE_IS_VALID Hücrenin değeri bir tarih olmalıdır. Veri doğrulamasıyla desteklenir. ConditionValues gerektirmez.
ONE_OF_RANGE Hücrenin değeri, koşul değerinin aralığındaki ızgarada listelenmelidir. Veri doğrulamasıyla desteklenir. Tek bir ConditionValue gerektirir ve değer, A1 gösteriminde geçerli bir aralık olmalıdır.
ONE_OF_LIST Hücrenin değeri, koşul değerleri listesinde olmalıdır. Veri doğrulamasıyla desteklenir. Listedeki öğe başına bir tane olmak üzere herhangi bir sayıda condition values değerini destekler. Değerlerde formüller desteklenmez.
BLANK Hücrenin değeri boş olmalıdır. Koşullu biçimlendirme ve filtreler tarafından desteklenir. ConditionValues gerektirmez.
NOT_BLANK Hücrenin değeri boş olmamalıdır. Koşullu biçimlendirme ve filtreler tarafından desteklenir. ConditionValues gerektirmez.
CUSTOM_FORMULA Koşulun formülü doğru olarak değerlendirilmelidir. Veri doğrulama, koşullu biçimlendirme ve filtreler tarafından desteklenir. Veri kaynağı sayfası filtreleri tarafından desteklenmez. Tek bir ConditionValue gerektirir.
BOOLEAN Hücrenin değeri DOĞRU/YANLIŞ olmalı veya koşul değerleri listesinde yer almalıdır. Veri doğrulamasıyla desteklenir. Hücre onay kutusu olarak oluşturulur. Sıfır, bir veya iki ConditionValues karakterini destekler. Değer yoksa hücre DOĞRU veya YANLIŞ olmalıdır. DOĞRU, işaretli olarak, YANLIŞ ise işaretsiz olarak oluşturulur. Bir değer, hücre bu değeri içerdiğinde işaretli, boş olduğunda ise işaretsiz olarak oluşturulacağını gösterir. İki değer, hücre ilk değeri içerdiğinde işaretli, ikinci değeri içerdiğinde ise işaretsiz olarak oluşturulacağını gösterir. Örneğin, ["Evet","Hayır"] değeri, hücrenin "Evet" değerine sahip olduğunda işaretli bir kutu, "Hayır" değerine sahip olduğunda ise işaretsiz bir kutu oluşturacağını gösterir.
TEXT_NOT_EQ Hücrenin değeri, koşulun değerinden farklı olmalıdır. Veri kaynağı nesnelerindeki filtreler tarafından desteklenir. En az bir ConditionValue gerektirir.
DATE_NOT_EQ Hücrenin değeri, koşulun değerinden farklı olmalıdır. Veri kaynağı nesnelerindeki filtreler tarafından desteklenir. En az bir ConditionValue gerektirir.
FILTER_EXPRESSION Hücrenin değeri, belirtilen kalıba uygun olmalıdır. Tek bir ConditionValue gerektirir.

ConditionValue

Koşulun değeri.

JSON gösterimi
{

  // 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.
}
Alanlar
Birleşik alan value. Koşulun değeri. Tam olarak bir değer ayarlanmalıdır. value aşağıdakilerden yalnızca biri olabilir:
relativeDate

enum (RelativeDate)

Geçerli tarihe göre belirlenen göreli bir tarih. Yalnızca type DATE_BEFORE, DATE_AFTER, DATE_ON_OR_BEFORE veya DATE_ON_OR_AFTER ise geçerlidir.

Bağıl tarihler, veri doğrulama işleminde desteklenmez. Yalnızca koşullu biçimlendirme ve koşullu filtrelerde desteklenir.

userEnteredValue

string

Koşulun temel alındığı değer. Değer, kullanıcı bir hücreye yazmış gibi ayrıştırılır. Formüller desteklenir (ve = veya "+" ile başlamalıdır).

RelativeDate

Tarih koşulunun nasıl değerlendirileceğini kontrol eder.

Sıralamalar
RELATIVE_DATE_UNSPECIFIED Varsayılan değer, kullanmayın.
PAST_YEAR Değer, bugünden bir yıl öncesidir.
PAST_MONTH Değer, bugünden bir ay öncesidir.
PAST_WEEK Değer, bugünden bir hafta öncesidir.
YESTERDAY Değer, dünün değeridir.
TODAY Değer bugündür.
TOMORROW Değer yarın olmalıdır.

GridRange

Bir sayfadaki aralık. Tüm dizinler sıfır tabanlıdır. Dizinler yarı açıktır. Yani başlangıç dizini dahil, bitiş dizini hariçtir ([startIndex, endIndex)). Eksik dizinler, aralığın o tarafta sınırsız olduğunu gösterir.

Örneğin, "Sheet1" 123456 numaralı e-tablo ise:

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

Başlangıç dizini her zaman bitiş dizininden küçük veya ona eşit olmalıdır. Başlangıç dizini bitiş dizinine eşitse aralık boştur. Boş aralıklar genellikle anlamlı değildir ve kullanıcı arayüzünde #REF! olarak oluşturulur.

JSON gösterimi
{
  "sheetId": integer,
  "startRowIndex": integer,
  "endRowIndex": integer,
  "startColumnIndex": integer,
  "endColumnIndex": integer
}
Alanlar
sheetId

integer

Bu aralığın bulunduğu sayfa.

startRowIndex

integer

Aralığın başlangıç satırı (dahil) veya sınırsızsa ayarlanmamış.

endRowIndex

integer

Aralığın son satırı (hariç) veya sınırsızsa ayarlanmamış.

startColumnIndex

integer

Aralığın başlangıç sütunu (dahil) veya sınırsızsa ayarlanmamış.

endColumnIndex

integer

Aralığın son sütunu (hariç) veya sınırsızsa ayarlanmamış.

SortOrder

Sıralama düzeni.

Sıralamalar
SORT_ORDER_UNSPECIFIED Varsayılan değerdir, kullanmayın.
ASCENDING Artan düzende sıralayın.
DESCENDING Azalan düzende sıralayın.

FilterSpec

Belirli bir sütunla ilişkili filtre ölçütleri.

JSON gösterimi
{
  "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.
}
Alanlar
filterCriteria

object (FilterCriteria)

Sütunun ölçütleri.

Birleşik alan reference. Filtrelenen sütuna referans. reference aşağıdakilerden yalnızca biri olabilir:
columnIndex

integer

Sıfır tabanlı sütun dizini.

dataSourceColumnReference

object (DataSourceColumnReference)

Veri kaynağı sütununa referans.

FilterCriteria

Filtre veya filtre görünümünde satırları gösterme ya da gizleme ölçütleri.

JSON gösterimi
{
  "hiddenValues": [
    string
  ],
  "condition": {
    object (BooleanCondition)
  },
  "visibleBackgroundColor": {
    object (Color)
  },
  "visibleBackgroundColorStyle": {
    object (ColorStyle)
  },
  "visibleForegroundColor": {
    object (Color)
  },
  "visibleForegroundColorStyle": {
    object (ColorStyle)
  }
}
Alanlar
hiddenValues[]

string

Gizlenmesi gereken değerler.

condition

object (BooleanCondition)

Değerlerin gösterilmesi için true olması gereken bir koşul. (Bu, hiddenValues'ı geçersiz kılmaz. hiddenValues Bir değer orada listeleniyorsa gizlenmeye devam eder.)

visibleBackgroundColor
(deprecated)

object (Color)

Filtreleme için kullanılacak arka plan dolgu rengi. Yalnızca bu dolgu rengine sahip hücreler gösterilir. visibleForegroundColor ile karşılıklı olarak hariç tutulur. Desteği sonlandırıldı: visibleBackgroundColorStyle kullanın.

visibleBackgroundColorStyle

object (ColorStyle)

Filtreleme için kullanılacak arka plan dolgu rengi. Yalnızca bu dolgu rengine sahip hücreler gösterilir. Bu alan, visibleForegroundColor ile karşılıklı olarak birbirini dışlar ve RGB türünde bir renge ayarlanmalıdır. visibleBackgroundColor da ayarlanmışsa bu alan öncelikli olur.

visibleForegroundColor
(deprecated)

object (Color)

Filtreleme için kullanılacak ön plan rengi. Yalnızca bu ön plan rengine sahip hücreler gösterilir. visibleBackgroundColor ile karşılıklı olarak hariç tutulur. Desteği sonlandırıldı: visibleForegroundColorStyle kullanın.

visibleForegroundColorStyle

object (ColorStyle)

Filtreleme için kullanılacak ön plan rengi. Yalnızca bu ön plan rengine sahip hücreler gösterilir. Bu alan, visibleBackgroundColor ile karşılıklı olarak birbirini dışlar ve RGB türünde bir renge ayarlanmalıdır. visibleForegroundColor da ayarlanmışsa bu alan öncelikli olur.

SortSpec

Belirli bir sütun veya satırla ilişkili sıralama düzeni.

JSON gösterimi
{
  "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.
}
Alanlar
sortOrder

enum (SortOrder)

Sipariş verileri sıralanmalıdır.

foregroundColor
(deprecated)

object (Color)

Sıralamada kullanılacak ön plan rengi. Bu ön plan rengine sahip hücreler en üste sıralanır. backgroundColor ile karşılıklı olarak hariç tutulur. Desteği sonlandırıldı: foregroundColorStyle kullanın.

foregroundColorStyle

object (ColorStyle)

Sıralamada kullanılacak ön plan rengi. Bu ön plan rengine sahip hücreler en üste sıralanır. backgroundColor ile birbirini dışlar ve RGB türünde bir renk olmalıdır. foregroundColor da ayarlanmışsa bu alan öncelikli olur.

backgroundColor
(deprecated)

object (Color)

Sıralamada temel alınacak arka plan dolgu rengi. Bu dolgu rengine sahip hücreler en üste sıralanır. foregroundColor ile karşılıklı olarak hariç tutulur. Desteği sonlandırıldı: backgroundColorStyle kullanın.

backgroundColorStyle

object (ColorStyle)

Sıralamada temel alınacak arka plan dolgu rengi. Bu dolgu rengine sahip hücreler en üste sıralanır. foregroundColor ile birbirini dışlar ve RGB türünde bir renk olmalıdır. backgroundColor da ayarlanmışsa bu alan öncelikli olur.

Birleşik alan reference. Sıralanan boyuta referans. reference aşağıdakilerden yalnızca biri olabilir:
dimensionIndex

integer

Sıralamanın uygulanacağı boyut.

dataSourceColumnReference

object (DataSourceColumnReference)

Veri kaynağı sütununa referans.

EmbeddedObjectPosition

Grafik gibi yerleştirilmiş bir nesnenin konumu.

JSON gösterimi
{

  // 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.
}
Alanlar
Birleşik alan location. Nesnenin konumu. Tam olarak bir değer ayarlanmalıdır. location aşağıdakilerden yalnızca biri olabilir:
sheetId

integer

Bu işlevin bulunduğu sayfa. Yalnızca yerleştirilmiş nesne kendi sayfasındaysa ayarlanır. Negatif olmamalıdır.

overlayPosition

object (OverlayPosition)

Nesnenin bir ızgaranın üzerine yerleştirildiği konum.

newSheet

boolean

Doğruysa yerleştirilen nesne, kimliği sizin için seçilen yeni bir sayfaya yerleştirilir. Yalnızca yazarken kullanılır.

OverlayPosition

Bir nesnenin ızgaranın üzerine yerleştirildiği konum.

JSON gösterimi
{
  "anchorCell": {
    object (GridCoordinate)
  },
  "offsetXPixels": integer,
  "offsetYPixels": integer,
  "widthPixels": integer,
  "heightPixels": integer
}
Alanlar
anchorCell

object (GridCoordinate)

Nesnenin sabitlendiği hücre.

offsetXPixels

integer

Nesnenin, piksel cinsinden, tutturma hücresinden yatay ofseti.

offsetYPixels

integer

Nesnenin, tutturma hücresinden dikey olarak kaydırıldığı piksel cinsinden değer.

widthPixels

integer

Nesnenin piksel cinsinden genişliği. Varsayılan olarak 600 değerine ayarlanır.

heightPixels

integer

Nesnenin piksel cinsinden yüksekliği. Varsayılan olarak 371 değerine ayarlanır.

GridCoordinate

Bir sayfadaki koordinat. Tüm dizinler sıfır tabanlıdır.

JSON gösterimi
{
  "sheetId": integer,
  "rowIndex": integer,
  "columnIndex": integer
}
Alanlar
sheetId

integer

Bu koordinatın bulunduğu sayfa.

rowIndex

integer

Koordinatın satır dizini.

columnIndex

integer

Koordinatın sütun dizini.