REST Resource: documents

{
  "documentId": string,
  "title": string,
  "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)
    },
    ...
  },
  "revisionId": string,
  "suggestionsViewMode": enum (SuggestionsViewMode),
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}

string

Tylko dane wyjściowe. Identyfikator dokumentu.

string

Tytuł dokumentu.

object (Body)

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

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

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

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

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

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

Tylko dane wyjściowe. Przypisy w dokumencie powiązane z identyfikatorem przypisu.

object (DocumentStyle)

Tylko dane wyjściowe. Styl dokumentu.

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

Tylko dane wyjściowe. Sugerowane zmiany stylu dokumentu na podstawie identyfikatora sugestii.

object (NamedStyles)

Tylko dane wyjściowe. Nazwane style dokumentu.

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

Tylko dane wyjściowe. Sugerowane zmiany w nazwanych stylów dokumentu, zgodnie z identyfikatorem sugestii.

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

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

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

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

string

Tylko dane wyjściowe. Identyfikator wersji dokumentu. Można go używać w żądaniach aktualizacji do określania, do której wersji dokumentu mają zostać zastosowane aktualizacje i jak powinno zachowywać się żądanie, jeśli dokument był edytowany od czasu tej wersji. Pole wypełnione tylko wtedy, gdy użytkownik ma uprawnienia do edycji dokumentu.

Identyfikator wersji nie jest liczbą sekwencyjną, ale nieprzejrzystym ciągiem. Format identyfikatora wersji może się z czasem zmienić. Zwrócony identyfikator wersji będzie ważny tylko przez 24 godziny od zwrócenia i nie może być udostępniany użytkownikom. Jeśli identyfikator wersji nie uległ zmianie między wywołaniami, dokument pozostaje bez zmian. Natomiast zmiana identyfikatora (dla tego samego dokumentu i tego samego użytkownika) zwykle oznacza, że dokument został zaktualizowany. Jednak zmiana identyfikatora może być spowodowana czynnikami wewnętrznymi, takimi jak zmiana formatu identyfikatora.

enum (SuggestionsViewMode)

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

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

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

Tylko dane wyjściowe. Obiekty w dokumencie powiązane z identyfikatorem obiektu.

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

Tylko dane wyjściowe. Pozycjone obiekty w dokumencie podane według identyfikatora obiektu.

{
  "content": [
    {
      object (StructuralElement)
    }
  ]
}

object (StructuralElement)

Treść.

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

{
  "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.
}

integer

Indeks początkowy tego elementu strukturalnego liczony od zera, w jednostkach kodu UTF-16.

integer

Liczący od zera indeks końcowy tego wyłącznego elementu struktury w jednostkach kodu UTF-16.

object (Paragraph)

Typ akapitu elementu strukturalnego.

object (SectionBreak)

Typ podziału sekcji w elemencie strukturalnym.

object (Table)

Typ tabeli elementu struktury.

object (TableOfContents)

Typ spisu treści elementu strukturalnego.

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

object (ParagraphElement)

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

object (ParagraphStyle)

Styl tego akapitu.

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

Proponowany styl akapitu zmienia się w ten akapit na podstawie identyfikatora sugestii.

object (Bullet)

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

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

Sugerowane zmiany w punkcie tego akapitu.

string

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

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

Identyfikatory pozycjonowanych obiektów, które powinny zostać dołączone do tego akapitu, powiązane z identyfikatorem sugestii.

{
  "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.
}

integer

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

integer

Indeks końcowy tego elementu akapitu (wyłącznie) w jednostkach kodu UTF-16.

object (TextRun)

Element akapitu z tekstem w formacie tekstowym.

object (AutoText)

Element automatycznego tekstu akapitu.

object (PageBreak)

Element akapitu z podziałem strony.

object (ColumnBreak)

Element akapitu z podziałem na kolumny.

object (FootnoteReference)

Element akapitu z odwołaniem do przypisu.

object (HorizontalRule)

Element akapitu z linią poziomą.

object (Equation)

Element akapitu równania.

object (InlineObjectElement)

Wbudowany element akapitu.

object (Person)

Element akapitu z linkiem do osoby lub adresu e-mail.

object (RichLink)

Element akapitu z linkiem do zasobu Google (np. pliku na Dysku Google, filmu w YouTube czy wydarzenia w Kalendarzu).

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

string

Tekst tego uruchomienia.

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

string

Sugerowane identyfikatory wstawiania. Element TextRun może mieć wiele identyfikatorów wstawiania, jeśli jest to zagnieżdżona sugerowana zmiana. Jeśli to pole jest puste, nie jest to sugerowane wstawienie.

string

Identyfikatory sugerowanych usunięć. Jeśli pole jest puste, nie ma sugestii usunięcia tej treści.

object (TextStyle)

Styl tekstu tego uruchomienia.

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

Sugerowane zmiany stylu tekstu w tym uruchomieniu na podstawie identyfikatora sugestii.

{
  "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)
  }
}

boolean

Określa, czy tekst jest pogrubiony.

