REST Resource: documents

Zasób: dokument

dokument w Dokumentach Google,

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

string

Tylko dane wyjściowe. Identyfikator dokumentu.
title

string

Tytuł dokumentu.
tabs[]

object (Tab)

karty, które są częścią dokumentu.

Karty mogą zawierać karty podrzędne, czyli karty umieszczone w innej karcie. Zakładki podrzędne są reprezentowane przez pole Tab.childTabs.
revisionId

string

Tylko dane wyjściowe. Identyfikator wersji dokumentu. Może być używany w żądaniach aktualizacji w celu określenia, do której wersji dokumentu mają zostać zastosowane zmiany, oraz jak żądanie powinno się zachowywać, jeśli dokument został zmieniony od tej wersji. Wypełnione tylko wtedy, gdy użytkownik ma uprawnienia do edycji dokumentu.

Identyfikator wersji to nieciągły ciąg znaków, a nie liczba. Format identyfikatora wersji może się z czasem zmieniać. Zwrócony identyfikator wersji jest gwarantowany tylko przez 24 godziny od momentu jego zwrotu i nie może być udostępniany innym użytkownikom. Jeśli identyfikator wersji nie zmienia się między wywołaniami, oznacza to, że dokument nie został zmieniony. Z kolei zmieniony identyfikator (w przypadku tego samego dokumentu i użytkownika) zwykle oznacza, że dokument został zaktualizowany. Zmiana identyfikatora może być też spowodowana czynnikami wewnętrznymi, np. zmianami formatu identyfikatora.
suggestionsViewMode

enum (SuggestionsViewMode)

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

Uwaga: podczas edytowania dokumentu zmiany muszą być 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 zasada ma wartość false lub jest nieskonfigurowana, to pole zawiera informacje o pierwszej karcie w dokumencie.
headers

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

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

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, posortowane według identyfikatora przypisu;

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

object (DocumentStyle)

Tylko dane wyjściowe. Styl dokumentu.

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

object (NamedStyles)

Tylko dane wyjściowe. Nazwane style dokumentu.

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

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

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

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

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

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

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

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

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

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

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

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

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 false lub nie jest ustawione, to pole zawiera informacje o pierwszej karcie w dokumencie.

Tab

Karta w dokumencie.

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

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

object (TabProperties)

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

object (Tab)

Karty podrzędne umieszczone na tej karcie.
Pole unii content. Treść karty. content może mieć tylko jedną z tych wartości:
documentTab

object (DocumentTab)

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

TabProperties

Właściwości karty.

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

string

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

string

Nazwa karty widoczna dla użytkownika.
parentTabId

string

Opcjonalnie: Identyfikator karty nadrzędnej. Pusty, gdy bieżąca karta jest kartą na poziomie katalogu głównego, co oznacza, że nie ma żadnych elementów nadrzędnych.
index

integer

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

integer

Tylko dane wyjściowe. Głębokość karty w dokumencie. Karty na poziomie wyższym zaczynają się od 0.

DocumentTab

Karta z treścią dokumentu.

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

object (Body)

Główna część karty dokumentu.
headers

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

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

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

Stopki na karcie dokumentu, 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 dokumentu, posortowane według identyfikatora listy;
namedRanges

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

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

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

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

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

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)

Treść wiadomości.

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

StructuralElement

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

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

  // Union field content can be only one of the following:
  "paragraph": {
    object (Paragraph)
  },
  "sectionBreak": {
    object (SectionBreak)
  },
  "table": {
    object (Table)
  },
  "tableOfContents": {
    object (TableOfContents)
  }
  // End of list of possible types for union field content.
}
Pola
startIndex

integer

Indeks początkowy tego elementu strukturalnego liczony od 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 unii content. Zawartość elementu strukturalnego. content może być tylko jednym z tych elementów:
paragraph

object (Paragraph)

Element strukturalny typu akapit.
sectionBreak

object (SectionBreak)

Element strukturalny typu podział na sekcje.
table

object (Table)

Typ tabeli jako element strukturalny.
tableOfContents

object (TableOfContents)

Element strukturalny typu spis treści.

Akapit

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

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

object (ParagraphElement)

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

object (ParagraphStyle)

Styl tego akapitu.
suggestedParagraphStyleChanges

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

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

object (Bullet)

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

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

Sugerowane zmiany w punkcie w tym akapicie.
positionedObjectIds[]

string

Identyfikatory obiektów powiązanych z tym akapitem.
suggestedPositionedObjectIds

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

Identyfikatory obiektów z pozycjonowaniem, które mają być dołączone do tego akapitu, z kluczem identyfikatora sugestii.

ParagraphElement

Element ParagraphElement opisuje treść w elemencie Paragraph.

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

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

integer

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

integer

Indeks końcowy 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 tekstu.
autoText

object (AutoText)

Element akapitu z tekstem automatycznym.
pageBreak

object (PageBreak)

Element akapitu z podziałem strony.
columnBreak

object (ColumnBreak)

Element akapitu z podziałem na kolumny.
footnoteReference

object (FootnoteReference)

Element akapitu odwołania do przypisu.
horizontalRule

object (HorizontalRule)

Element akapitu z linijką poziomą.
equation

object (Equation)

Element akapitu równania.
inlineObjectElement

object (InlineObjectElement)

Wbudowany element akapitu obiektu.
person

object (Person)

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

TextRun

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

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

string

Tekst tego uruchomienia.

Wszystkie elementy inne niż tekstowe w sesji 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 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 przebiegu.
suggestedTextStyleChanges

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

Styl sugerowanego tekstu zmienia się w tym przebiegu, a jako klucz używany jest identyfikator sugestii.

TextStyle

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

Odziedziczone style tekstu są w tej wiadomości reprezentowane jako pola nieskonfigurowane. Element nadrzędny stylu tekstu zależy od miejsca zdefiniowania stylu:

  • Styl tekstu w elementach Paragraph dziedziczy się z odpowiednich elementów named style type.
  • Styl tekstu w elementach named style dziedziczy styl o nazwie normal text.
  • Styl tekstu normal text dziedziczy styl tekstu domyślnego w edytorze Dokumentów.
  • Styl tekstu elementu Paragraph zawartego w tabeli może dziedziczyć styl tekstu od stylu tabeli.

Jeśli styl tekstu nie dziedziczy ustawień od elementu nadrzędnego, odznaczenie pól spowoduje przywrócenie stylu do wartości domyślnych w edytorze Dokumentów.

Zapis JSON 
{
  "bold": boolean,
  "italic": boolean,
  "underline": boolean,
  "strikethrough": boolean,
  "smallCaps": boolean,
  "backgroundColor": {
    object (OptionalColor)
  },
  "foregroundColor": {
    object (OptionalColor)
  },
  "fontSize": {
    object (Dimension)
  },
  "weightedFontFamily": {
    object (WeightedFontFamily)
  },
  "baselineOffset": enum (BaselineOffset),
  "link": {
    object (Link)
  }
}
Pola
bold

boolean

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

boolean

Określa, czy tekst jest kursywą.
underline

boolean

Określa, czy tekst jest podkreślony.
strikethrough

boolean

