REST Resource: documents

Zasób: dokument

dokument w Dokumentach Google,

Zapis JSON
{
  "documentId": string,
  "title": string,
  "tabs": [
    {
      object (Tab)
    }
  ],
  "revisionId": string,
  "suggestionsViewMode": enum (SuggestionsViewMode),
  "body": {
    object (Body)
  },
  "headers": {
    string: {
      object (Header)
    },
    ...
  },
  "footers": {
    string: {
      object (Footer)
    },
    ...
  },
  "footnotes": {
    string: {
      object (Footnote)
    },
    ...
  },
  "documentStyle": {
    object (DocumentStyle)
  },
  "suggestedDocumentStyleChanges": {
    string: {
      object (SuggestedDocumentStyle)
    },
    ...
  },
  "namedStyles": {
    object (NamedStyles)
  },
  "suggestedNamedStylesChanges": {
    string: {
      object (SuggestedNamedStyles)
    },
    ...
  },
  "lists": {
    string: {
      object (List)
    },
    ...
  },
  "namedRanges": {
    string: {
      object (NamedRanges)
    },
    ...
  },
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}
Pola
documentId

string

Tylko dane wyjściowe. Identyfikator dokumentu.

title

string

Tytuł dokumentu.

tabs[]

object (Tab)

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 Tab.childTabs.

revisionId

string

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.

suggestionsViewMode

enum (SuggestionsViewMode)

Tylko dane wyjściowe. Tryb wyświetlania sugestii zastosowany w dokumencie.

Uwaga: podczas edytowania dokumentu zmiany muszą być oparte na dokumencie z wartością SUGGESTIONS_INLINE.

body

object (Body)

Tylko dane wyjściowe. Główna część dokumentu.

Pole starsze: zamiast tego użyj pola Document.tabs.documentTab.body, które wyświetla rzeczywiste treści dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli false lub nie jest ustawione, to pole zawiera informacje o pierwszej karcie w dokumencie.

headers

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

Tylko dane wyjściowe. Nagłówki w dokumencie, posortowane według identyfikatora nagłówka.

Pole starsze: zamiast tego użyj pola Document.tabs.documentTab.headers, które wyświetla rzeczywiste treści dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli false lub nie jest ustawione, to pole zawiera informacje o pierwszej karcie w dokumencie.

footers

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

Tylko dane wyjściowe. stopki w dokumencie, posortowane według identyfikatora stopki;

Pole starsze: zamiast tego użyj pola Document.tabs.documentTab.footers, które wyświetla rzeczywiste treści dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli false lub nie jest ustawione, to pole zawiera informacje o pierwszej karcie w dokumencie.

footnotes

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

Tylko dane wyjściowe. przypisy w dokumencie, posortowane według identyfikatora przypisu;

Pole starsze: zamiast tego użyj pola Document.tabs.documentTab.footnotes, które wyświetla rzeczywiste treści dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli false lub nie jest ustawione, to pole zawiera informacje o pierwszej karcie w dokumencie.

documentStyle

object (DocumentStyle)

Tylko dane wyjściowe. Styl dokumentu.

Pole starsze: zamiast tego użyj pola Document.tabs.documentTab.documentStyle, które wyświetla rzeczywiste treści dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli false lub nie jest ustawione, to pole zawiera informacje o pierwszej karcie w dokumencie.

suggestedDocumentStyleChanges

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

Tylko dane wyjściowe. Sugerowane zmiany stylu dokumentu, posortowane według identyfikatora sugestii.

Pole starsze: zamiast tego użyj pola Document.tabs.documentTab.suggestedDocumentStyleChanges, które wyświetla rzeczywiste treści dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli false lub nie jest ustawione, to pole zawiera informacje o pierwszej karcie w dokumencie.

namedStyles

object (NamedStyles)

Tylko dane wyjściowe. Nazwane style dokumentu.

Pole starsze: zamiast tego użyj pola Document.tabs.documentTab.namedStyles, które wyświetla rzeczywiste treści dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli false lub nie jest ustawione, to pole zawiera informacje o pierwszej karcie w dokumencie.

suggestedNamedStylesChanges

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

Tylko dane wyjściowe. Sugerowane zmiany nazwanych stylów dokumentu, posortowane według identyfikatora sugestii.

Pole starsze: zamiast tego użyj pola Document.tabs.documentTab.suggestedNamedStylesChanges, które wyświetla rzeczywiste treści dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli false lub nie jest ustawione, to pole zawiera informacje o pierwszej karcie w dokumencie.

lists

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

Tylko dane wyjściowe. Listy w dokumencie, posortowane według identyfikatora listy.

Pole starsze: zamiast tego użyj pola Document.tabs.documentTab.lists, które wyświetla rzeczywiste treści dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli false lub nie jest ustawione, to pole zawiera informacje o pierwszej karcie w dokumencie.

namedRanges

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

Tylko dane wyjściowe. Nazwane zakresy w dokumencie, posortowane według nazwy.

Pole starsze: zamiast tego użyj pola Document.tabs.documentTab.namedRanges, które wyświetla rzeczywiste treści dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli false lub nie jest ustawione, to pole zawiera informacje o pierwszej karcie w dokumencie.

inlineObjects

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

Tylko dane wyjściowe. Obiekty w dokumencie, których kluczem jest identyfikator obiektu.

Pole starsze: zamiast tego użyj pola Document.tabs.documentTab.inlineObjects, które wyświetla rzeczywiste treści dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli false lub nie jest ustawione, to pole zawiera informacje o pierwszej karcie w dokumencie.

positionedObjects

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

Tylko dane wyjściowe. Obiekty umieszczone w dokumencie, posortowane według identyfikatora obiektu.

Pole starsze: zamiast tego użyj pola Document.tabs.documentTab.positionedObjects, które wyświetla rzeczywiste treści dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli false lub nie jest ustawione, to pole zawiera informacje o pierwszej karcie w dokumencie.

Tab

Karta w dokumencie.

Zapis JSON
{
  "tabProperties": {
    object (TabProperties)
  },
  "childTabs": [
    {
      object (Tab)
    }
  ],

  // Union field content can be only one of the following:
  "documentTab": {
    object (DocumentTab)
  }
  // End of list of possible types for union field content.
}
Pola
tabProperties

object (TabProperties)

Właściwości karty, takie jak identyfikator i tytuł.

childTabs[]

object (Tab)

Karty podrzędne umieszczone na tej karcie.

Pole unii content. Treść karty. content może być tylko jednym z tych elementów:
documentTab

object (DocumentTab)

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
tabId

string

Tylko dane wyjściowe. Identyfikator karty. Tego pola nie można zmienić.

title

string

Nazwa karty widoczna dla użytkownika.

parentTabId

string

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

integer

Indeks karty w grupie zaczynający się od 0.

nestingLevel

integer

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 (Body)
  },
  "headers": {
    string: {
      object (Header)
    },
    ...
  },
  "footers": {
    string: {
      object (Footer)
    },
    ...
  },
  "footnotes": {
    string: {
      object (Footnote)
    },
    ...
  },
  "documentStyle": {
    object (DocumentStyle)
  },
  "suggestedDocumentStyleChanges": {
    string: {
      object (SuggestedDocumentStyle)
    },
    ...
  },
  "namedStyles": {
    object (NamedStyles)
  },
  "suggestedNamedStylesChanges": {
    string: {
      object (SuggestedNamedStyles)
    },
    ...
  },
  "lists": {
    string: {
      object (List)
    },
    ...
  },
  "namedRanges": {
    string: {
      object (NamedRanges)
    },
    ...
  },
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}
Pola
body

object (Body)

Główna część karty dokumentu.

headers

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

Nagłówki na karcie dokumentu, posortowane według identyfikatora nagłówka.

footers

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

Stopki na karcie dokumentu, posortowane według identyfikatora stopki.

footnotes

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

przypisy na karcie dokumentu, posortowane według identyfikatora przypisu;

documentStyle

object (DocumentStyle)

Styl karty dokumentu.

suggestedDocumentStyleChanges

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

Proponowane zmiany stylu karty dokumentu, posortowane według identyfikatora sugestii.

namedStyles

object (NamedStyles)

Nazwane style karty dokumentu.

suggestedNamedStylesChanges

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

Proponowane zmiany nazwanych stylów na karcie dokumentu, posortowane według identyfikatora sugestii.

lists

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

listy na karcie dokumentu, posortowane według identyfikatora listy;

namedRanges

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

Zakresy nazwane na karcie dokumentu, posortowane według nazwy.

inlineObjects

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

Obiekty w dokumencie na karcie, posortowane według identyfikatora obiektu.

positionedObjects

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

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 (StructuralElement)
    }
  ]
}
Pola
content[]

object (StructuralElement)

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 content can be only one of the following:
  "paragraph": {
    object (Paragraph)
  },
  "sectionBreak": {
    object (SectionBreak)
  },
  "table": {
    object (Table)
  },
  "tableOfContents": {
    object (TableOfContents)
  }
  // End of list of possible types for union field content.
}
Pola
startIndex

integer

Indeks początkowy tego elementu strukturalnego (liczony od 0) w jednostkach kodu UTF-16.

endIndex

integer

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

object (Paragraph)

Element strukturalny typu akapit.

sectionBreak

object (SectionBreak)

Element strukturalny typu podział na sekcje.

table

object (Table)

Typ tabeli jako element strukturalny.

tableOfContents

object (TableOfContents)

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 (ParagraphElement)
    }
  ],
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "suggestedParagraphStyleChanges": {
    string: {
      object (SuggestedParagraphStyle)
    },
    ...
  },
  "bullet": {
    object (Bullet)
  },
  "suggestedBulletChanges": {
    string: {
      object (SuggestedBullet)
    },
    ...
  },
  "positionedObjectIds": [
    string
  ],
  "suggestedPositionedObjectIds": {
    string: {
      object (ObjectReferences)
    },
    ...
  }
}
Pola
elements[]

