REST Resource: documents

Zasób: Document

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 będące częścią dokumentu.

Karty mogą zawierać karty podrzędne, czyli karty zagnieżdżone w innych kartach. Karty podrzędne są reprezentowane przez pole Tab.childTabs.

revisionId

string

Tylko dane wyjściowe. Identyfikator wersji dokumentu. Można go używać w żądaniach aktualizacji, aby określić, do której wersji dokumentu mają zostać zastosowane aktualizacje i jak powinno działać żądanie, jeśli dokument był edytowany od czasu wprowadzenia tej wersji. To pole jest wypełniane tylko wtedy, gdy użytkownik ma uprawnienia do edycji dokumentu.

Identyfikator wersji nie jest liczbą sekwencyjną, ale nieprzezroczystym ciągiem. Format identyfikatora wersji może się z czasem zmienić. Gwarantujemy, że zwrócony identyfikator wersji będzie ważny tylko przez 24 godziny po zwróceniu i nie będzie można go udostępniać użytkownikom. Jeśli identyfikator wersji nie zmienia się między wywołaniami, dokument nie został zmieniony. Jeśli natomiast zmienisz identyfikator (tego samego dokumentu i tego samego użytkownika), zwykle oznacza to, że dokument został zaktualizowany. Jednak zmiana identyfikatora może wynikać z czynników wewnętrznych, takich jak zmiana formatu identyfikatora.

suggestionsViewMode

enum (SuggestionsViewMode)

Tylko dane wyjściowe. Tryb widoku sugestii zastosowany do dokumentu.

Uwaga: podczas edytowania dokumentu zmiany muszą być wprowadzone w dokumencie z atrybutem SUGGESTIONS_INLINE.

body

object (Body)

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

Starsza wersja pola: zamiast tego użyj pola Document.tabs.documentTab.body, które udostępnia rzeczywistą zawartość dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli zasada ma wartość false lub jest nieskonfigurowana, to pole zawiera informacje o pierwszej karcie w dokumencie.

headers

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

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

Starsza wersja pola: zamiast tego użyj pola Document.tabs.documentTab.headers, które udostępnia rzeczywistą zawartość dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli zasada ma wartość false lub jest nieskonfigurowana, to pole zawiera informacje o pierwszej karcie w dokumencie.

footers

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

Tylko dane wyjściowe. Stopki w dokumencie, pogrupowane według identyfikatora stopki.

Starsza wersja pola: zamiast tego użyj pola Document.tabs.documentTab.footers, które udostępnia rzeczywistą zawartość dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli zasada ma wartość false lub jest nieskonfigurowana, to pole zawiera informacje o pierwszej karcie w dokumencie.

footnotes

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

Tylko dane wyjściowe. Przypisy w dokumencie przypisane do klucza identyfikatora przypisu.

Starsza wersja pola: zamiast tego użyj pola Document.tabs.documentTab.footnotes, które udostępnia rzeczywistą zawartość dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli zasada ma wartość false lub jest nieskonfigurowana, to pole zawiera informacje o pierwszej karcie w dokumencie.

documentStyle

object (DocumentStyle)

Tylko dane wyjściowe. Styl dokumentu.

Starsza wersja pola: zamiast tego użyj pola Document.tabs.documentTab.documentStyle, które udostępnia rzeczywistą zawartość dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli zasada ma wartość false lub jest nieskonfigurowana, to pole zawiera informacje o pierwszej karcie w dokumencie.

suggestedDocumentStyleChanges

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

Tylko dane wyjściowe. Sugerowane zmiany stylu dokumentu oparte na identyfikatorze sugestii.

Starsza wersja pola: zamiast tego użyj pola Document.tabs.documentTab.suggestedDocumentStyleChanges, które udostępnia rzeczywistą zawartość dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli zasada ma wartość false lub jest nieskonfigurowana, to pole zawiera informacje o pierwszej karcie w dokumencie.

namedStyles

object (NamedStyles)

Tylko dane wyjściowe. Nazwane style dokumentu.

Starsza wersja pola: zamiast tego użyj pola Document.tabs.documentTab.namedStyles, które udostępnia rzeczywistą zawartość dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli zasada ma wartość false lub jest nieskonfigurowana, to pole zawiera informacje o pierwszej karcie w dokumencie.

suggestedNamedStylesChanges

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

Tylko dane wyjściowe. Sugerowane zmiany w nazwanych stylach dokumentu bazujących na identyfikatorze sugestii.

Starsza wersja pola: zamiast tego użyj pola Document.tabs.documentTab.suggestedNamedStylesChanges, które udostępnia rzeczywistą zawartość dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli zasada ma wartość false lub jest nieskonfigurowana, to pole zawiera informacje o pierwszej karcie w dokumencie.

lists

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

Tylko dane wyjściowe. Listy w dokumencie z zastosowaniem identyfikatora listy.

Starsza wersja pola: zamiast tego użyj pola Document.tabs.documentTab.lists, które udostępnia rzeczywistą zawartość dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli zasada ma wartość false lub jest nieskonfigurowana, to pole zawiera informacje o pierwszej karcie w dokumencie.

namedRanges

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

Tylko dane wyjściowe. Zakresy nazwane w dokumencie z kluczem według nazwy.

Starsza wersja pola: zamiast tego użyj pola Document.tabs.documentTab.namedRanges, które udostępnia rzeczywistą zawartość dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli zasada ma wartość false lub jest nieskonfigurowana, to pole zawiera informacje o pierwszej karcie w dokumencie.

inlineObjects

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

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

Starsza wersja pola: zamiast tego użyj pola Document.tabs.documentTab.inlineObjects, które udostępnia rzeczywistą zawartość dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli zasada ma wartość false lub jest nieskonfigurowana, to pole zawiera informacje o pierwszej karcie w dokumencie.

positionedObjects

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

Tylko dane wyjściowe. Pozycjonowane obiekty w dokumencie z kluczem według identyfikatora obiektu.

Starsza wersja pola: zamiast tego użyj pola Document.tabs.documentTab.positionedObjects, które udostępnia rzeczywistą zawartość dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli zasada ma wartość false lub jest nieskonfigurowana, 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 zagnieżdżone w tej karcie.

Pole sumy content. Zawartość karty. content może mieć tylko jedną z tych wartości:
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. Pusta, jeśli bieżąca karta jest kartą główną, co oznacza, że nie ma na niej żadnych elementów nadrzędnych.

index

integer

Indeks karty w obrębie elementu nadrzędnego liczony od zera.

nestingLevel

integer

Tylko dane wyjściowe. Głębokość karty w dokumencie. Karty na poziomie głównym zaczynają się od 0.

DocumentTab

Karta z zawartoś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 treść karty dokumentu.

headers

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

Nagłówki na karcie dokumentu z kluczem według identyfikatora nagłówka.

footers

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

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

footnotes

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

Przypisy na karcie dokumentu z kluczami według identyfikatora przypisu.

documentStyle

object (DocumentStyle)

Styl karty dokumentu.

suggestedDocumentStyleChanges

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

Sugerowane zmiany stylu karty dokumentu oparte na identyfikatorze sugestii.

namedStyles

object (NamedStyles)

Nazwane style karty dokumentu.

suggestedNamedStylesChanges

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

Sugerowane zmiany w nazwanych stylach karty dokumentu z zastosowaniem identyfikatora sugestii.

lists

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

Listy na karcie dokumentów pogrupowane według identyfikatora listy.

namedRanges

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

Zakresy nazwane na karcie dokumentu z kluczami według nazwy.

inlineObjects

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

Obiekty wbudowane na karcie dokumentu z kluczem według identyfikatora obiektu.

positionedObjects

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

Pozycjonowane obiekty na karcie dokumentu z kluczami według identyfikatora obiektu.

Treść

Treść dokumentu.

Treść zwykle zawiera pełną zawartość dokumentu z wyjątkiem pól headers, footers i footnotes.

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

object (StructuralElement)

Zawartość ciała.

Indeksy treści treści zaczynają się od zera.

StructuralElement

Element StructuralElement opisuje treść, która nadaje dokumentowi strukturę.

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 zera w jednostkach kodu UTF-16.

endIndex

integer

Indeks końcowy liczony od zera dla tego elementu strukturalnego w jednostkach kodu UTF-16 (wyłącznie).

Pole sumy content. Zawartość elementu strukturalnego. content może mieć tylko jedną z tych wartości:
paragraph

object (Paragraph)

Typ akapitu elementu strukturalnego.

sectionBreak

object (SectionBreak)

Typ podziału sekcji w elemencie strukturalnym.

table

object (Table)

Typ tabeli elementu strukturalnego.

tableOfContents

object (TableOfContents)

Typ spisu treści elementu strukturalnego.

Akapit

Znak StructuralElement reprezentujący akapit. Akapit to zakres treści, który jest 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))

Sugerowany styl akapitu zostanie zmieniony w tym akapicie z zastosowaniem identyfikatora sugestii.

bullet

object (Bullet)

Punktor tego akapitu. Jeśli akapit nie istnieje, oznacza to, że nie należy do listy.

suggestedBulletChanges

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

Sugerowane zmiany w punkcie tego akapitu.

positionedObjectIds[]

string

Identyfikatory pozycji ustawionych obiektów powiązanych z tym akapitem.

suggestedPositionedObjectIds

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

Identyfikatory pozycjonowanych obiektów, które powinny zostać dołączone do tego akapitu, przypisane do identyfikatora sugestii.

ParagraphElement

Element ParagraphElement opisuje treść w elemencie 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 o zerowej podstawie elementu akapitu (wyłącznie) w jednostkach kodu UTF-16.

Pole sumy content. Zawartość elementu akapitu. content może mieć tylko jedną z tych wartości:
textRun

object (TextRun)

Element akapitu uruchomienia tekstu.

autoText

object (AutoText)

Element automatycznego tekstu akapitu.

pageBreak

object (PageBreak)

Element akapitu podziału strony.

columnBreak

object (ColumnBreak)

Element akapitu podziału kolumny.

footnoteReference

object (FootnoteReference)

Element akapitu z odwołaniem do przypisu.

horizontalRule

object (HorizontalRule)

Element akapitu z linijką poziomą.

equation

object (Equation)

Element równania akapitu.

inlineObjectElement

object (InlineObjectElement)

Wbudowany element akapitu obiektu.

person

object (Person)

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

TextRun

ParagraphElement reprezentujący cały tekst o tym samym stylu.

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

string

Tekst tego uruchomienia.

Podczas uruchomienia wszystkie elementy inne niż tekstowe są zastępowane znakiem Unicode U+E907.

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

Identyfikatory sugerowanego usunięcia. Jeśli pole jest puste, nie są sugerowane usunięcia treści.

textStyle

object (TextStyle)

Styl tekstu tego uruchomienia.

suggestedTextStyleChanges

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

Sugerowany styl tekstu zmieni się w tym uruchomieniu na podstawie identyfikatora sugestii.

Styl tekstu

Reprezentuje styl, który można zastosować do tekstu.