Określa, czy tekst jest przekreślony.
smallCaps

boolean

czy tekst jest zapisany małymi literami.
backgroundColor

object (OptionalColor)

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

object (OptionalColor)

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

object (Dimension)

Rozmiar czcionki tekstu.
weightedFontFamily

object (WeightedFontFamily)

Rodzina czcionek i renderowana grubość tekstu.

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

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

Jeśli 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)

Pionowe przesunięcie tekstu od jego normalnej pozycji.

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

OptionalColor

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

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

object (Color)

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

Kolor

jednolity kolor;

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

object (RgbColor)

Wartość koloru RGB.

RgbColor

Kolor RGB.

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

number

Skł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 to 1/72 cala.

WeightedFontFamily

Reprezentuje rodzinę czcionek i grubość tekstu.

Zapis JSON 
{
  "fontFamily": string,
  "weight": integer
}
Pola
fontFamily

string

Rodzina czcionek tekstu.

Rodzina czcionek może być dowolną czcionką z menu czcionek w Dokumentach lub z Google Fonts. Jeśli nazwa czcionki nie jest rozpoznawana, tekst jest renderowany w czcionce Arial.
weight

integer

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

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

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

  • Jeśli tekst jest pogrubiony, a 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

Sposoby, w jakie tekst może być przesunięty w pionie od swojej normalnej pozycji.

Wartości w polu enum
BASELINE_OFFSET_UNSPECIFIED Odsunięcie linii bazowej tekstu jest dziedziczone z elementu nadrzędnego.
NONE Tekst nie jest przesunięty w pionie.
SUPERSCRIPT Tekst jest przesunięty w górę (wysokodruk).
SUBSCRIPT Tekst jest przesunięty w dół (pod indeksem).

SuggestedTextStyle

sugerowana zmiana w elemencie TextStyle;

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

object (TextStyle)

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

object (TextStyleSuggestionState)

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

TextStyleSuggestionState

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

Zapis JSON 
{
  "boldSuggested": boolean,
  "italicSuggested": boolean,
  "underlineSuggested": boolean,
  "strikethroughSuggested": boolean,
  "smallCapsSuggested": boolean,
  "backgroundColorSuggested": boolean,
  "foregroundColorSuggested": boolean,
  "fontSizeSuggested": boolean,
  "weightedFontFamilySuggested": boolean,
  "baselineOffsetSuggested": boolean,
  "linkSuggested": boolean
}
Pola
boldSuggested

boolean

Wskazuje, czy zasugerowano zmianę na bold.
italicSuggested

boolean

Wskazuje, czy zasugerowano zmianę na italic.
underlineSuggested

boolean

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

boolean

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

boolean

Wskazuje, czy zasugerowano zmianę na smallCaps.
backgroundColorSuggested

boolean

Wskazuje, czy zasugerowano zmianę na backgroundColor.
foregroundColorSuggested

boolean

Wskazuje, czy zasugerowano zmianę na foregroundColor.
fontSizeSuggested

boolean

Wskazuje, czy zasugerowano zmianę na fontSize.
weightedFontFamilySuggested

boolean

Wskazuje, czy zasugerowano zmianę na weightedFontFamily.
baselineOffsetSuggested

boolean

Wskazuje, czy zasugerowano zmianę na baselineOffset.

AutoText

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

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

enum (Type)

Typ tego automatycznego tekstu.
suggestedInsertionIds[]

string

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

string

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

object (TextStyle)

Styl tekstu tego tekstu automatycznego.
suggestedTextStyleChanges

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

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

Typ

Typy automatycznego tekstu.

Wartości w polu enum
TYPE_UNSPECIFIED Nieokreślony typ tekstu automatycznego.
PAGE_NUMBER Wpisz tekst automatyczny, który będzie reprezentować bieżący numer strony.
PAGE_COUNT Wpisz tekst automatyczny, który będzie reprezentować łączną liczbę stron w dokumencie.

PageBreak

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

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

string

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

string

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

object (TextStyle)

Styl tekstu tego wcięcia strony.

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

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

Styl sugerowanego tekstu zmienia się na ten zdefiniowany w elemencie PageBreak, którego kluczem jest identyfikator sugestii.

ColumnBreak

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

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

string

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

string

Identyfikatory sugerowanych do usunięcia 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 treści tekstowych, 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 zmienia się na ten element BreakInColumn, którego kluczem jest identyfikator 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 footnote zawierający treść tego odwołania do przypisu.
footnoteNumber

string

Wyrenderowany numer tego przypisu.
suggestedInsertionIds[]

string

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

string

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

object (TextStyle)

Styl tekstu tego odwołania do przypisu.
suggestedTextStyleChanges

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

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

HorizontalRule

ParagraphElement reprezentuje linię poziomą.

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

string

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

string

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

object (TextStyle)

Styl tekstu tej poziomej linii.

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

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

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

Równanie

ParagraphElement reprezentujące równanie.

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

string

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

string

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

InlineObjectElement

Element ParagraphElement zawierający element InlineObject.

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

string

Identyfikator elementu InlineObject, który zawiera ten element.
suggestedInsertionIds[]

string

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

string

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

object (TextStyle)

Styl tekstu tego elementu wbudowanego.

Podobnie jak w przypadku zawartości tekstowej, np. ciągów tekstowych i odniesień do przypisów, styl tekstu elementu obiektu wstawionego w tekście może wpływać na układ treści oraz styl tekstu wstawionego obok.
suggestedTextStyleChanges

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

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

Osoba

osoba lub adres e-mail wymieniony w dokumencie. Te wzmianki działają jak pojedynczy, niezmienny element zawierający imię i nazwisko lub adres e-mail osoby.

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

string

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

string

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

string

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

object (TextStyle)

Styl tekstu w tym Person.
suggestedTextStyleChanges

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

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

object (PersonProperties)

Tylko dane wyjściowe. Właściwości tego elementu Person. To pole jest zawsze 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 zamiast adresu 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 specyficzne dla RichLink.

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

string

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

string

Tylko dane wyjściowe. Identyfikator URI RichLink. Ta wartość jest zawsze dostępna.
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.

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

  • Styl akapitu w elementach Paragraph dziedziczy ustawienia z odpowiadających elementów named style type.
  • Styl akapitu w elementach named style dziedziczy styl o nazwie normal text.
  • Styl akapitu normal text dziedziczy styl akapitu domyślnego w edytorze Dokumentów.
  • Styl akapitu elementu Paragraph zawartego w tabeli może odziedziczyć styl akapitu od stylu tabeli.

Jeśli styl akapitu nie dziedziczy ustawień od elementu nadrzędnego, odznaczenie pól spowoduje przywrócenie stylu do wartości domyślnej w edytorze Dokumentów.