object (ParagraphElement)

Treść akapitu podzielona na części składowe.

paragraphStyle

object (ParagraphStyle)

Styl tego akapitu.

suggestedParagraphStyleChanges

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

Styl sugerowanego akapitu zmienia się na ten akapit, którego identyfikator jest podany w kluczu.

bullet

object (Bullet)

Punkt w tym akapicie. Jeśli nie ma go na liście, akapit nie należy do listy.

suggestedBulletChanges

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

Sugerowane zmiany w punkcie w tym akapicie.

positionedObjectIds[]

string

Identyfikatory obiektów powiązanych z tym akapitem.

suggestedPositionedObjectIds

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

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 content can be only one of the following:
  "textRun": {
    object (TextRun)
  },
  "autoText": {
    object (AutoText)
  },
  "pageBreak": {
    object (PageBreak)
  },
  "columnBreak": {
    object (ColumnBreak)
  },
  "footnoteReference": {
    object (FootnoteReference)
  },
  "horizontalRule": {
    object (HorizontalRule)
  },
  "equation": {
    object (Equation)
  },
  "inlineObjectElement": {
    object (InlineObjectElement)
  },
  "person": {
    object (Person)
  },
  "richLink": {
    object (RichLink)
  }
  // End of list of possible types for union field content.
}
Pola
startIndex

integer

Indeks początkowy tego elementu akapitu (liczony od zera) w jednostkach kodu UTF-16.

endIndex

integer

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

object (TextRun)

Element akapitu tekstu.

autoText

object (AutoText)

Element akapitu z tekstem automatycznym.

pageBreak

object (PageBreak)

Element akapitu z podziałem strony.

columnBreak

object (ColumnBreak)

Element akapitu z podziałem na kolumny.

footnoteReference

object (FootnoteReference)

Element akapitu odwołania do przypisu.

horizontalRule

object (HorizontalRule)

Element akapitu z poziomą linią.

equation

object (Equation)

Element akapitu równania.

inlineObjectElement

object (InlineObjectElement)

Wbudowany element akapitu obiektu.

person

object (Person)

Element akapitu, który zawiera link do osoby lub adresu e-mail.

TextRun

ParagraphElement, który reprezentuje ciąg tekstu o tym samym stylu.

Zapis JSON
{
  "content": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Pola
content

string

Tekst tego przebiegu.

Wszystkie elementy inne niż tekstowe w sesji są zastępowane znakiem Unicode U+E907.

suggestedInsertionIds[]

string

Sugerowane identyfikatory wstawień. Jeśli TextRun jest zagnieżdżoną sugerowaną zmianą, może mieć wiele identyfikatorów wstawienia. Jeśli jest puste, nie jest to sugerowane wstawienie.

suggestedDeletionIds[]

string

Identyfikatory sugerowanych do usunięcia. Jeśli jest puste, nie ma żadnych sugerowanych usunięcia tych treści.

textStyle

object (TextStyle)

Styl tekstu tego przebiegu.

suggestedTextStyleChanges

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

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ów named style type w akapitach.
  • Styl tekstu w elementach named style dziedziczy styl o nazwie normal 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 (OptionalColor)
  },
  "foregroundColor": {
    object (OptionalColor)
  },
  "fontSize": {
    object (Dimension)
  },
  "weightedFontFamily": {
    object (WeightedFontFamily)
  },
  "baselineOffset": enum (BaselineOffset),
  "link": {
    object (Link)
  }
}
Pola
bold

boolean

Określa, czy tekst ma być wyświetlany pogrubioną czcionką.

italic

boolean

Określa, czy tekst jest kursywą.

underline

boolean

Określa, czy tekst jest podkreślony.

strikethrough

boolean

Określa, czy tekst jest przekreślony.

smallCaps

boolean

czy tekst jest zapisany małymi literami.

backgroundColor

object (OptionalColor)

Kolor tła tekstu. Jeśli jest ustawiony, kolor jest kolorem RGB lub przezroczysty, w zależności od pola color.

foregroundColor

object (OptionalColor)

Kolor pierwszego planu tekstu. Jeśli jest ustawiony, kolor jest kolorem RGB lub przezroczysty, w zależności od pola color.

fontSize

object (Dimension)

Rozmiar czcionki tekstu.

weightedFontFamily

object (WeightedFontFamily)

Rodzina czcionek i renderowana grubość tekstu.

Jeśli żądanie aktualizacji zawiera wartości zarówno dla parametru weightedFontFamily, jak i bold, najpierw zostanie zastosowany parametr weightedFontFamily, a potem bold.

Jeśli parametr weightedFontFamily#weight nie jest ustawiony, przyjmuje domyślną wartość 400.

Jeśli parametr weightedFontFamily jest ustawiony, parametr weightedFontFamily#fontFamily musi też mieć ustawioną niepustą wartość. W przeciwnym razie zwracany jest błąd 400 „Błędne żądanie”.

baselineOffset

enum (BaselineOffset)

Pionowe przesunięcie tekstu od jego normalnej pozycji.

Tekst z odstępami od linii bazowej SUPERSCRIPT lub SUBSCRIPT jest automatycznie renderowany w mniejszym rozmiarze czcionki obliczanym na podstawie pola fontSize. Zmiany w tym polu nie mają wpływu na fontSize.

OptionalColor

Kolor, który może być całkowicie nieprzejrzysty lub całkowicie przezroczysty.

Zapis JSON
{
  "color": {
    object (Color)
  }
}
Pola
color

object (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 (RgbColor)
  }
}
Pola
rgbColor

object (RgbColor)

Wartość koloru RGB.

RgbColor

Kolor RGB.

Zapis JSON
{
  "red": number,
  "green": number,
  "blue": number
}
Pola
red

number

Składowa czerwona koloru, od 0,0 do 1,0.

green

number

Składowa zielona koloru, od 0,0 do 1,0.

blue

number

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 (Unit)
}
Pola
magnitude

number

Wielkość.

unit

enum (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
fontFamily

string

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

weight

integer

Grubość czcionki. To pole może zawierać dowolną wartość będącą wielokrotnością 100 w zakresie od 100 do 900 (obustronnie domkniętym). Ten zakres odpowiada wartościom liczbowym opisanym w specyfikacji CSS 2.1 (sekcja 15.6), przy czym wartości niebędące liczbami są niedozwolone.

Wartością domyślną jest 400 („normalny”).

Grubość czcionki stanowi tylko jeden składnik renderowanej grubości czcionki. Połączenie wartości weight i rozwiązanej wartości bold stylu tekstu określa renderowaną wagę po uwzględnieniu dziedziczenia:

  • Jeśli tekst jest pogrubiony, a grubość jest mniejsza niż 400, renderowana grubość wynosi 400.
  • Jeśli tekst jest pogrubiony, a waga jest większa lub równa 400, ale mniejsza niż 700, renderowana waga jest równa 700.
  • Jeśli waga jest większa lub równa 700, wyrenderowana waga jest równa wadze.
  • Jeśli tekst nie jest pogrubiony, renderowana grubość jest równa gruboś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).

SuggestedTextStyle

sugerowana zmiana w elemencie TextStyle;

Zapis JSON
{
  "textStyle": {
    object (TextStyle)
  },
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  }
}
Pola
textStyle

object (TextStyle)

TextStyle, który zawiera tylko zmiany wprowadzone w tej propozycji. Możesz go używać razem z przyciskiem textStyleSuggestionState, aby sprawdzić, które pola się zmieniły i jakie mają teraz wartości.

textStyleSuggestionState

object (TextStyleSuggestionState)

Maska wskazująca, które pola w podstawowym TextStyle zostały zmienione w tej propozycji.

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
boldSuggested

boolean

Wskazuje, czy zasugerowano zmianę na bold.

italicSuggested

boolean

Wskazuje, czy zasugerowano zmianę na italic.

underlineSuggested

boolean

Wskazuje, czy zasugerowano zmianę na underline.

strikethroughSuggested

boolean

Wskazuje, czy zasugerowano zmianę na strikethrough.

smallCapsSuggested

boolean

Wskazuje, czy zasugerowano zmianę na smallCaps.

backgroundColorSuggested

boolean

Wskazuje, czy zasugerowano zmianę na backgroundColor.

foregroundColorSuggested

boolean

Wskazuje, czy zasugerowano zmianę na foregroundColor.

fontSizeSuggested

boolean

Wskazuje, czy zasugerowano zmianę na fontSize.

weightedFontFamilySuggested

boolean

Wskazuje, czy zasugerowano zmianę na weightedFontFamily.

baselineOffsetSuggested

boolean

Wskazuje, czy zasugerowano zmianę na baselineOffset.

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 (Type),
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Pola
type

enum (Type)

Typ tekstu automatycznego.

suggestedInsertionIds[]

string

Sugerowane identyfikatory wstawień. Jeśli AutoText jest zagnieżdżoną sugerowaną zmianą, może mieć wiele identyfikatorów wstawienia. Jeśli pole jest puste, nie jest to sugerowana wstawka.

suggestedDeletionIds[]

string

Identyfikatory sugerowanych do usunięcia. Jeśli jest puste, nie ma żadnych sugerowanych usunięcia tych treści.

textStyle

object (TextStyle)

Styl tekstu tego tekstu automatycznego.