Odziedziczone style tekstu są w tej wiadomości reprezentowane jako pola nieskonfigurowane. Element nadrzędny stylu tekstu zależy od tego, gdzie został zdefiniowany:

  • Styl tekstu w polu Paragraph dziedziczy z odpowiedniego elementu named style type akapitu.
  • Element TextStyle w elemencie named style dziedziczy styl nazwany normal text.
  • Styl TextStyle w stylu nazwanym normal text jest dziedziczony z domyślnego stylu tekstu w edytorze Dokumentów.
  • Styl TextStyle w elemencie Paragraph zawartym w tabeli może dziedziczyć styl tekstu ze stylu tabeli.

Jeśli styl tekstu nie jest dziedziczony z elementu nadrzędnego, usunięcie ustawień w polach 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ć pogrubiony.

italic

boolean

Wskazuje, czy tekst jest pisany kursywą.

underline

boolean

Określa, czy tekst jest podkreślony.

strikethrough

boolean

Określa, czy tekst jest przekreślony.

smallCaps

boolean

Określa, czy tekst został zapisany małymi literami.

backgroundColor

object (OptionalColor)

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

foregroundColor

object (OptionalColor)

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

fontSize

object (Dimension)

Rozmiar czcionki tekstu.

weightedFontFamily

object (WeightedFontFamily)

Rodzina czcionek i wyrenderowana grubość tekstu.

Jeśli żądanie aktualizacji zawiera wartości zarówno weightedFontFamily, jak i bold, stosowana jest najpierw zasada weightedFontFamily, a potem bold.

Jeśli zasada weightedFontFamily#weight jest nieskonfigurowana, domyślna wartość to 400.

Jeśli ustawiono weightedFontFamily, wartość weightedFontFamily#fontFamily musi też być ustawiona na wartość, która nie jest pusta. W przeciwnym razie zwracany jest błąd 400 nieprawidłowego żądania.

baselineOffset

enum (BaselineOffset)

Przesunięcie tekstu w pionie względem jego normalnej pozycji.

Tekst z przesunięciem punktu odniesienia SUPERSCRIPT lub SUBSCRIPT jest automatycznie renderowany z mniejszym rozmiarem czcionki obliczonym na podstawie pola fontSize. Zmiany wprowadzone w tym polu nie mają wpływu na fontSize.

OptionalColor

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

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

object (Color)

Jeśli zostanie ustawiony, będzie używany jako kolor nieprzezroczysty. Jeśli nie jest ustawiona, kolor jest przezroczysty.

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ładnik koloru koloru z zakresu od 0,0 do 1,0.

green

number

Składnik koloru zielonego w zakresie od 0,0 do 1,0.

blue

number

Składnik koloru niebieskiego z zakresu 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 Czcionka w Dokumentach lub z Google Fonts. Jeśli nazwa czcionki nie zostanie rozpoznana, tekst będzie renderowany w języku Arial.

weight

integer

Grubość czcionki. To pole może mieć dowolną wartość, która jest wielokrotnością 100 z zakresu 100900 włącznie. Ten zakres odpowiada wartościom liczbowym opisanym w specyfikacji CSS 2.1 w sekcji 15.6 (przy czym wartości nieliczbowe są niedozwolone).

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

Grubość czcionki to tylko jeden z komponentów renderowanej czcionki. Kombinacja wartości weight i ustalonej wartości bold w stylu tekstu określa renderowaną wagę po uwzględnieniu dziedziczenia:

  • Jeśli tekst jest pogrubiony, a waga jest mniejsza niż 400, renderowana waga będzie wynosić 400.
  • Jeśli tekst jest pogrubiony, a waga jest większa lub równa 400, ale mniejsza niż 700, renderowana waga będzie wynosić 700.
  • Jeśli waga jest większa lub równa 700, renderowana waga jest równa jej.
  • Jeśli tekst nie jest pogrubiony, renderowana waga jest równa wagi.

BaselineOffset

Możliwości odsunięcia tekstu w pionie od jego normalnego położenia.

Wartości w polu enum
BASELINE_OFFSET_UNSPECIFIED Przesunięcie punktu odniesienia dla tekstu jest dziedziczone z elementu nadrzędnego.
NONE Tekst nie jest przesunięty w pionie.
SUPERSCRIPT Tekst jest przesunięty w pionie w górę (indeks górny).
SUBSCRIPT Tekst jest przesunięty pionowo w dół (indeks dolny).

SuggestedTextStyle

Sugerowana zmiana w: TextStyle.

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

object (TextStyle)

TextStyle, który zawiera tylko zmiany wprowadzone w tej sugestii. Tego pola możesz użyć razem z atrybutem textStyleSuggestionState, aby sprawdzić, które pola uległy zmianie i ich nowe wartości.

textStyleSuggestionState

object (TextStyleSuggestionState)

Maska wskazująca, które pola na podstawie TextStyle zostały zmienione w tej sugestii.

TextStyleSuggestionState

Maska wskazująca, które pola na podstawie TextStyle zostały zmienione w tej sugestii. Dla każdego pola z wartością true (prawda) pojawi się nowa wartość sugerowana.

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 została sugerowana zmiana w tym polu: bold.

italicSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: italic.

underlineSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: underline.

strikethroughSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: strikethrough.

smallCapsSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: smallCaps.

backgroundColorSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: backgroundColor.

foregroundColorSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: foregroundColor.

fontSizeSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: fontSize.

weightedFontFamilySuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: weightedFontFamily.

baselineOffsetSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: baselineOffset.

AutoText

Pole ParagraphElement reprezentujące miejsce w tekście, które jest dynamicznie zastępowane treścią, która może się zmieniać z czasem, np. numerem strony.

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

enum (Type)

Typ tego automatycznego tekstu.

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

Identyfikatory sugerowanego usunięcia. Jeśli pole jest puste, nie są sugerowane usunięcia treści.

textStyle

object (TextStyle)

Styl tekstu tego automatycznego tekstu.

suggestedTextStyleChanges

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

Sugerowany styl tekstu zostanie zmieniony na podstawie identyfikatora sugestii.

Typ

Rodzaje tekstu automatycznego.

Wartości w polu enum
TYPE_UNSPECIFIED Nieokreślony typ automatycznego tekstu.
PAGE_NUMBER Wpisz tekst automatyczny reprezentujący numer bieżącej strony.
PAGE_COUNT Wpisz tekst automatyczny reprezentujący łączną liczbę stron w dokumencie.

PageBreak

Element ParagraphElement reprezentujący podział strony. Podział strony powoduje, że następny tekst znajduje się na górze następnej strony.

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

string

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

suggestedDeletionIds[]

string

Identyfikatory sugerowanego usunięcia. Jeśli pole jest puste, nie są sugerowane usunięcia treści.

textStyle

object (TextStyle)

Styl tekstu tego podziału strony.

Styl tekstu podziału strony może wpływać na układ treści oraz na styl tekstu wstawionego w sąsiedztwie.

suggestedTextStyleChanges

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

Sugerowany styl tekstu zmienia się w tym podziałie strony według identyfikatora sugestii.

ColumnBreak

ParagraphElement reprezentujący podział kolumny. Podział kolumny powoduje, że następny tekst zaczyna się od góry następnej kolumny.

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

string

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

suggestedDeletionIds[]

string

Identyfikatory sugerowanego usunięcia. Jeśli pole jest puste, nie są sugerowane usunięcia treści.

textStyle

object (TextStyle)

Styl tekstu tego podziału kolumny.

Styl tekstu podziału kolumny może wpływać na układ treści, a także na styl tekstu wstawionego w sąsiedztwie tekstu, podobnie jak w przypadku fragmentów tekstu i odwołań do przypisów.

suggestedTextStyleChanges

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

Sugerowany styl tekstu zmieni się na ten podział kolumny według identyfikatora sugestii.

FootnoteReference

Element ParagraphElement reprezentujący odwołanie do przypisu. Odwołanie do przypisu to wbudowana treść renderowana za pomocą liczby, która służy do identyfikowania przypisu.

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

string

Identyfikator elementu footnote, który zawiera treść tego odwołania do przypisu.

footnoteNumber

string

Wyrenderowany numer tego przypisu.

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

Identyfikatory sugerowanego usunięcia. Jeśli pole jest puste, nie są sugerowane usunięcia treści.

textStyle

object (TextStyle)

Styl tekstu tego przypisu do przypisu.

suggestedTextStyleChanges

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

Sugerowany styl tekstu zmienia się w przypisie do przypisu, którego jest kluczem według identyfikatora sugestii.

HorizontalRule

ParagraphElement reprezentujący linię poziomą.

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

string

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

suggestedDeletionIds[]

string

Identyfikatory sugerowanego usunięcia. Jeśli pole jest puste, nie są sugerowane usunięcia treści.

textStyle

object (TextStyle)

Styl tekstu tej reguły poziomej.

Podobnie jak w przypadku zawartości tekstowej, np. przebiegi tekstu i odwołania do przypisów, styl tekstu linii poziomej może wpływać na układ treści, a także na styl tekstu wstawionego obok.

suggestedTextStyleChanges

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

Sugerowany styl tekstu zostanie zmieniony w tej regule poziomej, a ich klucz będzie zależeć od identyfikatora sugestii.

Równanie

ParagraphElement reprezentujące równanie.

Zapis JSON
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ]
}
Pola
suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

Identyfikatory sugerowanego usunięcia. Jeśli pole jest puste, nie są sugerowane usunięcia treści.

InlineObjectElement

Pole ParagraphElement zawierające InlineObject.

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

string

Identyfikator elementu InlineObject, który zawiera ten element.

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

Identyfikatory sugerowanego usunięcia. Jeśli pole jest puste, nie są sugerowane usunięcia treści.

textStyle

object (TextStyle)

Styl tekstu tego InlineObjectElement.

Styl tekstu wbudowanego elementu obiektu może wpływać na układ treści oraz na styl tekstu wstawionego obok niego, podobnie jak w przypadku zawartości tekstowej, np. przebiegi tekstu i odwołania do przypisów.

suggestedTextStyleChanges

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

Sugerowany styl tekstu zostanie zmieniony na ten obiekt InlineObject z kluczami według identyfikatora sugestii.

Osoba

Osoba lub adres e-mail wspomniany w dokumencie. Te wzmianki to jeden, trwały element zawierający imię i nazwisko lub adres e-mail danej 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 linku.

suggestedInsertionIds[]

string

Identyfikatory sugestii wstawiania do dokumentu linku do tej osoby. Element Person może mieć wiele identyfikatorów wstawiania, jeśli jest to zagnieżdżona sugerowana zmiana (np. sugestia w ramach sugestii wprowadzonej przez innego użytkownika). Jeśli pole jest puste, link do tej osoby nie jest sugerowanym wstawieniem.

suggestedDeletionIds[]

string

Identyfikatory sugestii usuwania linku tej osoby z dokumentu. Element Person może mieć wiele identyfikatorów usunięcia, jeśli na przykład wielu użytkowników zaproponuje jego usunięcie. Jeśli pole jest puste, link do tej osoby nie jest sugerowany do usunięcia.

