Requests

İstek

Bir belgeye 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
Birleştirme alanı request. Uygulanacak özel istek. Tam olarak bir alan gereklidir. request aşağıdakilerden yalnızca biri olabilir:
replaceAllText

object (ReplaceAllTextRequest)

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

insertText

object (InsertTextRequest)

Metni belirtilen konuma ekler.

updateTextStyle

object (UpdateTextStyleRequest)

Belirtilen aralıktaki metin stilini günceller.

createParagraphBullets

object (CreateParagraphBulletsRequest)

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

deleteParagraphBullets

object (DeleteParagraphBulletsRequest)

Paragraflardaki madde işaretlerini siler.

createNamedRange

object (CreateNamedRangeRequest)

Adlandırılmış bir 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 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)

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

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

Bir CommentThread öğesini siler.

deleteCommentReply

object (DeleteCommentReplyRequest)

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

acceptSuggestion

object (AcceptSuggestionRequest)

Öneriyi kabul eder.

rejectSuggestion

object (RejectSuggestionRequest)

Öneriyi reddeder.

deleteSuggestion

object (DeleteSuggestionRequest)

Öneriyi siler.

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ı. 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 sekmelere uygulanır.

Tek sekme içeren bir dokümanda:

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

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

Birden fazla sekme içeren bir dokümanda:

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

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

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

object (SubstringMatchCriteria)

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

SubstringMatchCriteria

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

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

string

Dokümanda aranacak metin.

matchCase

boolean

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

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

boolean

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

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

TabsCriteria

Bir isteğin hangi sekmelerde yürütüleceğini belirten ö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 geçerli ekleme dizinindeki paragraftan kopyalanır.

Eklenen metinlerin metin stilleri otomatik olarak belirlenir ve genellikle komşu metinlerin stili korunur. Çoğu durumda, eklenen metnin metin stili, ekleme dizininden hemen önce gelen metinle eşleşir.

Bazı kontrol karakterleri (U+0000-U+0008, U+000C-U+001F) ve Unicode Temel Çok Dilli Düzlem Özel Kullanım Alanı'ndaki (U+E000-U+F8FF) karakterler, eklenen metinden çıkarılır.

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

object (Location)

Metni dokümanda belirli bir dizine ekler.

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

endOfSegmentLocation

object (EndOfSegmentLocation)

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

Konum

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:

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

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

Birden fazla sekme içeren bir dokümanda:

  • Sağlanırsa istek, belirtilen sekme için geçerli olur.

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

EndOfSegmentLocation

Gövde, başlık, 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:

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

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

Birden fazla sekme içeren bir dokümanda:

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

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

fields

string (FieldMask format)

Güncellenmesi gereken alanlar.

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

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

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

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

object (Range)

Stil uygulanacak metin aralığı.

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

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

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

CreateParagraphBulletsRequest

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

Her paragrafın iç içe yerleştirme düzeyi, her paragrafın önündeki baştaki sekmeler sayılarak belirlenir. Madde işareti ile ilgili paragraf arasında fazla boşluk olmaması için bu istekte baştaki sekmeler kaldırılır. Bu durum, metnin bazı bölümlerinin dizinlerini değiştirebilir.

Güncellenen paragraflardan hemen önceki paragraf, eşleşen bir hazır ayarın bulunduğu listedeyse güncellenen paragraflar bu önceki listeye eklenir.

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

object (Range)

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

bulletPreset

enum (BulletGlyphPreset)

Kullanılacak madde işareti glifleri.

BulletGlyphPreset

Listeler için madde işareti gliflerinin hazır ayar 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 içi boş 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 yıldız
  • ALPHA : "a", "b" veya "c" gibi küçük bir harf.
  • UPPERALPHA : "A", "B" veya "C" gibi büyük harf.
  • DECIMAL : "1", "2" veya "3" gibi bir sayı.
  • ZERODECIMAL : Tek haneli sayıların başına sıfır eklenerek oluşturulan sayılar (ör. "01", "02" veya "03"). Birden fazla rakam içeren sayılara sıfır öneki eklenmez.
  • ROMAN : "i", "ii" veya "iii" gibi küçük harfli bir Roma rakamı.
  • UPPERROMAN : "I", "II" veya "III" gibi büyük harfli bir Roma rakamı.
  • LEFTTRIANGLE : Unicode U+25c4 kod noktasına karşılık gelen, sola bakan bir üçgen
