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 özel istek. Tam olarak bir alanın doldurulması 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)

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ış 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 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)

Konumlandırılmış nesneyi dokümandan 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 birleştirilen hücreleri ayırır.

createHeader

object (CreateHeaderRequest)

Üstbilgi 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 üstbilgiyi siler.

pinTableHeaderRows

object (PinTableHeaderRowsRequest)

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

ReplaceAllTextRequest

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

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 yerini alacak metin.

tabsCriteria

object (TabsCriteria)

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

Kullanılmadığında, değiştirme işlemi tüm sekmelere uygulanır.

Tek sekme içeren bir dokümanda:

  • Sağlanmışsa tekil sekmenin kimliğiyle eşleşmelidir.

  • Atlanırsa değiştirme işlemi tekil sekmeye uygulanır.

Birden fazla sekme içeren bir dokümanda:

  • Sağlandığında, değiştirme işlemi belirtilen sekmeler için geçerli olur.

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

Birlik 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

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 büyük/küçük harfe duyarlı 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.

TabsCriteria

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

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

string

İsteğin yürütüleceği 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 eklendiğinde dolaylı olarak yeni bir satır oluşturulur Paragraph görebilirsiniz. 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ı 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.

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

object (Location)

Dokümandaki belirli bir dizine metin ekler.

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

endOfSegmentLocation

object (EndOfSegmentLocation)

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

Konum

Dokümandaki 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, dokümanın gövdesini belirtir.

index

integer

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

Dizin, segmentId

tabId

string

Konumun bulunduğu sekme. Atlandığında, istek ilk sekmeye uygulanır.

Tek sekme içeren bir dokümanda:

  • Sağlanmışsa tekil sekmenin kimliğiyle eşleşmelidir.

  • Atlanırsa istek tekil sekmeye uygulanır.

Birden fazla sekme içeren bir dokümanda:

  • Sağlanmışsa istek, belirtilen sekme için geçerli olur.

  • Atlanırsa istek, dokümandaki ilk sekmeye uygulanır.

EndOfSegmentLocation

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

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

string

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

tabId

string

Konumun bulunduğu sekme. Atlandığında, istek ilk sekmeye uygulanır.

Tek sekme içeren bir dokümanda:

  • Sağlanmışsa tekil sekmenin kimliğiyle eşleşmelidir.

  • Atlanırsa istek tekil sekmeye uygulanır.

Birden fazla sekme içeren bir dokümanda:

  • Sağlanmışsa istek, belirtilen sekme için geçerli olur.

  • Atlanırsa istek, dokümandaki ilk sekmeye uygulanır.

UpdateTextStyleRequest

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)

Metinde ayarlanacak stiller.

Belirli bir stilin değeri üst stilin değeriyle eşleşirse söz konusu 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. Dokümanları görüntüleyin: TextStyle konulu videomuzu izleyin.

fields

string (FieldMask format)

Güncellenmesi gereken alanlar.

En az bir alan belirtilmelidir. Kök textStyle belirtilmeli ve belirtilmemelidir. Tek "*" her alanı listelemek için kısa bir ifade olarak kullanılabilir.

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

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.

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 oluşturulacak metin aralığı.

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

Aralık tamamen bir listeye ait paragrafı 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

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

Her bir paragrafın iç içe yerleştirme düzeyi, her paragrafın önündeki sekmeler sayılarak 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.

Paragrafların güncellenmesinden hemen önceki paragraf, eşleşen bir hazır ayara sahip bir listede yer alıyorsa güncellenen paragraflar ö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şareti gliflerinin hazır ayarlı 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 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 içi dolu baklava
  • 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 karo
  • DISC : Bir 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 kesintisiz kare
  • STAR : Unicode U+2605 kod noktasına karşılık gelen bir yıldız
  • ALPHA : "a", "b" veya "c" gibi küçük harf.
  • UPPERALPHA : "A", "B" veya "C" gibi büyük harfler.
  • DECIMAL : "1", "2" veya "3" gibi bir sayı.
  • ZERODECIMAL : Tek basamaklı sayıların başında sıfır bulunan bir sayıdır (ör. "01", "02" veya "03"). Birden fazla basamağı olan sayıların başında sıfır bulunmaz.
  • ROMAN : "i", "ii" veya "iii" gibi küçük Roma rakamı.
  • UPPERROMAN : "I", "II" veya "III" gibi büyük 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 glif hazır ayarı belirtilmemiş.
