REST Resource: documents

Zasób: dokument

Dokument w Dokumentach Google.

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

string

Tylko dane wyjściowe. Identyfikator dokumentu.

title

string

Tytuł dokumentu.

tabs[]

object (Tab)

Karty będące częścią dokumentu.

Karty mogą zawierać karty podrzędne, czyli karty zagnieżdżone w innych kartach. Zakładki 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ć. Zwrócony identyfikator wersji jest gwarantowany tylko przez 24 godziny od momentu jego zwrotu i nie może być udostępniany innym użytkownikom. Jeśli identyfikator wersji nie zmienia się między wywołaniami, oznacza to, że dokument nie został zmieniony. Natomiast zmiana identyfikatora (tego samego dokumentu i użytkownika) oznacza zazwyczaj, że dokument został zaktualizowany. Zmiana identyfikatora może być też spowodowana czynnikami wewnętrznymi, np. zmianami formatu identyfikatora.

suggestionsViewMode

enum (SuggestionsViewMode)

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

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

body

object (Body)

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

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

headers

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

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

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

footers

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

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

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.

Pole starsze: zamiast tego użyj pola Document.tabs.documentTab.footnotes, które wyświetla rzeczywiste treści dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli 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.

Pole starsze: zamiast tego użyj pola Document.tabs.documentTab.documentStyle, które wyświetla rzeczywiste treści dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli 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, posortowane według identyfikatora sugestii.

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

namedStyles

object (NamedStyles)

Tylko dane wyjściowe. Nazwane style dokumentu.

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 nazwanych stylów dokumentu, posortowane według identyfikatora 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, posortowane według 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. Nazwane zakresy w dokumencie, posortowane według nazwy.

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

positionedObjects

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

Tylko dane wyjściowe. 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 umieszczone na tej karcie.

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

object (DocumentTab)

Karta z zawartością dokumentu, np. tekstem i obrazami.

TabProperties

Właściwości karty.

Zapis JSON
{
  "tabId": string,
  "title": string,
  "parentTabId": string,
  "index": integer,
  "nestingLevel": integer
}
Pola
tabId

string

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

title

string

Nazwa karty widoczna dla użytkownika.

parentTabId

string

Opcjonalnie: Identyfikator karty nadrzędnej. Pusta, jeśli bieżąca karta jest kartą na poziomie głównym, co oznacza, że nie ma na niej żadnych elementów nadrzędnych.

index

integer

Indeks tabulacji w ramach elementu nadrzędnego, liczony od zera.

nestingLevel

integer

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

DocumentTab

Karta z treścią dokumentu.

Zapis JSON
{
  "body": {
    object (Body)
  },
  "headers": {
    string: {
      object (Header)
    },
    ...
  },
  "footers": {
    string: {
      object (Footer)
    },
    ...
  },
  "footnotes": {
    string: {
      object (Footnote)
    },
    ...
  },
  "documentStyle": {
    object (DocumentStyle)
  },
  "suggestedDocumentStyleChanges": {
    string: {
      object (SuggestedDocumentStyle)
    },
    ...
  },
  "namedStyles": {
    object (NamedStyles)
  },
  "suggestedNamedStylesChanges": {
    string: {
      object (SuggestedNamedStyles)
    },
    ...
  },
  "lists": {
    string: {
      object (List)
    },
    ...
  },
  "namedRanges": {
    string: {
      object (NamedRanges)
    },
    ...
  },
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}
Pola
body

object (Body)

Główna część karty dokumentu.

headers

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

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

footers

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

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

footnotes

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

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

documentStyle

object (DocumentStyle)

Styl karty dokumentu.

suggestedDocumentStyleChanges

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

Sugerowane zmiany stylu karty dokumentu oparte na identyfikatorze sugestii.

namedStyles

object (NamedStyles)

Nazwane style karty dokumentu.

suggestedNamedStylesChanges

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

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

lists

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

Listy na karcie 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ść zawiera zwykle całą 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

Wykluczający indeks końcowy tego elementu strukturalnego, liczony od zera, w jednostkach kodu UTF-16.

Pole sumy content. Treść elementu strukturalnego. content może być tylko jednym z tych elementów:
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)

Element strukturalny typu spis treści.

Akapit

Znak StructuralElement reprezentujący akapit. Akapit to zakres treści zakończony znakiem nowego wiersza.

Zapis JSON
{
  "elements": [
    {
      object (ParagraphElement)
    }
  ],
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "suggestedParagraphStyleChanges": {
    string: {
      object (SuggestedParagraphStyle)
    },
    ...
  },
  "bullet": {
    object (Bullet)
  },
  "suggestedBulletChanges": {
    string: {
      object (SuggestedBullet)
    },
    ...
  },
  "positionedObjectIds": [
    string
  ],
  "suggestedPositionedObjectIds": {
    string: {
      object (ObjectReferences)
    },
    ...
  }
}
Pola
elements[]

object (ParagraphElement)

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

paragraphStyle

object (ParagraphStyle)

Styl tego akapitu.

suggestedParagraphStyleChanges

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

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

bullet

object (Bullet)

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

suggestedBulletChanges

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

Sugerowane zmiany w punkcie w tym akapicie.

positionedObjectIds[]

string

Identyfikatory 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 zawartość w Paragraph.

