Requests

İstek

Bir dokümana uygulanacak tek bir güncelleme.

JSON gösterimi
{

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

object (ReplaceAllTextRequest)

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

insertText

object (InsertTextRequest)

Belirtilen konuma metin 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ümandan içerik siler.

insertInlineImage

object (InsertInlineImageRequest)

Belirtilen konuma 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 sayfa sonu ekler.

deletePositionedObject

object (DeletePositionedObjectRequest)

Yerleştirilmiş bir nesneyi dokümandan 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ştirilmesini kaldırır.

createHeader

object (CreateHeaderRequest)

Üstbilgi 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 bir bölüm sonu ekler.

deleteHeader

object (DeleteHeaderRequest)

Dokümanda bir üstbilgiyi siler.

pinTableHeaderRows

object (PinTableHeaderRowsRequest)

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

ReplaceAllTextRequest

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

JSON gösterimi
{
  "replaceText": string,
  "tabsCriteria": {
    object (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şimin hangi sekmelerde gerçekleşeceğini belirtmek için kullanılan ölçütler.

Atlanırsa değiştirme işlemi tüm sekmelere uygulanır.

Tek sekme içeren bir dokümanda:

  • Sağlandıysa 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:

  • Belirtilen sekmeler için değiştirme işlemi uygulanır.

  • Atlanırsa değiştirme işlemi tüm sekmelere uygulanır.

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

object (SubstringMatchCriteria)

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

SubstringMatchCriteria

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

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

string

Dokümanda aranacak metin.

matchCase

boolean

Aramanın büyük/küçük harflere 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 çalışacağını belirten ölçüt.

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

string

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

InsertTextRequest

Belirtilen konuma metin 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 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 yalnızca aşağıdakilerden biri olabilir:
location

object (Location)

Metni dokümanda belirli bir dizinde ekler.

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

endOfSegmentLocation

object (EndOfSegmentLocation)

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

Konum

Belgedeki belirli bir konum.

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

string

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

index

integer

UTF-16 kod birimleri cinsinden sıfır tabanlı dizin.

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

tabId

string

Konumun bulunduğu sekme. Atlanırsa istek ilk sekmeye uygulanır.

Tek sekme içeren bir dokümanda:

  • Sağlandıysa 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:

  • Gönderilirse istek belirtilen sekme için geçerli olur.

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

EndOfSegmentLocation

Bir gövdenin, üstbilginin, altbilginin veya dipnotun sonundaki konum. Konum, doküman segmentindeki son satır başı işaretinden hemen öncedir.

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

string

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

tabId

string

Konumun bulunduğu sekme. Atlanırsa istek ilk sekmeye uygulanır.

Tek sekme içeren bir dokümanda:

  • Sağlandıysa 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:

  • Gönderilirse istek belirtilen sekme için geçerli olur.

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

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 öğenin değeriyle eşleşirse bu stil devralınacak şekilde ayarlanır.

Belirli metin stili değişiklikleri, Dokümanlar düzenleyicisinin davranışını yansıtmak için başka değişikliklere neden olabilir. Daha fazla bilgi için TextStyle dokümanlarını inceleyin.

fields

string (FieldMask format)

Güncellenmesi gereken alanlar.

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

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

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

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

object (Range)

Stil uygulanacak metin aralığı.

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

Aralık, bir listeye ait bir paragrafı tamamen içeriyorsa paragrafın madde işareti de eşleşen metin stiliyle güncellenir.

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

CreateParagraphBulletsRequest

Belirtilen aralıkla örtüşen tüm paragraflar için madde işaretleri oluşturur.

Her paragrafın iç içe yerleştirme düzeyi, her paragrafın önündeki ilk sekmelerin sayılmasıyla belirlenir. Bu istek, madde işareti ile ilgili paragraf arasında fazladan boşluk olmasını önlemek için bu ilk sekmeleri kaldırır. Bu işlem, 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 bir 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 glif türleri.

BulletGlyphPreset

Listeler için önceden ayarlanmış nokta simgesi kalıpları.

Bu kalıplarda şu tür madde işaretleri kullanılır:

  • ARROW : Unicode U+2794 kod noktasına karşılık gelen bir ok
  • ARROW3D : Unicode U+27a2 kod noktasına karşılık gelen 3D gölgelendirmeli bir ok
  • CHECKBOX : Unicode U+274f kod noktasına karşılık gelen içi boş kare
  • CIRCLE : Unicode U+25cb kod noktasına karşılık gelen içi boş bir daire
  • DIAMOND : Unicode U+25c6 kod noktasına karşılık gelen dolu bir elmas
  • DIAMONDX : Unicode U+2756 kod noktasına karşılık gelen "x" içeren bir elmas
  • HOLLOWDIAMOND : Unicode U+25c7 kod noktasına karşılık gelen içi boş karo
  • 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 kare
  • STAR : Unicode U+2605 kod noktasına karşılık gelen bir yıldız
  • ALPHA : "a", "b" veya "c" gibi küçük bir harf.
  • UPPERALPHA : "A", "B" veya "C" gibi büyük bir harf.
  • DECIMAL : "1", "2" veya "3" gibi bir sayı.
  • ZERODECIMAL : Tek haneli sayıların önüne sıfır eklenmiş bir sayı ("01", "02" veya "03" gibi). Birden fazla basamaklı sayılara sıfır öneki eklenmez.
  • ROMAN : "i", "ii" veya "iii" gibi küçük harfli bir roma rakamı.
  • UPPERROMAN : "I", "II" veya "III" gibi büyük harfli bir Roma rakamı.
  • LEFTTRIANGLE : Unicode U+25c4 kod noktasına karşılık gelen, sola bakan bir üçgen
Sıralamalar
BULLET_GLYPH_PRESET_UNSPECIFIED Mermi simgesi hazır ayarı belirtilmemiş.
BULLET_DISC_CIRCLE_SQUARE İlk 3 liste iç içe yerleştirme seviyesi için DISC, CIRCLE ve SQUARE madde işaretiglifinin yer aldığı 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şaretiglifinin bulunduğu bir madde işaretli liste.
BULLET_CHECKBOX Tüm liste iç içe yerleştirme seviyeleri için CHECKBOX madde işareti glifleri içeren bir madde işaretli liste.
BULLET_ARROW_DIAMOND_DISC İlk 3 liste iç içe yerleştirme seviyesi için ARROW, DIAMOND ve DISC madde işaretiglifinin yer aldığı bir madde işaretli liste.
BULLET_STAR_CIRCLE_SQUARE İlk 3 liste iç içe yerleştirme seviyesi için STAR, CIRCLE ve SQUARE madde işaretiglifinin yer aldığı bir madde işaretli liste.
BULLET_ARROW3D_CIRCLE_SQUARE İlk 3 liste iç içe yerleştirme seviyesi için ARROW3D, CIRCLE ve SQUARE madde işaretiglifinin yer aldığı bir madde işaretli liste.
BULLET_LEFTTRIANGLE_DIAMOND_DISC İlk 3 liste iç içe yerleştirme seviyesi için LEFTTRIANGLE, DIAMOND ve DISC madde işaretiglifinin bulunduğu bir madde işaretli liste.
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE İlk 3 liste iç içe yerleştirme seviyesi için DIAMONDX, HOLLOWDIAMOND ve SQUARE madde işaretiglifinin yer aldığı bir madde işaretli liste.
BULLET_DIAMOND_CIRCLE_SQUARE İlk 3 liste iç içe yerleştirme seviyesi için DIAMOND, CIRCLE ve SQUARE madde işaretiglifinin yer aldığı bir madde işaretli liste.
NUMBERED_DECIMAL_ALPHA_ROMAN İlk 3 liste iç içe yerleştirme seviyesi için DECIMAL, ALPHA ve ROMAN sayısal gliflerin ardından noktaların yer aldığı bir numaralı liste.
NUMBERED_DECIMAL_ALPHA_ROMAN_PARENS İlk 3 liste iç içe yerleştirme seviyesi için DECIMAL, ALPHA ve ROMAN sayısal gliflerin ardından parantez içeren bir numaralı liste.
NUMBERED_DECIMAL_NESTED Noktalarla ayrılmış sayısal gliflerin yer aldığı, DECIMAL her iç içe yerleştirme düzeyinde önceki iç içe yerleştirme düzeyinin glifinin ön ek olarak kullanıldığı bir numaralı liste. Örneğin: "1.", '1.1.', '2.', '2.2.'.
NUMBERED_UPPERALPHA_ALPHA_ROMAN İlk 3 liste iç içe yerleştirme seviyesi için UPPERALPHA, ALPHA ve ROMAN sayısal gliflerin ardından noktaların yer aldığı bir numaralı liste.
NUMBERED_UPPERROMAN_UPPERALPHA_DECIMAL İlk 3 liste iç içe yerleştirme seviyesi için UPPERROMAN, UPPERALPHA ve DECIMAL sayısal gliflerin ardından noktaların yer aldığı bir numaralı liste.
NUMBERED_ZERODECIMAL_ALPHA_ROMAN İlk 3 liste iç içe yerleştirme seviyesi için ZERODECIMAL, ALPHA ve ROMAN sayısal gliflerin ardından noktaların yer aldığı bir numaralı liste.

DeleteParagraphBulletsRequest

Belirtilen aralıkla örtüşen tüm paragraflardaki madde işaretlerini siler.

İlgili paragrafın başına girinti ekleyerek her paragrafın iç içe yerleştirme düzeyi görsel olarak korunur.

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

object (Range)

Noktalı liste öğelerinin silineceği aralık.

CreateNamedRangeRequest

Belirtilen aralığa referans veren bir NamedRange oluşturur.

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

string

NamedRange nesnesinin adı. Adların benzersiz olması gerekmez.

Adlar, UTF-16 kod birimleri cinsinden en az 1 karakter ve en fazla 256 karakter uzunluğunda olmalıdır.

range

object (Range)

Adın uygulanacağı aralık.

DeleteNamedRangeRequest

Bir NamedRange silinir.

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 yapılması gerektiğini belirtmek için kullanılan ölçütler. Atlanırsa aralık silme işlemi tüm sekmelere uygulanır.

Tek sekme içeren bir dokümanda:

  • Sağlandıysa tekil sekmenin kimliğiyle eşleşmelidir.

  • Atlanırsa aralık silme işlemi tek 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ıkların silineceğini belirleyen değer. Tam olarak bir tane ayarlanmalıdır. named_range_reference yalnızca aşağıdakilerden 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 örtüşen 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 davranışını yansıtmak için başka değişikliklere neden olabilir. Daha fazla bilgi için ParagraphStyle dokümanlarını inceleyin.

fields

string (FieldMask format)

Güncellenmesi gereken alanlar.

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

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

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

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

object (Range)

Stil uygulanacak paragraflarla çakışan aralık.

DeleteContentRangeRequest

Dokümandan içerik siler.

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

object (Range)

Silecek içerik aralığı.

Bir paragraf sınırını aşan metin silindiğinde, iki paragraf birleştirildiği için paragraf stillerinde, listelerde, konumlandırılmış nesnelerde ve yer işaretlerinde değişiklikler olabilir.

Belirli aralıklara silme girişiminde bulunmak geçersiz bir doküman yapısına neden olabilir. Bu durumda 400 hatalı istek hatası döndürülür.

Geçersiz silme isteklerine örnek olarak aşağıdakiler verilebilir:

InsertInlineImageRequest

Belirtilen konuma resim içeren bir InlineObject ekler.

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

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

string

Resim URI'si.

Resim, eklenme sırasında bir kez getirilir ve dokümanda gösterilmek üzere bir kopyası saklanır. Resimler 50 MB'tan küçük, 25 megapikselden büyük olamaz ve PNG, JPEG veya GIF biçimlerinden birinde olmalıdır.

Sağlanan URI herkese açık olmalı ve en fazla 2 KB uzunluğunda olmalıdır. URI'nin kendisi resimle birlikte kaydedilir ve ImageProperties.content_uri alanı aracılığıyla gösterilir.

objectSize

object (Size)

Resmin dokümanda görünmesi gereken boyutu. 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 belirtilmezse resmin varsayılan boyutu, çözünürlüğüne göre hesaplanır. * Bir boyut belirtilirse diğer boyut, resmin en boy oranını korumak için hesaplanır. * Hem genişlik hem de yükseklik belirtilirse resim, en boy oranını koruyarak belirtilen boyutlara sığacak şekilde ölçeklenir.

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

object (Location)

Resmi dokümanda belirli bir dizine ekler.

Resim, mevcut bir Paragraph'ün sınırlarına yerleştirilmelidir. Örneğin, bir tablonun başlangıç dizine (ör. tablo ile önceki paragrafı arasına) eklenemez.

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

endOfSegmentLocation

object (EndOfSegmentLocation)

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

Satır içi resimler dipnotlara eklenemez.

InsertTableRequest

Belirtilen konuma bir tablo ekler.

Eklenen tablodan önce 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 yalnızca aşağıdakilerden biri olabilir:
location

object (Location)

Tabloyu belirli bir model dizine ekler.

Eklenen tablonun önüne yeni satır karakteri eklenir. Bu nedenle, tablo başlangıç dizini, belirtilen konum dizini + 1 olur.

Tablo, mevcut bir Paragraph'ün sınırları içine yerleştirilmelidir. Örneğin, bir tablonun başlangıç dizine (ör. 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 doküman gövdesinin sonuna ekler. Eklenen tablodan önce yeni satır karakteri eklenir.

Tablolar dipnotlara 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.

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

insertBelow

boolean

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

  • True : Hücrenin altına eklenir.
  • False : Hücrenin üzerine eklenir.

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.

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

insertRight

boolean

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

  • True : Sağa ekleyin.
  • False : Sola ekleme.

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

Tablodaki bir sütunu siler.

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

object (TableCellLocation)

Sütununun 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 bir 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
Birlik alanı insertion_location. Sayfa sonunun ekleneceği konum. insertion_location yalnızca aşağıdakilerden biri olabilir:
location

object (Location)

Sayfa sonunu dokümanda belirli bir dizinde ekler.

Sayfa sonu, mevcut bir Paragraph sınırına yerleştirilmelidir. Örneğin, bir tablonun başlangıç dizine (ör. 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ği için segment ID alanı boş olmalıdır.

endOfSegmentLocation

object (EndOfSegmentLocation)

Sayfa sonunu doküman gövdesinin sonuna ekler.

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

DeletePositionedObjectRequest

Dokümandan PositionedObject silebilir.

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

string

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

tabId

string

Silmek üzere konumlandırılmış nesnenin bulunduğu sekme. Atlanırsa istek ilk sekmeye uygulanır.

Tek sekme içeren bir dokümanda:

  • Sağlandıysa 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:

  • Gönderilirse istek belirtilen sekme için geçerli olur.

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

UpdateTableColumnPropertiesRequest

Tablodaki sütunların TableColumnProperties biçimini 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. Hiçbir dizin belirtilmezse tüm sütunlar güncellenir.

tableColumnProperties

object (TableColumnProperties)

Güncellenecek tablo sütunu özellikleri.

tableColumnProperties#width değerinin 5 puandan (5/72 inç) az 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 dizin tableColumnProperties ima edilir ve belirtilmemelidir. Her alanı listelemek için kısayol 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üncellenirken, bir hücre bitişik bir hücreyle kenar paylaşıyorsa bitişik hücrenin ilgili kenar özelliği de güncellenir. Birleştirilmiş ve görünmeyen kenarlıklar güncellenmez.

Aynı istekteki bitişik hücreler tarafından paylaşılan bir kenarlığın güncellenmesi, çakışan kenarlık güncellemelerine neden olabileceğinden kenarlık güncellemeleri aşağıdaki sırayla uygulanır:

  • borderRight
  • borderLeft
  • borderBottom
  • borderTop
fields

string (FieldMask format)

Güncellenmesi gereken alanlar.

En az bir alan belirtilmelidir. Kök dizin tableCellStyle ima edilir ve belirtilmemelidir. Her alanı listelemek için kısayol 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 özelliği varsayılan değerine sıfırlamak için alan maskesine alan adını ekleyin ancak alanın değerini ayarlanmamış bırakın.

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

object (TableRange)

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

tableStartLocation

object (Location)

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

TableRange

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

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

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

Tablo hücresi konumu = (tabloBaşlangıçKonumu, satır = 0, sütun = 0), satır kapsamı = 3 ve sütun kapsamı = 2 olan bir tablo aralığı aşağıdaki hücreleri belirtir:

 [ x ][ x ][   ]
 [ x ][ x ][   ]
 [ x    x    x ]
JSON gösterimi
{
  "tableCellLocation": {
    object (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 kapsamı.

columnSpan

integer

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

UpdateTableRowStyleRequest

Tablodaki satırların TableRowStyle sayısını 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 dizin tableRowStyle ima edilir ve belirtilmemelidir. Her alanı listelemek için kısayol 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 yeni bir resimle değiştirir.

Bir resmin değiştirilmesi, Docs düzenleyicisinin davranışını yansıtmak için mevcut resimden bazı image effects öğeleri kaldırı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, eklenme sırasında bir kez getirilir ve dokümanda gösterilmek üzere bir kopyası saklanır. Resimler 50 MB'tan küçük, 25 megapikselden büyük olamaz ve PNG, JPEG veya GIF biçiminde olmalıdır.

Sağlanan URI'nin uzunluğu 2 KB'ı aşamaz. URI, resimle birlikte kaydedilir ve ImageProperties.source_uri alanına yerleştirilir.

imageReplaceMethod

enum (ImageReplaceMethod)

Değişim yöntemi.

tabId

string

Değiştirilecek resmin bulunduğu sekme. Atlanırsa istek ilk sekmeye uygulanır.

Tek sekme içeren bir dokümanda:

  • Sağlandıysa 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:

  • Gönderilirse istek belirtilen sekme için geçerli olur.

  • 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çeklendirip ortalar. Resim, orijinal resmin sınırlarını dolduracak şekilde kırpılabilir. Resmin oluşturulan boyutu orijinal resimle aynı olur.

UpdateDocumentStyleRequest

DocumentStyle'yi günceller.

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

object (DocumentStyle)

Belgede ayarlanacak stiller.

Bazı doküman stili değişiklikleri, Dokümanlar düzenleyicisinin davranışını yansıtmak için başka değişikliklere neden olabilir. Daha fazla bilgi için DocumentStyle dokümanlarını inceleyin.

fields

string (FieldMask format)

Güncellenmesi gereken alanlar.

En az bir alan belirtilmelidir. Kök dizin documentStyle ima edilir ve belirtilmemelidir. Her alanı listelemek için kısayol 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. Atlanırsa istek ilk sekme için geçerli olur.

Tek sekme içeren bir dokümanda:

  • Sağlandıysa 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:

  • Gönderilirse istek belirtilen sekme için geçerli olur.

  • Bu parametre sağlanmazsa 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ştirilir ve aralığın "baş" hücresinde depolanır. İçerik yönü soldan sağa olduğunda aralıktaki sol üst hücre, aksi takdirde aralıktaki sağ üst hücredir.

Aralık dikdörtgen değilse (aralık halihazırda birleştirilmiş hücreleri kapsıyorsa veya tablo dikdörtgen değilse bu durum ortaya çıkabilir) 400 hatalı istek hatası döndürülür.

UnmergeTableCellsRequest

Birleştirilen hücreleri Table'te ayırır.

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

object (TableRange)

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

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

Birleştirilen hücrelerden herhangi birinde metin varsa metin, birleştirilmemiş hücrelerden oluşan blokun "baş" hücresinde kalır. "Baş" hücresi, içerik yönü soldan sağa doğru olduğunda sol üstteki hücredir, aksi takdirde sağ üstteki hücredir.

CreateHeaderRequest

Bir Header oluşturur. Yeni üstbilgi, belirtilmişse SectionBreak konumundaki SectionStyle'e, aksi takdirde DocumentStyle'ye uygulanır.

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

sectionBreakLocation

object (Location)

Bu başlığın ait olması gereken bölümün başladığı SectionBreak konumu. "sectionBreakLocation" ayarlanmamışsa veya doküman gövdesinde ilk bölüm sonunu belirtiyorsa başlık şu bölüm için geçerlidir: DocumentStyle

HeaderFooterType

Oluşturulabilecek başlık ve altbilgi türleri.

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

CreateFooterRequest

Bir Footer oluşturur. Yeni altbilgi, belirtilmişse SectionBreak konumundaki SectionStyle'e, aksi takdirde DocumentStyle'ye uygulanır.

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

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

enum (HeaderFooterType)

Oluşturulacak altbilginin türü.

sectionBreakLocation

object (Location)

Bu altbilginin ait olması gereken bölümden hemen önce gelen SectionBreak bölümündeki konum.SectionStyle Bu ayar yapılmamışsa veya dokümanda ilk bölüm sonunu belirtiyorsa altbilgi, doküman stili için geçerli olur.

CreateFootnoteRequest

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

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

JSON gösterimi
{

  // Union field 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 yalnızca aşağıdakilerden biri olabilir:
location

object (Location)

Dipnot referansını dokümanda belirli bir dizinde ekler.

Dipnot referansı, mevcut bir Paragraph'ün sınırlarına yerleştirilmelidir. Örneğin, bir tablonun başlangıç dizine (ör. tablo ile önceki paragrafı arasına) eklenemez.

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

endOfSegmentLocation

object (EndOfSegmentLocation)

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

Dipnot referansları bir üstbilgi, altbilgi veya dipnot içine eklenemez. Dipnot referansları yalnızca metne eklenebildiği için segment ID alanı boş olmalıdır.

ReplaceNamedRangeContentRequest

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

Bir NamedRange tek parça olmayabilir ve birden fazla 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 silinmesinin geçersiz bir doküman yapısıyla sonuçlanacağı durumlarda 400 hatalı istek hatası döndürülür.

JSON gösterimi
{
  "tabsCriteria": {
    object (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şimin hangi sekmelerde gerçekleşeceğini belirtmek için kullanılan ölçütler. Atlanırsa değiştirme işlemi tüm sekmelere uygulanır.

Tek sekme içeren bir dokümanda:

  • Sağlandıysa 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:

  • Belirtilen sekmeler için değiştirme işlemi uygulanır.

  • Atlanırsa değiştirme işlemi tüm sekmelere uygulanır.

Birlik alanı replacement_content. Adlandırılmış aralığın mevcut içeriğini değiştirecek içerik. replacement_content yalnızca aşağıdakilerden biri olabilir:
text

string

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

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

string

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

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

namedRangeName

string

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

Belirtilen ada sahip birden fazla öğe varsa bunların her birinin içeriği değiştirilir.named ranges Belirtilen ada sahip adlandırılmış aralık yoksa istek işleme alınmaz.

UpdateSectionStyleRequest

SectionStyle'yi günceller.

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

object (Range)

Stil uygulanacak bölümlerle çakışan aralık.

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

sectionStyle

object (SectionStyle)

Bölümde ayarlanacak stiller.

Bazı bölüm stili değişiklikleri, Docs düzenleyicisinin davranışını yansıtmak için başka değişikliklere neden olabilir. Daha fazla bilgi için SectionStyle dokümanlarını inceleyin.

fields

string (FieldMask format)

Güncellenmesi gereken alanlar.

En az bir alan belirtilmelidir. Kök dizin sectionStyle ima edilir ve belirtilmemelidir. Her alanı listelemek için kısayol 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 bir bölüm sonu ekler.

Bölüm sonuna 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 yalnızca aşağıdakilerden biri olabilir:
location

object (Location)

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

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

Bölüm sonları tablo, denklem, dipnot, üst bilgi veya alt bilgi içine eklenemez. Bölüm araları 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, üst bilgi veya alt bilgi içine eklenemez. Bölüm araları yalnızca gövdeye eklenebildiğinden segment ID alanı boş olmalıdır.

DeleteHeaderRequest

Dokümandan Header silebilir.

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

string

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

tabId

string

Silecek başlığı içeren sekme. Atlanırsa istek ilk sekmeye uygulanır.

Tek sekme içeren bir dokümanda:

  • Sağlandıysa 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:

  • Gönderilirse istek belirtilen sekme için geçerli olur.

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

DeleteFooterRequest

Dokümandan Footer silebilir.

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

string

Silecek altbilginin kimliği. Bu altbilgi DocumentStyle üzerinde tanımlanmışsa bu altbilgiye yapılan referans kaldırılır. Bu da dokümanın ilk bölümü için bu tür bir altbilgi olmamasına neden olur. Bu altbilgi bir SectionStyle üzerinde tanımlanmışsa bu altbilgiye yapılan referans kaldırılır ve bu tür altbilgi artık önceki bölümden devam eder.

tabId

string

Silecek altbilginin bulunduğu sekme. Atlanırsa istek ilk sekmeye uygulanır.

Tek sekme içeren bir dokümanda:

  • Sağlandıysa 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:

  • Gönderilirse istek belirtilen sekme için geçerli olur.

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

PinTableHeaderRowsRequest

Bir tablodaki sabitlenmiş tablo başlık 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 sabitlenmediğini gösterir.