textStyle

object (TextStyle)

Styl tekstu tego elementu (Person).

suggestedTextStyleChanges

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

Sugerowany styl tekstu zmieni się na ten element Person w zależności od identyfikatora sugestii.

personProperties

object (PersonProperties)

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

PersonProperties

Usługi związane z połączonym kontem 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, a nie w adresie e-mail tej osoby.

email

string

Tylko dane wyjściowe. Adres e-mail połączony z urządzeniem Person. To pole jest zawsze obecne.

RichLinkProperties

Właściwości charakterystyczne dla danego elementu: RichLink.

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

string

Tylko dane wyjściowe. Tytuł elementu RichLink wyświetlany w linku. Ten tytuł jest zgodny z tytułem połączonego zasobu w momencie wstawiania lub ostatniej aktualizacji linku. To pole jest zawsze obecne.

uri

string

Tylko dane wyjściowe. Identyfikator URI obiektu RichLink. Ta wartość jest zawsze dostępna.

mimeType

string

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

Styl akapitu

Style stosowane do całego akapitu.

W tej wiadomości dziedziczone style akapitu są reprezentowane jako nieskonfigurowane pola. Element nadrzędny stylu akapitu zależy od tego, gdzie zdefiniowany jest styl akapitu:

  • Styl akapitu w elemencie Paragraph dziedziczy z odpowiedniego named style type akapitu.
  • Styl akapitu w elemencie named style dziedziczy styl nazwany normal text.
  • Styl akapitu normal text jest dziedziczony z domyślnego stylu akapitu w edytorze Dokumentów.
  • Styl akapitu w elemencie Paragraph zawartym w tabeli może dziedziczyć styl akapitu ze stylu tabeli.

Jeśli styl akapitu nie jest dziedziczony z elementu nadrzędnego, usunięcie ustawień w polach spowoduje przywrócenie stylu do wartości domyślnych 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 ten akapit jest pusty, nie jest nagłówkiem.

Ta właściwość jest tylko do odczytu.

namedStyleType

enum (NamedStyleType)

Nazwany typ stylu akapitu.

Ponieważ aktualizacja nazwanego typu stylu wpływa na inne właściwości w elemencie ParagraphStyle, nazwany typ stylu jest stosowany przed aktualizacją pozostałych właściwości.

alignment

enum (Alignment)

Wyrównanie tekstu w tym akapicie.

lineSpacing

number

Odstęp między wierszami wyrażony jako procent normalnej wartości, gdzie norma jest przedstawiona jako 100, 0. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.

direction

enum (ContentDirection)

Kierunek tekstu w tym akapicie. Jeśli nie jest skonfigurowana, domyślnie przyjmuje się wartość LEFT_TO_RIGHT, ponieważ kierunek akapitu nie jest dziedziczony.

spacingMode

enum (SpacingMode)

Tryb odstępów w akapicie.

spaceAbove

object (Dimension)

Ilość dodatkowego miejsca nad akapitem. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.

spaceBelow

object (Dimension)

Ilość dodatkowego miejsca pod akapitem. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.

borderBetween

object (ParagraphBorder)

Obramowanie tego akapitu z następnym i poprzednim akapitem. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.

Obramowanie wewnętrzne jest renderowane, gdy sąsiedni akapit ma te same właściwości obramowania i wcięcia.

Nie można częściowo zaktualizować obramowania akapitu. Przy zmianie obramowania akapitu nowe obramowanie musi być w całości określone.

borderTop

object (ParagraphBorder)

Obramowanie u góry tego akapitu. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.

Obramowanie górne jest renderowane, gdy powyższy akapit ma inne właściwości obramowania i wcięcia.

Nie można częściowo zaktualizować obramowania akapitu. Przy zmianie obramowania akapitu nowe obramowanie musi być w całości określone.

borderBottom

object (ParagraphBorder)

Obramowanie na dole tego akapitu. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.

Obramowanie dolne jest renderowane, gdy poniższy akapit ma inne właściwości obramowania i wcięcia.

Nie można częściowo zaktualizować obramowania akapitu. Przy zmianie obramowania akapitu nowe obramowanie musi być w całości określone.

borderLeft

object (ParagraphBorder)

Obramowanie po lewej stronie tego akapitu. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.

Nie można częściowo zaktualizować obramowania akapitu. Przy zmianie obramowania akapitu nowe obramowanie musi być w całości określone.

borderRight

object (ParagraphBorder)

Obramowanie z prawej strony tego akapitu. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.

Nie można częściowo zaktualizować obramowania akapitu. Przy zmianie obramowania akapitu nowe obramowanie musi być w całości określone.

indentFirstLine

object (Dimension)

Wielkość wcięcia pierwszego wiersza akapitu. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.

indentStart

object (Dimension)

Wielkość wcięcia akapitu z boku, która odpowiada początkowi tekstu, w zależności od bieżącego kierunku akapitu. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.

indentEnd

object (Dimension)

Wielkość wcięcia akapitu z boku, która odpowiada końcu tekstu, w zależności od bieżącego kierunku akapitu. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.

tabStops[]

object (TabStop)

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

Ta właściwość jest tylko do odczytu.

keepLinesTogether

boolean

Określa, czy wszystkie wiersze akapitu powinny być w miarę możliwości umieszczone na tej samej stronie lub tej samej kolumnie. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.

keepWithNext

boolean

Określa, czy co najmniej część tego akapitu powinna zostać ułożona na tej samej stronie lub w tej samej kolumnie co następny akapit, jeśli to możliwe. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.

avoidWidowAndOrphan

boolean

Określa, czy w akapicie unikać wd i sierot. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.

shading

object (Shading)

Cieniowanie akapitu. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.

pageBreakBefore

boolean

Określa, czy bieżący akapit zawsze powinien zaczynać się na początku strony. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.

Próba zaktualizowania pola pageBreakBefore w akapitach w nieobsługiwanych regionach (np. Table, Header, Footer i Footnote) może spowodować zwrócenie nieprawidłowego stanu dokumentu i zwrócenie błędu 400.

NamedStyleType

Typy stylów nazwanych.

Wartości w polu enum
NAMED_STYLE_TYPE_UNSPECIFIED Typ stylu nazwanego jest nieokreślony.
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 przejmowane z elementu nadrzędnego.
START Akapit jest wyrównany do początku wiersza. Wyrównanie do lewej w przypadku tekstu LTR, w przeciwnym razie wyrównanie do prawej.
CENTER Akapit jest wyśrodkowany.
END Akapit jest wyrównany do końca wiersza. Wyrównanie do prawej w przypadku tekstu LTR, w przeciwnym razie wyrównanie do lewej.
JUSTIFIED Akapit jest uzasadniony.

ContentDirection

Kierunki, przez które może napływać treść,

Wartości w polu enum
CONTENT_DIRECTION_UNSPECIFIED Kierunek treści nie jest określony.
LEFT_TO_RIGHT Treść idzie od lewej do prawej.
RIGHT_TO_LEFT Treść idzie od prawej do lewej.

SpacingMode

Różne tryby odstępów między akapitami.

Wartości w polu enum
SPACING_MODE_UNSPECIFIED Tryb odstępów jest dziedziczony z elementu nadrzędnego.
NEVER_COLLAPSE Odstępy między akapitami są zawsze renderowane.
COLLAPSE_LISTS Odstępy między akapitami są pomijane.

ParagraphBorder

Obramowanie wokół 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)

Dopełnienie obramowania.

dashStyle

enum (DashStyle)

Styl obramowania.

DashStyle

Rodzaje myślników, które umożliwiają renderowanie geometrii liniowej. Te wartości są oparte na: „ST_PresetLineDashVal” prosty typ opisany w sekcji 20.1.10.48 dokumentu „Office Open XML File Formats - Fundamentals and Markup Language Reference” (Podstawowe informacje o formatach plików pakietu Office – informacje i znaczniki języka), część 1 ECMA-376 4th edition.

Wartości w polu enum
DASH_STYLE_UNSPECIFIED Nieokreślony styl kreski.
SOLID Linia ciągła. Odpowiada wartości „solid” standardu ECMA-376 ST_PresetLineDashVal. To jest domyślny styl kreski.
DOT Linia kropkowana. Odpowiada wartości „kropka” standardu ECMA-376 ST_PresetLineDashVal.
DASH Linia przerywana. Odpowiada wartości „dash” (dash) ECMA-376 ST_PresetLineDashVal.

TabStop

Tabulator w akapicie.

Zapis JSON
{
  "offset": {
    object (Dimension)
  },
  "alignment": enum (TabStopAlignment)
}
Pola
offset

object (Dimension)

Przesunięcie między tym punktem tabulacji a marginesem początkowym.

alignment

enum (TabStopAlignment)

Przystanek wyrównywania tej karty. Jeśli nie jest skonfigurowana, domyślna wartość to START.

TabStopAlignment

Wyrównanie tabulatora.

Wartości w polu enum
TAB_STOP_ALIGNMENT_UNSPECIFIED Wyrównanie zatrzymania karty jest nieokreślone.
START Tabulator zostanie wyrównany do początku wiersza. Jest to ustawienie domyślne.
CENTER Tabulator zostanie wyrównany do środka linii.
END Tabulator jest wyrównany do końca wiersza.

Cieniowanie

Cieniowanie akapitu.

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

object (OptionalColor)

Kolor tła tego cieniowania akapitu.

SuggestedParagraphStyle

Sugerowana zmiana w: ParagraphStyle.

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

object (ParagraphStyle)

ParagraphStyle, który zawiera tylko zmiany wprowadzone w tej sugestii. Tego pola możesz użyć razem z atrybutem paragraphStyleSuggestionState, aby sprawdzić, które pola uległy zmianie i ich nowe wartości.

paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

Maska wskazująca, które pola na podstawie ParagraphStyle zostały zmienione w tej sugestii.

ParagraphStyleSuggestionState

Maska wskazująca, które pola na podstawie ParagraphStyle zostały zmienione w tej sugestii. Dla każdego pola z wartością true (prawda) pojawi się nowa wartość sugerowana.

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 została sugerowana zmiana w tym polu: headingId.

namedStyleTypeSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: namedStyleType.

alignmentSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: alignment.

lineSpacingSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: lineSpacing.

directionSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: direction.

spacingModeSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: spacingMode.

spaceAboveSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: spaceAbove.

spaceBelowSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: spaceBelow.

borderBetweenSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: borderBetween.

borderTopSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: borderTop.

borderBottomSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: borderBottom.

borderLeftSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: borderLeft.

borderRightSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: borderRight.

indentFirstLineSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: indentFirstLine.

indentStartSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: indentStart.

indentEndSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: indentEnd.

keepLinesTogetherSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: keepLinesTogether.

keepWithNextSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: keepWithNext.

avoidWidowAndOrphanSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: avoidWidowAndOrphan.

shadingSuggestionState

object (ShadingSuggestionState)

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

pageBreakBeforeSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: pageBreakBefore.

ShadingSuggestionState