Zapis JSON
{
  "startIndex": integer,
  "endIndex": integer,

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

integer

Indeks początkowy tego elementu akapitu oparty na 0 w jednostkach kodu UTF-16.

endIndex

integer

Indeks końcowy tego elementu akapitu (z wyłączeniem) oparty na zerowej podstawie w jednostkach kodu UTF-16.

Pole unii content. Treść elementu akapitu. content może 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 poziomą linią.

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 jest puste, nie jest to sugerowane wstawienie.

suggestedDeletionIds[]

string

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

textStyle

object (TextStyle)

Styl tekstu tego przebiegu.

suggestedTextStyleChanges

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

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

TextStyle

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 elementach Paragraph dziedziczy się z odpowiednich elementów named style type.
  • Element TextStyle w elemencie named style dziedziczy styl nazwany normal text.
  • Styl tekstu normal text dziedziczy styl tekstu domyślnego 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

czy tekst jest zapisany małymi literami.

backgroundColor

object (OptionalColor)

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

foregroundColor

object (OptionalColor)

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

fontSize

object (Dimension)

Rozmiar czcionki tekstu.

weightedFontFamily

object (WeightedFontFamily)

Rodzina czcionek i renderowana grubość tekstu.

Jeśli żądanie aktualizacji zawiera wartości zarówno 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 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 ustawiony, oznacza przezroczysty kolor.

Kolor

Jednolity kolor.

Zapis JSON
{
  "rgbColor": {
    object (RgbColor)
  }
}
Pola
rgbColor

object (RgbColor)

Wartość koloru RGB.

RgbColor

Kolor RGB.

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

number

Składnik koloru koloru z zakresu od 0,0 do 1,0.

green

number

Składowa zielona koloru, 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 jest rozpoznawana, tekst jest renderowany w czcionce Arial.

weight

integer

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

Wartość domyślna to 400 („normalny”).

Grubość czcionki stanowi tylko jeden składnik renderowanej grubości 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 jest równa 700.
  • Jeśli waga jest większa lub równa 700, wyrenderowana waga jest równa wadze.
  • Jeśli tekst nie jest pogrubiony, renderowana grubość jest równa grubości.

BaselineOffset

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 propozycji. Możesz go używać razem z przyciskiem textStyleSuggestionState, aby sprawdzić, które pola się zmieniły i jakie mają teraz wartości.

textStyleSuggestionState

object (TextStyleSuggestionState)

Maska wskazująca, które pola 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 zasugerowano zmianę na 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 biegiem czasu, 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 wstawienia. Jeśli AutoText jest zagnieżdżoną sugerowaną zmianą, może mieć wiele identyfikatorów wstawienia. Jeśli pole jest puste, nie jest to sugerowane wstawienie.

suggestedDeletionIds[]

string

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

textStyle

object (TextStyle)

Styl tekstu tego 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 tekstu automatycznego.
PAGE_NUMBER Wpisz tekst automatyczny reprezentujący numer bieżącej strony.
PAGE_COUNT Wpisz tekst automatyczny, który będzie reprezentować łączną liczbę stron w dokumencie.

PageBreak

Element ParagraphElement reprezentujący podział strony. Podział strony powoduje, że następny tekst rozpoczyna się u góry następnej strony.

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

string

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

suggestedDeletionIds[]

string

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

textStyle

object (TextStyle)

Styl tekstu tego podziału strony.

Podobnie jak w przypadku treści tekstowych, np. ciągów tekstowych i odniesień do przypisów, styl tekstu w przerwie na stronie może wpływać na układ treści oraz styl tekstu wstawionego obok.

suggestedTextStyleChanges

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

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

ColumnBreak

ParagraphElement oznacza podział kolumny. Przerwanie kolumny powoduje, że następny tekst zaczyna się u góry następnej kolumny.

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

string

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

suggestedDeletionIds[]

string

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

textStyle

object (TextStyle)

Styl tekstu tego elementu ColumnBreak.

Podobnie jak w przypadku tekstu, np. ciągów tekstowych i odwołań do przypisów, styl tekstu w przerwie kolumny może wpływać na układ treści oraz styl tekstu wstawionego obok.

suggestedTextStyleChanges

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

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

FootnoteReference

Element ParagraphElement reprezentujący odwołanie do przypisu. Odwołanie do przypisu to zawartość wstawiana w tekście, która jest renderowana z numerem i służy do identyfikacji przypisu.

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

string

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

footnoteNumber

string

Wyrenderowany numer tego przypisu.

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

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

textStyle

object (TextStyle)

Styl tekstu tego przypisu do przypisu.

suggestedTextStyleChanges

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

Styl sugerowanego tekstu zmienia się na ten atrybut, którego kluczem jest identyfikator sugestii.

HorizontalRule

ParagraphElement 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 jest puste, nie jest to sugerowane wstawienie.

suggestedDeletionIds[]

string

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

textStyle

object (TextStyle)

Styl tekstu tej poziomej linii.

Podobnie jak w przypadku 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 zmienia się na tę regułę poziomą, która jest powiązana z identyfikatorem sugestii.

Równanie

ParagraphElement reprezentujące równanie.

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

string

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

suggestedDeletionIds[]

string

Identyfikatory sugerowanego usunięcia. Jeśli jest puste, nie ma żadnych sugerowanych usunięcia tych 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 InlineObject zawartego w tym elemencie.

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 jest puste, nie ma żadnych sugerowanych usunięcia tych treści.

textStyle

object (TextStyle)

Styl tekstu tego elementu wbudowanego.

Styl tekstu wbudowanego elementu obiektu może wpływać na układ treści oraz na styl wstawionego obok niego tekstu, 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 wymieniony 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, które wstawiają w dokumencie link do tej osoby. Element Person może mieć wiele identyfikatorów wstawienia, jeśli jest to zagnieżdżona sugerowana zmiana (np. sugestia w sugestii wprowadzona przez innego użytkownika). Jeśli jest puste, link do tej osoby nie jest sugerowanym wstawieniem.

suggestedDeletionIds[]

string

Identyfikatory sugestii, które usuwają link do tej osoby z dokumentu. 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 jest puste, nie zalecamy usuwania linku do tej osoby.

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

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

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

string

Tylko dane wyjściowe. Imię i nazwisko osoby, jeśli jest wyświetlane w tekście linku, 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 widoczne.

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

uri

string

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

mimeType

string

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

ParagraphStyle

Style, które dotyczą całego akapitu.

Dziedziczone style akapitu są w tym komunikacie reprezentowane jako pola nieskonfigurowane. Element nadrzędny stylu akapitu zależy od tego, gdzie jest zdefiniowany styl akapitu:

  • Styl akapitu w elementach Paragraph dziedziczy ustawienia z odpowiadających elementów named style type.
  • Styl 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 elementu Paragraph zawartego w tabeli może odziedziczyć styl akapitu od 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 usługa 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 liniami wyrażony jako odsetek wartości normalnej, gdzie wartość normalna to 100,0. Jeśli nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego.

direction

enum (ContentDirection)

Kierunek tekstu w tym akapicie. Jeśli nie 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 nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego.

spaceBelow

object (Dimension)

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

borderBetween

object (ParagraphBorder)

Granica między tym a poprzednim lub następnym akapitem. Jeśli nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego.

Obramowanie wewnętrzne jest renderowane, gdy sąsiednie akapity mają te same właściwości obramowania i wcięcia.

Nie można częściowo zaktualizować obramowania akapitu. Podczas zmiany obramowania akapitu należy określić nowe obramowanie w całości.

borderTop

object (ParagraphBorder)

Obramowanie u góry tego akapitu. Jeśli nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego.

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. Podczas zmiany obramowania akapitu należy określić nowe obramowanie w całości.

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.

Ramki akapitu nie można zaktualizować częściowo. Podczas zmiany obramowania akapitu należy określić nowe obramowanie w całości.

borderLeft

object (ParagraphBorder)

Obramowanie po lewej stronie tego akapitu. Jeśli nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego.

Nie można częściowo zaktualizować obramowania akapitu. Podczas zmiany obramowania akapitu należy określić nowe obramowanie w całości.

borderRight

object (ParagraphBorder)

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

Ramki akapitu nie można zaktualizować częściowo. 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 nie zostanie ustawiona, wartość zostanie odziedziczona 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 nie zostanie ustawiona, wartość zostanie odziedziczona 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 nie zostanie ustawiona, wartość zostanie odziedziczona 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 rozmieszczone 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 przypadku akapitu należy unikać wdółek i odstępów. Jeśli nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego.

shading

object (Shading)

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

pageBreakBefore

boolean

Określa, czy bieżący akapit ma zawsze zaczynać się na początku strony. Jeśli 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 innym przypadku wyrównanie do prawej.
CENTER Akapit jest wyśrodkowany.
END Akapit jest wyrównany do końca wiersza. Wyrównany do prawej w przypadku tekstu w kierunku z lewej do prawej, a w przeciwnym razie wyrównany do lewej.
JUSTIFIED Akapit jest uzasadniony.

ContentDirection

Treści z mapami mogą być przesyłane.

Wartości w polu enum
CONTENT_DIRECTION_UNSPECIFIED Kierunek treści nie jest określony.
LEFT_TO_RIGHT Treści są wyświetlane od lewej do prawej.
RIGHT_TO_LEFT Treści są wyświetlane od prawej do lewej.

SpacingMode

Różne tryby interliniowania akapitów.

Wartości w polu enum
SPACING_MODE_UNSPECIFIED Tryb 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 kresek 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)

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

