Requests

İstek

Bir dokümana uygulanacak tek bir güncelleme.

JSON gösterimi 
{

  "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)
  },
  "addDocumentTab": {
    object (AddDocumentTabRequest)
  },
  "deleteTab": {
    object (DeleteTabRequest)
  },
  "updateDocumentTabProperties": {
    object (UpdateDocumentTabPropertiesRequest)
  },
  "insertPerson": {
    object (InsertPersonRequest)
  },
  "updateNamedStyle": {
    object (UpdateNamedStyleRequest)
  },
  "insertRichLink": {
    object (InsertRichLinkRequest)
  },
  "insertDate": {
    object (InsertDateRequest)
  },
  "insertComment": {
    object (InsertCommentRequest)
  },
  "addCommentReply": {
    object (AddCommentReplyRequest)
  },
  "updateCommentPost": {
    object (UpdateCommentPostRequest)
  },
  "deleteComment": {
    object (DeleteCommentRequest)
  },
  "deleteCommentReply": {
    object (DeleteCommentReplyRequest)
  },
  "acceptSuggestion": {
    object (AcceptSuggestionRequest)
  },
  "rejectSuggestion": {
    object (RejectSuggestionRequest)
  },
  "deleteSuggestion": {
    object (DeleteSuggestionRequest)
  }
}
Alanlar
Uygulanacak özel istek. Tam olarak bir alan gereklidir. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
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)

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

Tablodaki bir sütunu 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)

Belgeden bir üstbilgiyi siler.

pinTableHeaderRows

object (PinTableHeaderRowsRequest)

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

addDocumentTab

object (AddDocumentTabRequest)

Doküman sekmesi ekler.

deleteTab

object (DeleteTabRequest)

Döküman sekmesini siler.

updateDocumentTabProperties

object (UpdateDocumentTabPropertiesRequest)

Bir doküman sekmesinin özelliklerini günceller.

insertPerson

object (InsertPersonRequest)

Kullanıcı bahsetme ekler.

updateNamedStyle

object (UpdateNamedStyleRequest)

Adlandırılmış bir stili günceller.

insertDate

object (InsertDateRequest)

Tarih ekler.

insertComment

object (InsertCommentRequest)

Dokümana CommentThread ekler.

addCommentReply

object (AddCommentReplyRequest)

CommentThread veya SuggestionThread öğesine yanıt ekler.

updateCommentPost

object (UpdateCommentPostRequest)

Bir CommentThread veya SuggestionThread'nin mevcut bir gönderisini (ana gönderi veya yanıt) günceller.

deleteComment

object (DeleteCommentRequest)

CommentThread öğesini siler.

deleteCommentReply

object (DeleteCommentReplyRequest)

Bir yanıta Post CommentThread veya SuggestionThread yanıtını siler.

acceptSuggestion

object (AcceptSuggestionRequest)

Öneriyi kabul eder.

rejectSuggestion

object (RejectSuggestionRequest)

Öneriyi reddeder.

deleteSuggestion

object (DeleteSuggestionRequest)

Öneriyi siler.

Birbirini dışlayan alanların sonu.

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

  "containsText": {
    object (SubstringMatchCriteria)
  }
}
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:

  • Belirtilmişse tekil sekmenin kimliğiyle eşleşmelidir.

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

Birden çok sekme içeren bir dokümanda:

  • Sağlanırsa 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.

Değiştirilecek metni eşleştirmek için kullanılan ölçütler. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
containsText

object (SubstringMatchCriteria)

Belgede bu alt dizeyle eşleşen metni bulur.

Birbirini dışlayan alanların sonu.

SubstringMatchCriteria

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

JSON gösterimi 
{
  "text": string,
  "matchCase": boolean,
  "searchByRegex": 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.
searchByRegex

boolean

İsteğe bağlıdır. Bulunan değerin normal ifade olarak değerlendirilmesi gerekiyorsa doğru. Kalıptaki 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 ö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,

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
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 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 Basic Multilingual Plane Private Use Area'daki (U+E000-U+F8FF) karakterler, eklenen metinden çıkarılır.

Metnin ekleneceği konum. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
location

object (Location)

Metni belgedeki belirli bir dizine ekler.

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

endOfSegmentLocation

object (EndOfSegmentLocation)

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

Birbirini dışlayan alanların sonu.

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, 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:

  • Belirtilmişse tekil sekmenin kimliğiyle eşleşmelidir.

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

Birden çok 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 gelir.

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:

  • Belirtilmişse tekil sekmenin kimliğiyle eşleşmelidir.

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

Birden çok 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

Metnin stilini güncelleyin.

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

  "range": {
    object (Range)
  }
}
Alanlar
textStyle