Zapis JSON 
{
  "headingId": string,
  "namedStyleType": enum (NamedStyleType),
  "alignment": enum (Alignment),
  "lineSpacing": number,
  "direction": enum (ContentDirection),
  "spacingMode": enum (SpacingMode),
  "spaceAbove": {
    object (Dimension)
  },
  "spaceBelow": {
    object (Dimension)
  },
  "borderBetween": {
    object (ParagraphBorder)
  },
  "borderTop": {
    object (ParagraphBorder)
  },
  "borderBottom": {
    object (ParagraphBorder)
  },
  "borderLeft": {
    object (ParagraphBorder)
  },
  "borderRight": {
    object (ParagraphBorder)
  },
  "indentFirstLine": {
    object (Dimension)
  },
  "indentStart": {
    object (Dimension)
  },
  "indentEnd": {
    object (Dimension)
  },
  "tabStops": [
    {
      object (TabStop)
    }
  ],
  "keepLinesTogether": boolean,
  "keepWithNext": boolean,
  "avoidWidowAndOrphan": boolean,
  "shading": {
    object (Shading)
  },
  "pageBreakBefore": boolean
}
Pola
headingId

string

Identyfikator nagłówka akapitu. Jeśli 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 wierszami wyrażony jako procent normalnej wartości, gdzie norma jest przedstawiona jako 100, 0. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.
direction

enum (ContentDirection)

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

enum (SpacingMode)

Tryb ustawień odstępów w akapicie.
spaceAbove

object (Dimension)

Ilość dodatkowego miejsca nad akapitem. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona 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.

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

object (ParagraphBorder)

Obramowanie u góry tego akapitu. Jeśli 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.

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

object (ParagraphBorder)

obramowanie na dole tego akapitu. Jeśli nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego.

Dolna krawędź jest renderowana, gdy akapit poniżej ma inne właściwości obramowania i wcięcia.

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

object (ParagraphBorder)

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

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

object (ParagraphBorder)

Obrzeże po prawej stronie tego akapitu. Jeśli nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego.

Ramki akapitu nie można zaktualizować częściowo. 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)

Odstęp akapitu po stronie odpowiadającej początkowi tekstu, na podstawie bieżącego kierunku akapitu. Jeśli nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego.
indentEnd

object (Dimension)

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 przystankó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 nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego.
keepWithNext

boolean

Określa, czy w miarę możliwości co najmniej część tego akapitu powinna być umieszczona na tej samej stronie lub w tej samej kolumnie co następny akapit. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.
avoidWidowAndOrphan

boolean

Określa, czy w akapicie unikać wd i sierot. Jeśli nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego.
shading

object (Shading)

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

boolean

Określa, czy bieżący akapit ma zawsze zaczynać się na początku strony. Jeśli nie zostanie ustawiona, wartość zostanie odziedziczona z elementu nadrzędnego.

Próba zaktualizowania 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 Nieokreślony typ nazwanego stylu.
NORMAL_TEXT Zwykły tekst.
TITLE Tytuł.
SUBTITLE Napisy.
HEADING_1 Nagłówek 1.
HEADING_2 Nagłówek 2.
HEADING_3 Nagłówek 3.
HEADING_4 Nagłówek 4.
HEADING_5 Nagłówek 5.
HEADING_6 Nagłówek 6.

Wyrównanie

Typy wyrównania tekstu w akapicie.

Wartości w polu enum
ALIGNMENT_UNSPECIFIED Wyrównanie akapitu jest dziedziczone z elementu nadrzędnego.
START Akapit jest wyrównany do początku wiersza. Wyrównany do lewej w przypadku tekstu w kierunku z lewej do prawej, a w przeciwnym razie wyrównany do prawej.
CENTER Akapit jest wyśrodkowany.
END Akapit jest wyrównany do końca wiersza. Wyrównany do prawej w przypadku tekstu w kierunku z lewej do prawej, a w przeciwnym razie wyrównany do lewej.
JUSTIFIED Akapit jest wyjustowany.

ContentDirection

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

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

SpacingMode

Różne tryby interliniowania akapitów.

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

ParagraphBorder

Obramowanie akapitu.

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

object (OptionalColor)

Kolor obramowania.
width

object (Dimension)

Szerokość obramowania.
padding

object (Dimension)

Dopełnienie obramowania.
dashStyle

enum (DashStyle)

Styl kresek obramowania.

DashStyle

Rodzaje kresek, za pomocą których można renderować geometrię liniową. Te wartości są oparte na typie „ST_PresetLineDashVal” opisanym w sekcji 20.1.10.48 dokumentu „Office Open XML File Formats – Fundamentals and Markup Language Reference” (Formaty plików Open XML pakietu Office – podstawy i odniesienia do języka znaczników), część 1, ECMA-376, wydanie 4.

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 przerywana. Odpowiada wartości „dot” (kropka) w standardzie ECMA-376 ST_PresetLineDashVal.
DASH Linia przerywana. Odpowiada wartości „dash” (kreska) w standardzie ECMA-376 ST_PresetLineDashVal.

TabStop

tabulacja w akapicie.

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

object (Dimension)

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

enum (TabStopAlignment)

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

TabStopAlignment

Wyrównanie tabulatora.

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

Cieniowanie

Cieniowanie akapitu.

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

object (OptionalColor)

Kolor tła cieniowania tego akapitu.

SuggestedParagraphStyle

sugerowana zmiana w elemencie ParagraphStyle;

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

object (ParagraphStyle)

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

object (ParagraphStyleSuggestionState)

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

ParagraphStyleSuggestionState

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

Zapis JSON 
{
  "headingIdSuggested": boolean,
  "namedStyleTypeSuggested": boolean,
  "alignmentSuggested": boolean,
  "lineSpacingSuggested": boolean,
  "directionSuggested": boolean,
  "spacingModeSuggested": boolean,
  "spaceAboveSuggested": boolean,
  "spaceBelowSuggested": boolean,
  "borderBetweenSuggested": boolean,
  "borderTopSuggested": boolean,
  "borderBottomSuggested": boolean,
  "borderLeftSuggested": boolean,
  "borderRightSuggested": boolean,
  "indentFirstLineSuggested": boolean,
  "indentStartSuggested": boolean,
  "indentEndSuggested": boolean,
  "keepLinesTogetherSuggested": boolean,
  "keepWithNextSuggested": boolean,
  "avoidWidowAndOrphanSuggested": boolean,
  "shadingSuggestionState": {
    object (ShadingSuggestionState)
  },
  "pageBreakBeforeSuggested": boolean
}
Pola
headingIdSuggested

boolean

Wskazuje, czy zasugerowano zmianę na headingId.
namedStyleTypeSuggested

boolean

Wskazuje, czy zasugerowano zmianę na namedStyleType.
alignmentSuggested

boolean

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

boolean

Wskazuje, czy zasugerowano zmianę na lineSpacing.
directionSuggested

boolean

Wskazuje, czy zasugerowano zmianę na direction.
spacingModeSuggested

boolean

Wskazuje, czy zasugerowano zmianę na spacingMode.
spaceAboveSuggested

boolean

Wskazuje, czy zasugerowano zmianę na spaceAbove.
spaceBelowSuggested

boolean

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

boolean

Wskazuje, czy zasugerowano zmianę na borderBetween.
borderTopSuggested

boolean

Wskazuje, czy zasugerowano zmianę na borderTop.
borderBottomSuggested

boolean

Wskazuje, czy zasugerowano zmianę na borderBottom.
borderLeftSuggested

boolean