alignment

enum (TabStopAlignment)

Przystanek wyrównywania tej karty. Jeśli nie zostanie ustawiony, wartością domyślną jest START.

TabStopAlignment

Wyrównanie tabulatora.

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

Cieniowanie

Cieniowanie akapitu.

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

object (OptionalColor)

Kolor tła tego cieniowania akapitu.

SuggestedParagraphStyle

sugerowana zmiana w elemencie ParagraphStyle;

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

object (ParagraphStyle)

ParagraphStyle, który zawiera tylko zmiany wprowadzone w tej 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 w podstawowym ParagraphStyle zostały zmienione w tej propozycji.

ParagraphStyleSuggestionState

Maska wskazująca, które pola w podstawowym ParagraphStyle zostały zmienione w tej propozycji. 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 zasugerowano zmianę na headingId.

namedStyleTypeSuggested

boolean

Wskazuje, czy zasugerowano zmianę na 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 zasugerowano zmianę na direction.

spacingModeSuggested

boolean

Wskazuje, czy zasugerowano zmianę na spacingMode.

spaceAboveSuggested

boolean

Wskazuje, czy zasugerowano zmianę na spaceAbove.

spaceBelowSuggested

boolean

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

borderBetweenSuggested

boolean

Wskazuje, czy zasugerowano zmianę na 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 zasugerowano zmianę na 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 zasugerowano zmianę na indentEnd.

keepLinesTogetherSuggested

boolean

Wskazuje, czy zasugerowano zmianę na keepLinesTogether.

keepWithNextSuggested

boolean

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

avoidWidowAndOrphanSuggested

boolean

Wskazuje, czy zasugerowano zmianę na avoidWidowAndOrphan.

shadingSuggestionState

object (ShadingSuggestionState)

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

pageBreakBeforeSuggested

boolean

Wskazuje, czy 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. W przypadku każdego pola ustawionego na „Prawda” jest nowa sugerowana wartość.

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 odnoszący się do akapitu zastosowany do tego punktu.

SuggestedBullet

sugerowana zmiana w elemencie Bullet;

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

object (Bullet)

Bullet, który zawiera tylko zmiany wprowadzone w tej 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 w podstawowym Bullet zostały zmienione w tej propozycji.

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 sugerowano zmianę w sekcji nestingLevel.

