- Zasób: Document
- Karty
- TabProperties
- DocumentTab
- Tekst główny
- StructuralElement
- Akapit
- ParagraphElement
- TextRun
- TextStyle
- OptionalColor
- Kolor
- RgbColor
- Wymiar
- Jednostka
- WeightedFontFamily
- BaselineOffset
- Link
- BookmarkLink
- HeadingLink
- SuggestedTextStyle
- TextStyleSuggestionState
- AutoText
- Typ
- PageBreak
- ColumnBreak
- FootnoteReference
- HorizontalRule
- Równanie
- InlineObjectElement
- Osoba
- PersonProperties
- RichLink
- RichLinkProperties
- ParagraphStyle
- NamedStyleType
- Wyrównanie
- ContentDirection
- SpacingMode
- ParagraphBorder
- DashStyle
- TabStop
- TabStopAlignment
- Cieniowanie
- SuggestedParagraphStyle
- ParagraphStyleSuggestionState
- ShadingSuggestionState
- Bullet
- SuggestedBullet
- BulletSuggestionState
- ObjectReferences
- SectionBreak
- SectionStyle
- SectionColumnProperties
- ColumnSeparatorStyle
- SectionType
- Tabela
- TableRow
- TableCell
- TableCellStyle
- TableCellBorder
- ContentAlignment
- SuggestedTableCellStyle
- TableCellStyleSuggestionState
- TableRowStyle
- SuggestedTableRowStyle
- TableRowStyleSuggestionState
- TableStyle
- TableColumnProperties
- WidthType
- TableOfContents
- Nagłówek
- Stopka
- Przypis
- DocumentStyle
- Informacje ogólne
- Rozmiar
- SuggestedDocumentStyle
- DocumentStyleSuggestionState
- BackgroundSuggestionState
- SizeSuggestionState
- NamedStyles
- NamedStyle
- SuggestedNamedStyles
- NamedStylesSuggestionState
- NamedStyleSuggestionState
- Lista
- ListProperties
- NestingLevel
- BulletAlignment
- GlyphType
- SuggestedListProperties
- ListPropertiesSuggestionState
- NestingLevelSuggestionState
- NamedRanges
- NamedRange
- Zakres
- InlineObject
- InlineObjectProperties
- EmbeddedObject
- EmbeddedDrawingProperties
- ImageProperties
- CropProperties
- EmbeddedObjectBorder
- PropertyState
- LinkedContentReference
- SheetsChartReference
- SuggestedInlineObjectProperties
- InlineObjectPropertiesSuggestionState
- EmbeddedObjectSuggestionState
- EmbeddedDrawingPropertiesSuggestionState
- ImagePropertiesSuggestionState
- CropPropertiesSuggestionState
- EmbeddedObjectBorderSuggestionState
- LinkedContentReferenceSuggestionState
- SheetsChartReferenceSuggestionState
- PositionedObject
- PositionedObjectProperties
- PositionedObjectPositioning
- PositionedObjectLayout
- SuggestedPositionedObjectProperties
- PositionedObjectPropertiesSuggestionState
- PositionedObjectPositioningSuggestionState
- SuggestionsViewMode
- Metody
Zasób: dokument
dokument w Dokumentach Google,
Zapis JSON |
---|
{ "documentId": string, "title": string, "tabs": [ { object ( |
Pola | |
---|---|
document |
Tylko dane wyjściowe. Identyfikator dokumentu. |
title |
Tytuł dokumentu. |
tabs[] |
karty, które są częścią dokumentu. Karty mogą zawierać karty podrzędne, czyli karty umieszczone w innej karcie. Zakładki podrzędne są reprezentowane przez pole |
revision |
Tylko dane wyjściowe. Identyfikator wersji dokumentu. Może być używany w żądaniach aktualizacji w celu określenia, do której wersji dokumentu mają zostać zastosowane zmiany, oraz jak żądanie powinno się zachowywać, jeśli dokument został zmieniony od tej wersji. Wypełnione tylko wtedy, gdy użytkownik ma uprawnienia do edycji dokumentu. Identyfikator wersji to nieciągły ciąg znaków, a nie liczba. Format identyfikatora wersji może się z czasem zmieniać. Zwrócony identyfikator wersji jest gwarantowany tylko przez 24 godziny od momentu jego zwrotu i nie może być udostępniany innym użytkownikom. Jeśli identyfikator wersji nie zmienia się między wywołaniami, oznacza to, że dokument nie został zmieniony. Z kolei zmieniony identyfikator (w przypadku tego samego dokumentu i użytkownika) zwykle oznacza, że dokument został zaktualizowany. Zmiana identyfikatora może być też spowodowana czynnikami wewnętrznymi, np. zmianami formatu identyfikatora. |
suggestions |
Tylko dane wyjściowe. Tryb wyświetlania sugestii zastosowany w dokumencie. Uwaga: podczas edytowania dokumentu zmiany muszą być oparte na dokumencie z wartością |
body |
Tylko dane wyjściowe. Główna część dokumentu. Pole starsze: zamiast tego użyj pola |
headers |
Tylko dane wyjściowe. Nagłówki w dokumencie, posortowane według identyfikatora nagłówka. Pole starsze: zamiast tego użyj pola |
footers |
Tylko dane wyjściowe. stopki w dokumencie, posortowane według identyfikatora stopki; Pole starsze: zamiast tego użyj pola |
footnotes |
Tylko dane wyjściowe. przypisy w dokumencie, posortowane według identyfikatora przypisu; Pole starsze: zamiast tego użyj pola |
document |
Tylko dane wyjściowe. Styl dokumentu. Pole starsze: zamiast tego użyj pola |
suggested |
Tylko dane wyjściowe. Sugerowane zmiany stylu dokumentu, posortowane według identyfikatora sugestii. Pole starsze: zamiast tego użyj pola |
named |
Tylko dane wyjściowe. Nazwane style dokumentu. Pole starsze: zamiast tego użyj pola |
suggested |
Tylko dane wyjściowe. Sugerowane zmiany nazwanych stylów dokumentu, posortowane według identyfikatora sugestii. Pole starsze: zamiast tego użyj pola |
lists |
Tylko dane wyjściowe. Listy w dokumencie, posortowane według identyfikatora listy. Pole starsze: zamiast tego użyj pola |
named |
Tylko dane wyjściowe. Nazwane zakresy w dokumencie, posortowane według nazwy. Pole starsze: zamiast tego użyj pola |
inline |
Tylko dane wyjściowe. Obiekty w dokumencie, których kluczem jest identyfikator obiektu. Pole starsze: zamiast tego użyj pola |
positioned |
Tylko dane wyjściowe. Obiekty umieszczone w dokumencie, posortowane według identyfikatora obiektu. Pole starsze: zamiast tego użyj pola |
Tab
Karta w dokumencie.
Zapis JSON |
---|
{ "tabProperties": { object ( |
Pola | |
---|---|
tab |
Właściwości karty, takie jak identyfikator i tytuł. |
child |
Karty podrzędne umieszczone na tej karcie. |
Pole unii content . Treść karty. content może być tylko jednym z tych elementów: |
|
document |
Karta z zawartością dokumentu, np. tekstem i obrazami. |
TabProperties
Właściwości karty.
Zapis JSON |
---|
{ "tabId": string, "title": string, "parentTabId": string, "index": integer, "nestingLevel": integer } |
Pola | |
---|---|
tab |
Tylko dane wyjściowe. Identyfikator karty. Tego pola nie można zmienić. |
title |
Nazwa karty widoczna dla użytkownika. |
parent |
Opcjonalnie: Identyfikator karty nadrzędnej. Pusty, gdy bieżąca karta jest kartą na poziomie katalogu głównego, co oznacza, że nie ma żadnych elementów nadrzędnych. |
index |
Indeks karty w grupie zaczynający się od 0. |
nesting |
Tylko dane wyjściowe. Głębokość karty w dokumencie. Karty na poziomie wyższym zaczynają się od 0. |
DocumentTab
Karta z treścią dokumentu.
Zapis JSON |
---|
{ "body": { object ( |
Pola | |
---|---|
body |
Główna część karty dokumentu. |
headers |
Nagłówki na karcie dokumentu, posortowane według identyfikatora nagłówka. |
footers |
Stopki na karcie dokumentu, posortowane według identyfikatora stopki. |
footnotes |
przypisy na karcie dokumentu, posortowane według identyfikatora przypisu; |
document |
Styl karty dokumentu. |
suggested |
Proponowane zmiany stylu karty dokumentu, posortowane według identyfikatora sugestii. |
named |
Nazwane style karty dokumentu. |
suggested |
Proponowane zmiany nazwanych stylów na karcie dokumentu, posortowane według identyfikatora sugestii. |
lists |
listy na karcie dokumentu, posortowane według identyfikatora listy; |
named |
Zakresy nazwane na karcie dokumentu, posortowane według nazwy. |
inline |
Obiekty w dokumencie na karcie, posortowane według identyfikatora obiektu. |
positioned |
Obiekty umieszczone na karcie dokumentu, posortowane według identyfikatora obiektu. |
Treść
Treść dokumentu.
Treść zawiera zwykle całą zawartość dokumentu z wyjątkiem pól headers
, footers
i footnotes
.
Zapis JSON |
---|
{
"content": [
{
object ( |
Pola | |
---|---|
content[] |
Treść wiadomości. Indeksy treści w ciele zaczynają się od 0. |
StructuralElement
Element strukturalny opisuje zawartość, która nadaje strukturę dokumentowi.
Zapis JSON |
---|
{ "startIndex": integer, "endIndex": integer, // Union field |
Pola | |
---|---|
start |
Indeks początkowy tego elementu strukturalnego (liczony od 0) w jednostkach kodu UTF-16. |
end |
Wykluczający indeks końcowy tego elementu strukturalnego (liczony od zera) w jednostkach kodu UTF-16. |
Pole unii content . Treść elementu strukturalnego. content może być tylko jednym z tych elementów: |
|
paragraph |
Element strukturalny typu akapit. |
section |
Element strukturalny typu podział na sekcje. |
table |
Typ tabeli jako element strukturalny. |
table |
Element strukturalny typu spis treści. |
Akapit
StructuralElement
reprezentujący akapit. Akapit to zakres treści zakończony znakiem nowego wiersza.
Zapis JSON |
---|
{ "elements": [ { object ( |
Pola | |
---|---|
elements[] |
Treść akapitu podzielona na części składowe. |
paragraph |
Styl tego akapitu. |
suggested |
Styl sugerowanego akapitu zmienia się na ten akapit, którego identyfikator jest podany w kluczu. |
bullet |
Punkt w tym akapicie. Jeśli nie ma go na liście, akapit nie należy do listy. |
suggested |
Sugerowane zmiany w punkcie w tym akapicie. |
positioned |
Identyfikatory obiektów powiązanych z tym akapitem. |
suggested |
Identyfikatory obiektów z pozycjonowaniem, które sugerujemy dołączyć do tego akapitu, z kluczem identyfikatora sugestii. |
ParagraphElement
Element ParagraphElement opisuje zawartość w Paragraph
.
Zapis JSON |
---|
{ "startIndex": integer, "endIndex": integer, // Union field |
Pola | |
---|---|
start |
Indeks początkowy tego elementu akapitu (liczony od zera) w jednostkach kodu UTF-16. |
end |
Indeks końcowy tego elementu akapitu (z wyłączeniem) oparty na zerowej podstawie w jednostkach kodu UTF-16. |
Pole unii content . Treść elementu akapitu. content może być tylko jednym z tych elementów: |
|
text |
Element akapitu tekstu. |
auto |
Element akapitu z tekstem automatycznym. |
page |
Element akapitu z podziałem strony. |
column |
Element akapitu z podziałem na kolumny. |
footnote |
Element akapitu odwołania do przypisu. |
horizontal |
Element akapitu z poziomą linią. |
equation |
Element akapitu równania. |
inline |
Wbudowany element akapitu obiektu. |
person |
Element akapitu, który zawiera link do osoby lub adresu e-mail. |
rich |
Element akapitu, który zawiera link do zasobu Google (np. pliku na Dysku Google, filmu w YouTube lub wydarzenia w Kalendarzu). |
TextRun
ParagraphElement
, który reprezentuje ciąg tekstu o tym samym stylu.
Zapis JSON |
---|
{ "content": string, "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
Pola | |
---|---|
content |
Tekst tego przebiegu. Wszystkie elementy inne niż tekstowe w sesji są zastępowane znakiem Unicode U+E907. |
suggested |
Sugerowane identyfikatory wstawień. Jeśli |
suggested |
Identyfikatory sugerowanych do usunięcia. Jeśli jest puste, nie ma żadnych sugerowanych usunięcia tych treści. |
text |
Styl tekstu tego przebiegu. |
suggested |
Styl sugerowanego tekstu zmienia się w tym przebiegu, a jako klucz używany jest identyfikator sugestii. |
TextStyle
Reprezentuje styl, który można zastosować do tekstu.
Styl tekstu dziedziczonego jest w tym komunikacie reprezentowany jako niezaznaczone pola. Element nadrzędny stylu tekstu zależy od miejsca zdefiniowania stylu:
- Styl tekstu w elementach
Paragraph
dziedziczy się z odpowiednich elementównamed style type
w akapitach. - Styl tekstu w elementach
named style
dziedziczy styl o nazwienormal text
. - Styl tekstu
normal text
dziedziczy styl tekstu domyślnego w edytorze Dokumentów. - Styl tekstu elementu
Paragraph
zawartego w tabeli może dziedziczyć styl tekstu od stylu tabeli.
Jeśli styl tekstu nie dziedziczy ustawień od elementu nadrzędnego, odznaczenie pól spowoduje przywrócenie stylu do wartości domyślnej w edytorze Dokumentów.
Zapis JSON |
---|
{ "bold": boolean, "italic": boolean, "underline": boolean, "strikethrough": boolean, "smallCaps": boolean, "backgroundColor": { object ( |
Pola | |
---|---|
bold |
Określa, czy tekst ma być wyświetlany pogrubioną czcionką. |
italic |
Określa, czy tekst jest kursywą. |
underline |
Określa, czy tekst jest podkreślony. |
strikethrough |
Określa, czy tekst jest przekreślony. |
small |
czy tekst jest zapisany małymi literami. |
background |
Kolor tła tekstu. Jeśli jest ustawiony, kolor jest kolorem RGB lub przezroczysty, w zależności od pola |
foreground |
Kolor pierwszego planu tekstu. Jeśli jest ustawiony, kolor jest kolorem RGB lub przezroczysty, w zależności od pola |
font |
Rozmiar czcionki tekstu. |
weighted |
Rodzina czcionek i renderowana grubość tekstu. Jeśli żądanie aktualizacji zawiera wartości zarówno dla parametru Jeśli parametr Jeśli parametr |
baseline |
Pionowe przesunięcie tekstu od jego normalnej pozycji. Tekst z odstępami od linii bazowej |
link |
Miejsce docelowe hiperlinku w tekście. Jeśli nie jest ustawiony, nie ma linku. Linki nie są dziedziczone z tekstu nadrzędnego. Zmiana linku w żądaniu aktualizacji powoduje inne zmiany stylu tekstu zakresu:
|
OptionalColor
Kolor, który może być całkowicie nieprzejrzysty lub całkowicie przezroczysty.
Zapis JSON |
---|
{
"color": {
object ( |
Pola | |
---|---|
color |
Jeśli jest ustawiony, będzie używany jako nieprzezroczysty kolor. Jeśli nie jest ustawiony, oznacza przezroczysty kolor. |
Kolor
jednolity kolor;
Zapis JSON |
---|
{
"rgbColor": {
object ( |
Pola | |
---|---|
rgb |
Wartość koloru RGB. |
RgbColor
Kolor RGB.
Zapis JSON |
---|
{ "red": number, "green": number, "blue": number } |
Pola | |
---|---|
red |
Składowa czerwona koloru, od 0,0 do 1,0. |
green |
Składowa zielona koloru, od 0,0 do 1,0. |
blue |
Niebieski składnik koloru, od 0,0 do 1,0. |
Wymiar
Wielkość w jednym kierunku w określonych jednostkach.
Zapis JSON |
---|
{
"magnitude": number,
"unit": enum ( |
Pola | |
---|---|
magnitude |
Wielkość. |
unit |
Jednostki wielkości. |
Jednostka
Jednostki miary.
Wartości w polu enum | |
---|---|
UNIT_UNSPECIFIED |
Jednostki są nieznane. |
PT |
Punkt, 1/72 cala. |
WeightedFontFamily
Reprezentuje rodzinę czcionek i grubość tekstu.
Zapis JSON |
---|
{ "fontFamily": string, "weight": integer } |
Pola | |
---|---|
font |
Rodzina czcionek tekstu. Rodzina czcionek może być dowolną czcionką z menu czcionek w Dokumentach lub z Google Fonts. Jeśli nazwa czcionki nie jest rozpoznawana, tekst jest renderowany w czcionce |
weight |
Grubość czcionki. To pole może zawierać dowolną wartość będącą wielokrotnością Wartością domyślną jest Grubość czcionki stanowi tylko jeden składnik renderowanej grubości czcionki. Połączenie wartości
|
BaselineOffset
Sposoby, w jakie tekst może być przesunięty w pionie od swojej normalnej pozycji.
Wartości w polu enum | |
---|---|
BASELINE_OFFSET_UNSPECIFIED |
Odsunięcie linii bazowej tekstu jest dziedziczone z elementu nadrzędnego. |
NONE |
Tekst nie jest przesunięty w pionie. |
SUPERSCRIPT |
Tekst jest przesunięty w górę (wysokodruk). |
SUBSCRIPT |
Tekst jest przesunięty w dół (pod indeksem). |
Link
Odwołuje się do innego fragmentu dokumentu lub zewnętrznego zasobu adresu URL.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole unii destination . Miejsce docelowe linku. destination może być tylko jednym z tych elementów: |
|
url |
zewnętrzny adres URL, |
tab |
Identyfikator karty w tym dokumencie. |
bookmark |
zakładka w tym dokumencie, W dokumentach zawierających jedną kartę linki do zakładek na tej karcie będą nadal zwracać wartość |
heading |
Nagłówek w tym dokumencie. W dokumentach zawierających jedną kartę linki do nagłówków na tej karcie będą nadal zwracać wartość |
bookmark |
Identyfikator zakładki w tym dokumencie. Stare pole: zamiast tego ustaw wartość Jeśli to pole jest używane w żądaniu zapisu, zakładka jest uznawana za pochodzącą z identyfikatora karty określonego w żądaniu. Jeśli w żądaniu nie jest określony identyfikator karty, jest ona uznawana za kartę na pierwszej karcie w dokumencie. |
heading |
Identyfikator nagłówka w tym dokumencie. Stare pole: zamiast tego ustaw wartość Jeśli to pole jest używane w żądaniu zapisu, nagłówek jest uznawany za pochodzący z identyfikatora karty określonego w żądaniu. Jeśli w żądaniu nie jest określony identyfikator karty, jest ona uznawana za kartę na pierwszej karcie w dokumencie. |
BookmarkLink
Odwołuje się do zakładki w tym dokumencie.
Zapis JSON |
---|
{ "id": string, "tabId": string } |
Pola | |
---|---|
id |
Identyfikator zakładki w tym dokumencie. |
tab |
Identyfikator karty zawierającej tę zakładkę. |
HeadingLink
Odniesienie do nagłówka w tym dokumencie.
Zapis JSON |
---|
{ "id": string, "tabId": string } |
Pola | |
---|---|
id |
Identyfikator nagłówka w tym dokumencie. |
tab |
Identyfikator karty zawierającej ten nagłówek. |
SuggestedTextStyle
sugerowana zmiana w elemencie TextStyle
;
Zapis JSON |
---|
{ "textStyle": { object ( |
Pola | |
---|---|
text |
|
text |
Maska wskazująca, które pola w podstawowym |
TextStyleSuggestionState
Maska wskazująca, które pola w podstawowym TextStyle
zostały zmienione w tej propozycji. W przypadku każdego pola ustawionego na „Prawda” jest nowa sugerowana wartość.
Zapis JSON |
---|
{ "boldSuggested": boolean, "italicSuggested": boolean, "underlineSuggested": boolean, "strikethroughSuggested": boolean, "smallCapsSuggested": boolean, "backgroundColorSuggested": boolean, "foregroundColorSuggested": boolean, "fontSizeSuggested": boolean, "weightedFontFamilySuggested": boolean, "baselineOffsetSuggested": boolean, "linkSuggested": boolean } |
Pola | |
---|---|
bold |
Wskazuje, czy zasugerowano zmianę na |
italic |
Wskazuje, czy zasugerowano zmianę na |
underline |
Wskazuje, czy zasugerowano zmianę na |
strikethrough |
Wskazuje, czy zasugerowano zmianę na |
small |
Wskazuje, czy zasugerowano zmianę na |
background |
Wskazuje, czy zasugerowano zmianę na |
foreground |
Wskazuje, czy zasugerowano zmianę na |
font |
Wskazuje, czy zasugerowano zmianę na |
weighted |
Wskazuje, czy zasugerowano zmianę na |
baseline |
Wskazuje, czy zasugerowano zmianę na |
link |
Wskazuje, czy zasugerowano zmianę na |
AutoText
ParagraphElement
oznacza miejsce w tekście, które jest dynamicznie zastępowane treścią, która może się zmieniać w czasie, np. numerem strony.
Zapis JSON |
---|
{ "type": enum ( |
Pola | |
---|---|
type |
Typ tekstu automatycznego. |
suggested |
Sugerowane identyfikatory wstawień. Jeśli |
suggested |
Identyfikatory sugerowanych do usunięcia. Jeśli jest puste, nie ma żadnych sugerowanych usunięcia tych treści. |
text |
Styl tekstu tego tekstu automatycznego. |
suggested |
Styl sugerowanego tekstu zmienia się na ten tekst automatyczny, którego kluczem jest identyfikator sugestii. |
Typ
Typy automatycznego tekstu.
Wartości w polu enum | |
---|---|
TYPE_UNSPECIFIED |
Nieokreślony typ tekstu automatycznego. |
PAGE_NUMBER |
Wpisz tekst automatyczny, który będzie reprezentować bieżący numer strony. |
PAGE_COUNT |
Wpisz tekst automatyczny, który będzie reprezentować łączną liczbę stron w dokumencie. |
PageBreak
ParagraphElement
reprezentuje podział strony. Podział strony powoduje, że następny tekst rozpoczyna się u góry następnej strony.
Zapis JSON |
---|
{ "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
Pola | |
---|---|
suggested |
Sugerowane identyfikatory wstawień. Jeśli |
suggested |
Identyfikatory sugerowanych do usunięcia. Jeśli jest puste, nie ma żadnych sugerowanych usunięcia tych treści. |
text |
Styl tekstu tego wcięcia strony. Podobnie jak w przypadku treści tekstowych, np. ciągów tekstowych i odniesień do przypisów, styl tekstu w przerwie na stronie może wpływać na układ treści oraz styl tekstu wstawionego obok. |
suggested |
Styl sugerowanego tekstu zmienia się na ten zdefiniowany w Break, którego kluczem jest identyfikator sugestii. |
ColumnBreak
ParagraphElement
oznacza podział kolumny. Przerwanie kolumny powoduje, że następny tekst zaczyna się u góry następnej kolumny.
Zapis JSON |
---|
{ "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
Pola | |
---|---|
suggested |
Sugerowane identyfikatory wstawień. Jeśli |
suggested |
Identyfikatory sugerowanych do usunięcia. Jeśli jest puste, nie ma żadnych sugerowanych usunięcia tych treści. |
text |
Styl tekstu tego elementu ColumnBreak. Podobnie jak w przypadku treści tekstowych, np. ciągów tekstowych i odwołań w przypisach, styl tekstu w przerwie kolumny może wpływać na układ treści oraz styl tekstu wstawionego obok. |
suggested |
Sugerowany styl tekstu zmienia się na ten element BreakInColumn, którego kluczem jest identyfikator sugestii. |
FootnoteReference
ParagraphElement
oznacza odwołanie do przypisu. Odwołanie do przypisu to zawartość wstawiana w tekście, która jest renderowana z numerem i służy do identyfikacji przypisu.
Zapis JSON |
---|
{ "footnoteId": string, "footnoteNumber": string, "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
Pola | |
---|---|
footnote |
Identyfikator |
footnote |
Wyrenderowany numer tego przypisu. |
suggested |
Sugerowane identyfikatory wstawień. Jeśli |
suggested |
Identyfikatory sugerowanych do usunięcia treści. Jeśli jest puste, nie ma żadnych sugerowanych usunięcia tych treści. |
text |
Styl tekstu tego odwołania do przypisu. |
suggested |
Styl sugerowanego tekstu zmienia się na ten atrybut, którego kluczem jest identyfikator sugestii. |
HorizontalRule
ParagraphElement
reprezentuje linię poziomą.
Zapis JSON |
---|
{ "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
Pola | |
---|---|
suggested |
Sugerowane identyfikatory wstawień. Jeśli |
suggested |
Identyfikatory sugerowanych do usunięcia. Jeśli jest puste, nie ma żadnych sugerowanych usunięcia tych treści. |
text |
Styl tekstu tej poziomej linii. Podobnie jak w przypadku tekstu, np. ciągów tekstowych i odniesień do przypisów, styl tekstu poziomej linii może wpływać na układ treści oraz styl tekstu wstawionego obok niej. |
suggested |
Sugerowany styl tekstu zmienia się na tę regułę poziomą, która jest powiązana z identyfikatorem sugestii. |
Równanie
ParagraphElement
reprezentujące równanie.
Zapis JSON |
---|
{ "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ] } |
Pola | |
---|---|
suggested |
Sugerowane identyfikatory wstawień. Jeśli |
suggested |
Identyfikatory sugerowanych do usunięcia. Jeśli jest puste, nie ma żadnych sugerowanych usunięcia tych treści. |
InlineObjectElement
ParagraphElement
, który zawiera InlineObject
.
Zapis JSON |
---|
{ "inlineObjectId": string, "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
Pola | |
---|---|
inline |
Identyfikator |
suggested |
Sugerowane identyfikatory wstawień. Jeśli |
suggested |
Identyfikatory sugerowanych do usunięcia. Jeśli jest puste, nie ma żadnych sugerowanych usunięcia tych treści. |
text |
Styl tekstu tego elementu wbudowanego. Podobnie jak w przypadku zawartości tekstowej, np. ciągów tekstowych i odniesień do przypisów, styl tekstu elementu obiektu wstawionego w tekście może wpływać na układ treści oraz styl tekstu wstawionego obok. |
suggested |
Styl sugerowanego tekstu zmienia się na ten obiekt InlineObject, którego kluczem jest identyfikator sugestii. |
Osoba
osoba lub adres e-mail wymieniony w dokumencie. Te wzmianki działają jak pojedynczy, niezmienny element zawierający imię i nazwisko lub adres e-mail osoby.
Zapis JSON |
---|
{ "personId": string, "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
Pola | |
---|---|
person |
Tylko dane wyjściowe. Unikalny identyfikator tego połączenia. |
suggested |
Identyfikatory sugestii, które wstawiają w dokumencie link do tej osoby. Element |
suggested |
Identyfikatory sugestii, które usuwają link do tej osoby z dokumentu. Jeśli na przykład |
text |
Styl tekstu w tym |
suggested |
Styl sugerowanego tekstu zmienia się na |
person |
Tylko dane wyjściowe. Właściwości tego elementu |
PersonProperties
Właściwości specyficzne dla połączonego Person
.
Zapis JSON |
---|
{ "name": string, "email": string } |
Pola | |
---|---|
name |
Tylko dane wyjściowe. imię i nazwisko osoby, jeśli jest wyświetlane w tekście linku zamiast adresu e-mail tej osoby; |
email |
Tylko dane wyjściowe. Adres e-mail powiązany z tym kontem |
RichLink
link do zasobu Google (np. pliku na Dysku, filmu w YouTube lub wydarzenia w Kalendarzu).
Zapis JSON |
---|
{ "richLinkId": string, "suggestedInsertionIds": [ string ], "suggestedDeletionIds": [ string ], "textStyle": { object ( |
Pola | |
---|---|
rich |
Tylko dane wyjściowe. Identyfikator tego linku. |
suggested |
Identyfikatory sugestii, które wstawiają ten link do dokumentu. Element |
suggested |
Identyfikatory sugestii, które usuwają ten link z dokumentu. Jeśli na przykład |
text |
Styl tekstu w tym |
suggested |
Styl sugerowanego tekstu zmienia się na |
rich |
Tylko dane wyjściowe. Właściwości tego elementu |
RichLinkProperties
Właściwości specyficzne dla RichLink
.
Zapis JSON |
---|
{ "title": string, "uri": string, "mimeType": string } |
Pola | |
---|---|
title |
Tylko dane wyjściowe. Tytuł |
uri |
Tylko dane wyjściowe. Identyfikator URI |
mime |
Tylko dane wyjściowe. Typ MIME |
ParagraphStyle
Style, które dotyczą całego akapitu.
Styl akapitu odziedziczony jest w tym komunikacie reprezentowany jako niezaznaczone pola. Element nadrzędny stylu akapitu zależy od tego, gdzie jest zdefiniowany styl akapitu:
- Styl akapitu w elementach
Paragraph
dziedziczy ustawienia z odpowiadających elementównamed style type
. - Styl akapitowy w elementach
named style
dziedziczy styl o nazwienormal text
. - Styl akapitu
normal text
dziedziczy styl akapitu domyślnego w edytorze Dokumentów. - Styl akapitu elementu
Paragraph
zawartego w tabeli może odziedziczyć styl akapitu od stylu tabeli.
Jeśli styl akapitu nie dziedziczy ustawień od elementu nadrzędnego, odznaczenie pól spowoduje przywrócenie stylu do wartości domyślnej w edytorze Dokumentów.
Zapis JSON |
---|
{ "headingId": string, "namedStyleType": enum ( |
Pola | |
---|---|
heading |
Identyfikator nagłówka akapitu. Jeśli jest pusty, akapit nie jest nagłówkiem. Ta usługa jest tylko do odczytu. |
named |
Nazwa stylu akapitu. Zmiana nazwanego typu stylu wpływa na inne właściwości w ramach typu ParagraphStyle, dlatego nazwany typ stylu jest stosowany przed zaktualizowaniem innych właściwości. |
alignment |
Wyrównanie tekstu w tym akapicie. |
line |
Ilość miejsca między liniami wyrażona jako odsetek wartości normalnej, gdzie wartość normalna to 100, 0. Jeśli nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego. |
direction |
Kierunek tekstu w tym akapicie. Jeśli nie zostanie ustawiona, wartość domyślna to |
spacing |
Tryb ustawień odstępów w akapicie. |
space |
Ilość dodatkowego miejsca nad akapitem. Jeśli nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego. |
space |
Ilość dodatkowego miejsca poniżej akapitu. Jeśli nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego. |
border |
Granica między tym a poprzednim lub następnym akapitem. Jeśli nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego. Obramowanie wewnętrzne jest renderowane, gdy sąsiednie akapity mają te same właściwości obramowania i wcięcia. Ramki akapitu nie można zaktualizować częściowo. Podczas zmiany obramowania akapitu należy określić nowe obramowanie w całości. |
border |
Obramowanie u góry tego akapitu. Jeśli nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego. Górna ramka jest renderowana, gdy akapit powyżej ma inne właściwości obramowania i wcięcia. Ramki akapitu nie można zaktualizować częściowo. Podczas zmiany obramowania akapitu należy określić nowe obramowanie w całości. |
border |
obramowanie na dole tego akapitu. Jeśli nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego. Dolna krawędź jest renderowana, gdy akapit poniżej ma inne właściwości obramowania i wcięcia. Ramki akapitu nie można zaktualizować częściowo. Podczas zmiany obramowania akapitu należy określić nowe obramowanie w całości. |
border |
Obramowanie po lewej stronie tego akapitu. Jeśli nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego. Ramki akapitu nie można zaktualizować częściowo. Podczas zmiany obramowania akapitu należy określić nowe obramowanie w całości. |
border |
Obrzeże po prawej stronie tego akapitu. Jeśli nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego. Ramki akapitu nie można zaktualizować częściowo. Podczas zmiany obramowania akapitu należy określić nowe obramowanie w całości. |
indent |
Wielkość wcięcia pierwszego wiersza akapitu. Jeśli nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego. |
indent |
Wielkość wcięcia akapitu po stronie odpowiadającej początkowi tekstu, na podstawie bieżącego kierunku akapitu. Jeśli nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego. |
indent |
Odstęp akapitu od lewej strony, który odpowiada prawej stronie tekstu, na podstawie bieżącego kierunku akapitu. Jeśli nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego. |
tab |
Lista tabulatorów w tym akapicie. Lista przystanków nie jest dziedziczona. Ta usługa jest tylko do odczytu. |
keep |
Określa, czy wszystkie wiersze akapitu mają być rozmieszczone na tej samej stronie lub w tej samej kolumnie (jeśli to możliwe). Jeśli nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego. |
keep |
Określa, czy w miarę możliwości co najmniej część tego akapitu powinna być umieszczona na tej samej stronie lub w tej samej kolumnie co następny akapit. Jeśli nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego. |
avoid |
Określa, czy w przypadku akapitu należy unikać wdółek i odstępów. Jeśli nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego. |
shading |
Cieniowanie akapitu. Jeśli nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego. |
page |
Określa, czy bieżący akapit ma zawsze zaczynać się na początku strony. Jeśli nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego. Próba zaktualizowania |
NamedStyleType
Typy stylów nazwanych.
Wartości w polu enum | |
---|---|
NAMED_STYLE_TYPE_UNSPECIFIED |
Nieokreślony typ nazwanego stylu. |
NORMAL_TEXT |
Zwykły tekst. |
TITLE |
Tytuł. |
SUBTITLE |
Napisy. |
HEADING_1 |
Nagłówek 1. |
HEADING_2 |
Nagłówek 2. |
HEADING_3 |
Nagłówek 3. |
HEADING_4 |
Nagłówek 4. |
HEADING_5 |
Nagłówek 5. |
HEADING_6 |
Nagłówek 6. |
Wyrównanie
Typy wyrównania tekstu w akapicie.
Wartości w polu enum | |
---|---|
ALIGNMENT_UNSPECIFIED |
Wyrównanie akapitu jest dziedziczone z elementu nadrzędnego. |
START |
Akapit jest wyrównany do początku wiersza. Wyrównany do lewej w przypadku tekstu w kierunku od lewej do prawej, a w przeciwnym razie wyrównany do prawej. |
CENTER |
Akapit jest wyśrodkowany. |
END |
Akapit jest wyrównany do końca wiersza. Wyrównany do prawej w przypadku tekstu w kierunku z lewej do prawej, a w przeciwnym razie wyrównany do lewej. |
JUSTIFIED |
Akapit jest wyjustowany. |
ContentDirection
Treści z mapami mogą być przesyłane.
Wartości w polu enum | |
---|---|
CONTENT_DIRECTION_UNSPECIFIED |
Kierunek treści jest nieokreślony. |
LEFT_TO_RIGHT |
Treści są wyświetlane od lewej do prawej. |
RIGHT_TO_LEFT |
Treści są wyświetlane od prawej do lewej. |
SpacingMode
Różne tryby interliniowania akapitów.
Wartości w polu enum | |
---|---|
SPACING_MODE_UNSPECIFIED |
Tryb rozmieszczania jest dziedziczony z elementu nadrzędnego. |
NEVER_COLLAPSE |
Odstępy między akapitami są zawsze renderowane. |
COLLAPSE_LISTS |
Odstępy akapitowe są pomijane między elementami listy. |
ParagraphBorder
Obramowanie akapitu.
Zapis JSON |
---|
{ "color": { object ( |
Pola | |
---|---|
color |
Kolor obramowania. |
width |
Szerokość obramowania. |
padding |
Odstęp od obramowania. |
dash |
Styl kresek obramowania. |
DashStyle
Rodzaje kresek, za pomocą których można renderować geometrię liniową. Te wartości są oparte na typie prostym „ST_PresetLineDashVal” opisanym w sekcji 20.1.10.48 dokumentu „Office Open XML File Formats – Fundamentals and Markup Language Reference” (Formaty plików Office Open XML – podstawy i odniesienia do języka znaczników), część 1, ECMA-376, 4 edycja.
Wartości w polu enum | |
---|---|
DASH_STYLE_UNSPECIFIED |
Nieokreślony styl kreski. |
SOLID |
Linia ciągła. Odpowiada wartości „solid” (ciągły) w standardzie ECMA-376 ST_PresetLineDashVal. To jest domyślny styl kreski. |
DOT |
linia przerywana. Odpowiada wartości „dot” (kropka) w standardzie ECMA-376 ST_PresetLineDashVal. |
DASH |
Linia przerywana. Odpowiada wartości „dash” (kreska) w standardzie ECMA-376 ST_PresetLineDashVal. |
TabStop
tabulacja w akapicie.
Zapis JSON |
---|
{ "offset": { object ( |
Pola | |
---|---|
offset |
Odstęp między tym przystankiem a marginesem początkowym. |
alignment |
Wyrównanie tej karty zostało zatrzymane. Jeśli nie zostanie ustawiony, wartością domyślną jest |
TabStopAlignment
Wyrównanie tabulatora.
Wartości w polu enum | |
---|---|
TAB_STOP_ALIGNMENT_UNSPECIFIED |
Wyrównanie przycisku zatrzymania karty jest nieokreślone. |
START |
Zatrzask jest wyrównany do początku linii. Jest to ustawienie domyślne. |
CENTER |
Zatrzask jest wyrównany do środka linii. |
END |
Zatrzask jest wyrównany do końca wiersza. |
Cieniowanie
Cieniowanie akapitu.
Zapis JSON |
---|
{
"backgroundColor": {
object ( |
Pola | |
---|---|
background |
Kolor tła cieniowania tego akapitu. |
SuggestedParagraphStyle
sugerowana zmiana w elemencie ParagraphStyle
;
Zapis JSON |
---|
{ "paragraphStyle": { object ( |
Pola | |
---|---|
paragraph |
|
paragraph |
Maska wskazująca, które pola w podstawowym |
ParagraphStyleSuggestionState
Maska wskazująca, które pola w podstawowym ParagraphStyle
zostały zmienione w tej propozycji. W przypadku każdego pola ustawionego na „Prawda” jest nowa sugerowana wartość.
Zapis JSON |
---|
{
"headingIdSuggested": boolean,
"namedStyleTypeSuggested": boolean,
"alignmentSuggested": boolean,
"lineSpacingSuggested": boolean,
"directionSuggested": boolean,
"spacingModeSuggested": boolean,
"spaceAboveSuggested": boolean,
"spaceBelowSuggested": boolean,
"borderBetweenSuggested": boolean,
"borderTopSuggested": boolean,
"borderBottomSuggested": boolean,
"borderLeftSuggested": boolean,
"borderRightSuggested": boolean,
"indentFirstLineSuggested": boolean,
"indentStartSuggested": boolean,
"indentEndSuggested": boolean,
"keepLinesTogetherSuggested": boolean,
"keepWithNextSuggested": boolean,
"avoidWidowAndOrphanSuggested": boolean,
"shadingSuggestionState": {
object ( |
Pola | |
---|---|
heading |
Wskazuje, czy zasugerowano zmianę na |
named |
Wskazuje, czy zasugerowano zmianę na |
alignment |
Wskazuje, czy zasugerowano zmianę na |
line |
Wskazuje, czy zasugerowano zmianę na |
direction |
Wskazuje, czy zasugerowano zmianę na |
spacing |
Wskazuje, czy zasugerowano zmianę na |
space |
Wskazuje, czy zasugerowano zmianę na |
space |
Wskazuje, czy zasugerowano zmianę na |
border |
Wskazuje, czy zasugerowano zmianę na |
border |
Wskazuje, czy zasugerowano zmianę na |
border |
Wskazuje, czy zasugerowano zmianę na |
border |
Wskazuje, czy zasugerowano zmianę na |
border |
Wskazuje, czy zasugerowano zmianę na |
indent |
Wskazuje, czy zasugerowano zmianę na |
indent |
Wskazuje, czy zasugerowano zmianę na |
indent |
Wskazuje, czy zasugerowano zmianę na |
keep |
Wskazuje, czy zasugerowano zmianę na |
keep |
Wskazuje, czy zasugerowano zmianę na |
avoid |
Wskazuje, czy zasugerowano zmianę na |
shading |
Maska wskazująca, które pola w elementach |
page |
Wskazuje, czy zasugerowano zmianę na |
ShadingSuggestionState
Maska wskazująca, które pola w podstawowym Shading
zostały zmienione w sugerowanej zmianie. W przypadku każdego pola ustawionego na „Prawda” jest nowa sugerowana wartość.
Zapis JSON |
---|
{ "backgroundColorSuggested": boolean } |
Pola | |
---|---|
background |
Wskazuje, czy sugerowano zmianę w sekcji |
Punktor
Opisuje punkt akapitu.
Zapis JSON |
---|
{
"listId": string,
"nestingLevel": integer,
"textStyle": {
object ( |
Pola | |
---|---|
list |
Identyfikator listy, do której należy ten akapit. |
nesting |
Poziom zagnieżdżenia tego akapitu na liście. |
text |
Styl tekstu odnoszący się do akapitu zastosowany do tego punktu. |
SuggestedBullet
sugerowana zmiana w elemencie Bullet
;
Zapis JSON |
---|
{ "bullet": { object ( |
Pola | |
---|---|
bullet |
|
bullet |
Maska wskazująca, które pola w podstawowym |
BulletSuggestionState
Maska wskazująca, które pola w podstawowym Bullet
zostały zmienione w tej propozycji. W przypadku każdego pola ustawionego na „Prawda” jest nowa sugerowana wartość.
Zapis JSON |
---|
{
"listIdSuggested": boolean,
"nestingLevelSuggested": boolean,
"textStyleSuggestionState": {
object ( |
Pola | |
---|---|
list |
Wskazuje, czy sugerowano zmianę w sekcji |
nesting |
Wskazuje, czy sugerowano zmianę w sekcji |
text |
Maska wskazująca, które pola w elementach |
ObjectReferences
Kolekcja identyfikatorów obiektów.
Zapis JSON |
---|
{ "objectIds": [ string ] } |
Pola | |
---|---|
object |
Identyfikatory obiektów. |
SectionBreak
StructuralElement
oznaczający podział sekcji. Sekcja to zakres treści o tej samej SectionStyle
. Podział sekcji oznacza początek nowej sekcji, a styl sekcji ma zastosowanie do sekcji po podziale.
Treść dokumentu zawsze zaczyna się od przejścia do sekcji.
Zapis JSON |
---|
{
"suggestedInsertionIds": [
string
],
"suggestedDeletionIds": [
string
],
"sectionStyle": {
object ( |
Pola | |
---|---|
suggested |
Sugerowane identyfikatory wstawień. Jeśli |
suggested |
Identyfikatory sugerowanych do usunięcia. Jeśli jest puste, nie ma żadnych sugerowanych usunięcia tych treści. |
section |
Styl sekcji po przerwie. |
SectionStyle
Stylizacja stosowana w sekcji.
Zapis JSON |
---|
{ "columnProperties": [ { object ( |
Pola | |
---|---|
column |
Właściwości kolumn sekcji. Jeśli jest pusta, zawiera w edytorze Dokumentów jedną kolumnę z właściwościami domyślnymi. Sekcję można zaktualizować tak, aby zawierała maksymalnie 3 kolumny. Podczas aktualizowania tej właściwości należy ustawić konkretną wartość. Jeśli nie ustawisz tej właściwości, wystąpi błąd 400 „Nieprawidłowe żądanie”. |
column |
Styl separatorów kolumn. Ten styl można ustawić nawet wtedy, gdy w sekcji jest tylko 1 kolumna. Podczas aktualizowania tej właściwości należy ustawić konkretną wartość. Jeśli nie ustawisz tej właściwości, wystąpi błąd 400 „Nieprawidłowe żądanie”. |
content |
Kierunek treści w tej sekcji. Jeśli nie zostanie ustawiony, wartością domyślną jest Podczas aktualizowania tej właściwości należy ustawić konkretną wartość. Jeśli nie ustawisz tej właściwości, wystąpi błąd 400 „Nieprawidłowe żądanie”. |
margin |
Górny margines strony sekcji. Jeśli nie zostanie ustawiony, wartość domyślna to Podczas aktualizowania tej właściwości należy ustawić konkretną wartość. Jeśli nie ustawisz tej właściwości, wystąpi błąd 400 „Nieprawidłowe żądanie”. |
margin |
Dolny margines strony sekcji. Jeśli nie zostanie ustawiony, wartość domyślna to Podczas aktualizowania tej właściwości należy ustawić konkretną wartość. Jeśli nie ustawisz tej właściwości, wystąpi błąd 400 „Nieprawidłowe żądanie”. |
margin |
Prawy margines strony sekcji. Jeśli nie zostanie ustawiony, wartość domyślna to Podczas aktualizowania tej właściwości należy ustawić konkretną wartość. Jeśli nie ustawisz tej właściwości, wystąpi błąd 400 „Nieprawidłowe żądanie”. |
margin |
Lewy margines strony sekcji. Jeśli nie zostanie ustawiony, wartość domyślna to Podczas aktualizowania tej właściwości należy ustawić konkretną wartość. Jeśli nie ustawisz tej właściwości, wystąpi błąd 400 „Nieprawidłowe żądanie”. |
margin |
Margines nagłówka sekcji. Jeśli nie zostanie ustawiony, wartość domyślna to Podczas aktualizowania tej właściwości należy ustawić konkretną wartość. Jeśli nie ustawisz tej właściwości, wystąpi błąd 400 „Nieprawidłowe żądanie”. |
margin |
Margines stopki sekcji. Jeśli nie zostanie ustawiony, wartość domyślna to Podczas aktualizowania tej właściwości należy ustawić konkretną wartość. Jeśli nie ustawisz tej właściwości, wystąpi błąd 400 „Nieprawidłowe żądanie”. |
section |
Tylko dane wyjściowe. Typ sekcji. |
default |
Identyfikator nagłówka domyślnego. Jeśli nie zostanie ustawiony, wartość zostanie odziedziczona z poprzedniego elementu Ta usługa jest tylko do odczytu. |
default |
Identyfikator domyślnego stopki. Jeśli nie zostanie ustawiony, wartość zostanie odziedziczona z poprzedniego elementu Ta usługa jest tylko do odczytu. |
first |
Identyfikator nagłówka używanego tylko na pierwszej stronie sekcji. Jeśli Ta usługa jest tylko do odczytu. |
first |
Identyfikator stopki używanej tylko na pierwszej stronie sekcji. Jeśli Ta usługa jest tylko do odczytu. |
even |
Identyfikator nagłówka używanego tylko na stronach parzystych. Jeśli wartość atrybutu Ta usługa jest tylko do odczytu. |
even |
Identyfikator stopki używanej tylko na stronach parzystych. Jeśli wartość Ta usługa jest tylko do odczytu. |
use |
Wskazuje, czy na pierwszej stronie sekcji mają być używane identyfikatory nagłówka / stopki pierwszej strony. Jeśli nie jest ustawiony, dziedziczy wartość Podczas aktualizowania tej właściwości należy ustawić konkretną wartość. Jeśli nie ustawisz tej właściwości, wystąpi błąd 400 „Nieprawidłowe żądanie”. |
page |
Numer strony, od której ma się zaczynać zliczanie liczby stron w tej sekcji. Jeśli nie jest ustawione, numerowanie stron jest kontynuowane z poprzedniej sekcji. Jeśli wartość w pierwszym elemencie Podczas aktualizowania tej właściwości należy ustawić konkretną wartość. Jeśli nie ustawisz tej właściwości, wystąpi błąd 400 „Nieprawidłowe żądanie”. |
flip |
Opcjonalnie: Wskazuje, czy w tym dziale wymiary Podczas aktualizowania tej właściwości należy ustawić konkretną wartość. Jeśli nie ustawisz tej właściwości, wystąpi błąd 400 „Nieprawidłowe żądanie”. |
SectionColumnProperties
Właściwości, które mają zastosowanie do kolumny sekcji.
Zapis JSON |
---|
{ "width": { object ( |
Pola | |
---|---|
width |
Tylko dane wyjściowe. Szerokość kolumny. |
padding |
Odstęp na końcu kolumny. |
ColumnSeparatorStyle
Styl separatorów kolumn.
Wartości w polu enum | |
---|---|
COLUMN_SEPARATOR_STYLE_UNSPECIFIED |
Nieokreślony styl separatora kolumny. |
NONE |
Brak linii rozdzielających kolumny. |
BETWEEN_EACH_COLUMN |
Wyświetla linię oddzielającą kolumny. |
SectionType
Określa, jak początek bieżącej sekcji jest umieszczony względem poprzedniej sekcji.
Wartości w polu enum | |
---|---|
SECTION_TYPE_UNSPECIFIED |
Typ sekcji nie został określony. |
CONTINUOUS |
Sekcja zaczyna się bezpośrednio po ostatnim akapicie poprzedniej sekcji. |
NEXT_PAGE |
Sekcja rozpoczyna się na następnej stronie. |
Tabela
StructuralElement
reprezentujący tabelę.
Zapis JSON |
---|
{ "rows": integer, "columns": integer, "tableRows": [ { object ( |
Pola | |
---|---|
rows |
Liczba wierszy w tabeli. |
columns |
Liczba kolumn w tabeli. Tabela może mieć kształt nieprostokątny, więc niektóre wiersze mogą mieć inną liczbę komórek. |
table |
Treść i styl każdego wiersza. |
suggested |
Sugerowane identyfikatory wstawień. Jeśli |
suggested |
Identyfikatory sugerowanych do usunięcia. Jeśli jest puste, nie ma żadnych sugerowanych usunięcia tych treści. |
table |
Styl tabeli. |
TableRow
Treść i styl wiersza w Table
.
Zapis JSON |
---|
{ "startIndex": integer, "endIndex": integer, "tableCells": [ { object ( |
Pola | |
---|---|
start |
Indeks początkowy tego wiersza (liczony od 0) w jednostkach kodu UTF-16. |
end |
Indeks końcowy tego wiersza (liczony od 0) w jednostkach kodu UTF-16 (bez uwzględnienia ostatniego wiersza). |
table |
Treść i styl każdej komórki w tym wierszu. Tabela może mieć kształt nieprostokątny, więc niektóre wiersze mogą mieć inną liczbę komórek niż inne wiersze w tej samej tabeli. |
suggested |
Sugerowane identyfikatory wstawień. Jeśli |
suggested |
Identyfikatory sugerowanych do usunięcia. Jeśli jest puste, nie ma żadnych sugerowanych usunięcia tych treści. |
table |
Styl wiersza tabeli. |
suggested |
Sugerowany styl zmienia się na ten wiersz, którego kluczem jest identyfikator sugestii. |
TableCell
Treść i styl komórki w Table
.
Zapis JSON |
---|
{ "startIndex": integer, "endIndex": integer, "content": [ { object ( |
Pola | |
---|---|
start |
Indeks początkowy tej komórki (liczony od 0) w jednostkach kodu UTF-16. |
end |
Indeks końcowy tej komórki (liczony od 0) w jednostkach kodu UTF-16 (bez uwzględnienia). |
content[] |
Treść komórki. |
table |
Styl komórki. |
suggested |
Sugerowane identyfikatory wstawień. Jeśli |
suggested |
Identyfikatory sugerowanych do usunięcia. Jeśli jest puste, nie ma żadnych sugerowanych usunięcia tych treści. |
suggested |
Sugerowane zmiany stylu komórki tabeli, posortowane według identyfikatora sugestii. |
TableCellStyle
Styl TableCell
.
Styly komórek tabeli odziedziczone są w tym komunikacie reprezentowane jako pola nieprzypisane. Styl komórki tabeli może odziedziczyć styl tabeli.
Zapis JSON |
---|
{ "rowSpan": integer, "columnSpan": integer, "backgroundColor": { object ( |
Pola | |
---|---|
row |
Zakres komórki w wierszach. Ta usługa jest tylko do odczytu. |
column |
Zakres kolumny komórki. Ta usługa jest tylko do odczytu. |
background |
Kolor tła komórki. |
border |
Lewa krawędź komórki. |
border |
Prawa krawędź komórki. |
border |
Górne obramowanie komórki. |
border |
Dolna krawędź komórki. |
padding |
Wypełnienie z lewej strony komórki. |
padding |
Prawe wypełnienie komórki. |
padding |
Dopełnienie górnej części komórki. |
padding |
Dopełnienie komórki u dołu. |
content |
Wyrównanie zawartości w komórce tabeli. Domyślne wyrównanie odpowiada wyrównaniu nowo utworzonych komórek tabeli w edytorze Dokumentów. |
TableCellBorder
Obramowanie komórki tabeli.
Ramki komórek tabeli nie mogą być przezroczyste. Aby ukryć obramowanie komórki tabeli, ustaw jego szerokość na 0.
Zapis JSON |
---|
{ "color": { object ( |
Pola | |
---|---|
color |
Kolor obramowania. Ten kolor nie może być przezroczysty. |
width |
Szerokość obramowania. |
dash |
Styl kresek obramowania. |
ContentAlignment
Typy dopasowania treści.
Wyprowadzony z podzbioru wartości typu prostego „ST_TextAnchoringType” w sekcji 20.1.10.59 dokumentu „Office Open XML File Formats – Fundamentals and Markup Language Reference” (Formaty plików Office Open XML – podstawy i odniesienia do języka znaczników), część 1, ECMA-376 w 4 edycji.
Wartości w polu enum | |
---|---|
CONTENT_ALIGNMENT_UNSPECIFIED |
Nieokreślone wyrównanie treści. Wyrównanie treści jest dziedziczone z elementu nadrzędnego, jeśli taki istnieje. |
CONTENT_ALIGNMENT_UNSUPPORTED |
Nieobsługiwane wyrównanie treści. |
TOP |
Wyrównanie, które wyrównuje treść do górnej części elementu. Odpowiada parametrowi ECMA-376 ST_TextAnchoringType „t”. |
MIDDLE |
Wyrównanie, które wyrównuje treść do środka elementu. Odpowiada wartości ECMA-376 ST_TextAnchoringType „ctr”. |
BOTTOM |
Wyrównanie, które wyrównuje treść do dolnej krawędzi elementu. Odpowiada wartości „b” typu ECMA-376 ST_TextAnchoringType. |
SuggestedTableCellStyle
sugerowana zmiana w elemencie TableCellStyle
;
Zapis JSON |
---|
{ "tableCellStyle": { object ( |
Pola | |
---|---|
table |
|
table |
Maska wskazująca, które pola w podstawowym |
TableCellStyleSuggestionState
Maska wskazująca, które pola w podstawowym TableCellStyle
zostały zmienione w tej propozycji. W przypadku każdego pola ustawionego na „Prawda” jest nowa sugerowana wartość.
Zapis JSON |
---|
{ "rowSpanSuggested": boolean, "columnSpanSuggested": boolean, "backgroundColorSuggested": boolean, "borderLeftSuggested": boolean, "borderRightSuggested": boolean, "borderTopSuggested": boolean, "borderBottomSuggested": boolean, "paddingLeftSuggested": boolean, "paddingRightSuggested": boolean, "paddingTopSuggested": boolean, "paddingBottomSuggested": boolean, "contentAlignmentSuggested": boolean } |
Pola | |
---|---|
row |
Wskazuje, czy zasugerowano zmianę na |
column |
Wskazuje, czy zasugerowano zmianę na |
background |
Wskazuje, czy zasugerowano zmianę na |
border |
Wskazuje, czy zasugerowano zmianę na |
border |
Wskazuje, czy zasugerowano zmianę na |
border |
Wskazuje, czy zasugerowano zmianę na |
border |
Wskazuje, czy zasugerowano zmianę na |
padding |
Wskazuje, czy zasugerowano zmianę na |
padding |
Wskazuje, czy zasugerowano zmianę na |
padding |
Wskazuje, czy zasugerowano zmianę na |
padding |
Wskazuje, czy zasugerowano zmianę na |
content |
Wskazuje, czy zasugerowano zmianę na |
TableRowStyle
Style stosowane do wiersza tabeli.
Zapis JSON |
---|
{
"minRowHeight": {
object ( |
Pola | |
---|---|
min |
Minimalna wysokość wiersza. Wiersz zostanie wyrenderowany w edytorze Dokumentów z wysokością równą tej wartości lub większą, aby pokazać całą zawartość komórek wiersza. |
table |
Określa, czy wiersz jest nagłówkiem tabeli. |
prevent |
Określa, czy wiersz nie może przekroczyć granicy strony lub kolumny. |
SuggestedTableRowStyle
sugerowana zmiana w elemencie TableRowStyle
;
Zapis JSON |
---|
{ "tableRowStyle": { object ( |
Pola | |
---|---|
table |
|
table |
Maska wskazująca, które pola w podstawowym |
TableRowStyleSuggestionState
Maska wskazująca, które pola w podstawowym TableRowStyle
zostały zmienione w tej propozycji. W przypadku każdego pola ustawionego na „Prawda” jest nowa sugerowana wartość.
Zapis JSON |
---|
{ "minRowHeightSuggested": boolean } |
Pola | |
---|---|
min |
Wskazuje, czy zasugerowano zmianę na |
TableStyle
Style stosowane do tabeli.
Zapis JSON |
---|
{
"tableColumnProperties": [
{
object ( |
Pola | |
---|---|
table |
Właściwości każdej kolumny. Pamiętaj, że w Dokumentach tabele zawierają wiersze, a wiersze zawierają komórki, podobnie jak w kodzie HTML. Właściwości wiersza można znaleźć w elementach |
TableColumnProperties
Właściwości kolumny w tabeli.
Zapis JSON |
---|
{ "widthType": enum ( |
Pola | |
---|---|
width |
Typ szerokości kolumny. |
width |
Szerokość kolumny. Ustaw, gdy wartość |
WidthType
Typ szerokości kolumny.
Wartości w polu enum | |
---|---|
WIDTH_TYPE_UNSPECIFIED |
Typ szerokości kolumny jest nieokreślony. |
EVENLY_DISTRIBUTED |
Szerokość kolumny jest równomiernie rozłożona między inne kolumny o równej szerokości. Szerokość kolumny jest określana automatycznie i będzie równa części szerokości tabeli po uwzględnieniu wszystkich kolumn o określonej szerokości. |
FIXED_WIDTH |
stała szerokość kolumny, Właściwość [width][google.apps.docs.v1.TableColumnProperties.width ] zawiera szerokość kolumny. |
TableOfContents
StructuralElement
reprezentujący spis treści.
Zapis JSON |
---|
{
"content": [
{
object ( |
Pola | |
---|---|
content[] |
Treść spisu treści. |
suggested |
Sugerowane identyfikatory wstawień. Jeśli |
suggested |
Identyfikatory sugerowanych do usunięcia. Jeśli jest puste, nie ma żadnych sugerowanych usunięcia tych treści. |
Nagłówek
Nagłówek dokumentu.
Zapis JSON |
---|
{
"headerId": string,
"content": [
{
object ( |
Pola | |
---|---|
header |
Identyfikator nagłówka. |
content[] |
Treść nagłówka. Indeksy treści nagłówka zaczynają się od 0. |
Przypis
przypis do dokumentu,
Zapis JSON |
---|
{
"footnoteId": string,
"content": [
{
object ( |
Pola | |
---|---|
footnote |
Identyfikator przypisu. |
content[] |
Treść przypisu. Indeksy zawartości przypisu zaczynają się od 0. |
DocumentStyle
Styl dokumentu.
Zapis JSON |
---|
{ "background": { object ( |
Pola | |
---|---|
background |
Tłoko dokumentu. Dokumenty nie mogą mieć przezroczystego koloru tła. |
default |
Identyfikator nagłówka domyślnego. Jeśli nie zostanie ustawiony, nie będzie nagłówka domyślnego. Ta usługa jest tylko do odczytu. |
default |
Identyfikator domyślnego stopki. Jeśli nie zostanie ustawiony, nie będzie nagłówka domyślnego. Ta usługa jest tylko do odczytu. |
even |
Identyfikator nagłówka używanego tylko na stronach parzystych. Wartość parametru Ta usługa jest tylko do odczytu. |
even |
Identyfikator stopki używanej tylko na stronach parzystych. Wartość parametru Ta usługa jest tylko do odczytu. |
first |
Identyfikator nagłówka używanego tylko na pierwszej stronie. Jeśli nie jest ustawiony, na pierwszej stronie nie ma unikalnego nagłówka. Wartość Ta usługa jest tylko do odczytu. |
first |
Identyfikator stopki używanej tylko na pierwszej stronie. Jeśli nie jest ustawiony, na pierwszej stronie nie ma unikalnej stopki. Wartość Ta usługa jest tylko do odczytu. |
use |
Wskazuje, czy na pierwszej stronie mają być używane identyfikatory nagłówka / stopki pierwszej strony. |
use |
Wskazuje, czy na stronach parzystych mają być używane identyfikatory nagłówka / stopki strony parzystej. |
page |
Numer strony, od której ma się rozpoczynać zliczanie liczby stron. |
margin |
Górny margines strony. Zmiana górnego marginesu strony w stylu dokumentu powoduje usunięcie górnego marginesu strony we wszystkich stylach sekcji. |
margin |
Dolny margines strony. Zmiana dolnego marginesu strony w stylu dokumentu powoduje wyczyszczenie dolnego marginesu strony we wszystkich stylach sekcji. |
margin |
Prawy margines strony. Zmiana prawego marginesu strony w stylu dokumentu powoduje wyczyszczenie prawego marginesu strony we wszystkich stylach sekcji. Może to też spowodować zmianę rozmiaru kolumn we wszystkich sekcjach. |
margin |
Lewy margines strony. Zmiana lewego marginesu strony w stylu dokumentu powoduje wyczyszczenie lewego marginesu strony we wszystkich stylach sekcji. Może to też spowodować zmianę rozmiaru kolumn we wszystkich sekcjach. |
page |
Rozmiar strony w dokumencie. |
margin |
Odległość między górną krawędzią strony a zawartością nagłówka. |
margin |
Ilość miejsca między dolną krawędzią strony a zawartością stopki. |
use |
Wskazuje, czy uwzględniane są atrybuty DocumentStyle Ta usługa jest tylko do odczytu. |
flip |
Opcjonalnie: Określa, czy wymiary |
Tło
Reprezentuje tło dokumentu.
Zapis JSON |
---|
{
"color": {
object ( |
Pola | |
---|---|
color |
Kolor tła. |
Rozmiar
szerokość i wysokość;
Zapis JSON |
---|
{ "height": { object ( |
Pola | |
---|---|
height |
Wysokość obiektu. |
width |
Szerokość obiektu. |
SuggestedDocumentStyle
Zaproponowana zmiana w DocumentStyle
.
Zapis JSON |
---|
{ "documentStyle": { object ( |
Pola | |
---|---|
document |
|
document |
Maska wskazująca, które pola w podstawowym |
DocumentStyleSuggestionState
Maska wskazująca, które pola w podstawowym DocumentStyle
zostały zmienione w tej propozycji. W przypadku każdego pola ustawionego na „Prawda” jest nowa sugerowana wartość.
Zapis JSON |
---|
{ "backgroundSuggestionState": { object ( |
Pola | |
---|---|
background |
Maska wskazująca, które pola w elementach |
default |
Wskazuje, czy zasugerowano zmianę na |
default |
Wskazuje, czy zasugerowano zmianę na |
even |
Wskazuje, czy zasugerowano zmianę na |
even |
Wskazuje, czy zasugerowano zmianę na |
first |
Wskazuje, czy zasugerowano zmianę na |
first |
Wskazuje, czy zasugerowano zmianę na |
use |
Wskazuje, czy zasugerowano zmianę na |
use |
Wskazuje, czy zasugerowano zmianę na |
page |
Wskazuje, czy zasugerowano zmianę na |
margin |
Wskazuje, czy zasugerowano zmianę na |
margin |
Wskazuje, czy zasugerowano zmianę na |
margin |
Wskazuje, czy zasugerowano zmianę na |
margin |
Wskazuje, czy zasugerowano zmianę na |
page |
Maska wskazująca, które pola w [size] [google.apps.docs.v1.DocumentStyle.size] zostały zmienione w tej propozycji. |
margin |
Wskazuje, czy zasugerowano zmianę na |
margin |
Wskazuje, czy zasugerowano zmianę na |
use |
Wskazuje, czy zasugerowano zmianę na |
flip |
Opcjonalnie: Wskazuje, czy zasugerowano zmianę na |
BackgroundSuggestionState
Maska wskazująca, które pola w podstawowym Background
zostały zmienione w tej propozycji. W przypadku każdego pola ustawionego na „Prawda” element Backgound
ma nową sugerowaną wartość.
Zapis JSON |
---|
{ "backgroundColorSuggested": boolean } |
Pola | |
---|---|
background |
Wskazuje, czy w tej propozycji został zmieniony bieżący kolor tła. |
SizeSuggestionState
Maska wskazująca, które pola w podstawowym Size
zostały zmienione w tej propozycji. W przypadku każdego pola ustawionego na „Prawda” element Size
ma nową sugerowaną wartość.
Zapis JSON |
---|
{ "heightSuggested": boolean, "widthSuggested": boolean } |
Pola | |
---|---|
height |
Wskazuje, czy zasugerowano zmianę na |
width |
Wskazuje, czy zasugerowano zmianę na |
NamedStyles
Style nazwane. Akapity w dokumencie mogą dziedziczyć wartości TextStyle
i ParagraphStyle
z tych nazwanych stylów.
Zapis JSON |
---|
{
"styles": [
{
object ( |
Pola | |
---|---|
styles[] |
Style nazwane. Wpis jest tworzony dla każdego możliwego |
NamedStyle
Styl o nazwie. Akapity w dokumencie mogą dziedziczyć wartości TextStyle
i ParagraphStyle
z tego stylu, jeśli mają ten sam typ stylu.
Zapis JSON |
---|
{ "namedStyleType": enum ( |
Pola | |
---|---|
named |
Typ tego nazwanego stylu. |
text |
Styl tekstu tego stylu nazwanego. |
paragraph |
Styl akapitu tego stylu nazwanego. |
SuggestedNamedStyles
Zaproponowana zmiana w NamedStyles
.
Zapis JSON |
---|
{ "namedStyles": { object ( |
Pola | |
---|---|
named |
|
named |
Maska wskazująca, które pola w podstawowym |
NamedStylesSuggestionState
Stan sugestii w wiadomości NamedStyles
.
Zapis JSON |
---|
{
"stylesSuggestionStates": [
{
object ( |
Pola | |
---|---|
styles |
Maska wskazująca, które pola w odpowiednim elemencie Kolejność stanów nazwanych sugestii stylów odpowiada kolejności nazwanych stylów w sugestii |
NamedStyleSuggestionState
Stan sugestii w wiadomości NamedStyle
.
Zapis JSON |
---|
{ "namedStyleType": enum ( |
Pola | |
---|---|
named |
Nazwa typu stylu, któremu odpowiada stan sugestii. To pole jest udostępniane w celu ułatwienia dopasowywania stanu NamedStyleSuggestionState do odpowiadającego mu |
text |
Maska wskazująca, które pola w elementach |
paragraph |
Maska wskazująca, które pola w elementach |
Lista
Lista reprezentuje atrybuty listy dla grupy akapitów, które należą do tej samej listy. Akapit, który jest częścią listy, zawiera w polu bullet
odwołanie do identyfikatora listy.
Zapis JSON |
---|
{ "listProperties": { object ( |
Pola | |
---|---|
list |
Właściwości listy. |
suggested |
Proponowane zmiany właściwości listy, posortowane według identyfikatora sugestii. |
suggested |
Sugerowany identyfikator wstawienia. Jeśli jest puste, nie jest to sugerowane wstawienie. |
suggested |
Identyfikatory sugerowanych do usunięcia. Jeśli jest puste, nie ma żadnych sugerowanych usunąć z tej listy. |
ListProperties
Właściwości list
opisujące wygląd i działanie symboli wypunktowania należących do akapitów powiązanych z listą.
Zapis JSON |
---|
{
"nestingLevels": [
{
object ( |
Pola | |
---|---|
nesting |
Opisuje właściwości punktów na powiązanym poziomie. Lista może mieć maksymalnie 9 poziomów zagnieżdżenia, przy czym poziom 0 odpowiada najwyższemu poziomowi, a poziom 8 – najbardziej zagnieżdżonemu poziomowi. Poziomy zagnieżdżenia są zwracane w kolejności rosnącej, a więc najpierw jest zwracany poziom najmniej zagnieżdżony. |
NestingLevel
Zawiera właściwości opisujące wygląd i wygląd symbolu na liście na danym poziomie zagnieżdżenia.
Zapis JSON |
---|
{ "bulletAlignment": enum ( |
Pola | |
---|---|
bullet |
wyrównanie cyfry w ramach miejsca przeznaczonego na jej wyświetlenie, |
glyph |
Format ciągu używany przez punktory na tym poziomie zagnieżdżania. Format glifów zawiera co najmniej 1 miejsce zastępcze, które jest zastępowane odpowiednimi wartościami w zależności od Na przykład format znaku
Format glifów może zawierać placeholdery dla bieżącego poziomu zagnieżdżenia oraz placeholdery dla nadrzędnych poziomów zagnieżdżenia. Na przykład lista może mieć format glifu
W przypadku uporządkowanych poziomów zagnieżdżania ciąg znaków, który zastępuje symbol zastępczy w formacie glifu w przypadku danego akapitu, zależy od kolejności akapitu na liście. |
indent |
Wielkość wcięcia pierwszego wiersza akapitów na tym poziomie zagnieżdżenia. |
indent |
Wielkość wcięcia akapitów na tym poziomie zagnieżdżenia. Zastosowany po stronie odpowiadającej początkowi tekstu na podstawie kierunku treści akapitu. |
text |
Styl tekstu w punkcie na tym poziomie umieszczania. |
start |
Numer pierwszego elementu listy na tym poziomie zagnieżdżenia. Wartość 0 jest traktowana jako wartość 1 w przypadku list z literami i rzymskimi cyframi. W przypadku wartości 0 i 1 listy literowe i rzymskie będą się zaczynać odpowiednio od Ta wartość jest ignorowana w przypadku poziomów zagnieżdżenia z nieuporządkowanymi glifami. |
Pole unii glyph_kind . Rodzaj glifu używanego przez symbole. Określa znak strzałki, który zastępuje zastępniki w elementach glyph_format . glyph_kind może być tylko jednym z tych elementów: |
|
glyph |
Typ znaku używanego przez wypunktowanie, gdy akapity na tym poziomie zagnieżdżenia są uporządkowane. Typ glifu określa typ glifu używanego do zastępowania obiektów zastępczych w sekcji |
glyph |
Symbol niestandardowego glifu używany przez kule, gdy akapity na tym poziomie zagnieżdżenia są nieuporządkowane. Symbol glifu zastępuje obiekty zastępcze w miejscu |
BulletAlignment
Typy wyrównania dla wypunktowania.
Wartości w polu enum | |
---|---|
BULLET_ALIGNMENT_UNSPECIFIED |
Wyrównanie listy wypunktowanej jest nieokreślone. |
START |
Odznaka jest wyrównana do początku miejsca zarezerwowanego na jej wyrenderowanie. Wyrównany do lewej w przypadku tekstu w kierunku z lewej do prawej, a w przeciwnym razie wyrównany do prawej. |
CENTER |
Punkt jest wyrównany do środka przestrzeni przeznaczonej na jego renderowanie. |
END |
Pogrubienie jest wyrównane do końca miejsca przeznaczonego na jego renderowanie. Wyrównany do prawej w przypadku tekstu w kierunku z lewej do prawej, a w przeciwnym razie wyrównany do lewej. |
GlyphType
Typy znaków użytych w wypunktowaniu, gdy akapity na tym poziomie zagnieżdżenia są uporządkowane.
Wartości w polu enum | |
---|---|
GLYPH_TYPE_UNSPECIFIED |
Typ glifu nie został określony lub nie jest obsługiwany. |
NONE |
Pusty ciąg znaków. |
DECIMAL |
Numer, np. 1 , 2 lub 3 . |
ZERO_DECIMAL |
Numer, w którym pojedyncze cyfry są poprzedzone zerem, np. 01 , 02 lub 03 . Liczby składające się z więcej niż 1 cyfry nie mają przedrostka 0. |
UPPER_ALPHA |
duża litera, np. A , B lub C ; |
ALPHA |
mała litera, np. a , b lub c ; |
UPPER_ROMAN |
Rzymska cyfra w wielkiej literze, np. I , II lub III . |
ROMAN |
Małą rzymską cyfrę, np. i , ii lub iii . |
SuggestedListProperties
Zaproponowana zmiana: ListProperties
.
Zapis JSON |
---|
{ "listProperties": { object ( |
Pola | |
---|---|
list |
|
list |
Maska wskazująca, które pola w podstawowym |
ListPropertiesSuggestionState
Maska wskazująca, które pola w podstawowym ListProperties
zostały zmienione w tej propozycji. W przypadku każdego pola ustawionego na „Prawda” jest nowa sugerowana wartość.
Zapis JSON |
---|
{
"nestingLevelsSuggestionStates": [
{
object ( |
Pola | |
---|---|
nesting |
Maska wskazująca, które pola w odpowiednim elemencie Stany sugestii poziomu zagnieżchnia są zwracane w kolejności rosnącej według poziomu zagnieżchnia, przy czym najpierw zwracany jest stan najmniej zagnieżdżony. |
NestingLevelSuggestionState
Maska wskazująca, które pola w podstawowym NestingLevel
zostały zmienione w tej propozycji. W przypadku każdego pola ustawionego na „Prawda” jest nowa sugerowana wartość.
Zapis JSON |
---|
{
"bulletAlignmentSuggested": boolean,
"glyphTypeSuggested": boolean,
"glyphFormatSuggested": boolean,
"glyphSymbolSuggested": boolean,
"indentFirstLineSuggested": boolean,
"indentStartSuggested": boolean,
"textStyleSuggestionState": {
object ( |
Pola | |
---|---|
bullet |
Wskazuje, czy zasugerowano zmianę na |
glyph |
Wskazuje, czy zasugerowano zmianę na |
glyph |
Wskazuje, czy zasugerowano zmianę na |
glyph |
Wskazuje, czy zasugerowano zmianę na |
indent |
Wskazuje, czy zasugerowano zmianę na |
indent |
Wskazuje, czy zasugerowano zmianę na |
text |
Maska wskazująca, które pola w elementach |
start |
Wskazuje, czy zasugerowano zmianę na |
NamedRanges
Kolekcja wszystkich NamedRange
w dokumencie, które mają tę samą nazwę.
Zapis JSON |
---|
{
"name": string,
"namedRanges": [
{
object ( |
Pola | |
---|---|
name |
Nazwa, którą mają wszystkie |
named |
|
NamedRange
Kolekcja komórek Range
o tym samym identyfikatorze zakresu nazw.
Zakresy o nazwie umożliwiają deweloperom kojarzenie części dokumentu z dowolną etykietą zdefiniowaną przez użytkownika, dzięki czemu ich zawartość może być odczytywana lub edytowana za pomocą kodu. Dokument może zawierać wiele zakresów nazwanych o tej samej nazwie, ale każdy z nich ma unikalny identyfikator.
Zakres nazwany jest tworzony za pomocą pojedynczego znaku Range
, a treści wstawiane w zakresie nazwanym zwykle go poszerzają. Jednak niektóre zmiany w dokumencie mogą spowodować podział zakresu na kilka zakresów.
Zakresy nazwane nie są prywatne. Wszystkie aplikacje i współpracownicy, którzy mają dostęp do dokumentu, mogą wyświetlać jego zakresy nazwane.
Zapis JSON |
---|
{
"namedRangeId": string,
"name": string,
"ranges": [
{
object ( |
Pola | |
---|---|
named |
Identyfikator zakresu nazwanego. |
name |
Nazwa zakresu nazwanego. |
ranges[] |
Zakresy należące do tego zakresu nazwanego. |
Zakres
Określa ciągły zakres tekstu.
Zapis JSON |
---|
{ "segmentId": string, "startIndex": integer, "endIndex": integer, "tabId": string } |
Pola | |
---|---|
segment |
Identyfikator nagłówka, stopki lub przypisu, w którym znajduje się ten zakres. Pusty identyfikator segmentu oznacza treść dokumentu. |
start |
Indeks początkowy tego zakresu (liczony od 0) w jednostkach kodu UTF-16. W przypadku wszystkich bieżących zastosowań musisz podać indeks początkowy. To pole jest typu Int32Value, aby uwzględnić przyszłe przypadki użycia z nieograniczonymi zakresami. |
end |
Indeks końcowy tego zakresu (liczony od 0) w jednostkach kodu UTF-16. W przypadku wszystkich bieżących zastosowań musi być podany indeks końcowy. To pole jest typu Int32Value, aby uwzględnić przyszłe przypadki użycia z nieograniczonymi zakresami. |
tab |
Karta zawierająca ten zakres. Jeśli nie zostanie podany, żądanie zostanie zastosowane do pierwszej karty. W dokumencie zawierającym jedną kartę:
W dokumencie zawierającym wiele kart:
|
InlineObject
Obiekt, który pojawia się w tekście. Obiekt w tekście zawiera EmbeddedObject
, np. obraz.
Zapis JSON |
---|
{ "objectId": string, "inlineObjectProperties": { object ( |
Pola | |
---|---|
object |
Identyfikator tego obiektu wbudowanego. Można go używać do aktualizowania właściwości obiektu. |
inline |
Właściwości tego obiektu wstawionego w tekst. |
suggested |
Sugerowane zmiany właściwości obiektów w tle, posortowane według identyfikatora sugestii. |
suggested |
Sugerowany identyfikator wstawienia. Jeśli jest puste, nie jest to sugerowane wstawienie. |
suggested |
Identyfikatory sugerowanych do usunięcia. Jeśli jest puste, nie ma żadnych sugerowanych usunięcia tych treści. |
InlineObjectProperties
Właściwości InlineObject
.
Zapis JSON |
---|
{
"embeddedObject": {
object ( |
Pola | |
---|---|
embedded |
Umieszczenie obiektu w ramach tego obiektu wstawianego w tekście. |
EmbeddedObject
Obiekt umieszczony w dokumencie.
Zapis JSON |
---|
{ "title": string, "description": string, "embeddedObjectBorder": { object ( |
Pola | |
---|---|
title |
Tytuł obiektu wstawionego. Atrybuty |
description |
Opis obiektu wbudowanego. Atrybuty |
embedded |
Obwód umieszczonego obiektu. |
size |
Widoczny rozmiar obrazu po przycięciu. |
margin |
Górny margines osadzonego obiektu. |
margin |
Dolna krawędź umieszczonego obiektu. |
margin |
Prawy margines osadzonego obiektu. |
margin |
Lewy margines osadzonego obiektu. |
linked |
Odniesienie do treści źródłowych ze źródła zewnętrznego, do którego istnieje link. Na przykład zawiera on odniesienie do źródłowego wykresu w Arkuszach Google, gdy wbudowany obiekt jest połączonym wykresem. Jeśli nie jest ustawiony, umieszczony obiekt nie jest połączony. |
Pole unii properties . Właściwości specyficzne dla każdego typu obiektu wbudowanego. properties może być tylko jednym z tych elementów: |
|
embedded |
Właściwości rysunku umieszczonego. |
image |
Właściwości obrazu. |
EmbeddedDrawingProperties
Ten typ nie ma pól.
Właściwości osadzonego rysunku, które służą do rozróżniania typu obiektu. Umieszczony rysunek to rysunek utworzony i edytowany w dokumencie. Pamiętaj, że obszerne szczegóły nie są obsługiwane.
ImageProperties
Właściwości obrazu.
Zapis JSON |
---|
{
"contentUri": string,
"sourceUri": string,
"brightness": number,
"contrast": number,
"transparency": number,
"cropProperties": {
object ( |
Pola | |
---|---|
content |
Identyfikator URI obrazu z domyślnym czasem trwania 30 minut. Ten identyfikator URI jest oznaczony tagiem konta osoby składającej prośbę. Każdy, kto ma identyfikator URI, uzyskuje dostęp do obrazu jako pierwotny żądający. Jeśli ustawienia udostępniania dokumentu ulegną zmianie, możesz utracić dostęp do obrazu. |
source |
Identyfikator URI źródła to identyfikator URI użyty do wstawienia obrazu. Identyfikator URI źródła może być pusty. |
brightness |
Efekt jasności obrazu. Wartość powinna mieścić się w zakresie [-1,0, 1,0], gdzie 0 oznacza brak efektu. |
contrast |
Efekt kontrastu obrazu. Wartość powinna mieścić się w zakresie [-1,0, 1,0], gdzie 0 oznacza brak efektu. |
transparency |
Efekt przezroczystości obrazu. Wartość powinna mieścić się w zakresie [0,0, 1,0], gdzie 0 oznacza brak efektu, a 1 – przezroczystość. |
crop |
Właściwości kadrowania obrazu. |
angle |
Kąt obrotu obrazu w prawo w radianach. |
CropProperties
Właściwości przycięcia obrazu.
Prostokąt przycięcia jest reprezentowany za pomocą odstępów ułamkowych od 4 krawędzi oryginalnej treści.
- Jeśli przesunięcie mieści się w przedziale (0, 1), odpowiednia krawędź prostokąta przycinania znajduje się wewnątrz pierwotnego prostokąta ograniczającego obraz.
- Jeśli przesunięcie jest ujemne lub większe niż 1, odpowiednia krawędź prostokąta przycinania znajduje się poza pierwotnym prostokątem ograniczającym obrazu.
- Jeśli wszystkie przesunięcia i kąt obrotu mają wartość 0, obraz nie jest przycinany.
Zapis JSON |
---|
{ "offsetLeft": number, "offsetRight": number, "offsetTop": number, "offsetBottom": number, "angle": number } |
Pola | |
---|---|
offset |
Odsunięcie określa, jak daleko od lewej krawędzi oryginalnych treści znajduje się lewa krawędź prostokąta przycinania (jako ułamek szerokości oryginalnych treści). |
offset |
Odsunięcie określa, jak daleko od prawej krawędzi oryginalnych treści znajduje się prawa krawędź prostokąta przycinania. Odsunięcie jest wyrażone jako ułamek szerokości oryginalnych treści. |
offset |
Odsunięcie określa, jak daleko od górnej krawędzi oryginalnej treści znajduje się górna krawędź prostokąta przycinania, wyrażone jako ułamek wysokości oryginalnej treści. |
offset |
Odsunięcie określa, jak daleko od dolnej krawędzi oryginalnej treści znajduje się dolna krawędź prostokąta przycinania. Odsunięcie jest wyrażone jako ułamek wysokości oryginalnej treści. |
angle |
Kąt obrotu prostokąta przycięcia wokół jego środka w radianach. Obrót jest stosowany po przesunięciu. |
EmbeddedObjectBorder
Obramowanie wokół EmbeddedObject
.
Zapis JSON |
---|
{ "color": { object ( |
Pola | |
---|---|
color |
Kolor obramowania. |
width |
Szerokość obramowania. |
dash |
Styl kresek obramowania. |
property |
Stan właściwości obramowania. |
PropertyState
Możliwe stany obiektu.
Wartości w polu enum | |
---|---|
RENDERED |
Jeśli stan właściwości to RENDERED, element ma tę właściwość po wyrenderowaniu w dokumencie. Jest to wartość domyślna. |
NOT_RENDERED |
Jeśli stan właściwości to NOT_RENDERED, element nie ma odpowiedniej właściwości po wyrenderowaniu w dokumencie. |
LinkedContentReference
Odniesienie do treści źródłowych ze źródła zewnętrznego, do którego istnieje link.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole unii reference . Odniesienie do typu treści, do których odwołuje się link. reference może być tylko jednym z tych elementów: |
|
sheets |
Odwołuje się do połączonego wykresu. |
SheetsChartReference
Odwołanie do połączonego wykresu z Arkuszy Google.
Zapis JSON |
---|
{ "spreadsheetId": string, "chartId": integer } |
Pola | |
---|---|
spreadsheet |
Identyfikator arkusza kalkulacyjnego w Google Sheets zawierającego wykres źródłowy. |
chart |
Identyfikator konkretnego wykresu w osadzonym arkuszu kalkulacyjnym Arkuszy Google. |
SuggestedInlineObjectProperties
Zaproponowana zmiana: InlineObjectProperties
.
Zapis JSON |
---|
{ "inlineObjectProperties": { object ( |
Pola | |
---|---|
inline |
|
inline |
Maska wskazująca, które pola w podstawowym |
InlineObjectPropertiesSuggestionState
Maska wskazująca, które pola w podstawowym InlineObjectProperties
zostały zmienione w tej propozycji. W przypadku każdego pola ustawionego na „Prawda” jest nowa sugerowana wartość.
Zapis JSON |
---|
{
"embeddedObjectSuggestionState": {
object ( |
Pola | |
---|---|
embedded |
Maska wskazująca, które pola w elementach |
EmbeddedObjectSuggestionState
Maska wskazująca, które pola w podstawowym EmbeddedObject
zostały zmienione w tej propozycji. W przypadku każdego pola ustawionego na „Prawda” jest nowa sugerowana wartość.
Zapis JSON |
---|
{ "embeddedDrawingPropertiesSuggestionState": { object ( |
Pola | |
---|---|
embedded |
Maska wskazująca, które pola w elementach |
image |
Maska wskazująca, które pola w elementach |
title |
Wskazuje, czy zasugerowano zmianę na |
description |
Wskazuje, czy zasugerowano zmianę na |
embedded |
Maska wskazująca, które pola w elementach |
size |
Maska wskazująca, które pola w elementach |
margin |
Wskazuje, czy zasugerowano zmianę na |
margin |
Wskazuje, czy zasugerowano zmianę na |
margin |
Wskazuje, czy zasugerowano zmianę na |
margin |
Wskazuje, czy zasugerowano zmianę na |
linked |
Maska wskazująca, które pola w elementach |
EmbeddedDrawingPropertiesSuggestionState
Ten typ nie ma pól.
Maska wskazująca, które pola w podstawowym EmbeddedDrawingProperties
zostały zmienione w tej propozycji. W przypadku każdego pola ustawionego na „Prawda” jest nowa sugerowana wartość.
ImagePropertiesSuggestionState
Maska wskazująca, które pola w podstawowym ImageProperties
zostały zmienione w tej propozycji. W przypadku każdego pola ustawionego na „Prawda” jest nowa sugerowana wartość.
Zapis JSON |
---|
{
"contentUriSuggested": boolean,
"sourceUriSuggested": boolean,
"brightnessSuggested": boolean,
"contrastSuggested": boolean,
"transparencySuggested": boolean,
"cropPropertiesSuggestionState": {
object ( |
Pola | |
---|---|
content |
Wskazuje, czy zasugerowano zmianę na |
source |
Wskazuje, czy zasugerowano zmianę w [sourceUri] [google.apps.docs.v1.EmbeddedObject.source_uri]. |
brightness |
Wskazuje, czy zasugerowano zmianę wartości atrybutu [brightness] [google.apps.docs.v1.EmbeddedObject.brightness]. |
contrast |
Wskazuje, czy zasugerowano zmianę w [contrast] [google.apps.docs.v1.EmbeddedObject.contrast]. |
transparency |
Wskazuje, czy zasugerowano zmianę w polu [transparency] [google.apps.docs.v1.EmbeddedObject.transparency]. |
crop |
Maska wskazująca, które pola w elementach |
angle |
Wskazuje, czy zasugerowano zmianę w elementach [angle] [google.apps.docs.v1.EmbeddedObject.angle]. |
CropPropertiesSuggestionState
Maska wskazująca, które pola w podstawowym CropProperties
zostały zmienione w tej propozycji. W przypadku każdego pola ustawionego na „Prawda” jest nowa sugerowana wartość.
Zapis JSON |
---|
{ "offsetLeftSuggested": boolean, "offsetRightSuggested": boolean, "offsetTopSuggested": boolean, "offsetBottomSuggested": boolean, "angleSuggested": boolean } |
Pola | |
---|---|
offset |
Wskazuje, czy zasugerowano zmianę na |
offset |
Wskazuje, czy zasugerowano zmianę na |
offset |
Wskazuje, czy zasugerowano zmianę na |
offset |
Wskazuje, czy zasugerowano zmianę na |
angle |
Wskazuje, czy zasugerowano zmianę na |
EmbeddedObjectBorderSuggestionState
Maska wskazująca, które pola w podstawowym EmbeddedObjectBorder
zostały zmienione w tej propozycji. W przypadku każdego pola ustawionego na „Prawda” jest nowa sugerowana wartość.
Zapis JSON |
---|
{ "colorSuggested": boolean, "widthSuggested": boolean, "dashStyleSuggested": boolean, "propertyStateSuggested": boolean } |
Pola | |
---|---|
color |
Wskazuje, czy zasugerowano zmianę atrybutu [color] w obiekcie [google.apps.docs.v1.EmbeddedBorderObject.color]. |
width |
Wskazuje, czy zasugerowano zmianę atrybutu [width] w obiekcie osadzonej ramki ([google.apps.docs.v1.EmbeddedBorderObject.width]). |
dash |
Wskazuje, czy zasugerowano zmianę atrybutu [dashStyle] w obiekcie [google.apps.docs.v1.EmbeddedBorderObject.dash_style]. |
property |
Wskazuje, czy zasugerowano zmianę wartości atrybutu [propertyState] w obiekcie [google.apps.docs.v1.EmbeddedBorderObject.property_state]. |
LinkedContentReferenceSuggestionState
Maska wskazująca, które pola w podstawowym LinkedContentReference
zostały zmienione w tej propozycji. W przypadku każdego pola ustawionego na „Prawda” jest nowa sugerowana wartość.
Zapis JSON |
---|
{
"sheetsChartReferenceSuggestionState": {
object ( |
Pola | |
---|---|
sheets |
Maska wskazująca, które pola w elementach |
SheetsChartReferenceSuggestionState
Maska wskazująca, które pola w podstawowym SheetsChartReference
zostały zmienione w tej propozycji. W przypadku każdego pola ustawionego na „Prawda” jest nowa sugerowana wartość.
Zapis JSON |
---|
{ "spreadsheetIdSuggested": boolean, "chartIdSuggested": boolean } |
Pola | |
---|---|
spreadsheet |
Wskazuje, czy zasugerowano zmianę na |
chart |
Wskazuje, czy zasugerowano zmianę na |
PositionedObject
Obiekt przywiązany do Paragraph
i umieszczony względem początku akapitu. Obiekt PositionedObject zawiera EmbeddedObject
, np. obraz.
Zapis JSON |
---|
{ "objectId": string, "positionedObjectProperties": { object ( |
Pola | |
---|---|
object |
Identyfikator tego obiektu. |
positioned |
Właściwości tego obiektu. |
suggested |
Sugerowane zmiany właściwości obiektów umieszczonych, z kluczem identyfikatora sugestii. |
suggested |
Sugerowany identyfikator wstawienia. Jeśli jest puste, nie jest to sugerowane wstawienie. |
suggested |
Identyfikatory sugerowanych do usunięcia. Jeśli jest puste, nie ma żadnych sugerowanych usunięcia tych treści. |
PositionedObjectProperties
Właściwości PositionedObject
.
Zapis JSON |
---|
{ "positioning": { object ( |
Pola | |
---|---|
positioning |
Pozycjonowanie tego obiektu względem znaku nowej linii w elemencie |
embedded |
Umieszczony obiekt tego obiektu. |
PositionedObjectPositioning
Położenie PositionedObject
. Obiekt jest umieszczany względem początku Paragraph
, do którego jest przywiązany.
Zapis JSON |
---|
{ "layout": enum ( |
Pola | |
---|---|
layout |
Układ tego umieszczonego obiektu. |
left |
Przesunięcie lewej krawędzi umieszczonego obiektu względem początku |
top |
Przesunięcie górnej krawędzi obiektu względem początku |
PositionedObjectLayout
Możliwe układy obiektu [PositionedObject][google.aps.docs.v1.PositionedObject].
Wartości w polu enum | |
---|---|
POSITIONED_OBJECT_LAYOUT_UNSPECIFIED |
układ nie został określony; |
WRAP_TEXT |
Tekst jest przenoszony na pozycjonowany obiekt. |
BREAK_LEFT |
Przerywa tekst tak, aby umieszczony obiekt znajdował się po lewej stronie, a tekst – po prawej. |
BREAK_RIGHT |
Przerywa tekst tak, aby umieszczony obiekt znajdował się po prawej stronie, a tekst – po lewej. |
BREAK_LEFT_RIGHT |
Przerywa tekst tak, aby po lewej lub prawej stronie obiektu nie było tekstu. |
IN_FRONT_OF_TEXT |
Obiekt jest umieszczony przed tekstem. |
BEHIND_TEXT |
Obiekt jest umieszczony za tekstem. |
SuggestedPositionedObjectProperties
Zaproponowana zmiana: PositionedObjectProperties
.
Zapis JSON |
---|
{ "positionedObjectProperties": { object ( |
Pola | |
---|---|
positioned |
|
positioned |
Maska wskazująca, które pola w podstawowym |
PositionedObjectPropertiesSuggestionState
Maska wskazująca, które pola w podstawowym PositionedObjectProperties
zostały zmienione w tej propozycji. W przypadku każdego pola ustawionego na „Prawda” jest nowa sugerowana wartość.
Zapis JSON |
---|
{ "positioningSuggestionState": { object ( |
Pola | |
---|---|
positioning |
Maska wskazująca, które pola w elementach |
embedded |
Maska wskazująca, które pola w elementach |
PositionedObjectPositioningSuggestionState
Maska wskazująca, które pola w podstawowym PositionedObjectPositioning
zostały zmienione w tej propozycji. W przypadku każdego pola ustawionego na „Prawda” jest nowa sugerowana wartość.
Zapis JSON |
---|
{ "layoutSuggested": boolean, "leftOffsetSuggested": boolean, "topOffsetSuggested": boolean } |
Pola | |
---|---|
layout |
Wskazuje, czy zasugerowano zmianę na |
left |
Wskazuje, czy zasugerowano zmianę na |
top |
Wskazuje, czy zasugerowano zmianę na |
SuggestionsViewMode
Tryb wyświetlania sugestii zastosowany w dokumencie, który wskazuje, jak sugerowane zmiany są reprezentowane. Zawiera opcje czytania dokumentu ze wszystkimi sugestiami w tekście, zaakceptowanymi lub odrzuconymi.
Wartości w polu enum | |
---|---|
DEFAULT_FOR_CURRENT_ACCESS |
Tryb wyświetlania sugestii zastosowany do zwróconego dokumentu zależy od bieżącego poziomu dostępu użytkownika. Jeśli użytkownik ma tylko dostęp do wyświetlania, zostanie zastosowany parametr PREVIEW_WITHOUT_SUGGESTIONS . W przeciwnym razie zostanie zastosowany element SUGGESTIONS_INLINE . Jest to domyślny tryb wyświetlania sugestii. |
SUGGESTIONS_INLINE |
Zwrócony dokument zawiera sugestie w tekście. Sugerowane zmiany będą odróżnione od podstawowej zawartości w dokumencie. Jeśli użytkownik nie ma uprawnień do wyświetlania sugerowanych zmian, żądania pobierania dokumentu w tym trybie zwrócą błąd 403. |
PREVIEW_SUGGESTIONS_ACCEPTED |
Zwrócony dokument jest podglądem z zaakceptowanymi wszystkimi sugerowanymi zmianami. Jeśli użytkownik nie ma uprawnień do wyświetlania sugerowanych zmian, żądania pobierania dokumentu w tym trybie zwrócą błąd 403. |
PREVIEW_WITHOUT_SUGGESTIONS |
Zwrócony dokument jest podglądem z odrzuconymi sugestiami (jeśli takie istnieją). |
Metody |
|
---|---|
|
Wprowadza co najmniej 1 zmianę w dokumencie. |
|
Tworzy pusty dokument z tytułem podanym w żądaniu. |
|
Pobiera najnowszą wersję określonego dokumentu. |