Requests

İstek

Bir belgeye 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)
  },
  "insertPerson": {
    object (InsertPersonRequest)
  }
  // End of list of possible types for union field request.
}
Alanlar
Birleşik alan request. Uygulanacak özel istek. Tam olarak bir alan gereklidir. 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)

Belirtilen aralıktaki metin stilini 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)

Belirtilen aralıktaki paragraf stilini günceller.

deleteContentRange

object (DeleteContentRangeRequest)

Dokümandaki içeriği siler.

insertInlineImage

object (InsertInlineImageRequest)

Belirtilen konuma satır içi resim ekler.

insertTable

object (InsertTableRequest)

Belirtilen konuma 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)

Tablodan sütun siler.

insertPageBreak

object (InsertPageBreakRequest)

Belirtilen konuma sayfa sonu ekler.

deletePositionedObject

object (DeletePositionedObjectRequest)

Konumlandırılmış bir nesneyi belgeden siler.

updateTableColumnProperties

object (UpdateTableColumnPropertiesRequest)

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)

Belgenin stilini günceller.

mergeTableCells

object (MergeTableCellsRequest)

Tablodaki hücreleri birleştirir.

unmergeTableCells

object (UnmergeTableCellsRequest)

Tablodaki hücrelerin birleştirmesini kaldırır.

createHeader

object (CreateHeaderRequest)

Başlık oluşturur.

createFootnote

object (CreateFootnoteRequest)

Dipnot oluşturur.

replaceNamedRangeContent

object (ReplaceNamedRangeContentRequest)

Adlandırılmış bir 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 bölüm sonu ekler.

deleteHeader

object (DeleteHeaderRequest)

Dokümandaki bir üstbilgiyi siler.

pinTableHeaderRows

object (PinTableHeaderRowsRequest)

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

insertPerson

object (InsertPersonRequest)

Kullanıcı bahsetme ekler.

ReplaceAllTextRequest

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