boolean

Określa, czy tekst jest napisany kursywą.

boolean

Wskazuje, czy tekst jest podkreślony.

boolean

Czy tekst zostanie przekreślony.

boolean

Wskazuje, czy tekst jest napisany małymi literami.

object (OptionalColor)

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

object (OptionalColor)

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

object (Dimension)

Rozmiar czcionki tekstu.

object (WeightedFontFamily)

Rodzina czcionek i renderowana grubość tekstu.

Jeśli w żądaniu aktualizacji określone są zarówno wartości weightedFontFamily, jak i bold, najpierw stosowana jest zasada weightedFontFamily, a następnie bold.

Jeśli zasada weightedFontFamily#weight nie jest skonfigurowana, domyślnie przyjmuje wartość 400.

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

enum (BaselineOffset)

Przesunięcie tekstu w pionie względem jego normalnego położenia.

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

object (Link)

Miejsce docelowe tekstu hiperlinku. Jeśli zasada jest nieskonfigurowana, link nie jest wyświetlany. Linki nie są dziedziczone z tekstu nadrzędnego.

Zmiana linku w żądaniu aktualizacji powoduje też inne zmiany stylu tekstu w zakresie:

• Gdy ustawisz link, kolor pierwszego planu tekstu zostanie zmieniony na domyślny, a tekst będzie podkreślony. Jeśli te pola zostaną zmodyfikowane w tym samym żądaniu, zamiast wartości domyślnych połączenia zostaną użyte te wartości.
• Ustawienie linku w zakresie tekstu, który pokrywa się z istniejącym linkiem, spowoduje też zaktualizowanie istniejącego linku, aby wskazywał nowy adres URL.
• Linków nie można konfigurować przy użyciu znaków nowego wiersza. W rezultacie ustawienie linku w zakresie tekstu, który przekracza granicę akapitu, np. "ABC\n123", spowoduje rozdzielenie znaków nowego wiersza w osobne ciągi tekstowe. Połączenie zostanie zastosowane oddzielnie do uruchomień przed nowym wierszem i po nim.
• Usunięcie linku spowoduje zaktualizowanie stylu tekstu z zakresu tak, aby pasował do stylu poprzedniego tekstu (lub domyślnych stylów tekstu, jeśli tekst poprzedzający jest innym linkiem), chyba że w tym samym żądaniu są ustawione różne style.

{
  "color": {
    object (Color)
  }
}

object (Color)

Po ustawieniu ten kolor będzie używany jako kolor nieprzezroczysty. Jeśli nie jest skonfigurowana, wartość jest wyświetlana w kolorze przezroczystym.

{
  "rgbColor": {
    object (RgbColor)
  }
}

object (RgbColor)

Wartość koloru RGB.

{
  "red": number,
  "green": number,
  "blue": number
}

number

Składnik czerwony koloru (od 0,0 do 1,0).

number

Składnik zielony koloru (od 0,0 do 1,0).

number

Składnik niebieski koloru, od 0,0 do 1,0.

{
  "magnitude": number,
  "unit": enum (Unit)
}

number

Siła.

enum (Unit)

Jednostki wielkości.

{
  "fontFamily": string,
  "weight": integer
}

string

Rodzina czcionek tekstu.

Rodziną czcionek może być dowolna czcionka z menu Czcionka w Dokumentach lub Google Fonts. Jeśli nazwa czcionki nie zostanie rozpoznana, tekst jest renderowany w języku: Arial.

integer

Grubość czcionki. To pole może mieć dowolną wartość, która jest wielokrotnością liczby 100 z zakresu od 100 do 900 włącznie. Ten zakres odpowiada wartościom liczbowym opisanym w sekcji 15.6 specyfikacji CSS 2.1, przy czym wartości inne niż cyfry są niedozwolone.

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

Grubość czcionki stanowi tylko jeden składnik renderowanej grubości czcionki. Połączenie właściwości weight i wartości bold określonej dla stylu tekstu określa wyrenderowaną wagę po uwzględnieniu dziedziczenia:

• Jeśli tekst jest pogrubiony, a waga jest mniejsza niż 400, renderowana waga wyniesie 400.
• Jeśli tekst jest pogrubiony, a waga jest większa lub równa 400, ale mniejsza niż 700, renderowana waga wyniesie 700.
• Jeśli waga jest większa lub równa 700, renderowana waga jest równa tej wartości.
• Jeśli tekst nie jest pogrubiony, renderowana waga jest równa wagi.

{

  // Union field destination can be only one of the following:
  "url": string,
  "bookmarkId": string,
  "headingId": string
  // End of list of possible types for union field destination.
}

string

Zewnętrzny adres URL.

string

Identyfikator zakładki w tym dokumencie.

string

Identyfikator nagłówka w tym dokumencie.

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

object (TextStyle)

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

object (TextStyleSuggestionState)

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

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

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości bold.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości italic.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości underline.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości strikethrough.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości smallCaps.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości backgroundColor.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości foregroundColor.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości fontSize.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości weightedFontFamily.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości baselineOffset.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości link.

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