object (TextStyle)

Metinde ayarlanacak stiller.

Belirli bir stilin değeri üst öğenin değeriyle eşleşiyorsa bu stil devralacak ş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 belgelerine göz atın.

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 özelliği varsayılan değerine sıfırlamak için alan adını alan maskesine ekleyin ancak alanı ayarlanmamış olarak bırakın.

Metin stilinin güncelleneceği aralığın türü. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
range

object (Range)

Stil uygulanacak metin aralığı.

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

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

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

Birbirini dışlayan alanların sonu.

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 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 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 önceden ayarlanmış 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 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 dolu bir 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 bir 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 harfler.
  • DECIMAL : "1", "2" veya "3" gibi bir sayı.
  • ZERODECIMAL : Tek haneli sayıların başına sıfır eklenerek oluşturulan bir sayı (ör. "01", "02" veya "03"). Birden fazla basamağı olan numaraların başına sıfır eklenmez.
  • ROMAN : "i", "ii" veya "iii" gibi küçük harfli bir Roma rakamı.
  • UPPERROMAN : "I", "II" veya "III" gibi büyük harfli bir Romen 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ı belirtilmedi.
BULLET_DISC_CIRCLE_SQUARE İlk 3 liste iç içe yerleştirme seviyesi için DISC, CIRCLE ve SQUARE madde işaretli glifini içeren madde işaretli bir liste.
BULLET_DIAMONDX_ARROW3D_SQUARE İlk 3 liste iç içe yerleştirme seviyesi için DIAMONDX, ARROW3D ve SQUARE madde işaretli glifini içeren madde işaretli bir liste.
BULLET_CHECKBOX Tüm liste iç içe yerleştirme düzeyleri için CHECKBOX madde işareti glifleri içeren madde işaretli bir liste.
BULLET_ARROW_DIAMOND_DISC İlk 3 liste iç içe yerleştirme seviyesi için ARROW, DIAMOND ve DISC madde işaretli glifini içeren madde işaretli bir liste.
BULLET_STAR_CIRCLE_SQUARE İlk 3 liste iç içe yerleştirme seviyesi için STAR, CIRCLE ve SQUARE madde işaretli glifini içeren madde işaretli bir liste.
BULLET_ARROW3D_CIRCLE_SQUARE İlk 3 liste iç içe yerleştirme seviyesi için ARROW3D, CIRCLE ve SQUARE madde işaretli glifini içeren madde işaretli bir liste.
BULLET_LEFTTRIANGLE_DIAMOND_DISC İlk 3 liste iç içe yerleştirme seviyesi için LEFTTRIANGLE, DIAMOND ve DISC madde işaretli glifini içeren madde işaretli bir liste.
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE İlk 3 liste iç içe yerleştirme seviyesi için DIAMONDX, HOLLOWDIAMOND ve SQUARE madde işaretli glifini içeren madde işaretli bir liste.
BULLET_DIAMOND_CIRCLE_SQUARE İlk 3 liste iç içe yerleştirme seviyesi için DIAMOND, CIRCLE ve SQUARE madde işaretli glifini içeren madde işaretli bir liste.
NUMBERED_DECIMAL_ALPHA_ROMAN İlk 3 liste iç içe yerleştirme seviyesi için DECIMAL, ALPHA ve ROMAN sayısal gliflerinin kullanıldığı, ardından nokta gelen numaralı bir liste.
NUMBERED_DECIMAL_ALPHA_ROMAN_PARENS İlk 3 liste iç içe yerleştirme seviyesi için DECIMAL, ALPHA ve ROMAN sayısal gliflerini içeren, ardından parantez gelen numaralı liste.
NUMBERED_DECIMAL_NESTED Aşağıdaki özelliklere sahip numaralı liste: DECIMAL Noktalarla ayrılmış sayısal glifler. Her iç içe yerleştirme düzeyi, önceki iç içe yerleştirme düzeyinin glifini ön ek olarak kullanır. Örneğin: "1.", '1.1.', "2.", "2.2.".
NUMBERED_UPPERALPHA_ALPHA_ROMAN İlk 3 liste iç içe yerleştirme seviyesi için UPPERALPHA, ALPHA ve ROMAN sayısal gliflerinin kullanıldığı, ardından nokta gelen numaralı bir liste.
NUMBERED_UPPERROMAN_UPPERALPHA_DECIMAL İlk 3 liste iç içe yerleştirme seviyesi için UPPERROMAN, UPPERALPHA ve DECIMAL sayısal gliflerinin kullanıldığı, ardından nokta gelen numaralı bir liste.
NUMBERED_ZERODECIMAL_ALPHA_ROMAN İlk 3 liste iç içe yerleştirme seviyesi için ZERODECIMAL, ALPHA ve ROMAN sayısal gliflerinin kullanıldığı, 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)