Wskazuje, czy zasugerowano zmianę na borderLeft.
borderRightSuggested

boolean

Wskazuje, czy zasugerowano zmianę na borderRight.
indentFirstLineSuggested

boolean

Wskazuje, czy zasugerowano zmianę na indentFirstLine.
indentStartSuggested

boolean

Wskazuje, czy zasugerowano zmianę na indentStart.
indentEndSuggested

boolean

Wskazuje, czy zasugerowano zmianę na indentEnd.
keepLinesTogetherSuggested

boolean

Wskazuje, czy zasugerowano zmianę na keepLinesTogether.
keepWithNextSuggested

boolean

Wskazuje, czy zasugerowano zmianę na keepWithNext.
avoidWidowAndOrphanSuggested

boolean

Wskazuje, czy zasugerowano zmianę na avoidWidowAndOrphan.
shadingSuggestionState

object (ShadingSuggestionState)

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

boolean

Wskazuje, czy zasugerowano zmianę na pageBreakBefore.

ShadingSuggestionState

Maska wskazująca, które pola w podstawowym Shading zostały zmienione w sugerowanej zmianie. Dla każdego pola z wartością true (prawda) pojawi się nowa wartość sugerowana.

Zapis JSON 
{
  "backgroundColorSuggested": boolean
}
Pola
backgroundColorSuggested

boolean

Wskazuje, czy sugerowano zmianę w sekcji Shading.

Punktor

Opisuje punkt akapitu.

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

string

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

integer

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

object (TextStyle)

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

SuggestedBullet

sugerowana zmiana w elemencie Bullet;

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

object (Bullet)

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

object (BulletSuggestionState)

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

BulletSuggestionState

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

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

boolean

Wskazuje, czy zasugerowano zmianę w sekcji listId.
nestingLevelSuggested

boolean

Wskazuje, czy sugerowano zmianę w sekcji nestingLevel.
textStyleSuggestionState

object (TextStyleSuggestionState)

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

ObjectReferences

Kolekcja identyfikatorów obiektów.

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

string

Identyfikatory obiektów.

SectionBreak

StructuralElement oznaczający podział sekcji. Sekcja to zakres treści o tych samych parametrach 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 wstawień. Jeśli SectionBreak 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.
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 ta sekcja będzie pusta, sekcja będzie zawierać jedną kolumnę z domyślnymi właściwościami w edytorze Dokumentów. Sekcję można zaktualizować tak, aby zawierała maksymalnie 3 kolumny.

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

enum (ColumnSeparatorStyle)

Styl separatorów kolumn.

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

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

enum (ContentDirection)

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

Podczas aktualizowania tej właściwości należy ustawić konkretną wartość. 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 nie zostanie ustawiony, wartość domyślna to marginTop z DocumentStyle.

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

object (Dimension)

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

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

object (Dimension)

Prawy margines strony sekcji. Jeśli nie zostanie ustawiony, wartość domyślna to marginRight z DocumentStyle. 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 strony sekcji. Jeśli nie zostanie ustawiony, wartość domyślna to marginLeft z DocumentStyle. 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 należy ustawić konkretną wartość. Jeśli nie ustawisz tej właściwości, wystąpi błąd 400 „Nieprawidłowe żądanie”.
marginHeader

object (Dimension)

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

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

enum (SectionType)

Tylko dane wyjściowe. Typ sekcji.
defaultHeaderId

string

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

Ta usługa jest tylko do odczytu.
firstPageHeaderId

string

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

Ta usługa jest tylko do odczytu.
firstPageFooterId

string

Identyfikator stopki używanej tylko dla pierwszej strony sekcji. Jeśli useFirstPageHeaderFooter ma wartość Prawda, ta wartość jest używana w stopce na pierwszej stronie sekcji. Jeśli jest ustawiona na wartość false, stopka na pierwszej stronie sekcji używa wartości defaultFooterId. 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 firstPageFooterId w DocumentStyle.

Ta usługa jest tylko do odczytu.
evenPageHeaderId

string

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

Ta usługa jest tylko do odczytu.
evenPageFooterId

string

Identyfikator stopki używanej tylko na stronach parzystych. Jeśli wartość useEvenPageHeaderFooter w DocumentStyle ma wartość true, jest ona używana w stopkach na parzystych stronach w sekcji. Jeśli jest ustawiona wartość false, stopki na stronach parzystych używają wartości defaultFooterId. 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 evenPageFooterId elementu DocumentStyle.

Ta usługa jest tylko do odczytu.
useFirstPageHeaderFooter

boolean

Wskazuje, czy dla pierwszej strony sekcji należy używać identyfikatorów nagłówka / stopki pierwszej strony. Jeśli zasada jest nieskonfigurowana, dziedziczy z klasy useFirstPageHeaderFooter w pierwszej sekcji elementu DocumentStyle. Jeśli wartość nie jest ustawiona w przypadku kolejnych sektorów, należy ją interpretować jako wartość fałsz.

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

integer

Numer strony, od której ma się zaczynać zliczanie liczby stron w tej sekcji. Jeśli nie jest ustawiony, numerowanie stron jest kontynuowane z poprzedniej sekcji. Jeśli wartość nie jest ustawiona w pierwszym SectionBreak, sprawdź pageNumberStart w DocumentStyle.

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

boolean

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

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

SectionColumnProperties

Właściwości, które mają zastosowanie do kolumny sekcji.

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

object (Dimension)

Tylko dane wyjściowe. Szerokość kolumny.
paddingEnd

object (Dimension)

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 linii rozdzielających kolumny.
BETWEEN_EACH_COLUMN Renderuje separator kolumn między poszczególnymi kolumnami.

SectionType

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

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

Tabela

StructuralElement reprezentujący tabelę.

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

integer

Liczba wierszy w tabeli.
columns

integer

Liczba kolumn w tabeli.

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

object (TableRow)

Treść i styl każdego wiersza.
suggestedInsertionIds[]

string

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

string

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

object (TableStyle)

Styl tabeli.

TableRow

Treść i styl wiersza w Table.

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

integer

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

integer

Indeks końcowy tego wiersza (z licznikiem od 0) w jednostkach kodu UTF-16.
tableCells[]

object (TableCell)

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

Tabela może mieć kształt nieprostokątny, więc niektóre wiersze mogą mieć inną liczbę komórek niż inne wiersze w tej samej tabeli.
suggestedInsertionIds[]

string

Sugerowane identyfikatory wstawień. Jeśli TableRow jest zagnieżdżoną sugerowaną zmianą, może mieć wiele identyfikatorów wstawiania. Jeśli pole jest puste, nie jest to sugerowana wstawka.
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ę na ten wiersz, którego kluczem jest identyfikator 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 0) w jednostkach kodu UTF-16.
endIndex

integer

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

object (StructuralElement)

Treść komórki.
tableCellStyle

object (TableCellStyle)

Styl komórki.
suggestedInsertionIds[]

string

Sugerowane identyfikatory 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 pole jest puste, nie są sugerowane usunięcia treści.
suggestedTableCellStyleChanges

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

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

TableCellStyle

Styl TableCell.