enum (Type)

Typ tego tekstu automatycznego.

string

Sugerowane identyfikatory wstawiania. Element AutoText może mieć wiele identyfikatorów wstawiania, jeśli jest to zagnieżdżona sugerowana zmiana. Jeśli to pole jest puste, nie jest to sugerowane wstawienie.

string

Identyfikatory sugerowanych usunięć. Jeśli pole jest puste, nie ma sugestii usunięcia tej treści.

object (TextStyle)

Styl tekstu tego autotekstu.

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

Sugerowane zmiany stylu tekstu tego autotekstu na podstawie identyfikatora sugestii.

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

string

Sugerowane identyfikatory wstawiania. Element PageBreak może mieć wiele identyfikatorów wstawiania, jeśli jest to zagnieżdżona sugerowana zmiana. Jeśli to pole jest puste, nie jest to sugerowane wstawienie.

string

Identyfikatory sugerowanych usunięć. Jeśli pole jest puste, nie ma sugestii usunięcia tej treści.

object (TextStyle)

Styl tekstu tego podziału strony.

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

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

Sugerowane zmiany stylu tekstu w tym podziale strony na podstawie identyfikatora sugestii.

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

string

Sugerowane identyfikatory wstawiania. Element ColumnBreak może mieć wiele identyfikatorów wstawiania, jeśli jest to zagnieżdżona sugerowana zmiana. Jeśli to pole jest puste, nie jest to sugerowane wstawienie.

string

Identyfikatory sugerowanych usunięć. Jeśli pole jest puste, nie ma sugestii usunięcia tej treści.

object (TextStyle)

Styl tekstu tej klasy ColumnBreak.

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

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

Sugerowane zmiany stylu tekstu w tym polu ColumnBreak na podstawie identyfikatora sugestii.

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

string

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

string

Renderowana liczba tego przypisu.

string

Sugerowane identyfikatory wstawiania. Element FootnoteReference może mieć wiele identyfikatorów wstawiania, jeśli jest to zagnieżdżona sugerowana zmiana. Jeśli to pole jest puste, nie jest to sugerowane wstawienie.

string

Identyfikatory sugerowanych usunięć. Jeśli pole jest puste, nie ma sugestii usunięcia tej treści.

object (TextStyle)

Styl tekstu tej funkcji FootnoteReference.

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

Proponowane zmiany stylu tekstu w tym przypisie referencyjnym na podstawie identyfikatora sugestii.

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

string

Sugerowane identyfikatory wstawiania. Element HorizontalRule może mieć wiele identyfikatorów wstawiania, jeśli jest to zagnieżdżona sugerowana zmiana. Jeśli to pole jest puste, nie jest to sugerowane wstawienie.

string

Identyfikatory sugerowanych usunięć. Jeśli pole jest puste, nie ma sugestii usunięcia tej treści.

object (TextStyle)

Styl tekstu tej reguły poziomej.

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

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

Sugerowane zmiany stylu tekstu w tej regule poziomej na podstawie identyfikatora sugestii.

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ]
}

string

Sugerowane identyfikatory wstawiania. Element Equation może mieć wiele identyfikatorów wstawiania, jeśli jest to zagnieżdżona sugerowana zmiana. Jeśli to pole jest puste, nie jest to sugerowane wstawienie.

string

Identyfikatory sugerowanych usunięć. Jeśli pole jest puste, nie ma sugestii usunięcia tej treści.

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

string

Identyfikator elementu InlineObject, który zawiera ten element.

string

Sugerowane identyfikatory wstawiania. Element InlineObjectElement może mieć wiele identyfikatorów wstawiania, jeśli jest to zagnieżdżona sugerowana zmiana. Jeśli to pole jest puste, nie jest to sugerowane wstawienie.

string

Identyfikatory sugerowanych usunięć. Jeśli pole jest puste, nie ma sugestii usunięcia tej treści.

object (TextStyle)

Styl tekstu tego elementu InlineObjectElement.

Podobnie jak w przypadku treści tekstowych, np. przebiegów tekstu i odwołań do przypisów, styl tekstu elementu wbudowanego obiektu może wpływać na układ treści oraz styl tekstu wstawionego obok niego.

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

Sugerowane zmiany stylu tekstu w tym obiekcie InlineObject zależą od identyfikatora sugestii.

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

string

Tylko dane wyjściowe. Unikalny identyfikator tego linku.

string

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

string

Identyfikatory sugestii, które mogą usunąć link tej osoby z dokumentu. Element Person może mieć wiele identyfikatorów usuwania, jeśli na przykład wielu użytkowników sugeruje jego usunięcie. Jeśli to pole jest puste, link do tej osoby nie jest proponowany do usunięcia.

object (TextStyle)

Styl tekstu elementu Person.

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

Sugerowane zmiany stylu tekstu w tym elemencie: Person na podstawie identyfikatora sugestii.

object (PersonProperties)

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