textStyleSuggestionState

object (TextStyleSuggestionState)

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

ObjectReferences

Kolekcja identyfikatorów obiektów.

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

string

Identyfikatory obiektów.

SectionBreak

StructuralElement reprezentujący podział sekcji. Sekcja to zakres treści o tej samej wartości SectionStyle. Podział sekcji oznacza początek nowej sekcji, a styl sekcji ma zastosowanie do sekcji po podziale.

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

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

string

Sugerowane identyfikatory wstawienia. 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 przerwie.

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 jest pusta, zawiera w edytorze Dokumentów jedną kolumnę z właściwościami domyślnymi. Sekcję można zaktualizować tak, aby zawierała maksymalnie 3 kolumny.

Podczas aktualizowania tej właściwości wymagane jest ustawienie konkretnej wartości. Jeśli nie ustawisz tej właściwości, wystąpi błąd 400 „Nieprawidłowe żądanie”.

columnSeparatorStyle

enum (ColumnSeparatorStyle)

Styl separatorów kolumn.

Ten styl można ustawić nawet wtedy, gdy w sekcji jest tylko 1 kolumna.

Podczas aktualizowania tej właściwości należy ustawić konkretną wartość. Jeśli nie ustawisz tej właściwości, wystąpi błąd 400 „Nieprawidłowe żądanie”.

contentDirection

enum (ContentDirection)

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

Podczas aktualizowania tej właściwości należy ustawić konkretną wartość. Wyłączenie tej właściwości powoduje wystąpienie błędu 400 nieprawidłowego żądania.

marginTop

object (Dimension)

Górny margines strony sekcji. Jeśli zasada jest nieskonfigurowana, domyślna wartość z DocumentStyle to marginTop.

Podczas aktualizowania tej właściwości należy ustawić konkretną wartość. Jeśli nie ustawisz tej właściwości, wystąpi błąd 400 „Nieprawidłowe żądanie”.

marginBottom

object (Dimension)

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

Podczas aktualizowania tej właściwości należy ustawić konkretną wartość. Wyłączenie tej właściwości powoduje wystąpienie błędu 400 nieprawidłowego żądania.

marginRight

object (Dimension)

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

Podczas aktualizowania tej właściwości należy ustawić konkretną wartość. Jeśli nie ustawisz tej właściwości, wystąpi błąd 400 „Nieprawidłowe żądanie”.

marginLeft

object (Dimension)

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

Podczas aktualizowania tej właściwości 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ść atrybutu useCustomHeaderFooterMargins w obiekcie DocumentStyle wskazuje, czy w tej sekcji jest uwzględniany margines nagłówka.

Podczas aktualizowania tej właściwości należy ustawić konkretną wartość. Jeśli nie ustawisz tej właściwości, wystąpi błąd 400 „Nieprawidłowe żądanie”.

sectionType

enum (SectionType)

Tylko dane wyjściowe. Typ sekcji.

defaultHeaderId

string

Identyfikator nagłówka domyślnego. Jeśli nie zostanie ustawiony, wartość zostanie odziedziczona z poprzedniego elementu SectionBreak's SectionStyle. Jeśli wartość 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żywanego tylko na pierwszej stronie sekcji. Jeśli useFirstPageHeaderFooter ma wartość prawda, ta wartość jest używana w nagłówku na pierwszej stronie sekcji. Jeśli ma wartość Fałsz, w nagłówku pierwszej strony sekcji jest używany nagłówek defaultHeaderId. Jeśli nie zostanie ustawiony, wartość zostanie odziedziczona z poprzedniego elementu SectionBreak's SectionStyle. Jeśli wartość nie jest ustawiona w pierwszym elemencie SectionBreak, dziedziczy ją z firstPageHeaderId elementu DocumentStyle.

Ta 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 to prawda, ta wartość jest używana w przypadku nagłówków na parzystych stronach sekcji. Jeśli jest to wartość false, nagłówki na stronach parzystych używają wartości defaultHeaderId. Jeśli nie zostanie ustawiony, wartość zostanie odziedziczona z poprzedniego elementu SectionBreak's SectionStyle. Jeśli wartość nie jest ustawiona w pierwszym elemencie SectionBreak, dziedziczy ją z evenPageHeaderId elementu DocumentStyle.

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

pageNumberStart

integer

Numer strony, od której ma się zaczynać zliczanie liczby stron w tej sekcji. Jeśli zasada jest nieskonfigurowana, numerowanie stron jest kontynuowane od poprzedniej sekcji. Jeśli wartość w pierwszym elemencie SectionBreak jest pusta, sprawdź element pageNumberStart obiektu DocumentStyle.

Podczas aktualizowania tej właściwości należy ustawić konkretną wartość. 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 nie zostanie ustawiona, wartość zostanie odziedziczona z flipPageOrientation obiektu DocumentStyle.

Podczas aktualizowania tej właściwości należy ustawić konkretną wartość. Jeśli nie ustawisz tej właściwości, wystąpi błąd 400 „Nieprawidłowe żądanie”.

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.

Wartości w polu enum
COLUMN_SEPARATOR_STYLE_UNSPECIFIED Nieokreślony styl separatora kolumny.
NONE Brak separatorów kolumn między kolumnami.
BETWEEN_EACH_COLUMN Wyświetla linię oddzielającą kolumny.

SectionType

Określa, jak początek bieżącej sekcji jest umieszczony względem poprzedniej sekcji.

Wartości w polu enum
SECTION_TYPE_UNSPECIFIED Typ sekcji jest nieokreślony.
CONTINUOUS Sekcja rozpoczyna się bezpośrednio po ostatnim akapicie poprzedniej sekcji.
NEXT_PAGE Sekcja rozpoczyna się na następnej stronie.