Styly komórek tabeli odziedziczone są w tym komunikacie reprezentowane jako pola nieprzypisane. Styl komórki tabeli może odziedziczyć styl tabeli.

Zapis JSON 
{
  "rowSpan": integer,
  "columnSpan": integer,
  "backgroundColor": {
    object (OptionalColor)
  },
  "borderLeft": {
    object (TableCellBorder)
  },
  "borderRight": {
    object (TableCellBorder)
  },
  "borderTop": {
    object (TableCellBorder)
  },
  "borderBottom": {
    object (TableCellBorder)
  },
  "paddingLeft": {
    object (Dimension)
  },
  "paddingRight": {
    object (Dimension)
  },
  "paddingTop": {
    object (Dimension)
  },
  "paddingBottom": {
    object (Dimension)
  },
  "contentAlignment": enum (ContentAlignment)
}
Pola
rowSpan

integer

Zakres komórki w wierszach.

Ta usługa jest tylko do odczytu.
columnSpan

integer

Zakres kolumny komórki.

Ta usługa jest tylko do odczytu.
backgroundColor

object (OptionalColor)

Kolor tła komórki.
borderLeft

object (TableCellBorder)

Lewa krawędź komórki.
borderRight

object (TableCellBorder)

Prawa krawędź komórki.
borderTop

object (TableCellBorder)

Górne obramowanie komórki.
borderBottom

object (TableCellBorder)

Dolna krawędź komórki.
paddingLeft

object (Dimension)

Wypełnienie z lewej strony komórki.
paddingRight

object (Dimension)

Prawy margines komórki.
paddingTop

object (Dimension)

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

object (Dimension)

Dopełnienie komórki u dołu.
contentAlignment

enum (ContentAlignment)

Wyrównanie zawartości w komórce tabeli. Domyślne wyrównanie odpowiada wyrównaniu nowo utworzonych komórek tabeli w edytorze Dokumentów.

TableCellBorder

Obramowanie komórki tabeli.

Ramki komórek tabeli nie mogą być przezroczyste. Aby ukryć obramowanie komórki tabeli, ustaw jego szerokość na 0.

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

object (OptionalColor)

Kolor obramowania.

Ten kolor nie może być przezroczysty.
width

object (Dimension)

Szerokość obramowania.
dashStyle

enum (DashStyle)

Styl obramowania.

ContentAlignment

Typy dopasowania treści.

Oparty na podzbiorze wartości prostego typu „ST_TextAnchoringType” opisanego w sekcji 20.1.10.59 w artykule „Office Open XML File Formats - Fundamentals and Markup Language Reference” (formaty plików Office Open XML – podstawowe informacje i znaczniki języka), część 1 ECMA-376 4th edition.

Wartości w polu enum
CONTENT_ALIGNMENT_UNSPECIFIED Nieokreślone wyrównanie treści. Wyrównanie treści jest przejmowane z elementu nadrzędnego (jeśli taki istnieje).
CONTENT_ALIGNMENT_UNSUPPORTED Nieobsługiwane wyrównanie treści.
TOP Wyrównanie, które wyrównuje treść do górnej części elementu. Odpowiada wartości „t” typu ST_TextAnchoringType w standardzie ECMA-376.
MIDDLE Wyrównanie, które wyrównuje treść do środka elementu. Odpowiada wartości ECMA-376 ST_TextAnchoringType „ctr”.
BOTTOM Wyrównanie, które wyrównuje treść do dołu właściciela treści. Odpowiada wartości „b” typu ECMA-376 ST_TextAnchoringType.

SuggestedTableCellStyle

sugerowana zmiana w elemencie TableCellStyle;

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

object (TableCellStyle)

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

object (TableCellStyleSuggestionState)

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

TableCellStyleSuggestionState

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

Zapis JSON 
{
  "rowSpanSuggested": boolean,
  "columnSpanSuggested": boolean,
  "backgroundColorSuggested": boolean,
  "borderLeftSuggested": boolean,
  "borderRightSuggested": boolean,
  "borderTopSuggested": boolean,
  "borderBottomSuggested": boolean,
  "paddingLeftSuggested": boolean,
  "paddingRightSuggested": boolean,
  "paddingTopSuggested": boolean,
  "paddingBottomSuggested": boolean,
  "contentAlignmentSuggested": boolean
}
Pola
rowSpanSuggested

boolean

Wskazuje, czy zasugerowano zmianę na rowSpan.
columnSpanSuggested

boolean

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

boolean

Wskazuje, czy zasugerowano zmianę na backgroundColor.
borderLeftSuggested

boolean

Wskazuje, czy zasugerowano zmianę na borderLeft.
borderRightSuggested

boolean

Wskazuje, czy zasugerowano zmianę na borderRight.
borderTopSuggested

boolean

Wskazuje, czy zasugerowano zmianę na borderTop.
borderBottomSuggested

boolean

Wskazuje, czy zasugerowano zmianę na borderBottom.
paddingLeftSuggested

boolean

Wskazuje, czy zasugerowano zmianę na paddingLeft.
paddingRightSuggested

boolean

Wskazuje, czy zasugerowano zmianę na paddingRight.
paddingTopSuggested

boolean

Wskazuje, czy zasugerowano zmianę na paddingTop.
paddingBottomSuggested

boolean

Wskazuje, czy zasugerowano zmianę na paddingBottom.
contentAlignmentSuggested

boolean

Wskazuje, czy 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 z wysokością równą tej wartości lub większą, aby pokazać całą zawartość komórek wiersza.
tableHeader

boolean

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

boolean

Określa, czy wiersz nie może się rozlać na kolejne strony lub poza granice kolumny.

SuggestedTableRowStyle

sugerowana zmiana w elemencie TableRowStyle;

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

object (TableRowStyle)

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

object (TableRowStyleSuggestionState)

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

TableRowStyleSuggestionState

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

Zapis JSON 
{
  "minRowHeightSuggested": boolean
}
Pola
minRowHeightSuggested

boolean

Wskazuje, czy zasugerowano zmianę na minRowHeight.

TableStyle

Style stosowane do tabeli.

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

object (TableColumnProperties)

Właściwości każdej kolumny.

Pamiętaj, że w Dokumentach tabele zawierają wiersze, a wiersze zawierają komórki, podobnie jak w kodzie HTML. Właściwości wiersza można znaleźć w elementach tableRowStyle 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 inne kolumny o równej szerokości.

Szerokość kolumny jest określana automatycznie i będzie równa części szerokości tabeli po uwzględnieniu wszystkich kolumn o określonej szerokości.
FIXED_WIDTH Stała szerokość kolumny. Właściwość [width][google.apps.docs.v1.TableColumnProperties.width] zawiera szerokość kolumny.

TableOfContents

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 wstawień. Jeśli TableOfContents jest zagnieżdżoną sugerowaną zmianą, może mieć wiele identyfikatorów wstawienia. Jeśli jest puste, nie jest to sugerowane wstawienie.
suggestedDeletionIds[]

string

Identyfikatory sugerowanych do usunięcia treści. 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ło dokumentu. Tło dokumentów nie może być przezroczyste.
defaultHeaderId

string

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

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

string

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