{
  "name": string,
  "email": string
}

string

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

string

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

{
  "richLinkId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  },
  "richLinkProperties": {
    object (RichLinkProperties)
  }
}

string

Tylko dane wyjściowe. Identyfikator tego połączenia.

string

Identyfikatory sugestii, które wstawiają ten link do dokumentu. Element RichLink może mieć wiele identyfikatorów wstawiania, jeśli jest to zagnieżdżona sugerowana zmiana (np. sugestia w sugestii innego użytkownika). Jeśli to pole jest puste, link do tej osoby nie jest sugerowanym wstawianiem.

string

Identyfikatory sugestii, które pozwolą usunąć ten link z dokumentu. Element RichLink może mieć wiele identyfikatorów usuwania, jeśli na przykład wielu użytkowników sugeruje jego usunięcie. Jeśli to pole jest puste, link do tej osoby nie jest proponowany do usunięcia.

object (TextStyle)

Styl tekstu elementu RichLink.

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

Sugerowane zmiany stylu tekstu w tym elemencie: RichLink na podstawie identyfikatora sugestii.

object (RichLinkProperties)

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

{
  "title": string,
  "uri": string,
  "mimeType": string
}

string

Tylko dane wyjściowe. Tytuł (RichLink) widoczny w linku. Ten tytuł jest taki sam jak tytuł połączonego zasobu w momencie wstawienia lub ostatniej aktualizacji linku. To pole jest zawsze obecne.

string

Tylko dane wyjściowe. Identyfikator URI obiektu w usłudze RichLink. Ta wartość jest zawsze obecna.

string

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

{
  "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
}

string

Identyfikator nagłówka akapitu. Jeśli ta kolumna jest pusta, ten akapit nie jest nagłówkiem.

Ta usługa jest tylko do odczytu.

enum (NamedStyleType)

Nazwany typ stylu akapitu.

Ponieważ zmiana typu stylu nazwanego ma wpływ na inne właściwości w obrębie ParagraphStyle, ten typ jest stosowany przed aktualizacją pozostałych właściwości.

enum (Alignment)

Wyrównanie tekstu w tym akapicie.

number

Ilość odstępów między wierszami wyrażona jako procent normalnej wartości, gdzie normalność jest przedstawiana jako 100, 0. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.

enum (ContentDirection)

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

enum (SpacingMode)

Tryb odstępów w akapicie.

object (Dimension)

Dodatkowa przestrzeń nad akapitem. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.

object (Dimension)

Dodatkowa przestrzeń pod akapitem. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.

object (ParagraphBorder)

Obramowanie między tym akapitem a następnym i poprzednim akapitem. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.

Obramowanie między akapitami jest renderowane, gdy sąsiedni akapit mają takie same właściwości obramowania i wcięcia.

Nie można częściowo zaktualizować obramowania akapitów. Gdy zmieniasz obramowanie akapitu, nowe obramowanie należy określić w całości.

object (ParagraphBorder)

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

Obramowanie górne jest renderowane, gdy akapit powyżej ma różne ustawienia obramowania i wcięcia.

Nie można częściowo zaktualizować obramowania akapitów. Gdy zmieniasz obramowanie akapitu, nowe obramowanie należy określić w całości.

object (ParagraphBorder)

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

Obramowanie dolne jest renderowane, gdy akapit poniżej ma różne ustawienia obramowania i wcięcia.

Nie można częściowo zaktualizować obramowania akapitów. Gdy zmieniasz obramowanie akapitu, nowe obramowanie należy określić w całości.

object (ParagraphBorder)

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

Nie można częściowo zaktualizować obramowania akapitów. Gdy zmieniasz obramowanie akapitu, nowe obramowanie należy określić w całości.

object (ParagraphBorder)

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

Nie można częściowo zaktualizować obramowania akapitów. Gdy zmieniasz obramowanie akapitu, nowe obramowanie należy określić w całości.

object (Dimension)

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

object (Dimension)

Wielkość wcięcia akapitu z boku, które odpowiada początkowi tekstu, na podstawie bieżącego kierunku akapitu. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.

object (Dimension)

Stopień wcięcia akapitu z boku, które odpowiada końcu tekstu na podstawie bieżącego kierunku akapitu. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z elementu nadrzędnego.

object (TabStop)

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

Ta usługa jest tylko do odczytu.

boolean

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

boolean

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

boolean

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

object (Shading)

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

boolean

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

Próba aktualizacji atrybutu pageBreakBefore w przypadku akapitów w nieobsługiwanych regionach, takich jak Table, Header, Footer i Footnote, może spowodować nieprawidłowy stan dokumentu, który zwróci błąd 400 błędnego żądania.

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

object (OptionalColor)

Kolor obramowania.

object (Dimension)

Szerokość obramowania.

object (Dimension)

Dopełnienie obramowania.

enum (DashStyle)

Styl obramowania.

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

object (Dimension)

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

enum (TabStopAlignment)