BULLET_DISC_CIRCLE_SQUARE Madde işaretli liste DISC CIRCLE ve SQUARE liste iç içe yerleştirme düzeyi için madde işareti simgesi
BULLET_DIAMONDX_ARROW3D_SQUARE Madde işaretli liste DIAMONDX ARROW3D ve SQUARE liste iç içe yerleştirme düzeyi için madde işareti simgesi
BULLET_CHECKBOX Madde işaretli liste CHECKBOX tüm liste iç içe yerleştirme düzeyleri için madde işareti işaretleri.
BULLET_ARROW_DIAMOND_DISC Madde işaretli liste ARROW DIAMOND ve DISC liste iç içe yerleştirme düzeyi için madde işareti simgesi
BULLET_STAR_CIRCLE_SQUARE Madde işaretli liste STAR CIRCLE ve SQUARE liste iç içe yerleştirme düzeyi için madde işareti simgesi
BULLET_ARROW3D_CIRCLE_SQUARE Madde işaretli liste ARROW3D CIRCLE ve SQUARE liste iç içe yerleştirme düzeyi için madde işareti simgesi
BULLET_LEFTTRIANGLE_DIAMOND_DISC Madde işaretli liste LEFTTRIANGLE DIAMOND ve DISC liste iç içe yerleştirme düzeyi için madde işareti simgesi
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE Madde işaretli liste DIAMONDX HOLLOWDIAMOND ve SQUARE liste iç içe yerleştirme düzeyi için madde işareti simgesi
BULLET_DIAMOND_CIRCLE_SQUARE Madde işaretli liste DIAMOND CIRCLE ve SQUARE liste iç içe yerleştirme düzeyi için madde işareti simgesi
NUMBERED_DECIMAL_ALPHA_ROMAN Numaralı liste DECIMAL ALPHA ve ROMAN ilk 3 liste iç içe yerleştirme düzeyi için sayısal karakterler ve ardından noktalar.
NUMBERED_DECIMAL_ALPHA_ROMAN_PARENS Numaralı liste DECIMAL ALPHA ve ROMAN ilk 3 liste iç içe yerleştirme düzeyi için sayısal karakterler ve ardından parantez var.
NUMBERED_DECIMAL_NESTED Numaralı liste DECIMAL noktayla ayrılmış sayısal glifler. Her iç içe yerleştirme düzeyinde önek olarak bir önceki iç içe yerleştirme seviyesinin glifi kullanılır. Örneğin: '1.', "1.1.", "2.", "2.2."
NUMBERED_UPPERALPHA_ALPHA_ROMAN Numaralı liste UPPERALPHA ALPHA ve ROMAN ilk 3 liste iç içe yerleştirme düzeyi için sayısal karakterler ve ardından noktalar.
NUMBERED_UPPERROMAN_UPPERALPHA_DECIMAL Numaralı liste UPPERROMAN UPPERALPHA ve DECIMAL ilk 3 liste iç içe yerleştirme düzeyi için sayısal karakterler ve ardından noktalar.
NUMBERED_ZERODECIMAL_ALPHA_ROMAN Numaralı liste ZERODECIMAL ALPHA ve ROMAN ilk 3 liste iç içe yerleştirme düzeyi için sayısal karakterler ve ardından noktalar.

DeleteParagraphBulletsRequest

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

Her paragrafın iç içe yerleştirme düzeyi, karşılık gelen paragrafın başına girinti eklenerek görsel olarak korunur.

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

object (Range)

Madde işaretlerinin silineceği aralık.

CreateNamedRangeRequest

