Requests

İstek

Bir dokümana uygulanacak tek bir güncelleme.

JSON gösterimi 
{

  // Union field request can be only one of the following:
  "replaceAllText": {
    object (ReplaceAllTextRequest)
  },
  "insertText": {
    object (InsertTextRequest)
  },
  "updateTextStyle": {
    object (UpdateTextStyleRequest)
  },
  "createParagraphBullets": {
    object (CreateParagraphBulletsRequest)
  },
  "deleteParagraphBullets": {
    object (DeleteParagraphBulletsRequest)
  },
  "createNamedRange": {
    object (CreateNamedRangeRequest)
  },
  "deleteNamedRange": {
    object (DeleteNamedRangeRequest)
  },
  "updateParagraphStyle": {
    object (UpdateParagraphStyleRequest)
  },
  "deleteContentRange": {
    object (DeleteContentRangeRequest)
  },
  "insertInlineImage": {
    object (InsertInlineImageRequest)
  },
  "insertTable": {
    object (InsertTableRequest)
  },
  "insertTableRow": {
    object (InsertTableRowRequest)
  },
  "insertTableColumn": {
    object (InsertTableColumnRequest)
  },
  "deleteTableRow": {
    object (DeleteTableRowRequest)
  },
  "deleteTableColumn": {
    object (DeleteTableColumnRequest)
  },
  "insertPageBreak": {
    object (InsertPageBreakRequest)
  },
  "deletePositionedObject": {
    object (DeletePositionedObjectRequest)
  },
  "updateTableColumnProperties": {
    object (UpdateTableColumnPropertiesRequest)
  },
  "updateTableCellStyle": {
    object (UpdateTableCellStyleRequest)
  },
  "updateTableRowStyle": {
    object (UpdateTableRowStyleRequest)
  },
  "replaceImage": {
    object (ReplaceImageRequest)
  },
  "updateDocumentStyle": {
    object (UpdateDocumentStyleRequest)
  },
  "mergeTableCells": {
    object (MergeTableCellsRequest)
  },
  "unmergeTableCells": {
    object (UnmergeTableCellsRequest)
  },
  "createHeader": {
    object (CreateHeaderRequest)
  },
  "createFooter": {
    object (CreateFooterRequest)
  },
  "createFootnote": {
    object (CreateFootnoteRequest)
  },
  "replaceNamedRangeContent": {
    object (ReplaceNamedRangeContentRequest)
  },
  "updateSectionStyle": {
    object (UpdateSectionStyleRequest)
  },
  "insertSectionBreak": {
    object (InsertSectionBreakRequest)
  },
  "deleteHeader": {
    object (DeleteHeaderRequest)
  },
  "deleteFooter": {
    object (DeleteFooterRequest)
  },
  "pinTableHeaderRows": {
    object (PinTableHeaderRowsRequest)
  }
  // End of list of possible types for union field request.
}
Alanlar
Birlik alanı request. Uygulanacak istek. Tam olarak bir alan zorunludur. request aşağıdakilerden yalnızca biri olabilir:
replaceAllText

object (ReplaceAllTextRequest)

Belirtilen metnin tüm örneklerini değiştirir.

insertText

object (InsertTextRequest)

Metni belirtilen konuma ekler.

updateTextStyle

object (UpdateTextStyleRequest)

Metin stilini, belirtilen aralıkta günceller.

createParagraphBullets

object (CreateParagraphBulletsRequest)

Paragraflar için madde işaretleri oluşturur.

deleteParagraphBullets

object (DeleteParagraphBulletsRequest)

Paragraflardaki madde işaretlerini siler.

createNamedRange

object (CreateNamedRangeRequest)

Adlandırılmış aralık oluşturur.

deleteNamedRange

object (DeleteNamedRangeRequest)

Adlandırılmış bir aralığı siler.

updateParagraphStyle

object (UpdateParagraphStyleRequest)

Paragraf stilini, belirtilen aralıkta günceller.

deleteContentRange

object (DeleteContentRangeRequest)

Dokümandaki içeriği siler.

insertInlineImage

object (InsertInlineImageRequest)

Belirtilen konuma bir satır içi resim ekler.

insertTable

object (InsertTableRequest)

Belirtilen konuma bir tablo ekler.

insertTableRow

object (InsertTableRowRequest)

Tabloya boş bir satır ekler.

insertTableColumn

object (InsertTableColumnRequest)

Tabloya boş bir sütun ekler.

deleteTableRow

object (DeleteTableRowRequest)

Tablodaki bir satırı siler.

deleteTableColumn

object (DeleteTableColumnRequest)

Tablodaki bir sütunu siler.

insertPageBreak

object (InsertPageBreakRequest)

Belirtilen konuma bir sayfa sonu ekler.

deletePositionedObject

object (DeletePositionedObjectRequest)

Dokümandaki konumlandırılmış bir nesneyi siler.

updateTableColumnProperties

object (UpdateTableColumnPropertiesRequest)

Bir tablodaki sütunların özelliklerini günceller.

updateTableCellStyle

object (UpdateTableCellStyleRequest)

Tablo hücrelerinin stilini günceller.

updateTableRowStyle

object (UpdateTableRowStyleRequest)

Tablodaki satır stilini günceller.

replaceImage

object (ReplaceImageRequest)

Dokümandaki bir resmi değiştirir.

updateDocumentStyle

object (UpdateDocumentStyleRequest)

Dokümanın stilini günceller.

mergeTableCells

object (MergeTableCellsRequest)

Tablodaki hücreleri birleştirir.

unmergeTableCells

object (UnmergeTableCellsRequest)

Tablodaki hücreleri ayırır.

createHeader

object (CreateHeaderRequest)

Bir başlık oluşturur.

createFootnote

object (CreateFootnoteRequest)

Dipnot oluşturur.

replaceNamedRangeContent