Wyrównanie tej karty zostanie zatrzymane. Jeśli zasada jest nieskonfigurowana, stosowana jest wartość domyślna START.

{
  "backgroundColor": {
    object (OptionalColor)
  }
}

object (OptionalColor)

Kolor tła tego cieniowania akapitu.

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

object (ParagraphStyle)

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

object (ParagraphStyleSuggestionState)

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

{
  "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
}

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości headingId.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości namedStyleType.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości alignment.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości lineSpacing.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości direction.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości spacingMode.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości spaceAbove.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości spaceBelow.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości borderBetween.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości borderTop.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości borderBottom.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości borderLeft.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości borderRight.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości indentFirstLine.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości indentStart.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości indentEnd.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości keepLinesTogether.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości keepWithNext.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości avoidWidowAndOrphan.

object (ShadingSuggestionState)

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

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości pageBreakBefore.

{
  "backgroundColorSuggested": boolean
}

boolean

Wskazuje, czy istnieje sugerowana zmiana w atrybucie Shading.

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

string

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

integer

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

object (TextStyle)

Styl tekstu charakterystyczny dla akapitu zastosowany do tego punktu.

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

object (Bullet)

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

object (BulletSuggestionState)

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

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

boolean

Wskazuje, czy istnieje sugerowana zmiana w atrybucie listId.

boolean

Wskazuje, czy istnieje sugerowana zmiana w atrybucie nestingLevel.

object (TextStyleSuggestionState)

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

{
  "objectIds": [
    string
  ]
}

string

Identyfikatory obiektów.

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

string

Sugerowane identyfikatory wstawiania. Element SectionBreak może mieć wiele identyfikatorów wstawiania, jeśli jest to zagnieżdżona sugerowana zmiana. Jeśli to pole jest puste, nie jest to sugerowane wstawienie.

string

Identyfikatory sugerowanych usunięć. Jeśli pole jest puste, nie ma sugestii usunięcia tej treści.

object (SectionStyle)

Styl sekcji po tym podziałie sekcji.

{
  "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
}

object (SectionColumnProperties)

Właściwości kolumn sekcji.

Jeśli ta sekcja jest pusta, zawiera 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 należy ustawić konkretną wartość. Usunięcie ustawienia tej właściwości spowoduje błąd 400 błędnego żądania.

enum (ColumnSeparatorStyle)

Styl separatorów kolumn.

Ten styl możesz ustawić, nawet jeśli w sekcji jest 1 kolumna.

Podczas aktualizowania tej właściwości należy ustawić konkretną wartość. Usunięcie ustawienia tej usługi spowoduje błąd 400 błędnego żądania.

enum (ContentDirection)

Kierunek treści tej sekcji. Jeśli zasada jest nieskonfigurowana, stosowana jest wartość domyślna LEFT_TO_RIGHT.

Podczas aktualizowania tej właściwości należy ustawić konkretną wartość. Usunięcie ustawienia tej usługi spowoduje błąd 400 błędnego żądania.

object (Dimension)

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

Podczas aktualizowania tej właściwości należy ustawić konkretną wartość. Usunięcie ustawienia tej usługi spowoduje błąd 400 błędnego żądania.

object (Dimension)

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

Podczas aktualizowania tej właściwości należy ustawić konkretną wartość. Usunięcie ustawienia tej usługi spowoduje błąd 400 błędnego żądania.

object (Dimension)

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

Podczas aktualizowania tej właściwości należy ustawić konkretną wartość. Usunięcie ustawienia tej usługi spowoduje błąd 400 błędnego żądania.

object (Dimension)

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

Podczas aktualizowania tej właściwości należy ustawić konkretną wartość. Usunięcie ustawienia tej usługi spowoduje błąd 400 błędnego żądania.

object (Dimension)

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

Podczas aktualizowania tej właściwości należy ustawić konkretną wartość. Usunięcie ustawienia tej usługi spowoduje błąd 400 błędnego żądania.

object (Dimension)

Margines stopki sekcji. Jeśli zasada jest nieskonfigurowana, wartość domyślna z DocumentStyle to marginFooter. Po aktualizacji zasada useCustomHeaderFooterMargins ma wartość prawda w stylu DocumentStyle. Wartość atrybutu useCustomHeaderFooterMargins w DocumentStyle wskazuje, czy margines stopki jest respektowany dla tej sekcji

Podczas aktualizowania tej właściwości należy ustawić konkretną wartość. Usunięcie ustawienia tej usługi spowoduje błąd 400 błędnego żądania.

enum (SectionType)

Tylko dane wyjściowe. Typ sekcji.

string

Identyfikator domyślnego nagłówka. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z poprzedniej wartości atrybutu sectionStyle w zasadzie SectionBreak's. Jeśli wartość nie jest skonfigurowana w pierwszym polu sectionBreak, jest dziedziczona z elementu defaultHeaderId DocumentStyle.

Ta usługa jest tylko do odczytu.

string