Madde işaretlerinin 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

Adlandırılmış aralığın adı. Adların benzersiz olması gerekmez.

Adlar en az 1 karakter, en fazla 256 karakter olmalıdır (UTF-16 kod birimleriyle ölçülür).

range

object (Range)

Adın uygulanacağı aralık.

DeleteNamedRangeRequest

NamedRange öğesini siler.

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

  "namedRangeId": string,
  "name": string
}
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:

  • Belirtilmişse tekil sekmenin kimliğiyle eşleşmelidir.

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

Birden çok 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.

Hangi aralıkların silineceğini belirleyen değer. Tam olarak bir tane ayarlanmalıdır. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
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.

Birbirini dışlayan alanların sonu.

UpdateParagraphStyleRequest

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

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

  "range": {
    object (Range)
  }
}
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 belgelerine göz atın.

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 özelliği varsayılan değerine sıfırlamak için alan adını alan maskesine ekleyin ancak alanı ayarlanmamış olarak bırakın.

Paragraf stilinin güncelleneceği aralığın türü. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
range

object (Range)

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

Birbirini dışlayan alanların sonu.

DeleteContentRangeRequest

Belgedeki 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ıyla sonuçlanabilir. Bu durumda 400 hatalı istek hatası döndürülür.

Geçersiz silme isteklerine bazı örnekler:

InsertInlineImageRequest

Belirtilen konuma, resim içeren bir InlineObject ekler.

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

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
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. Görseller 50 MB'tan küçük olmalı, 25 megapikseli aşmamalı ve PNG, JPEG veya GIF biçimlerinden birinde olmalıdır.

Sağlanan URI, herkesin erişimine açık olmalı ve uzunluğu en fazla 2 kB olmalıdır. URI, resimle birlikte kaydedilir ve ImageProperties.content_uri alanında gösterilir.

objectSize

object (Size)

Resmin belgede görüneceği boyut. Bu özellik isteğe bağlıdır ve dokümandaki resmin son 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.

Resmin ekleneceği konum. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
location

object (Location)

Görüntüyü belgedeki belirli bir dizine ekler.

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

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

endOfSegmentLocation

object (EndOfSegmentLocation)

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

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

Birbirini dışlayan alanların sonu.

InsertTableRequest

Belirtilen konuma tablo ekler.

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

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

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
Alanlar
rows

integer

Tablodaki satır sayısı.

columns

integer

Tablodaki sütun sayısı.

Tablonun ekleneceği konum. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
location

object (Location)

Tabloyu belirli bir model dizinine ekler.

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

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

Tablolar dipnot veya denklemin 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.

Birbirini dışlayan alanların sonu.

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

insertBelow

boolean

Yeni satırın referans hücre konumunun altına eklenip eklenmeyeceği.

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

TableCellLocation

Tablo içindeki 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 bir 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