JSON gösterimi 
{
  "replaceText": string,
  "tabsCriteria": {
    object (TabsCriteria)
  },

  // 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 yerine geçecek metin.

tabsCriteria

object (TabsCriteria)

İsteğe bağlıdır. Değiştirmenin hangi sekmelerde gerçekleşeceğini belirtmek için kullanılan ölçütler.

Atlandığında değiştirme işlemi tüm sekmeler için geçerli olur.

Tek sekme içeren bir dokümanda:

  • Sağlanması durumunda, tekil sekmenin kimliğiyle eşleşmelidir.

  • Atlanırsa değiştirme işlemi tekil sekme için geçerli olur.

Birden fazla sekme içeren bir dokümanda:

  • Sağlanırsa değiştirme işlemi belirtilen sekmelere uygulanır.

  • Atlanırsa değiştirme işlemi tüm sekmeler için geçerli olur.

Birleşik alan criteria. 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.

SubstringMatchCriteria

Belgedeki belirli bir metin dizesiyle eşleşen ölçüt.

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

string

Dokümanda aranacak metin.

matchCase

boolean

Aramada büyük/küçük harf duyarlılığı olup olmayacağını gösterir:

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

boolean

İsteğe bağlıdır. Bulunan değerin normal ifade olarak değerlendirilmesi gerekiyorsa doğru. Kalıptaki tüm ters eğik çizgiler kod dışına alınmalıdır.

  • True : Arama metni normal ifade olarak değerlendirilir.
  • False : Arama metni, eşleştirme için alt dize olarak değerlendirilir.

TabsCriteria

Bir isteğin hangi sekmelerde yürütüleceğini belirten bir ölçüt.

JSON gösterimi 
{
  "tabIds": [
    string
  ]
}
Alanlar
tabIds[]

string

İsteğin yürütüldüğü sekme kimliklerinin listesi.

InsertTextRequest

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.

Yeni satır karakteri eklemek, söz konusu dizinde yeni bir Paragraph oluşturur. Yeni paragrafın paragraf stili, listeler ve madde işaretleri de dahil olmak üzere mevcut ekleme dizinindeki paragraftan kopyalanır.

Eklenen metinlerin metin stilleri otomatik olarak belirlenir ve genellikle komşu metinlerin 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 çıkarılır.

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

object (Location)

Metni dokümanda belirli bir dizine ekler.

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

endOfSegmentLocation

object (EndOfSegmentLocation)

Metni üstbilgi, altbilgi, dipnot veya belge gövdesinin sonuna ekler.

Konum

Belgedeki belirli bir konum.

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

string

Konumun bulunduğu üstbilgi, altbilgi veya dipnotun kimliği. Boş bir segment kimliği, belgenin gövdesini ifade eder.

index

integer

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

Dizin, segmentId ile belirtilen segmentin başlangıcına göre belirlenir.

tabId

string

Konumun bulunduğu sekme. Atlandığında istek ilk sekme için geçerli olur.

Tek sekme içeren bir dokümanda:

  • Sağlanması durumunda, tekil sekmenin kimliğiyle eşleşmelidir.

  • Atlanırsa istek tekil sekme için geçerli olur.

Birden fazla sekme içeren bir dokümanda:

  • Belirtilmişse istek, belirtilen sekme için geçerlidir.

  • Atlanırsa istek, dokümandaki ilk sekme için geçerli olur.

EndOfSegmentLocation

Gövde, üstbilgi, altbilgi veya dipnotun sonundaki konum. Konum, belge segmentindeki son yeni satırdan hemen önce olmalıdır.

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

string

Konumun bulunduğu üstbilgi, altbilgi veya dipnotun kimliği. Boş bir segment kimliği, belgenin gövdesini ifade eder.

tabId

string

Konumun bulunduğu sekme. Atlandığında istek ilk sekme için geçerli olur.

Tek sekme içeren bir dokümanda:

  • Sağlanması durumunda, tekil sekmenin kimliğiyle eşleşmelidir.

  • Atlanırsa istek tekil sekme için geçerli olur.

Birden fazla sekme içeren bir dokümanda:

  • Belirtilmişse istek, belirtilen sekme için geçerlidir.

  • Atlanırsa istek, dokümandaki ilk sekme için geçerli olur.

UpdateTextStyleRequest

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

Metinde ayarlanacak stiller.

Belirli bir stilin değeri üst öğenin değeriyle eşleşiyorsa bu stil, devralma olarak 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 TextStyle belgelerini inceleyin.

fields

string (FieldMask format)

Güncellenmesi gereken alanlar.

En az bir alan belirtilmelidir. Kök textStyle örtülüdür ve belirtilmemelidir. Her alanı listelemek için kısaltma olarak tek bir "*" kullanılabilir.

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

Bir mülkü varsayılan değerine sıfırlamak için alan adını alan maskesine ekleyin ancak alanı ayarlanmamış olarak bırakın.

Birleşik 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ık, bir listeye ait olan bir paragrafı tamamen içeriyorsa paragrafın madde işareti de eşleşen metin stiliyle güncellenir.

Aralıklar, göreceli bir UpdateTextStyleRequest'in içine eklenemez.

CreateParagraphBulletsRequest

Belirtilen aralıkla çakışan 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 baştaki sekmeler sayılarak belirlenir. Madde işareti ile ilgili paragraf arasında fazla boşluk olmaması için bu istekte baştaki sekmeler kaldırılır. Bu durum, metnin bazı bölümlerinin dizinlerini değiştirebilir.

Güncellenen paragraflardan hemen önceki paragraf, eşleşen bir hazır ayarın bulunduğu listedeyse güncellenen paragraflar bu ö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 glifleri.

BulletGlyphPreset

Listeler için madde işareti gliflerinin hazır kalıpları.

Bu kalıplarda aşağıdaki 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ölgeli 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 boş bir daire
  • DIAMOND : Unicode U+25c6 kod noktasına karşılık gelen dolu elmas
  • DIAMONDX : Unicode U+2756 kod noktasına karşılık gelen, içinde "x" 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 dolu daire
  • SQUARE : Unicode U+25a0 kod noktasına karşılık gelen dolu bir 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 harf.
  • DECIMAL : "1", "2" veya "3" gibi bir sayı.
  • ZERODECIMAL : Tek haneli sayıların önüne sıfır eklenerek oluşturulan sayılar (ör. "01", "02" veya "03"). Birden fazla rakam içeren sayılara sıfır öneki eklenmez.
  • ROMAN : "i", "ii" veya "iii" gibi küçük harfli bir Roma rakamı.
  • UPPERROMAN : "I", "II" veya "III" gibi büyük harfli bir Roma rakamı.
  • LEFTTRIANGLE : Sola bakan bir üçgen, Unicode U+25c4 kod noktasına karşılık gelir.
Sıralamalar
BULLET_GLYPH_PRESET_UNSPECIFIED Madde işareti glif hazır ayarı belirtilmemiş.
BULLET_DISC_CIRCLE_SQUARE İlk 3 liste iç içe yerleştirme seviyesi için DISC, CIRCLE ve SQUARE madde işaretli liste glifi içeren bir 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şaretli liste glifi içeren bir madde işaretli liste.
BULLET_CHECKBOX Tüm liste iç içe yerleştirme seviyeleri için CHECKBOX madde işaretli glifler içeren 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şaretli liste glifi içeren 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şaretli liste glifi içeren 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şaretli liste glifi içeren 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şaretli liste glifi içeren 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şaretli liste glifi içeren 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şaretli liste glifi içeren bir madde işaretli liste.
NUMBERED_DECIMAL_ALPHA_ROMAN Aşağıdaki öğeleri içeren numaralı bir liste: DECIMAL, ALPHA ve ROMAN İlk 3 liste iç içe yerleştirme seviyesi için sayısal glifler ve ardından noktalar.
NUMBERED_DECIMAL_ALPHA_ROMAN_PARENS Aşağıdaki öğeleri içeren numaralı bir liste: DECIMAL, ALPHA ve ROMAN İlk 3 liste iç içe yerleştirme seviyesi için sayısal glifler ve ardından parantez.
NUMBERED_DECIMAL_NESTED Aşağıdaki biçimde numaralandırılmış bir liste: DECIMAL Noktalarla ayrılmış sayısal glifler. Her iç içe yerleştirme düzeyinde, önceki iç içe yerleştirme düzeyinin glifi ön ek olarak kullanılı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 glifleri içeren ve ardından nokta gelen numaralı bir liste.
NUMBERED_UPPERROMAN_UPPERALPHA_DECIMAL Aşağıdaki öğeleri içeren numaralı bir liste: UPPERROMAN, UPPERALPHA ve DECIMAL İlk 3 liste iç içe yerleştirme seviyesi için sayısal glifler ve ardından noktalar.
NUMBERED_ZERODECIMAL_ALPHA_ROMAN İlk 3 liste iç içe yerleştirme seviyesi için ZERODECIMAL, ALPHA ve ROMAN sayısal glifleri içeren ve ardından nokta gelen numaralı bir liste.

DeleteParagraphBulletsRequest

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

Her paragrafın iç içe yerleştirme düzeyi, 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

Belirtilen aralığa NamedRange başvuran bir 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 birimleriyle ölçüldüğünde en az 1 karakter, en fazla 256 karakter uzunluğunda olmalıdır.

range

object (Range)

Adın uygulanacağı aralık.

DeleteNamedRangeRequest

NamedRange öğesini siler.

JSON gösterimi 
{
  "tabsCriteria": {
    object (TabsCriteria)
  },

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

object (TabsCriteria)

İsteğe bağlıdır. Aralık silme işleminin hangi sekmelerde gerçekleşeceğini belirtmek için kullanılan ölçütler. Atlandığında, aralık silme işlemi tüm sekmelere uygulanır.

Tek sekme içeren bir dokümanda:

  • Sağlanması durumunda, tekil sekmenin kimliğiyle eşleşmelidir.

  • Atlanırsa aralık silme işlemi tekil sekme için geçerli olur.

Birden fazla sekme içeren bir dokümanda:

  • Sağlanırsa aralık silme işlemi belirtilen sekmeler için geçerli olur.

  • Belirtilmezse aralık silme işlemi tüm sekmeler için geçerli olur.

Birleşik 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.

UpdateParagraphStyleRequest

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.

Belirli 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 ParagraphStyle belgelerini inceleyin.

fields

string (FieldMask format)

Güncellenmesi gereken alanlar.

En az bir alan belirtilmelidir. Kök paragraphStyle örtülüdür ve belirtilmemelidir. Her alanı listelemek için kısaltma olarak tek bir "*" kullanılabilir.

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

Bir mülkü varsayılan değerine sıfırlamak için alan adını alan maskesine ekleyin ancak alanı ayarlanmamış olarak bırakın.

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

object (Range)

Biçimlendirilecek paragraflarla çakışan aralık.

DeleteContentRangeRequest

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ğinden paragraf stillerinde, listelerde, konumlandırılmış nesnelerde ve yer işaretlerinde değişikliklere neden olabilir.

Belirli aralıkları silmeye çalışmak, 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 bazı örnekler:

InsertInlineImageRequest

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

Resmin URI'si.

Resim, ekleme sırasında bir kez getirilir ve dokümanda görüntülenmek üzere bir kopyası saklanır. Resimler 50 MB'tan küçük olmalı, 25 megapikseli aşmamalı 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, resimle birlikte kaydedilir ve ImageProperties.content_uri alanında gösterilir.

objectSize

object (Size)

Resmin dokümanda görüneceği boyut. Bu özellik isteğe bağlıdır ve belgedeki resmin nihai boyutu aşağıdaki kurallara göre belirlenir: * Genişlik veya yükseklik belirtilmemişse resmin varsayılan boyutu çözünürlüğüne göre hesaplanır. * Bir boyut belirtilirse diğer boyut, resmin en boy oranını koruyacak şekilde hesaplanır. * Hem genişlik hem de yükseklik belirtilmişse resim, en boy oranı korunarak belirtilen boyutlara sığacak şekilde ölçeklendirilir.

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

object (Location)

Resmi, dokümanda belirli bir dizine ekler.

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

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

endOfSegmentLocation

object (EndOfSegmentLocation)

Metni üstbilginin, altbilginin veya belge gövdesinin sonuna ekler.

Satır içi resimler dipnotun içine eklenemez.

InsertTableRequest

Belirtilen konuma tablo ekler.

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

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

Birleşik 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 tablonun önüne yeni satır karakteri ekleneceğinden tablonun başlangıç dizini, belirtilen konum dizini + 1 olacaktır.

Tablo, mevcut bir Paragraph sınırları içine yerleştirilmelidir. Örneğin, bir tablonun başlangıç dizinine (yani mevcut bir tablo ile ondan önceki paragraf arasına) eklenemez.

Tablolar dipnot veya denklem içine eklenemez.

endOfSegmentLocation

object (EndOfSegmentLocation)

Tabloyu, belirtilen üstbilginin, altbilginin veya belge gövdesinin sonuna ekler. Eklenen tablonun önüne yeni satır karakteri eklenir.

Tablolar dipnot içine eklenemez.

InsertTableRowRequest

Tabloya boş bir satır ekler.

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

object (TableCellLocation)

Satırların ekleneceği referans tablo hücresi konumu.

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

insertBelow

boolean

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

  • True : Hücrenin altına eklemek için kullanılır.
  • False : Hücrenin üstüne eklemek için.

TableCellLocation

Tablodaki tek bir hücrenin konumu.

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

object (Location)

Tablonun dokümanda başladığı konum.

rowIndex

integer

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

columnIndex

integer

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 (TableCellLocation)
  },
  "insertRight": boolean
}
Alanlar
tableCellLocation