Tabela

StructuralElement reprezentujący tabelę.

Zapis JSON
{
  "rows": integer,
  "columns": integer,
  "tableRows": [
    {
      object (TableRow)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "tableStyle": {
    object (TableStyle)
  }
}
Pola
rows

integer

Liczba wierszy w tabeli.

columns

integer

Liczba kolumn w tabeli.

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

tableRows[]

object (TableRow)

zawartość i styl każdego wiersza,

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

Identyfikatory sugerowanych do usunięcia treści. 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 0) w jednostkach kodu UTF-16.

endIndex

integer

Indeks końcowy tego wiersza (z licznikiem od 0) 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 wstawienia. Jeśli TableRow jest zagnieżdżoną sugerowaną zmianą, może mieć wiele identyfikatorów wstawiania. Jeśli 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 tej komórki (liczony od 0) w jednostkach kodu UTF-16 (bez uwzględnienia).

content[]

object (StructuralElement)

Treść komórki.

tableCellStyle

object (TableCellStyle)

Styl komórki.

suggestedInsertionIds[]

string

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

suggestedDeletionIds[]

string

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

suggestedTableCellStyleChanges

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

Sugerowane zmiany stylu komórki tabeli, posortowane według identyfikatora sugestii.

TableCellStyle

Styl 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

Zakres komórki w wierszach.

Ta usługa jest tylko do odczytu.

columnSpan

integer

Zakres kolumny komórki.

Ta usługa jest tylko do odczytu.

backgroundColor

object (OptionalColor)

Kolor tła komórki.

borderLeft

object (TableCellBorder)

Lewa krawędź komórki.

borderRight

object (TableCellBorder)

Prawa krawędź komórki.

borderTop

object (TableCellBorder)

Górne obramowanie komórki.

borderBottom

object (TableCellBorder)

Dolna krawędź komórki.

paddingLeft

object (Dimension)

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 zawartoś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.

Dane pochodzą z podzbioru wartości „ST_TextAnchoringType” prosty typ 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), 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 dziedziczone z elementu nadrzędnego (jeśli taki istnieje).
CONTENT_ALIGNMENT_UNSUPPORTED Nieobsługiwane wyrównanie treści.
TOP Wyrównanie, które wyrównuje treść do górnej części elementu. Odpowiada ECMA-376 ST_TextAnchoringType „t”.
MIDDLE Wyrównanie, które wyrównuje treść do środka elementu. Odpowiada ECMA-376 ST_TextAnchoringType „ctr”.
BOTTOM Wyrównanie, które wyrównuje treść do dolnej krawędzi elementu. Odpowiada wartości „b” typu ECMA-376 ST_TextAnchoringType.

SuggestedTableCellStyle

sugerowana zmiana w elemencie TableCellStyle;

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

object (TableCellStyle)

TableCellStyle, który zawiera tylko zmiany wprowadzone w tej propozycji. 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 zasugerowano zmianę na borderRight.

borderTopSuggested

boolean

Wskazuje, czy zasugerowano zmianę na borderTop.

borderBottomSuggested

boolean

Wskazuje, czy zasugerowano zmianę na 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 zasugerowano zmianę na paddingTop.

paddingBottomSuggested

boolean

Wskazuje, czy zasugerowano zmianę na paddingBottom.

contentAlignmentSuggested

boolean

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

TableRowStyle

Style stosowane do wiersza tabeli.

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

object (Dimension)

Minimalna wysokość wiersza. Wiersz zostanie wyrenderowany w Edytorze Dokumentów 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 propozycji. Możesz go używać razem z przyciskiem tableRowStyleSuggestionState, aby sprawdzić, które pola się zmieniły i jakie mają teraz wartości.

tableRowStyleSuggestionState

object (TableRowStyleSuggestionState)

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

TableRowStyleSuggestionState

Maska wskazująca, które pola w podstawowym TableRowStyle zostały zmienione w tej propozycji. 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, podobnie jak w kodzie HTML. Właściwości wiersza można znaleźć w elementach tableRowStyle wiersza.

TableColumnProperties

Właściwości kolumny w tabeli.

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

enum (WidthType)

Typ szerokości kolumny.

width

object (Dimension)

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

WidthType

Typ szerokości kolumny.

Wartości w polu enum
WIDTH_TYPE_UNSPECIFIED Typ szerokości kolumny jest nieokreślony.
EVENLY_DISTRIBUTED

Szerokość kolumny jest równomiernie rozłożona między pozostałe kolumny.

Szerokość kolumny jest określana automatycznie i będzie równa części szerokości tabeli po uwzględnieniu wszystkich kolumn o określonej szerokości.

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

TableOfContents

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 jest puste, nie ma żadnych sugerowanych usunięcia tych 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 0.

DocumentStyle

Styl dokumentu.

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

object (Background)

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

defaultHeaderId

string

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

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

evenPageHeaderId

string

Identyfikator nagłówka używanego tylko na stronach 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żywanego tylko na pierwszej stronie. 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 ma być użyta wartość defaultHeaderId, czy ta wartość. Jeśli nie jest ustawiony, nie ma nagłówka pierwszej strony.

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

pageNumberStart

integer

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

marginTop

object (Dimension)

Górny margines 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 spowoduje wyczyszczenie tego dolnego marginesu we wszystkich stylach 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: Określa, czy wymiary pageSize mają być odwrócone, co umożliwia zmianę orientacji strony z poziomej na poziomą i odwrotnie.

Tło

Reprezentuje tło dokumentu.

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

object (OptionalColor)

Kolor tła.

Rozmiar

szerokość i wysokość,

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

object (Dimension)

Wysokość obiektu.

width

object (Dimension)

