İstek
Bir dokümana uygulanacak tek bir güncelleme.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
Birlik alanı
request . Uygulanacak istek. Tam olarak bir alan gereklidir.
request
yalnızca aşağıdakilerden biri olabilir:
|
|
replace
|
Belirtilen metnin tüm örneklerini değiştirir. |
insert
|
Belirtilen konuma metin ekler. |
update
|
Belirtilen aralıktaki metin stilini günceller. |
create
|
Paragraflar için madde işaretleri oluşturur. |
delete
|
Paragraflardaki madde işaretlerini siler. |
create
|
Adlandırılmış aralık oluşturur. |
delete
|
Adlandırılmış aralığı siler. |
update
|
Belirtilen aralıktaki paragraf stilini günceller. |
delete
|
Dokümandaki içeriği siler. |
insert
|
Belirtilen konuma satır içi resim ekler. |
insert
|
Belirtilen konuma bir tablo ekler. |
insert
|
Tabloya boş bir satır ekler. |
insert
|
Tabloya boş bir sütun ekler. |
delete
|
Tablodaki bir satırı siler. |
delete
|
Tablodaki bir sütunu siler. |
insert
|
Belirtilen konuma sayfa sonu ekler. |
delete
|
Yerleştirilmiş bir nesneyi dokümandan siler. |
update
|
Tablodaki sütunların özelliklerini günceller. |
update
|
Tablo hücrelerinin stilini günceller. |
update
|
Tablodaki satır stilini günceller. |
replace
|
Dokümandaki bir resmi değiştirir. |
update
|
Belgenin stilini günceller. |
merge
|
Tablodaki hücreleri birleştirir. |
unmerge
|
Tablodaki hücrelerin birleştirilmesini kaldırır. |
create
|
Üstbilgi oluşturur. |
create
|
Altbilgi oluşturur. |
create
|
Dipnot oluşturur. |
replace
|
Adlandırılmış bir aralıktaki içeriği değiştirir. |
update
|
Belirtilen aralığın bölüm stilini günceller. |
insert
|
Belirtilen konuma bir bölüm sonu ekler. |
delete
|
Dokümanda bir üstbilgiyi siler. |
delete
|
Dokümandan bir altbilgiyi siler. |
pin
|
Tablodaki sabitlenmiş başlık satırlarının sayısını günceller. |
ReplaceAllTextRequest
Bir ölçütle eşleşen tüm metin örneklerini replace text
ile değiştirir.
JSON gösterimi |
---|
{ "replaceText": string, "tabsCriteria": { object ( |
Alanlar | |
---|---|
replace
|
Eşleşen metnin yerini alacak metin. |
tabs
|
İsteğe bağlı. Değiştirmenin hangi sekmelerde gerçekleşeceğini belirtmek için kullanılan ölçütler. Atlanırsa değiştirme işlemi tüm sekmelere uygulanır. Tek sekme içeren bir dokümanda:
Birden fazla sekme içeren bir dokümanda:
|
Birlik alanı
criteria . Değiştirilecek metni eşleştirmek için kullanılan ölçütler.
criteria
yalnızca aşağıdakilerden biri olabilir:
|
|
contains
|
Dokümanda bu alt dizeyle eşleşen metni bulur. |
SubstringMatchCriteria
Belgedeki belirli bir metin diziyle eşleşen bir ölçüt.
JSON gösterimi |
---|
{ "text": string, "matchCase": boolean } |
Alanlar | |
---|---|
text
|
Dokümanda aranacak metin. |
match
|
Aramanın büyük/küçük harflere duyarlı olup olmayacağını belirtir:
|
TabsCriteria
Bir isteğin hangi sekmelerde çalışacağını belirten ölçüt.
JSON gösterimi |
---|
{ "tabIds": [ string ] } |
Alanlar | |
---|---|
tab
|
İsteğin yürütüldüğü sekme kimliklerinin listesi. |
InsertTextRequest
Belirtilen konuma metin ekler.
JSON gösterimi |
---|
{ "text": string, // Union field |
Alanlar | |
---|---|
text
|
Eklenecek metin.
Yeni satır karakteri eklemek, söz konusu dizinde yeni bir Eklenen metnin metin stilleri otomatik olarak belirlenir ve genellikle komşu metnin stili korunur. Çoğu durumda, eklenen metnin metin stili, ekleme dizininden hemen önceki metinle eşleşir. Bazı kontrol karakterleri (U+0000-U+0008, U+000C-U+001F) ve Unicode Temel Çok Dilli Düzlem Özel Kullanım Alanı'ndaki (U+E000-U+F8FF) karakterler, eklenen metinden kaldırılır. |
Birlik alanı
insertion_location . Metnin ekleneceği konum.
insertion_location
yalnızca aşağıdakilerden biri olabilir:
|
|
location
|
Metni dokümanda belirli bir dizinde ekler.
Metin, mevcut bir |
end
|
Metni bir üstbilginin, altbilginin, dipnotun veya doküman gövdesinin sonuna ekler. |
Konum
Belgedeki belirli bir konum.
JSON gösterimi |
---|
{ "segmentId": string, "index": integer, "tabId": string } |
Alanlar | |
---|---|
segment
|
Konumun bulunduğu üstbilgi, altbilgi veya dipnotun kimliği. Boş bir segment kimliği, dokümanın gövdesini belirtir. |
index
|
UTF-16 kod birimlerinde sıfır tabanlı dizin.
Dizin, |
tab
|
Konumun bulunduğu sekme. Atlandığında, istek ilk sekmeye uygulanır. Tek sekme içeren bir dokümanda:
Birden fazla sekme içeren bir dokümanda:
|
EndOfSegmentLocation
Bir gövdenin, üstbilginin, altbilginin veya dipnotun sonundaki konum. Konum, doküman segmentindeki son satır başı işaretinden hemen öncedir.
JSON gösterimi |
---|
{ "segmentId": string, "tabId": string } |
Alanlar | |
---|---|
segment
|
Konumun bulunduğu üstbilgi, altbilgi veya dipnotun kimliği. Boş bir segment kimliği, belgenin gövdesini gösterir. |
tab
|
Konumun bulunduğu sekme. Atlanırsa istek ilk sekmeye uygulanır. Tek sekme içeren bir dokümanda:
Birden fazla sekme içeren bir dokümanda:
|
UpdateTextStyleRequest
Metnin stilini güncelleyin.
JSON gösterimi |
---|
{ "textStyle": { object ( |
Alanlar | |
---|---|
text
|
Metinde ayarlanacak stiller. Belirli bir stilin değeri üst öğenin değeriyle eşleşirse bu stil devralınacak şekilde ayarlanır.
Belirli metin stili değişiklikleri, Dokümanlar düzenleyicisinin davranışını yansıtmak için başka değişikliklere neden olabilir. Daha fazla bilgi için |
fields
|
Güncellenmesi gereken alanlar.
En az bir alan belirtilmelidir. Kök dizin
Örneğin, metin stilini kalın olarak güncellemek için Bir özelliği varsayılan değerine sıfırlamak için alan maskesine alan adını ekleyin ancak alanın değerini ayarlanmamış bırakın. |
Birlik alanı
insertion_location . Metin stilinin güncelleneceği yerde kullanılan aralık türü.
insertion_location
yalnızca aşağıdakilerden biri olabilir:
|
|
range
|
Stil uygulanacak metin aralığı. Aralık, bitişik yeni satırları içerecek şekilde genişletilebilir. Aralık, bir listeye ait bir paragrafı tamamen içeriyorsa paragrafın madde işareti de eşleşen metin stiliyle güncellenir. Aralıklar, göreli bir UpdateTextStyleRequest içine eklenemez. |
CreateParagraphBulletsRequest
Belirtilen aralıkla örtüşen tüm paragraflar için madde işaretleri oluşturur.
Her paragrafın iç içe yerleştirme düzeyi, her paragrafın önündeki ilk sekmelerin sayılmasıyla belirlenir. Madde işareti ile karşılık gelen paragraf arasında fazla boşluk olmaması için bu istekle, baştaki bu sekmeler kaldırılır. Bu, metnin bölümlerinin indekslerini değiştirebilir.
Güncellenen paragraflardan hemen önceki paragraf, eşleşen bir hazır ayarın bulunduğu bir listedeyse güncellenen paragraflar bu önceki listeye eklenir.
JSON gösterimi |
---|
{ "range": { object ( |
Alanlar | |
---|---|
range
|
Madde işareti hazır ayarının uygulanacağı aralık. |
bullet
|
Kullanılacak madde işareti glif türleri. |
BulletGlyphPreset
Listeler için önceden ayarlanmış nokta simgesi kalıpları.
Bu kalıplarda şu tür madde işaretleri kullanılır:
-
ARROW
: Unicode U+2794 kod noktasına karşılık gelen bir ok -
ARROW3D
: Unicode U+27a2 kod noktasına karşılık gelen 3D gölgelemeli bir ok -
CHECKBOX
: Unicode U+274f kod noktasına karşılık gelen içi boş kare -
CIRCLE
: Unicode U+25cb kod noktasına karşılık gelen içi boş bir daire -
DIAMOND
: Unicode U+25c6 kod noktasına karşılık gelen dolu bir elmas -
DIAMONDX
: Unicode U+2756 kod noktasına karşılık gelen, "x" harfine sahip elmas -
HOLLOWDIAMOND
: Unicode U+25c7 kod noktasına karşılık gelen boş bir elmas -
DISC
: Unicode U+25cf kod noktasına karşılık gelen düz bir daire -
SQUARE
: Unicode U+25a0 kod noktasına karşılık gelen dolu kare -
STAR
: Unicode U+2605 kod noktasına karşılık gelen bir yıldız -
ALPHA
: "a", "b" veya "c" gibi küçük bir harf. -
UPPERALPHA
: "A", "B" veya "C" gibi büyük bir harf. -
DECIMAL
: "1", "2" veya "3" gibi bir sayı. -
ZERODECIMAL
: Tek haneli sayıların önüne sıfır eklenmiş bir sayı ("01", "02" veya "03" gibi). Birden fazla basamaklı sayılara sıfır öneki eklenmez. -
ROMAN
: "i", "ii" veya "iii" gibi küçük Roma rakamı. -
UPPERROMAN
: "I", "II" veya "III" gibi büyük harfli bir Roma rakamı. -
LEFTTRIANGLE
: Unicode U+25c4 kod noktasına karşılık gelen, sola bakan bir üçgen
Sıralamalar | |
---|---|
BULLET_GLYPH_PRESET_UNSPECIFIED
|
Mermi simgesi hazır ayarı belirtilmemiş. |
BULLET_DISC_CIRCLE_SQUARE
|
İlk 3 liste iç içe yerleştirme düzeyi için DISC , CIRCLE ve SQUARE madde işareti glifi içeren madde işaretli liste.
|
BULLET_DIAMONDX_ARROW3D_SQUARE
|
İlk 3 liste iç içe yerleştirme seviyesi için DIAMONDX , ARROW3D ve SQUARE madde işaretiglifinin yer aldığı bir madde işaretli liste.
|
BULLET_CHECKBOX
|
Tüm liste iç içe yerleştirme seviyeleri için CHECKBOX
madde işareti glifleri içeren bir madde işaretli liste.
|
BULLET_ARROW_DIAMOND_DISC
|
İlk 3 liste iç içe yerleştirme seviyesi için ARROW , DIAMOND ve DISC madde işaretiglifinin yer aldığı bir madde işaretli liste.
|
BULLET_STAR_CIRCLE_SQUARE
|
İlk 3 liste iç içe yerleştirme seviyesi için STAR , CIRCLE ve SQUARE madde işaretiglifinin yer aldığı bir madde işaretli liste.
|
BULLET_ARROW3D_CIRCLE_SQUARE
|
İlk 3 liste iç içe yerleştirme seviyesi için ARROW3D , CIRCLE ve SQUARE madde işaretiglifinin yer aldığı bir madde işaretli liste.
|
BULLET_LEFTTRIANGLE_DIAMOND_DISC
|
İlk 3 liste iç içe yerleştirme seviyesi için LEFTTRIANGLE , DIAMOND ve DISC madde işaretiglifinin yer aldığı bir madde işaretli liste.
|
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE
|
İlk 3 liste iç içe yerleştirme seviyesi için DIAMONDX , HOLLOWDIAMOND ve SQUARE madde işaretiglifinin yer aldığı bir madde işaretli liste.
|
BULLET_DIAMOND_CIRCLE_SQUARE
|
İlk 3 liste iç içe yerleştirme seviyesi için DIAMOND , CIRCLE ve SQUARE madde işaretiglifinin yer aldığı bir madde işaretli liste.
|
NUMBERED_DECIMAL_ALPHA_ROMAN
|
İlk 3 liste iç içe yerleştirme düzeyi için DECIMAL ,
ALPHA
ve
ROMAN
sayısal glif ve ardından nokta içeren numaralı liste.
|
NUMBERED_DECIMAL_ALPHA_ROMAN_PARENS
|
İlk 3 liste iç içe yerleştirme seviyesi için DECIMAL ,
ALPHA
ve
ROMAN
sayısal gliflerin ardından parantez içeren bir numaralı liste.
|
NUMBERED_DECIMAL_NESTED
|
Noktalarla ayrılmış DECIMAL sayısal glif içeren numaralı liste. Her iç içe yerleştirme seviyesi, bir önceki iç içe yerleştirme seviyesinin glifini önek olarak kullanır. Örneğin: "1.", '1.1.', '2.', '2.2.'.
|
NUMBERED_UPPERALPHA_ALPHA_ROMAN
|
İlk 3 liste iç içe yerleştirme seviyesi için UPPERALPHA ,
ALPHA
ve
ROMAN
sayısal gliflerin ardından noktaların yer aldığı bir numaralı liste.
|
NUMBERED_UPPERROMAN_UPPERALPHA_DECIMAL
|
İlk 3 liste iç içe yerleştirme seviyesi için UPPERROMAN ,
UPPERALPHA
ve
DECIMAL
sayısal gliflerin ardından noktaların yer aldığı bir numaralı liste.
|
NUMBERED_ZERODECIMAL_ALPHA_ROMAN
|
İlk 3 liste iç içe yerleştirme seviyesi için ZERODECIMAL ,
ALPHA
ve
ROMAN
sayısal gliflerin ardından noktaların yer aldığı bir numaralı liste.
|
DeleteParagraphBulletsRequest
Belirtilen aralıkla örtüşen tüm paragraflardaki madde işaretlerini siler.
İlgili paragrafın başına girinti ekleyerek her paragrafın iç içe yerleştirme düzeyi görsel olarak korunur.
JSON gösterimi |
---|
{
"range": {
object ( |
Alanlar | |
---|---|
range
|
Noktalı liste öğelerinin silineceği aralık. |
CreateNamedRangeRequest
Belirtilen aralığa referansta bulunan bir NamedRange
oluşturur.
JSON gösterimi |
---|
{
"name": string,
"range": {
object ( |
Alanlar | |
---|---|
name
|
NamedRange nesnesinin adı. Adların benzersiz olması gerekmez. Adlar, UTF-16 kod birimleri cinsinden en az 1 karakter ve en fazla 256 karakter uzunluğunda olmalıdır. |
range
|
Adın uygulanacağı aralık. |
DeleteNamedRangeRequest
Bir NamedRange
silinir.
JSON gösterimi |
---|
{ "tabsCriteria": { object ( |
Alanlar | |
---|---|
tabs
|
İsteğe bağlı. Aralık silme işleminin hangi sekmelerde yapılması gerektiğini belirtmek için kullanılan ölçütler. Atlanırsa aralık silme işlemi tüm sekmelere uygulanır. Tek sekme içeren bir dokümanda:
Birden fazla sekme içeren bir dokümanda:
|
Birleştirme alanı
named_range_reference . Hangi aralığın veya aralıkların silineceğini belirleyen değer. Tam olarak bir tane ayarlanmalıdır.
named_range_reference
yalnızca aşağıdakilerden biri olabilir:
|
|
named
|
Silinecek adlandırılmış aralığın kimliği. |
name
|
Silinecek aralıkların adı. Belirtilen ada sahip tüm adlandırılmış aralıklar silinir. |
UpdateParagraphStyleRequest
Belirtilen aralıkla örtüşen tüm paragrafların stilini güncelleyin.
JSON gösterimi |
---|
{ "paragraphStyle": { object ( |
Alanlar | |
---|---|
paragraph
|
Paragraflarda ayarlanacak stiller.
Bazı paragraf stili değişiklikleri, Dokümanlar düzenleyicisinin davranışını yansıtmak için başka değişikliklere neden olabilir. Daha fazla bilgi için |
fields
|
Güncellenmesi gereken alanlar.
En az bir alan belirtilmelidir. Kök dizin
Örneğin, paragraf stilinin hizalama özelliğini güncellemek için Bir özelliği varsayılan değerine sıfırlamak için alan maskesine alan adını ekleyin ancak alanın kendisini ayarlanmamış bırakın. |
Birleştirme alanı
insertion_location . Paragraf stilinin güncelleneceği aralığın türü.
insertion_location
yalnızca aşağıdakilerden biri olabilir:
|
|
range
|
Stil uygulanacak paragraflarla çakışan aralık. |
DeleteContentRangeRequest
Dokümandaki içeriği siler.
JSON gösterimi |
---|
{
"range": {
object ( |
Alanlar | |
---|---|
range
|
Silinecek içerik aralığı. Bir paragraf sınırını aşan metin silindiğinde, iki paragraf birleştirildiği için paragraf stillerinde, listelerde, yerleştirilmiş nesnelerde ve yer işaretlerinde değişiklikler olabilir. Belirli aralıkları silme girişimi, geçersiz bir doküman yapısına neden olabilir. Bu durumda, 400 hatalı istek hatası döndürülür. Geçersiz silme isteklerine örnek olarak aşağıdakiler verilebilir:
|
InsertInlineImageRequest
Belirtilen konumdaki bir resmi içeren InlineObject
ekler.
JSON gösterimi |
---|
{ "uri": string, "objectSize": { object ( |
Alanlar | |
---|---|
uri
|
Resim URI'si. Resim, eklenme sırasında bir kez getirilir ve dokümanda gösterilmek üzere bir kopyası saklanır. Resimler 50 MB'tan küçük, 25 megapikselden büyük olamaz ve PNG, JPEG veya GIF biçimlerinden birinde olmalıdır.
Sağlanan URI herkese açık olmalı ve en fazla 2 KB uzunluğunda olmalıdır. URI'nin kendisi resimle birlikte kaydedilir ve |
object
|
Resmin dokümanda görünmesi gereken boyutu. Bu özellik isteğe bağlıdır ve dokümandaki resmin nihai boyutu şu kurallara göre belirlenir: * Genişlik veya yükseklik belirtilmediyse çözünürlüğüne göre resmin varsayılan boyutu hesaplanır. * Bir boyut belirtilirse diğer boyut, resmin en boy oranını korumak için hesaplanır. * Hem genişlik hem de yükseklik belirtilirse resim, en boy oranını koruyarak belirtilen boyutlara sığacak şekilde ölçeklenir. |
Birlik alanı
insertion_location . Resmin ekleneceği konum.
insertion_location
yalnızca aşağıdakilerden biri olabilir:
|
|
location
|
Resmi dokümanda belirli bir dizine ekler.
Resim, mevcut bir Satır içi resimler dipnot veya denklem içine eklenemez. |
end
|
Metni bir üstbilginin, altbilginin veya doküman gövdesinin sonuna ekler. Satır içi resimler dipnotlara eklenemez. |
InsertTableRequest
Belirtilen konuma bir tablo ekler.
Eklenen tablonun önüne yeni satır karakteri eklenir.
JSON gösterimi |
---|
{ "rows": integer, "columns": integer, // Union field |
Alanlar | |
---|---|
rows
|
Tablodaki satır sayısı. |
columns
|
Tablodaki sütun sayısı. |
Birlik alanı
insertion_location . Tablonun ekleneceği konum.
insertion_location aşağıdakilerden yalnızca biri olabilir:
|
|
location
|
Tabloyu belirli bir model dizine ekler. Eklenen tablonun önüne yeni satır karakteri eklenir. Bu nedenle, tablo başlangıç dizini, belirtilen konum dizini + 1 olur.
Tablo, mevcut bir Tablolar dipnot veya denklem içine eklenemez. |
end
|
Tabloyu, belirtilen üstbilginin, altbilginin veya doküman gövdesinin sonuna ekler. Eklenen tablonun önüne yeni satır karakteri eklenir. Tablolar dipnotlara eklenemez. |
InsertTableRowRequest
Tabloya boş bir satır ekler.
JSON gösterimi |
---|
{
"tableCellLocation": {
object ( |
Alanlar | |
---|---|
table
|
Satırların ekleneceği referans tablo hücresi konumu. Referans hücrenin bulunduğu satırın üstüne (veya altına) yeni bir satır eklenir. Referans hücre birleştirilmiş bir hücreyse birleştirilmiş hücrenin üstüne (veya altına) yeni bir satır eklenir. |
insert
|
Referans hücre konumunun altına yeni satır eklenip eklenmeyeceğini belirtir.
|
TableCellLocation
Tablodaki tek bir hücrenin konumu.
JSON gösterimi |
---|
{
"tableStartLocation": {
object ( |
Alanlar | |
---|---|
table
|
Tablonun dokümanda başladığı konum. |
row
|
Sıfır tabanlı satır dizini. Örneğin, tablodaki ikinci satırın satır dizini 1'dir. |
column
|
Sıfır tabanlı sütun dizini. Örneğin, tablodaki ikinci sütunun sütun dizini 1'dir. |
InsertTableColumnRequest
Tabloya boş bir sütun ekler.
JSON gösterimi |
---|
{
"tableCellLocation": {
object ( |
Alanlar | |
---|---|
table
|
Sütunların ekleneceği referans tablo hücresi konumu. Referans hücrenin bulunduğu sütunun soluna (veya sağına) yeni bir sütun eklenir. Referans hücre bir birleştirilmiş hücreyse birleştirilmiş hücrenin soluna (veya sağına) yeni bir sütun eklenir. |
insert
|
Başvuru hücre konumunun sağına yeni sütun eklenip eklenmeyeceğini belirtir.
|
DeleteTableRowRequest
Tablodaki bir satırı siler.
JSON gösterimi |
---|
{
"tableCellLocation": {
object ( |
Alanlar | |
---|---|
table
|
Satırın silineceği referans tablosu hücre konumu. Bu hücrenin kapladığı satır silinecek. Bu, birden fazla satırı kapsayan birleştirilmiş bir hücreyse hücrenin kapsadığı tüm satırlar silinir. Bu silme işleminden sonra tabloda satır kalmazsa tablonun tamamı silinir. |
DeleteTableColumnRequest
Tablodaki bir sütunu siler.
JSON gösterimi |
---|
{
"tableCellLocation": {
object ( |
Alanlar | |
---|---|
table
|
Sütununun silineceği referans tablo hücresi konumu. Bu hücrenin kapladığı sütun silinecek. Birden çok sütuna yayılan birleştirilmiş bir hücre söz konusuysa hücrenin kapsadığı tüm sütunlar silinir. Bu silme işleminden sonra tabloda hiç sütun kalmazsa tablonun tamamı silinir. |
InsertPageBreakRequest
Belirtilen konuma bir sayfa sonu ve ardından yeni satır ekler.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
Birleştirme alanı
insertion_location . Sayfa sonunun ekleneceği konum.
insertion_location
yalnızca aşağıdakilerden biri olabilir:
|
|
location
|
Sayfa sonunu dokümanda belirli bir dizine ekler.
Sayfa sonu, mevcut bir
Sayfa sonları tablo, denklem, dipnot, üst bilgi veya alt bilgi içine eklenemez. Sayfa sonları yalnızca gövdeye eklenebildiği için |
end
|
Sayfa sonunu doküman gövdesinin sonuna ekler.
Sayfa sonları dipnot, üstbilgi veya altbilgi içine eklenemez. Sayfa sonları yalnızca gövdenin içine eklenebildiğinden |
DeletePositionedObjectRequest
Dokümandan
PositionedObject
öğesini siler.
JSON gösterimi |
---|
{ "objectId": string, "tabId": string } |
Alanlar | |
---|---|
object
|
Silinecek konumlandırılmış nesnenin kimliği. |
tab
|
Silinecek nesnenin bulunduğu sekme. Atlanırsa istek ilk sekmeye uygulanır. Tek sekme içeren bir dokümanda:
Birden fazla sekme içeren bir dokümanda:
|
UpdateTableColumnPropertiesRequest
Tablodaki sütunların TableColumnProperties
biçimini günceller.
JSON gösterimi |
---|
{ "tableStartLocation": { object ( |
Alanlar | |
---|---|
table
|
Tablonun dokümanda başladığı konum. |
column
|
Özelliğinin güncellenmesi gereken sıfır tabanlı sütun dizinlerinin listesi. Hiçbir dizin belirtilmezse tüm sütunlar güncellenir. |
table
|
Güncellenecek tablo sütunu özellikleri.
|
fields
|
Güncellenmesi gereken alanlar.
En az bir alan belirtilmelidir.
Örneğin, sütun genişliğini güncellemek için |
UpdateTableCellStyleRequest
Bir tablo hücresi aralığının stilini günceller.
JSON gösterimi |
---|
{ "tableCellStyle": { object ( |
Alanlar | |
---|---|
table
|
Tablo hücrelerinde ayarlanacak stil. Kenarlıklar güncellenirken, bir hücre bitişik bir hücreyle kenar paylaşıyorsa bitişik hücrenin ilgili kenar özelliği de güncellenir. Birleştirilmiş ve görünmeyen kenarlıklar güncellenmez. Aynı istekteki bitişik hücreler tarafından paylaşılan bir kenarlığın güncellenmesi, çakışan kenarlık güncellemelerine neden olabileceğinden kenarlık güncellemeleri aşağıdaki sırayla uygulanır:
|
fields
|
Güncellenmesi gereken alanlar.
En az bir alan belirtilmelidir. Kök dizin
Örneğin, tablo hücresi arka plan rengini güncellemek için Bir özelliği varsayılan değerine sıfırlamak için alan adını alan maskesine ekleyin ancak alanı ayarlanmamış olarak bırakın. |
Birleştirme alanı
cells . Güncellenecek hücreler.
cells
yalnızca aşağıdakilerden biri olabilir:
|
|
table
|
Güncellemelerin uygulandığı tablo alt kümesini temsil eden tablo aralığı. |
table
|
Tablonun dokümanda başladığı konum. Belirtilen güncellemeler, tablodaki tüm hücrelere uygulanır. |
TableRange
Tablo aralığı, bir tablonun alt kümesine yapılan başvuruyu temsil eder.
Tablo aralığıyla belirtilen hücrelerin mutlaka dikdörtgen oluşturmadığını unutmayın. Örneğin, son satırdaki tüm hücrelerin birleştirildiği 3 x 3 boyutunda bir tablomuz olduğunu varsayalım. Tablo şu şekilde görünür:
[ ][ ][ ]
[ ][ ][ ]
[ ]
Tablo hücresi konumu = (tabloBaşlangıçKonumu, satır = 0, sütun = 0), satır kapsamı = 3 ve sütun kapsamı = 2 olan bir tablo aralığı aşağıdaki hücreleri belirtir:
[ x ][ x ][ ]
[ x ][ x ][ ]
[ x x x ]
JSON gösterimi |
---|
{
"tableCellLocation": {
object ( |
Alanlar | |
---|---|
table
|
Tablo aralığının başladığı hücre konumu. |
row
|
Tablo aralığının satır kapsamı. |
column
|
Tablo aralığının sütun aralığı. |
UpdateTableRowStyleRequest
Tablodaki satırların TableRowStyle
sayısını günceller.
JSON gösterimi |
---|
{ "tableStartLocation": { object ( |
Alanlar | |
---|---|
table
|
Tablonun dokümanda başladığı konum. |
row
|
Stili güncellenmesi gereken sıfır tabanlı satır dizinlerinin listesi. Dizin belirtilmezse tüm satırlar güncellenir. |
table
|
Satırlarda ayarlanacak stiller. |
fields
|
Güncellenmesi gereken alanlar.
En az bir alan belirtilmelidir. Kök dizin
Örneğin, minimum satır yüksekliğini güncellemek için |
ReplaceImageRequest
Mevcut bir resmi yeni bir resimle değiştirir.
Bir resim değiştirildiğinde, Dokümanlar düzenleyicisinin davranışını yansıtmak için
mevcut resimdeki bazı image effects
kaldırılır.
JSON gösterimi |
---|
{
"imageObjectId": string,
"uri": string,
"imageReplaceMethod": enum ( |
Alanlar | |
---|---|
image
|
Değiştirilecek mevcut resmin kimliği. Kimlik, bir get isteğinin yanıtından alınabilir. |
uri
|
Yeni resmin URI'si. Resim, eklenme sırasında bir kez getirilir ve dokümanda gösterilmek üzere bir kopyası saklanır. Resimler 50 MB'tan küçük, 25 megapikselden büyük olamaz ve PNG, JPEG veya GIF biçiminde olmalıdır.
Sağlanan URI uzunluğu 2 KB'ı aşamaz. URI, resimle birlikte kaydedilir ve |
image
|
Değişim yöntemi. |
tab
|
Değiştirilecek resmin bulunduğu sekme. Atlandığında, istek ilk sekmeye uygulanır. Tek sekme içeren bir dokümanda:
Birden fazla sekme içeren bir dokümanda:
|
ImageReplaceMethod
Resim değiştirme yöntemi.
Sıralamalar | |
---|---|
IMAGE_REPLACE_METHOD_UNSPECIFIED
|
Belirtilmemiş resim değiştirme yöntemi. Bu değer kullanılmamalıdır. |
CENTER_CROP
|
Resmi, orijinal resmin sınırlarını dolduracak şekilde ölçeklendirip ortalar. Resim, orijinal resmin sınırlarını dolduracak şekilde kırpılabilir. Resmin oluşturulan boyutu, orijinal resimle aynı olur. |
UpdateDocumentStyleRequest
DocumentStyle
'yi günceller.
JSON gösterimi |
---|
{
"documentStyle": {
object ( |
Alanlar | |
---|---|
document
|
Dokümanda ayarlanacak stiller.
Bazı doküman stili değişiklikleri, Dokümanlar düzenleyicisinin davranışını yansıtmak için başka değişikliklere neden olabilir. Daha fazla bilgi için |
fields
|
Güncellenmesi gereken alanlar.
En az bir alan belirtilmelidir. Kök dizin
Örneğin, arka planı güncellemek için |
tab
|
Güncellenecek stili içeren sekme. Atlanırsa istek ilk sekme için geçerli olur. Tek sekme içeren bir dokümanda:
Birden fazla sekme içeren bir dokümanda:
|
MergeTableCellsRequest
Table
içindeki hücreleri birleştirir.
JSON gösterimi |
---|
{
"tableRange": {
object ( |
Alanlar | |
---|---|
table
|
Tablonun hangi hücrelerinin birleştirileceğini belirten tablo aralığı. Birleştirilen hücrelerdeki tüm metinler birleştirilir ve aralığın "başlık" hücresinde depolanır. İçerik yönü soldan sağa olduğunda aralıktaki sol üst hücre, aksi takdirde aralıktaki sağ üst hücredir. Aralık dikdörtgen değilse (aralık zaten birleştirilmiş hücreleri kapsayan bazı durumlarda ortaya çıkabilir veya tablonun dikdörtgen biçiminde olmadığı durumlarda ortaya çıkabilir) 400 hatalı istek hatası döndürülür. |
UnmergeTableCellsRequest
Birleştirilen hücreleri Table
'te ayırır.
JSON gösterimi |
---|
{
"tableRange": {
object ( |
Alanlar | |
---|---|
table
|
Tablonun hangi hücrelerinin birleştirileceğini belirten tablo aralığı. Bu aralıktaki tüm birleştirilmiş hücrelerin birleştirilmesi iptal edilir. Daha önce birleştirilmemiş hücreler bu durumdan etkilenmez. Aralıkta birleştirilmiş hücre yoksa istek hiçbir şey yapmaz. Birleştirilen hücrelerden herhangi birinde metin varsa metin, birleştirilmemiş hücrelerden oluşan blokun "baş" hücresinde kalır. İçerik yönü soldan sağa; "head" hücresi sol üstteki hücredir, aksi halde sağ üstteki hücredir. |
CreateHeaderRequest
Header
oluşturur. Yeni üst bilgi, belirtilirse SectionBreak
öğesinin konumunda SectionStyle
öğesine uygulanır. Aksi takdirde DocumentStyle
öğesine uygulanır.
Belirtilen türde bir üstbilgi zaten mevcutsa 400 hatalı istek hatası döndürülür.
JSON gösterimi |
---|
{ "type": enum ( |
Alanlar | |
---|---|
type
|
Oluşturulacak üstbilginin türü. |
section
|
Bu başlığın ait olması gereken bölümün başladığı |
CreateFootnoteRequest
Bir Footnote
segmenti oluşturur ve bu segmente belirli bir konumda yeni bir FootnoteReference
ekler.
Yeni Footnote
segmenti, bir boşluk ve ardından yeni satır karakteri içerir.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
Birlik alanı
footnote_reference_location . Dipnot referansının ekleneceği konum.
footnote_reference_location
yalnızca aşağıdakilerden biri olabilir:
|
|
location
|
Dipnot referansını dokümanda belirli bir dizinde ekler.
Dipnot referansı, mevcut bir
Dipnot referansları bir denkleme, üstbilgiye, altbilgiye veya dipnota eklenemez. Dipnot referansları yalnızca metne eklenebilir. Bu nedenle, |
end
|
Dipnot referansını doküman gövdesinin sonuna ekler.
Dipnot referansları bir üstbilgi, altbilgi veya dipnot içine eklenemez. Dipnot referansları yalnızca gövdeye eklenebildiğinden |
ReplaceNamedRangeContentRequest
Belirtilen NamedRange
veya NamedRanges
öğesinin içeriğini, belirtilen değiştirme içeriğiyle değiştirir.
Bir NamedRange
ranges
'in birden fazla kesintili ranges
'den oluşabileceğini unutmayın. Bu durumda, yalnızca ilk aralıktaki içerik değiştirilir. Diğer aralıklar ve içerikleri silinecek.
Herhangi bir aralığın değiştirilmesi veya silinmesinin geçersiz bir doküman yapısıyla sonuçlanacağı durumlarda 400 hatalı istek hatası döndürülür.
JSON gösterimi |
---|
{ "tabsCriteria": { object ( |
Alanlar | |
---|---|
tabs
|
İsteğe bağlı. Değişimin hangi sekmelerde gerçekleşeceğini belirtmek için kullanılan ölçütler. Atlanırsa değiştirme işlemi tüm sekmelere uygulanır. Tek sekme içeren bir dokümanda:
Birden fazla sekme içeren bir dokümanda:
|
Birlik alanı
replacement_content . Adlandırılmış aralığın mevcut içeriğini değiştirecek içerik.
replacement_content aşağıdakilerden yalnızca biri olabilir:
|
|
text
|
Belirtilen adlandırılmış aralıkların içeriğini belirtilen metinle değiştirir. |
Birlik alanı
named_range_reference . İçeriği değiştirilecek adlandırılmış aralıklara referans.
named_range_reference
yalnızca aşağıdakilerden biri olabilir:
|
|
named
|
İçeriği değiştirilecek adlandırılmış aralığın kimliği. Belirtilen kimliğe sahip adlandırılmış aralık yoksa 400 hatalı istek hatası döndürülür. |
named
|
İçeriği değiştirilecek
Belirtilen ada sahip birden fazla öğe varsa bunların her birinin içeriği değiştirilir. |
UpdateSectionStyleRequest
SectionStyle
'yi günceller.
JSON gösterimi |
---|
{ "range": { object ( |
Alanlar | |
---|---|
range
|
Stil uygulanacak bölümlerle çakışan aralık.
Bölüm araları yalnızca gövdeye eklenebildiğinden |
section
|
Bölümde ayarlanacak stiller.
Belirli bölüm stili değişiklikleri, Dokümanlar düzenleyicisinin davranışını yansıtmak için başka değişikliklere neden olabilir. Daha fazla bilgi için |
fields
|
Güncellenmesi gereken alanlar.
En az bir alan belirtilmelidir. Kök dizin
Örneğin, sol kenar boşluğunu güncellemek için |
InsertSectionBreakRequest
Belirtilen konuma bir bölüm sonu ekler.
Bölüm sonuna yeni satır karakteri eklenir.
JSON gösterimi |
---|
{ "sectionType": enum ( |
Alanlar | |
---|---|
section
|
Eklenecek bölümün türü. |
Birlik alanı
insertion_location . Aranın ekleneceği konum.
insertion_location
yalnızca aşağıdakilerden biri olabilir:
|
|
location
|
Dokümanda belirli bir dizinde yeni satır ve bölüm sonu ekler.
Bölüm sonu, mevcut bir
Bölüm sonları tablo, denklem, dipnot, üstbilgi veya altbilgi içine eklenemez. Bölüm araları yalnızca gövdeye eklenebildiğinden |
end
|
Belge gövdesinin sonuna yeni satır ve bölüm sonu ekler.
Dipnot, üstbilgi veya altbilgi içine bölüm sonları eklenemez. Bölüm araları yalnızca gövdeye eklenebildiğinden |
DeleteHeaderRequest
Dokümandan
Header
öğesini siler.
JSON gösterimi |
---|
{ "headerId": string, "tabId": string } |
Alanlar | |
---|---|
header
|
Silecek üstbilginin kimliği. Bu başlık |
tab
|
Silecek başlığı içeren sekme. Atlanırsa istek ilk sekmeye uygulanır. Tek sekme içeren bir dokümanda:
Birden fazla sekme içeren bir dokümanda:
|
PinTableHeaderRowsRequest
Bir tablodaki sabitlenmiş tablo başlık satırı sayısını günceller.
JSON gösterimi |
---|
{
"tableStartLocation": {
object ( |
Alanlar | |
---|---|
table
|
Tablonun dokümanda başladığı konum. |
pinned
|
Sabitlenecek tablo satırlarının sayısı. 0 değeri, tüm satırların sabitlenmediğini gösterir. |