suggestedTextStyleChanges

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

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 (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Pola
suggestedInsertionIds[]

string

Sugerowane identyfikatory wstawień. Jeśli PageBreak jest zagnieżdżoną sugerowaną zmianą, może mieć wiele identyfikatorów wstawienia. Jeśli pole jest puste, nie jest to sugerowana wstawka.

suggestedDeletionIds[]

string

Identyfikatory sugerowanych do usunięcia. Jeśli jest puste, nie ma żadnych sugerowanych usunięcia tych treści.

textStyle

object (TextStyle)

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.

suggestedTextStyleChanges

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

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 (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Pola
suggestedInsertionIds[]

string

Sugerowane identyfikatory wstawień. Jeśli ColumnBreak jest zagnieżdżoną sugerowaną zmianą, może mieć wiele identyfikatorów wstawienia. Jeśli jest puste, nie jest to sugerowane wstawienie.

suggestedDeletionIds[]

string

Identyfikatory sugerowanych do usunięcia. Jeśli jest puste, nie ma żadnych sugerowanych usunięcia tych treści.

textStyle

object (TextStyle)

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.

suggestedTextStyleChanges

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

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 (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Pola
footnoteId

string

Identyfikator footnote zawierający treść tego odwołania do przypisu.

footnoteNumber

string

Wyrenderowany numer tego przypisu.

suggestedInsertionIds[]

string

Sugerowane identyfikatory wstawień. Jeśli FootnoteReference jest zagnieżdżoną sugerowaną zmianą, może mieć wiele identyfikatorów wstawienia. Jeśli jest puste, nie jest to sugerowane wstawienie.

suggestedDeletionIds[]

string

Identyfikatory sugerowanych do usunięcia treści. Jeśli jest puste, nie ma żadnych sugerowanych usunięcia tych treści.

textStyle

object (TextStyle)

Styl tekstu tego odwołania do przypisu.

suggestedTextStyleChanges

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

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 (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Pola
suggestedInsertionIds[]

string

Sugerowane identyfikatory wstawień. Jeśli HorizontalRule jest zagnieżdżoną sugerowaną zmianą, może mieć wiele identyfikatorów wstawienia. Jeśli jest puste, nie jest to sugerowane wstawienie.

suggestedDeletionIds[]

string

Identyfikatory sugerowanych do usunięcia. Jeśli jest puste, nie ma żadnych sugerowanych usunięcia tych treści.

textStyle

object (TextStyle)

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.

suggestedTextStyleChanges

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

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
suggestedInsertionIds[]

string

Sugerowane identyfikatory wstawień. Jeśli Equation jest zagnieżdżoną sugerowaną zmianą, może mieć wiele identyfikatorów wstawienia. Jeśli jest puste, nie jest to sugerowane wstawienie.

suggestedDeletionIds[]

string

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 (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}
Pola
inlineObjectId

string

Identyfikator InlineObject zawartego w tym elemencie.

suggestedInsertionIds[]

string

Sugerowane identyfikatory wstawień. Jeśli InlineObjectElement jest zagnieżdżoną sugerowaną zmianą, może mieć wiele identyfikatorów wstawienia. Jeśli jest puste, nie jest to sugerowane wstawienie.

suggestedDeletionIds[]

string

Identyfikatory sugerowanych do usunięcia. Jeśli jest puste, nie ma żadnych sugerowanych usunięcia tych treści.

textStyle

object (TextStyle)

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.

suggestedTextStyleChanges

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

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 (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  },
  "personProperties": {
    object (PersonProperties)
  }
}
Pola
personId

string

Tylko dane wyjściowe. Unikalny identyfikator tego połączenia.

suggestedInsertionIds[]

string

Identyfikatory sugestii, które wstawiają w dokumencie link do tej osoby. Element Person może mieć wiele identyfikatorów wstawienia, jeśli jest to zagnieżdżona sugerowana zmiana (np. sugestia w sugestii wprowadzona przez innego użytkownika). Jeśli jest puste, link do tej osoby nie jest sugerowanym wstawieniem.

suggestedDeletionIds[]

string

Identyfikatory sugestii, które usuwają link do tej osoby z dokumentu. Jeśli na przykład Person ma wiele identyfikatorów usunięcia, oznacza to, że sugeruje to usunięcie wielu użytkowników. Jeśli jest puste, nie zalecamy usuwania linku do tej osoby.

textStyle

object (TextStyle)

Styl tekstu w tym Person.

suggestedTextStyleChanges

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

Styl sugerowanego tekstu zmienia się na Person, zgodnie z kluczem identyfikatora sugestii.

personProperties

object (PersonProperties)

Tylko dane wyjściowe. Właściwości tego elementu Person. To pole jest zawsze widoczne.

PersonProperties

Właściwości specyficzne dla połączonego Person.

Zapis JSON
{
  "name": string,
  "email": string
}
Pola
name

string

Tylko dane wyjściowe. imię i nazwisko osoby, jeśli jest wyświetlane w tekście linku zamiast adresu e-mail tej osoby;

email

string

Tylko dane wyjściowe. Adres e-mail powiązany z tym kontem Person. To pole jest zawsze widoczne.

RichLinkProperties

Właściwości specyficzne dla RichLink.

Zapis JSON
{
  "title": string,
  "uri": string,
  "mimeType": string
}
Pola
title

string

Tylko dane wyjściowe. Tytuł RichLink wyświetlany w linku. Tytuł ten jest zgodny z tytułem zasobu, do którego linkuje się zasób, w momencie wstawienia lub ostatniej aktualizacji linku. To pole jest zawsze widoczne.

uri

string

Tylko dane wyjściowe. Identyfikator URI RichLink. Jest zawsze obecny.

mimeType

string

Tylko dane wyjściowe. Typ MIME RichLink, jeśli istnieje (na przykład, gdy jest to plik na Dysku).

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ów named style type.
  • Styl akapitowy w elementach named style dziedziczy styl o nazwie normal 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 (NamedStyleType),
  "alignment": enum (Alignment),
  "lineSpacing": number,
  "direction": enum (ContentDirection),
  "spacingMode": enum (SpacingMode),
  "spaceAbove": {
    object (Dimension)
  },
  "spaceBelow": {
    object (Dimension)
  },
  "borderBetween": {
    object (ParagraphBorder)
  },
  "borderTop": {
    object (ParagraphBorder)
  },
  "borderBottom": {
    object (ParagraphBorder)
  },
  "borderLeft": {
    object (ParagraphBorder)
  },
  "borderRight": {
    object (ParagraphBorder)
  },
  "indentFirstLine": {
    object (Dimension)
  },
  "indentStart": {
    object (Dimension)
  },
  "indentEnd": {
    object (Dimension)
  },
  "tabStops": [
    {
      object (TabStop)
    }
  ],
  "keepLinesTogether": boolean,
  "keepWithNext": boolean,
  "avoidWidowAndOrphan": boolean,
  "shading": {
    object (Shading)
  },
  "pageBreakBefore": boolean
}
Pola
headingId

string

Identyfikator nagłówka akapitu. Jeśli jest pusty, akapit nie jest nagłówkiem.

Ta usługa jest tylko do odczytu.

namedStyleType

enum (NamedStyleType)

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

enum (Alignment)

Wyrównanie tekstu w tym akapicie.

lineSpacing

number

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

enum (ContentDirection)

Kierunek tekstu w tym akapicie. Jeśli nie zostanie ustawiona, wartość domyślna to LEFT_TO_RIGHT, ponieważ kierunek akapitu nie jest dziedziczony.

spacingMode

enum (SpacingMode)

Tryb ustawień odstępów w akapicie.

spaceAbove

object (Dimension)

Ilość dodatkowego miejsca nad akapitem. Jeśli nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego.

spaceBelow

object (Dimension)

Ilość dodatkowego miejsca poniżej akapitu. Jeśli nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego.

borderBetween

object (ParagraphBorder)

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.

borderTop

object (ParagraphBorder)

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.

borderBottom

object (ParagraphBorder)

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.

borderLeft

object (ParagraphBorder)

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.

borderRight

object (ParagraphBorder)

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.

indentFirstLine

object (Dimension)

Wielkość wcięcia pierwszego wiersza akapitu. Jeśli nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego.

indentStart

object (Dimension)

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.

indentEnd

object (Dimension)

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.

tabStops[]

object (TabStop)

Lista tabulatorów w tym akapicie. Lista przystanków nie jest dziedziczona.

Ta usługa jest tylko do odczytu.

keepLinesTogether

boolean

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.

keepWithNext

boolean

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.

avoidWidowAndOrphan

boolean

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

object (Shading)

Cieniowanie akapitu. Jeśli nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego.

pageBreakBefore

boolean

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 pageBreakBefore w przypadku akapitów w nieobsługiwanych regionach, w tym Table, Header, Footer i Footnote, może spowodować nieprawidłowy stan dokumentu, który zwraca błąd 400 „Nieprawidłowe żądanie”.

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 (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "padding": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle)
}
Pola
color

object (OptionalColor)

Kolor obramowania.

width

object (Dimension)

Szerokość obramowania.

padding

object (Dimension)

Odstęp od obramowania.

dashStyle

enum (DashStyle)

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 (Dimension)
  },
  "alignment": enum (TabStopAlignment)
}
Pola
offset

object (Dimension)

Odstęp między tym przystankiem a marginesem początkowym.

alignment

enum (TabStopAlignment)

Wyrównanie tej karty zostało zatrzymane. Jeśli nie zostanie ustawiony, wartością domyślną jest START.

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 (OptionalColor)
  }
}
Pola
backgroundColor

object (OptionalColor)

Kolor tła cieniowania tego akapitu.

SuggestedParagraphStyle

sugerowana zmiana w elemencie ParagraphStyle;

Zapis JSON
{
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "paragraphStyleSuggestionState": {
    object (ParagraphStyleSuggestionState)
  }
}
Pola
paragraphStyle

object (ParagraphStyle)

ParagraphStyle, który zawiera tylko zmiany wprowadzone w tej propozycji. Możesz go używać razem z przyciskiem paragraphStyleSuggestionState, aby sprawdzić, które pola się zmieniły i jakie mają teraz wartości.

paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

Maska wskazująca, które pola w podstawowym ParagraphStyle zostały zmienione w tej propozycji.

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 (ShadingSuggestionState)
  },
  "pageBreakBeforeSuggested": boolean
}
Pola
headingIdSuggested

boolean

Wskazuje, czy zasugerowano zmianę na headingId.

namedStyleTypeSuggested

boolean

Wskazuje, czy zasugerowano zmianę na namedStyleType.