Bir NamedRange referans verilen zaman aralığıdır.

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

string

AdlandırılmışAralık'ın adı. Adların benzersiz olması gerekmez.

Adlar UTF-16 kod birimleriyle ölçülen en az 1, en fazla 256 karakterden oluşmalıdır.

range

object (Range)

Adın uygulanacağı aralık.

DeleteNamedRangeRequest

Bir NamedRange

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ı. 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ğlanmışsa 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.

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 adları. Belirtilen ada sahip tüm adlandırılmış aralıklar silinecek.

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.

Bazı paragraf stili değişiklikleri, Dokümanlar düzenleyicisinin çalışma biçimini yansıtmak için başka değişikliklere neden olabilir. Dokümanları görüntüleyin: ParagraphStyle konulu videomuzu izleyin.

fields

string (FieldMask format)

Güncellenmesi gereken alanlar.

En az bir alan belirtilmelidir. Kök paragraphStyle belirtilmeli ve belirtilmemelidir. Tek "*" her alanı listelemek için kısa bir ifade olarak kullanılabilir.

Örneğin, paragraf stilinin hizalama özelliğini güncellemek için fields - "alignment".

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.

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

object (Range)

Stil oluşturmak için 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ığı.

Bir paragraf sınırını geçen metnin silinmesi, bu iki paragraf birleştirilirken paragraf stillerinde, listelerde, konumlandırılmış nesnelerde ve yer işaretlerinde değişikliklere neden 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 isteğine ilişkin bazı örnekler şunlardır:

InsertInlineImageRequest

Ek InlineObject konumdaki bir resmi içerir.

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

Görsel URI'si.

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

Sağlanan URI herkesin erişimine açık olmalı ve en fazla 2 kB uzunluğunda olmalıdır. URI'nın kendisi resimle birlikte kaydedilir ve ImageProperties.content_uri girin.

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 ş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 belirtilmişse diğer boyut, resmin en boy oranını korumak için hesaplanır. * Hem genişlik hem de yükseklik belirtilmişse resim, en boy oranı korunarak 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 resmin sınırlarının içine Paragraph Örneğin, bir tablonun başlangıç dizinine (tablo ile önceki paragrafı arasına) eklenemez.

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

endOfSegmentLocation

object (EndOfSegmentLocation)

Metni üstbilgi, altbilgi veya doküman gövdesinin sonuna ekler.

Satır içi resimler dipnota 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 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 eklendiği için tablo başlangıç dizini, belirtilen konum dizininde + 1 olur.

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

Dipnot veya denklem içine tablo eklenemez.

endOfSegmentLocation

object (EndOfSegmentLocation)

Tabloyu belirtilen üstbilgi, altbilgi veya doküman gövdesinin sonuna ekler. Eklenen tablonun önüne yeni satır karakteri eklenir.

Dipnota tablo 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 tablosu hücre konumu.

Başvuru hücresinin bulunduğu satırın üstüne (veya altına) yeni bir satır eklenir. Başvuru hücresi, birleştirilmiş bir 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 ekleyin.

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 tablosu hücre konumu.

Başvuru hücresinin bulunduğu sütunun soluna (veya sağına) yeni bir sütun eklenir. Başvuru hücresi, birleştirilmiş bir hücreyse, birleştirilmiş hücrenin soluna (veya sağına) yeni bir sütun eklenir.

insertRight

boolean

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

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

DeleteTableRowRequest

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 kapladığı satır silinecek. Birden çok satıra yayılan birleştirilmiş bir hücre söz konusuysa hücrenin kapsadığı tüm satırlar silinir. Bu silme işleminden sonra tabloda hiç satır kalmazsa tablonun tamamı silinir.

DeleteTableColumnRequest

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

Dokümandaki belirli bir dizine sayfa sonunu ekler.

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

Tablo, denklem, dipnot, üstbilgi veya altbilgi içine sayfa sonları eklenemez. Sayfa sonları yalnızca gövdenin içine eklenebildiğinden, segment ID alanı boş olmalıdır.

