openapi-directory/api/googleapis.com/docs.json

Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS

{"openapi":"3.0.0","servers":[{"url":"https://docs.googleapis.com/"}],"info":{"contact":{"name":"Google","url":"https://google.com","x-twitter":"youtube"},"description":"Reads and writes Google Docs documents.","license":{"name":"Creative Commons Attribution 3.0","url":"http://creativecommons.org/licenses/by/3.0/"},"termsOfService":"https://developers.google.com/terms/","title":"Google Docs API","version":"v1","x-apiClientRegistration":{"url":"https://console.developers.google.com"},"x-apisguru-categories":["analytics","media"],"x-logo":{"url":"https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png"},"x-origin":[{"converter":{"url":"https://github.com/mermade/oas-kit","version":"7.0.4"},"format":"google","url":"https://docs.googleapis.com/$discovery/rest?version=v1","version":"v1"}],"x-providerName":"googleapis.com","x-serviceName":"docs"},"externalDocs":{"url":"https://developers.google.com/docs/"},"tags":[{"name":"documents"}],"paths":{"/v1/documents":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Creates a blank document using the title given in the request. Other fields in the request, including any provided content, are ignored. Returns the created document.","operationId":"docs.documents.create","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Document"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Document"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/documents"],"Oauth2c":["https://www.googleapis.com/auth/documents"]},{"Oauth2":["https://www.googleapis.com/auth/drive"],"Oauth2c":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"],"Oauth2c":["https://www.googleapis.com/auth/drive.file"]}],"tags":["documents"]}},"/v1/documents/{documentId}":{"get":{"description":"Gets the latest version of the specified document.","operationId":"docs.documents.get","parameters":[{"description":"The ID of the document to retrieve.","in":"path","name":"documentId","required":true,"schema":{"type":"string"}},{"description":"The suggestions view mode to apply to the document. This allows viewing the document with all suggestions inline, accepted or rejected. If one is not specified, DEFAULT_FOR_CURRENT_ACCESS is used.","in":"query","name":"suggestionsViewMode","schema":{"enum":["DEFAULT_FOR_CURRENT_ACCESS","SUGGESTIONS_INLINE","PREVIEW_SUGGESTIONS_ACCEPTED","PREVIEW_WITHOUT_SUGGESTIONS"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Document"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/documents"],"Oauth2c":["https://www.googleapis.com/auth/documents"]},{"Oauth2":["https://www.googleapis.com/auth/documents.readonly"],"Oauth2c":["https://www.googleapis.com/auth/documents.readonly"]},{"Oauth2":["https://www.googleapis.com/auth/drive"],"Oauth2c":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"],"Oauth2c":["https://www.googleapis.com/auth/drive.file"]},{"Oauth2":["https://www.googleapis.com/auth/drive.readonly"],"Oauth2c":["https://www.googleapis.com/auth/drive.readonly"]}],"tags":["documents"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v1/documents/{documentId}:batchUpdate":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Applies one or more updates to the document. Each request is validated before being applied. If any request is not valid, then the entire request will fail and nothing will be applied. Some requests have replies to give you some information about how they are applied. Other requests do not need to return information; these each return an empty reply. The order of replies matches that of the requests. For example, suppose you call batchUpdate with four updates, and only the third one returns information. The response would have two empty replies, the reply to the third request, and another empty reply, in that order. Because other users may be editing the document, the document might not exactly reflect your changes: your changes may be altered with respect to collaborator changes. If there are no collaborators, the document should reflect your changes. In any case, the updates in your request are guaranteed to be applied together atomically.","operationId":"docs.documents.batchUpdate","parameters":[{"description":"The ID of the document to update.","in":"path","name":"documentId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchUpdateDocumentRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchUpdateDocumentResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/documents"],"Oauth2c":["https://www.googleapis.com/auth/documents"]},{"Oauth2":["https://www.googleapis.com/auth/drive"],"Oauth2c":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"],"Oauth2c":["https://www.googleapis.com/auth/drive.file"]}],"tags":["documents"]}}},"components":{"parameters":{"_.xgafv":{"description":"V1 error format.","in":"query","name":"$.xgafv","schema":{"enum":["1","2"],"type":"string"}},"access_token":{"description":"OAuth access token.","in":"query","name":"access_token","schema":{"type":"string"}},"alt":{"description":"Data format for response.","in":"query","name":"alt","schema":{"enum":["json","media","proto"],"type":"string"}},"callback":{"description":"JSONP","in":"query","name":"callback","schema":{"type":"string"}},"fields":{"description":"Selector specifying which fields to include in a partial response.","in":"query","name":"fields","schema":{"type":"string"}},"key":{"description":"API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.","in":"query","name":"key","schema":{"type":"string"}},"oauth_token":{"description":"OAuth 2.0 token for the current user.","in":"query","name":"oauth_token","schema":{"type":"string"}},"prettyPrint":{"description":"Returns response with indentations and line breaks.","in":"query","name":"prettyPrint","schema":{"type":"boolean"}},"quotaUser":{"description":"Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.","in":"query","name":"quotaUser","schema":{"type":"string"}},"uploadType":{"description":"Legacy upload protocol for media (e.g. \"media\", \"multipart\").","in":"query","name":"uploadType","schema":{"type":"string"}},"upload_protocol":{"description":"Upload protocol for media (e.g. \"raw\", \"multipart\").","in":"query","name":"upload_protocol","schema":{"type":"string"}}},"schemas":{"AutoText":{"description":"A ParagraphElement representing a spot in the text that's dynamically replaced with content that can change over time, like a page number.","properties":{"suggestedDeletionIds":{"description":"The suggested deletion IDs. If empty, then there are no suggested deletions of this content.","items":{"type":"string"},"type":"array"},"suggestedInsertionIds":{"description":"The suggested insertion IDs. An AutoText may have multiple insertion IDs if it's a nested suggested change. If empty, then this is not a suggested insertion.","items":{"type":"string"},"type":"array"},"suggestedTextStyleChanges":{"additionalProperties":{"$ref":"#/components/schemas/SuggestedTextStyle"},"description":"The suggested text style changes to this AutoText, keyed by suggestion ID.","type":"object"},"textStyle":{"$ref":"#/components/schemas/TextStyle","description":"The text style of this AutoText."},"type":{"description":"The type of this auto text.","enum":["TYPE_UNSPECIFIED","PAGE_NUMBER","PAGE_COUNT"],"type":"string"}},"type":"object"},"Background":{"description":"Represents the background of a document.","properties":{"color":{"$ref":"#/components/schemas/OptionalColor","description":"The background color."}},"type":"object"},"BackgroundSuggestionState":{"description":"A mask that indicates which of the fields on the base Background have been changed in this suggestion. For any field set to true, the Backgound has a new suggested value.","properties":{"backgroundColorSuggested":{"description":"Indicates whether the current background color has been modified in this suggestion.","type":"boolean"}},"type":"object"},"BatchUpdateDocumentRequest":{"description":"Request message for BatchUpdateDocument.","properties":{"requests":{"description":"A list of updates to apply to the document.","items":{"$ref":"#/components/schemas/Request"},"type":"array"},"writeControl":{"$ref":"#/components/schemas/WriteControl","description":"Provides control over how write requests are executed."}},"type":"object"},"BatchUpdateDocumentResponse":{"description":"Response message from a BatchUpdateDocument request.","properties":{"documentId":{"description":"The ID of the document to which the updates were applied to.","type":"string"},"replies":{"description":"The reply of the updates. This maps 1:1 with the updates, although replies to some requests may be empty.","items":{"$ref":"#/components/schemas/Response"},"type":"array"},"writeControl":{"$ref":"#/components/schemas/WriteControl","description":"The updated write control after applying the request."}},"type":"object"},"Body":{"description":"The document body. The body typically contains the full document contents except for headers, footers, and footnotes.","properties":{"content":{"description":"The contents of the body. The indexes for the body's content begin at zero.","items":{"$ref":"#/components/schemas/StructuralElement"},"type":"array"}},"type":"object"},"Bullet":{"description":"Describes the bullet of a paragraph.","properties":{"listId":{"description":"The ID of the list this paragraph belongs to.","type":"string"},"nestingLevel":{"description":"The nesting level of this paragraph in the list.","format":"int32","type":"integer"},"textStyle":{"$ref":"#/components/schemas/TextStyle","description":"The paragraph-specific text style applied to this bullet."}},"type":"object"},"BulletSuggestionState":{"description":"A mask that indicates which of the fields on the base Bullet have been changed in this suggestion. For any field set to true, there's a new suggested value.","properties":{"listIdSuggested":{"description":"Indicates if there was a suggested change to the list_id.","type":"boolean"},"nestingLevelSuggested":{"description":"Indicates if there was a suggested change to the nesting_level.","type":"boolean"},"textStyleSuggestionState":{"$ref":"#/components/schemas/TextStyleSuggestionState","description":"A mask that indicates which of the fields in text style have been changed in this suggestion."}},"type":"object"},"Color":{"description":"A solid color.","properties":{"rgbColor":{"$ref":"#/components/schemas/RgbColor","description":"The RGB color value."}},"type":"object"},"ColumnBreak":{"description":"A ParagraphElement representing a column break. A column break makes the subsequent text start at the top of the next column.","properties":{"suggestedDeletionIds":{"description":"The suggested deletion IDs. If empty, then there are no suggested deletions of this content.","items":{"type":"string"},"type":"array"},"suggestedInsertionIds":{"description":"The suggested insertion IDs. A ColumnBreak may have multiple insertion IDs if it's a nested suggested change. If empty, then this is not a suggested insertion.","items":{"type":"string"},"type":"array"},"suggestedTextStyleChanges":{"additionalProperties":{"$ref":"#/components/schemas/SuggestedTextStyle"},"description":"The suggested text style changes to this ColumnBreak, keyed by suggestion ID.","type":"object"},"textStyle":{"$ref":"#/components/schemas/TextStyle","description":"The text style of this ColumnBreak. Similar to text content, like text runs and footnote references, the text style of a column break can affect content layout as well as the styling of text inserted next to it."}},"type":"object"},"CreateFooterRequest":{"description":"Creates a Footer. The new footer is applied to the SectionStyle at the location of the SectionBreak if specified, otherwise it is applied to the DocumentStyle. If a footer of the specified type already exists, a 400 bad request error is returned.","properties":{"sectionBreakLocation":{"$ref":"#/components/schemas/Location","description":"The location of the SectionBreak immediately preceding the section whose SectionStyle this footer should belong to. If this is unset or refers to the first section break in the document, the footer applies to the document style."},"type":{"description":"The type of footer to create.","enum":["HEADER_FOOTER_TYPE_UNSPECIFIED","DEFAULT"],"type":"string"}},"type":"object"},"CreateFooterResponse":{"description":"The result of creating a footer.","properties":{"footerId":{"description":"The ID of the created footer.","type":"string"}},"type":"object"},"CreateFootnoteRequest":{"description":"Creates a Footnote segment and inserts a new FootnoteReference to it at the given location. The new Footnote segment will contain a space followed by a newline character.","properties":{"endOfSegmentLocation":{"$ref":"#/components/schemas/EndOfSegmentLocation","description":"Inserts the footnote reference at the end of the document body. Footnote references cannot be inserted inside a header, footer or footnote. Since footnote references can only be inserted in the body, the segment ID field must be empty."},"location":{"$ref":"#/components/schemas/Location","description":"Inserts the footnote reference at a specific index in the document. The footnote reference must be inserted inside the bounds of an existing Paragraph. For instance, it cannot be inserted at a table's start index (i.e. between the table and its preceding paragraph). Footnote references cannot be inserted inside an equation, header, footer or footnote. Since footnote references can only be inserted in the body, the segment ID field must be empty."}},"type":"object"},"CreateFootnoteResponse":{"description":"The result of creating a footnote.","properties":{"footnoteId":{"description":"The ID of the created footnote.","type":"string"}},"type":"object"},"CreateHeaderRequest":{"description":"Creates a Header. The new header is applied to the SectionStyle at the location of the SectionBreak if specified, otherwise it is applied to the DocumentStyle. If a header of the specified type already exists, a 400 bad request error is returned.","properties":{"sectionBreakLocation":{"$ref":"#/components/schemas/Location","description":"The location of the SectionBreak which begins the section this header should belong to. If `section_break_location' is unset or if it refers to the first section break in the document body, the header applies to the DocumentStyle"},"type":{"description":"The type of header to create.","enum":["HEADER_FOOTER_TYPE_UNSPECIFIED","DEFAULT"],"type":"string"}},"type":"object"},"CreateHeaderResponse":{"description":"The result of creating a header.","properties":{"headerId":{"description":"The ID of the created header.","type":"string"}},"type":"object"},"CreateNamedRangeRequest":{"description":"Creates a NamedRange referencing the given range.","properties":{"name":{"description":"The name of the NamedRange. Names do not need to be unique. Names must be at least 1 character and no more than 256 characters, measured in UTF-16 code units.","type":"string"},"range":{"$ref":"#/components/schemas/Range","description":"The range to apply the name to."}},"type":"object"},"CreateNamedRangeResponse":{"description":"The result of creating a named range.","properties":{"namedRangeId":{"description":"The ID of the created named range.","type":"string"}},"type":"object"},"CreateParagraphBulletsRequest":{"description":"Creates bullets for all of the paragraphs that overlap with the given range. The nesting level of each paragraph will be determined by counting leading tabs in front of each paragraph. To avoid excess space between the bullet and the corresponding paragraph, these leading tabs are removed by this request. This may change the indices of parts of the text. If the paragraph immediately before paragraphs being updated is in a list with a matching preset, the paragraphs being updated are added to that preceding list.","properties":{"bulletPreset":{"description":"The kinds of bullet glyphs to be used.","enum":["BULLET_GLYPH_PRESET_UNSPECIFIED","BULLET_DISC_CIRCLE_SQUARE","BULLET_DIAMONDX_ARROW3D_SQUARE","BULLET_CHECKBOX","BULLET_ARROW_DIAMOND_DISC","BULLET_STAR_CIRCLE_SQUARE","BULLET_ARROW3D_CIRCLE_SQUARE","BULLET_LEFTTRIANGLE_DIAMOND_DISC","BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE","BULLET_DIAMOND_CIRCLE_SQUARE","NUMBERED_DECIMAL_ALPHA_ROMAN","NUMBERED_DECIMAL_ALPHA_ROMAN_PARENS","NUMBERED_DECIMAL_NESTED","NUMBERED_UPPERALPHA_ALPHA_ROMAN","NUMBERED_UPPERROMAN_UPPERALPHA_DECIMAL","NUMBERED_ZERODECIMAL_ALPHA_ROMAN"],"type":"string"},"range":{"$ref":"#/components/schemas/Range","description":"The range to apply the bullet preset to."}},"type":"object"},"CropProperties":{"description":"The crop properties of an image. The crop rectangle is represented using fractional offsets from the original content's 4 edges. - If the offset is in the interval (0, 1), the corresponding edge of crop rectangle is positioned inside of the image's original bounding rectangle. - If the offset is negative or greater than 1, the corresponding edge of crop rectangle is positioned outside of the image's original bounding rectangle. - If all offsets and rotation angle are 0, the image is not cropped.","properties":{"angle":{"description":"The clockwise rotation angle of the crop rectangle around its center, in radians. Rotation is applied after the offsets.","format":"float","type":"number"},"offsetBottom":{"description":"The offset specifies how far inwards the bottom edge of the crop rectangle is from the bottom edge of the original content as a fraction of the original content's height.","format":"float","type":"number"},"offsetLeft":{"description":"The offset specifies how far inwards the left edge of the crop rectangle is from the left edge of the original content as a fraction of the original content's width.","format":"float","type":"number"},"offsetRight":{"description":"The offset specifies how far inwards the right edge of the crop rectangle is from the right edge of the original content as a fraction of the original content's width.","format":"float","type":"number"},"offsetTop":{"description":"The offset specifies how far inwards the top edge of the crop rectangle is from the top edge of the original content as a fraction of the original content's height.","format":"float","type":"number"}},"type":"object"},"CropPropertiesSuggestionState":{"description":"A mask that indicates which of the fields on the base CropProperties have been changed in this suggestion. For any field set to true, there's a new suggested value.","properties":{"angleSuggested":{"description":"Indicates if there was a suggested change to angle.","type":"boolean"},"offsetBottomSuggested":{"description":"Indicates if there was a suggested change to offset_bottom.","type":"boolean"},"offsetLeftSuggested":{"description":"Indicates if there was a suggested change to offset_left.","type":"boolean"},"offsetRightSuggested":{"description":"Indicates if there was a suggested change to offset_right.","type":"boolean"},"offsetTopSuggested":{"description":"Indicates if there was a suggested change to offset_top.","type":"boolean"}},"type":"object"},"DeleteContentRangeRequest":{"description":"Deletes content from the document.","properties":{"range":{"$ref":"#/components/schemas/Range","description":"The range of content to delete. Deleting text that crosses a paragraph boundary may result in changes to paragraph styles, lists, positioned objects and bookmarks as the two paragraphs are merged. Attempting to delete certain ranges can result in an invalid document structure in which case a 400 bad request error is returned. Some examples of invalid delete requests include: * Deleting one code unit of a surrogate pair. * Deleting the last newline character of a Body, Header, Footer, Footnote, TableCell or TableOfContents. * Deleting the start or end of a Table, TableOfContents or Equation without deleting the entire element. * Deleting the newline character before a Table, TableOfContents or SectionBreak without deleting the element. * Deleting individual rows or cells of a table. Deleting the content within a table cell is allowed."}},"type":"object"},"DeleteFooterRequest":{"description":"Deletes a Footer from the document.","properties":{"footerId":{"description":"The id of the footer to delete. If this footer is defined on DocumentStyle, the reference to this footer is removed, resulting in no footer of that type for the first section of the document. If this footer is defined on a SectionStyle, the reference to this footer is removed and the footer of that type is now continued from the previous section.","type":"string"}},"type":"object"},"DeleteHeaderRequest":{"description":"Deletes a Header from the document.","properties":{"headerId":{"description":"The id of the header to delete. If this header is defined on DocumentStyle, the reference to this header is removed, resulting in no header of that type for the first section of the document. If this header is defined on a SectionStyle, the reference to this header is removed and the header of that type is now continued from the previous section.","type":"string"}},"type":"object"},"DeleteNamedRangeRequest":{"description":"Deletes a NamedRange.","properties":{"name":{"description":"The name of the range(s) to delete. All named ranges with the given name will be deleted.","type":"string"},"namedRangeId":{"description":"The ID of the named range to delete.","type":"string"}},"type":"object"},"DeleteParagraphBulletsRequest":{"description":"Deletes bullets from all of the paragraphs that overlap with the given range. The nesting level of each paragraph will be visually preserved by adding indent to the start of the corresponding paragraph.","properties":{"range":{"$ref":"#/components/schemas/Range","description":"The range to delete bullets from."}},"type":"object"},"DeletePositionedObjectRequest":{"description":"Deletes a PositionedObject from the document.","properties":{"objectId":{"description":"The ID of the positioned object to delete.","type":"string"}},"type":"object"},"DeleteTableColumnRequest":{"description":"Deletes a column from a table.","properties":{"tableCellLocation":{"$ref":"#/components/schemas/TableCellLocation","description":"The reference table cell location from which the column will be deleted. The column this cell spans will be deleted. If this is a merged cell that spans multiple columns, all columns that the cell spans will be deleted. If no columns remain in the table after this deletion, the whole table is deleted."}},"type":"object"},"DeleteTableRowRequest":{"description":"Deletes a row from a table.","properties":{"tableCellLocation":{"$ref":"#/components/schemas/TableCellLocation","description":"The reference table cell location from which the row will be deleted. The row this cell spans will be deleted. If this is a merged cell that spans multiple rows, all rows that the cell spans will be deleted. If no rows remain in the table after this deletion, the whole table is deleted."}},"type":"object"},"Dimension":{"description":"A magnitude in a single direction in the specified units.","properties":{"magnitude":{"description":"The magnitude.","format":"double","type":"number"},"unit":{"description":"The units for magnitude.","enum":["UNIT_UNSPECIFIED","PT"],"type":"string"}},"type":"object"},"Document":{"description":"A Google Docs document.","properties":{"body":{"$ref":"#/components/schemas/Body","description":"Output only. The main body of the document."},"documentId":{"description":"Output only. The ID of the document.","type":"string"},"documentStyle":{"$ref":"#/components/schemas/DocumentStyle","description":"Output only. The style of the document."},"footers":{"additionalProperties":{"$ref":"#/components/schemas/Footer"},"description":"Output only. The footers in the document, keyed by footer ID.","type":"object"},"footnotes":{"additionalProperties":{"$ref":"#/components/schemas/Footnote"},"description":"Output only. The footnotes in the document, keyed by footnote ID.","type":"object"},"headers":{"additionalProperties":{"$ref":"#/components/schemas/Header"},"description":"Output only. The headers in the document, keyed by header ID.","type":"object"},"inlineObjects":{"additionalProperties":{"$ref":"#/components/schemas/InlineObject"},"description":"Output only. The inline objects in the document, keyed by object ID.","type":"object"},"lists":{"additionalProperties":{"$ref":"#/components/schemas/List"},"description":"Output only. The lists in the document, keyed by list ID.","type":"object"},"namedRanges":{"additionalProperties":{"$ref":"#/components/schemas/NamedRanges"},"description":"Output only. The named ranges in the document, keyed by name.","type":"object"},"namedStyles":{"$ref":"#/components/schemas/NamedStyles","description":"Output only. The named styles of the document."},"positionedObjects":{"additionalProperties":{"$ref":"#/components/schemas/PositionedObject"},"description":"Output only. The positioned objects in the document, keyed by object ID.","type":"object"},"revisionId":{"description":"Output only. The revision ID of the document. Can be used in update requests to specify which revision of a document to apply updates to and how the request should behave if the document has been edited since that revision. Only populated if the user has edit access to the document. The revision ID is not a sequential number but an opaque string. The format of the revision ID might change over time. A returned revision ID is only guaranteed to be valid for 24 hours after it has been returned and cannot be shared across users. If the revision ID is unchanged between calls, then the document has not changed. Conversely, a changed ID (for the same document and user) usually means the document has been updated. However, a changed ID can also be due to internal factors such as ID format changes.","type":"string"},"suggestedDocumentStyleChanges":{"additionalProperties":{"$ref":"#/components/schemas/SuggestedDocumentStyle"},"description":"Output only. The suggested changes to the style of the document, keyed by suggestion ID.","type":"object"},"suggestedNamedStylesChanges":{"additionalProperties":{"$ref":"#/components/schemas/SuggestedNamedStyles"},"description":"Output only. The suggested changes to the named styles of the document, keyed by suggestion ID.","type":"object"},"suggestionsViewMode":{"description":"Output only. The suggestions view mode applied to the document. Note: When editing a document, changes must be based on a document with SUGGESTIONS_INLINE.","enum":["DEFAULT_FOR_CURRENT_ACCESS","SUGGESTIONS_INLINE","PREVIEW_SUGGESTIONS_ACCEPTED","PREVIEW_WITHOUT_SUGGESTIONS"],"type":"string"},"title":{"description":"The title of the document.","type":"string"}},"type":"object"},"DocumentStyle":{"description":"The style of the document.","properties":{"background":{"$ref":"#/components/schemas/Background","description":"The background of the document. Documents cannot have a transparent background color."},"defaultFooterId":{"description":"The ID of the default footer. If not set, there's no default footer. This property is read-only.","type":"string"},"defaultHeaderId":{"description":"The ID of the default header. If not set, there's no default header. This property is read-only.","type":"string"},"evenPageFooterId":{"description":"The ID of the footer used only for even pages. The value of use_even_page_header_footer determines whether to use the default_footer_id or this value for the footer on even pages. If not set, there's no even page footer. This property is read-only.","type":"string"},"evenPageHeaderId":{"description":"The ID of the header used only for even pages. The value of use_even_page_header_footer determines whether to use the default_header_id or this value for the header on even pages. If not set, there's no even page header. This property is read-only.","type":"string"},"firstPageFooterId":{"description":"The ID of the footer used only for the first page. If not set then a unique footer for the first page does not exist. The value of use_first_page_header_footer determines whether to use the default_footer_id or this value for the footer on the first page. If not set, there's no first page footer. This property is read-only.","type":"string"},"firstPageHeaderId":{"description":"The ID of the header used only for the first page. If not set then a unique header for the first page does not exist. The value of use_first_page_header_footer determines whether to use the default_header_id or this value for the header on the first page. If not set, there's no first page header. This property is read-only.","type":"string"},"flipPageOrientation":{"description":"Optional. Indicates whether to flip the dimensions of the page_size, which allows changing the page orientation between portrait and landscape.","type":"boolean"},"marginBottom":{"$ref":"#/components/schemas/Dimension","description":"The bottom page margin. Updating the bottom page margin on the document style clears the bottom page margin on all section styles."},"marginFooter":{"$ref":"#/components/schemas/Dimension","description":"The amount of space between the bottom of the page and the contents of the footer."},"marginHeader":{"$ref":"#/components/schemas/Dimension","description":"The amount of space between the top of the page and the contents of the header."},"marginLeft":{"$ref":"#/components/schemas/Dimension","description":"The left page margin. Updating the left page margin on the document style clears the left page margin on all section styles. It may also cause columns to resize in all sections."},"marginRight":{"$ref":"#/components/schemas/Dimension","description":"The right page margin. Updating the right page margin on the document style clears the right page margin on all section styles. It may also cause columns to resize in all sections."},"marginTop":{"$ref":"#/components/schemas/Dimension","description":"The top page margin. Updating the top page margin on the document style clears the top page margin on all section styles."},"pageNumberStart":{"description":"The page number from which to start counting the number of pages.","format":"int32","type":"integer"},"pageSize":{"$ref":"#/components/schemas/Size","description":"The size of a page in the document."},"useCustomHeaderFooterMargins":{"description":"Indicates whether DocumentStyle margin_header, SectionStyle margin_header and DocumentStyle margin_footer, SectionStyle margin_footer are respected. When false, the default values in the Docs editor for header and footer margin are used. This property is read-only.","type":"boolean"},"useEvenPageHeaderFooter":{"description":"Indicates whether to use the even page header / footer IDs for the even pages.","type":"boolean"},"useFirstPageHeaderFooter":{"description":"Indicates whether to use the first page header / footer IDs for the first page.","type":"boolean"}},"type":"object"},"DocumentStyleSuggestionState":{"description":"A mask that indicates which of the fields on the base DocumentStyle have been changed in this suggestion. For any field set to true, there's a new suggested value.","properties":{"backgroundSuggestionState":{"$ref":"#/components/schemas/BackgroundSuggestionState","description":"A mask that indicates which of the fields in background have been changed in this suggestion."},"defaultFooterIdSuggested":{"description":"Indicates if there was a suggested change to default_footer_id.","type":"boolean"},"defaultHeaderIdSuggested":{"description":"Indicates if there was a suggested change to default_header_id.","type":"boolean"},"evenPageFooterIdSuggested":{"description":"Indicates if there was a suggested change to even_page_footer_id.","type":"boolean"},"evenPageHeaderIdSuggested":{"description":"Indicates if there was a suggested change to even_page_header_id.","type":"boolean"},"firstPageFooterIdSuggested":{"description":"Indicates if there was a suggested change to first_page_footer_id.","type":"boolean"},"firstPageHeaderIdSuggested":{"description":"Indicates if there was a suggested change to first_page_header_id.","type":"boolean"},"flipPageOrientationSuggested":{"description":"Optional. Indicates if there was a suggested change to flip_page_orientation.","type":"boolean"},"marginBottomSuggested":{"description":"Indicates if there was a suggested change to margin_bottom.","type":"boolean"},"marginFooterSuggested":{"description":"Indicates if there was a suggested change to margin_footer.","type":"boolean"},"marginHeaderSuggested":{"description":"Indicates if there was a suggested change to margin_header.","type":"boolean"},"marginLeftSuggested":{"description":"Indicates if there was a suggested change to margin_left.","type":"boolean"},"marginRightSuggested":{"description":"Indicates if there was a suggested change to margin_right.","type":"boolean"},"marginTopSuggested":{"description":"Indicates if there was a suggested change to margin_top.","type":"boolean"},"pageNumberStartSuggested":{"description":"Indicates if there was a suggested change to page_number_start.","type":"boolean"},"pageSizeSuggestionState":{"$ref":"#/components/schemas/SizeSuggestionState","description":"A mask that indicates which of the fields in size have been changed in this suggestion."},"useCustomHeaderFooterMarginsSuggested":{"description":"Indicates if there was a suggested change to use_custom_header_footer_margins.","type":"boolean"},"useEvenPageHeaderFooterSuggested":{"description":"Indicates if there was a suggested change to use_even_page_header_footer.","type":"boolean"},"useFirstPageHeaderFooterSuggested":{"description":"Indicates if there was a suggested change to use_first_page_header_footer.","type":"boolean"}},"type":"object"},"EmbeddedDrawingProperties":{"description":"The properties of an embedded drawing and used to differentiate the object type. An embedded drawing is one that's created and edited within a document. Note that extensive details are not supported.","properties":{},"type":"object"},"EmbeddedDrawingPropertiesSuggestionState":{"description":"A mask that indicates which of the fields on the base EmbeddedDrawingProperties have been changed in this suggestion. For any field set to true, there's a new suggested value.","properties":{},"type":"object"},"EmbeddedObject":{"description":"An embedded object in the document.","properties":{"description":{"description":"The description of the embedded object. The `title` and `description` are both combined to display alt text.","type":"string"},"embeddedDrawingProperties":{"$ref":"#/components/schemas/EmbeddedDrawingProperties","description":"The properties of an embedded drawing."},"embeddedObjectBorder":{"$ref":"#/components/schemas/EmbeddedObjectBorder","description":"The border of the embedded object."},"imageProperties":{"$ref":"#/components/schemas/ImageProperties","description":"The properties of an image."},"linkedContentReference":{"$ref":"#/components/schemas/LinkedContentReference","description":"A reference to the external linked source content. For example, it contains a reference to the source Google Sheets chart when the embedded object is a linked chart. If unset, then the embedded object is not linked."},"marginBottom":{"$ref":"#/components/schemas/Dimension","description":"The bottom margin of the embedded object."},"marginLeft":{"$ref":"#/components/schemas/Dimension","description":"The left margin of the embedded object."},"marginRight":{"$ref":"#/components/schemas/Dimension","description":"The right margin of the embedded object."},"marginTop":{"$ref":"#/components/schemas/Dimension","description":"The top margin of the embedded object."},"size":{"$ref":"#/components/schemas/Size","description":"The visible size of the image after cropping."},"title":{"description":"The title of the embedded object. The `title` and `description` are both combined to display alt text.","type":"string"}},"type":"object"},"EmbeddedObjectBorder":{"description":"A border around an EmbeddedObject.","properties":{"color":{"$ref":"#/components/schemas/OptionalColor","description":"The color of the border."},"dashStyle":{"description":"The dash style of the border.","enum":["DASH_STYLE_UNSPECIFIED","SOLID","DOT","DASH"],"type":"string"},"propertyState":{"description":"The property state of the border property.","enum":["RENDERED","NOT_RENDERED"],"type":"string"},"width":{"$ref":"#/components/schemas/Dimension","description":"The width of the border."}},"type":"object"},"EmbeddedObjectBorderSuggestionState":{"description":"A mask that indicates which of the fields on the base EmbeddedObjectBorder have been changed in this suggestion. For any field set to true, there's a new suggested value.","properties":{"colorSuggested":{"description":"Indicates if there was a suggested change to color.","type":"boolean"},"dashStyleSuggested":{"description":"Indicates if there was a suggested change to dash_style.","type":"boolean"},"propertyStateSuggested":{"description":"Indicates if there was a suggested change to property_state.","type":"boolean"},"widthSuggested":{"description":"Indicates if there was a suggested change to width.","type":"boolean"}},"type":"object"},"EmbeddedObjectSuggestionState":{"description":"A mask that indicates which of the fields on the base EmbeddedObject have been changed in this suggestion. For any field set to true, there's a new suggested value.","properties":{"descriptionSuggested":{"description":"Indicates if there was a suggested change to description.","type":"boolean"},"embeddedDrawingPropertiesSuggestionState":{"$ref":"#/components/schemas/EmbeddedDrawingPropertiesSuggestionState","description":"A mask that indicates which of the fields in embedded_drawing_properties have been changed in this suggestion."},"embeddedObjectBorderSuggestionState":{"$ref":"#/components/schemas/EmbeddedObjectBorderSuggestionState","description":"A mask that indicates which of the fields in embedded_object_border have been changed in this suggestion."},"imagePropertiesSuggestionState":{"$ref":"#/components/schemas/ImagePropertiesSuggestionState","description":"A mask that indicates which of the fields in image_properties have been changed in this suggestion."},"linkedContentReferenceSuggestionState":{"$ref":"#/components/schemas/LinkedContentReferenceSuggestionState","description":"A mask that indicates which of the fields in linked_content_reference have been changed in this suggestion."},"marginBottomSuggested":{"description":"Indicates if there was a suggested change to margin_bottom.","type":"boolean"},"marginLeftSuggested":{"description":"Indicates if there was a suggested change to margin_left.","type":"boolean"},"marginRightSuggested":{"description":"Indicates if there was a suggested change to margin_right.","type":"boolean"},"marginTopSuggested":{"description":"Indicates if there was a suggested change to margin_top.","type":"boolean"},"sizeSuggestionState":{"$ref":"#/components/schemas/SizeSuggestionState","description":"A mask that indicates which of the fields in size have been changed in this suggestion."},"titleSuggested":{"description":"Indicates if there was a suggested change to title.","type":"boolean"}},"type":"object"},"EndOfSegmentLocation":{"description":"Location at the end of a body, header, footer or footnote. The location is immediately before the last newline in the document segment.","properties":{"segmentId":{"description":"The ID of the header, footer or footnote the location is in. An empty segment ID signifies the document's body.","type":"string"}},"type":"object"},"Equation":{"description":"A ParagraphElement representing an equation.","properties":{"suggestedDeletionIds":{"description":"The suggested deletion IDs. If empty, then there are no suggested deletions of this content.","items":{"type":"string"},"type":"array"},"suggestedInsertionIds":{"description":"The suggested insertion IDs. An Equation may have multiple insertion IDs if it's a nested suggested change. If empty, then this is not a suggested insertion.","items":{"type":"string"},"type":"array"}},"type":"object"},"Footer":{"description":"A document footer.","properties":{"content":{"description":"The contents of the footer. The indexes for a footer's content begin at zero.","items":{"$ref":"#/components/schemas/StructuralElement"},"type":"array"},"footerId":{"description":"The ID of the footer.","type":"string"}},"type":"object"},"Footnote":{"description":"A document footnote.","properties":{"content":{"description":"The contents of the footnote. The indexes for a footnote's content begin at zero.","items":{"$ref":"#/components/schemas/StructuralElement"},"type":"array"},"footnoteId":{"description":"The ID of the footnote.","type":"string"}},"type":"object"},"FootnoteReference":{"description":"A ParagraphElement representing a footnote reference. A footnote reference is the inline content rendered with a number and is used to identify the footnote.","properties":{"footnoteId":{"description":"The ID of the footnote that contains the content of this footnote reference.","type":"string"},"footnoteNumber":{"description":"The rendered number of this footnote.","type":"string"},"suggestedDeletionIds":{"description":"The suggested deletion IDs. If empty, then there are no suggested deletions of this content.","items":{"type":"string"},"type":"array"},"suggestedInsertionIds":{"description":"The suggested insertion IDs. A FootnoteReference may have multiple insertion IDs if it's a nested suggested change. If empty, then this is not a suggested insertion.","items":{"type":"string"},"type":"array"},"suggestedTextStyleChanges":{"additionalProperties":{"$ref":"#/components/schemas/SuggestedTextStyle"},"description":"The suggested text style changes to this FootnoteReference, keyed by suggestion ID.","type":"object"},"textStyle":{"$ref":"#/components/schemas/TextStyle","description":"The text style of this FootnoteReference."}},"type":"object"},"Header":{"description":"A document header.","properties":{"content":{"description":"The contents of the header. The indexes for a header's content begin at zero.","items":{"$ref":"#/components/schemas/StructuralElement"},"type":"array"},"headerId":{"description":"The ID of the header.","type":"string"}},"type":"object"},"HorizontalRule":{"description":"A ParagraphElement representing a horizontal line.","properties":{"suggestedDeletionIds":{"description":"The suggested deletion IDs. If empty, then there are no suggested deletions of this content.","items":{"type":"string"},"type":"array"},"suggestedInsertionIds":{"description":"The suggested insertion IDs. A HorizontalRule may have multiple insertion IDs if it is a nested suggested change. If empty, then this is not a suggested insertion.","items":{"type":"string"},"type":"array"},"suggestedTextStyleChanges":{"additionalProperties":{"$ref":"#/components/schemas/SuggestedTextStyle"},"description":"The suggested text style changes to this HorizontalRule, keyed by suggestion ID.","type":"object"},"textStyle":{"$ref":"#/components/schemas/TextStyle","description":"The text style of this HorizontalRule. Similar to text content, like text runs and footnote references, the text style of a horizontal rule can affect content layout as well as the styling of text inserted next to it."}},"type":"object"},"ImageProperties":{"description":"The properties of an image.","properties":{"angle":{"description":"The clockwise rotation angle of the image, in radians.","format":"float","type":"number"},"brightness":{"description":"The brightness effect of the image. The value should be in the interval [-1.0, 1.0], where 0 means no effect.","format":"float","type":"number"},"contentUri":{"description":"A URI to the image with a default lifetime of 30 minutes. This URI is tagged with the account of the requester. Anyone with the URI effectively accesses the image as the original requester. Access to the image may be lost if the document's sharing settings change.","type":"string"},"contrast":{"description":"The contrast effect of the image. The value should be in the interval [-1.0, 1.0], where 0 means no effect.","format":"float","type":"number"},"cropProperties":{"$ref":"#/components/schemas/CropProperties","description":"The crop properties of the image."},"sourceUri":{"description":"The source URI is the URI used to insert the image. The source URI can be empty.","type":"string"},"transparency":{"description":"The transparency effect of the image. The value should be in the interval [0.0, 1.0], where 0 means no effect and 1 means transparent.","format":"float","type":"number"}},"type":"object"},"ImagePropertiesSuggestionState":{"description":"A mask that indicates which of the fields on the base ImageProperties have been changed in this suggestion. For any field set to true, there's a new suggested value.","properties":{"angleSuggested":{"description":"Indicates if there was a suggested change to angle.","type":"boolean"},"brightnessSuggested":{"description":"Indicates if there was a suggested change to brightness.","type":"boolean"},"contentUriSuggested":{"description":"Indicates if there was a suggested change to content_uri.","type":"boolean"},"contrastSuggested":{"description":"Indicates if there was a suggested change to contrast.","type":"boolean"},"cropPropertiesSuggestionState":{"$ref":"#/components/schemas/CropPropertiesSuggestionState","description":"A mask that indicates which of the fields in crop_properties have been changed in this suggestion."},"sourceUriSuggested":{"description":"Indicates if there was a suggested change to source_uri.","type":"boolean"},"transparencySuggested":{"description":"Indicates if there was a suggested change to transparency.","type":"boolean"}},"type":"object"},"InlineObject":{"description":"An object that appears inline with text. An InlineObject contains an EmbeddedObject such as an image.","properties":{"inlineObjectProperties":{"$ref":"#/components/schemas/InlineObjectProperties","description":"The properties of this inline object."},"objectId":{"description":"The ID of this inline object. Can be used to update an object’s properties.","type":"string"},"suggestedDeletionIds":{"description":"The suggested deletion IDs. If empty, then there are no suggested deletions of this content.","items":{"type":"string"},"type":"array"},"suggestedInlineObjectPropertiesChanges":{"additionalProperties":{"$ref":"#/components/schemas/SuggestedInlineObjectProperties"},"description":"The suggested changes to the inline object properties, keyed by suggestion ID.","type":"object"},"suggestedInsertionId":{"description":"The suggested insertion ID. If empty, then this is not a suggested insertion.","type":"string"}},"type":"object"},"InlineObjectElement":{"description":"A ParagraphElement that contains an InlineObject.","properties":{"inlineObjectId":{"description":"The ID of the InlineObject this element contains.","type":"string"},"suggestedDeletionIds":{"description":"The suggested deletion IDs. If empty, then there are no suggested deletions of this content.","items":{"type":"string"},"type":"array"},"suggestedInsertionIds":{"description":"The suggested insertion IDs. An InlineObjectElement may have multiple insertion IDs if it's a nested suggested change. If empty, then this is not a suggested insertion.","items":{"type":"string"},"type":"array"},"suggestedTextStyleChanges":{"additionalProperties":{"$ref":"#/components/schemas/SuggestedTextStyle"},"description":"The suggested text style changes to this InlineObject, keyed by suggestion ID.","type":"object"},"textStyle":{"$ref":"#/components/schemas/TextStyle","description":"The text style of this InlineObjectElement. Similar to text content, like text runs and footnote references, the text style of an inline object element can affect content layout as well as the styling of text inserted next to it."}},