alignmentSuggested

boolean

Wskazuje, czy zasugerowano zmianę na alignment.

lineSpacingSuggested

boolean

Wskazuje, czy zasugerowano zmianę na lineSpacing.

directionSuggested

boolean

Wskazuje, czy zasugerowano zmianę na direction.

spacingModeSuggested

boolean

Wskazuje, czy zasugerowano zmianę na spacingMode.

spaceAboveSuggested

boolean

Wskazuje, czy zasugerowano zmianę na spaceAbove.

spaceBelowSuggested

boolean

Wskazuje, czy zasugerowano zmianę na spaceBelow.

borderBetweenSuggested

boolean

Wskazuje, czy zasugerowano zmianę na borderBetween.

borderTopSuggested

boolean

Wskazuje, czy zasugerowano zmianę na borderTop.

borderBottomSuggested

boolean

Wskazuje, czy zasugerowano zmianę na borderBottom.

borderLeftSuggested

boolean

Wskazuje, czy zasugerowano zmianę na borderLeft.

borderRightSuggested

boolean

Wskazuje, czy zasugerowano zmianę na borderRight.

indentFirstLineSuggested

boolean

Wskazuje, czy zasugerowano zmianę na indentFirstLine.

indentStartSuggested

boolean

Wskazuje, czy zasugerowano zmianę na indentStart.

indentEndSuggested

boolean

Wskazuje, czy zasugerowano zmianę na indentEnd.

keepLinesTogetherSuggested

boolean

Wskazuje, czy zasugerowano zmianę na keepLinesTogether.

keepWithNextSuggested

boolean

Wskazuje, czy zasugerowano zmianę na keepWithNext.

avoidWidowAndOrphanSuggested

boolean

Wskazuje, czy zasugerowano zmianę na avoidWidowAndOrphan.

shadingSuggestionState

object (ShadingSuggestionState)

Maska wskazująca, które pola w elementach shading zostały zmienione w tej propozycji.

pageBreakBeforeSuggested

boolean

Wskazuje, czy zasugerowano zmianę na pageBreakBefore.

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
backgroundColorSuggested

boolean

Wskazuje, czy sugerowano zmianę w sekcji Shading.

Punktor

Opisuje punkt akapitu.

Zapis JSON
{
  "listId": string,
  "nestingLevel": integer,
  "textStyle": {
    object (TextStyle)
  }
}
Pola
listId

string

Identyfikator listy, do której należy ten akapit.

nestingLevel

integer

Poziom zagnieżdżenia tego akapitu na liście.

textStyle

object (TextStyle)

Styl tekstu odnoszący się do akapitu zastosowany do tego punktu.

SuggestedBullet

sugerowana zmiana w elemencie Bullet;

Zapis JSON
{
  "bullet": {
    object (Bullet)
  },
  "bulletSuggestionState": {
    object (BulletSuggestionState)
  }
}
Pola
bullet

object (Bullet)

Bullet, który zawiera tylko zmiany wprowadzone w tej propozycji. Możesz go używać razem z przyciskiem bulletSuggestionState, aby sprawdzić, które pola się zmieniły i jakie mają teraz wartości.

bulletSuggestionState

object (BulletSuggestionState)

Maska wskazująca, które pola w podstawowym Bullet zostały zmienione w tej propozycji.

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 (TextStyleSuggestionState)
  }
}
Pola
listIdSuggested

boolean

Wskazuje, czy sugerowano zmianę w sekcji listId.

nestingLevelSuggested

boolean

Wskazuje, czy sugerowano zmianę w sekcji nestingLevel.

textStyleSuggestionState

object (TextStyleSuggestionState)

Maska wskazująca, które pola w elementach text style zostały zmienione w tej propozycji.

ObjectReferences

Kolekcja identyfikatorów obiektów.

Zapis JSON
{
  "objectIds": [
    string
  ]
}
Pola
objectIds[]

string

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 (SectionStyle)
  }
}
Pola
suggestedInsertionIds[]

string

Sugerowane identyfikatory wstawień. Jeśli SectionBreak jest zagnieżdżoną sugerowaną zmianą, może mieć wiele identyfikatorów wstawienia. Jeśli pole jest puste, nie jest to sugerowana wstawka.

suggestedDeletionIds[]

string

Identyfikatory sugerowanych do usunięcia. Jeśli jest puste, nie ma żadnych sugerowanych usunięcia tych treści.

sectionStyle

object (SectionStyle)

Styl sekcji po przerwie.

SectionStyle

Stylizacja stosowana w sekcji.

Zapis JSON
{
  "columnProperties": [
    {
      object (SectionColumnProperties)
    }
  ],
  "columnSeparatorStyle": enum (ColumnSeparatorStyle),
  "contentDirection": enum (ContentDirection),
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "marginHeader": {
    object (Dimension)
  },
  "marginFooter": {
    object (Dimension)
  },
  "sectionType": enum (SectionType),
  "defaultHeaderId": string,
  "defaultFooterId": string,
  "firstPageHeaderId": string,
  "firstPageFooterId": string,
  "evenPageHeaderId": string,
  "evenPageFooterId": string,
  "useFirstPageHeaderFooter": boolean,
  "pageNumberStart": integer,
  "flipPageOrientation": boolean
}
Pola
columnProperties[]

object (SectionColumnProperties)

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

columnSeparatorStyle

enum (ColumnSeparatorStyle)

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

contentDirection

enum (ContentDirection)

Kierunek treści w tej sekcji. Jeśli nie zostanie ustawiony, wartością domyślną jest LEFT_TO_RIGHT.

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

marginTop

object (Dimension)

Górny margines strony sekcji. Jeśli nie zostanie ustawiony, wartość domyślna to marginTop z DocumentStyle.

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

marginBottom

object (Dimension)

Dolny margines strony sekcji. Jeśli nie zostanie ustawiony, wartość domyślna to marginBottom z DocumentStyle.

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

marginRight

object (Dimension)

Prawy margines strony sekcji. Jeśli nie zostanie ustawiony, wartość domyślna to marginRight z DocumentStyle. Zmiana prawego marginesu powoduje zmianę rozmiaru kolumn w tej sekcji. Margines wpływa na szerokość kolumny, więc jest stosowany przed właściwościami 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”.

marginLeft

object (Dimension)

Lewy margines strony sekcji. Jeśli nie zostanie ustawiony, wartość domyślna to marginLeft z DocumentStyle. Zmiana lewego marginesu powoduje zmianę rozmiaru kolumn w tej sekcji. Margines wpływa na szerokość kolumny, więc jest stosowany przed właściwościami 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”.

marginHeader

object (Dimension)

Margines nagłówka sekcji. Jeśli nie zostanie ustawiony, wartość domyślna to marginHeader z DocumentStyle. Jeśli zostanie zaktualizowany, useCustomHeaderFooterMargins zostanie ustawiony na wartość Prawda w DocumentStyle. Wartość atrybutu useCustomHeaderFooterMargins w obiekcie DocumentStyle wskazuje, czy w tej sekcji jest uwzględniany margines nagłówka.

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

sectionType

enum (SectionType)

Tylko dane wyjściowe. Typ sekcji.

defaultHeaderId

string

Identyfikator nagłówka domyślnego. Jeśli nie zostanie ustawiony, wartość zostanie odziedziczona z poprzedniego elementu SectionBreak's SectionStyle. Jeśli wartość nie jest ustawiona w pierwszym elemencie SectionBreak, dziedziczy ją z defaultHeaderId elementu DocumentStyle.

Ta usługa jest tylko do odczytu.

firstPageHeaderId

string

Identyfikator nagłówka używanego tylko na pierwszej stronie sekcji. Jeśli useFirstPageHeaderFooter ma wartość PRAWDA, ta wartość jest używana w nagłówku na pierwszej stronie sekcji. Jeśli jest ustawiona na „fałsz”, nagłówek na pierwszej stronie sekcji używa wartości defaultHeaderId. Jeśli nie zostanie ustawiony, wartość zostanie odziedziczona z poprzedniego elementu SectionBreak's SectionStyle. Jeśli wartość nie jest ustawiona w pierwszym elemencie SectionBreak, dziedziczy ją z firstPageHeaderId elementu DocumentStyle.

Ta usługa jest tylko do odczytu.

evenPageHeaderId

string

Identyfikator nagłówka używanego tylko na stronach parzystych. Jeśli wartość atrybutu useEvenPageHeaderFooter obiektu DocumentStyle ma wartość TRUE, jest ona używana do nagłówków na parzystych stronach w sekcji. Jeśli jest to wartość false, nagłówki na stronach parzystych używają wartości defaultHeaderId. Jeśli nie zostanie ustawiony, wartość zostanie odziedziczona z poprzedniego elementu SectionBreak's SectionStyle. Jeśli wartość nie jest ustawiona w pierwszym elemencie SectionBreak, dziedziczy ją z evenPageHeaderId elementu DocumentStyle.

Ta usługa jest tylko do odczytu.

pageNumberStart

integer

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 SectionBreak jest pusta, sprawdź element pageNumberStart obiektu DocumentStyle.

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

flipPageOrientation

boolean

Opcjonalnie: Wskazuje, czy w tym dziale wymiary pageSize w DocumentStyle mają być odwrócone, co umożliwia zmianę orientacji strony z pionowej na poziomą i odwrotnie. Jeśli nie zostanie ustawiona, wartość zostanie odziedziczona z flipPageOrientation w DocumentStyle.

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 (Dimension)
  },
  "paddingEnd": {
    object (Dimension)
  }
}
Pola
width

object (Dimension)

Tylko dane wyjściowe. Szerokość kolumny.

paddingEnd

object (Dimension)

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 (TableRow)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "tableStyle": {
    object (TableStyle)
  }
}
Pola
rows

integer

Liczba wierszy w tabeli.

columns

integer

Liczba kolumn w tabeli.