Szerokość obiektu.

SuggestedDocumentStyle

Zaproponowana zmiana w DocumentStyle.

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

object (DocumentStyle)

DocumentStyle, który zawiera tylko zmiany wprowadzone w tej 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 w podstawowym DocumentStyle zostały zmienione w tej propozycji.

DocumentStyleSuggestionState

Maska wskazująca, które pola w podstawowym DocumentStyle zostały zmienione w tej propozycji. W przypadku każdego pola ustawionego na „Prawda” jest nowa sugerowana wartość.

Zapis JSON
{
  "backgroundSuggestionState": {
    object (BackgroundSuggestionState)
  },
  "defaultHeaderIdSuggested": boolean,
  "defaultFooterIdSuggested": boolean,
  "evenPageHeaderIdSuggested": boolean,
  "evenPageFooterIdSuggested": boolean,
  "firstPageHeaderIdSuggested": boolean,
  "firstPageFooterIdSuggested": boolean,
  "useFirstPageHeaderFooterSuggested": boolean,
  "useEvenPageHeaderFooterSuggested": boolean,
  "pageNumberStartSuggested": boolean,
  "marginTopSuggested": boolean,
  "marginBottomSuggested": boolean,
  "marginRightSuggested": boolean,
  "marginLeftSuggested": boolean,
  "pageSizeSuggestionState": {
    object (SizeSuggestionState)
  },
  "marginHeaderSuggested": boolean,
  "marginFooterSuggested": boolean,
  "useCustomHeaderFooterMarginsSuggested": boolean,
  "flipPageOrientationSuggested": boolean
}
Pola
backgroundSuggestionState

object (BackgroundSuggestionState)

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

defaultHeaderIdSuggested

boolean

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

evenPageHeaderIdSuggested

boolean

Wskazuje, czy zasugerowano zmianę na 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 zasugerowano zmianę na marginTop.

marginBottomSuggested

boolean

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

marginRightSuggested

boolean

Wskazuje, czy zasugerowano zmianę na marginRight.

marginLeftSuggested

boolean

Wskazuje, czy zasugerowano zmianę na marginLeft.

pageSizeSuggestionState

object (SizeSuggestionState)

Maska wskazująca, które 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 zasugerowano zmianę na flipPageOrientation.

BackgroundSuggestionState

Maska wskazująca, które pola w podstawowym Background zostały zmienione w tej propozycji. W przypadku każdego pola ustawionego na „Prawda” element Backgound ma nową sugerowaną wartość.

Zapis JSON
{
  "backgroundColorSuggested": boolean
}
Pola
backgroundColorSuggested

boolean

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

SizeSuggestionState

Maska wskazująca, które pola w podstawowym Size zostały zmienione w tej propozycji. 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 stylu nazwanego.

SuggestedNamedStyles

Zaproponowana zmiana w NamedStyles.

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

object (NamedStyles)

NamedStyles, który zawiera tylko zmiany wprowadzone w tej 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 z pól odpowiedniego pola NamedStyle w styles zostały zmienione w tej sugestii.

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

NamedStyleSuggestionState

Stan sugestii w wiadomości NamedStyle.

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

enum (NamedStyleType)

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 elementach paragraph style zostały zmienione w tej propozycji.

Lista

Lista reprezentuje atrybuty listy dla grupy akapitów, które należą do tej samej listy. Akapit, który jest częścią listy, zawiera w polu bullet odwołanie do identyfikatora listy.

Zapis JSON
{
  "listProperties": {
    object (ListProperties)
  },
  "suggestedListPropertiesChanges": {
    string: {
      object (SuggestedListProperties)
    },
    ...
  },
  "suggestedInsertionId": string,
  "suggestedDeletionIds": [
    string
  ]
}
Pola
listProperties

object (ListProperties)

Właściwości listy.

suggestedListPropertiesChanges

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

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

suggestedInsertionId

string

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

suggestedDeletionIds[]

string

Identyfikatory sugerowanych do usunięcia treści. 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 może mieć maksymalnie 9 poziomów zagnieżdżenia, przy czym poziom 0 odpowiada najwyższemu poziomowi, a poziom 8 – najbardziej zagnieżdżonemu poziomowi. Poziomy zagnieżdżenia są zwracane w kolejności rosnącej, a więc najpierw jest zwracany poziom najmniej zagnieżdżony.

NestingLevel

Zawiera właściwości opisujące wygląd i 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 cyfry w ramach miejsca przeznaczonego na jej wyświetlenie,

glyphFormat

string

Format ciągu używany przez punktory na tym poziomie zagnieżdżenia.

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

Na przykład format znaku %0. wskazuje, że renderowany znak zastąpi miejsce zastępcze odpowiednim znakiem dla poziomu zagnieżdżania 0, po którym następuje kropka jako przyrostek. 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 glifów może zawierać placeholdery dla bieżącego poziomu zagnieżdżenia oraz placeholdery dla nadrzędnych poziomów zagnieżdżenia. Na przykład lista może mieć format znaku %0. na poziomie zagnieżdżenia 0 i format znaku %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żania ciąg znaków, który zastępuje symbol zastępczy w formacie glifu w przypadku danego akapitu, zależy od kolejności akapitu na liście.

indentFirstLine

object (Dimension)

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

indentStart

object (Dimension)

Wielkość wcięcia akapitów na tym poziomie zagnieżdżenia. 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.

Wartość 0 jest traktowana jako wartość 1 w przypadku list z literami i rzymskimi cyframi. 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 unii glyph_kind. Rodzaj glifu używanego przez symbole. 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żania wynosi 0, glyphFormat to %0., a typ glifu to DECIMAL, wyrenderowany glif zastąpi placeholder %0 w formacie glifu liczbą odpowiadającą pozycji elementu na liście.

