Text

TextContent

Genel metin içeriği. Metin, sayfada uyumlu bir şekil (ör. metin kutusu veya dikdörtgen) ya da tablo hücresinde yer almalıdır.

JSON gösterimi
{
  "textElements": [
    {
      object (TextElement)
    }
  ],
  "lists": {
    string: {
      object (List)
    },
    ...
  }
}
Alanlar
textElements[]

object (TextElement)

Metin içerikleri, stil bilgileri de dahil olmak üzere bileşenlerine ayrılır. Bu özellik salt okunurdur.

lists

map (key: string, value: object ( List))

Bu metinde yer alan, liste kimliğine göre anahtarlanmış madde işaretli listeler.

TextElement

TextElement, bir Shape veya TableCell'in metin içeriğindeki bir dizi dizinin içeriğini açıklar.

JSON gösterimi
{
  "startIndex": integer,
  "endIndex": integer,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "paragraphMarker": {
    object (ParagraphMarker)
  },
  "textRun": {
    object (TextRun)
  },
  "autoText": {
    object (AutoText)
  }
  // End of mutually exclusive fields.
}
Alanlar
startIndex

integer

Bu metin öğesinin Unicode kod birimlerindeki sıfır tabanlı başlangıç indeksi.

endIndex

integer

Bu metin öğesinin sıfır tabanlı bitiş dizini (hariç) Unicode kod birimlerinde.

Bu öğenin temsil ettiği metin türü. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt içinde en fazla bir alan ayarlanır:
paragraphMarker

object (ParagraphMarker)

Yeni bir paragrafın başlangıcını temsil eden işaretçi.

Bu TextElement'in startIndex ve endIndex değerleri, paragrafın aralığını gösterir. Bu paragrafın aralığında yer alan dizin aralığına sahip diğer TextElement'ler bu paragrafın parçası olarak kabul edilir. İki ayrı paragrafın dizin aralığı asla çakışmaz.

textRun

object (TextRun)

Çalışmadaki tüm karakterlerin aynı TextStyle olduğu bir metin çalışmasını temsil eden TextElement.

TextRun'ların startIndex ve endIndex değerleri her zaman tek bir paragraphMarker TextElement'in dizin aralığında tamamen yer alır. Diğer bir deyişle, TextRun hiçbir zaman birden fazla paragrafı kapsamaz.

autoText

object (AutoText)

Metinde, zaman içinde değişebilen içerikle dinamik olarak değiştirilen bir noktayı temsil eden TextElement.

Karşılıklı olarak hariç tutulan alanların sonu.

ParagraphMarker

Yeni bir paragrafın başlangıcını temsil eden bir TextElement türü.

JSON gösterimi
{
  "style": {
    object (ParagraphStyle)
  },
  "bullet": {
    object (Bullet)
  }
}
Alanlar
style

object (ParagraphStyle)

Paragrafın stili

bullet

object (Bullet)

Bu paragrafın madde işareti. Yoksa paragraf bir listeye ait değildir.

ParagraphStyle

Bir paragrafın tamamına uygulanan stiller.

Bu metin, üst öğesi olan bir şekil placeholder içinde yer alıyorsa bu paragraf stilleri üst öğeden devralınabilir. Hangi paragraf stillerinin devralınacağı, listelerin iç içe yerleştirme düzeyine bağlıdır:

  • Bir listede bulunmayan paragraf, paragraf stilini üst yer tutucunun içindeki listenin 0 iç içe yerleştirme düzeyindeki paragraftan devralır.
  • Bir listedeki paragraf, paragraf stilini üst yer tutucunun içindeki listenin karşılık gelen iç içe yerleştirme düzeyindeki paragraftan devralır.

Devralınan paragraf stilleri bu iletide ayarlanmamış alanlar olarak gösterilir.

JSON gösterimi
{
  "lineSpacing": number,
  "alignment": enum (Alignment),
  "indentStart": {
    object (Dimension)
  },
  "indentEnd": {
    object (Dimension)
  },
  "spaceAbove": {
    object (Dimension)
  },
  "spaceBelow": {
    object (Dimension)
  },
  "indentFirstLine": {
    object (Dimension)
  },
  "direction": enum (TextDirection),
  "spacingMode": enum (SpacingMode)
}
Alanlar
lineSpacing

number

Normalin %100 olarak temsil edildiği satırlar arasındaki boşluk miktarı (normalin yüzdesi olarak). Ayarlanmamışsa değer üst öğeden devralınır.