object (TableCellLocation)

Sütunların ekleneceği referans tablo hücresi konumu.

Yeni bir sütun, referans hücrenin bulunduğu sütunun soluna (veya sağına) eklenir. Referans hücre birleştirilmiş bir hücreyse yeni sütun, birleştirilmiş hücrenin soluna (veya sağına) eklenir.

insertRight

boolean

Yeni sütunun referans hücre konumunun sağına eklenip eklenmeyeceği.

  • True : Sağa ekleme
  • False : Sola eklemek için.

DeleteTableRowRequest

Tablodaki bir satırı siler.

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

object (TableCellLocation)

Satırın silineceği referans tablo hücresi konumu.

Bu hücrenin kapsadığı satır silinir. 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

Tablodan sütun siler.

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

object (TableCellLocation)

Sütunun silineceği referans tablo hücresi konumu.

Bu hücrenin kapsadığı sütun silinir. Bu, birden fazla sütunu kapsayan birleştirilmiş bir hücreyse hücrenin kapsadığı tüm sütunlar silinir. Bu silme işleminden sonra tabloda sütun kalmazsa tablonun tamamı silinir.

InsertPageBreakRequest

Belirtilen konuma sayfa sonu ve ardından yeni 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
Birleşik alan insertion_location. Sayfa sonunun ekleneceği konum. insertion_location aşağıdakilerden yalnızca biri olabilir:
location