Maska wskazująca, które z pól na podstawie Shading zostały zmienione w ramach tej sugerowanej zmiany. Dla każdego pola z wartością true (prawda) pojawi się nowa wartość sugerowana.

Zapis JSON
{
  "backgroundColorSuggested": boolean
}
Pola
backgroundColorSuggested

boolean

Wskazuje, czy została sugerowana zmiana w elemencie Shading.

Punktor

Opisuje punktor 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 akapitu zastosowany do tego punktu.

SuggestedBullet

Sugerowana zmiana w: Bullet.

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

object (Bullet)

Bullet, który zawiera tylko zmiany wprowadzone w tej sugestii. Tego pola możesz użyć razem z atrybutem bulletSuggestionState, aby sprawdzić, które pola uległy zmianie i ich nowe wartości.

bulletSuggestionState

object (BulletSuggestionState)

Maska wskazująca, które pola na podstawie Bullet zostały zmienione w tej sugestii.

BulletSuggestionState

Maska wskazująca, które pola na podstawie Bullet zostały zmienione w tej sugestii. Dla każdego pola z wartością true (prawda) pojawi się nowa wartość sugerowana.

Zapis JSON
{
  "listIdSuggested": boolean,
  "nestingLevelSuggested": boolean,
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  }
}
Pola
listIdSuggested

boolean

Wskazuje, czy została sugerowana zmiana w elemencie listId.

nestingLevelSuggested

boolean

Wskazuje, czy została sugerowana zmiana w elemencie nestingLevel.

textStyleSuggestionState

object (TextStyleSuggestionState)

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

ObjectReferences

Kolekcja identyfikatorów obiektów.

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

string

Identyfikatory obiektów.

SectionBreak

StructuralElement reprezentujący podział sekcji. Sekcja to zakres treści o tych samych parametrach SectionStyle. Podział sekcji to początek nowej sekcji, a jego styl ma zastosowanie do sekcji po nim.

Treść dokumentu zawsze zaczyna się od podziału sekcji.

Zapis JSON
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "sectionStyle": {
    object (SectionStyle)
  }
}
Pola
suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

Identyfikatory sugerowanego usunięcia. Jeśli pole jest puste, nie są sugerowane usunięcia treści.

sectionStyle

object (SectionStyle)

Styl sekcji po podziale sekcji.

SectionStyle

Styl, który ma zastosowanie do 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 ta sekcja będzie pusta, sekcja będzie zawierać jedną kolumnę z domyślnymi właściwościami w edytorze Dokumentów. Sekcję można zaktualizować tak, aby zawierała maksymalnie 3 kolumny.

Podczas aktualizowania tej właściwości wymagane jest ustawienie konkretnej wartości. Wyłączenie tej właściwości spowoduje wystąpienie błędu 400 nieprawidłowego żądania.

columnSeparatorStyle

enum (ColumnSeparatorStyle)

Styl separatorów kolumn.

Ten styl można ustawić nawet wtedy, gdy sekcja zawiera tylko jedną kolumnę.

Podczas aktualizowania tej właściwości wymagane jest ustawienie konkretnej wartości. Wyłączenie tej właściwości powoduje wystąpienie błędu 400 nieprawidłowego żądania.

contentDirection

enum (ContentDirection)

Kierunek treści tej sekcji. Jeśli nie jest skonfigurowana, domyślna wartość to LEFT_TO_RIGHT.

Podczas aktualizowania tej właściwości wymagane jest ustawienie konkretnej wartości. Wyłączenie tej właściwości powoduje wystąpienie błędu 400 nieprawidłowego żądania.

marginTop

object (Dimension)

Margines górnej strony sekcji. Jeśli zasada jest nieskonfigurowana, domyślna wartość z DocumentStyle to marginTop.

Podczas aktualizowania tej właściwości wymagane jest ustawienie konkretnej wartości. Wyłączenie tej właściwości powoduje wystąpienie błędu 400 nieprawidłowego żądania.

marginBottom

object (Dimension)

Dolny margines sekcji. Jeśli zasada jest nieskonfigurowana, domyślna wartość z DocumentStyle to marginBottom.

Podczas aktualizowania tej właściwości wymagane jest ustawienie konkretnej wartości. Wyłączenie tej właściwości powoduje wystąpienie błędu 400 nieprawidłowego żądania.

marginRight

object (Dimension)

Prawy margines sekcji. Jeśli zasada jest nieskonfigurowana, domyślna wartość z DocumentStyle to marginRight. Zaktualizowanie prawego marginesu powoduje zmianę rozmiaru kolumn w tej sekcji. Margines ma wpływ na szerokość kolumny, więc jest on stosowany przed właściwościami kolumny.

Podczas aktualizowania tej właściwości wymagane jest ustawienie konkretnej wartości. Wyłączenie tej właściwości powoduje wystąpienie błędu 400 nieprawidłowego żądania.

marginLeft

object (Dimension)

Lewy margines sekcji. Jeśli zasada jest nieskonfigurowana, domyślna wartość z DocumentStyle to marginLeft. Zaktualizowanie lewego marginesu powoduje zmianę rozmiaru kolumn w tej sekcji. Margines ma wpływ na szerokość kolumny, więc jest on stosowany przed właściwościami kolumny.

Podczas aktualizowania tej właściwości wymagane jest ustawienie konkretnej wartości. Wyłączenie tej właściwości powoduje wystąpienie błędu 400 nieprawidłowego żądania.

marginHeader

object (Dimension)

Margines nagłówka sekcji. Jeśli zasada jest nieskonfigurowana, domyślna wartość z DocumentStyle to marginHeader. Po aktualizacji zasada useCustomHeaderFooterMargins ma wartość Prawda w DocumentStyle. Wartość useCustomHeaderFooterMargins w DocumentStyle wskazuje, czy w tej sekcji przestrzegany jest margines nagłówka.

Podczas aktualizowania tej właściwości wymagane jest ustawienie konkretnej wartości. Wyłączenie tej właściwości powoduje wystąpienie błędu 400 nieprawidłowego żądania.

sectionType

enum (SectionType)

Tylko dane wyjściowe. Typ sekcji.

defaultHeaderId

string