Sıralamalar
BULLET_GLYPH_PRESET_UNSPECIFIED Madde işareti glif hazır ayarı belirtilmemiş.
BULLET_DISC_CIRCLE_SQUARE İlk 3 liste iç içe yerleştirme seviyesi için DISC, CIRCLE ve SQUARE madde işaretli glifleri 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 glifleri içeren madde işaretli bir liste.
BULLET_CHECKBOX Tüm liste iç içe yerleştirme seviyeleri için CHECKBOX madde işaretli glifler içeren madde işaretli liste.
BULLET_ARROW_DIAMOND_DISC İlk 3 liste iç içe yerleştirme seviyesi için ARROW, DIAMOND ve DISC madde işaretli glifleri 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 glifleri 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 glifleri 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 glifleri 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 glifleri 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 glifleri 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 glifleri içeren ve ardından nokta gelen numaralı 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 Noktalarla ayrılmış sayısal glifler içeren numaralı liste. Her iç içe yerleştirme düzeyi, önceki iç içe yerleştirme düzeyinin glifini ön ek olarak kullanır. DECIMAL Örneğin: "1.", '1.1.', '2.', "2.2."
NUMBERED_UPPERALPHA_ALPHA_ROMAN İlk 3 liste iç içe yerleştirme seviyesi için UPPERALPHA, ALPHA ve ROMAN sayısal glifleri içeren ve ardından nokta gelen numaralı 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 işaretlerinin geldiği numaralı bir liste.
NUMBERED_ZERODECIMAL_ALPHA_ROMAN İlk 3 liste iç içe yerleştirme seviyesi için ZERODECIMAL, ALPHA ve ROMAN sayısal glifleri içeren ve ardından nokta gelen numaralı liste.

DeleteParagraphBulletsRequest

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

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

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

object (Range)

Maddelerin silineceği aralık.

CreateNamedRangeRequest

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

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

string

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

Adlar, UTF-16 kod birimleriyle ölçüldüğünde en az 1 karakter, en fazla 256 karakter uzunluğunda olmalıdır.

range

object (Range)

Adın uygulanacağı aralık.

DeleteNamedRangeRequest

NamedRange siler.

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

  "namedRangeId": string,
  "name": string
}
Alanlar
tabsCriteria

object (TabsCriteria)

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

Tek sekme içeren bir dokümanda:

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

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

Birden fazla sekme içeren bir dokümanda:

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

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

Birleştirme alanı named_range_reference. Hangi aralıkların silineceğini belirleyen değer. Tam olarak bir tane ayarlanmalıdır. named_range_reference aşağıdakilerden yalnızca biri olabilir:
namedRangeId

string

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

name

string

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

UpdateParagraphStyleRequest

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

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

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

fields

string (FieldMask format)

Güncellenmesi gereken alanlar.

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

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

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

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

object (Range)

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

DeleteContentRangeRequest

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ına neden olabilir. Bu durumda 400 hatalı istek hatası döndürülür.

Geçersiz silme isteklerine bazı örnekler:

InsertInlineImageRequest

Belirtilen konumda resim içeren bir InlineObject ekler.

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

  "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. Resimler 50 MB'tan küçük olmalı, 25 megapikseli aşmamalı ve PNG, JPEG veya GIF biçimlerinden birinde olmalıdır.

Sağlanan URI, herkesin erişimine 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 belgede görüneceği boyut. Bu özellik isteğe bağlıdır ve belgedeki resmin son 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ı koruyacak şekilde hesaplanır. * Hem genişlik hem de yükseklik belirtilmişse resim, en boy oranı korunarak belirtilen boyutlara sığacak şekilde ölçeklendirilir.

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

object (Location)

Resmi dokümanda belirli bir dizine ekler.

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

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

endOfSegmentLocation

object (EndOfSegmentLocation)

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

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

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

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

object (Location)

Tabloyu belirli bir model dizinine ekler.

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

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

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

InsertTableRowRequest

Tabloya boş bir satır ekler.

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

object (TableCellLocation)

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

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

insertBelow

boolean

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

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

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 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
Birleştirme alanı insertion_location. Sayfa sonunun ekleneceği konum. insertion_location aşağıdakilerden yalnızca biri olabilir:
location

object (Location)

Sayfa sonunu belgedeki belirli bir dizine ekler.

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

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