object (Location)

Sayfa sonunu belgedeki belirli bir dizine ekler.

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

Sayfa sonları tablo, denklem, dipnot, üst bilgi veya alt bilgi içine eklenemez. Sayfa sonları yalnızca gövdeye eklenebildiğinden segment ID alanı boş olmalıdır.

endOfSegmentLocation

object (EndOfSegmentLocation)

Sayfa sonunu belge gövdesinin sonuna ekler.

Sayfa sonları, dipnot, üst bilgi veya alt bilgi içine eklenemez. Sayfa sonları yalnızca gövdeye eklenebildiğinden segment ID alanı boş olmalıdır.

DeletePositionedObjectRequest

Dokümandaki PositionedObject öğesini siler.

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

string

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

tabId

string

Silinecek konumlandırılmış nesnenin bulunduğu sekme. Atlandığında istek ilk sekme için geçerli olur.

Tek sekme içeren bir dokümanda:

  • Sağlanması durumunda, tekil sekmenin kimliğiyle eşleşmelidir.

  • Atlanırsa istek tekil sekme için geçerli olur.

Birden fazla sekme içeren bir dokümanda:

  • Belirtilmişse istek, belirtilen sekme için geçerlidir.

  • Atlanırsa istek, dokümandaki ilk sekme için geçerli olur.