glyphSymbol

string

Symbol niestandardowego glifu używany przez punktory, gdy akapity na tym poziomie zagnieżdżenia nie są uporzą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 Odznaka jest wyrównana do początku miejsca zarezerwowanego na jej wyrenderowanie. Wyrównany do lewej w przypadku tekstu w kierunku od lewej do prawej, a w przeciwnym razie wyrównany do prawej.
CENTER Punktor jest wyrównany do środka obszaru przeznaczonego na renderowanie punktora.
END Pogrubienie jest wyrównane do końca miejsca przeznaczonego na jego renderowanie. Wyrównany do prawej w przypadku tekstu w kierunku z lewej do prawej, a w przeciwnym razie wyrównany do lewej.

GlyphType

Typy 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 nie został określony lub nie jest obsługiwany.
NONE Pusty ciąg.
DECIMAL Liczba, np. 1, 2 lub 3.
ZERO_DECIMAL Numer, w którym pojedyncze cyfry mają przedrost 0, np. 01, 02 lub 03. Liczby, które zawierają więcej niż jedną cyfrę, nie mają prefiksu zerem.
UPPER_ALPHA duża litera, np. A, B lub C;
ALPHA mała litera, np. a, b lub c;
UPPER_ROMAN Rzymska cyfra w wielkiej literze, np. I, II lub III.
ROMAN Małą rzymską cyfrę, np. i, ii lub iii.

SuggestedListProperties

Zaproponowana zmiana: ListProperties.

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

object (ListProperties)

ListProperties, który zawiera tylko zmiany wprowadzone w tej 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 w podstawowym ListProperties zostały zmienione w tej propozycji. 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 w odpowiednim elemencie NestingLevel w definicji nestingLevels zostały zmienione w tej propozycji.

Stany sugestii poziomu zagnieżchnia są zwracane w kolejności rosnącej według poziomu zagnieżchnia, przy czym najpierw zwracany jest stan najmniej zagnieżdżony.

NestingLevelSuggestionState

Maska wskazująca, które pola 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 zasugerowano zmianę na 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 zasugerowano zmianę na 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 zasugerowano zmianę na startNumber.

NamedRanges

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

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

string

Nazwa 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 o nazwie umożliwiają deweloperom kojarzenie części dokumentu z dowolną etykietą zdefiniowaną przez użytkownika, dzięki czemu ich zawartość może być odczytywana lub edytowana za pomocą kodu. Dokument może zawierać wiele zakresów nazwanych o tej samej nazwie, ale każdy zakres nazwany ma unikalny identyfikator.

Zakres nazwany jest tworzony za pomocą pojedynczego znaku Range, a wstawiane w nim treści zazwyczaj go poszerzają. Jednak niektóre zmiany w dokumencie mogą spowodować podział zakresu na kilka zakresów.

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

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

string

Identyfikator zakresu nazwanego.

name

string

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

W przypadku wszystkich bieżących zastosowań musisz podać indeks początkowy. To pole jest typu Int32Value, aby uwzględnić przyszłe przypadki użycia z nieograniczonymi zakresami.

endIndex

integer

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

W przypadku wszystkich bieżących zastosowań 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, który pojawia się w tekście. Obiekt w tekście zawiera EmbeddedObject, np. obraz.

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

string

Identyfikator tego obiektu wbudowanego. Moż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 właściwości obiektów w tle, posortowane według identyfikatora sugestii.

suggestedInsertionId

string

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

suggestedDeletionIds[]

string

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

InlineObjectProperties

Właściwości InlineObject.

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

object (EmbeddedObject)

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ł obiektu wstawionego. 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 osadzonego obiektu.

linkedContentReference

object (LinkedContentReference)

Odniesienie do treści źródłowych ze źródła zewnętrznego, do którego istnieje link. Na przykład 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 właściwe dla każdego typu obiektu osadzonego. properties może mieć tylko jedną z tych wartości:
embeddedDrawingProperties

object (EmbeddedDrawingProperties)

Właściwości rysunku umieszczonego.

imageProperties

object (ImageProperties)

Właściwości obrazu.

EmbeddedDrawingProperties

Ten typ nie ma pól.

Właściwości 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 z domyślnym czasem trwania 30 minut. Ten identyfikator URI jest oznaczony tagiem konta osoby składającej 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 zakresie [-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 przycięcia jest reprezentowany za pomocą odstępów ułamkowych 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 mają wartość 0, obraz nie jest przycinany.
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

Odsunięcie określa, jak daleko od prawej krawędzi oryginalnych treści znajduje się prawa krawędź prostokąta przycinania. Odsunięcie jest wyrażone jako ułamek szerokości oryginalnych treści.

offsetTop

number

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

Odsunięcie określa, jak daleko od dolnej krawędzi oryginalnej treści znajduje się dolna krawędź prostokąta przycinania. Odsunięcie jest wyrażone jako ułamek wysokości oryginalnej treści.

angle

number

Kąt obrotu prostokąta przycięcia wokół jego środka w radianach. Obrót jest stosowany po przesunięciach.

EmbeddedObjectBorder

Obramowanie wokół EmbeddedObject.

Zapis JSON
{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle),
  "propertyState": enum (PropertyState)
}
Pola
color

object (OptionalColor)

Kolor obramowania.

width

object (Dimension)

Szerokość obramowania.

dashStyle

enum (DashStyle)

Styl kresek obramowania.

propertyState

enum (PropertyState)

Stan właściwości granicy.

PropertyState

Możliwe stany obiektu.