alignment

enum (Alignment)

Bu paragrafın metin hizalaması.

indentStart

object (Dimension)

Geçerli metin yönüne göre, metnin başlangıcına karşılık gelen taraftaki paragraf için girinti miktarı. Ayarlanmamışsa değer üst öğeden devralınır.

indentEnd

object (Dimension)

Geçerli metin yönüne göre, metnin sonuna karşılık gelen taraftaki paragraf için girinti miktarı. Ayarlanmamışsa değer üst öğeden devralınır.

spaceAbove

object (Dimension)

Paragrafın üstündeki ek boşluk miktarı. Ayarlanmamışsa değer üst öğeden devralınır.

spaceBelow

object (Dimension)

Paragrafın altındaki ek boşluğun miktarı. Ayarlanmamışsa değer üst öğeden devralınır.

indentFirstLine

object (Dimension)

Paragrafın ilk satırının başlangıcındaki girinti miktarı. Ayarlanmamışsa değer üst öğeden devralınır.

direction

enum (TextDirection)

Bu paragrafın metin yönü. Ayarlanmamışsa metin yönü devralınmadığı için değer varsayılan olarak LEFT_TO_RIGHT olur.

spacingMode

enum (SpacingMode)

Paragrafın aralık modu.

Uyum

Bir paragraf için metin hizalama türleri.

Sıralamalar
ALIGNMENT_UNSPECIFIED Paragraf hizalama, üst öğeden devralınır.
START Paragraf, satırın başlangıcına hizalanır. Soldan sağa metin için sola, aksi takdirde sağa hizalanır.
CENTER Paragraf ortalanır.
END Paragraf, satırın sonuna hizalanır. Soldan sağa metin için sağa hizalı, aksi takdirde sola hizalı.
JUSTIFIED Paragraf hizalanmış.

TextDirection

Yol tarifi metni akabilir.

Sıralamalar
TEXT_DIRECTION_UNSPECIFIED Metin yönü üst öğeden devralınır.
LEFT_TO_RIGHT Metin soldan sağa doğru ilerler.
RIGHT_TO_LEFT Metin sağdan sola doğru ilerler.

SpacingMode

Paragraf aralığı için farklı modlar.

Sıralamalar
SPACING_MODE_UNSPECIFIED Aralık modu üst öğeden devralınır.
NEVER_COLLAPSE Paragraf aralığı her zaman oluşturulur.
COLLAPSE_LISTS Liste öğeleri arasında paragraf aralığı atlanır.

Madde işareti

Paragrafın madde işaretini tanımlar.

JSON gösterimi
{
  "listId": string,
  "nestingLevel": integer,
  "glyph": string,
  "bulletStyle": {
    object (TextStyle)
  }
}
Alanlar
listId

string

Bu paragrafın ait olduğu listenin kimliği.

nestingLevel

integer

Bu paragrafın listedeki iç içe yerleştirme seviyesi.

glyph

string

Bu paragraf için oluşturulan madde işareti glifi.

bulletStyle

object (TextStyle)

Bu madde işaretine uygulanan paragrafa özgü metin stili.

TextStyle

Bir TextRun'a uygulanabilecek stili temsil eder.

Bu metin, üst öğesi olan bir şekil placeholder içinde yer alıyorsa bu metin stilleri üst öğeden devralınabilir. Hangi metin stillerinin devralınacağı, listelerin iç içe yerleştirme düzeyine bağlıdır:

  • Bir listede olmayan bir paragraftaki metin çalıştırması, metin stilini üst yer tutucunun içindeki listenin 0 iç içe yerleştirme düzeyindeki paragrafta bulunan yeni satır karakterinden devralır.
  • Bir listedeki paragrafta bulunan metin çalıştırması, metin stilini üst yer tutucunun içindeki listede karşılık gelen iç içe yerleştirme düzeyindeki paragrafta bulunan yeni satır karakterinden devralır.

Devralınan metin stilleri, bu iletide ayarlanmamış alanlar olarak gösterilir. Metin, üst yer tutucusu olmayan bir şekil içinde yer alıyorsa bu alanların ayarı kaldırıldığında stil, Slaytlar düzenleyicisindeki varsayılanlarla eşleşen bir değere geri döner.