UpdateTableColumnPropertiesRequest

Tablodaki sütunların TableColumnProperties değerini günceller.

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

object (Location)

Tablonun dokümanda başladığı konum.

columnIndices[]

integer

Özelliği güncellenmesi gereken sıfır tabanlı sütun dizinlerinin listesi. Dizin belirtilmezse tüm sütunlar güncellenir.

tableColumnProperties

object (TableColumnProperties)

Güncellenecek tablo sütunu özellikleri.

tableColumnProperties#width değerinin 5 noktadan (5/72 inç) küçük olması durumunda 400 hatalı istek hatası döndürülür.

fields

string (FieldMask format)

Güncellenmesi gereken alanlar.

En az bir alan belirtilmelidir. Kök tableColumnProperties örtülüdür ve belirtilmemelidir. Her alanı listelemek için kısaltma olarak tek bir "*" kullanılabilir.

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

UpdateTableCellStyleRequest

Bir tablo hücresi 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ücrelerinde ayarlanacak stil.

Kenarlıkları güncellerken bir hücrenin bitişik bir hücreyle ortak kenarlığı varsa bitişik hücrenin ilgili kenarlık özelliği de güncellenir. Birleştirilmiş ve görünmez kenarlıklar güncellenmez.

Aynı istekte 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:

  • borderRight
  • borderLeft
  • borderBottom
  • borderTop
fields

string (FieldMask format)

Güncellenmesi gereken alanlar.

En az bir alan belirtilmelidir. Kök tableCellStyle örtülüdür ve belirtilmemelidir. Her alanı listelemek için kısaltma olarak tek bir "*" kullanılabilir.

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

Bir mülkü varsayılan değerine sıfırlamak için alan adını alan maskesine ekleyin ancak alanı ayarlanmamış olarak bırakın.