Identyfikator nagłówka domyślnego. Jeśli zasada jest nieskonfigurowana, wartość dziedziczy poprzedni styl sekcji (SectionBreak's). Jeśli wartość jest nieskonfigurowana w pierwszym podziale sekcji, jest dziedziczona z elementu defaultHeaderId w DocumentStyle.

Ta właściwość jest tylko do odczytu.

firstPageHeaderId

string

Identyfikator nagłówka używany tylko dla pierwszej strony sekcji. Jeśli useFirstPageHeaderFooter ma wartość prawda, ta wartość jest używana w nagłówku na pierwszej stronie sekcji. Jeśli ma wartość Fałsz, w nagłówku pierwszej strony sekcji jest używany nagłówek defaultHeaderId. Jeśli zasada jest nieskonfigurowana, wartość dziedziczy poprzedni styl sekcji (SectionBreak's). Jeśli wartość jest nieskonfigurowana w pierwszym podziale sekcji, jest dziedziczona z elementu firstPageHeaderId w DocumentStyle.

Ta właściwość jest tylko do odczytu.

evenPageHeaderId

string

Identyfikator nagłówka używany tylko w przypadku stron parzystych. Jeśli wartość useEvenPageHeaderFooter w DocumentStyle jest zgodna z prawdą, ta wartość jest używana w przypadku nagłówków na parzystych stronach sekcji. Jeśli ma wartość Fałsz, w nagłówkach stron parzystych jest używany atrybut defaultHeaderId. Jeśli zasada jest nieskonfigurowana, wartość dziedziczy poprzedni styl sekcji (SectionBreak's). Jeśli wartość jest nieskonfigurowana w pierwszym podziale sekcji, jest dziedziczona z elementu evenPageHeaderId w DocumentStyle.

Ta właściwość jest tylko do odczytu.

pageNumberStart

integer

Numer strony, od której ma się zacząć liczenie stron w tej sekcji. Jeśli zasada jest nieskonfigurowana, numerowanie stron jest kontynuowane od poprzedniej sekcji. Jeśli wartość nie jest ustawiona w pierwszym SectionBreak, sprawdź pageNumberStart w DocumentStyle.

Podczas aktualizowania tej właściwości wymagane jest ustawienie konkretnej wartości. Wyłączenie tej właściwości powoduje wystąpienie błędu 400 nieprawidłowego żądania.

flipPageOrientation

boolean

Opcjonalnie: Wskazuje, czy należy odwrócić wymiary elementu pageSize w DocumentStyle dla tej sekcji, co pozwala zmienić orientację strony na pionową lub poziomą. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z zasad flipPageOrientation w DocumentStyle.

Podczas aktualizowania tej właściwości wymagane jest ustawienie konkretnej wartości. Wyłączenie tej właściwości powoduje wystąpienie błędu 400 nieprawidłowego żądania.

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)

Dopełnienie na końcu kolumny.

ColumnSeparatorStyle

Styl separatorów kolumn między kolumnami.

Wartości w polu enum
COLUMN_SEPARATOR_STYLE_UNSPECIFIED Nieokreślony styl separatora kolumn.
NONE Brak separatorów kolumn między kolumnami.
BETWEEN_EACH_COLUMN Renderuje separator kolumn między poszczególnymi kolumnami.

SectionType

Określa położenie początku bieżącej sekcji względem poprzedniej.

Wartości w polu enum
SECTION_TYPE_UNSPECIFIED Typ sekcji jest nieokreślony.
CONTINUOUS Sekcja rozpoczyna się bezpośrednio po ostatnim akapicie poprzedniej sekcji.
NEXT_PAGE Sekcja zaczyna 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 nie być prostokątna, więc niektóre wiersze mogą zawierać inną liczbę komórek.

tableRows[]

object (TableRow)

zawartość i styl każdego wiersza,

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

Identyfikatory sugerowanego usunięcia. Jeśli pole jest puste, nie są sugerowane usunięcia treści.

tableStyle

object (TableStyle)

Styl tabeli.

TableRow

Zawartość i styl wiersza w tabeli 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 zera w jednostkach kodu UTF-16.

endIndex

integer

Indeks końcowy liczony od zera dla tego wiersza (wyłącznie) w jednostkach kodu UTF-16.

tableCells[]

object (TableCell)

Zawartość i styl każdej komórki w tym wierszu.

Tabela może nie być prostokątna, więc niektóre wiersze mogą zawierać inną liczbę komórek niż pozostałe wiersze w tej samej tabeli.

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

Identyfikatory sugerowanego usunięcia. Jeśli pole jest puste, nie są sugerowane usunięcia treści.

tableRowStyle

object (TableRowStyle)

Styl wiersza tabeli.

suggestedTableRowStyleChanges

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

Sugerowany styl zmienia się w tym wierszu z zastosowaniem identyfikatora sugestii.

TableCell

Zawartość i styl komórki w elemencie 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 zera w jednostkach kodu UTF-16.

endIndex

integer

Indeks końcowy liczony od zera, wyłącznie w jednostkach kodu UTF-16.

content[]

object (StructuralElement)

Zawartość komórki.

tableCellStyle

object (TableCellStyle)

Styl komórki.

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

Identyfikatory sugerowanego usunięcia. Jeśli pole jest puste, nie są sugerowane usunięcia treści.

suggestedTableCellStyleChanges

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

Sugerowane zmiany w stylu komórki tabeli oparte na identyfikatorze sugestii.

TableCellStyle

Styl produktu (TableCell).

Odziedziczone style komórek tabeli są w tej wiadomości reprezentowane jako pola nieskonfigurowane. Styl komórki tabeli może dziedziczyć 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

Rozpiętość wiersza komórki.

Ta właściwość jest tylko do odczytu.

columnSpan

integer

Rozpiętość kolumny dla komórki.

Ta właściwość 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)

Dopełnienie z lewej strony komórki.

paddingRight

object (Dimension)

Dopełnienie z prawej strony komórki.

paddingTop

object (Dimension)

Dopełnienie u góry komórki.

paddingBottom

object (Dimension)

Dopełnienie dolne komórki.

contentAlignment

enum (ContentAlignment)

Wyrównanie treści w komórce tabeli. Domyślne wyrównanie jest zgodne z wyrównaniem nowo utworzonych komórek tabeli w edytorze Dokumentów.

TableCellBorder

Obramowanie komórki tabeli.

Obramowanie komórek tabeli nie może 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 obramowania.

ContentAlignment

Typy wyrównywania treści.

Powstały na podstawie podzbioru wartości „ST_TextAnchoringType” prostego typu w sekcji 20.1.10.59 dokumentu „Office Open XML File Formats - Fundamentals and Markup Language Reference” (Podstawowe informacje o formatach plików pakietu Office Open XML – informacje i zasady dotyczące języka znaczników), część 1 ECMA-376 4th edition.

Wartości w polu enum
CONTENT_ALIGNMENT_UNSPECIFIED Nieokreślone wyrównanie treści. Wyrównanie treści jest przejmowane 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óry właściciela treści. Odpowiada ECMA-376 ST_TextAnchoringType „t”.
MIDDLE Wyrównanie, które wyrównuje treść do środka właściciela treści. Odpowiada ECMA-376 ST_TextAnchoringType „ctr”.
BOTTOM Wyrównanie, które wyrównuje treść do dołu właściciela treści. Odpowiada ECMA-376 ST_TextAnchoringType „b”.

SuggestedTableCellStyle

Sugerowana zmiana w: TableCellStyle.

Zapis JSON
{
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "tableCellStyleSuggestionState": {
    object (TableCellStyleSuggestionState)
  }
}
Pola
tableCellStyle

object (TableCellStyle)

TableCellStyle, który zawiera tylko zmiany wprowadzone w tej sugestii. Tego pola możesz użyć razem z atrybutem tableCellStyleSuggestionState, aby sprawdzić, które pola uległy zmianie i ich nowe wartości.

tableCellStyleSuggestionState

object (TableCellStyleSuggestionState)

Maska wskazująca, które pola na podstawie TableCellStyle zostały zmienione w tej sugestii.

TableCellStyleSuggestionState

Maska wskazująca, które pola na podstawie TableCellStyle zostały zmienione w tej sugestii. Dla każdego pola z wartością true (prawda) pojawi się nowa wartość sugerowana.

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 została sugerowana zmiana w tym polu: rowSpan.

columnSpanSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: columnSpan.

backgroundColorSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: backgroundColor.

borderLeftSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: borderLeft.

borderRightSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: borderRight.

borderTopSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: borderTop.

borderBottomSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: borderBottom.

paddingLeftSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: paddingLeft.

paddingRightSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: paddingRight.

paddingTopSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: paddingTop.

paddingBottomSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: paddingBottom.

contentAlignmentSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: contentAlignment.

TableRowStyle

Style zastosowane 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 na wysokości równej lub większej od tej wartości. Pozwoli to wyświetlić całą zawartość komórek w tym wierszu.

tableHeader

boolean

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

preventOverflow

boolean

Określa, czy wiersz nie może przekraczać granic strony lub kolumn.

SuggestedTableRowStyle

Sugerowana zmiana w: TableRowStyle.

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

object (TableRowStyle)

TableRowStyle, który zawiera tylko zmiany wprowadzone w tej sugestii. Tego pola możesz użyć razem z atrybutem tableRowStyleSuggestionState, aby sprawdzić, które pola uległy zmianie i ich nowe wartości.

tableRowStyleSuggestionState

object (TableRowStyleSuggestionState)

Maska wskazująca, które pola na podstawie TableRowStyle zostały zmienione w tej sugestii.

TableRowStyleSuggestionState

Maska wskazująca, które pola na podstawie TableRowStyle zostały zmienione w tej sugestii. Dla każdego pola z wartością true (prawda) pojawi się nowa wartość sugerowana.

Zapis JSON
{
  "minRowHeightSuggested": boolean
}
Pola
minRowHeightSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: minRowHeight.

TableStyle

Style stosowane do tabeli.

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

object (TableColumnProperties)

Właściwości poszczególnych kolumn.

Pamiętaj, że w Dokumentach tabele zawierają wiersze, a wiersze zawierają komórki (podobne do kodu HTML). Dlatego właściwości wiersza znajdują się w jego elemencie 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 widthType kolumny ma wartość 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 pozostałe kolumny.

Szerokość kolumny jest określana automatycznie i po uwzględnieniu wszystkich kolumn o określonych szerokościach ma taką samą część szerokości tabeli.

FIXED_WIDTH Stała szerokość kolumny. Właściwość [width][google.apps.docs.v1.TableColumnProperties.width] zawiera szerokość kolumny.

TableOfContents

Znak StructuralElement reprezentujący spis treści.

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

object (StructuralElement)

Zawartość spisu treści.

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

Identyfikatory sugerowanego usunięcia. Jeśli pole jest puste, nie są sugerowane usunięcia treści.

Przypis

Przypis w dokumencie.

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

string

Identyfikator przypisu.

content[]

object (StructuralElement)

Treść przypisu.

Indeksy treści przypisu zaczynają się od zera.

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ło dokumentu. Tło dokumentów nie może być przezroczyste.

defaultHeaderId

string

Identyfikator nagłówka domyślnego. Jeśli zasada nie jest skonfigurowana, brak domyślnego nagłówka.

Ta właściwość jest tylko do odczytu.

evenPageHeaderId

string

Identyfikator nagłówka używany tylko w przypadku stron parzystych. Wartość useEvenPageHeaderFooter określa, czy na stronach parzystych należy używać w nagłówku właściwości defaultHeaderId czy tej wartości. Jeśli zasada jest nieskonfigurowana, nagłówek stron parzystych nie ma.

Ta właściwość jest tylko do odczytu.

firstPageHeaderId

string

Identyfikator nagłówka używany tylko dla pierwszej strony. Jeśli jej nie skonfigurujesz, unikalny nagłówek pierwszej strony nie będzie istnieć. Wartość useFirstPageHeaderFooter określa, czy w nagłówku na pierwszej stronie użyć elementu defaultHeaderId czy tej wartości. Jeśli zasada nie jest skonfigurowana, nagłówek pierwszej strony nie jest wyświetlany.

Ta właściwość jest tylko do odczytu.

pageNumberStart

integer

Numer strony, od której ma się rozpocząć liczenie stron.

marginTop

object (Dimension)

Margines górnej strony.

Zaktualizowanie górnego marginesu w stylu dokumentu spowoduje wyczyszczenie tego marginesu we wszystkich stylach sekcji.

marginBottom

object (Dimension)

Dolny margines strony.

Zaktualizowanie dolnego marginesu w stylu dokumentu powoduje wyczyszczenie dolnego marginesu wszystkich stylów sekcji.

marginRight

object (Dimension)

Prawy margines strony.

Zaktualizowanie prawego marginesu w stylu dokumentu powoduje wyczyszczenie prawego marginesu we wszystkich stylach sekcji. Może to też spowodować zmianę rozmiaru kolumn we wszystkich sekcjach.

marginLeft

object (Dimension)

Lewy margines strony.

Zaktualizowanie lewego marginesu w stylu dokumentu powoduje wyczyszczenie tego marginesu 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 treścią nagłówka.

flipPageOrientation

boolean

Opcjonalnie: Wskazuje, czy odwrócić wymiary w elemencie pageSize, co pozwala zmienić orientację strony na pionową lub poziomą.

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: DocumentStyle.

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

object (DocumentStyle)

DocumentStyle, który zawiera tylko zmiany wprowadzone w tej sugestii. Tego pola możesz użyć razem z atrybutem documentStyleSuggestionState, aby sprawdzić, które pola uległy zmianie i ich nowe wartości.

documentStyleSuggestionState

object (DocumentStyleSuggestionState)

Maska wskazująca, które pola na podstawie DocumentStyle zostały zmienione w tej sugestii.

DocumentStyleSuggestionState

Maska wskazująca, które pola na podstawie DocumentStyle zostały zmienione w tej sugestii. Dla każdego pola z wartością true (prawda) pojawi się nowa wartość sugerowana.

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 tabeli background zostały zmienione w tej sugestii.

defaultHeaderIdSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: defaultHeaderId.

evenPageHeaderIdSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: evenPageHeaderId.

firstPageHeaderIdSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: firstPageHeaderId.

pageNumberStartSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: pageNumberStart.

marginTopSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: marginTop.

marginBottomSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: marginBottom.

marginRightSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: marginRight.

marginLeftSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: marginLeft.

pageSizeSuggestionState

object (SizeSuggestionState)

Maska wskazująca, które z pól w rozmiarze [size] W tej sugestii zmieniono element [google.apps.docs.v1.DocumentStyle.size].

marginHeaderSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: marginHeader.

flipPageOrientationSuggested

boolean

Opcjonalnie: Wskazuje, czy została sugerowana zmiana w tym polu: flipPageOrientation.

BackgroundSuggestionState

Maska wskazująca, które pola na podstawie Background zostały zmienione w tej sugestii. W przypadku każdego pola z wartością „true” (prawda), Backgound ma nową sugerowaną wartość.

Zapis JSON
{
  "backgroundColorSuggested": boolean
}
Pola
backgroundColorSuggested

boolean

Wskazuje, czy bieżący kolor tła został zmieniony w tej sugestii.

SizeSuggestionState

Maska wskazująca, które pola na podstawie Size zostały zmienione w tej sugestii. W przypadku każdego pola z wartością „true” (prawda), Size ma nową sugerowaną wartość.

Zapis JSON
{
  "heightSuggested": boolean,
  "widthSuggested": boolean
}
Pola
heightSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: height.

widthSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: width.

NamedStyles

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

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

object (NamedStyle)

Style nazwane.

Istnieje wpis dla każdej możliwej wartości named style types.

NamedStyle

Styl nazwany. Akapity w dokumencie mogą dziedziczyć właściwości TextStyle i ParagraphStyle z tego stylu nazwanego, 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 nazwanego stylu.

SuggestedNamedStyles

Zaproponowana zmiana: NamedStyles.

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

object (NamedStyles)

NamedStyles, który zawiera tylko zmiany wprowadzone w tej sugestii. Tego pola możesz użyć razem z atrybutem namedStylesSuggestionState, aby sprawdzić, które pola uległy zmianie i ich nowe wartości.

namedStylesSuggestionState

object (NamedStylesSuggestionState)

Maska wskazująca, które pola na podstawie NamedStyles zostały zmienione w tej sugestii.

NamedStylesSuggestionState

Stan sugestii wiadomości NamedStyles.

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

object (NamedStyleSuggestionState)

Maska wskazująca, które pola na odpowiednim obiekcie NamedStyle w: styles zostały zmienione w tej sugestii.

Kolejność stanów sugestii stylu nazwanego jest zgodna z kolejnością odpowiedniego stylu nazwanego z sugestii named styles.

NamedStyleSuggestionState

Stan sugestii wiadomości NamedStyle.

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

enum (NamedStyleType)

Nazwany typ stylu, któremu odpowiada ten stan sugestii.

To pole ma na celu ułatwienie dopasowania wartości NamedStylesuggestionState do odpowiadającej jej właściwości NamedStyle.

textStyleSuggestionState

object (TextStyleSuggestionState)

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

paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

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

Lista

Lista reprezentuje atrybuty listy dla grupy akapitów, które należą do tej samej listy. Akapit, który jest częścią listy, w właściwości bullet zawiera odniesienie 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))