endOfSegmentLocation

object (EndOfSegmentLocation)

Sayfa sonunu doküman gövdesinin sonuna ekler.

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

DeletePositionedObjectRequest

Bir PositionedObject kaldıracak.

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

string

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

tabId

string

Silinecek nesnenin bulunduğu sekme. Atlandığında, istek ilk sekmeye uygulanır.

Tek sekme içeren bir dokümanda:

  • Sağlanmışsa tekil sekmenin kimliğiyle eşleşmelidir.

  • Atlanırsa istek tekil sekmeye uygulanır.

Birden fazla sekme içeren bir dokümanda:

  • Sağlanmışsa istek, belirtilen sekme için geçerli olur.

  • Atlanırsa istek, dokümandaki ilk sekmeye uygulanır.

UpdateTableColumnPropertiesRequest

TableColumnProperties görebilirsiniz.

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ğinin 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.

Eğer tableColumnProperties#width 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. Kök tableColumnProperties belirtilmeli ve belirtilmemelidir. Tek "*" her alanı listelemek için kısa bir ifade olarak kullanılabilir.

Örneğin, sütun genişliğini güncellemek için fields - "width".

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ücre bitişik bir hücreyle kenarlık paylaşıyorsa bitişik hücrenin karşılık gelen kenarlık özelliği de güncellenir. Birleştirilmiş ve görünmez olan kenarlıklar güncellenmez.

Aynı istekte komşu hücreler tarafından paylaşılan sınırın güncellenmesi sınır güncellemelerinin çakışmasına 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 belirtilmeli ve belirtilmemelidir. Tek "*" her alanı listelemek için kısa bir ifade olarak kullanılabilir.

Örneğin, tablo hücresinin arka plan rengini güncellemek için fields - "backgroundColor".

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.

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)

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

TableRange

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

Bir tablo aralığıyla belirtilen hücrelerin mutlaka bir dikdörtgen oluşturmadığı unutulmamalıdır. Örneğin, son satırdaki tüm hücrelerin birleştirildiği 3 x 3 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 aralığı.

UpdateTableRowStyleRequest

TableRowStyle satır sayısını gösterir.

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

Stilinin 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 belirtilmeli ve belirtilmemelidir. Tek "*" her alanı listelemek için kısa bir ifade olarak kullanılabilir.

Örneğin, minimum satır yüksekliğini güncellemek için fields - "minRowHeight".

ReplaceImageRequest

Mevcut bir resmi yeni bir resimle değiştirir.

Resmi değiştirmek bazı image effects özelliğini kullanarak Dokümanlar düzenleyicisinin davranışını yansıtmak için mevcut resimden kaldırın.

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 zamanında bir kez getirilir ve dokümanın içinde görüntülenmek ü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 ImageProperties.source_uri girin.

imageReplaceMethod

enum (ImageReplaceMethod)

Değiştirme yöntemi.

tabId

string

Değiştirilecek resmin bulunduğu sekme. Atlandığında, istek ilk sekmeye uygulanır.

Tek sekme içeren bir dokümanda:

  • Sağlanmışsa tekil sekmenin kimliğiyle eşleşmelidir.

  • Atlanırsa istek tekil sekmeye uygulanır.

Birden fazla sekme içeren bir dokümanda:

  • Sağlanmışsa istek, belirtilen sekme için geçerli olur.

  • Atlanırsa istek, dokümandaki ilk sekmeye uygulanır.

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

UpdateDocumentStyleRequest

DocumentStyle