Ta usługa jest tylko do odczytu.
evenPageFooterId

string

Identyfikator stopki używanej tylko na stronach parzystych. Wartość parametru useEvenPageHeaderFooter określa, czy w stopce na stronach parzystych ma być używana wartość parametru defaultFooterId czy parametr useEvenPageHeaderFooter. Jeśli nie jest ustawiony, nie ma stopki stron parzystych.

Ta usługa jest tylko do odczytu.
firstPageHeaderId

string

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

Ta usługa jest tylko do odczytu.
firstPageFooterId

string

Identyfikator stopki używany tylko dla pierwszej strony. Jeśli nie jest ustawiony, na pierwszej stronie nie ma unikalnej stopki. Wartość useFirstPageHeaderFooter określa, czy w stopce na pierwszej stronie ma być używana wartość defaultFooterId, czy ta wartość. Jeśli nie jest ustawiona, nie ma stopki pierwszej strony.

Ta usługa jest tylko do odczytu.
useFirstPageHeaderFooter

boolean

Wskazuje, czy na pierwszej stronie mają być używane identyfikatory nagłówka / stopki pierwszej strony.
useEvenPageHeaderFooter

boolean

Wskazuje, czy na stronach parzystych mają być używane identyfikatory nagłówka / stopki strony parzystej.
pageNumberStart

integer

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

object (Dimension)

Margines górnej strony.

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

object (Dimension)

Dolny margines strony.

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

object (Dimension)

Prawy margines strony.

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

object (Dimension)

Lewy margines strony.

Zmiana lewego marginesu strony w stylu dokumentu powoduje wyczyszczenie lewego marginesu strony we wszystkich stylach sekcji. Może to też spowodować zmianę rozmiaru kolumn we wszystkich sekcjach.
pageSize

object (Size)

Rozmiar strony w dokumencie.
marginHeader

object (Dimension)

Odległość między górną krawędzią strony a 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. Możesz go używać razem z przyciskiem documentStyleSuggestionState, aby sprawdzić, które pola się zmieniły i jakie mają teraz wartości.
documentStyleSuggestionState

object (DocumentStyleSuggestionState)

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

DocumentStyleSuggestionState

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

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

object (BackgroundSuggestionState)

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

boolean

Wskazuje, czy zasugerowano zmianę na defaultHeaderId.
evenPageHeaderIdSuggested

boolean

Wskazuje, czy zasugerowano zmianę na evenPageHeaderId.
evenPageFooterIdSuggested

boolean

Wskazuje, czy zasugerowano zmianę na evenPageFooterId.
firstPageHeaderIdSuggested

boolean

Wskazuje, czy zasugerowano zmianę na firstPageHeaderId.
firstPageFooterIdSuggested

boolean

Wskazuje, czy zasugerowano zmianę na firstPageFooterId.
useFirstPageHeaderFooterSuggested

boolean

Wskazuje, czy zasugerowano zmianę na useFirstPageHeaderFooter.
useEvenPageHeaderFooterSuggested

boolean

Wskazuje, czy zasugerowano zmianę na useEvenPageHeaderFooter.
pageNumberStartSuggested

boolean

Wskazuje, czy zasugerowano zmianę na pageNumberStart.
marginTopSuggested

boolean

Wskazuje, czy zasugerowano zmianę na marginTop.
marginBottomSuggested

boolean

Wskazuje, czy zasugerowano zmianę na marginBottom.
marginRightSuggested

boolean

Wskazuje, czy zasugerowano zmianę na marginRight.
marginLeftSuggested

boolean

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

object (SizeSuggestionState)

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

boolean

Wskazuje, czy zasugerowano zmianę na marginHeader.
flipPageOrientationSuggested

boolean

Opcjonalnie: Wskazuje, czy zasugerowano zmianę na flipPageOrientation.

BackgroundSuggestionState

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

Zapis JSON 
{
  "backgroundColorSuggested": boolean
}
Pola
backgroundColorSuggested

boolean

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

SizeSuggestionState

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

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

boolean

Wskazuje, czy zasugerowano zmianę na height.
widthSuggested

boolean

Wskazuje, czy zasugerowano zmianę na width.

NamedStyles

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

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

object (NamedStyle)

Style nazwane.

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

NamedStyle

Styl o nazwie. Akapity w dokumencie mogą dziedziczyć wartości TextStyle i ParagraphStyle z tego stylu, jeśli mają ten sam typ stylu.

Zapis JSON 
{
  "namedStyleType": enum (NamedStyleType),
  "textStyle": {
    object (TextStyle)
  },
  "paragraphStyle": {
    object (ParagraphStyle)
  }
}
Pola
namedStyleType

enum (NamedStyleType)

Typ tego nazwanego stylu.
textStyle

object (TextStyle)

Styl tekstu tego stylu nazwanego.
paragraphStyle

object (ParagraphStyle)

Styl akapitu tego stylu nazwanego.

SuggestedNamedStyles

Zaproponowana zmiana w NamedStyles.

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

object (NamedStyles)

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

NamedStylesSuggestionState

Stan sugestii w wiadomości NamedStyles.

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

object (NamedStyleSuggestionState)

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

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

NamedStyleSuggestionState

Stan sugestii w wiadomości NamedStyle.

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

enum (NamedStyleType)

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

object (ParagraphStyleSuggestionState)

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

Lista

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

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

object (ListProperties)

Właściwości listy.
suggestedListPropertiesChanges

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

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

string

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

string

Identyfikatory sugerowanych do usunięcia. Jeśli 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 punktów na powiązanym poziomie.

Lista może mieć maksymalnie 9 poziomów zagnieżdżenia, przy czym poziom 0 odpowiada najwyższemu poziomowi, a poziom 8 – najbardziej zagnieżdżonemu poziomowi. Poziomy zagnieżdżenia są zwracane w kolejności rosnącej, a więc najpierw jest zwracany poziom najmniej zagnieżdżony.

NestingLevel

Zawiera właściwości opisujące wygląd i działanie symbolu 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 glifów zawiera co najmniej 1 miejsce zastępcze, które jest zastępowane odpowiednimi wartościami w zależności od glyphType lub glyphSymbol. Zmienna musi być zgodna ze wzorcem %[nestingLevel]. Symbole zastępcze mogą też mieć prefiksy i sufiksy. Dzięki temu format glifów ma format <prefix>%[nestingLevel]<suffix>. Pamiętaj, że prefiks i sufiks są opcjonalne i mogą być dowolnymi ciągami znaków.

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

A.

B.

C.

Format glifów może zawierać placeholdery dla bieżącego poziomu zagnieżdżenia oraz placeholdery dla nadrzędnych poziomów zagnieżdżenia. Na przykład format glifu może mieć wartość %0. na poziomie zagnieżdżenia i format glifu %0.%1. na poziomie zagnieżdżenia 1. Zakładając, że oba poziomy zagnieżdżenia mają typy glifu DECIMAL, spowoduje to utworzenie listy z wyrenderowanymi glifami.

1.

2.

2.1.

2.2.

3.

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

object (Dimension)

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

object (Dimension)

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 w punkcie na tym poziomie umieszczania.
startNumber