JSON gösterimi
{
  "backgroundColor": {
    object (OptionalColor)
  },
  "foregroundColor": {
    object (OptionalColor)
  },
  "bold": boolean,
  "italic": boolean,
  "fontFamily": string,
  "fontSize": {
    object (Dimension)
  },
  "link": {
    object (Link)
  },
  "baselineOffset": enum (BaselineOffset),
  "smallCaps": boolean,
  "strikethrough": boolean,
  "underline": boolean,
  "weightedFontFamily": {
    object (WeightedFontFamily)
  }
}
Alanlar
backgroundColor

object (OptionalColor)

Metnin arka plan rengi. Ayarlanmışsa rengi, içindeki alanının ayarlanıp ayarlanmadığına bağlı olarak opak veya şeffaftır. opaqueColor alanı ayarlanmışsa rengi, içindeki alanının ayarlanıp ayarlanmadığına bağlı olarak opak veya şeffaftır.

foregroundColor

object (OptionalColor)

Metnin rengi. Ayarlanmışsa rengi, içindeki alanının ayarlanıp ayarlanmadığına bağlı olarak opak veya şeffaftır. opaqueColor alanı ayarlanmışsa rengi, içindeki alanının ayarlanıp ayarlanmadığına bağlı olarak opak veya şeffaftır.

bold

boolean

Metnin kalın olarak oluşturulup oluşturulmadığı.

italic

boolean

Metnin italik olup olmadığı.

fontFamily

string

Metnin yazı tipi ailesi.

Yazı tipi ailesi, Slaytlar'daki Yazı tipi menüsünde veya Google Fonts'ta yer alan herhangi bir yazı tipi olabilir. Yazı tipi adı tanınmıyorsa metin Arial olarak oluşturulur.

Bazı yazı tipleri, metnin ağırlığını etkileyebilir. Bir güncelleme isteğinde hem fontFamily hem de bold için değerler belirtilirse açıkça ayarlanan bold değeri kullanılır.

fontSize

object (Dimension)

Metnin yazı tipinin boyutu. Okunduğunda, fontSize değeri punto cinsinden belirtilir.

baselineOffset

enum (BaselineOffset)

Metnin normal konumundan dikey uzaklığı.

SUPERSCRIPT veya SUBSCRIPT taban çizgisi kaydırmaları içeren metin, fontSize alanına göre hesaplanan daha küçük bir yazı tipi boyutunda otomatik olarak oluşturulur. Bu alandaki değişiklikler fontSize etkilemez.

smallCaps

boolean

Metnin küçük büyük harflerle yazılıp yazılmadığı

strikethrough

boolean

Metnin üstünün çizili olup olmadığı.

underline

boolean

Metnin altının çizili olup olmadığı.

weightedFontFamily

object (WeightedFontFamily)

Metnin yazı tipi ailesi ve oluşturulan ağırlığı.

Bu alan, geriye dönük uyumluluğu bozmadan açık yazı tipi ağırlıklarını desteklemek için fontFamily alanının bir uzantısıdır. Bu nedenle, bir metin aralığının stilini okurken weightedFontFamily#fontFamily değeri her zaman fontFamily değerine eşit olur. Ancak yazma sırasında her iki alan da alan maskesine dahil edilirse (açıkça veya joker karakter "*" aracılığıyla) değerleri aşağıdaki şekilde uzlaştırılır:

  • fontFamily ayarlanırsa ve weightedFontFamily ayarlanmazsa fontFamily değeri 400 ("normal") ağırlığıyla uygulanır.
  • Her iki alan da ayarlanırsa fontFamily değerinin weightedFontFamily#fontFamily değeriyle eşleşmesi gerekir. Bu durumda, weightedFontFamily yazı tipi ailesi ve ağırlığı uygulanır. Aksi takdirde 400 hatalı istek hatası döndürülür.
  • weightedFontFamily ayarlanır ve fontFamily ayarlanmazsa weightedFontFamily yazı tipi ailesi ve ağırlığı uygulanır.
  • İki alan da ayarlanmamışsa metnin yazı tipi ailesi ve ağırlığı üst öğeden devralınır. Bu özelliklerin birbirinden ayrı olarak devralınamayacağını unutmayın.

Bir güncelleme isteğinde hem weightedFontFamily hem de bold için değerler belirtiliyorsa önce weightedFontFamily, ardından bold uygulanır.

weightedFontFamily#weight ayarlanmazsa varsayılan olarak 400 olur.