Identyfikator domyślnej stopki. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z poprzedniej wartości atrybutu sectionStyle w zasadzie SectionBreak's. Jeśli wartość nie jest skonfigurowana w pierwszym polu sectionBreak, jest dziedziczona z elementu defaultFooterId DocumentStyle.

Ta usługa jest tylko do odczytu.

string

Identyfikator nagłówka używany tylko na pierwszej stronie sekcji. Jeśli useFirstPageHeaderFooter ma wartość prawda, ta wartość jest używana w nagłówku na pierwszej stronie sekcji. Jeśli ma wartość false (fałsz), w nagłówku pierwszej strony sekcji jest używany element defaultHeaderId. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z poprzedniej wartości atrybutu sectionStyle w zasadzie SectionBreak's. Jeśli wartość nie jest skonfigurowana w pierwszym polu sectionBreak, jest dziedziczona z elementu firstPageHeaderId DocumentStyle.

Ta usługa jest tylko do odczytu.

string

Identyfikator stopki używany tylko na pierwszej stronie sekcji. Jeśli useFirstPageHeaderFooter ma wartość prawda, ta wartość jest używana w stopce na pierwszej stronie sekcji. Jeśli ma wartość false (fałsz), stopka na pierwszej stronie sekcji używa elementu defaultFooterId. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z poprzedniej wartości atrybutu sectionStyle w zasadzie SectionBreak's. Jeśli wartość nie jest skonfigurowana w pierwszym polu sectionBreak, jest dziedziczona z elementu firstPageFooterId DocumentStyle.

Ta usługa jest tylko do odczytu.

string

Identyfikator nagłówka używany tylko w przypadku stron parzystych. Jeśli wartość parametru useEvenPageHeaderFooter DocumentStyle jest prawda, ta wartość jest używana w przypadku nagłówków na parzystych stronach w sekcji. W przypadku wartości false (fałsz) w nagłówkach stron parzystych jest używany element defaultHeaderId. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z poprzedniej wartości atrybutu sectionStyle w zasadzie SectionBreak's. Jeśli wartość nie jest skonfigurowana w pierwszym polu sectionBreak, jest dziedziczona z elementu evenPageHeaderId DocumentStyle.

Ta usługa jest tylko do odczytu.

string

Identyfikator stopki używany tylko w przypadku stron parzystych. Jeśli wartość parametru useEvenPageHeaderFooter DocumentStyle jest prawda, ta wartość jest używana w stopkach na parzystych stronach w sekcji. Jeśli ma wartość false (fałsz), w stopkach na parzystych stronach jest używany element defaultFooterId. Jeśli zasada jest nieskonfigurowana, wartość jest dziedziczona z poprzedniej wartości atrybutu sectionStyle w zasadzie SectionBreak's. Jeśli wartość nie jest skonfigurowana w pierwszym polu sectionBreak, jest dziedziczona z elementu evenPageFooterId DocumentStyle.

Ta usługa jest tylko do odczytu.

boolean

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

Podczas aktualizowania tej właściwości należy ustawić konkretną wartość. Usunięcie ustawienia tej usługi spowoduje błąd 400 błędnego żądania.

integer

Numer strony, od której zaczyna się zliczanie stron tej sekcji. Jeśli nie jest skonfigurowana, numerowanie stron jest kontynuowane z poprzedniej sekcji. Jeśli wartość jest nieskonfigurowana w pierwszym ustawieniu SectionBreak, zapoznaj się z pageNumberStart klasy DocumentStyle.

Podczas aktualizowania tej właściwości należy ustawić konkretną wartość. Usunięcie ustawienia tej usługi spowoduje błąd 400 błędnego żądania.

boolean

Opcjonalnie. Wskazuje, czy w tej sekcji mają zostać odwrócone wymiary elementu pageSize DocumentStyle. Pozwala to zmienić orientację strony z pionowej na poziomą lub odwrotnie. Jeśli nie jest skonfigurowana, wartość dziedziczy wartość z elementu flipPageOrientation DocumentStyle.

Podczas aktualizowania tej właściwości należy ustawić konkretną wartość. Usunięcie ustawienia tej usługi spowoduje błąd 400 błędnego żądania.

{
  "width": {
    object (Dimension)
  },
  "paddingEnd": {
    object (Dimension)
  }
}

object (Dimension)

Tylko dane wyjściowe. Szerokość kolumny.

object (Dimension)

Dopełnienie na końcu kolumny.

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

integer

Liczba wierszy w tabeli.

integer

Liczba kolumn w tabeli.

Tabela może być nieprostokątna, więc niektóre wiersze mogą zawierać różną liczbę komórek.

object (TableRow)

Zawartość i styl każdego wiersza.

string

Sugerowane identyfikatory wstawiania. Element Table może mieć wiele identyfikatorów wstawiania, jeśli jest to zagnieżdżona sugerowana zmiana. Jeśli to pole jest puste, nie jest to sugerowane wstawienie.

string

Identyfikatory sugerowanych usunięć. Jeśli pole jest puste, nie ma sugestii usunięcia tej treści.