JSON gösterimi
{
  "documentStyle": {
    object (DocumentStyle)
  },
  "fields": string,
  "tabId": 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. Dokümanları görüntüleyin: DocumentStyle konulu videomuzu izleyin.

fields

string (FieldMask format)

Güncellenmesi gereken alanlar.

En az bir alan belirtilmelidir. Kök documentStyle belirtilmeli ve belirtilmemelidir. Tek "*" her alanı listelemek için kısa bir ifade olarak kullanılabilir.

Örneğin, arka planı güncellemek için fields - "background".

tabId

string

Güncellenecek stili içeren sekme. Atlandığında, istek ilk sekmeye uygulanır.

Tek sekme içeren bir dokümanda:

  • Sağlanmışsa tekil sekmenin kimliğiyle eşleşmelidir.

  • Atlanırsa istek tekil sekmeye uygulanır.

Birden fazla sekme içeren bir dokümanda:

  • Sağlanmışsa istek, belirtilen sekme için geçerli olur.

  • Sağlanmazsa istek, dokümanın ilk sekmesi için geçerli olur.

MergeTableCellsRequest

Hücreleri bir araya getirir Table

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

object (TableRange)

Tablodaki hangi hücrelerin birleştirileceğini belirten tablo aralığı.

Birleştirilen hücrelerdeki tüm metinler birleştirilir ve "başlık" bölümünde depolanır hücresini ekleyin. Bu, içerik yönü soldan sağa; aksi halde aralığın sağ üst hücresi olduğunda aralığın sol üst hücresidir.

Aralık dikdörtgen değilse (aralık önceden 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 ayırır: Table

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

object (TableRange)

Tablodaki hangi hücrelerin ayrılacağını belirten tablo aralığı.

Bu aralıktaki birleştirilen tüm hücreler ayrılır ve daha önce ayrılmış olan hücreler etkilenmez. Aralıkta birleştirilmiş hücre yoksa istek hiçbir şey yapmaz.

Birleştirilen hücrelerde metin varsa metin "başlık" bölümünde kalır hücresinin hücresi gösterilir. "Baş" içerik yönü soldan sağa; aksi halde sağ üstteki hücre sol üst hücredir.

CreateHeaderRequest

Bir Header Yeni üstbilgi, SectionStyle bulunduğu yerde SectionBreak belirtildiğinde, aksi takdirde DocumentStyle.

Belirtilen türde bir üstbilgi zaten mevcutsa 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)

Etiketin konumu SectionBreak Bu başlığın ait olması gereken bölümün başlangıcını sağlar. "sectionBreakLocation" ayarlanmadığından veya doküman gövdesindeki ilk bölüm sonuyla ilgiliyse başlık DocumentStyle

HeaderFooterType

Oluşturulabilecek üstbilgi ve altbilgi türleri.

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

CreateFooterRequest

Bir Footer Yeni altbilgi SectionStyle bulunduğu yerde SectionBreak belirtildiğinde, aksi takdirde DocumentStyle.

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)

Etiketin konumu SectionBreak bulunan bölümün hemen önüne SectionStyle ait olması gerekir. Bu ayar ayarlanmazsa veya dokümandaki ilk bölüm sonu anlamına gelirse altbilgi, doküman stiline uygulanır.

CreateFootnoteRequest

Bir Footnote segmente yeni bir segment ekler FootnoteReference .

Yeni Footnote segment 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
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 referansı, mevcut bir Paragraph Örneğin, bir tablonun başlangıç dizinine (tablo ile önceki paragrafı arasına) eklenemez.

Dipnot referansları bir denkleme, üstbilgiye, altbilgiye veya dipnota eklenemez. Dipnot başvuruları yalnızca gövdeye eklenebildiğinden, segment ID alanı boş olmalıdır.

endOfSegmentLocation

object (EndOfSegmentLocation)

Dipnot referansını doküman gövdesinin sonuna ekler.

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

ReplaceNamedRangeContentRequest

Belirtilen NamedRange veya NamedRanges değiştirilir.

Bir kullanıcının NamedRange süreklilik gösteren birden fazla ranges. Bu durumda, yalnızca ilk aralıktaki içerik değiştirilir. Diğer aralıklar ve içerikleri silinecek.

Aralıkları değiştirmenin veya silmenin geçersiz bir doküman yapısına neden olacağı durumlarda 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ı. Değiştirmenin hangi sekmelerde gerçekleşeceğini belirtmek için kullanılan ölçütler. Kullanılmadığında, değiştirme işlemi tüm sekmelere uygulanır.