Tabela może mieć kształt nieprostokątny, więc niektóre wiersze mogą mieć inną liczbę komórek.

tableRows[]

object (TableRow)

Treść i styl każdego wiersza.

suggestedInsertionIds[]

string

Sugerowane identyfikatory wstawień. Jeśli Table jest zagnieżdżoną sugerowaną zmianą, może mieć wiele identyfikatorów wstawienia. Jeśli jest puste, nie jest to sugerowane wstawienie.

suggestedDeletionIds[]

string

Identyfikatory sugerowanych do usunięcia. Jeśli jest puste, nie ma żadnych sugerowanych usunięcia tych treści.

tableStyle

object (TableStyle)

Styl tabeli.

TableRow

Treść i styl wiersza w Table.

Zapis JSON
{
  "startIndex": integer,
  "endIndex": integer,
  "tableCells": [
    {
      object (TableCell)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "suggestedTableRowStyleChanges": {
    string: {
      object (SuggestedTableRowStyle)
    },
    ...
  }
}
Pola
startIndex

integer

Indeks początkowy tego wiersza (liczony od 0) w jednostkach kodu UTF-16.

endIndex

integer

Indeks końcowy tego wiersza (liczony od 0) w jednostkach kodu UTF-16 (bez uwzględnienia ostatniego wiersza).

tableCells[]

object (TableCell)

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.

suggestedInsertionIds[]

string

Sugerowane identyfikatory wstawień. Jeśli TableRow jest zagnieżdżoną sugerowaną zmianą, może mieć wiele identyfikatorów wstawienia. Jeśli pole jest puste, nie jest to sugerowana wstawka.

suggestedDeletionIds[]

string

Identyfikatory sugerowanych do usunięcia. Jeśli jest puste, nie ma żadnych sugerowanych usunięcia tych treści.

tableRowStyle

object (TableRowStyle)

Styl wiersza tabeli.

suggestedTableRowStyleChanges

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

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 (StructuralElement)
    }
  ],
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "suggestedTableCellStyleChanges": {
    string: {
      object (SuggestedTableCellStyle)
    },
    ...
  }
}
Pola
startIndex

integer

Indeks początkowy tej komórki (liczony od 0) w jednostkach kodu UTF-16.

endIndex

integer

Indeks końcowy tej komórki (liczony od 0) w jednostkach kodu UTF-16 (bez uwzględnienia).

content[]

object (StructuralElement)

Treść komórki.

tableCellStyle

object (TableCellStyle)

Styl komórki.

suggestedInsertionIds[]

string

Sugerowane identyfikatory wstawień. Jeśli TableCell jest zagnieżdżoną sugerowaną zmianą, może mieć wiele identyfikatorów wstawienia. Jeśli jest puste, nie jest to sugerowane wstawienie.

suggestedDeletionIds[]

string

Identyfikatory sugerowanych do usunięcia. Jeśli jest puste, nie ma żadnych sugerowanych usunięcia tych treści.

suggestedTableCellStyleChanges

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

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 (OptionalColor)
  },
  "borderLeft": {
    object (TableCellBorder)
  },
  "borderRight": {
    object (TableCellBorder)
  },
  "borderTop": {
    object (TableCellBorder)
  },
  "borderBottom": {
    object (TableCellBorder)
  },
  "paddingLeft": {
    object (Dimension)
  },
  "paddingRight": {
    object (Dimension)
  },
  "paddingTop": {
    object (Dimension)
  },
  "paddingBottom": {
    object (Dimension)
  },
  "contentAlignment": enum (ContentAlignment)
}
Pola
rowSpan

integer

Zakres komórki w wierszach.

Ta usługa jest tylko do odczytu.

columnSpan

integer

Zakres kolumny komórki.

Ta usługa jest tylko do odczytu.

backgroundColor

object (OptionalColor)

Kolor tła komórki.

borderLeft

object (TableCellBorder)

Lewa krawędź komórki.

borderRight

object (TableCellBorder)

Prawa krawędź komórki.

borderTop

object (TableCellBorder)

Górne obramowanie komórki.

borderBottom

object (TableCellBorder)

Dolna krawędź komórki.

paddingLeft

object (Dimension)

Wypełnienie z lewej strony komórki.

paddingRight

object (Dimension)

Prawe wypełnienie komórki.

paddingTop

object (Dimension)

Dopełnienie górnej części komórki.

paddingBottom

object (Dimension)

Dopełnienie komórki u dołu.

contentAlignment

enum (ContentAlignment)

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 (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle)
}
Pola
color

object (OptionalColor)

Kolor obramowania.

Ten kolor nie może być przezroczysty.

width

object (Dimension)

Szerokość obramowania.

dashStyle

enum (DashStyle)

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 (TableCellStyle)
  },
  "tableCellStyleSuggestionState": {
    object (TableCellStyleSuggestionState)
  }
}
Pola
tableCellStyle

object (TableCellStyle)

TableCellStyle, który zawiera tylko zmiany wprowadzone w tej propozycji. Możesz go używać razem z przyciskiem tableCellStyleSuggestionState, aby sprawdzić, które pola się zmieniły i jakie mają teraz wartości.

tableCellStyleSuggestionState

object (TableCellStyleSuggestionState)

Maska wskazująca, które pola w podstawowym TableCellStyle zostały zmienione w tej propozycji.

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
rowSpanSuggested

boolean

Wskazuje, czy zasugerowano zmianę na rowSpan.

columnSpanSuggested

boolean

Wskazuje, czy zasugerowano zmianę na columnSpan.

backgroundColorSuggested

boolean

Wskazuje, czy zasugerowano zmianę na backgroundColor.

borderLeftSuggested

boolean

Wskazuje, czy zasugerowano zmianę na borderLeft.

borderRightSuggested

boolean

Wskazuje, czy zasugerowano zmianę na borderRight.

borderTopSuggested

boolean

Wskazuje, czy zasugerowano zmianę na borderTop.

borderBottomSuggested

boolean

Wskazuje, czy zasugerowano zmianę na borderBottom.

paddingLeftSuggested

boolean

Wskazuje, czy zasugerowano zmianę na paddingLeft.

paddingRightSuggested

boolean

Wskazuje, czy zasugerowano zmianę na paddingRight.

paddingTopSuggested

boolean

Wskazuje, czy zasugerowano zmianę na paddingTop.

paddingBottomSuggested

boolean

Wskazuje, czy zasugerowano zmianę na paddingBottom.

contentAlignmentSuggested

boolean

Wskazuje, czy zasugerowano zmianę na contentAlignment.

TableRowStyle

Style stosowane do wiersza tabeli.

Zapis JSON
{
  "minRowHeight": {
    object (Dimension)
  },
  "tableHeader": boolean,
  "preventOverflow": boolean
}
Pola
minRowHeight

object (Dimension)

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.

tableHeader

boolean

Określa, czy wiersz jest nagłówkiem tabeli.

preventOverflow

boolean

Określa, czy wiersz nie może przekroczyć granicy strony lub kolumny.

SuggestedTableRowStyle

sugerowana zmiana w elemencie TableRowStyle;

Zapis JSON
{
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "tableRowStyleSuggestionState": {
    object (TableRowStyleSuggestionState)
  }
}
Pola
tableRowStyle

object (TableRowStyle)

TableRowStyle, który zawiera tylko zmiany wprowadzone w tej propozycji. Możesz go używać razem z przyciskiem tableRowStyleSuggestionState, aby sprawdzić, które pola się zmieniły i jakie mają teraz wartości.

tableRowStyleSuggestionState

object (TableRowStyleSuggestionState)

Maska wskazująca, które pola w podstawowym TableRowStyle zostały zmienione w tej propozycji.

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
minRowHeightSuggested

boolean

Wskazuje, czy zasugerowano zmianę na minRowHeight.

TableStyle

Style stosowane do tabeli.

Zapis JSON
{
  "tableColumnProperties": [
    {
      object (TableColumnProperties)
    }
  ]
}
Pola
tableColumnProperties[]

object (TableColumnProperties)

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

TableColumnProperties

Właściwości kolumny w tabeli.

Zapis JSON
{
  "widthType": enum (WidthType),
  "width": {
    object (Dimension)
  }
}
Pola
widthType

enum (WidthType)

Typ szerokości kolumny.

width

object (Dimension)

Szerokość kolumny. Ustaw, gdy wartość widthType kolumny to FIXED_WIDTH.

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 (StructuralElement)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ]
}
Pola
content[]

object (StructuralElement)

Treść spisu treści.

suggestedInsertionIds[]

string

Sugerowane identyfikatory wstawień. Jeśli TableOfContents jest zagnieżdżoną sugerowaną zmianą, może mieć wiele identyfikatorów wstawienia. Jeśli jest puste, nie jest to sugerowane wstawienie.

suggestedDeletionIds[]

string

Identyfikatory sugerowanych do usunięcia. Jeśli jest puste, nie ma żadnych sugerowanych usunięcia tych treści.

Przypis

przypis do dokumentu,

Zapis JSON
{
  "footnoteId": string,
  "content": [
    {
      object (StructuralElement)
    }
  ]
}
Pola
footnoteId

string

Identyfikator przypisu.

content[]

object (StructuralElement)

Treść przypisu.

Indeksy zawartości przypisu zaczynają się od 0.

DocumentStyle

Styl dokumentu.

Zapis JSON
{
  "background": {
    object (Background)
  },
  "defaultHeaderId": string,
  "defaultFooterId": string,
  "evenPageHeaderId": string,
  "evenPageFooterId": string,
  "firstPageHeaderId": string,
  "firstPageFooterId": string,
  "useFirstPageHeaderFooter": boolean,
  "useEvenPageHeaderFooter": boolean,
  "pageNumberStart": integer,
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "pageSize": {
    object (Size)
  },
  "marginHeader": {
    object (Dimension)
  },
  "marginFooter": {
    object (Dimension)
  },
  "useCustomHeaderFooterMargins": boolean,
  "flipPageOrientation": boolean
}
Pola
background