object (TableStyle)

Styl tabeli.

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

integer

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

integer

Liczący od zera indeks końcowy tego wiersza, wyłączny, w jednostkach kodu UTF-16.

object (TableCell)

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

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

string

Sugerowane identyfikatory wstawiania. Element TableRow może mieć wiele identyfikatorów wstawiania, jeśli jest to zagnieżdżona sugerowana zmiana. Jeśli to pole jest puste, nie jest to sugerowane wstawienie.

string

Identyfikatory sugerowanych usunięć. Jeśli pole jest puste, nie ma sugestii usunięcia tej treści.

object (TableRowStyle)

Styl wiersza tabeli.

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

Sugerowane zmiany stylu w tym wierszu, zgodnie z identyfikatorem sugestii.

{
  "startIndex": integer,
  "endIndex": integer,
  "content": [
    {
      object (StructuralElement)
    }
  ],
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "suggestedTableCellStyleChanges": {
    string: {
      object (SuggestedTableCellStyle)
    },
    ...
  }
}

integer

Indeks początkowy tej komórki liczony od zera, w jednostkach kodu UTF-16.

integer

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

object (StructuralElement)

Zawartość komórki.

object (TableCellStyle)

Styl komórki.

string

Sugerowane identyfikatory wstawiania. Element TableCell może mieć wiele identyfikatorów wstawiania, jeśli jest to zagnieżdżona sugerowana zmiana. Jeśli to pole jest puste, nie jest to sugerowane wstawienie.

string

Identyfikatory sugerowanych usunięć. Jeśli pole jest puste, nie ma sugestii usunięcia tej treści.

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

Sugerowane zmiany stylu komórki tabeli na podstawie identyfikatora sugestii.

{
  "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)
}

integer

Zakres wiersza komórki.

Ta usługa jest tylko do odczytu.

integer

Rozpiętość kolumny komórki.

Ta usługa jest tylko do odczytu.

object (OptionalColor)

Kolor tła komórki.

object (TableCellBorder)

Lewe obramowanie komórki.

object (TableCellBorder)

Prawe obramowanie komórki.

object (TableCellBorder)

Górne obramowanie komórki.

object (TableCellBorder)

Dolne obramowanie komórki.

object (Dimension)

Lewe dopełnienie komórki.

object (Dimension)

Prawe dopełnienie komórki.

object (Dimension)

Górne dopełnienie komórki.

object (Dimension)

Dolne dopełnienie komórki.

enum (ContentAlignment)

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

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

object (OptionalColor)

Kolor obramowania.

Ten kolor nie może być przezroczysty.

object (Dimension)

Szerokość obramowania.

enum (DashStyle)

Styl obramowania.

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

object (TableCellStyle)

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

object (TableCellStyleSuggestionState)

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

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

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości rowSpan.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości columnSpan.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości backgroundColor.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości borderLeft.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości borderRight.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości borderTop.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości borderBottom.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości paddingLeft.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości paddingRight.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości paddingTop.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości paddingBottom.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości contentAlignment.

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

object (Dimension)

Minimalna wysokość wiersza. Wiersz będzie renderowany w edytorze Dokumentów na wysokości równej lub większej niż ta wartość. Będzie wtedy można wyświetlić całą zawartość komórek wiersza.

boolean

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

boolean

Określa, czy wiersz nie może wykraczać poza granice strony lub kolumn.

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

object (TableRowStyle)

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

object (TableRowStyleSuggestionState)

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

{
  "minRowHeightSuggested": boolean
}

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości minRowHeight.

{
  "tableColumnProperties": [
    {
      object (TableColumnProperties)
    }
  ]
}

object (TableColumnProperties)

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

Pamiętaj, że w Dokumentach tabele zawierają wiersze, a wiersze – komórki podobne do tych w języku HTML. Dlatego właściwości wiersza można znaleźć w jego kolumnie tableRowStyle.

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

enum (WidthType)

Typ szerokości kolumny.

object (Dimension)

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

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

object (StructuralElement)

Zawartość spisu treści.

string

Sugerowane identyfikatory wstawiania. Element TableOfContents może mieć wiele identyfikatorów wstawiania, jeśli jest to zagnieżdżona sugerowana zmiana. Jeśli to pole jest puste, nie jest to sugerowane wstawienie.

string

Identyfikatory sugerowanych usunięć. Jeśli pole jest puste, nie ma sugestii usunięcia tej treści.

{
  "headerId": string,
  "content": [
    {
      object (StructuralElement)
    }
  ]
}

string

Identyfikator nagłówka.

object (StructuralElement)

Treść nagłówka.

Indeksy treści nagłówka rozpoczynają się od zera.

{
  "footerId": string,
  "content": [
    {
      object (StructuralElement)
    }
  ]
}

string

Identyfikator stopki.

object (StructuralElement)

Zawartość stopki.

Indeksy zawartości stopki rozpoczynają się od zera.

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

string

Identyfikator przypisu.

object (StructuralElement)