endOfSegmentLocation

object (EndOfSegmentLocation)

Sayfa sonunu belge gövdesinin sonuna ekler.

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

DeletePositionedObjectRequest

Dokümandaki PositionedObject öğesini siler.

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

string

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

tabId

string

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

Tek sekme içeren bir dokümanda:

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

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

Birden fazla sekme içeren bir dokümanda:

  • Sağlanırsa 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 değerini günceller.

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

object (Location)

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

columnIndices[]

integer

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

tableColumnProperties

object (TableColumnProperties)

Güncellenecek tablo sütunu özellikleri.

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

fields

string (FieldMask format)

Güncellenmesi gereken alanlar.

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

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

UpdateTableCellStyleRequest

Bir tablo hücresi aralığının stilini günceller.

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

  "tableRange": {
    object (TableRange)
  },
  "tableStartLocation": {
    object (Location)
  }
}
Alanlar
tableCellStyle

object (TableCellStyle)

Tablo hücrelerinde ayarlanacak stil.

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

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

  • borderRight
  • borderLeft
  • borderBottom
  • borderTop
fields

string (FieldMask format)

Güncellenmesi gereken alanlar.

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

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

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

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

object (TableRange)

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

tableStartLocation

object (Location)

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

TableRange

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

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

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

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

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

object (TableCellLocation)

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

rowSpan

integer

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

columnSpan

integer

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

UpdateTableRowStyleRequest

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

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

object (Location)

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

rowIndices[]

integer

Stili güncellenmesi gereken sıfır tabanlı satır dizinlerinin listesi. Dizin belirtilmezse tüm satırlar güncellenir.

tableRowStyle

object (TableRowStyle)

Satırlarda ayarlanacak stiller.

fields

string (FieldMask format)

Güncellenmesi gereken alanlar.

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

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

ReplaceImageRequest

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

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

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

string

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

uri

string

Yeni resmin URI'si.

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

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

imageReplaceMethod

enum (ImageReplaceMethod)

Değiştirme yöntemi.

tabId

string

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

Tek sekme içeren bir dokümanda:

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

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

Birden fazla sekme içeren bir dokümanda:

  • Sağlanırsa 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 Orijinal resmin sınırlarını dolduracak şekilde 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üncellenir.

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

object (DocumentStyle)

Belgede ayarlanacak stiller.

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

fields

string (FieldMask format)

Güncellenmesi gereken alanlar.

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

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

tabId

string

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

Tek sekme içeren bir dokümanda:

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

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

Birden fazla sekme içeren bir dokümanda:

  • Sağlanırsa istek, belirtilen sekme için geçerli olur.

  • 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ştirileceğini belirten tablo aralığı.

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

Birleştirilen hücrelerden herhangi birinde metin varsa bu metin, birleştirilmemiş hücrelerden oluşan sonuç 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 üstbilgi, belirtilmişse SectionStyle konumundaki SectionBreak için, belirtilmemişse DocumentStyle için geçerli olur.

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

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

enum (HeaderFooterType)

Oluşturulacak başlığın türü.

sectionBreakLocation

object (Location)

Bu başlığın ait olması gereken bölümün başladığı SectionBreak konumudur. SectionBreak `sectionBreakLocation` ayarlanmamışsa veya doküman gövdesindeki ilk bölüm sonunu ifade ediyorsa 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 SectionBreak konumundaki SectionStyle için geçerlidir. Aksi takdirde, DocumentStyle için geçerlidir.

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

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

enum (HeaderFooterType)

Oluşturulacak altbilgi türü.

sectionBreakLocation

object (Location)

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

CreateFootnoteRequest

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

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