object (Background)

Tłoko dokumentu. Dokumenty nie mogą mieć przezroczystego koloru tła.

defaultHeaderId

string

Identyfikator nagłówka domyślnego. Jeśli nie zostanie ustawiony, nie będzie nagłówka domyślnego.

Ta usługa jest tylko do odczytu.

evenPageHeaderId

string

Identyfikator nagłówka używanego tylko na stronach parzystych. Wartość parametru useEvenPageHeaderFooter określa, czy w nagłówku na stronach parzystych ma być używana wartość parametru defaultHeaderId, czy ta wartość. Jeśli nie jest ustawiony, nie ma nagłówka strony parzystej.

Ta usługa jest tylko do odczytu.

firstPageHeaderId

string

Identyfikator nagłówka używanego tylko na pierwszej stronie. Jeśli nie jest ustawiony, na pierwszej stronie nie ma unikalnego nagłówka. Wartość useFirstPageHeaderFooter określa, czy w nagłówku na pierwszej stronie ma być użyta wartość defaultHeaderId, czy ta wartość. Jeśli nie jest ustawiony, nagłówek pierwszej strony nie będzie wyświetlany.

Ta usługa jest tylko do odczytu.

pageNumberStart

integer

Numer strony, od której ma się rozpoczynać zliczanie liczby stron.

marginTop

object (Dimension)

Górny margines strony.

Zmiana górnego marginesu strony w stylu dokumentu powoduje usunięcie górnego marginesu strony we wszystkich stylach sekcji.

marginBottom

object (Dimension)

Dolny margines strony.

Zmiana dolnego marginesu strony w stylu dokumentu powoduje wyczyszczenie dolnego marginesu strony we wszystkich stylach sekcji.

marginRight

object (Dimension)

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.

marginLeft

object (Dimension)

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.

pageSize

object (Size)

Rozmiar strony w dokumencie.

marginHeader

object (Dimension)

Odległość między górną krawędzią strony a zawartością nagłówka.

flipPageOrientation

boolean

Opcjonalnie: Określa, czy wymiary pageSize mają być odwrócone, co umożliwia zmianę orientacji strony z poziomej na poziomą i odwrotnie.

Tło

Reprezentuje tło dokumentu.

Zapis JSON
{
  "color": {
    object (OptionalColor)
  }
}
Pola
color

object (OptionalColor)

Kolor tła.

Rozmiar

szerokość i wysokość;

Zapis JSON
{
  "height": {
    object (Dimension)
  },
  "width": {
    object (Dimension)
  }
}
Pola
height

object (Dimension)

Wysokość obiektu.

width

object (Dimension)

Szerokość obiektu.

SuggestedDocumentStyle

Zaproponowana zmiana w DocumentStyle.

Zapis JSON
{
  "documentStyle": {
    object (DocumentStyle)
  },
  "documentStyleSuggestionState": {
    object (DocumentStyleSuggestionState)
  }
}
Pola
documentStyle

object (DocumentStyle)

DocumentStyle, który zawiera tylko zmiany wprowadzone w tej propozycji. Możesz go używać razem z przyciskiem documentStyleSuggestionState, aby sprawdzić, które pola się zmieniły i jakie mają teraz wartości.

documentStyleSuggestionState

object (DocumentStyleSuggestionState)

Maska wskazująca, które pola w podstawowym DocumentStyle zostały zmienione w tej propozycji.

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 (BackgroundSuggestionState)
  },
  "defaultHeaderIdSuggested": boolean,
  "defaultFooterIdSuggested": boolean,
  "evenPageHeaderIdSuggested": boolean,
  "evenPageFooterIdSuggested": boolean,
  "firstPageHeaderIdSuggested": boolean,
  "firstPageFooterIdSuggested": boolean,
  "useFirstPageHeaderFooterSuggested": boolean,
  "useEvenPageHeaderFooterSuggested": boolean,
  "pageNumberStartSuggested": boolean,
  "marginTopSuggested": boolean,
  "marginBottomSuggested": boolean,
  "marginRightSuggested": boolean,
  "marginLeftSuggested": boolean,
  "pageSizeSuggestionState": {
    object (SizeSuggestionState)
  },
  "marginHeaderSuggested": boolean,
  "marginFooterSuggested": boolean,
  "useCustomHeaderFooterMarginsSuggested": boolean,
  "flipPageOrientationSuggested": boolean
}
Pola
backgroundSuggestionState

object (BackgroundSuggestionState)

Maska wskazująca, które pola w elementach background zostały zmienione w tej propozycji.

defaultHeaderIdSuggested

boolean

Wskazuje, czy zasugerowano zmianę na defaultHeaderId.

evenPageHeaderIdSuggested

boolean

Wskazuje, czy zasugerowano zmianę na evenPageHeaderId.

firstPageHeaderIdSuggested

boolean

Wskazuje, czy zasugerowano zmianę na firstPageHeaderId.

pageNumberStartSuggested

boolean

Wskazuje, czy zasugerowano zmianę na pageNumberStart.

marginTopSuggested

boolean

Wskazuje, czy zasugerowano zmianę na marginTop.

marginBottomSuggested

boolean

Wskazuje, czy zasugerowano zmianę na marginBottom.

marginRightSuggested

boolean

Wskazuje, czy zasugerowano zmianę na marginRight.

marginLeftSuggested

boolean

Wskazuje, czy zasugerowano zmianę na marginLeft.

pageSizeSuggestionState

object (SizeSuggestionState)

Maska wskazująca, które pola w [size] [google.apps.docs.v1.DocumentStyle.size] zostały zmienione w tej propozycji.

marginHeaderSuggested

boolean

Wskazuje, czy zasugerowano zmianę na marginHeader.

flipPageOrientationSuggested

boolean

Opcjonalnie: Wskazuje, czy zasugerowano zmianę na flipPageOrientation.

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
backgroundColorSuggested

boolean

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
heightSuggested

boolean

Wskazuje, czy zasugerowano zmianę na height.

widthSuggested

boolean

Wskazuje, czy zasugerowano zmianę na width.

NamedStyles

Style nazwane. Akapity w dokumencie mogą dziedziczyć wartości TextStyle i ParagraphStyle z tych nazwanych stylów.

Zapis JSON
{
  "styles": [
    {
      object (NamedStyle)
    }
  ]
}
Pola
styles[]

object (NamedStyle)

Style nazwane.

Wpis jest tworzony dla każdego możliwego named style types.

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 (NamedStyleType),
  "textStyle": {
    object (TextStyle)
  },
  "paragraphStyle": {
    object (ParagraphStyle)
  }
}
Pola
namedStyleType

enum (NamedStyleType)

Typ tego nazwanego stylu.

textStyle

object (TextStyle)

Styl tekstu tego stylu nazwanego.

paragraphStyle

object (ParagraphStyle)

Styl akapitu tego stylu nazwanego.

SuggestedNamedStyles

Zaproponowana zmiana w NamedStyles.

Zapis JSON
{
  "namedStyles": {
    object (NamedStyles)
  },
  "namedStylesSuggestionState": {
    object (NamedStylesSuggestionState)
  }
}
Pola
namedStyles

object (NamedStyles)

NamedStyles, który zawiera tylko zmiany wprowadzone w tej propozycji. Możesz go używać razem z przyciskiem namedStylesSuggestionState, aby sprawdzić, które pola się zmieniły i jakie mają teraz wartości.

namedStylesSuggestionState

object (NamedStylesSuggestionState)

Maska wskazująca, które pola w podstawowym NamedStyles zostały zmienione w tej propozycji.

NamedStylesSuggestionState

Stan sugestii w wiadomości NamedStyles.

Zapis JSON
{
  "stylesSuggestionStates": [
    {
      object (NamedStyleSuggestionState)
    }
  ]
}
Pola
stylesSuggestionStates[]

object (NamedStyleSuggestionState)

Maska wskazująca, które pola w odpowiednim elemencie NamedStyle w definicji styles zostały zmienione w tej propozycji.

Kolejność stanów nazwanych sugestii stylów odpowiada kolejności nazwanych stylów w sugestii named styles.

NamedStyleSuggestionState

Stan sugestii w wiadomości NamedStyle.

Zapis JSON
{
  "namedStyleType": enum (NamedStyleType),
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  },
  "paragraphStyleSuggestionState": {
    object (ParagraphStyleSuggestionState)
  }
}
Pola
namedStyleType

enum (NamedStyleType)

Nazwa typu stylu, któremu odpowiada stan sugestii.

To pole jest udostępniane w celu ułatwienia dopasowywania stanu NamedStyleSuggestionState do odpowiadającego mu NamedStyle.

textStyleSuggestionState

object (TextStyleSuggestionState)

Maska wskazująca, które pola w elementach text style zostały zmienione w tej propozycji.

paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

Maska wskazująca, które pola w elementach paragraph style zostały zmienione w tej propozycji.

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 (ListProperties)
  },
  "suggestedListPropertiesChanges": {
    string: {
      object (SuggestedListProperties)
    },
    ...
  },
  "suggestedInsertionId": string,
  "suggestedDeletionIds": [
    string
  ]
}
Pola
listProperties

object (ListProperties)

Właściwości listy.

suggestedListPropertiesChanges

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

Proponowane zmiany właściwości listy, posortowane według identyfikatora sugestii.

suggestedInsertionId

string

Sugerowany identyfikator wstawienia. Jeśli jest puste, nie jest to sugerowane wstawienie.

suggestedDeletionIds[]

string

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 (NestingLevel)
    }
  ]
}
Pola
nestingLevels[]

object (NestingLevel)

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 (BulletAlignment),
  "glyphFormat": string,
  "indentFirstLine": {
    object (Dimension)
  },
  "indentStart": {
    object (Dimension)
  },
  "textStyle": {
    object (TextStyle)
  },
  "startNumber": integer,

  // Union field glyph_kind can be only one of the following:
  "glyphType": enum (GlyphType),
  "glyphSymbol": string
  // End of list of possible types for union field glyph_kind.
}
Pola
bulletAlignment