Sugerowane zmiany właściwości listy pogrupowane według identyfikatora sugestii.

suggestedInsertionId

string

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

suggestedDeletionIds[]

string

Identyfikatory sugerowanego usunięcia. Jeśli ta lista jest pusta, nie są wyświetlane żadne sugestie usunięcia tej listy.

ListProperties

Właściwości elementu list opisujące wygląd i styl punktorów należących do akapitów powiązanych z listą.

Zapis JSON
{
  "nestingLevels": [
    {
      object (NestingLevel)
    }
  ]
}
Pola
nestingLevels[]

object (NestingLevel)

Opisuje właściwości punktorów na powiązanym poziomie.

Lista ma maksymalnie 9 poziomów zagnieżdżenia, gdzie poziom zagnieżdżenia 0 odpowiada najwyższemu poziomowi, a poziomowi 8 odpowiada najbardziej poziomowi. Poziomy zagnieżdżenia są zwracane w kolejności rosnącej, gdzie jako pierwsze zwracane są najmniej zagnieżdżone poziomy.

NestingLevel

Zawiera właściwości opisujące wygląd i sposób działania punktu listy 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 punktu w obszarze przeznaczonym na renderowanie punktora.

glyphFormat

string

Ciąg formatu używany przez punktory na tym poziomie zagnieżdżania.

Format glifu zawiera co najmniej 1 obiekt zastępcze, które są zastępowane odpowiednimi wartościami w zależności od glyphType lub glyphSymbol. Symbole zastępcze mają format %[nestingLevel]. Symbole zastępcze mogą też mieć prefiksy i sufiksy. Dzięki temu format glifów ma format <prefix>%[nestingLevel]<suffix>. Pamiętaj, że prefiks i sufiks są opcjonalne i mogą być dowolnymi ciągami znaków.

Na przykład format glifu %0. wskazuje, że wyrenderowany glif zastąpi obiekt zastępczy odpowiednim glifem na poziomie 0 zagnieżdżenia, po którym następuje kropka jako sufiks. Dlatego lista z typem glifu UPPER_ALPHA i formatem glifu %0. na poziomie zagnieżdżenia 0 utworzy listę z wyrenderowanymi glifami

A.

B.

C.

Format glifu może zawierać obiekty zastępcze dla bieżącego poziomu zagnieżdżenia, a także obiekty zastępcze dla nadrzędnych poziomów zagnieżdżenia. Na przykład format glifu może mieć wartość %0. na poziomie zagnieżdżenia i format glifu %0.%1. na poziomie zagnieżdżenia 1. Jeśli oba poziomy zagnieżdżenia zawierają tyle typów glifów: DECIMAL, powstanie lista z wyrenderowanymi glifami

1.

2.

2.1.

2.2.

3.

W przypadku uporządkowanych poziomów zagnieżdżenia ciąg, który w formacie glifu zastępuje obiekt zastępczy w formacie glifu w danym akapicie, zależy od kolejności akapitu na liście.

indentFirstLine

object (Dimension)

Liczba wcięć dla pierwszego wiersza akapitu na tym poziomie zagnieżdżenia.

indentStart

object (Dimension)

Liczba wcięć akapitów na tym poziomie zagnieżdżania. Jest stosowana do strony, która odpowiada początkowi tekstu, w zależności od kierunku treści akapitu.

textStyle

object (TextStyle)

Styl tekstu punktorów na tym poziomie zagnieżdżania.

startNumber

integer

Numer pierwszego elementu listy na tym poziomie zagnieżdżenia.

W przypadku list z literami i liczb rzymskich wartość 0 jest traktowana jako 1. W przypadku wartości 0 i 1 listy z literami i rzymskimi literami zaczynają się odpowiednio od a i i.

Ta wartość jest ignorowana w przypadku poziomów zagnieżdżenia z nieuporządkowanymi glifami.

Pole sumy glyph_kind. Rodzaj glifu używanego w punktorach. Określa glif punktora, który zastępuje zmienne w glyph_format. glyph_kind może mieć tylko jedną z tych wartości:
glyphType

enum (GlyphType)

Typ glifu używanego przez punktory, gdy obowiązuje kolejność akapitów na tym poziomie zagnieżdżenia.

Typ glifu określa typ glifu używanego do zastępowania obiektów zastępczych w elemencie glyphFormat, gdy akapity na tym poziomie zagnieżdżania są w odpowiedniej kolejności. Jeśli na przykład poziom zagnieżdżenia to 0, pole glyphFormat ma wartość %0., a typ glifu to DECIMAL, wówczas renderowany glif zastąpi symbol zastępczy %0 w formacie glifu liczbą odpowiadającą kolejności elementu na liście.

glyphSymbol

string

Niestandardowy symbol glifu używany przez punktory, gdy akapity na tym poziomie zagnieżdżenia są nieuporządkowane.

Symbol glifu zastępuje obiekty zastępcze w elemencie glyphFormat. Jeśli na przykład symbol glifu to pełny okrąg odpowiadający punktowi kodowemu Unicode U+25cf, a element glyphFormat ma wartość %0, renderowanym glifem będzie okrągłym okrąg.

BulletAlignment

Typy wyrównania punktora.

Wartości w polu enum
BULLET_ALIGNMENT_UNSPECIFIED Wyrównanie punktora nie jest określone.
START Punktor jest wyrównany do początku obszaru przeznaczonego na wyrenderowanie punktu. Wyrównanie do lewej w przypadku tekstu LTR, w przeciwnym razie wyrównanie do prawej.
CENTER Punktor jest wyrównany do środka obszaru przeznaczonego na renderowanie punktora.
END Punktor jest wyrównany do końca obszaru przeznaczonego na renderowanie punktora. Wyrównanie do prawej w przypadku tekstu LTR, w przeciwnym razie wyrównanie do lewej.

GlyphType

Typy glifów używanych przez punktory w przypadku określonego porządku akapitów na tym poziomie zagnieżdżenia.

Wartości w polu enum
GLYPH_TYPE_UNSPECIFIED Typ glifu jest nieokreślony lub nieobsługiwany.
NONE Pusty ciąg.
DECIMAL Liczba, np. 1, 2 lub 3.
ZERO_DECIMAL Liczba, w której liczby jednocyfrowe są poprzedzone zerem, np. 01, 02 lub 03. Liczby, które zawierają więcej niż jedną cyfrę, nie mają prefiksu zerem.
UPPER_ALPHA Wielka litera, np. A, B lub C.
ALPHA Mała litera, np. a, b lub c.
UPPER_ROMAN Wielkie litery rzymska, np. I, II lub III.
ROMAN Mała cyfra rzymska, np. i, ii lub iii.

SuggestedListProperties

Sugerowana zmiana: ListProperties.

Zapis JSON
{
  "listProperties": {
    object (ListProperties)
  },
  "listPropertiesSuggestionState": {
    object (ListPropertiesSuggestionState)
  }
}
Pola
listProperties

object (ListProperties)

ListProperties, który zawiera tylko zmiany wprowadzone w tej sugestii. Tego pola możesz użyć razem z atrybutem listPropertiesSuggestionState, aby sprawdzić, które pola uległy zmianie i ich nowe wartości.

listPropertiesSuggestionState

object (ListPropertiesSuggestionState)

Maska wskazująca, które pola na podstawie ListProperties zostały zmienione w tej sugestii.

ListPropertiesSuggestionState

Maska wskazująca, które pola na podstawie ListProperties zostały zmienione w tej sugestii. Dla każdego pola z wartością true (prawda) pojawi się nowa wartość sugerowana.

Zapis JSON
{
  "nestingLevelsSuggestionStates": [
    {
      object (NestingLevelSuggestionState)
    }
  ]
}
Pola
nestingLevelsSuggestionStates[]

object (NestingLevelSuggestionState)

Maska wskazująca, które pola na odpowiednim obiekcie NestingLevel w: nestingLevels zostały zmienione w tej sugestii.

Stany sugestii na poziomie zagnieżdżenia są zwracane w kolejności rosnącej od poziomu zagnieżdżenia. Jako pierwsze zwracane są najmniej zagnieżdżone stany.

NestingLevelSuggestionState

Maska wskazująca, które pola na podstawie NestingLevel zostały zmienione w tej sugestii. Dla każdego pola z wartością true (prawda) pojawi się nowa wartość sugerowana.

Zapis JSON
{
  "bulletAlignmentSuggested": boolean,
  "glyphTypeSuggested": boolean,
  "glyphFormatSuggested": boolean,
  "glyphSymbolSuggested": boolean,
  "indentFirstLineSuggested": boolean,
  "indentStartSuggested": boolean,
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  },
  "startNumberSuggested": boolean
}
Pola
bulletAlignmentSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: bulletAlignment.

glyphTypeSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: glyphType.

glyphFormatSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: glyphFormat.

glyphSymbolSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: glyphSymbol.

indentFirstLineSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: indentFirstLine.

indentStartSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: indentStart.

textStyleSuggestionState

object (TextStyleSuggestionState)

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

startNumberSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: startNumber.

NamedRanges

Zbiór wszystkich elementów NamedRange w dokumencie, które mają określone imię.

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

string

Nazwa używana przez wszystkie named ranges.

namedRanges[]

object (NamedRange)

NamedRange o tej samej nazwie.

NamedRange

Kolekcja elementów Range z tym samym identyfikatorem zakresu.

Zakresy nazwane pozwalają programistom powiązać części dokumentu z dowolną etykietą zdefiniowaną przez użytkownika, dzięki czemu można programowo odczytać lub edytować ich zawartość. Dokument może zawierać wiele zakresów nazwanych o tej samej nazwie, ale każdy zakres nazwany ma unikalny identyfikator.