JSON gösterimi 
{

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
Alanlar
Birleştirme alanı footnote_reference_location. Dipnot referansının ekleneceği konum. footnote_reference_location aşağıdakilerden yalnızca biri olabilir:
location

object (Location)

Dipnot referansını belgedeki belirli bir dizine ekler.

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

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

endOfSegmentLocation

object (EndOfSegmentLocation)

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

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

ReplaceNamedRangeContentRequest

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

Bir NamedRange birden fazla 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ı. 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 sekmelere uygulanır.

Tek sekme içeren bir dokümanda:

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

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

Birden fazla sekme içeren bir dokümanda:

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

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

Birleştirme alanı replacement_content. Adlandırılmış aralığın mevcut içeriğinin yerine kullanılacak içerik. replacement_content aşağıdakilerden yalnızca biri olabilir:
text

string

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

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

string

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

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

namedRangeName

string

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

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

UpdateSectionStyleRequest

SectionStyle güncellenir.

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

object (Range)

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

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

sectionStyle

object (SectionStyle)

Bölümde ayarlanacak stiller.

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

fields

string (FieldMask format)

Güncellenmesi gereken alanlar.

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

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

InsertSectionBreakRequest

Belirtilen konuma bölüm sonu ekler.

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

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

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

enum (SectionType)

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

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

object (Location)

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

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

Bölüm sonları tablo, denklem, dipnot, ü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 satır ve bölüm sonu ekler.

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

DeleteHeaderRequest

Dokümandaki Header öğesini siler.

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

string

Silinecek üstbilginin kimliği. Bu 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:

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

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

Birden fazla sekme içeren bir dokümanda:

  • Sağlanırsa istek, belirtilen sekme için geçerli olur.

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

DeleteFooterRequest

Dokümandaki Footer öğesini siler.

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

string

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

tabId

string

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

Tek sekme içeren bir dokümanda:

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

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

Birden fazla sekme içeren bir dokümanda:

  • Sağlanırsa istek, belirtilen sekme için geçerli olur.

  • 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 bahsetme özelliğinin adı.

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

object (Location)

Kişi bahsetmesini belgedeki belirli bir dizine ekler.

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

Kişi bahsetmeleri denklemlerin içine eklenemez.

endOfSegmentLocation

object (EndOfSegmentLocation)

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

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" içerecek şekilde 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. Güncelleme varsayılan olarak ilk sekmeye uygulanır.

InsertRichLinkRequest

Belirtilen konuma RichLink ekler.

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

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
Alanlar
Birleştirme alanı insertion_location. Zengin bağlantının ekleneceği konum. insertion_location aşağıdakilerden yalnızca biri olabilir:
location

object (Location)

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

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

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

endOfSegmentLocation

object (EndOfSegmentLocation)

Zengin bağlantıyı üstbilgi, altbilgi, dipnot veya belge gövdesinin sonuna ekler.

InsertDateRequest

Belirtilen konuma bir tarih ekler.

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

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

object (DateElementProperties)

Eklenecek tarihin özellikleri.

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

object (Location)

Tarihi, dokümandaki belirli bir dizine 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.

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ş olamaz ve 2.048 UTF-8 kod birimini aşmamalıdır.

assigneeEmailAddress

string

İsteğe bağlı. 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.

Birleştirme alanı anchor. Dokümanda bu yorumla ilişkili konum. anchor aşağıdakilerden yalnızca biri olabilir:
range

object (Range)

Bu yorumla ilişkili dokümandaki Range.

AddCommentReplyRequest

Post CommentThread veya SuggestionThread içine yanıt ekler.

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

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

object (Post)

Yanıtı temsil eden Post.

Birleştirme alanı thread_id. Yanıtın ekleneceği ileti dizisinin kimliği. thread_id aşağıdakilerden yalnızca biri olabilir:
commentId

string

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

suggestionId

string

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

UpdateCommentPostRequest

CommentThread veya SuggestionThread içinde Post öğesini günceller.

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

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

  • İstekte bulunan kullanıcı, gönderinin yazarı değil.

  • Aynı BatchUpdateDocumentRequest için aynı postId'de birden fazla UpdateCommentPostRequest var.

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ş olamaz ve 2.048 UTF-8 kod birimini aşmamalıdır.

Birleştirme alanı thread_id. Yayının ait olduğu ileti dizisinin kimliği. thread_id aşağıdakilerden yalnızca biri olabilir:
commentId

string

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

suggestionId

string

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

DeleteCommentRequest

CommentThread siler.

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

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

string

Silinen CommentThread kimliği.

DeleteCommentReplyRequest

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

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

  • İstekte bulunan kullanıcı, gönderinin yazarı değil.

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

  • 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

Birleştirme alanı thread_id. Yayının ait olduğu ileti dizisinin kimliği. thread_id aşağıdakilerden yalnızca biri olabilir:
commentId

string

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

suggestionId

string

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

AcceptSuggestionRequest

Öneriyi kabul eder.

İstekte bulunan kullanıcının dokümana düzenleme erişimi yoksa 403 yasaklandı hatası döndürülü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ını döndürü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.