Wartości w polu enum
RENDERED Jeśli stan właściwości to RENDERED, element ma tę właściwość po wyrenderowaniu w dokumencie. jest to wartość domyślna
NOT_RENDERED Jeśli stan właściwości to NOT_RENDERED, element nie ma odpowiedniej właściwości po wyrenderowaniu w dokumencie.

LinkedContentReference

Odniesienie do treści źródłowych ze źródła zewnętrznego, do którego istnieje link.

Zapis JSON
{

  // Union field reference can be only one of the following:
  "sheetsChartReference": {
    object (SheetsChartReference)
  }
  // End of list of possible types for union field reference.
}
Pola
Pole unii reference. Odwołanie specyficzne dla typu powiązanej treści. reference może być tylko jednym z tych elementów:
sheetsChartReference

object (SheetsChartReference)

Odwołuje się 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 zawierającego 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 w podstawowym InlineObjectProperties zostały zmienione w tej propozycji. 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 elementach embeddedObject zostały zmienione w tej propozycji.

EmbeddedObjectSuggestionState

Maska wskazująca, które pola w podstawowym EmbeddedObject zostały zmienione w tej propozycji. 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 elementach imageProperties zostały zmienione w tej propozycji.

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 zasugerowano zmianę na 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 ma 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 zasugerowano zmianę na contentUri.

sourceUriSuggested

boolean

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

brightnessSuggested

boolean

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

contrastSuggested

boolean

Wskazuje, czy zasugerowano zmianę wartości atrybutu [contrast] w atrybucie [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 zasugerowano zmianę na offsetBottom.

angleSuggested

boolean

Wskazuje, czy zasugerowano zmianę na angle.

EmbeddedObjectBorderSuggestionState

Maska wskazująca, które pola na podstawie EmbeddedObjectBorder zostały zmienione w tej sugestii. W przypadku każdego pola ustawionego na „Prawda” jest nowa sugerowana wartość.

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

boolean

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

widthSuggested

boolean

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

dashStyleSuggested

boolean

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

propertyStateSuggested

boolean

Wskazuje, czy zasugerowano zmianę wartości atrybutu [propertyState] w obiekcie [google.apps.docs.v1.EmbeddedBorderObject.property_state].

LinkedContentReferenceSuggestionState

Maska wskazująca, które pola na podstawie LinkedContentReference zostały zmienione w tej sugestii. W przypadku każdego pola ustawionego na „Prawda” jest nowa sugerowana wartość.

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

object (SheetsChartReferenceSuggestionState)

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

SheetsChartReferenceSuggestionState

Maska wskazująca, które pola na podstawie SheetsChartReference zostały zmienione w tej sugestii. W przypadku każdego pola ustawionego na „Prawda” jest nowa sugerowana wartość.

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

boolean

Wskazuje, czy zasugerowano zmianę na spreadsheetId.

chartIdSuggested

boolean

Wskazuje, czy zasugerowano zmianę na chartId.

PositionedObject

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

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

string

Identyfikator tego umieszczonego obiektu.

positionedObjectProperties

object (PositionedObjectProperties)

Właściwości tego obiektu.

suggestedPositionedObjectPropertiesChanges

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

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

suggestedInsertionId

string

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

suggestedDeletionIds[]

string

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

PositionedObjectProperties

Właściwości 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 obiektu.

PositionedObjectPositioning

Pozycjonowanie elementu PositionedObject. Obiekt jest umieszczany względem początku Paragraph, do którego jest przywiązany.

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

enum (PositionedObjectLayout)

Układ tego umieszczonego obiektu.

leftOffset

object (Dimension)

Odsunięcie lewej krawędzi umieszczonego obiektu względem początku elementu Paragraph, z którym jest powiązany powiązanie. Dokładne pozycjonowanie obiektu może zależeć od innych treści w dokumencie i jego stylizacji.

topOffset

object (Dimension)

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

PositionedObjectLayout

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

Wartości w polu enum
POSITIONED_OBJECT_LAYOUT_UNSPECIFIED Układ nie jest określony.
WRAP_TEXT Tekst jest przenoszony na pozycjonowany obiekt.
BREAK_LEFT Dzieli tekst w taki sposób, że umieszczony obiekt jest po lewej stronie, a tekst po prawej.
BREAK_RIGHT Przerwy w tekście, w których obiekt jest po prawej stronie, a tekst po lewej.
BREAK_LEFT_RIGHT Przerywa tekst tak, aby po lewej lub prawej stronie obiektu nie było tekstu.
IN_FRONT_OF_TEXT Obiekt jest umieszczony przed tekstem.
BEHIND_TEXT Obiekt 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 propozycji. 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 w podstawowym PositionedObjectProperties zostały zmienione w tej propozycji. W przypadku każdego pola ustawionego na „Prawda” jest nowa sugerowana wartość.

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

object (PositionedObjectPositioningSuggestionState)

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

embeddedObjectSuggestionState

object (EmbeddedObjectSuggestionState)

Maska wskazująca, które pola w 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 wyświetlania sugestii zastosowany w dokumencie, który wskazuje, jak sugerowane zmiany są reprezentowane. 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 tylko dostęp do wyświetlania, zostanie zastosowany parametr PREVIEW_WITHOUT_SUGGESTIONS. W przeciwnym razie zostanie zastosowany element SUGGESTIONS_INLINE. Jest to domyślny tryb wyświetlania sugestii.
SUGGESTIONS_INLINE

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

Jeśli użytkownik nie ma uprawnień do wyświetlania sugerowanych zmian, żądania pobierania dokumentu w tym trybie zwrócą błąd 403.

PREVIEW_SUGGESTIONS_ACCEPTED

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

Żądania pobrania dokumentu korzystające z tego trybu 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

Wprowadza co najmniej 1 zmianę w dokumencie.

create

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

get

Pobiera najnowszą wersję określonego dokumentu.