enum (BulletAlignment)

wyrównanie cyfry w ramach miejsca przeznaczonego na jej wyświetlenie,

glyphFormat

string

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 glyphType lub glyphSymbol. Zmienna musi być zgodna ze wzorcem %[nestingLevel]. Wartości zastępcze mogą też zawierać przedrostki i przyrostki. Format glifów jest więc zgodny ze wzorcem <prefix>%[nestingLevel]<suffix>. Pamiętaj, że prefiks i sufiks są opcjonalne i mogą być dowolnymi ciągami znaków.

Na przykład format znaku %0. wskazuje, że renderowany znak zastąpi miejsce zastępcze odpowiednim znakiem dla poziomu zagnieżdżania 0, po którym następuje kropka jako przyrostek. Lista z typem glifu UPPER_ALPHA i formatem glifu %0. na poziomie zagnieżdżenia 0 spowoduje wyświetlenie listy z wyrenderowanymi glifami.

A.

B.

C.

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 %0. na poziomie zagnieżdżenia 0 i format glifu %0.%1. na poziomie zagnieżdżenia 1. Zakładając, że oba poziomy zagnieżdżenia mają typy glifu DECIMAL, spowoduje to utworzenie listy z wyrenderowanymi glifami.

1.

2.

2.1.

2.2.

3.

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.

indentFirstLine

object (Dimension)

Wielkość wcięcia pierwszego wiersza akapitów na tym poziomie zagnieżdżenia.

indentStart

object (Dimension)

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.

textStyle

object (TextStyle)

Styl tekstu w punkcie na tym poziomie umieszczania.

startNumber

integer

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 a i i.

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

enum (GlyphType)

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 glyphFormat, gdy akapity na tym poziomie zagnieżdżenia są uporządkowane. Jeśli na przykład poziom zagnieżdżania wynosi 0, glyphFormat to %0., a typ glifu to DECIMAL, wyrenderowany glif zastąpi placeholder %0 w formacie glifu liczbą odpowiadającą pozycji elementu na liście.

glyphSymbol

string

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 glyphFormat. Jeśli na przykład symbol glifów to pełny okrąg odpowiadający punktowi kodu Unicode U+25cf, a glyphFormat to %0, wyrenderowany glif będzie miał postać pełnego okręgu.

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 (ListProperties)
  },
  "listPropertiesSuggestionState": {
    object (ListPropertiesSuggestionState)
  }
}
Pola
listProperties

object (ListProperties)

ListProperties, który zawiera tylko zmiany wprowadzone w tej propozycji. Możesz go używać razem z przyciskiem listPropertiesSuggestionState, aby sprawdzić, które pola się zmieniły i jakie mają teraz wartości.

listPropertiesSuggestionState

object (ListPropertiesSuggestionState)

Maska wskazująca, które pola w podstawowym ListProperties zostały zmienione w tej propozycji.

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 (NestingLevelSuggestionState)
    }
  ]
}
Pola
nestingLevelsSuggestionStates[]

object (NestingLevelSuggestionState)

Maska wskazująca, które pola w odpowiednim elemencie NestingLevel w definicji nestingLevels zostały zmienione w tej propozycji.

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 (TextStyleSuggestionState)
  },
  "startNumberSuggested": boolean
}
Pola
bulletAlignmentSuggested

boolean

Wskazuje, czy zasugerowano zmianę na bulletAlignment.

glyphTypeSuggested

boolean

Wskazuje, czy zasugerowano zmianę na glyphType.

glyphFormatSuggested

boolean

Wskazuje, czy zasugerowano zmianę na glyphFormat.

glyphSymbolSuggested

boolean

Wskazuje, czy zasugerowano zmianę na glyphSymbol.

indentFirstLineSuggested

boolean

Wskazuje, czy zasugerowano zmianę na indentFirstLine.

indentStartSuggested

boolean

Wskazuje, czy zasugerowano zmianę na indentStart.

textStyleSuggestionState

object (TextStyleSuggestionState)

Maska wskazująca, które pola w elementach text style zostały zmienione w tej propozycji.

startNumberSuggested

boolean

Wskazuje, czy zasugerowano zmianę na startNumber.

NamedRanges

Kolekcja wszystkich NamedRange w dokumencie, które mają tę samą nazwę.

Zapis JSON
{
  "name": string,
  "namedRanges": [
    {
      object (NamedRange)
    }
  ]
}
Pola
name

string

Nazwa, którą mają wszystkie named ranges.

namedRanges[]

object (NamedRange)

NamedRange o tej samej nazwie.

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 (Range)
    }
  ]
}
Pola
namedRangeId

string

Identyfikator zakresu nazwanego.

name

string

Nazwa zakresu nazwanego.

ranges[]

object (Range)

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
segmentId

string

Identyfikator nagłówka, stopki lub przypisu, w którym znajduje się ten zakres. Pusty identyfikator segmentu oznacza treść dokumentu.

startIndex

integer

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.

endIndex

integer

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.

tabId

string

Karta zawierająca ten zakres. Jeśli nie zostanie podany, żądanie zostanie zastosowane do pierwszej karty.

W dokumencie zawierającym jedną kartę:

  • Jeśli podano, musi być zgodny z identyfikatorem pojedynczej karty.

  • Jeśli to pole zostanie pominięte, prośba będzie dotyczyć pojedynczej karty.

W dokumencie zawierającym wiele kart:

  • Jeśli podano, prośba dotyczy określonej karty.

  • Jeśli nie zostanie podany, prośba zostanie zastosowana do pierwszej karty w dokumencie.

InlineObject

Obiekt, który pojawia się w tekście. Obiekt w tekście zawiera EmbeddedObject, np. obraz.

Zapis JSON
{
  "objectId": string,
  "inlineObjectProperties": {
    object (InlineObjectProperties)
  },
  "suggestedInlineObjectPropertiesChanges": {
    string: {
      object (SuggestedInlineObjectProperties)
    },
    ...
  },
  "suggestedInsertionId": string,
  "suggestedDeletionIds": [
    string
  ]
}
Pola
objectId

string

Identyfikator tego obiektu wbudowanego. Można go używać do aktualizowania właściwości obiektu.

inlineObjectProperties

object (InlineObjectProperties)

Właściwości tego obiektu wstawionego w tekst.

suggestedInlineObjectPropertiesChanges

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

Sugerowane zmiany właściwości obiektów w tle, posortowane według identyfikatora sugestii.

suggestedInsertionId

string

Sugerowany identyfikator wstawienia. Jeśli jest puste, nie jest to sugerowane wstawienie.

suggestedDeletionIds[]

string

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 (EmbeddedObject)
  }
}
Pola
embeddedObject

object (EmbeddedObject)

Umieszczenie obiektu w ramach tego obiektu wstawianego w tekście.

EmbeddedObject

Obiekt umieszczony w dokumencie.

Zapis JSON
{
  "title": string,
  "description": string,
  "embeddedObjectBorder": {
    object (EmbeddedObjectBorder)
  },
  "size": {
    object (Size)
  },
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "linkedContentReference": {
    object (LinkedContentReference)
  },

  // Union field properties can be only one of the following:
  "embeddedDrawingProperties": {
    object (EmbeddedDrawingProperties)
  },
  "imageProperties": {
    object (ImageProperties)
  }
  // End of list of possible types for union field properties.
}
Pola
title

string

Tytuł obiektu wstawionego. Atrybuty title i description są łączone, aby wyświetlić tekst alternatywny.

description

string

Opis obiektu wbudowanego. Atrybuty title i description są łączone, aby wyświetlić tekst alternatywny.

embeddedObjectBorder

object (EmbeddedObjectBorder)

Obwód umieszczonego obiektu.

size

object (Size)

Widoczny rozmiar obrazu po przycięciu.

marginTop

object (Dimension)

Górny margines osadzonego obiektu.

marginBottom

object (Dimension)

Dolna krawędź umieszczonego obiektu.

marginRight

object (Dimension)

Prawy margines osadzonego obiektu.

marginLeft

object (Dimension)

Lewy margines osadzonego obiektu.

linkedContentReference

object (LinkedContentReference)

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

object (EmbeddedDrawingProperties)

Właściwości rysunku umieszczonego.

imageProperties

object (ImageProperties)

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 (CropProperties)
  },
  "angle": number
}
Pola
contentUri

string

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.

sourceUri

string

Identyfikator URI źródła to identyfikator URI użyty do wstawienia obrazu. Identyfikator URI źródła może być pusty.

brightness

number

Efekt jasności obrazu. Wartość powinna mieścić się w zakresie [-1,0, 1,0], gdzie 0 oznacza brak efektu.

contrast

number

Efekt kontrastu obrazu. Wartość powinna mieścić się w zakresie [-1,0, 1,0], gdzie 0 oznacza brak efektu.

transparency

number

Efekt przezroczystości obrazu. Wartość powinna mieścić się w zakresie [0,0, 1,0], gdzie 0 oznacza brak efektu, a 1 – przezroczystość.

cropProperties

object (CropProperties)

Właściwości kadrowania obrazu.

angle

number

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
offsetLeft

number

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

offsetRight

number

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.

offsetTop

number

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.

offsetBottom

number

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

number

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 (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle),
  "propertyState": enum (PropertyState)
}
Pola
color

object (OptionalColor)

Kolor obramowania.

width

object (Dimension)

Szerokość obramowania.

dashStyle

enum (DashStyle)

Styl kresek obramowania.

propertyState

enum (PropertyState)

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 reference can be only one of the following:
  "sheetsChartReference": {
    object (SheetsChartReference)
  }
  // End of list of possible types for union field reference.
}
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:
sheetsChartReference

object (SheetsChartReference)

Odwołuje się do połączonego wykresu.

SheetsChartReference

Odwołanie do połączonego wykresu z Arkuszy Google.