integer

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

Wartość 0 jest traktowana jako wartość 1 w przypadku list z literami i rzymskimi cyframi. W przypadku wartości 0 i 1 listy literowe i rzymskie będą się zaczynać odpowiednio od a i i.

Ta wartość jest ignorowana w przypadku poziomów zagnieżdżenia z nieuporządkowanymi glifami.
Pole unii glyph_kind. Rodzaj glifu używanego przez symbole. Określa glif punktora, który zastępuje zmienne w glyph_format. glyph_kind może być tylko jednym z tych elementów:
glyphType

enum (GlyphType)

Typ znaku używanego przez wypunktowanie, gdy akapity na tym poziomie zagnieżdżenia są uporządkowane.

Typ glifu określa typ glifu używanego do zastępowania obiektów zastępczych w sekcji glyphFormat, gdy akapity na tym poziomie zagnieżdżenia są uporządkowane. Jeśli na przykład poziom zagnieżdżania wynosi 0, glyphFormat to %0., a typ glifu to DECIMAL, wyrenderowany glif zastąpi placeholder %0 w formacie glifu liczbą odpowiadającą pozycji elementu na liście.
glyphSymbol

string

Symbol niestandardowego glifu używany przez kule, gdy akapity na tym poziomie zagnieżdżenia są nieuporządkowane.

Symbol glifu zastępuje obiekty zastępcze w miejscu glyphFormat. Jeśli na przykład symbolGlyph to pełny okrąg odpowiadający punktowi kodu Unicode U+25cf, a glyphFormat to %0, renderowany symbolGlyph będzie miał postać pełnego koła.

BulletAlignment

Typy wyrównania punktora.

Wartości w polu enum
BULLET_ALIGNMENT_UNSPECIFIED Wyrównanie listy wypunktowanej jest nieokreślone.
START Odznaka jest wyrównana do początku miejsca zarezerwowanego na jej wyrenderowanie. Wyrównany do lewej w przypadku tekstu w kierunku od lewej do prawej, a w przeciwnym razie wyrównany do prawej.
CENTER Odznaka jest wyrównana do środka miejsca zarezerwowanego na jej renderowanie.
END Odznaka jest wyrównana do końca miejsca zarezerwowanego na jej 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 znaków.
DECIMAL Liczba, np. 1, 2 lub 3.
ZERO_DECIMAL Numer, w którym pojedyncze cyfry mają przedrost 0, np. 01, 02 lub 03. Liczby składające się z więcej niż 1 cyfry nie mają przedrostka 0.
UPPER_ALPHA duża litera, np. A, B lub C;
ALPHA mała litera, np. a, b lub c;
UPPER_ROMAN Rzymska cyfra w wielkiej literze, np. I, II lub III.
ROMAN Mała cyfra rzymska, 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. Możesz go używać razem z przyciskiem listPropertiesSuggestionState, aby sprawdzić, które pola się zmieniły i jakie mają teraz wartości.
listPropertiesSuggestionState

object (ListPropertiesSuggestionState)

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

ListPropertiesSuggestionState

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

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

object (NestingLevelSuggestionState)

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

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

NestingLevelSuggestionState

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

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

boolean

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

boolean

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

boolean

Wskazuje, czy zasugerowano zmianę na glyphFormat.
glyphSymbolSuggested

boolean

Wskazuje, czy zasugerowano zmianę na glyphSymbol.
indentFirstLineSuggested

boolean

Wskazuje, czy zasugerowano zmianę na indentFirstLine.
indentStartSuggested

boolean

Wskazuje, czy zasugerowano zmianę na indentStart.
textStyleSuggestionState

object (TextStyleSuggestionState)

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

boolean

Wskazuje, czy zasugerowano zmianę na startNumber.

NamedRanges

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

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

string

Nazwa, którą mają wszystkie named ranges.
namedRanges[]

object (NamedRange)

NamedRange o tej samej nazwie.

NamedRange

Kolekcja komórek Range o tym samym identyfikatorze zakresu nazw.

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

Nazwany zakres jest tworzony z pojedynczym elementem Range, a treść wstawiona do nazwanego zakresu zwykle go rozszerza. Jednak 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, widzą jego zakresy nazwane.

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

string

Identyfikator zakresu nazwanego.
name

string

Nazwa zakresu nazwanego.
ranges[]

object (Range)

Zakresy, 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 0) w jednostkach kodu UTF-16.

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

integer

Indeks końcowy tego zakresu (liczony od 0) w jednostkach kodu UTF-16.

W przypadku wszystkich bieżących zastosowań musi być podany indeks końcowy. To pole jest typu Int32Value, aby uwzględnić przyszłe przypadki użycia z nieograniczonymi zakresami.
tabId

string

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

W dokumencie zawierającym jedną kartę:

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

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

W dokumencie zawierającym wiele kart:

  • 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żna go używać do aktualizowania właściwości obiektu.
inlineObjectProperties

object (InlineObjectProperties)

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

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

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

string

Sugerowany identyfikator 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.

InlineObjectProperties

Właściwości InlineObject.

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

object (EmbeddedObject)

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

EmbeddedObject

Obiekt umieszczony w dokumencie.

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

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

string

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

string

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

object (EmbeddedObjectBorder)

Obwód umieszczonego obiektu.
size

object (Size)

Rozmiar obrazu widoczny po przycięciu.
marginTop

object (Dimension)

Górny margines osadzonego obiektu.
marginBottom

object (Dimension)

Dolna krawędź umieszczonego obiektu.
marginRight

object (Dimension)

Prawy margines osadzonego obiektu.
marginLeft

object (Dimension)

Lewy margines osadzonego obiektu.
linkedContentReference

object (LinkedContentReference)

Odniesienie do treści źródłowych ze źródła zewnętrznego, do którego istnieje link. Na przykład zawiera on odwołanie do źródłowego wykresu w Arkuszach Google, gdy wbudowany obiekt jest połączonym wykresem.

Jeśli zasada jest nieskonfigurowana, osadzony obiekt nie jest połączony.
Pole sumy properties. Właściwości specyficzne dla każdego typu obiektu wbudowanego. properties może mieć tylko jedną z tych wartości:
embeddedDrawingProperties

object (EmbeddedDrawingProperties)

Właściwości umieszczonego rysunku.
imageProperties

object (ImageProperties)

Właściwości obrazu.

EmbeddedDrawingProperties

Ten typ nie zawiera pól.

Właściwości osadzonego rysunku, które służą do rozróżniania typu obiektu. Rysunek umieszczony na stronie to taki, który jest tworzony i edytowany w dokumencie. Pamiętaj, że obszerne szczegóły nie są obsługiwane.

ImageProperties

Właściwości obrazu.

Zapis JSON 
{
  "contentUri": string,
  "sourceUri": string,
  "brightness": number,
  "contrast": number,
  "transparency": number,
  "cropProperties": {
    object (CropProperties)
  },
  "angle": number
}
Pola
contentUri

string