Birleşik 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)

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

TableRange

Tablo aralığı, tablonun bir alt kümesine yapılan başvuruyu ifade eder.

Tablo aralığıyla belirtilen hücrelerin mutlaka dikdörtgen oluşturmadığını unutmayın. Örneğin, son satırın tüm hücrelerinin birleştirildiği 3 x 3 boyutlu bir tablomuz olduğunu varsayalım. Tablo şu şekilde görünür: 

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

Tablo hücresi 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 aralığı.

UpdateTableRowStyleRequest

Tablodaki satırların TableRowStyle değerini günceller.

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

object (Location)

Tablonun dokümanda başladığı konum.

rowIndices[]

integer

Stili güncellenmesi gereken sıfır tabanlı satır dizinlerinin listesi. 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. Kök tableRowStyle örtülüdür ve belirtilmemelidir. Her alanı listelemek için kısaltma olarak tek bir "*" kullanılabilir.

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

ReplaceImageRequest

Mevcut bir resmi yenisiyle değiştirir.

Bir resmi değiştirdiğinizde, Dokümanlar düzenleyicisinin davranışını yansıtmak için mevcut resimden bazı image effects kaldırılır.

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

string

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

uri

string

Yeni resmin URI'si.

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

Sağlanan URI, 2 KB'ı aşamaz. URI, resimle birlikte kaydedilir ve ImageProperties.source_uri alanı üzerinden gösterilir.

imageReplaceMethod

enum (ImageReplaceMethod)

Değiştirme yöntemi.

tabId

string

Değiştirilecek resmin bulunduğu sekme. Atlandığında istek ilk sekme için geçerli olur.

Tek sekme içeren bir dokümanda:

  • Sağlanması durumunda, tekil sekmenin kimliğiyle eşleşmelidir.

  • Atlanırsa istek tekil sekme için geçerli olur.

Birden fazla sekme içeren bir dokümanda:

  • Belirtilmişse istek, belirtilen sekme için geçerlidir.

  • Atlanırsa istek, dokümandaki ilk sekme için geçerli olur.

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çeklendirir ve ortalar. Resim, orijinal resmin sınırlarını doldurmak için kırpılabilir. Resmin oluşturulan boyutu, orijinal resimle aynı olur.

UpdateDocumentStyleRequest

DocumentStyle güncellenir.

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

object (DocumentStyle)

Belgede ayarlanacak stiller.

Belirli belge 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 belgelerini inceleyin.

fields

string (FieldMask format)

Güncellenmesi gereken alanlar.

En az bir alan belirtilmelidir. Kök documentStyle örtülüdür ve belirtilmemelidir. Her alanı listelemek için kısaltma olarak tek bir "*" kullanılabilir.

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

tabId

string

Güncellenecek stili içeren sekme. Atlandığında istek ilk sekme için geçerli olur.

Tek sekme içeren bir dokümanda:

  • Sağlanması durumunda, tekil sekmenin kimliğiyle eşleşmelidir.

  • Atlanırsa istek tekil sekme için geçerli olur.

Birden fazla sekme içeren bir dokümanda:

  • Belirtilmişse istek, belirtilen sekme için geçerlidir.

  • Belirtilmezse istek, dokümandaki ilk sekme için geçerli olur.

MergeTableCellsRequest

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ştirilip aralığın "baş" hücresinde saklanır. İçerik yönü soldan sağa olduğunda aralığın sol üst hücresi, aksi takdirde aralığın sağ üst hücresidir.

Aralık dikdörtgen değilse (bu durum, aralığın zaten birleştirilmiş hücreleri kapsadığı veya tablonun dikdörtgen olmadığı bazı durumlarda ortaya çıkabilir) 400 hatalı istek hatası döndürülür.

UnmergeTableCellsRequest

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

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

object (TableRange)

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

Bu aralıktaki tüm birleştirilmiş hücrelerin birleştirilmesi iptal edilir ve önceden birleştirilmesi iptal edilmiş hücreler etkilenmez. Aralıkta birleştirilmiş hücre yoksa istek hiçbir işlem yapmaz.