object (ReplaceNamedRangeContentRequest)

Adlandırılmış aralıktaki içeriği değiştirir.

updateSectionStyle

object (UpdateSectionStyleRequest)

Belirtilen aralığın bölüm stilini günceller.

insertSectionBreak

object (InsertSectionBreakRequest)

Belirtilen konuma bir bölüm sonu ekler.

deleteHeader

object (DeleteHeaderRequest)

Dokümandaki bir başlığı siler.

pinTableHeaderRows

object (PinTableHeaderRowsRequest)

Bir tablodaki sabitlenmiş başlık satırlarının sayısını günceller.

Tüm Metin İsteğini Değiştir

Bir ölçütle eşleşen tüm metin örneklerini replace text ile değiştirir.

JSON gösterimi 
{
  "replaceText": string,

  // Union field criteria can be only one of the following:
  "containsText": {
    object (SubstringMatchCriteria)
  }
  // End of list of possible types for union field criteria.
}
Alanlar
replaceText

string

Eşleşen metnin yerini alacak metin.

Birlik alanı criteria. Yenisiyle değiştirilecek metni eşleştirmek için kullanılan ölçütler. criteria aşağıdakilerden yalnızca biri olabilir:
containsText

object (SubstringMatchCriteria)

Dokümanda bu alt dizeyle eşleşen metni bulur.

Alt Dize Eşleştirme Ölçütleri

Dokümandaki belirli bir metin dizesiyle eşleşen ölçütler.

JSON gösterimi 
{
  "text": string,
  "matchCase": boolean
}
Alanlar
text

string

Dokümanda aranacak metin.

matchCase

boolean

Aramanın, duruma uygun olup olmayacağını belirtir:

  • True : arama büyük/küçük harfe duyarlıdır.
  • False : arama büyük/küçük harfe duyarlı değildir.

Metin İsteği Ekle

Metni belirtilen konuma ekler.