Nazwany zakres jest tworzony z pojedynczym elementem Range, a treść wstawiona do nazwanego zakresu zwykle go rozszerza. Jednak pewne zmiany w dokumencie mogą spowodować podzielenie zakresu na kilka zakresów.

Zakresy nazwane nie są prywatne. Wszystkie aplikacje i współpracownicy, którzy mają dostęp do dokumentu, widzą jego zakresy nazwane.

Zapis JSON
{
  "namedRangeId": string,
  "name": string,
  "ranges": [
    {
      object (Range)
    }
  ]
}
Pola
namedRangeId

string

Identyfikator zakresu nazwanego.

name

string

Nazwa nazwanego zakresu.

ranges[]

object (Range)

Zakresy, które należą do tego nazwanego zakresu.

Zakres

Określa przyległ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 zawarty jest ten zakres. Pusty identyfikator segmentu oznacza treść dokumentu.

startIndex

integer

Indeks początkowy tego zakresu liczony od zera w jednostkach kodu UTF-16.

We wszystkich bieżących zastosowaniach musisz podać indeks początkowy. To pole jest typu Int32Value, aby uwzględnić przyszłe przypadki użycia z zakresami otwartymi.

endIndex

integer

Indeks końcowy liczony od zera dla tego zakresu (wyłącznie) w jednostkach kodu UTF-16.

We wszystkich bieżących zastosowaniach musisz podać indeks końcowy. To pole jest typu Int32Value, aby uwzględnić przyszłe przypadki użycia z zakresami otwartymi.

tabId

string

Karta zawierająca ten zakres. W przypadku jego pominięcia żądanie jest stosowane do pierwszej karty.

W dokumencie zawierającym jedną kartę:

  • Jeśli podano, musi odpowiadać identyfikatorowi pojedynczej karty.

  • Jeśli pominiesz ten zapis, żądanie będzie dotyczyło pojedynczej karty.

W dokumencie z wieloma kartami:

  • Jeśli żądanie zostanie podane, dotyczy podanej karty.

  • Jeśli go pominiesz, żądanie będzie dotyczyć pierwszej karty w dokumencie.

InlineObject

Obiekt wyświetlany w tekście. Obiekt InlineObject zawiera obiekt EmbeddedObject, np. obraz.

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

string

Identyfikator tego wbudowanego obiektu. Może służyć do aktualizowania właściwości obiektu.

inlineObjectProperties

object (InlineObjectProperties)

Właściwości tego wbudowanego obiektu.

suggestedInlineObjectPropertiesChanges

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

Sugerowane zmiany we właściwościach wbudowanego obiektu, których kluczem jest identyfikator sugestii.

suggestedInsertionId

string

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

suggestedDeletionIds[]

string

Identyfikatory sugerowanego usunięcia. Jeśli pole jest puste, nie są sugerowane usunięcia treści.

InlineObjectProperties

Właściwości elementu InlineObject.

Zapis JSON
{
  "embeddedObject": {
    object (EmbeddedObject)
  }
}
Pola
embeddedObject

object (EmbeddedObject)

Umieszczony obiekt tego wbudowanego obiektu.

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ł umieszczonego obiektu. Elementy title i description są połączone, aby wyświetlić tekst alternatywny.

description

string

Opis umieszczonego obiektu. Elementy title i description są połączone, aby wyświetlić tekst alternatywny.

embeddedObjectBorder

object (EmbeddedObjectBorder)

Obramowanie umieszczonego obiektu.

size

object (Size)

Rozmiar obrazu widoczny po przycięciu.

marginTop

object (Dimension)

Górny margines umieszczonego obiektu.

marginBottom

object (Dimension)

Dolny margines umieszczonego obiektu.

marginRight

object (Dimension)

Prawy margines umieszczonego obiektu.

marginLeft

object (Dimension)

Lewy margines umieszczonego obiektu.

linkedContentReference

object (LinkedContentReference)

Odniesienie do zewnętrznych treści źródłowych, do których prowadzą linki. Na przykład gdy umieszczony obiekt jest wykresem połączonym, zawiera ono odwołanie do źródłowego wykresu Arkuszy Google.

Jeśli zasada jest nieskonfigurowana, osadzony obiekt nie jest połączony.

Pole sumy properties. Właściwości charakterystyczne dla każdego typu obiektu osadzonego. properties może mieć tylko jedną z tych wartości:
embeddedDrawingProperties

object (EmbeddedDrawingProperties)

Właściwości umieszczonego rysunku.

imageProperties

object (ImageProperties)

Właściwości obrazu.

EmbeddedDrawingProperties

Ten typ nie zawiera pól.

Właściwości umieszczonego rysunku służące do rozróżnienia typu obiektu. Rysunek umieszczony na stronie to taki, który jest tworzony i edytowany w dokumencie. Pamiętaj, że szczegółowe dane 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 o domyślnym czasie trwania wynoszącym 30 minut. Ten identyfikator URI jest oznaczony tagiem konta użytkownika zgłaszającego prośbę. Każda osoba korzystająca z identyfikatora URI uzyskuje dostęp do obrazu jako osoba, która zgłosiła pierwotne żądanie. Jeśli zmienią się ustawienia udostępniania dokumentu, możesz utracić dostęp do zdjęcia.

sourceUri

string

Identyfikator URI źródła to identyfikator URI służący do wstawiania obrazu. Źródłowy identyfikator URI może być pusty.

brightness

number

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

contrast

number

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

transparency

number

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

cropProperties

object (CropProperties)

Właściwości przycinania obrazu.

angle

number

Kąt obrotu obrazu w prawo w radianach.

CropProperties

Właściwości przycinania obrazu.

Prostokąt przycinania jest reprezentowany za pomocą ułamkowych odsunięć od 4 krawędzi oryginalnej treści.

  • Jeśli odsunięcie znajduje się w przedziale (0, 1), odpowiednia krawędź prostokąta przycinania jest umieszczona wewnątrz prostokąta ograniczającego obrazu.
  • Jeśli odsunięcie jest ujemne lub większe niż 1, odpowiednia krawędź prostokąta przycinania jest umieszczona poza prostokątem ograniczającym obraz.
  • Jeśli wszystkie przesunięcia i kąt obrotu wynoszą 0, obraz nie zostanie przycięty.
Zapis JSON
{
  "offsetLeft": number,
  "offsetRight": number,
  "offsetTop": number,
  "offsetBottom": number,
  "angle": number
}
Pola
offsetLeft

number

Przesunięcie określa, jak daleko od lewej krawędzi prostokąta przycinania do środka znajduje się ułamek jego szerokości.

offsetRight

number

To odsunięcie określa, jak daleko do prawej krawędzi prostokąta przycinania do środka od jego prawej krawędzi znajduje się ułamek jego szerokości.

offsetTop

number

Przesunięcie określa, jak daleko od górnej krawędzi prostokąta przycinania do środka znajduje się odległość od górnej krawędzi oryginalnej treści wyrażona jako ułamek wysokości oryginalnej treści.

offsetBottom

number

To odsunięcie określa, jak daleko dolna krawędź prostokąta przycinania znajduje się do wewnątrz od dolnej krawędzi oryginalnej treści. Jej wysokość określa się jako ułamek wysokości oryginalnej treści.

angle

number

Kąt obrotu prostokąta przycinania w prawo (w radianach) wokół jego środka. Obrót jest stosowany po przesunięciach.

EmbeddedObjectBorder

Obramowanie wokół krawędzi 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 obramowania.

propertyState

enum (PropertyState)

Stan właściwości granicy.

PropertyState

Możliwe stany usługi.

Wartości w polu enum
RENDERED Jeśli stan właściwości to RENDERED, element po wyrenderowaniu w dokumencie ma odpowiednią właściwość. 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 zewnętrznych treści źródłowych, do których prowadzą linki.

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 sumy reference. Odwołanie specyficzne dla typu powiązanej treści. reference może mieć tylko jedną z tych wartości:
sheetsChartReference

object (SheetsChartReference)

Odwołanie do połączonego wykresu.

SheetsChartReference

Odwołanie do linku do wykresu umieszczonego z Arkuszy Google.

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

string

Identyfikator arkusza kalkulacyjnego Arkuszy Google, który zawiera wykres źródłowy.

chartId

integer

Identyfikator konkretnego wykresu w osadzonym arkuszu kalkulacyjnym Arkuszy Google.

SuggestedInlineObjectProperties

Sugerowana zmiana: InlineObjectProperties.

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

object (InlineObjectProperties)

Wartość InlineObjectProperties obejmująca tylko zmiany wprowadzone w tej sugestii. Tego pola możesz użyć razem z atrybutem inlineObjectPropertiesSuggestionState, aby sprawdzić, które pola uległy zmianie i ich nowe wartości.

inlineObjectPropertiesSuggestionState

object (InlineObjectPropertiesSuggestionState)

Maska wskazująca, które pola na podstawie InlineObjectProperties zostały zmienione w tej sugestii.

InlineObjectPropertiesSuggestionState

Maska wskazująca, które pola na podstawie InlineObjectProperties zostały zmienione w tej sugestii. Dla każdego pola z wartością true (prawda) pojawi się nowa wartość sugerowana.

Zapis JSON
{
  "embeddedObjectSuggestionState": {
    object (EmbeddedObjectSuggestionState)
  }
}
Pola
embeddedObjectSuggestionState

object (EmbeddedObjectSuggestionState)

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

EmbeddedObjectSuggestionState

Maska wskazująca, które pola na podstawie EmbeddedObject zostały zmienione w tej sugestii. Dla każdego pola z wartością true (prawda) pojawi się nowa wartość sugerowana.

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 tabeli embeddedDrawingProperties zostały zmienione w tej sugestii.

imagePropertiesSuggestionState

object (ImagePropertiesSuggestionState)

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

titleSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: title.

descriptionSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: description.

embeddedObjectBorderSuggestionState

object (EmbeddedObjectBorderSuggestionState)

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

sizeSuggestionState

object (SizeSuggestionState)

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

marginLeftSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: marginLeft.

marginRightSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: marginRight.

marginTopSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: marginTop.

marginBottomSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: marginBottom.

linkedContentReferenceSuggestionState

object (LinkedContentReferenceSuggestionState)

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

EmbeddedDrawingPropertiesSuggestionState

Ten typ nie zawiera pól.

Maska wskazująca, które pola na podstawie EmbeddedDrawingProperties zostały zmienione w tej sugestii. Dla każdego pola z wartością true (prawda) pojawi się nowa wartość sugerowana.

ImagePropertiesSuggestionState

Maska wskazująca, które pola na podstawie ImageProperties zostały zmienione w tej sugestii. Dla każdego pola z wartością true (prawda) pojawi się nowa wartość sugerowana.

Zapis JSON
{
  "contentUriSuggested": boolean,
  "sourceUriSuggested": boolean,
  "brightnessSuggested": boolean,
  "contrastSuggested": boolean,
  "transparencySuggested": boolean,
  "cropPropertiesSuggestionState": {
    object (CropPropertiesSuggestionState)
  },
  "angleSuggested": boolean
}
Pola
contentUriSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: contentUri.