Tablodaki bir sütunu 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 
{

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
Alanlar
Sayfa sonunun ekleneceği konum. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
location

object (Location)

Belgeye belirli bir dizinde sayfa sonu ekler.

Sayfa sonu, mevcut bir Paragraph sınırları içine yerleştirilmelidir. Örneğin, 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, üstbilgi veya altbilgi içine eklenemez. Sayfa sonları yalnızca gövdeye eklenebildiğinden segment ID alanı boş olmalıdır.

Birbirini dışlayan alanların sonu.

DeletePositionedObjectRequest

Belgeden 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:

  • Belirtilmişse tekil sekmenin kimliğiyle eşleşmelidir.

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

Birden çok 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.

Değeri tableColumnProperties#width 5 noktadan (5/72 inç) azsa 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,

  "tableRange": {
    object (TableRange)
  },
  "tableStartLocation": {
    object (Location)
  }
}
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 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 özelliği varsayılan değerine sıfırlamak için alan adını alan maskesine ekleyin ancak alanı ayarlanmamış olarak bırakın.

Güncellenecek hücreler. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
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.

Birbirini dışlayan alanların sonu.

TableRange

Tablo aralığı, tablonun bir alt kümesine yapılan referansı temsil 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, row = 0, column = 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 yeni bir resimle 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.

Belirtilen 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 görüntünün bulunduğu sekme. Atlandığında istek ilk sekme için geçerli olur.

Tek sekme içeren bir dokümanda:

  • Belirtilmişse tekil sekmenin kimliğiyle eşleşmelidir.

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

Birden çok 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 Orijinal resmin sınırlarını doldurmak için resmi ö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üncellendi.

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 belgelerine göz atın.

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:

  • Belirtilmişse tekil sekmenin kimliğiyle eşleşmelidir.

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

Birden çok 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 önceden 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ştirilenleri ayrılacağını belirten tablo aralığı.

Bu aralıktaki tüm birleştirilmiş hücrelerin birleştirilmesi iptal edilir ve birleştirilmesi iptal edilmiş olan 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ç bloğunun "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 başlık, belirtilmişse SectionStyle konumundaki SectionBreak 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ık türü.

sectionBreakLocation

object (Location)

Bu başlığın ait olması gereken bölümün başladığı 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 üstbilgi/altbilgi.

CreateFooterRequest

Footer oluşturur. Yeni altbilgi, belirtilmişse SectionStyle konumundaki SectionBreak için, belirtilmemişse DocumentStyle için geçerli olur.

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 öğesinin konumu. Bu ayar yapılmamışsa veya belgedeki ilk bölüm sonunu ifade ediyorsa altbilgi, belge stiline uygulanır.

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çerecek.

JSON gösterimi 
{

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
Alanlar
Dipnot referansının ekleneceği konum. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
location

object (Location)

Dipnot referansını belgedeki belirli bir dizine ekler.

Dipnot referansı, mevcut bir Paragraph sınırları içine eklenmelidir. Örneğin, 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.

Birbirini dışlayan alanların sonu.

ReplaceNamedRangeContentRequest

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

Bir bireyin NamedRange birden fazla kesintili ranges içerebileceğini unutmayın. 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)
  },

  "text": string

  "namedRangeId": string,
  "namedRangeName": string
}
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:

  • Belirtilmişse tekil sekmenin kimliğiyle eşleşmelidir.

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

Birden çok sekme içeren bir dokümanda:

  • Sağlanırsa 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.

Adlandırılmış aralığın mevcut içeriğinin yerine kullanılacak içerik. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
text

string

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

Birbirini dışlayan alanların sonu.
İçeriği değiştirilecek olan adlandırılmış aralıklara yapılan bir referans. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
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 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.

Birbirini dışlayan alanların sonu.

UpdateSectionStyleRequest

SectionStyle güncellendi.

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 belgelerine göz atın.

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

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
Alanlar
sectionType

enum (SectionType)

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

Aranın ekleneceği konum. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
location

object (Location)