Birleştirilen hücrelerden herhangi birinde metin varsa bu metin, birleştirilmemiş hücrelerden oluşan sonuçtaki bloğun "baş" hücresinde kalır. İçerik yönü soldan sağa olduğunda "başlık" hücresi sol üstteki hücre, aksi takdirde sağ üstteki hücredir.

CreateHeaderRequest

Header oluşturur. Yeni üstbilgi, belirtilmişse SectionBreak konumundaki SectionStyle için, belirtilmemişse DocumentStyle için geçerlidir.

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 başlığın türü.

sectionBreakLocation

object (Location)

Bu başlığın ait olması gereken bölümün başladığı SectionBreak konumudur. SectionBreak `sectionBreakLocation` ayarlanmamışsa veya doküman gövdesindeki ilk bölüm sonuna atıfta bulunuyorsa başlık, DocumentStyle

HeaderFooterType

Oluşturulabilecek üstbilgi ve altbilgi türleri.

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

CreateFooterRequest

Footer oluşturur. Yeni altbilgi, belirtilmişse SectionBreak konumundaki SectionStyle için geçerlidir. Aksi takdirde, DocumentStyle için geçerlidir.

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 altbilgi türü.

sectionBreakLocation

object (Location)

Bu altbilginin ait olması gereken SectionStyle bölümünden hemen önce gelen SectionBreak bölümünün konumu. Bu ayar kaldırılırsa veya belgedeki ilk bölüm sonuna referans verirse altbilgi, belge stili için geçerli olur.

CreateFootnoteRequest

Bir Footnote segmenti oluşturur ve belirtilen konuma yeni bir FootnoteReference ekler.

Yeni Footnote segmenti, bir boşluk ve ardından yeni satır karakteri içerir.

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
Birleşik 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ı belgedeki belirli bir dizine ekler.

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

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

endOfSegmentLocation

object (EndOfSegmentLocation)

Dipnot referansını belge gövdesinin sonuna ekler.

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

ReplaceNamedRangeContentRequest

Belirtilen NamedRange veya NamedRanges içeriğini, verilen değiştirme içeriğiyle değiştirir.

Bir NamedRange birden fazla süreksiz ranges içerebilir. Bu durumda yalnızca ilk aralıktaki içerik değiştirilir. Diğer aralıklar ve içerikleri silinir.

Herhangi bir aralığın değiştirilmesi veya silinmesi durumunda geçersiz bir belge yapısı oluşursa 400 hatalı istek hatası döndürülür.