Tek sekme içeren bir dokümanda:

  • Sağlanmışsa tekil sekmenin kimliğiyle eşleşmelidir.

  • Atlanırsa değiştirme işlemi tekil sekmeye uygulanır.

Birden fazla sekme içeren bir dokümanda:

  • Sağlandığında, değiştirme işlemi belirtilen sekmeler için geçerli olur.

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

Birlik alanı replacement_content Adlandırılmış aralıktaki mevcut içeriğin değiştirileceği 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 başvuru. 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

Kişinin adı NamedRanges içerik değiştirilecek.

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

UpdateSectionStyleRequest

SectionStyle

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

object (Range)

Stil oluşturmak için bölümlerle çakışan aralık.

Bölüm sonları yalnızca gövdenin içine eklenebileceğ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. Dokümanları görüntüleyin: SectionStyle konulu videomuzu izleyin.

fields

string (FieldMask format)

Güncellenmesi gereken alanlar.

En az bir alan belirtilmelidir. Kök sectionStyle belirtilmeli ve belirtilmemelidir. Tek "*" her alanı listelemek için kısa bir ifade olarak kullanılabilir.

Örneğin, sol kenar boşluğunu güncellemek için fields - "marginLeft".

InsertSectionBreakRequest

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

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

object (Location)

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

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

Tablo, denklem, dipnot, üstbilgi veya altbilgi içine bölüm sonları eklenemez. Bölüm sonları yalnızca gövdenin içine eklenebildiğ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 altbilgi içine bölüm sonları eklenemez. Bölüm sonları yalnızca gövdenin içine eklenebileceğinden, segment ID alanı boş olmalıdır.

DeleteHeaderRequest

Bir Header kaldıracak.

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

string

Silinecek başlığın kimliği. Bu üst bilgi DocumentStyle ise bu üstbilgiye yapılan başvuru kaldırılır. Bu da, dokümanın ilk bölümünde söz konusu türde üstbilgi olmamasına neden olur. Bu üstbilgi, SectionStyle, bu üstbilgiye yapılan başvuru kaldırılır ve söz konusu türdeki üstbilgi artık önceki bölümden devam ettirilir.

tabId

string

Silinecek başlığı içeren sekme. Atlandığında, istek ilk sekmeye uygulanır.

Tek sekme içeren bir dokümanda:

  • Sağlanmışsa tekil sekmenin kimliğiyle eşleşmelidir.

  • Atlanırsa istek tekil sekmeye uygulanır.

Birden fazla sekme içeren bir dokümanda:

  • Sağlanmışsa istek, belirtilen sekme için geçerli olur.

  • Atlanırsa istek, dokümandaki ilk sekmeye uygulanır.

DeleteFooterRequest

Bir Footer kaldıracak.

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

string

Silinecek altbilginin kimliği. Bu altbilgi DocumentStyle, bu altbilgiye yönelik referans kaldırıldığından, dokümanın ilk bölümünde bu altbilgiye ait herhangi bir alt bilgi yer almıyor. Bu altbilgi SectionStyle, bu altbilgiye yönelik referans kaldırıldı ve ilgili türdeki altbilgi artık önceki bölümden devam ettiriliyor.

tabId

string

Silinecek altbilgiyi içeren sekme. Atlandığında, istek ilk sekmeye uygulanır.

Tek sekme içeren bir dokümanda:

  • Sağlanmışsa tekil sekmenin kimliğiyle eşleşmelidir.

  • Atlanırsa istek tekil sekmeye uygulanır.

Birden fazla sekme içeren bir dokümanda:

  • Sağlanmışsa istek, belirtilen sekme için geçerli olur.

  • Atlanırsa istek, dokümandaki ilk sekmeye uygulanır.

PinTableHeaderRowsRequest

Bir tablodaki sabitlenmiş tablo başlığı satırı 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ırlarının sayısı. 0 değeri, tüm satırların sabitlemesinin kaldırıldığı anlamına gelir.