Belgedeki 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, tablonun başlangıç dizinine (yani 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 sonları yalnızca gövdeye eklenebildiğinden segment ID alanı boş olmalıdır.

endOfSegmentLocation

object (EndOfSegmentLocation)

Belge gövdesinin sonuna yeni bir 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.

Birbirini dışlayan alanların sonu.

DeleteHeaderRequest

Belgeden Header öğesini siler.

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

string

Silinecek üstbilginin kimliği. Bu başlık DocumentStyle üzerinde tanımlanmışsa bu başlığa yapılan referans kaldırılır ve belgenin ilk bölümünde bu türden bir başlık olmaz. 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:

  • Belirtilmişse tekil sekmenin kimliğiyle eşleşmelidir.

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

Birden çok 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

Belgeden 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 dokümanın ilk bölümünde bu türde 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:

  • Belirtilmişse tekil sekmenin kimliğiyle eşleşmelidir.

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

Birden çok 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ırlarının sayısıdır. 0, tüm satırların sabitlenmediği anlamına gelir.

AddDocumentTabRequest

Doküman sekmesi ekler. Belirli bir dizine sekme eklendiğinde, sonraki tüm sekmelerin dizinleri artırılır.

JSON gösterimi 
{
  "tabProperties": {
    object (TabProperties)
  }
}
Alanlar
tabProperties

object (TabProperties)

Eklenecek sekmenin özellikleri. Tüm özellikler isteğe bağlıdır.

DeleteTabRequest

Sekmeyi siler. Sekmede alt sekmeler varsa bunlar da silinir.

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

string

Silinecek sekmenin kimliği.

UpdateDocumentTabPropertiesRequest

Doküman sekmesinin özelliklerini güncelleyin.

JSON gösterimi 
{
  "tabProperties": {
    object (TabProperties)
  },
  "fields": string
}
Alanlar
tabProperties

object (TabProperties)

Güncellenecek sekme özellikleri.

fields

string (FieldMask format)

Güncellenmesi gereken alanlar.

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

InsertPersonRequest

Kullanıcı bahsetme ekler.

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

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
Alanlar
personProperties

object (PersonProperties)

Eklenecek kişi bahsinin özellikleri.

Kişi bahsinin ekleneceği konum. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
location

object (Location)

Belirtilen kişinin bahsinin, dokümanda belirli bir dizine eklenmesini sağlar.

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

Kişi bahsetmeleri denklemlerin içine eklenemez.

endOfSegmentLocation

object (EndOfSegmentLocation)

Kişi bahsini üstbilgi, altbilgi, dipnot veya belge gövdesinin sonuna ekler.

Birbirini dışlayan alanların sonu.

UpdateNamedStyleRequest

Adlandırılmış bir stili günceller.

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

object (NamedStyle)

Güncellenecek doküman stili.

fields

string (FieldMask format)

Güncellenmesi gereken NamedStyle alanları.

En az namedStyleType belirtilmelidir. Kök namedStyle ö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 "textStyle" ve "textStyle.bold" olarak ayarlayın. Paragraf stilinin hizalama özelliğini güncellemek için fields değerini "paragraphStyle" ve "paragraphStyle.alignment" değerlerini içerecek şekilde ayarlayın.

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. Boş bir TextStyle veya ParagraphStyle ile "textStyle" ya da "paragraphStyle" belirtmek, iç içe yerleştirilmiş tüm alanlarını sıfırlar.

tabId

string

Güncellenecek doküman sekmesi. Varsayılan olarak güncelleme ilk sekmeye uygulanır.

InsertRichLinkRequest

Belirtilen konuma RichLink ekler.

JSON gösterimi 
{
  "richLinkProperties": {
    object (RichLinkProperties)
  },

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
Alanlar
Zengin bağlantının ekleneceği konum. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
location

object (Location)

Zengin bağlantıyı belgedeki belirli bir dizine ekler.

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

Zengin bağlantı, denklemin içine eklenemez.

endOfSegmentLocation

object (EndOfSegmentLocation)

Zengin bağlantıyı başlığın, altbilginin, dipnotun veya belge gövdesinin sonuna ekler.

Birbirini dışlayan alanların sonu.

InsertDateRequest

Belirtilen konuma tarih ekler.

JSON gösterimi 
{
  "dateElementProperties": {
    object (DateElementProperties)
  },

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
Alanlar
dateElementProperties

object (DateElementProperties)

Eklenecek tarihin özellikleri.

Tarihin ekleneceği konum. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
location

object (Location)

Belirli bir dizindeki belgeye tarihi ekler.

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

endOfSegmentLocation

object (EndOfSegmentLocation)

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

Birbirini dışlayan alanların sonu.

InsertCommentRequest

Dokümana CommentThread ekler.

JSON gösterimi 
{
  "content": string,
  "assigneeEmailAddress": string,

  "range": {
    object (Range)
  }
}
Alanlar
content

string

Yorumun metni düz metin olarak.

Bu metin içeriği, Dokümanlar düzenleyicisinde oluşturulan yorumlara benzer şekilde ele alınır. Biçimlendirme, bildirimler vb. için benzer davranışlar gösterir.

Bu alan boş bırakılamaz ve 2.048 UTF-8 kod birimini aşmamalıdır.

assigneeEmailAddress

string

İsteğe bağlıdır. Yorumun atandığı kullanıcının e-posta adresi.

Atanmamış bir yorum için boş bırakın.

2048 UTF-8 kod birimini aşamaz.

Dokümanda bu yorumla ilişkili konum. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
range

object (Range)

Bu yoruma bağlı dokümandaki Range.

Birbirini dışlayan alanların sonu.

AddCommentReplyRequest

Post içine CommentThread veya SuggestionThread ekler.

JSON gösterimi 
{
  "post": {
    object (Post)
  },

  "commentId": string,
  "suggestionId": string
}
Alanlar
post

object (Post)

Yanıtı temsil eden Post.

Yanıtın ekleneceği ileti dizisinin kimliği. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
commentId

string

Yanıtın ekleneceği CommentThread kimliği.

suggestionId

string

Yanıtın ekleneceği SuggestionThread kimliği.

Birbirini dışlayan alanların sonu.

UpdateCommentPostRequest

Post içeriğini CommentThread veya SuggestionThread içinde günceller.

Aşağıdaki durumlarda 400 hatalı istek hatası döndürülür:

  • Gönderi, bir SuggestionThread'in headPost'idir.

  • İstekte bulunan kullanıcı, yayının yazarı değil.

JSON gösterimi 
{
  "postId": string,
  "content": string,

  "commentId": string,
  "suggestionId": string
}
Alanlar
postId

string

Güncellenen yayının kimliği.

content

string

Yorumun yeni metni (düz metin olarak).

Bu metin içeriği, Dokümanlar düzenleyicisinde oluşturulan yorumlara benzer şekilde ele alınır. Biçimlendirme, bildirimler vb. için benzer davranışlar gösterir.

Bu alan boş bırakılamaz ve 2.048 UTF-8 kod birimini aşmamalıdır.

Yayının ait olduğu ileti dizisinin kimliği. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
commentId

string

Yayının ait olduğu CommentThread kimliği.

suggestionId

string

Yayının ait olduğu SuggestionThread kimliği.

Birbirini dışlayan alanların sonu.

DeleteCommentRequest

CommentThread öğesini siler.

İstekte bulunan kullanıcı headPost öğesinin yazarı değilse 400 hatalı istek hatası döndürülür.

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

string

Silinen CommentThread kimliği.

DeleteCommentReplyRequest

Bir yanıta Post CommentThread veya SuggestionThread simgesi ekler.

Aşağıdaki durumlarda 400 hatalı istek hatası döndürülür:

  • İstekte bulunan kullanıcı, yayının yazarı değil.

  • Yanıt gönderisinde [action][google.apps.docs.v1.Post.action] var.

  • Yanıt gönderisinde assignee var.

JSON gösterimi 
{
  "postId": string,

  "commentId": string,
  "suggestionId": string
}
Alanlar
postId

string

Silinecek yanıtın kimliği. Post

Yayının ait olduğu ileti dizisinin kimliği. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
commentId

string

Yayının ait olduğu CommentThread kimliği.

suggestionId

string

Yayının ait olduğu SuggestionThread kimliği.

Birbirini dışlayan alanların sonu.

AcceptSuggestionRequest

Öneriyi kabul eder.

İstek gönderen kullanıcının doküman üzerinde düzenleme erişimi yoksa 403 yasaklandı hatasını döndürür.

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

string

Önerinin kimliği.

RejectSuggestionRequest

Öneriyi reddeder.

İstekte bulunan kullanıcının dokümanda düzenleme erişimi yoksa ve önerinin yazarı değilse 403 yasaklandı hatası döndürülür.

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

string

Önerinin kimliği.

DeleteSuggestionRequest

Öneriyi siler.

İstekte bulunan kullanıcı önerinin yazarı değilse 403 yasaklandı hatasını döndürür.

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

string

Önerinin kimliği.