JSON gösterimi 
{
  "tabsCriteria": {
    object (TabsCriteria)
  },

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

object (TabsCriteria)

İsteğe bağlıdır. Değiştirmenin hangi sekmelerde gerçekleşeceğini belirtmek için kullanılan ölçütler. Atlandığında değiştirme işlemi tüm sekmeler için geçerli olur.

Tek sekme içeren bir dokümanda:

  • Sağlanması durumunda, tekil sekmenin kimliğiyle eşleşmelidir.

  • Atlanırsa değiştirme işlemi tekil sekme için geçerli olur.

Birden fazla sekme içeren bir dokümanda:

  • Sağlanırsa değiştirme işlemi belirtilen sekmelere uygulanır.

  • Atlanırsa değiştirme işlemi tüm sekmeler için geçerli olur.

Birleşik alan replacement_content. Adlandırılmış aralığın mevcut içeriğinin yerine kullanılacak 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.

Birleşik alan named_range_reference. İçeriği değiştirilecek olan 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 olan 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.

namedRangeName

string

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

Belirtilen ada sahip birden fazla named ranges varsa her birinin içeriği değiştirilir. Belirtilen ada sahip adlandırılmış aralık yoksa istek işlem yapılmadan tamamlanır.

UpdateSectionStyleRequest

SectionStyle güncellenir.

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

object (Range)

Biçimlendirilecek bölümlerle çakışan aralık.

Bölüm sonları yalnızca gövdeye eklenebildiğinden segment ID alanı boş olmalıdır.

sectionStyle

object (SectionStyle)

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 SectionStyle belgelerini inceleyin.

fields

string (FieldMask format)

Güncellenmesi gereken alanlar.

En az bir alan belirtilmelidir. Kök sectionStyle örtülüdür ve belirtilmemelidir. Her alanı listelemek için kısaltma olarak tek bir "*" kullanılabilir.

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

InsertSectionBreakRequest

Belirtilen konuma bölüm sonu ekler.

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

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

Birleşik 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 (yani tablo ile önceki paragraf arasına) eklenemez.

Bölüm sonları tablo, denklem, dipnot, üstbilgi veya altbilgi içine eklenemez. Bölüm sonları yalnızca gövdeye eklenebildiğinden segment ID alanı boş olmalıdır.

endOfSegmentLocation

object (EndOfSegmentLocation)

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

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

DeleteHeaderRequest

Dokümandaki Header öğesini siler.

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

string

Silinecek üstbilginin kimliği. Bu üstbilgi DocumentStyle üzerinde tanımlanmışsa bu üstbilgiye yapılan referans kaldırılır. Bu da belgenin ilk bölümünde bu türde bir üstbilgi olmamasına neden olur. Bu başlık bir SectionStyle üzerinde tanımlanmışsa bu başlığa yapılan referans kaldırılır ve bu türdeki başlık artık önceki bölümden devam eder.

tabId

string

Silinecek üstbilgiyi içeren sekme. Atlandığında istek ilk sekme için geçerli olur.

Tek sekme içeren bir dokümanda:

  • Sağlanması durumunda, tekil sekmenin kimliğiyle eşleşmelidir.

  • Atlanırsa istek tekil sekme için geçerli olur.

Birden fazla sekme içeren bir dokümanda:

  • Belirtilmişse istek, belirtilen sekme için geçerlidir.

  • Atlanırsa istek, dokümandaki ilk sekme için geçerli olur.

DeleteFooterRequest

Dokümandaki Footer öğesini siler.

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

string

Silinecek altbilginin kimliği. Bu altbilgi DocumentStyle üzerinde tanımlanmışsa bu altbilgiye yapılan referans kaldırılır ve belgenin ilk bölümünde bu tür bir altbilgi olmaz. Bu altbilgi bir SectionStyle üzerinde tanımlanmışsa bu altbilgiye yapılan referans kaldırılır ve bu türdeki altbilgi artık önceki bölümden devam eder.

tabId

string

Silinecek altbilgiyi içeren sekme. Atlandığında istek ilk sekme için geçerli olur.

Tek sekme içeren bir dokümanda:

  • Sağlanması durumunda, tekil sekmenin kimliğiyle eşleşmelidir.

  • Atlanırsa istek tekil sekme için geçerli olur.

Birden fazla sekme içeren bir dokümanda:

  • Belirtilmişse istek, belirtilen sekme için geçerlidir.

  • Atlanırsa istek, dokümandaki ilk sekme için geçerli olur.

PinTableHeaderRowsRequest

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)

Tablonun dokümanda başladığı konum.

pinnedHeaderRowsCount

integer

Sabitlenecek tablo satırı sayısı. 0, tüm satırların sabitlenmediği anlamına gelir.

InsertPersonRequest

Kullanıcı bahsetme ekler.

JSON gösterimi 
{
  "personProperties": {
    object (PersonProperties)
  },

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

object (PersonProperties)

Eklenecek kişi bahsinin özellikleri.

Birleşik alan insertion_location. Kişi bahsinin ekleneceği konum. insertion_location aşağıdakilerden yalnızca biri olabilir:
location

object (Location)

Kişi bahsini belgedeki belirli bir dizine ekler.

Kişi bahsi, mevcut bir Paragraph sınırları içine yerleştirilmelidir. Örneğin, bir tablonun başlangıç dizinine (yani tablo ile önceki paragraf arasına) eklenemez.

Kişi bahsetmeleri denklemlerin içine eklenemez.

endOfSegmentLocation

object (EndOfSegmentLocation)

Kullanıcı bahsini üstbilgi, altbilgi, dipnot veya belge gövdesinin sonuna ekler.