Identyfikator URI obrazu z domyślnym czasem trwania 30 minut. Ten identyfikator URI jest oznaczony tagiem konta osoby składającej prośbę. Każdy, kto ma identyfikator URI, uzyskuje dostęp do obrazu jako pierwotny żądający. Jeśli ustawienia udostępniania dokumentu ulegną zmianie, możesz utracić dostęp do obrazu.
sourceUri

string

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

number

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

number

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

number

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

object (CropProperties)

Właściwości kadrowania obrazu.
angle

number

Kąt obrotu obrazu w prawo w radianach.

CropProperties

Właściwości przycięcia obrazu.

Prostokąt przycięcia jest reprezentowany za pomocą odstępów ułamkowych od 4 krawędzi oryginalnej treści.

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

number

Odsunięcie określa, jak daleko od lewej krawędzi oryginalnych treści znajduje się lewa krawędź prostokąta przycinania (jako ułamek szerokości oryginalnych treści).
offsetRight

number

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

number

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

number

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

number

Kąt obrotu prostokąta przycinania w prawo (w radianach) wokół jego środka. 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 połączonego wykresu 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

Zaproponowana zmiana: InlineObjectProperties.

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

object (InlineObjectProperties)

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

object (InlineObjectPropertiesSuggestionState)

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

InlineObjectPropertiesSuggestionState

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

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

object (EmbeddedObjectSuggestionState)

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

EmbeddedObjectSuggestionState

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

Zapis JSON 
{
  "embeddedDrawingPropertiesSuggestionState": {
    object (EmbeddedDrawingPropertiesSuggestionState)
  },
  "imagePropertiesSuggestionState": {
    object (ImagePropertiesSuggestionState)
  },
  "titleSuggested": boolean,
  "descriptionSuggested": boolean,
  "embeddedObjectBorderSuggestionState": {
    object (EmbeddedObjectBorderSuggestionState)
  },
  "sizeSuggestionState": {
    object (SizeSuggestionState)
  },
  "marginLeftSuggested": boolean,
  "marginRightSuggested": boolean,
  "marginTopSuggested": boolean,
  "marginBottomSuggested": boolean,
  "linkedContentReferenceSuggestionState": {
    object (LinkedContentReferenceSuggestionState)
  }
}
Pola
embeddedDrawingPropertiesSuggestionState

object (EmbeddedDrawingPropertiesSuggestionState)

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

object (ImagePropertiesSuggestionState)

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

boolean

Wskazuje, czy zasugerowano zmianę na title.
descriptionSuggested

boolean

Wskazuje, czy zasugerowano zmianę na description.
embeddedObjectBorderSuggestionState

object (EmbeddedObjectBorderSuggestionState)

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

object (SizeSuggestionState)

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

boolean

Wskazuje, czy zasugerowano zmianę na marginLeft.
marginRightSuggested

boolean

Wskazuje, czy 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 elementach linkedContentReference zostały zmienione w tej propozycji.

EmbeddedDrawingPropertiesSuggestionState

Ten typ nie zawiera pól.

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

ImagePropertiesSuggestionState

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

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

boolean

Wskazuje, czy zasugerowano zmianę na contentUri.
sourceUriSuggested

boolean

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

boolean

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

boolean

Wskazuje, czy zasugerowano zmianę wartości atrybutu [contrast] w atrybucie [google.apps.docs.v1.EmbeddedObject.contrast].
transparencySuggested

boolean

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

object (CropPropertiesSuggestionState)

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

boolean

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

CropPropertiesSuggestionState

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

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

boolean

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

boolean

Wskazuje, czy zasugerowano zmianę na offsetRight.
offsetTopSuggested

boolean

Wskazuje, czy zasugerowano zmianę na offsetTop.
offsetBottomSuggested

boolean

Wskazuje, czy zasugerowano zmianę na offsetBottom.
angleSuggested

boolean

Wskazuje, czy została sugerowana zmiana w tym polu: 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 zasugerowano zmianę atrybutu [color] w obiekcie [google.apps.docs.v1.EmbeddedBorderObject.color].
widthSuggested

boolean

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

boolean

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

boolean

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

LinkedContentReferenceSuggestionState

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

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

object (SheetsChartReferenceSuggestionState)

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

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 przywiązany do Paragraph i umieszczony względem początku akapitu. Obiekt PositionedObject zawiera EmbeddedObject, np. obraz.

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

string

Identyfikator tego obiektu.
positionedObjectProperties

object (PositionedObjectProperties)

Właściwości tego obiektu.
suggestedPositionedObjectPropertiesChanges

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

Sugerowane zmiany właściwości obiektów w pozycji, posortowane 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. Jeśli jest puste, nie ma żadnych sugerowanych usunięcia tych treści.

PositionedObjectProperties

Właściwości PositionedObject.

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

object (PositionedObjectPositioning)

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

object (EmbeddedObject)

Umieszczony obiekt tego umieszczonego obiektu.

PositionedObjectPositioning

Położenie PositionedObject. Obiekt jest umieszczany względem początku Paragraph, do którego jest przywiązany.

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

enum (PositionedObjectLayout)

Układ tego umieszczonego obiektu.
leftOffset

object (Dimension)

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

object (Dimension)

Przesunięcie górnej krawędzi obiektu względem początku Paragraph, do którego jest przywiązany. Dokładne 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 został 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 jest umieszczony za tekstem.

SuggestedPositionedObjectProperties

Zaproponowana zmiana: PositionedObjectProperties.

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

object (PositionedObjectProperties)

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

object (PositionedObjectPropertiesSuggestionState)

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

PositionedObjectPropertiesSuggestionState

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

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

object (PositionedObjectPositioningSuggestionState)

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

object (EmbeddedObjectSuggestionState)

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

PositionedObjectPositioningSuggestionState

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

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

boolean

Wskazuje, czy 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 czytania dokumentu ze wszystkimi sugestiami w tekście, zaakceptowanymi lub odrzuconymi.

Wartości w polu enum
DEFAULT_FOR_CURRENT_ACCESS Tryb wyświetlania sugestii zastosowany do zwróconego dokumentu zależy od bieżącego poziomu dostępu użytkownika. Jeśli użytkownik ma tylko dostęp do wyświetlania, zostanie zastosowany parametr PREVIEW_WITHOUT_SUGGESTIONS. W przeciwnym razie zostanie zastosowany element SUGGESTIONS_INLINE. Jest to domyślny tryb wyświetlania sugestii.
SUGGESTIONS_INLINE

Zwrócony dokument zawiera sugestie. Sugerowane zmiany będą odróżnione od podstawowej zawartości w dokumencie.

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

Zwrócony dokument jest podglądem z zaakceptowanymi wszystkimi sugerowanymi zmianami.

Żądania pobrania dokumentu w tym trybie będą zwracać błąd 403, jeśli użytkownik nie ma uprawnień do wyświetlania sugerowanych zmian.
PREVIEW_WITHOUT_SUGGESTIONS Zwrócony dokument jest podglądem z odrzuconymi sugestiami (jeśli takie istnieją).

Metody

batchUpdate

 Wprowadza co najmniej 1 zmianę w dokumencie.

create

 Tworzy pusty dokument z wykorzystaniem tytułu podanego w żądaniu.

get

 Pobiera najnowszą wersję określonego dokumentu.