JSON gösterimi 
{
  "text": string,

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
Alanlar
text

string

Eklenecek metin.

Dolaylı olarak yeni bir satır karakteri eklendiğinde ilgili dizinde yeni bir Paragraph değeri oluşturulur. Yeni paragrafın paragraf stili, listeler ve madde işaretleri dahil olmak üzere geçerli ekleme dizinindeki paragraftan kopyalanır.

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ı metin karakterleri (U+0000-U+0008, U+000C-U+001F) ve Unicode Temel Çok Dilli Uçak Özel Kullanım Alanı'ndaki (U+E000-U+F8FF) karakterler, eklenen metinden çıkarılır.

Birlik alanı insertion_location. Metnin ekleneceği konum. insertion_location aşağıdakilerden yalnızca biri olabilir:
location

object (Location)

Metni, dokümandaki belirli bir dizine ekler.

Metin, mevcut bir Paragraph öğesinin sınırları içine yerleştirilmelidir. Örneğin, metin bir tablonun başlangıç dizinine (ör. tablo ile önceki paragraf arasına) eklenemez. Metin, önceki paragrafa eklenmelidir.

endOfSegmentLocation

object (EndOfSegmentLocation)

Metni bir üstbilginin, altbilginin, dipnotun veya doküman gövdesinin sonuna ekler.

Konum

Dokümandaki belirli bir konum.

JSON gösterimi 
{
  "segmentId": string,
  "index": integer
}
Alanlar
segmentId

string

Konumun bulunduğu üstbilgi, altbilgi veya dipnotun kimliği. Boş segment kimliği, dokümanın gövdesini belirtir.

index

integer

UTF-16 kod birimlerindeki sıfır tabanlı dizin.

Dizin, segmentId tarafından belirtilen segmentin başlangıcına bağlıdır.

SegmentKonumunun Sonu

Gövde, altbilgi, altbilgi veya dipnotun sonundaki konum. Konum, doküman segmentindeki son yeni satırdan hemen önce.

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

string

Konumun bulunduğu üstbilgi, altbilgi veya dipnotun kimliği. Boş segment kimliği, dokümanın gövdesini belirtir.

Metin Stili İsteğini Güncelle

Metnin stilini güncelleyin.

JSON gösterimi 
{
  "textStyle": {
    object (TextStyle)
  },
  "fields": string,

  // Union field insertion_location can be only one of the following:
  "range": {
    object (Range)
  }
  // End of list of possible types for union field insertion_location.
}
Alanlar
textStyle

object (TextStyle)

Metin üzerinde ayarlanacak stiller.

Belirli bir stilin değeri üst öğenin türüyle eşleşiyorsa bu stil devralınacak şekilde ayarlanır.

Bazı 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 TextStyle dokümanına bakın.

fields

string (FieldMask format)

Güncellenmesi gereken alanlar.

En az bir alan belirtilmelidir. textStyle kökü ima edilir ve belirtilmemelidir. Her bir alanı listelemek için tek bir "*" kullanılabilir.

Örneğin, metin stilini kalın olarak güncellemek için fields öğesini "bold" olarak ayarlayın.

Bir özelliği varsayılan değerine sıfırlamak için alan adını alan maskesine dahil edin ancak alanı ayarlanmamış olarak bırakın.

Birlik alanı insertion_location. Metin stilinin güncelleneceği aralığın türü. insertion_location aşağıdakilerden yalnızca biri olabilir:
range

object (Range)

Stil uygulanacak metin aralığı.

Aralık, bitişik yeni satırları içerecek şekilde genişletilebilir.

Aralıkta tam olarak bir listeye ait olan bir paragraf varsa, paragrafın madde işareti de eşleşen metin stiliyle güncellenir.

Aralıklar, göreli bir UpdateTextStyleRequest içinde eklenemez.

ParagraphBulletsRequest oluşturma

Belirli bir aralıkla çakışan tüm paragraflar için madde işaretleri oluşturur.

Her paragrafın iç içe yerleştirme seviyesi, her paragrafın önünde sıradaki sekmeler sayılarak belirlenir. Madde işareti ile karşılık gelen paragraf arasında fazla boşluk olmaması için bu öncü sekmeler bu istek tarafından kaldırılır. Bu, metnin bazı bölümlerinin dizinlerini değiştirebilir.

Paragrafların güncellenmesinden hemen önceki paragraf, eşleşen hazır ayara sahip bir listedeyse, güncellenen paragraflar bir önceki listeye eklenir.

JSON gösterimi 
{
  "range": {
    object (Range)
  },
  "bulletPreset": enum (BulletGlyphPreset)
}
Alanlar
range

object (Range)

Madde işareti hazır ayarının uygulanacağı aralık.

bulletPreset

enum (BulletGlyphPreset)

Kullanılacak madde işareti glif türleri.

BulletGlyphPreset

Listeler için madde işaretli karakterlerin hazır kalıpları.

Bu kalıplar aşağıdaki tür madde işaretlerini kullanı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 ok
  • CHECKBOX : Unicode U+274f kod noktasına karşılık gelen boş bir kare
  • CIRCLE : Unicode U+25cb kod noktasına karşılık gelen boş bir daire
  • DIAMOND : Unicode U+25c6 kod noktasına karşılık gelen sağlam bir elmas
  • DIAMONDX : Unicode U+2756 kod noktasına karşılık gelen, "x" işareti bulunan bir 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 düz bir kare
  • STAR : Unicode U+2605 kod noktasına karşılık gelen yıldız
  • ALPHA : "a", "b" veya "c" gibi küçük harf.
  • UPPERALPHA : "A", "B" veya "C" gibi büyük harfli bir harf.
  • DECIMAL : "1", "2" veya "3" gibi bir sayı.
  • ZERODECIMAL : Tek haneli sayıların önüne "01", "02" veya "03" gibi bir sayı gelen sayı. Birden fazla basamağı olan sayıların önüne sıfır eklenmez.
  • ROMAN : Küçük bir Roma rakamı (ör. "i", "ii" veya "iii").
  • UPPERROMAN : "I", "II" veya "III" gibi büyük bir Roma rakamı.
  • LEFTTRIANGLE : Unicode U+25c4 kod noktasına karşılık gelen, sola işaret eden bir üçgen
Sıralamalar
BULLET_GLYPH_PRESET_UNSPECIFIED Madde işareti ön ayarı belirtilmemiş.
BULLET_DISC_CIRCLE_SQUARE Listenin iç içe yerleştirme seviyeleri için DISC, CIRCLE ve SQUARE madde işaretiyle madde işaretli liste.
BULLET_DIAMONDX_ARROW3D_SQUARE Listenin iç içe yerleştirme seviyeleri için DIAMONDX, ARROW3D ve SQUARE madde işaretiyle madde işaretli liste.
BULLET_CHECKBOX Tüm liste iç içe yerleştirme seviyeleri için CHECKBOX madde işareti içeren madde işaretli bir liste.
BULLET_ARROW_DIAMOND_DISC Listenin iç içe yerleştirme seviyeleri için ARROW, DIAMOND ve DISC madde işaretiyle madde işaretli liste.
BULLET_STAR_CIRCLE_SQUARE Listenin iç içe yerleştirme seviyeleri için STAR, CIRCLE ve SQUARE madde işaretiyle madde işaretli liste.
BULLET_ARROW3D_CIRCLE_SQUARE Listenin iç içe yerleştirme seviyeleri için ARROW3D, CIRCLE ve SQUARE madde işaretiyle madde işaretli liste.
BULLET_LEFTTRIANGLE_DIAMOND_DISC Listenin iç içe yerleştirme seviyeleri için LEFTTRIANGLE, DIAMOND ve DISC madde işaretiyle madde işaretli liste.
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE Listenin iç içe yerleştirme seviyeleri için DIAMONDX, HOLLOWDIAMOND ve SQUARE madde işaretiyle madde işaretli liste.
BULLET_DIAMOND_CIRCLE_SQUARE Listenin iç içe yerleştirme seviyeleri için DIAMOND, CIRCLE ve SQUARE madde işaretiyle madde işaretli liste.
NUMBERED_DECIMAL_ALPHA_ROMAN İç içe yerleştirilmiş ilk 3 liste seviyesi için DECIMAL, ALPHA ve ROMAN sayısal glifleri içeren ve ardından nokta kullanılan bir numaralı liste.
NUMBERED_DECIMAL_ALPHA_ROMAN_PARENS Listenin iç içe yerleştirme seviyeleri için DECIMAL, ALPHA ve ROMAN sayısal gliften oluşan ve ardından parantezin eklendiği numaralı bir liste.
NUMBERED_DECIMAL_NESTED Noktalarla ayrılmış DECIMAL sayısal gliflere sahip numaralı bir liste. Burada her iç içe yerleştirme seviyesi bir önek olarak önceki iç içe yerleştirme seviyesi glifini kullanır. Örneğin: "1.", "1.1.", "2.", "2.2."
NUMBERED_UPPERALPHA_ALPHA_ROMAN İç içe yerleştirilmiş ilk 3 liste seviyesi için UPPERALPHA, ALPHA ve ROMAN sayısal glifleri içeren ve ardından nokta kullanılan bir numaralı liste.
NUMBERED_UPPERROMAN_UPPERALPHA_DECIMAL İç içe yerleştirilmiş ilk 3 liste seviyesi için UPPERROMAN, UPPERALPHA ve DECIMAL sayısal glifleri içeren ve ardından nokta kullanılan bir numaralı liste.
NUMBERED_ZERODECIMAL_ALPHA_ROMAN İç içe yerleştirilmiş ilk 3 liste seviyesi için ZERODECIMAL, ALPHA ve ROMAN sayısal glifleri içeren ve ardından nokta kullanılan bir numaralı liste.

ParagraphBulletsİsteği Sil

Belirli bir aralıkla çakışan tüm paragraflardaki madde işaretlerini siler.

Her paragrafın iç içe yerleştirme seviyesi, ilgili paragrafın başına girinti eklenerek görsel olarak korunur.

JSON gösterimi 
{
  "range": {
    object (Range)
  }
}
Alanlar
range

object (Range)

Maddelerin silineceği aralık.

CreateNamedRangeRequest oluşturma

Belirtilen aralığa başvuruda bulunan bir NamedRange oluşturur.

JSON gösterimi 
{
  "name": string,
  "range": {
    object (Range)
  }
}
Alanlar
name

string

NamedRange'in adı. Adların benzersiz olması gerekmez.

Adlar, UTF-16 kod birimlerinde ölçülen en az 1 ve 256 karakterden uzun olmamalıdır.

range

object (Range)

Adın uygulanacağı aralık.

DeleteNamedRange İsteği

Bir NamedRange öğesini siler.

JSON gösterimi 
{

  // Union field named_range_reference can be only one of the following:
  "namedRangeId": string,
  "name": string
  // End of list of possible types for union field named_range_reference.
}
Alanlar
Birlik 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 aşağıdakilerden yalnızca biri olabilir:
namedRangeId

string

Silinecek adlandırılmış aralığın kimliği.

name

string

Silinecek aralıkların adı. Belirtilen ada sahip tüm adlandırılmış aralıklar silinir.

Güncelleme ParagraphStyleRequest

Belirtilen aralıkla çakışan tüm paragrafların stilini güncelleyin.

JSON gösterimi 
{
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "fields": string,

  // Union field insertion_location can be only one of the following:
  "range": {
    object (Range)
  }
  // End of list of possible types for union field insertion_location.
}
Alanlar
paragraphStyle

object (ParagraphStyle)

Paragraflarda ayarlanacak stiller.

Paragraf stilinde yapılan bazı değişiklikler, Dokümanlar düzenleyicisinin davranışını yansıtmak için başka değişikliklere neden olabilir. Daha fazla bilgi için ParagraphStyle dokümanına bakın.

fields

string (FieldMask format)

Güncellenmesi gereken alanlar.

En az bir alan belirtilmelidir. paragraphStyle kökü ima edilir ve belirtilmemelidir. Her bir alanı listelemek için tek bir "*" kullanılabilir.

Örneğin, paragraf stilinin hizalama özelliğini güncellemek için fields değerini "alignment" olarak ayarlayın.

Bir özelliği varsayılan değerine sıfırlamak için alan adını alan maskesine dahil edin ancak alanı ayarlanmamış olarak bırakın.

Birlik alanı insertion_location. Paragraf stilinin güncelleneceği aralık türü. insertion_location aşağıdakilerden yalnızca biri olabilir:
range

object (Range)

Paragrafların stil sunulacak şekilde çakışması.

SilİçerikArası İsteği

Dokümandaki içeriği siler.

JSON gösterimi 
{
  "range": {
    object (Range)
  }
}
Alanlar
range

object (Range)

Silinecek içerik aralığı.

Paragraf sınırını aşan metinlerin silinmesi, iki paragraf birleştirildiğinde paragraf stillerinde, listelerde, konumlandırılmış nesnelerde ve yer işaretlerinde değişikliklere neden olabilir.

Belirli aralıkların silinmeye çalışılması 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:

Satır içi resim isteği ekle

Belirtilen konumda resim içeren bir InlineObject ekler.

JSON gösterimi 
{
  "uri": string,
  "objectSize": {
    object (Size)
  },

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
Alanlar
uri

string

Resim URI'si.

Resim, ekleme sırasında bir kez getirilir ve bir kopyası, dokümanın içinde görüntülenmek üzere depolanır. Resimlerin boyutu 50 MB'tan küçük olmalı, 25 megapikseli aşmamalı ve PNG, JPEG veya GIF biçiminde olmalıdır.

Sağlanan URI, herkes tarafından erişilebilir ve en fazla 2 kB uzunluğunda olmalıdır. URI'nın kendisi, resimle birlikte kaydedilir ve ImageProperties.content_uri alanı üzerinden gösterilir.

objectSize

object (Size)

Resmin dokümanda görünmesi gereken boyut. Bu özellik isteğe bağlıdır ve dokümandaki resmin son boyutu aşağıdaki kurallarla belirlenir: * Genişlik veya yükseklik belirtilmemişse resmin çözünürlüğüne göre varsayılan boyut hesaplanır. * Bir boyut belirtilmişse 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ı korunurken sağlanan boyutlara sığacak şekilde ölçeklendirilir.

Birlik alanı insertion_location. Resmin ekleneceği konum. insertion_location aşağıdakilerden yalnızca biri olabilir:
location

object (Location)

Resmi, dokümandaki belirli bir dizine ekler.

Resim, mevcut bir Paragraph öğesinin sınırlarına eklenmelidir. Örneğin, bir tablonun başlangıç dizinine (tablo ile önceki paragraf arasına) eklenemez.

Satır içi resimler dipnot veya denklemin içine eklenemez.

endOfSegmentLocation

object (EndOfSegmentLocation)

Metni bir üstbilginin, altbilginin veya doküman gövdesinin sonuna ekler.

Satır içi resimler dipnota eklenemez.

Tablo İsteği Ekle

Belirtilen konuma bir tablo ekler.

Eklenen tablonun önüne yeni bir satır karakteri eklenecek.

JSON gösterimi 
{
  "rows": integer,
  "columns": integer,

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
Alanlar
rows

integer

Tablodaki satır sayısı.

columns

integer

Tablodaki sütun sayısı.

Birlik alanı insertion_location. Tablonun ekleneceği konum. insertion_location aşağıdakilerden yalnızca biri olabilir:
location

object (Location)

Tabloyu belirli bir model dizinine ekler.

Eklenen tablodan önce bir yeni satır karakteri eklenir. Bu nedenle, tablo başlangıç dizini, belirtilen konum dizininde + 1'de olur.

Tablo mevcut bir Paragraph öğesinin sınırları içine eklenmelidir. Örneğin, bir tablonun başlangıç dizinine (ör. mevcut bir tablonun ve onun önceki paragrafının arasına) eklenemez.

Tablolar dipnot veya denklemin içine eklenemez.

endOfSegmentLocation

object (EndOfSegmentLocation)

Tabloyu, verilen üstbilginin, altbilginin veya doküman gövdesinin sonuna ekler. Eklenen tablonun önüne yeni bir satır karakteri eklenecek.

Tablolar dipnot içine eklenemez.

TableRowRequest'i Ekleme

Tabloya boş bir satır ekler.

JSON gösterimi 
{
  "tableCellLocation": {
    object (TableCellLocation)
  },
  "insertBelow": boolean
}
Alanlar
tableCellLocation

object (TableCellLocation)

Satırların ekleneceği referans tablosu hücre konumu.

Referans hücrenin bulunduğu satırın yukarısına (veya altına) yeni bir satır eklenir. Referans hücre, birleştirilen hücreyse birleştirilmiş hücrenin üstüne (veya altına) yeni bir satır eklenir.

insertBelow

boolean

Referans hücre konumunun altına yeni satır eklenip eklenmeyeceğini belirtir.

  • True : Hücrenin altına ekleyin.
  • False : Hücrenin üstüne ekler.

TabloHücreKonumu

Tablodaki tek bir hücrenin konumu.

JSON gösterimi 
{
  "tableStartLocation": {
    object (Location)
  },
  "rowIndex": integer,
  "columnIndex": integer
}
Alanlar
tableStartLocation

object (Location)

Dokümanda tablonun başladığı konum.

rowIndex

integer

Sıfır tabanlı satır dizini. Örneğin, tablodaki ikinci satırın 1'lik satır dizini vardır.

columnIndex

integer

Sıfır tabanlı sütun dizini. Örneğin, tablodaki ikinci sütunun 1 sütun dizini vardır.

TabloSütun İsteği Ekle

Tabloya boş bir sütun ekler.

JSON gösterimi 
{
  "tableCellLocation": {
    object (TableCellLocation)
  },
  "insertRight": boolean
}
Alanlar
tableCellLocation

object (TableCellLocation)

Sütunların ekleneceği referans tablosu hücre konumu.

Referans hücrenin olduğu sütunun sol (veya sağ) bölümüne yeni bir sütun eklenir. Referans hücre, birleştirilen hücreyse yenileştirilen hücrenin soluna (veya sağına) yeni bir sütun eklenir.

insertRight

boolean

Referans hücre konumunun sağına yeni sütun eklenip eklenmeyeceğini belirtir.

  • True : Sağa ekleyin.
  • False : sola ekleyin.

TableRowRequest'i Sil

Tablodaki bir satırı siler.

JSON gösterimi 
{
  "tableCellLocation": {
    object (TableCellLocation)
  }
}
Alanlar
tableCellLocation

object (TableCellLocation)

Satırın silineceği referans tablosu hücre konumu.

Bu hücrenin yayıldığı satır silinir. Bu, birden çok satırı kapsayan birleştirilmiş bir hücreyse hücrenin yayıldığı tüm satırlar silinir. Bu silme işleminden sonra tabloda hiçbir satır kalmazsa tüm tablo silinir.

TabloSütun İsteğini Sil

Tablodaki bir sütunu siler.

JSON gösterimi 
{
  "tableCellLocation": {
    object (TableCellLocation)
  }
}
Alanlar
tableCellLocation

object (TableCellLocation)

Sütunun silineceği referans tablosu hücre konumu.

Bu hücrenin yaydığı sütun silinir. Bu, birden çok sütunu kapsayan birleştirilmiş bir hücreyse hücrenin yaydığı tüm sütunlar silinir. Bu silme işleminden sonra tabloda hiçbir sütun kalmazsa tüm tablo silinir.

InsertPageBreakRequest

Belirtilen konumda bir satır sonu ve yeni bir satır ekler.

JSON gösterimi 
{

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
Alanlar
Birlik alanı insertion_location. Sayfa sonunun ekleneceği konum. insertion_location aşağıdakilerden yalnızca biri olabilir:
location

object (Location)

Sayfa sonunu dokümandaki belirli bir dizine ekler.

Sayfa sonu, mevcut bir Paragraph öğesinin sınırlarına eklenmelidir. Örneğin, bir tablonun başlangıç dizinine (tablo ile önceki paragraf arasına) eklenemez.

Sayfa sonları bir tablo, denklem, dipnot, üstbilgi veya altbilgiye eklenemez. Sayfa sonları yalnızca gövde içine girilebildiğinden segment ID alanı boş olmalıdır.

endOfSegmentLocation

object (EndOfSegmentLocation)

Belge gövdesinin sonuna sayfa sonu ekler.

Dipnot, üstbilgi veya altbilginin içine sayfa sonu eklenemez. Sayfa sonları yalnızca gövde içine girilebildiğinden segment ID alanı boş olmalıdır.

Konumlandırma Nesne İsteğini Sil

Dokümandaki bir PositionedObject öğesini siler.

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

string

Silinecek konumlandırılmış nesnenin kimliği.

TabloSütun Özellik İsteğini Güncelle

Tablodaki TableColumnProperties sütunu günceller.

JSON gösterimi 
{
  "tableStartLocation": {
    object (Location)
  },
  "columnIndices": [
    integer
  ],
  "tableColumnProperties": {
    object (TableColumnProperties)
  },
  "fields": string
}
Alanlar
tableStartLocation

object (Location)

Dokümanda tablonun başladığı konum.

columnIndices[]

integer

Mülkün güncellenmesi gereken sıfır temelli sütun dizinlerinin listesi. Herhangi bir dizin belirtilmezse tüm sütunlar güncellenir.

tableColumnProperties

object (TableColumnProperties)

Güncellenecek tablo sütunu özellikleri.

tableColumnProperties#width değeri 5 puandan (5/72 inç) küçükse 400 hatalı istek hatası döndürülür.

fields

string (FieldMask format)

Güncellenmesi gereken alanlar.

En az bir alan belirtilmelidir. tableColumnProperties kökü ima edilir ve belirtilmemelidir. Her bir alanı listelemek için tek bir "*" kullanılabilir.

Örneğin, sütun genişliğini güncellemek için fields değerini "width" olarak ayarlayın.

TableTableStyleStyle Güncelleme Güncelleme

Tablo hücre aralığının stilini günceller.

JSON gösterimi 
{
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "fields": string,

  // Union field cells can be only one of the following:
  "tableRange": {
    object (TableRange)
  },
  "tableStartLocation": {
    object (Location)
  }
  // End of list of possible types for union field cells.
}
Alanlar
tableCellStyle

object (TableCellStyle)

Tablo hücreleri üzerinde ayarlanacak stil.

Kenarlıklar güncellenirken, bir hücre bitişik bir hücreyle kenarlık paylaşırsa bitişik hücrenin ilgili kenarlık özelliği de güncellenir. Birleştirilen ve görünmeyen kenarlıklar güncellenmez.

Aynı istekte bitişik hücreler tarafından paylaşılan bir sınırın güncellenmesi, kenarlık güncellemelerinin çakışmasına neden olabileceği için kenarlık güncellemeleri aşağıdaki sırayla uygulanır:

  • borderRight
  • borderLeft
  • borderBottom
  • borderTop
fields

string (FieldMask format)

Güncellenmesi gereken alanlar.

En az bir alan belirtilmelidir. tableCellStyle kökü ima edilir ve belirtilmemelidir. Her bir alanı listelemek için tek bir "*" kullanılabilir.

Örneğin, tablo hücresi arka plan rengini güncellemek için fields değerini "backgroundColor" olarak ayarlayın.

Bir özelliği varsayılan değerine sıfırlamak için alan adını alan maskesine dahil edin ancak alanı ayarlanmamış olarak bırakın.

Birlik alanı cells. Güncellenecek hücreler. cells aşağıdakilerden yalnızca biri olabilir:
tableRange

object (TableRange)

Güncellemelerin uygulandığı tablonun alt kümesini temsil eden tablo aralığı.

tableStartLocation

object (Location)

Dokümanda tablonun başladığı konum. Belirtildiğinde, güncellemeler tablodaki tüm hücrelere uygulanır.

TabloAralığı

Tablo aralığı, tablonun bir alt kümesine yapılan referansı temsil eder.

Tablo aralığı tarafından belirtilen hücrelerin mutlaka bir dikdörtgen oluşturmadığını unutmayın. Örneğin, son satırdaki tüm hücrelerin birleştirildiği 3x3 boyutunda bir tablomuz olduğunu varsayalım. Tablo aşağıdaki gibi görünür: 

 [   ][   ][   ]
 [   ][   ][   ]
 [             ]

Tablo hücre konumu = (tableStartLocation, satır = 0, sütun = 0), satır aralığı = 3 ve sütun aralığı = 2 olan bir tablo aralığı aşağıdaki hücreleri belirtir: 

 [ x ][ x ][   ]
 [ x ][ x ][   ]
 [ x    x    x ]
JSON gösterimi 
{
  "tableCellLocation": {
    object (TableCellLocation)
  },
  "rowSpan": integer,
  "columnSpan": integer
}
Alanlar
tableCellLocation

object (TableCellLocation)

Tablo aralığının başladığı hücre konumu.

rowSpan

integer

Tablo aralığının satır aralığı.

columnSpan

integer

Tablo aralığının sütun kapsamı.

TableRowStyleRequest Güncelleme

Tablodaki TableRowStyle satırı günceller.

JSON gösterimi 
{
  "tableStartLocation": {
    object (Location)
  },
  "rowIndices": [
    integer
  ],
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "fields": string
}
Alanlar
tableStartLocation

object (Location)

Dokümanda tablonun başladığı konum.

rowIndices[]

integer

Stilinin güncellenmesi gereken sıfır tabanlı satır dizinlerinin listesi. Herhangi bir dizin belirtilmezse tüm satırlar güncellenir.

tableRowStyle

object (TableRowStyle)

Satırlarda ayarlanacak stiller.

fields

string (FieldMask format)

Güncellenmesi gereken alanlar.

En az bir alan belirtilmelidir. tableRowStyle kökü ima edilir ve belirtilmemelidir. Her bir alanı listelemek için tek bir "*" kullanılabilir.

Örneğin, minimum satır yüksekliğini güncellemek için fields değerini "minRowHeight" olarak ayarlayın.

Resim Değiştirme

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 bazı image effects öğeleri mevcut resimden kaldırılır.

JSON gösterimi 
{
  "imageObjectId": string,
  "uri": string,
  "imageReplaceMethod": enum (ImageReplaceMethod)
}
Alanlar
imageObjectId

string

Değiştirilecek mevcut resmin kimliği. Kimlik, bir alma isteğinin yanıtından alınabilir.

uri

string

Yeni resmin URI'si.

Resim, ekleme sırasında bir kez getirilir ve bir kopyası, dokümanın içinde görüntülenmek üzere depolanır. Resimler 50 MB'tan küçük, 25 megapikselden büyük olmamalı ve PNG, JPEG veya GIF biçiminde olmalıdır.

Sağlanan URI, 2 KB'tan uzun olamaz. URI, resimle birlikte kaydedilir ve ImageProperties.source_uri alanı üzerinden gösterilir.

imageReplaceMethod

enum (ImageReplaceMethod)

Değiştirme yöntemi.

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 ölçeklendirir ve orijinal resmin sınırlarını dolduracak şekilde ortalar. Resim, orijinal resmin sınırlarını dolduracak şekilde kırpılabilir. Resmin oluşturma boyutu, orijinal resimle aynı olur.

Belge Stili İsteğini Güncelleme

DocumentStyle güncellenir.

JSON gösterimi 
{
  "documentStyle": {
    object (DocumentStyle)
  },
  "fields": string
}
Alanlar
documentStyle

object (DocumentStyle)

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 DocumentStyle dokümanına bakın.

fields

string (FieldMask format)

Güncellenmesi gereken alanlar.

En az bir alan belirtilmelidir. documentStyle kökü ima edilir ve belirtilmemelidir. Her bir alanı listelemek için tek bir "*" kullanılabilir.

Örneğin, arka planı güncellemek için fields özelliğini "background" olarak ayarlayın.

MergeTableCellsİsteği

Table içindeki hücreleri birleştirir.

JSON gösterimi 
{
  "tableRange": {
    object (TableRange)
  }
}
Alanlar
tableRange

object (TableRange)

Tablonun hangi hücrelerinin birleştirileceğini belirten tablo aralığı.

Birleştirilen hücrelerdeki tüm metinler birleştirilir ve aralığın "baş" hücresinde depolanır. Bu, içerik yönü soldan sağa doğru değiştiğinden aralığın sol üst hücresidir.

Aralık dikdörtgen olmamalıdır (bu, aralığın zaten birleştirilmiş olan veya tablo dikdörtgen olmayan hücreleri kapsadığı durumlarda ortaya çıkabilir) 400 hatalı istek hatası döndürülür.

UnmergeTableCellsRequest isteği

Table içindeki hücreleri ayırır.

JSON gösterimi 
{
  "tableRange": {
    object (TableRange)
  }
}
Alanlar
tableRange

object (TableRange)

Tablonun hangi hücrelerinin birleştirileceğini belirten tablo aralığı.

Bu aralıktaki birleştirilen tüm hücreler birleştirilir ve halihazırda birleştirilen hücreler etkilenmez. Aralıkta birleştirilmiş hücre yoksa istek hiçbir şey yapmaz.

Birleştirilmiş hücrelerden herhangi birinde metin varsa bu metin, ortaya çıkan birleştirilmemiş hücre bloğunun "baş" hücresinde kalır. "Baş" hücresi, içerik yönü soldan sağa doğru kullanıldığında sol üstteki hücredir.

Başlık İsteği Oluştur

Header oluşturur. Belirtilirse yeni başlık, SectionStyle öğesine SectionBreak konumunda uygulanır. Aksi takdirde DocumentStyle öğesine uygulanır.

Belirtilen türde bir üstbilgi zaten varsa 400 hatalı istek hatası döndürülür.

JSON gösterimi 
{
  "type": enum (HeaderFooterType),
  "sectionBreakLocation": {
    object (Location)
  }
}
Alanlar
type

enum (HeaderFooterType)

Oluşturulacak üstbilginin türü.

sectionBreakLocation

object (Location)

Bu başlığın ait olduğu bölümün başlangıcını yapan SectionBreak öğesinin konumu. "sectionBreakLocation" ayarlanmazsa veya doküman gövdesindeki ilk bölüm sonuna atıfta bulunursa başlık DocumentStyle için geçerli olur

BaşlıkAltbilgiTürü

Oluşturulabilecek üstbilgi ve altbilgi türleri.

Sıralamalar
DEFAULT Varsayılan üstbilgi/altbilgi.

Altbilgi İsteği Oluştur

Footer oluşturur. Belirtilirse yeni altbilgi SectionStyle öğesine SectionBreak konumunda uygulanır. Aksi takdirde DocumentStyle öğesine uygulanır.

Belirtilen türde bir altbilgi zaten varsa 400 hatalı istek hatası döndürülür.

JSON gösterimi 
{
  "type": enum (HeaderFooterType),
  "sectionBreakLocation": {
    object (Location)
  }
}
Alanlar
type

enum (HeaderFooterType)

Oluşturulacak altbilginin türü.

sectionBreakLocation

object (Location)

Bu altbilginin ait olması gereken bölümün hemen önündeki SectionBreak konumu.SectionStyle Bu politika ayarlanmazsa veya dokümandaki ilk bölüm sonuna atıfta bulunursa altbilgi, doküman stili için geçerli olur.

Dipnot Oluşturma İsteği

Footnote segmenti oluşturur ve belirtilen konumda bu segmente yeni bir FootnoteReference ekler.

Yeni Footnote segmentinde, boşluk ve ardından yeni satır karakteri bulunur.

JSON gösterimi 
{

  // Union field footnote_reference_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field footnote_reference_location.
}
Alanlar
Birlik alanı footnote_reference_location. Dipnot referansının ekleneceği konum. footnote_reference_location aşağıdakilerden yalnızca biri olabilir:
location

object (Location)

Dipnot referansını dokümandaki belirli bir dizine ekler.

Dipnot başvurusu, mevcut bir Paragraph öğesinin sınırlarına eklenmelidir. Örneğin, bir tablonun başlangıç dizinine (tablo ile önceki paragraf arasına) eklenemez.

Dipnot referansları bir denklem, üstbilgi, altbilgi veya dipnota eklenemez. Dipnot referansları yalnızca gövdeye eklenebildiğinden segment ID alanı boş olmalıdır.

endOfSegmentLocation

object (EndOfSegmentLocation)

Doküman gövdesinin sonuna dipnot referansını ekler.

Dipnot referansları üstbilgi, altbilgi veya dipnot içine eklenemez. Dipnot referansları yalnızca gövdeye eklenebildiğinden segment ID alanı boş olmalıdır.

AdlandırılmışAralığıİçerik İsteğini Değiştir

Belirtilen NamedRange veya NamedRanges içeriğini belirtilen değişim içeriğiyle değiştirir.

Tek bir NamedRange öğesinin, birden fazla süregelen ranges içeriyor olabileceğini unutmayın. Bu durumda, yalnızca ilk aralıktaki içerik değiştirilir. Diğer aralıklar ve içindekiler silinir.

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 
{

  // Union field replacement_content can be only one of the following:
  "text": string
  // End of list of possible types for union field replacement_content.

  // Union field named_range_reference can be only one of the following:
  "namedRangeId": string,
  "namedRangeName": string
  // End of list of possible types for union field named_range_reference.
}
Alanlar
Birlik alanı replacement_content. Adlandırılmış aralığın mevcut içeriğiyle değiştirilecek içerik. replacement_content aşağıdakilerden yalnızca biri olabilir:
text

string

Belirtilen adlandırılmış aralıkların içeriğini verilen metinle değiştirir.

Birlik alanı named_range_reference. İçeriği değiştirilecek adlandırılmış aralıklara yapılan bir referans. named_range_reference aşağıdakilerden yalnızca biri olabilir:
namedRangeId

string

İçeriği değiştirilecek adlandırılmış aralığın kimliği.

Belirtilen kimliğe sahip bir adlandırılmış aralık yoksa 400 hatalı istek hatası döndürülür.

namedRangeName

string

İçeriği değiştirilecek NamedRanges öğesinin adı.

Belirtilen ada sahip birden fazla named ranges varsa her birinin içeriği değiştirilir. Belirtilen ada sahip bir adlandırılmış aralık yoksa istek işlemsiz olur.

GüncellemeSectionStyleRequest

SectionStyle güncellenir.

JSON gösterimi 
{
  "range": {
    object (Range)
  },
  "sectionStyle": {
    object (SectionStyle)
  },
  "fields": string
}
Alanlar
range

object (Range)

Stilin parçalarla çakıştığı aralık.

Bölüm sonları yalnızca gövde içine yerleştirilebildiğinden segment ID alanı boş olmalıdır.

sectionStyle

object (SectionStyle)

Bölümde ayarlanacak stiller.

Bazı 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 SectionStyle dokümanına bakın.

fields

string (FieldMask format)

Güncellenmesi gereken alanlar.

En az bir alan belirtilmelidir. sectionStyle kökü ima edilir ve belirtilmemelidir. Her bir alanı listelemek için tek bir "*" kullanılabilir.

Örneğin, sol kenar boşluğunu güncellemek için fields öğesini "marginLeft" olarak ayarlayın.

InsertSectionBreakRequest

Belirtilen konuma bir bölüm sonu ekler.

Bölüm sonundan önce yeni satır karakteri eklenecek.

JSON gösterimi 
{
  "sectionType": enum (SectionType),

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
Alanlar
sectionType

enum (SectionType)

Eklenecek bölümün türü.

Birlik alanı insertion_location. Aranın ekleneceği konum. insertion_location aşağıdakilerden yalnızca biri olabilir:
location

object (Location)

Dokümanda belirli bir dizine yeni satır ve bölüm sonu ekler.

Bölüm sonu, mevcut bir Paragraph sınırları içine eklenmelidir. Örneğin, bir tablonun başlangıç dizinine (tablo ile önceki paragraf arasına) eklenemez.

Tablo, denklem, dipnot, üstbilgi veya altbilgiye bölüm sonu eklenemez. Bölüm sonları yalnızca gövde içine eklenebileceğinden segment ID alanı boş olmalıdır.

endOfSegmentLocation

object (EndOfSegmentLocation)

Doküman gövdesinin sonuna yeni bir satır ve bölüm sonu ekler.

Dipnot, üstbilgi veya altbilginin içine bölüm sonu eklenemez. Bölüm sonları yalnızca gövde içine yerleştirilebildiğinden segment ID alanı boş olmalıdır.

Başlık İsteğini Sil

Dokümandaki bir Header öğesini siler.

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

string

Silinecek başlığın kimliği. Bu üstbilgi DocumentStyle öğesinde tanımlanmışsa bu üstbilgiye yapılan referans kaldırılır ve dokümanın ilk bölümü için bu tür bir başlık oluşturulmaz. Bu üstbilgi bir SectionStyle öğesinde tanımlanıyorsa bu başlığa yapılan referans kaldırılır ve bu türden bir başlık artık önceki bölümden devam eder.

Altbilgi İsteğini Sil

Dokümandaki bir Footer öğesini siler.

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

string

Silinecek altbilginin kimliği. Bu altbilgi DocumentStyle ürününde tanımlanırsa bu altbilgiye ilişkin referans kaldırılır. Bu sayede dokümanın ilk bölümü için söz konusu altbilgi bulunmaz. Bu altbilgi bir SectionStyle ürününde tanımlanıyorsa bu altbilgiye yapılan referans kaldırılır ve bu türden altbilgiye artık önceki bölümden devam edilir.

PinTableHeaderRows İsteği

Bir tablodaki sabitlenmiş tablo başlığı satırlarının sayısını günceller.

JSON gösterimi 
{
  "tableStartLocation": {
    object (Location)
  },
  "pinnedHeaderRowsCount": integer
}
Alanlar
tableStartLocation

object (Location)

Dokümanda tablonun başladığı konum.

pinnedHeaderRowsCount

integer

Sabitlenecek tablo satırlarının sayısı. 0 değeri, tüm satırların sabitlemesinin kaldırıldığını gösterir.