sourceUriSuggested

boolean

Wskazuje, czy została sugerowana zmiana dotycząca identyfikatora [sourceUri] [google.apps.docs.v1.EmbeddedObject.source_uri].

brightnessSuggested

boolean

Wskazuje, czy sugerowano zmianę na [jasność] [google.apps.docs.v1.EmbeddedObject.brightness].

contrastSuggested

boolean

Wskazuje, czy sugerowano zmianę na [kontrrast] [google.apps.docs.v1.EmbeddedObject.contrast].

transparencySuggested

boolean

Wskazuje, czy została sugerowana zmiana w [przejrzystość] [google.apps.docs.v1.EmbeddedObject.transparency].

cropPropertiesSuggestionState

object (CropPropertiesSuggestionState)

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

angleSuggested

boolean

Wskazuje, czy została sugerowana zmiana na [angle] [google.apps.docs.v1.EmbeddedObject.angle].

CropPropertiesSuggestionState

Maska wskazująca, które pola na podstawie CropProperties zostały zmienione w tej sugestii. Dla każdego pola z wartością true (prawda) pojawi się nowa wartość sugerowana.

Zapis JSON
{
  "offsetLeftSuggested": boolean,
  "offsetRightSuggested": boolean,
  "offsetTopSuggested": boolean,
  "offsetBottomSuggested": boolean,
  "angleSuggested": boolean
}
Pola
offsetLeftSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: offsetLeft.

offsetRightSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: offsetRight.

offsetTopSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: offsetTop.

offsetBottomSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: offsetBottom.

angleSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: angle.

EmbeddedObjectBorderSuggestionState

Maska wskazująca, które pola na podstawie EmbeddedObjectBorder zostały zmienione w tej sugestii. Dla każdego pola z wartością true (prawda) pojawi się nowa wartość sugerowana.

Zapis JSON
{
  "colorSuggested": boolean,
  "widthSuggested": boolean,
  "dashStyleSuggested": boolean,
  "propertyStateSuggested": boolean
}
Pola
colorSuggested

boolean

Wskazuje, czy została sugerowana zmiana na kolor [color] [google.apps.docs.v1.EmbeddedBorderObject.color].

widthSuggested

boolean

Wskazuje, czy została sugerowana zmiana rozmiaru [width] [google.apps.docs.v1.EmbeddedBorderObject.width].

dashStyleSuggested

boolean

Wskazuje, czy została sugerowana zmiana na [dashStyle] [google.apps.docs.v1.EmbeddedBorderObject.dash_style].

propertyStateSuggested

boolean

Wskazuje, czy została sugerowana zmiana na [propertyState] [google.apps.docs.v1.EmbeddedBorderObject.property_state].

LinkedContentReferenceSuggestionState

Maska wskazująca, które pola na podstawie LinkedContentReference zostały zmienione w tej sugestii. Dla każdego pola z wartością true (prawda) pojawi się nowa wartość sugerowana.

Zapis JSON
{
  "sheetsChartReferenceSuggestionState": {
    object (SheetsChartReferenceSuggestionState)
  }
}
Pola
sheetsChartReferenceSuggestionState

object (SheetsChartReferenceSuggestionState)

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

SheetsChartReferenceSuggestionState

Maska wskazująca, które pola na podstawie SheetsChartReference zostały zmienione w tej sugestii. Dla każdego pola z wartością true (prawda) pojawi się nowa wartość sugerowana.

Zapis JSON
{
  "spreadsheetIdSuggested": boolean,
  "chartIdSuggested": boolean
}
Pola
spreadsheetIdSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: spreadsheetId.

chartIdSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: chartId.

PositionedObject

Obiekt powiązany z elementem Paragraph i umieszczony względem początku akapitu. Element PositionedObject zawiera obiekt EmbeddedObject, np. obraz.

Zapis JSON
{
  "objectId": string,
  "positionedObjectProperties": {
    object (PositionedObjectProperties)
  },
  "suggestedPositionedObjectPropertiesChanges": {
    string: {
      object (SuggestedPositionedObjectProperties)
    },
    ...
  },
  "suggestedInsertionId": string,
  "suggestedDeletionIds": [
    string
  ]
}
Pola
objectId

string

Identyfikator tego umieszczonego obiektu.

positionedObjectProperties

object (PositionedObjectProperties)

Właściwości tego umieszczonego obiektu.

suggestedPositionedObjectPropertiesChanges

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

Sugerowane zmiany właściwości pozycjonowanego obiektu pogrupowane według identyfikatora sugestii.

suggestedInsertionId

string

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

suggestedDeletionIds[]

string

Identyfikatory sugerowanego usunięcia. Jeśli pole jest puste, nie są sugerowane usunięcia treści.

PositionedObjectProperties

Właściwości elementu PositionedObject.

Zapis JSON
{
  "positioning": {
    object (PositionedObjectPositioning)
  },
  "embeddedObject": {
    object (EmbeddedObject)
  }
}
Pola
positioning

object (PositionedObjectPositioning)

Pozycjonowanie tego umieszczonego obiektu względem nowego wiersza obiektu Paragraph, które odwołuje się do tego umieszczonego obiektu.

embeddedObject

object (EmbeddedObject)

Umieszczony obiekt tego umieszczonego obiektu.

PositionedObjectPositioning

Pozycjonowanie elementu PositionedObject. Pozycjonowany obiekt jest położony względem początku elementu Paragraph, z którym jest powiązany.

Zapis JSON
{
  "layout": enum (PositionedObjectLayout),
  "leftOffset": {
    object (Dimension)
  },
  "topOffset": {
    object (Dimension)
  }
}
Pola
layout

enum (PositionedObjectLayout)

Układ tego umieszczonego obiektu.

leftOffset

object (Dimension)

Odsunięcie lewej krawędzi umieszczonego obiektu względem początku elementu Paragraph, z którym jest połączony. Dokładne położenie obiektu może zależeć od innych treści w dokumencie oraz jego stylu.

topOffset

object (Dimension)

Odsunięcie górnej krawędzi umieszczonego obiektu względem początku elementu Paragraph, z którym jest powiązany powiązany element. Dokładne położenie obiektu może zależeć od innych treści w dokumencie oraz jego stylu.

PositionedObjectLayout

Możliwe układy [PositionedObject][google.aps.docs.v1.PositionedObject].

Wartości w polu enum
POSITIONED_OBJECT_LAYOUT_UNSPECIFIED Układ nie jest określony.
WRAP_TEXT Tekst zostanie zawinięty wokół umieszczonego obiektu.
BREAK_LEFT Dzieli tekst w taki sposób, że umieszczony obiekt jest po lewej stronie, a tekst po prawej.
BREAK_RIGHT Dzieli tekst w taki sposób, że umieszczony obiekt znajduje się po prawej stronie, a tekst po lewej.
BREAK_LEFT_RIGHT Powoduje podział tekstu tak, że nie ma tekstu po lewej ani prawej stronie umieszczonego obiektu.
IN_FRONT_OF_TEXT Umieszczony obiekt znajduje się przed tekstem.
BEHIND_TEXT Obiekt znajduje się za tekstem.

SuggestedPositionedObjectProperties

Sugerowana zmiana: PositionedObjectProperties.

Zapis JSON
{
  "positionedObjectProperties": {
    object (PositionedObjectProperties)
  },
  "positionedObjectPropertiesSuggestionState": {
    object (PositionedObjectPropertiesSuggestionState)
  }
}
Pola
positionedObjectProperties

object (PositionedObjectProperties)

PositionedObjectProperties, który zawiera tylko zmiany wprowadzone w tej sugestii. Tego pola możesz użyć razem z atrybutem positionedObjectPropertiesSuggestionState, aby sprawdzić, które pola uległy zmianie i ich nowe wartości.

positionedObjectPropertiesSuggestionState

object (PositionedObjectPropertiesSuggestionState)

Maska wskazująca, które pola na podstawie PositionedObjectProperties zostały zmienione w tej sugestii.

PositionedObjectPropertiesSuggestionState

Maska wskazująca, które pola na podstawie PositionedObjectProperties zostały zmienione w tej sugestii. Dla każdego pola z wartością true (prawda) pojawi się nowa wartość sugerowana.

Zapis JSON
{
  "positioningSuggestionState": {
    object (PositionedObjectPositioningSuggestionState)
  },
  "embeddedObjectSuggestionState": {
    object (EmbeddedObjectSuggestionState)
  }
}
Pola
positioningSuggestionState

object (PositionedObjectPositioningSuggestionState)

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

embeddedObjectSuggestionState

object (EmbeddedObjectSuggestionState)

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

PositionedObjectPositioningSuggestionState

Maska wskazująca, które pola na podstawie PositionedObjectPositioning zostały zmienione w tej sugestii. Dla każdego pola z wartością true (prawda) pojawi się nowa wartość sugerowana.

Zapis JSON
{
  "layoutSuggested": boolean,
  "leftOffsetSuggested": boolean,
  "topOffsetSuggested": boolean
}
Pola
layoutSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: layout.

leftOffsetSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: leftOffset.

topOffsetSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: topOffset.

SuggestionsViewMode

Tryb widoku sugestii zastosowany do dokumentu, który wskazuje, w jaki sposób są reprezentowane sugerowane zmiany. Zawiera opcje odczytu dokumentu ze wszystkimi sugestiami w tekście, zaakceptowanymi lub odrzuconymi.

Wartości w polu enum
DEFAULT_FOR_CURRENT_ACCESS Tryb SuggestionsViewMode stosowany do zwracanego dokumentu zależy od bieżącego poziomu dostępu użytkownika. Jeśli użytkownik ma uprawnienia tylko do wyświetlania, zastosowana zostanie zasada PREVIEW_WITHOUT_SUGGESTIONS. W przeciwnym razie stosowana jest zasada SUGGESTIONS_INLINE. To jest domyślny tryb widoku sugestii.
SUGGESTIONS_INLINE

Zwrócony dokument zawiera sugestie. Sugerowane zmiany będą się różnić od podstawowej treści dokumentu.

Żądania pobrania dokumentu w tym trybie będą zwracać błąd 403, jeśli użytkownik nie ma uprawnień do wyświetlania sugerowanych zmian.

PREVIEW_SUGGESTIONS_ACCEPTED

Zwrócony dokument to podgląd, w którym zaakceptowano wszystkie sugerowane zmiany.

Żądania pobrania dokumentu w tym trybie będą zwracać błąd 403, jeśli użytkownik nie ma uprawnień do wyświetlania sugerowanych zmian.

PREVIEW_WITHOUT_SUGGESTIONS Zwrócony dokument to podgląd. Jeśli w dokumencie pojawiają się jakieś sugestie, wszystkie sugerowane zmiany są odrzucane.

Metody

batchUpdate

Powoduje zastosowanie do dokumentu co najmniej jednej aktualizacji.

create

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

get

Pobiera najnowszą wersję określonego dokumentu.