Zapis JSON
{
  "spreadsheetId": string,
  "chartId": integer
}
Pola
spreadsheetId

string

Identyfikator arkusza kalkulacyjnego w Google Sheets zawierającego wykres źródłowy.

chartId

integer

Identyfikator konkretnego wykresu w osadzonym arkuszu kalkulacyjnym Arkuszy Google.

SuggestedInlineObjectProperties

Zaproponowana zmiana: InlineObjectProperties.

Zapis JSON
{
  "inlineObjectProperties": {
    object (InlineObjectProperties)
  },
  "inlineObjectPropertiesSuggestionState": {
    object (InlineObjectPropertiesSuggestionState)
  }
}
Pola
inlineObjectProperties

object (InlineObjectProperties)

InlineObjectProperties, który zawiera tylko zmiany wprowadzone w tej propozycji. Możesz go używać razem z przyciskiem inlineObjectPropertiesSuggestionState, aby sprawdzić, które pola się zmieniły i jakie mają teraz wartości.

inlineObjectPropertiesSuggestionState

object (InlineObjectPropertiesSuggestionState)

Maska wskazująca, które pola w podstawowym InlineObjectProperties zostały zmienione w tej propozycji.

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 (EmbeddedObjectSuggestionState)
  }
}
Pola
embeddedObjectSuggestionState

object (EmbeddedObjectSuggestionState)

Maska wskazująca, które pola w elementach embeddedObject zostały zmienione w tej propozycji.

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 (EmbeddedDrawingPropertiesSuggestionState)
  },
  "imagePropertiesSuggestionState": {
    object (ImagePropertiesSuggestionState)
  },
  "titleSuggested": boolean,
  "descriptionSuggested": boolean,
  "embeddedObjectBorderSuggestionState": {
    object (EmbeddedObjectBorderSuggestionState)
  },
  "sizeSuggestionState": {
    object (SizeSuggestionState)
  },
  "marginLeftSuggested": boolean,
  "marginRightSuggested": boolean,
  "marginTopSuggested": boolean,
  "marginBottomSuggested": boolean,
  "linkedContentReferenceSuggestionState": {
    object (LinkedContentReferenceSuggestionState)
  }
}
Pola
embeddedDrawingPropertiesSuggestionState

object (EmbeddedDrawingPropertiesSuggestionState)

Maska wskazująca, które pola w elementach embeddedDrawingProperties zostały zmienione w tej propozycji.

imagePropertiesSuggestionState

object (ImagePropertiesSuggestionState)

Maska wskazująca, które pola w elementach imageProperties zostały zmienione w tej propozycji.

titleSuggested

boolean

Wskazuje, czy zasugerowano zmianę na title.

descriptionSuggested

boolean

Wskazuje, czy zasugerowano zmianę na description.

embeddedObjectBorderSuggestionState

object (EmbeddedObjectBorderSuggestionState)

Maska wskazująca, które pola w elementach embeddedObjectBorder zostały zmienione w tej propozycji.

sizeSuggestionState

object (SizeSuggestionState)

Maska wskazująca, które pola w elementach size zostały zmienione w tej propozycji.

marginLeftSuggested

boolean

Wskazuje, czy zasugerowano zmianę na marginLeft.

marginRightSuggested

boolean

Wskazuje, czy zasugerowano zmianę na marginRight.

marginTopSuggested

boolean

Wskazuje, czy zasugerowano zmianę na marginTop.

marginBottomSuggested

boolean

Wskazuje, czy zasugerowano zmianę na marginBottom.

linkedContentReferenceSuggestionState

object (LinkedContentReferenceSuggestionState)

Maska wskazująca, które pola w elementach linkedContentReference zostały zmienione w tej propozycji.

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 (CropPropertiesSuggestionState)
  },
  "angleSuggested": boolean
}
Pola
contentUriSuggested

boolean

Wskazuje, czy zasugerowano zmianę na contentUri.

sourceUriSuggested

boolean

Wskazuje, czy zasugerowano zmianę w [sourceUri] [google.apps.docs.v1.EmbeddedObject.source_uri].

brightnessSuggested

boolean

Wskazuje, czy zasugerowano zmianę wartości atrybutu [brightness] [google.apps.docs.v1.EmbeddedObject.brightness].

contrastSuggested

boolean

Wskazuje, czy zasugerowano zmianę w [contrast] [google.apps.docs.v1.EmbeddedObject.contrast].

transparencySuggested

boolean

Wskazuje, czy zasugerowano zmianę w polu [transparency] [google.apps.docs.v1.EmbeddedObject.transparency].

cropPropertiesSuggestionState

object (CropPropertiesSuggestionState)

Maska wskazująca, które pola w elementach cropProperties zostały zmienione w tej propozycji.

angleSuggested

boolean

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
offsetLeftSuggested

boolean

Wskazuje, czy zasugerowano zmianę na offsetLeft.

offsetRightSuggested

boolean

Wskazuje, czy zasugerowano zmianę na offsetRight.

offsetTopSuggested

boolean

Wskazuje, czy zasugerowano zmianę na offsetTop.

offsetBottomSuggested

boolean

Wskazuje, czy zasugerowano zmianę na offsetBottom.

angleSuggested

boolean

Wskazuje, czy zasugerowano zmianę na angle.

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
colorSuggested

boolean

Wskazuje, czy zasugerowano zmianę atrybutu [color] w obiekcie [google.apps.docs.v1.EmbeddedBorderObject.color].

widthSuggested

boolean

Wskazuje, czy zasugerowano zmianę atrybutu [width] w obiekcie osadzonej ramki ([google.apps.docs.v1.EmbeddedBorderObject.width]).

dashStyleSuggested

boolean

Wskazuje, czy zasugerowano zmianę atrybutu [dashStyle] w obiekcie [google.apps.docs.v1.EmbeddedBorderObject.dash_style].

propertyStateSuggested

boolean

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 (SheetsChartReferenceSuggestionState)
  }
}
Pola
sheetsChartReferenceSuggestionState

object (SheetsChartReferenceSuggestionState)

Maska wskazująca, które pola w elementach sheetsChartReference zostały zmienione w tej propozycji.

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
spreadsheetIdSuggested

boolean

Wskazuje, czy zasugerowano zmianę na spreadsheetId.

chartIdSuggested

boolean

Wskazuje, czy zasugerowano zmianę na chartId.

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 (PositionedObjectProperties)
  },
  "suggestedPositionedObjectPropertiesChanges": {
    string: {
      object (SuggestedPositionedObjectProperties)
    },
    ...
  },
  "suggestedInsertionId": string,
  "suggestedDeletionIds": [
    string
  ]
}
Pola
objectId

string

Identyfikator tego obiektu.

positionedObjectProperties

object (PositionedObjectProperties)

Właściwości tego obiektu.

suggestedPositionedObjectPropertiesChanges

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

Sugerowane zmiany właściwości obiektów umieszczonych, z kluczem identyfikatora sugestii.

suggestedInsertionId

string

Sugerowany identyfikator wstawienia. Jeśli jest puste, nie jest to sugerowane wstawienie.

suggestedDeletionIds[]

string

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 (PositionedObjectPositioning)
  },
  "embeddedObject": {
    object (EmbeddedObject)
  }
}
Pola
positioning

object (PositionedObjectPositioning)

Pozycjonowanie tego obiektu względem znaku nowej linii w elemencie Paragraph, który odwołuje się do tego obiektu.

embeddedObject

object (EmbeddedObject)

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 (PositionedObjectLayout),
  "leftOffset": {
    object (Dimension)
  },
  "topOffset": {
    object (Dimension)
  }
}
Pola
layout

enum (PositionedObjectLayout)

Układ tego umieszczonego obiektu.

leftOffset

object (Dimension)

Przesunięcie lewej krawędzi umieszczonego obiektu względem początku Paragraph, do którego jest przywiązany. Dokładne pozycjonowanie obiektu może zależeć od innych treści w dokumencie i jego stylizacji.

topOffset

object (Dimension)

Przesunięcie górnej krawędzi obiektu względem początku Paragraph, do którego jest przywiązany. Dokładne pozycjonowanie obiektu może zależeć od innych treści w dokumencie i jego stylizacji.

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 (PositionedObjectProperties)
  },
  "positionedObjectPropertiesSuggestionState": {
    object (PositionedObjectPropertiesSuggestionState)
  }
}
Pola
positionedObjectProperties

object (PositionedObjectProperties)

PositionedObjectProperties, który zawiera tylko zmiany wprowadzone w tej propozycji. Możesz go używać razem z przyciskiem positionedObjectPropertiesSuggestionState, aby sprawdzić, które pola się zmieniły i jakie mają teraz wartości.

positionedObjectPropertiesSuggestionState

object (PositionedObjectPropertiesSuggestionState)

Maska wskazująca, które pola w podstawowym PositionedObjectProperties zostały zmienione w tej propozycji.

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 (PositionedObjectPositioningSuggestionState)
  },
  "embeddedObjectSuggestionState": {
    object (EmbeddedObjectSuggestionState)
  }
}
Pola
positioningSuggestionState

object (PositionedObjectPositioningSuggestionState)

Maska wskazująca, które pola w elementach positioning zostały zmienione w tej propozycji.

embeddedObjectSuggestionState

object (EmbeddedObjectSuggestionState)

Maska wskazująca, które pola w elementach embeddedObject zostały zmienione w tej propozycji.

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
layoutSuggested

boolean

Wskazuje, czy zasugerowano zmianę na layout.

leftOffsetSuggested

boolean

Wskazuje, czy zasugerowano zmianę na leftOffset.

topOffsetSuggested

boolean

Wskazuje, czy zasugerowano zmianę na topOffset.

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

batchUpdate

Wprowadza co najmniej 1 zmianę w dokumencie.

create

Tworzy pusty dokument z tytułem podanym w żądaniu.

get

Pobiera najnowszą wersję określonego dokumentu.