If weightedFontFamily ayarlanırsa weightedFontFamily#fontFamily de boş olmayan bir değerle ayarlanmalıdır. Aksi takdirde, 400 hatalı istek hatası döndürülür.

OptionalColor

Tamamen opak veya tamamen şeffaf olabilen bir renk.

JSON gösterimi
{
  "opaqueColor": {
    object (OpaqueColor)
  }
}
Alanlar
opaqueColor

object (OpaqueColor)

Ayarlanırsa opak renk olarak kullanılır. Ayarlanmamışsa bu, şeffaf bir rengi temsil eder.

BaselineOffset

Metnin normal konumundan dikey olarak kaydırılabileceği yöntemler.

Sıralamalar
BASELINE_OFFSET_UNSPECIFIED Metnin referans çizgisi uzaklığı üst öğeden devralınır.
NONE Metin dikey olarak kaydırılmamış.
SUPERSCRIPT Metin dikey olarak yukarıya doğru kaydırılır (üst simge).
SUBSCRIPT Metin dikey olarak aşağıya kaydırılır (alt simge).

WeightedFontFamily

Bir TextRun'ı stilize etmek için kullanılan yazı tipi ailesini ve ağırlığını temsil eder.

JSON gösterimi
{
  "fontFamily": string,
  "weight": integer
}
Alanlar
fontFamily

string

Metnin yazı tipi ailesi.

Yazı tipi ailesi, Slaytlar'daki Yazı tipi menüsünde veya Google Fonts'ta yer alan herhangi bir yazı tipi olabilir. Yazı tipi adı tanınmıyorsa metin Arial olarak oluşturulur.

weight

integer

Metnin oluşturulan ağırlığı. Bu alan, 100 ile 900 arasında (bu değerler dahil) 100'nın katı olan herhangi bir değeri alabilir. Bu aralık, CSS 2.1 belirtiminin 15.6 bölümünde açıklanan sayısal değerlere karşılık gelir ve sayısal olmayan değerlere izin verilmez. 700 değerine eşit veya bu değerden büyük ağırlıklar kalın, 700 değerinden küçük ağırlıklar ise kalın değildir. Varsayılan değer 400 ("normal") değeridir.

TextRun

Tümü aynı stile sahip bir metin dizisini temsil eden bir TextElement türü.

JSON gösterimi
{
  "content": string,
  "style": {
    object (TextStyle)
  }
}
Alanlar
content

string

Bu çalıştırmanın metni.

style

object (TextStyle)

Bu çalıştırmaya uygulanan stil.

AutoText

Otomatik metni temsil eden bir TextElement türü.

JSON gösterimi
{
  "type": enum (Type),
  "content": string,
  "style": {
    object (TextStyle)
  }
}
Alanlar
type

enum (Type)

Bu otomatik metnin türü.

content

string

Varsa bu otomatik metnin oluşturulan içeriği.

style

object (TextStyle)

Bu otomatik metne uygulanan stil.

Tür

Otomatik metin türleri

Sıralamalar
TYPE_UNSPECIFIED Belirtilmemiş bir otomatik metin türü.
SLIDE_NUMBER Geçerli slayt numarasını temsil eden otomatik metin türü.

Liste

Liste, bir listeyle ilişkili paragraflara ait madde işaretlerinin görünümünü ve tarzını tanımlar. Bir listenin parçası olan paragraf, listenin kimliğine örtülü bir referans içerir.

JSON gösterimi
{
  "listId": string,
  "nestingLevel": {
    integer: {
      object (NestingLevel)
    },
    ...
  }
}
Alanlar
listId

string

Listenin kimliği.

nestingLevel

map (key: integer, value: object ( NestingLevel))

İlişkili düzeydeki madde işaretlerinin özelliklerine yönelik iç içe yerleştirme düzeylerinin haritası. Bir listede en fazla dokuz iç içe yerleştirme düzeyi bulunur. Bu nedenle, bu haritanın anahtarları için olası değerler 0 ile 8 (dahil) arasındadır.

NestingLevel

Belirli bir iç içe yerleştirme düzeyinde liste madde işaretinin görünümünü ve tarzını açıklayan özellikleri içerir.

JSON gösterimi
{
  "bulletStyle": {
    object (TextStyle)
  }
}
Alanlar
bulletStyle

object (TextStyle)

Bu iç içe yerleştirme düzeyindeki madde işaretinin stili.