Treść przypisu.

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

{
  "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
}

object (Background)

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

string

Identyfikator domyślnego nagłówka. Jeśli jej nie skonfigurujesz, domyślny nagłówek nie będzie niedostępny.

Ta usługa jest tylko do odczytu.

string

Identyfikator domyślnej stopki. Jeśli jej nie skonfigurujesz, stopka domyślna nie będzie używana.

Ta usługa jest tylko do odczytu.

string

Identyfikator nagłówka używany tylko w przypadku stron parzystych. Wartość useEvenPageHeaderFooter określa, czy na stronach parzystych używać w nagłówku tagu defaultHeaderId czy tej wartości. Jeśli jej nie skonfigurujesz, nagłówek stron parzystych nie będzie używany.

Ta usługa jest tylko do odczytu.

string

Identyfikator stopki używany tylko w przypadku stron parzystych. Wartość useEvenPageHeaderFooter określa, czy w stopce na stronach parzystych ma być używana stopka defaultFooterId czy ta wartość. Jeśli jej nie skonfigurujesz, stopka stron parzystych nie będzie używana.

Ta usługa jest tylko do odczytu.

string

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

Ta usługa jest tylko do odczytu.

string

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

Ta usługa jest tylko do odczytu.

boolean

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

boolean

Wskazuje, czy w przypadku stron parzystych używać identyfikatorów nagłówków / stopek stron parzystych.

integer

Numer strony, od której zaczyna się zliczanie stron.

object (Dimension)

Górny margines strony.

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

object (Dimension)

Dolny margines strony.

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

object (Dimension)

Prawy margines strony.

Zmiana prawego marginesu strony na styl dokumentu powoduje usunięcie prawego marginesu strony we wszystkich stylach sekcji. Może to też spowodować zmianę rozmiaru kolumn we wszystkich sekcjach.

object (Dimension)

Lewy margines strony.

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

object (Size)

Rozmiar strony w dokumencie.

object (Dimension)

Wielkość odstępu między górną krawędzią strony a treścią nagłówka.

object (Dimension)

Wielkość odstępu między dolną krawędzią strony a zawartością stopki.

boolean

Wskazuje, czy respektowane są style DocumentStyle marginHeader, Style sekcji marginHeader i Styl dokumentu marginFooter oraz Styl sekcji marginFooter. Gdy ma wartość Fałsz, używane są domyślne wartości marginesów nagłówka i stopki z edytora Dokumentów.

Ta usługa jest tylko do odczytu.

boolean

Opcjonalnie. Wskazuje, czy chcesz odwrócić wymiary elementu pageSize, co pozwala zmienić orientację strony z pionowej lub poziomej.

{
  "color": {
    object (OptionalColor)
  }
}

object (OptionalColor)

Kolor tła.

{
  "height": {
    object (Dimension)
  },
  "width": {
    object (Dimension)
  }
}

object (Dimension)

Wysokość obiektu.

object (Dimension)

Szerokość obiektu.

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

object (DocumentStyle)

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

object (DocumentStyleSuggestionState)

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

{
  "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
}

object (BackgroundSuggestionState)

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

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości defaultHeaderId.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości defaultFooterId.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości evenPageHeaderId.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości evenPageFooterId.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości firstPageHeaderId.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości firstPageFooterId.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości useFirstPageHeaderFooter.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości useEvenPageHeaderFooter.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości pageNumberStart.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości marginTop.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości marginBottom.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości marginRight.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości marginLeft.

object (SizeSuggestionState)

Maska wskazująca, które z pól w [rozmiar] [google.apps.docs.v1.DocumentStyle.size] zostały zmienione w tej sugestii.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości marginHeader.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości marginFooter.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości useCustomHeaderFooterMargins.

boolean

Opcjonalnie. Wskazuje, czy istnieje sugerowana zmiana wartości flipPageOrientation.

{
  "backgroundColorSuggested": boolean
}

boolean

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

{
  "heightSuggested": boolean,
  "widthSuggested": boolean
}

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości height.

boolean

Wskazuje, czy istnieje sugerowana zmiana wartości width.

{
  "styles": [
    {
      object (NamedStyle)
    }
  ]
}

object (NamedStyle)

Style nazwane.

Istnieje wpis dla każdej z możliwych wartości (named style types).

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

enum (NamedStyleType)

Typ tego stylu nazwanego.

object (TextStyle)

Styl tekstu tego stylu nazwanego.

object (ParagraphStyle)

Styl akapitu tego stylu nazwanego.

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

object (NamedStyles)

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

object (NamedStylesSuggestionState)

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

{
  "stylesSuggestionStates": [
    {
      object (NamedStyleSuggestionState)
    }
  ]
}

object (NamedStyleSuggestionState)

Maska wskazująca, które pola odpowiedniego NamedStyle w styles zostały zmienione w tej sugestii.

Kolejność stanu sugestii nazwanych odpowiada kolejności odpowiedniego stylu nazwanego w sugestii named styles.