@zackbart/connecta 0.34.1 → 0.35.0

package/dist/providers/docs/lib/constants.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The Docs API root. Unlike Gmail there is no per-user path segment: the
+ * delegated token's subject decides which documents a request can reach.
+ */
+export declare const DOCS_API_BASE_URL = "https://docs.googleapis.com/v1";
+/**
+ * Exactly the scope this connection requests, and exactly what the Admin
+ * console's domain-wide delegation entry must list for it. `documents` reads
+ * and edits Docs the user can reach; it lists nothing and touches no other
+ * Drive file type.
+ */
+export declare const DOCS_SCOPES: readonly ["https://www.googleapis.com/auth/documents"];
+/**
+ * A document with every tab, as JSON. Styles ride on every text run, so the
+ * JSON is many times the text; this admits documents near Google's own size
+ * limit without letting one exhaust a Worker.
+ */
+export declare const DOCS_MAX_RESPONSE_BYTES: number;

package/dist/providers/docs/lib/constants.js

@@ -0,0 +1,18 @@
+/**
+ * The Docs API root. Unlike Gmail there is no per-user path segment: the
+ * delegated token's subject decides which documents a request can reach.
+ */
+export const DOCS_API_BASE_URL = "https://docs.googleapis.com/v1";
+/**
+ * Exactly the scope this connection requests, and exactly what the Admin
+ * console's domain-wide delegation entry must list for it. `documents` reads
+ * and edits Docs the user can reach; it lists nothing and touches no other
+ * Drive file type.
+ */
+export const DOCS_SCOPES = ["https://www.googleapis.com/auth/documents"];
+/**
+ * A document with every tab, as JSON. Styles ride on every text run, so the
+ * JSON is many times the text; this admits documents near Google's own size
+ * limit without letting one exhaust a Worker.
+ */
+export const DOCS_MAX_RESPONSE_BYTES = 24 * 1024 * 1024;

package/dist/providers/docs/lib/discovery.js

@@ -0,0 +1,26 @@
+import { OperationIndex } from "../../_shared/rest/operation-index.js";
+import { openapi } from "../openapi.generated.js";
+import { googleBatchGuard, googleHatchBinding } from "../../_shared/google/hatch.js";
+import { REQUEST_KINDS } from "./requests.js";
+export const DOCS_INDEX = new OperationIndex(openapi, {
+    vendor: "docs",
+    title: "Google Docs",
+    pathMatching: "uri-template",
+});
+/** Literal execution allowlist. Schema inventory alone never admits an operation. */
+export const DOCS_VERDICTS = {
+    "GET /documents/{documentId}": "read",
+    "POST /documents": "write",
+    "POST /documents/{documentId}:batchUpdate": "destructive",
+};
+export function docsBinding(connection) {
+    return googleHatchBinding(connection, {
+        index: DOCS_INDEX,
+        review: "All three frozen Docs methods; batch writes require a current revision and 1–100 reviewed GA request kinds. Preview comments and suggestions are refused.",
+        refuse: (call) => call.op.path.endsWith(":batchUpdate")
+            ? googleBatchGuard(call.body, { kinds: REQUEST_KINDS, revision: true, max: 100 })
+            : undefined,
+        revisionGuarded: (call) => call.op.path.endsWith(":batchUpdate") &&
+            !googleBatchGuard(call.body, { kinds: REQUEST_KINDS, revision: true, max: 100 }),
+    });
+}

package/dist/providers/docs/lib/requests.js

@@ -0,0 +1,48 @@
+// Reviewed generally available Docs Request kinds; preview comments and suggestions remain refused.
+export const REQUEST_KINDS = [
+    "addDocumentTab",
+    "createDropdownDefinition",
+    "createFooter",
+    "createFootnote",
+    "createHeader",
+    "createNamedRange",
+    "createParagraphBullets",
+    "deleteContentRange",
+    "deleteDropdownDefinition",
+    "deleteFooter",
+    "deleteHeader",
+    "deleteNamedRange",
+    "deleteParagraphBullets",
+    "deletePositionedObject",
+    "deleteTab",
+    "deleteTableColumn",
+    "deleteTableRow",
+    "insertDate",
+    "insertDropdown",
+    "insertInlineImage",
+    "insertPageBreak",
+    "insertPerson",
+    "insertRichLink",
+    "insertSectionBreak",
+    "insertTable",
+    "insertTableColumn",
+    "insertTableRow",
+    "insertText",
+    "mergeTableCells",
+    "pinTableHeaderRows",
+    "replaceAllText",
+    "replaceImage",
+    "replaceNamedRangeContent",
+    "unmergeTableCells",
+    "updateDocumentStyle",
+    "updateDocumentTabProperties",
+    "updateDropdownDefinitionProperties",
+    "updateDropdownProperties",
+    "updateNamedStyle",
+    "updateParagraphStyle",
+    "updateSectionStyle",
+    "updateTableCellStyle",
+    "updateTableColumnProperties",
+    "updateTableRowStyle",
+    "updateTextStyle",
+];

package/dist/providers/docs/lib/schemas.js

@@ -0,0 +1,168 @@
+// Effect declarations are the catalog and runtime decoder for every named Docs tool.
+import { Schema } from "effect";
+import { Integer, isMinChars, isMaxChars } from "../../../http/json-schema.js";
+import { fieldsInput } from "../../../http/fields.js";
+import { REQUEST_KINDS } from "./requests.js";
+const matches = (pattern) => Schema.makeFilter((value) => new RegExp(pattern).test(value), {
+    expected: `a string matching ${pattern}`,
+    toJsonSchema: () => ({ pattern }),
+});
+const Request = Schema.Record(Schema.String, Schema.Record(Schema.String, Schema.Unknown)).check(Schema.makeFilter((value) => Object.keys(value).length === 1 &&
+    REQUEST_KINDS.includes(Object.keys(value)[0]), {
+    expected: "exactly one reviewed Docs request kind",
+    toJsonSchema: () => ({ minProperties: 1, maxProperties: 1, propertyNames: { enum: [...REQUEST_KINDS] } }),
+}));
+export const GET_DOCUMENT_INPUT = Schema.Struct({
+    "documentId": Schema.String.check(isMinChars(1), isMaxChars(256), matches("^[A-Za-z0-9_-]+$")).annotate({
+        description: "Document id: the part after /d/ in its URL, or a Drive file id for a Google Doc.",
+    }),
+    "tabId": Schema.optionalKey(Schema.String.check(isMinChars(1), isMaxChars(128), matches("^[A-Za-z0-9._-]+$")).annotate({
+        description: "Render only this tab (from a previous get_document); omit for every tab.",
+    })),
+    "maxChars": Schema.optionalKey(Integer.check(Schema.isGreaterThanOrEqualTo(0), Schema.isLessThanOrEqualTo(1000000)).annotate({
+        description: "Characters of text kept across all rendered tabs, 0 to 1000000; defaults to 20000. Connecta's cap. Longer text ends with a truncation marker. Above the default, call directly (call_tool, connecta.result to page): execute_code carries at most 256 KiB per result.",
+    })),
+    "withIndexes": Schema.optionalKey(Schema.Boolean.annotate({
+        description: "Add each tab's elements: every paragraph, table, and table of contents with UTF-16 startIndex and endIndex, 64 KiB per page (connecta's cap); page with cursor.",
+    })),
+    "cursor": Schema.optionalKey(Schema.String.check(isMinChars(1)).annotate({
+        description: "Opaque page.nextCursor from the previous indexed read; keep the same arguments and document revision.",
+    })),
+    "suggestions": Schema.optionalKey(Schema.Literals(["inline", "accepted", "rejected"]).annotate({
+        description: "How suggested edits read: inline (editors' default; the indexes edits use), or a preview with all accepted or all rejected (indexes not valid for edits).",
+    })),
+    fields: Schema.optionalKey(fieldsInput("Dot paths to keep in the result. Page and truncation metadata are always returned.")),
+});
+export const GET_DOCUMENT_OUTPUT = Schema.Struct({
+    "documentId": Schema.optionalKey(Schema.String),
+    "title": Schema.optionalKey(Schema.String),
+    "revisionId": Schema.optionalKey(Schema.String),
+    "url": Schema.optionalKey(Schema.String),
+    "tabs": Schema.optionalKey(Schema.Array(Schema.Struct({
+        "tabId": Schema.optionalKey(Schema.String),
+        "title": Schema.optionalKey(Schema.String),
+        "parentTabId": Schema.optionalKey(Schema.String),
+        "nestingLevel": Schema.optionalKey(Integer),
+        "endIndex": Schema.optionalKey(Integer),
+        "text": Schema.optionalKey(Schema.String),
+        "notRendered": Schema.optionalKey(Schema.Array(Schema.Literals(["headers", "footers", "positioned_objects", "suggestion_marks", "unknown_elements"]))),
+        "elements": Schema.optionalKey(Schema.Array(Schema.Struct({
+            "type": Schema.optionalKey(Schema.Literals(["paragraph", "table", "table_of_contents"])),
+            "startIndex": Schema.optionalKey(Integer),
+            "endIndex": Schema.optionalKey(Integer),
+            "style": Schema.optionalKey(Schema.String),
+            "row": Schema.optionalKey(Integer),
+            "column": Schema.optionalKey(Integer),
+            "text": Schema.optionalKey(Schema.String),
+        }))),
+    }))),
+    "page": Schema.optionalKey(Schema.Struct({ "hasMore": Schema.optionalKey(Schema.Boolean), "nextCursor": Schema.optionalKey(Schema.String) })),
+    "dropped": Schema.optionalKey(Schema.Array(Schema.String)),
+    "truncated": Schema.optionalKey(Schema.Array(Schema.String)),
+});
+export const CREATE_DOCUMENT_INPUT = Schema.Struct({
+    "title": Schema.String.check(isMinChars(1), isMaxChars(1000), matches("^[^\\r\\n]*$")).annotate({
+        description: "Document title, one line. Connecta's 1,000-character cap.",
+    }),
+    "text": Schema.optionalKey(Schema.String.check(isMinChars(1), isMaxChars(1000000)).annotate({
+        description: "Optional plain-text body; \\n starts a new paragraph.",
+    })),
+});
+export const CREATE_DOCUMENT_OUTPUT = Schema.Struct({
+    "documentId": Schema.String,
+    "title": Schema.optionalKey(Schema.String),
+    "revisionId": Schema.optionalKey(Schema.String),
+    "url": Schema.String,
+    "dropped": Schema.optionalKey(Schema.Array(Schema.String)),
+    "notice": Schema.optionalKey(Schema.String),
+});
+export const APPEND_TEXT_INPUT = Schema.Struct({
+    "documentId": Schema.String.check(isMinChars(1), isMaxChars(256), matches("^[A-Za-z0-9_-]+$")).annotate({
+        description: "Document id: the part after /d/ in its URL, or a Drive file id for a Google Doc.",
+    }),
+    "text": Schema.String.check(isMinChars(1), isMaxChars(1000000)).annotate({
+        description: "Plain text; \\n starts a new paragraph. Google caps a document near 1.02 million characters.",
+    }),
+    "tabId": Schema.optionalKey(Schema.String.check(isMinChars(1), isMaxChars(128), matches("^[A-Za-z0-9._-]+$")).annotate({
+        description: "Tab to append to; omit for the first tab.",
+    })),
+    "requiredRevisionId": Schema.optionalKey(Schema.String.check(isMinChars(1), isMaxChars(512), matches("^\\S+$")).annotate({
+        description: "revisionId from get_document or a previous edit. If the document has changed since, the edit fails conflict and nothing is applied.",
+    })),
+});
+export const APPEND_TEXT_OUTPUT = Schema.Struct({
+    "documentId": Schema.String,
+    "revisionId": Schema.optionalKey(Schema.String),
+    "dropped": Schema.optionalKey(Schema.Array(Schema.String)),
+    "notice": Schema.optionalKey(Schema.String),
+});
+export const INSERT_TEXT_INPUT = Schema.Struct({
+    "documentId": Schema.String.check(isMinChars(1), isMaxChars(256), matches("^[A-Za-z0-9_-]+$")).annotate({
+        description: "Document id: the part after /d/ in its URL, or a Drive file id for a Google Doc.",
+    }),
+    "index": Integer.check(Schema.isGreaterThanOrEqualTo(1), Schema.isLessThanOrEqualTo(10000000)).annotate({
+        description: "UTF-16 index inside an existing paragraph, from get_document withIndexes; 1 is the body's start. Not a table's start index.",
+    }),
+    "text": Schema.String.check(isMinChars(1), isMaxChars(1000000)).annotate({
+        description: "Plain text; \\n starts a new paragraph. Google caps a document near 1.02 million characters.",
+    }),
+    "tabId": Schema.optionalKey(Schema.String.check(isMinChars(1), isMaxChars(128), matches("^[A-Za-z0-9._-]+$")).annotate({
+        description: "Tab the index belongs to; omit for the first tab.",
+    })),
+    "requiredRevisionId": Schema.optionalKey(Schema.String.check(isMinChars(1), isMaxChars(512), matches("^\\S+$")).annotate({
+        description: "revisionId from get_document or a previous edit. If the document has changed since, the edit fails conflict and nothing is applied.",
+    })),
+});
+export const INSERT_TEXT_OUTPUT = Schema.Struct({
+    "documentId": Schema.String,
+    "revisionId": Schema.optionalKey(Schema.String),
+    "dropped": Schema.optionalKey(Schema.Array(Schema.String)),
+    "notice": Schema.optionalKey(Schema.String),
+});
+export const REPLACE_ALL_TEXT_INPUT = Schema.Struct({
+    "documentId": Schema.String.check(isMinChars(1), isMaxChars(256), matches("^[A-Za-z0-9_-]+$")).annotate({
+        description: "Document id: the part after /d/ in its URL, or a Drive file id for a Google Doc.",
+    }),
+    "find": Schema.String.check(isMinChars(1), isMaxChars(10000)).annotate({
+        description: "Text to find. With regex: true, a regular expression in Google's RE2 syntax.",
+    }),
+    "replaceWith": Schema.String.check(isMaxChars(1000000)).annotate({
+        description: "Replacement text; an empty string deletes every match.",
+    }),
+    "matchCase": Schema.optionalKey(Schema.Boolean.annotate({ description: "Match case exactly. Defaults to false." })),
+    "regex": Schema.optionalKey(Schema.Boolean.annotate({ description: "Treat find as an RE2 regular expression. Defaults to false." })),
+    "tabIds": Schema.optionalKey(Schema.Array(Schema.String.check(isMinChars(1), isMaxChars(128), matches("^[A-Za-z0-9._-]+$")).annotate({
+        description: "Tab id from get_document.",
+    }))
+        .check(Schema.isMinLength(1), Schema.isMaxLength(100))
+        .annotate({ description: "Only these tabs; omit for every tab." })),
+    "requiredRevisionId": Schema.optionalKey(Schema.String.check(isMinChars(1), isMaxChars(512), matches("^\\S+$")).annotate({
+        description: "revisionId from get_document or a previous edit. If the document has changed since, the edit fails conflict and nothing is applied.",
+    })),
+});
+export const REPLACE_ALL_TEXT_OUTPUT = Schema.Struct({
+    "documentId": Schema.String,
+    "occurrencesChanged": Integer,
+    "revisionId": Schema.optionalKey(Schema.String),
+    "dropped": Schema.optionalKey(Schema.Array(Schema.String)),
+    "notice": Schema.optionalKey(Schema.String),
+});
+export const BATCH_UPDATE_DOCUMENT_INPUT = Schema.Struct({
+    "documentId": Schema.String.check(isMinChars(1), isMaxChars(256), matches("^[A-Za-z0-9_-]+$")).annotate({
+        description: "Document id: the part after /d/ in its URL, or a Drive file id for a Google Doc.",
+    }),
+    "requests": Schema.Array(Request).check(Schema.isMinLength(1), Schema.isMaxLength(100)).annotate({
+        description: "Requests in order, 1 to 100 (connecta's cap). Later requests see earlier ones' index shifts.",
+    }),
+    "requiredRevisionId": Schema.String.check(isMinChars(1), isMaxChars(512), matches("^\\S+$")).annotate({
+        description: "revisionId from get_document or a previous edit; required, so raw edits are planned against what was read. If the document has changed, it fails conflict and nothing is applied.",
+    }),
+});
+export const BATCH_UPDATE_DOCUMENT_OUTPUT = Schema.Struct({
+    "documentId": Schema.String,
+    "revisionId": Schema.optionalKey(Schema.String),
+    "replies": Schema.Array(Schema.Record(Schema.String, Schema.Unknown)),
+    "dropped": Schema.optionalKey(Schema.Array(Schema.String)),
+    "notice": Schema.optionalKey(Schema.String),
+    "truncated": Schema.optionalKey(Schema.Array(Schema.String)),
+});

package/dist/providers/docs/openapi.generated.js

@@ -0,0 +1,16 @@
+import { compactOpenApi } from "../_shared/rest/compact-index.js";
+export const openapi = compactOpenApi({
+    source: "https://docs.googleapis.com/$discovery/rest?version=v1",
+    revision: "20261019",
+    digest: "sha256:9f7c1120a3156c723bc1fc0b65332d00a22ae30dc516af131dbbb6b82b42e780",
+    version: "v1",
+    servers: ["https://docs.googleapis.com/v1"],
+    tags: ["documents"],
+    ops: [
+        ["POST", "/documents", "docs.documents.create", "Create add blank document with title", 0],
+        ["GET", "/documents/{documentId}", "docs.documents.get", "Get read document tabs text named ranges styles headers footers and revision", 0],
+        ["POST", "/documents/{documentId}:batchUpdate", "docs.documents.batchUpdate", "Edit document: append paragraph, insert text at index, delete replace text range, format bold style, table, tab, header", 0],
+    ],
+    fields: "{\"p\":[\"body\",\"commentUpdateState\",\"comments\",\"commentsViewMode\",\"comments[].anchorId\",\"comments[].commentId\",\"comments[].headPost\",\"comments[].plainTextQuote\",\"comments[].replies\",\"comments[].status\",\"documentId\",\"documentStyle\",\"footers\",\"footnotes\",\"headers\",\"inlineObjects\",\"lists\",\"namedRanges\",\"namedStyles\",\"positionedObjects\",\"replies\",\"replies[].addCommentReply\",\"replies[].addDocumentTab\",\"replies[].createDropdownDefinition\",\"replies[].createFooter\",\"replies[].createFootnote\",\"replies[].createHeader\",\"replies[].createNamedRange\",\"replies[].insertComment\",\"replies[].insertDropdown\",\"replies[].insertInlineImage\",\"replies[].insertInlineSheetsChart\",\"replies[].replaceAllText\",\"revisionId\",\"suggestedDocumentStyleChanges\",\"suggestedNamedStylesChanges\",\"suggestionResponses\",\"suggestionResponses[].acceptedSuggestionIds\",\"suggestionResponses[].createdSuggestionIds\",\"suggestionResponses[].deletedSuggestionIds\",\"suggestionResponses[].rejectedSuggestionIds\",\"suggestionResponses[].updatedSummarySuggestionIds\",\"suggestions\",\"suggestionsViewMode\",\"suggestions[].headPost\",\"suggestions[].replies\",\"suggestions[].status\",\"suggestions[].suggestionId\",\"suggestions[].summaryHtml\",\"suggestions[].summaryText\",\"tabs\",\"tabs[].childTabs\",\"tabs[].documentTab\",\"tabs[].tabProperties\",\"title\",\"writeControl\"],\"d\":[[0,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,33,34,35,42,43,44,45,46,47,48,49,50,51,52,53,54],[1,10,20,21,22,23,24,25,26,27,28,29,30,31,32,36,37,38,39,40,41,55]],\"o\":[0,0,1]}",
+    requestSchemas: "{\"definitions\":{\"Input_Document\":{\"description\":\"A Google Docs document.\",\"properties\":{\"title\":{\"description\":\"The title of the document.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_BatchUpdateDocumentRequest\":{\"description\":\"Request message for BatchUpdateDocument.\",\"properties\":{\"requests\":{\"description\":\"A list of updates to apply to the document.\",\"items\":{\"$ref\":\"#/$defs/Input_Request\"},\"type\":\"array\"},\"writeControl\":{\"description\":\"Provides control over how write requests are executed.\",\"$ref\":\"#/$defs/Input_WriteControl\"}},\"type\":\"object\"},\"Input_Request\":{\"description\":\"A single update to apply to a document.\",\"properties\":{\"acceptSuggestion\":{\"description\":\"Accepts a suggestion.\",\"$ref\":\"#/$defs/Input_AcceptSuggestionRequest\"},\"addCommentReply\":{\"description\":\"Adds a reply to a CommentThread or SuggestionThread.\",\"$ref\":\"#/$defs/Input_AddCommentReplyRequest\"},\"addDocumentTab\":{\"description\":\"Adds a document tab.\",\"$ref\":\"#/$defs/Input_AddDocumentTabRequest\"},\"createDropdownDefinition\":{\"description\":\"Creates a DropdownDefinition.\",\"$ref\":\"#/$defs/Input_CreateDropdownDefinitionRequest\"},\"createFooter\":{\"description\":\"Creates a footer.\",\"$ref\":\"#/$defs/Input_CreateFooterRequest\"},\"createFootnote\":{\"description\":\"Creates a footnote.\",\"$ref\":\"#/$defs/Input_CreateFootnoteRequest\"},\"createHeader\":{\"description\":\"Creates a header.\",\"$ref\":\"#/$defs/Input_CreateHeaderRequest\"},\"createNamedRange\":{\"description\":\"Creates a named range.\",\"$ref\":\"#/$defs/Input_CreateNamedRangeRequest\"},\"createParagraphBullets\":{\"description\":\"Creates bullets for paragraphs.\",\"$ref\":\"#/$defs/Input_CreateParagraphBulletsRequest\"},\"deleteComment\":{\"description\":\"Deletes a CommentThread.\",\"$ref\":\"#/$defs/Input_DeleteCommentRequest\"},\"deleteCommentReply\":{\"description\":\"Deletes a reply Post from a CommentThread or SuggestionThread.\",\"$ref\":\"#/$defs/Input_DeleteCommentReplyRequest\"},\"deleteContentRange\":{\"description\":\"Deletes content from the document.\",\"$ref\":\"#/$defs/Input_DeleteContentRangeRequest\"},\"deleteDropdownDefinition\":{\"description\":\"Deletes a DropdownDefinition.\",\"$ref\":\"#/$defs/Input_DeleteDropdownDefinitionRequest\"},\"deleteFooter\":{\"description\":\"Deletes a footer from the document.\",\"$ref\":\"#/$defs/Input_DeleteFooterRequest\"},\"deleteHeader\":{\"description\":\"Deletes a header from the document.\",\"$ref\":\"#/$defs/Input_DeleteHeaderRequest\"},\"deleteNamedRange\":{\"description\":\"Deletes a named range.\",\"$ref\":\"#/$defs/Input_DeleteNamedRangeRequest\"},\"deleteParagraphBullets\":{\"description\":\"Deletes bullets from paragraphs.\",\"$ref\":\"#/$defs/Input_DeleteParagraphBulletsRequest\"},\"deletePositionedObject\":{\"description\":\"Deletes a positioned object from the document.\",\"$ref\":\"#/$defs/Input_DeletePositionedObjectRequest\"},\"deleteSuggestion\":{\"description\":\"Deletes a suggestion.\",\"$ref\":\"#/$defs/Input_DeleteSuggestionRequest\"},\"deleteTab\":{\"description\":\"Deletes a document tab.\",\"$ref\":\"#/$defs/Input_DeleteTabRequest\"},\"deleteTableColumn\":{\"description\":\"Deletes a column from a table.\",\"$ref\":\"#/$defs/Input_DeleteTableColumnRequest\"},\"deleteTableRow\":{\"description\":\"Deletes a row from a table.\",\"$ref\":\"#/$defs/Input_DeleteTableRowRequest\"},\"insertComment\":{\"description\":\"Inserts a CommentThread into the document.\",\"$ref\":\"#/$defs/Input_InsertCommentRequest\"},\"insertDate\":{\"description\":\"Inserts a date.\",\"$ref\":\"#/$defs/Input_InsertDateRequest\"},\"insertDropdown\":{\"description\":\"Inserts a Dropdown at the specified location.\",\"$ref\":\"#/$defs/Input_InsertDropdownRequest\"},\"insertInlineImage\":{\"description\":\"Inserts an inline image at the specified location.\",\"$ref\":\"#/$defs/Input_InsertInlineImageRequest\"},\"insertPageBreak\":{\"description\":\"Inserts a page break at the specified location.\",\"$ref\":\"#/$defs/Input_InsertPageBreakRequest\"},\"insertPerson\":{\"description\":\"Inserts a person mention.\",\"$ref\":\"#/$defs/Input_InsertPersonRequest\"},\"insertRichLink\":{\"description\":\"Insert a rich link.\",\"$ref\":\"#/$defs/Input_InsertRichLinkRequest\"},\"insertSectionBreak\":{\"description\":\"Inserts a section break at the specified location.\",\"$ref\":\"#/$defs/Input_InsertSectionBreakRequest\"},\"insertTable\":{\"description\":\"Inserts a table at the specified location.\",\"$ref\":\"#/$defs/Input_InsertTableRequest\"},\"insertTableColumn\":{\"description\":\"Inserts an empty column into a table.\",\"$ref\":\"#/$defs/Input_InsertTableColumnRequest\"},\"insertTableRow\":{\"description\":\"Inserts an empty row into a table.\",\"$ref\":\"#/$defs/Input_InsertTableRowRequest\"},\"insertText\":{\"description\":\"Inserts text at the specified location.\",\"$ref\":\"#/$defs/Input_InsertTextRequest\"},\"mergeTableCells\":{\"description\":\"Merges cells in a table.\",\"$ref\":\"#/$defs/Input_MergeTableCellsRequest\"},\"pinTableHeaderRows\":{\"description\":\"Updates the number of pinned header rows in a table.\",\"$ref\":\"#/$defs/Input_PinTableHeaderRowsRequest\"},\"rejectSuggestion\":{\"description\":\"Rejects a suggestion.\",\"$ref\":\"#/$defs/Input_RejectSuggestionRequest\"},\"replaceAllText\":{\"description\":\"Replaces all instances of the specified text.\",\"$ref\":\"#/$defs/Input_ReplaceAllTextRequest\"},\"replaceImage\":{\"description\":\"Replaces an image in the document.\",\"$ref\":\"#/$defs/Input_ReplaceImageRequest\"},\"replaceNamedRangeContent\":{\"description\":\"Replaces the content in a named range.\",\"$ref\":\"#/$defs/Input_ReplaceNamedRangeContentRequest\"},\"unmergeTableCells\":{\"description\":\"Unmerges cells in a table.\",\"$ref\":\"#/$defs/Input_UnmergeTableCellsRequest\"},\"updateCommentPost\":{\"description\":\"Updates an existing post (head post or reply) of a CommentThread or SuggestionThread.\",\"$ref\":\"#/$defs/Input_UpdateCommentPostRequest\"},\"updateDocumentStyle\":{\"description\":\"Updates the style of the document.\",\"$ref\":\"#/$defs/Input_UpdateDocumentStyleRequest\"},\"updateDocumentTabProperties\":{\"description\":\"Updates the properties of a document tab.\",\"$ref\":\"#/$defs/Input_UpdateDocumentTabPropertiesRequest\"},\"updateDropdownDefinitionProperties\":{\"description\":\"Updates the properties of a DropdownDefinition.\",\"$ref\":\"#/$defs/Input_UpdateDropdownDefinitionPropertiesRequest\"},\"updateDropdownProperties\":{\"description\":\"Updates the properties of a Dropdown.\",\"$ref\":\"#/$defs/Input_UpdateDropdownPropertiesRequest\"},\"updateNamedStyle\":{\"description\":\"Updates a named style.\",\"$ref\":\"#/$defs/Input_UpdateNamedStyleRequest\"},\"updateParagraphStyle\":{\"description\":\"Updates the paragraph style at the specified range.\",\"$ref\":\"#/$defs/Input_UpdateParagraphStyleRequest\"},\"updateSectionStyle\":{\"description\":\"Updates the section style of the specified range.\",\"$ref\":\"#/$defs/Input_UpdateSectionStyleRequest\"},\"updateTableCellStyle\":{\"description\":\"Updates the style of table cells.\",\"$ref\":\"#/$defs/Input_UpdateTableCellStyleRequest\"},\"updateTableColumnProperties\":{\"description\":\"Updates the properties of columns in a table.\",\"$ref\":\"#/$defs/Input_UpdateTableColumnPropertiesRequest\"},\"updateTableRowStyle\":{\"description\":\"Updates the row style in a table.\",\"$ref\":\"#/$defs/Input_UpdateTableRowStyleRequest\"},\"updateTextStyle\":{\"description\":\"Updates the text style at the specified range.\",\"$ref\":\"#/$defs/Input_UpdateTextStyleRequest\"}},\"type\":\"object\"},\"Input_AcceptSuggestionRequest\":{\"description\":\"Accepts a suggestion.\",\"properties\":{\"suggestionId\":{\"description\":\"The ID of the suggestion.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_AddCommentReplyRequest\":{\"description\":\"Inserts a reply Post into a CommentThread or SuggestionThread.\",\"properties\":{\"commentId\":{\"description\":\"The ID of the CommentThread to add the reply to.\",\"type\":\"string\"},\"post\":{\"description\":\"The Post representing the reply.\",\"$ref\":\"#/$defs/Input_Post\"},\"suggestionId\":{\"description\":\"The ID of the SuggestionThread to add the reply to.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_Post\":{\"description\":\"Represents a single post in a comment or suggestion thread.\",\"properties\":{\"assigneeEmail\":{\"description\":\"Optional.\",\"type\":\"string\"},\"commentAction\":{\"description\":\"Optional.\",\"enum\":[\"COMMENT_ACTION_TYPE_UNSPECIFIED\",\"NO_COMMENT_ACTION_CHANGE\",\"RESOLVE\",\"REOPEN\"],\"type\":\"string\"},\"content\":{\"description\":\"The content of the post.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_AddDocumentTabRequest\":{\"description\":\"Adds a document tab.\",\"properties\":{\"tabProperties\":{\"description\":\"The properties of the tab to add.\",\"$ref\":\"#/$defs/Input_TabProperties\"}},\"type\":\"object\"},\"Input_TabProperties\":{\"description\":\"Properties of a tab.\",\"properties\":{\"iconEmoji\":{\"description\":\"Optional.\",\"type\":\"string\"},\"index\":{\"description\":\"The zero-based index of the tab within the parent.\",\"format\":\"int32\",\"type\":\"integer\"},\"parentTabId\":{\"description\":\"Optional.\",\"type\":\"string\"},\"tabId\":{\"description\":\"The immutable ID of the tab.\",\"type\":\"string\"},\"title\":{\"description\":\"The user-visible name of the tab.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_CreateDropdownDefinitionRequest\":{\"description\":\"Creates a new DropdownDefinition in the document.\",\"properties\":{\"dropdownDefinition\":{\"description\":\"Required.\",\"$ref\":\"#/$defs/Input_DropdownDefinition\"},\"tabId\":{\"description\":\"The ID of the tab to create the dropdown definition in.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_DropdownDefinition\":{\"description\":\"A dropdown definition in the document.\",\"properties\":{\"dropdownDefinitionId\":{\"description\":\"The ID of this dropdown definition.\",\"type\":\"string\"},\"dropdownDefinitionProperties\":{\"description\":\"The properties of this dropdown definition.\",\"$ref\":\"#/$defs/Input_DropdownDefinitionProperties\"},\"suggestedDeletionId\":{\"description\":\"ID for suggestion that deletes this dropdown definition.\",\"type\":\"string\"},\"suggestedDropdownDefinitionPropertiesChanges\":{\"additionalProperties\":{\"$ref\":\"#/$defs/Input_SuggestedDropdownDefinitionProperties\"},\"description\":\"Suggested property changes to this definition, keyed by suggestion ID.\",\"type\":\"object\"},\"suggestedInsertionId\":{\"description\":\"ID for suggestion that inserts this dropdown definition.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_DropdownDefinitionProperties\":{\"description\":\"Properties of a dropdown definition.\",\"properties\":{\"options\":{\"description\":\"The list of options defined by this dropdown definition.\",\"items\":{\"$ref\":\"#/$defs/Input_DropdownOption\"},\"type\":\"array\"},\"title\":{\"description\":\"The title of the dropdown definition.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_DropdownOption\":{\"description\":\"An option in a Dropdown.\",\"properties\":{\"displayValue\":{\"description\":\"The display value of this dropdown option.\",\"type\":\"string\"},\"optionId\":{\"description\":\"The ID of this dropdown option.\",\"type\":\"string\"},\"textStyle\":{\"description\":\"The text style of this dropdown option.\",\"$ref\":\"#/$defs/Input_TextStyle\"}},\"type\":\"object\"},\"Input_TextStyle\":{\"description\":\"Represents the styling that can be applied to text.\",\"properties\":{\"backgroundColor\":{\"description\":\"The background color of the text.\",\"$ref\":\"#/$defs/Input_OptionalColor\"},\"baselineOffset\":{\"description\":\"The text's vertical offset from its normal position.\",\"enum\":[\"BASELINE_OFFSET_UNSPECIFIED\",\"NONE\",\"SUPERSCRIPT\",\"SUBSCRIPT\"],\"type\":\"string\"},\"bold\":{\"description\":\"Whether or not the text is rendered as bold.\",\"type\":\"boolean\"},\"fontSize\":{\"description\":\"The size of the text's font.\",\"$ref\":\"#/$defs/Input_Dimension\"},\"foregroundColor\":{\"description\":\"The foreground color of the text.\",\"$ref\":\"#/$defs/Input_OptionalColor\"},\"italic\":{\"description\":\"Whether or not the text is italicized.\",\"type\":\"boolean\"},\"link\":{\"description\":\"The hyperlink destination of the text.\",\"$ref\":\"#/$defs/Input_Link\"},\"smallCaps\":{\"description\":\"Whether or not the text is in small capital letters.\",\"type\":\"boolean\"},\"strikethrough\":{\"description\":\"Whether or not the text is struck through.\",\"type\":\"boolean\"},\"underline\":{\"description\":\"Whether or not the text is underlined.\",\"type\":\"boolean\"},\"weightedFontFamily\":{\"description\":\"The font family and rendered weight of the text.\",\"$ref\":\"#/$defs/Input_WeightedFontFamily\"}},\"type\":\"object\"},\"Input_OptionalColor\":{\"description\":\"A color that can either be fully opaque or fully transparent.\",\"properties\":{\"color\":{\"description\":\"If set, this will be used as an opaque color.\",\"$ref\":\"#/$defs/Input_Color\"}},\"type\":\"object\"},\"Input_Color\":{\"description\":\"A solid color.\",\"properties\":{\"rgbColor\":{\"description\":\"The RGB color value.\",\"$ref\":\"#/$defs/Input_RgbColor\"}},\"type\":\"object\"},\"Input_RgbColor\":{\"description\":\"An RGB color.\",\"properties\":{\"blue\":{\"description\":\"The blue component of the color, from 0.0 to 1.0.\",\"format\":\"float\",\"type\":\"number\"},\"green\":{\"description\":\"The green component of the color, from 0.0 to 1.0.\",\"format\":\"float\",\"type\":\"number\"},\"red\":{\"description\":\"The red component of the color, from 0.0 to 1.0.\",\"format\":\"float\",\"type\":\"number\"}},\"type\":\"object\"},\"Input_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\"},\"Input_Link\":{\"description\":\"A reference to another portion of a document or an external URL resource.\",\"properties\":{\"bookmark\":{\"description\":\"A bookmark in this document.\",\"$ref\":\"#/$defs/Input_BookmarkLink\"},\"bookmarkId\":{\"description\":\"The ID of a bookmark in this document.\",\"type\":\"string\"},\"heading\":{\"description\":\"A heading in this document.\",\"$ref\":\"#/$defs/Input_HeadingLink\"},\"headingId\":{\"description\":\"The ID of a heading in this document.\",\"type\":\"string\"},\"tabId\":{\"description\":\"The ID of a tab in this document.\",\"type\":\"string\"},\"url\":{\"description\":\"An external URL.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_BookmarkLink\":{\"description\":\"A reference to a bookmark in this document.\",\"properties\":{\"id\":{\"description\":\"The ID of a bookmark in this document.\",\"type\":\"string\"},\"tabId\":{\"description\":\"The ID of the tab containing this bookmark.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_HeadingLink\":{\"description\":\"A reference to a heading in this document.\",\"properties\":{\"id\":{\"description\":\"The ID of a heading in this document.\",\"type\":\"string\"},\"tabId\":{\"description\":\"The ID of the tab containing this heading.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_WeightedFontFamily\":{\"description\":\"Represents a font family and weight of text.\",\"properties\":{\"fontFamily\":{\"description\":\"The font family of the text.\",\"type\":\"string\"},\"weight\":{\"description\":\"The weight of the font.\",\"format\":\"int32\",\"type\":\"integer\"}},\"type\":\"object\"},\"Input_SuggestedDropdownDefinitionProperties\":{\"description\":\"A suggested change to dropdown definition properties.\",\"properties\":{\"dropdownDefinitionProperties\":{\"description\":\"A DropdownDefinitionProperties that only includes the changes made in this suggestion.\",\"$ref\":\"#/$defs/Input_DropdownDefinitionProperties\"},\"dropdownDefinitionPropertiesSuggestionState\":{\"description\":\"A mask that indicates which of the fields on the base DropdownDefinitionProperties have been changed in this suggestion.\",\"$ref\":\"#/$defs/Input_DropdownDefinitionPropertiesSuggestionState\"}},\"type\":\"object\"},\"Input_DropdownDefinitionPropertiesSuggestionState\":{\"description\":\"A mask that indicates which of the fields on the base DropdownDefinitionProperties have been changed in this suggestion.\",\"properties\":{\"optionsSuggested\":{\"description\":\"Indicates if there was a suggested change to options.\",\"type\":\"boolean\"},\"titleSuggested\":{\"description\":\"Indicates if there was a suggested change to title.\",\"type\":\"boolean\"}},\"type\":\"object\"},\"Input_CreateFooterRequest\":{\"description\":\"Creates a Footer.\",\"properties\":{\"sectionBreakLocation\":{\"description\":\"The location of the SectionBreak immediately preceding the section whose SectionStyle this footer should belong to.\",\"$ref\":\"#/$defs/Input_Location\"},\"type\":{\"description\":\"The type of footer to create.\",\"enum\":[\"HEADER_FOOTER_TYPE_UNSPECIFIED\",\"DEFAULT\"],\"type\":\"string\"}},\"type\":\"object\"},\"Input_Location\":{\"description\":\"A particular location in the document.\",\"properties\":{\"index\":{\"description\":\"The zero-based index, in UTF-16 code units.\",\"format\":\"int32\",\"type\":\"integer\"},\"segmentId\":{\"description\":\"The ID of the header, footer or footnote the location is in.\",\"type\":\"string\"},\"tabId\":{\"description\":\"The tab that the location is in.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_CreateFootnoteRequest\":{\"description\":\"Creates a Footnote segment and inserts a new FootnoteReference to it at the given location.\",\"properties\":{\"endOfSegmentLocation\":{\"description\":\"Inserts the footnote reference at the end of the document body.\",\"$ref\":\"#/$defs/Input_EndOfSegmentLocation\"},\"location\":{\"description\":\"Inserts the footnote reference at a specific index in the document.\",\"$ref\":\"#/$defs/Input_Location\"}},\"type\":\"object\"},\"Input_EndOfSegmentLocation\":{\"description\":\"Location at the end of a body, header, footer or footnote.\",\"properties\":{\"segmentId\":{\"description\":\"The ID of the header, footer or footnote the location is in.\",\"type\":\"string\"},\"tabId\":{\"description\":\"The tab that the location is in.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_CreateHeaderRequest\":{\"description\":\"Creates a Header.\",\"properties\":{\"sectionBreakLocation\":{\"description\":\"The location of the SectionBreak which begins the section this header should belong to.\",\"$ref\":\"#/$defs/Input_Location\"},\"type\":{\"description\":\"The type of header to create.\",\"enum\":[\"HEADER_FOOTER_TYPE_UNSPECIFIED\",\"DEFAULT\"],\"type\":\"string\"}},\"type\":\"object\"},\"Input_CreateNamedRangeRequest\":{\"description\":\"Creates a NamedRange referencing the given range.\",\"properties\":{\"name\":{\"description\":\"The name of the NamedRange.\",\"type\":\"string\"},\"range\":{\"description\":\"The range to apply the name to.\",\"$ref\":\"#/$defs/Input_Range\"}},\"type\":\"object\"},\"Input_Range\":{\"description\":\"Specifies a contiguous range of text.\",\"properties\":{\"endIndex\":{\"description\":\"The zero-based end index of this range, exclusive, in UTF-16 code units.\",\"format\":\"int32\",\"type\":\"integer\"},\"segmentId\":{\"description\":\"The ID of the header, footer, or footnote that this range is contained in.\",\"type\":\"string\"},\"startIndex\":{\"description\":\"The zero-based start index of this range, in UTF-16 code units.\",\"format\":\"int32\",\"type\":\"integer\"},\"tabId\":{\"description\":\"The tab that contains this range.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_CreateParagraphBulletsRequest\":{\"description\":\"Creates bullets for all of the paragraphs that overlap with the given range.\",\"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\":{\"description\":\"The range to apply the bullet preset to.\",\"$ref\":\"#/$defs/Input_Range\"}},\"type\":\"object\"},\"Input_DeleteCommentRequest\":{\"description\":\"Deletes a CommentThread.\",\"properties\":{\"commentId\":{\"description\":\"The ID of the CommentThread that is being deleted.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_DeleteCommentReplyRequest\":{\"description\":\"Deletes a reply Post from a CommentThread or SuggestionThread.\",\"properties\":{\"commentId\":{\"description\":\"The ID of the CommentThread which the post belongs to.\",\"type\":\"string\"},\"postId\":{\"description\":\"The ID of the reply Post being deleted.\",\"type\":\"string\"},\"suggestionId\":{\"description\":\"The ID of the SuggestionThread which the post belongs to.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_DeleteContentRangeRequest\":{\"description\":\"Deletes content from the document.\",\"properties\":{\"range\":{\"description\":\"The range of content to delete.\",\"$ref\":\"#/$defs/Input_Range\"}},\"type\":\"object\"},\"Input_DeleteDropdownDefinitionRequest\":{\"description\":\"Deletes a DropdownDefinition.\",\"properties\":{\"dropdownDefinitionId\":{\"description\":\"The ID of the DropdownDefinition to delete.\",\"type\":\"string\"},\"tabId\":{\"description\":\"The ID of the tab that contains the dropdown definition to delete.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_DeleteFooterRequest\":{\"description\":\"Deletes a Footer from the document.\",\"properties\":{\"footerId\":{\"description\":\"The id of the footer to delete.\",\"type\":\"string\"},\"tabId\":{\"description\":\"The tab that contains the footer to delete.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_DeleteHeaderRequest\":{\"description\":\"Deletes a Header from the document.\",\"properties\":{\"headerId\":{\"description\":\"The id of the header to delete.\",\"type\":\"string\"},\"tabId\":{\"description\":\"The tab containing the header to delete.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_DeleteNamedRangeRequest\":{\"description\":\"Deletes a NamedRange.\",\"properties\":{\"name\":{\"description\":\"The name of the range(s) to delete.\",\"type\":\"string\"},\"namedRangeId\":{\"description\":\"The ID of the named range to delete.\",\"type\":\"string\"},\"tabsCriteria\":{\"description\":\"Optional.\",\"$ref\":\"#/$defs/Input_TabsCriteria\"}},\"type\":\"object\"},\"Input_TabsCriteria\":{\"description\":\"A criteria that specifies in which tabs a request executes.\",\"properties\":{\"tabIds\":{\"description\":\"The list of tab IDs in which the request executes.\",\"items\":{\"type\":\"string\"},\"type\":\"array\"}},\"type\":\"object\"},\"Input_DeleteParagraphBulletsRequest\":{\"description\":\"Deletes bullets from all of the paragraphs that overlap with the given range.\",\"properties\":{\"range\":{\"description\":\"The range to delete bullets from.\",\"$ref\":\"#/$defs/Input_Range\"}},\"type\":\"object\"},\"Input_DeletePositionedObjectRequest\":{\"description\":\"Deletes a PositionedObject from the document.\",\"properties\":{\"objectId\":{\"description\":\"The ID of the positioned object to delete.\",\"type\":\"string\"},\"tabId\":{\"description\":\"The tab that the positioned object to delete is in.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_DeleteSuggestionRequest\":{\"description\":\"Deletes a suggestion.\",\"properties\":{\"suggestionId\":{\"description\":\"The ID of the suggestion.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_DeleteTabRequest\":{\"description\":\"Deletes a tab.\",\"properties\":{\"tabId\":{\"description\":\"The ID of the tab to delete.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_DeleteTableColumnRequest\":{\"description\":\"Deletes a column from a table.\",\"properties\":{\"tableCellLocation\":{\"description\":\"The reference table cell location from which the column will be deleted.\",\"$ref\":\"#/$defs/Input_TableCellLocation\"}},\"type\":\"object\"},\"Input_TableCellLocation\":{\"description\":\"Location of a single cell within a table.\",\"properties\":{\"columnIndex\":{\"description\":\"The zero-based column index.\",\"format\":\"int32\",\"type\":\"integer\"},\"rowIndex\":{\"description\":\"The zero-based row index.\",\"format\":\"int32\",\"type\":\"integer\"},\"tableStartLocation\":{\"description\":\"The location where the table starts in the document.\",\"$ref\":\"#/$defs/Input_Location\"}},\"type\":\"object\"},\"Input_DeleteTableRowRequest\":{\"description\":\"Deletes a row from a table.\",\"properties\":{\"tableCellLocation\":{\"description\":\"The reference table cell location from which the row will be deleted.\",\"$ref\":\"#/$defs/Input_TableCellLocation\"}},\"type\":\"object\"},\"Input_InsertCommentRequest\":{\"description\":\"Inserts a CommentThread into the document.\",\"properties\":{\"assigneeEmailAddress\":{\"description\":\"Optional.\",\"type\":\"string\"},\"content\":{\"description\":\"The text of the comment, as plain text.\",\"type\":\"string\"},\"range\":{\"description\":\"The Range in the document that is tied to this comment.\",\"$ref\":\"#/$defs/Input_Range\"}},\"type\":\"object\"},\"Input_InsertDateRequest\":{\"description\":\"Inserts a date at the specified location.\",\"properties\":{\"dateElementProperties\":{\"description\":\"The properties of the date to insert.\",\"$ref\":\"#/$defs/Input_DateElementProperties\"},\"endOfSegmentLocation\":{\"description\":\"Inserts the date at the end of the given header, footer or document body.\",\"$ref\":\"#/$defs/Input_EndOfSegmentLocation\"},\"location\":{\"description\":\"Inserts the date at a specific index in the document.\",\"$ref\":\"#/$defs/Input_Location\"}},\"type\":\"object\"},\"Input_DateElementProperties\":{\"description\":\"Properties of a DateElement.\",\"properties\":{\"dateFormat\":{\"description\":\"Determines how the date part of the DateElement will be displayed in the document.\",\"enum\":[\"DATE_FORMAT_UNSPECIFIED\",\"DATE_FORMAT_CUSTOM\",\"DATE_FORMAT_MONTH_DAY_ABBREVIATED\",\"DATE_FORMAT_MONTH_DAY_FULL\",\"DATE_FORMAT_MONTH_DAY_YEAR_ABBREVIATED\",\"DATE_FORMAT_ISO8601\"],\"type\":\"string\"},\"locale\":{\"description\":\"The language code of the DateElement.\",\"type\":\"string\"},\"timeFormat\":{\"description\":\"Determines how the time part of the DateElement will be displayed in the document.\",\"enum\":[\"TIME_FORMAT_UNSPECIFIED\",\"TIME_FORMAT_DISABLED\",\"TIME_FORMAT_HOUR_MINUTE\",\"TIME_FORMAT_HOUR_MINUTE_TIMEZONE\"],\"type\":\"string\"},\"timeZoneId\":{\"description\":\"The time zone of the DateElement, as defined by the Unicode Common Locale Data Repository (CLDR) project.\",\"type\":\"string\"},\"timestamp\":{\"description\":\"The point in time to represent, in seconds and nanoseconds since Unix epoch: January 1, 1970 at midnight UTC.\",\"format\":\"google-datetime\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_InsertDropdownRequest\":{\"description\":\"Inserts a Dropdown at the specified location.\",\"properties\":{\"dropdownDefinitionId\":{\"description\":\"Required.\",\"type\":\"string\"},\"endOfSegmentLocation\":{\"description\":\"The EndOfSegmentLocation in the document to insert the dropdown at.\",\"$ref\":\"#/$defs/Input_EndOfSegmentLocation\"},\"location\":{\"description\":\"The Location in the document to insert the dropdown at.\",\"$ref\":\"#/$defs/Input_Location\"},\"selectedOptionId\":{\"description\":\"Optional initial value for the dropdown.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_InsertInlineImageRequest\":{\"description\":\"Inserts an InlineObject containing an image at the given location.\",\"properties\":{\"endOfSegmentLocation\":{\"description\":\"Inserts the text at the end of a header, footer or the document body.\",\"$ref\":\"#/$defs/Input_EndOfSegmentLocation\"},\"location\":{\"description\":\"Inserts the image at a specific index in the document.\",\"$ref\":\"#/$defs/Input_Location\"},\"objectSize\":{\"description\":\"The size that the image should appear as in the document.\",\"$ref\":\"#/$defs/Input_Size\"},\"uri\":{\"description\":\"The image URI.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_Size\":{\"description\":\"A width and height.\",\"properties\":{\"height\":{\"description\":\"The height of the object.\",\"$ref\":\"#/$defs/Input_Dimension\"},\"width\":{\"description\":\"The width of the object.\",\"$ref\":\"#/$defs/Input_Dimension\"}},\"type\":\"object\"},\"Input_InsertPageBreakRequest\":{\"description\":\"Inserts a page break followed by a newline at the specified location.\",\"properties\":{\"endOfSegmentLocation\":{\"description\":\"Inserts the page break at the end of the document body.\",\"$ref\":\"#/$defs/Input_EndOfSegmentLocation\"},\"location\":{\"description\":\"Inserts the page break at a specific index in the document.\",\"$ref\":\"#/$defs/Input_Location\"}},\"type\":\"object\"},\"Input_InsertPersonRequest\":{\"description\":\"Inserts a person mention.\",\"properties\":{\"endOfSegmentLocation\":{\"description\":\"Inserts the person mention at the end of a header, footer, footnote or the document body.\",\"$ref\":\"#/$defs/Input_EndOfSegmentLocation\"},\"location\":{\"description\":\"Inserts the person mention at a specific index in the document.\",\"$ref\":\"#/$defs/Input_Location\"},\"personProperties\":{\"description\":\"The properties of the person mention to insert.\",\"$ref\":\"#/$defs/Input_PersonProperties\"}},\"type\":\"object\"},\"Input_PersonProperties\":{\"description\":\"Properties specific to a linked Person.\",\"properties\":{\"email\":{\"description\":\"The email address linked to this Person.\",\"type\":\"string\"},\"name\":{\"description\":\"The name of the person if it's displayed in the link text instead of the person's email address.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_InsertRichLinkRequest\":{\"description\":\"Inserts a RichLink at the specified location.\",\"properties\":{\"endOfSegmentLocation\":{\"description\":\"Inserts the rich link at the end of a header, footer, footnote or the document body.\",\"$ref\":\"#/$defs/Input_EndOfSegmentLocation\"},\"location\":{\"description\":\"Inserts the rich link at a specific index in the document.\",\"$ref\":\"#/$defs/Input_Location\"},\"richLinkProperties\":{\"description\":\"The properties of the rich link to insert.\",\"$ref\":\"#/$defs/Input_RichLinkProperties\"}},\"type\":\"object\"},\"Input_RichLinkProperties\":{\"description\":\"Properties specific to a RichLink.\",\"properties\":{\"mimeType\":{\"description\":\"The MIME type of the RichLink, if there's one (for example, when it's a file in Drive).\",\"type\":\"string\"},\"title\":{\"description\":\"The title of the RichLink as displayed in the link.\",\"type\":\"string\"},\"uri\":{\"description\":\"The URI to the RichLink.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_InsertSectionBreakRequest\":{\"description\":\"Inserts a section break at the given location.\",\"properties\":{\"endOfSegmentLocation\":{\"description\":\"Inserts a newline and a section break at the end of the document body.\",\"$ref\":\"#/$defs/Input_EndOfSegmentLocation\"},\"location\":{\"description\":\"Inserts a newline and a section break at a specific index in the document.\",\"$ref\":\"#/$defs/Input_Location\"},\"sectionType\":{\"description\":\"The type of section to insert.\",\"enum\":[\"SECTION_TYPE_UNSPECIFIED\",\"CONTINUOUS\",\"NEXT_PAGE\"],\"type\":\"string\"}},\"type\":\"object\"},\"Input_InsertTableRequest\":{\"description\":\"Inserts a table at the specified location.\",\"properties\":{\"columns\":{\"description\":\"The number of columns in the table.\",\"format\":\"int32\",\"type\":\"integer\"},\"endOfSegmentLocation\":{\"description\":\"Inserts the table at the end of the given header, footer or document body.\",\"$ref\":\"#/$defs/Input_EndOfSegmentLocation\"},\"location\":{\"description\":\"Inserts the table at a specific model index.\",\"$ref\":\"#/$defs/Input_Location\"},\"rows\":{\"description\":\"The number of rows in the table.\",\"format\":\"int32\",\"type\":\"integer\"}},\"type\":\"object\"},\"Input_InsertTableColumnRequest\":{\"description\":\"Inserts an empty column into a table.\",\"properties\":{\"insertRight\":{\"description\":\"Whether to insert new column to the right of the reference cell location.\",\"type\":\"boolean\"},\"tableCellLocation\":{\"description\":\"The reference table cell location from which columns will be inserted.\",\"$ref\":\"#/$defs/Input_TableCellLocation\"}},\"type\":\"object\"},\"Input_InsertTableRowRequest\":{\"description\":\"Inserts an empty row into a table.\",\"properties\":{\"insertBelow\":{\"description\":\"Whether to insert new row below the reference cell location.\",\"type\":\"boolean\"},\"tableCellLocation\":{\"description\":\"The reference table cell location from which rows will be inserted.\",\"$ref\":\"#/$defs/Input_TableCellLocation\"}},\"type\":\"object\"},\"Input_InsertTextRequest\":{\"description\":\"Inserts text at the specified location.\",\"properties\":{\"endOfSegmentLocation\":{\"description\":\"Inserts the text at the end of a header, footer, footnote or the document body.\",\"$ref\":\"#/$defs/Input_EndOfSegmentLocation\"},\"location\":{\"description\":\"Inserts the text at a specific index in the document.\",\"$ref\":\"#/$defs/Input_Location\"},\"text\":{\"description\":\"The text to be inserted.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_MergeTableCellsRequest\":{\"description\":\"Merges cells in a Table.\",\"properties\":{\"tableRange\":{\"description\":\"The table range specifying which cells of the table to merge.\",\"$ref\":\"#/$defs/Input_TableRange\"}},\"type\":\"object\"},\"Input_TableRange\":{\"description\":\"A table range represents a reference to a subset of a table.\",\"properties\":{\"columnSpan\":{\"description\":\"The column span of the table range.\",\"format\":\"int32\",\"type\":\"integer\"},\"rowSpan\":{\"description\":\"The row span of the table range.\",\"format\":\"int32\",\"type\":\"integer\"},\"tableCellLocation\":{\"description\":\"The cell location where the table range starts.\",\"$ref\":\"#/$defs/Input_TableCellLocation\"}},\"type\":\"object\"},\"Input_PinTableHeaderRowsRequest\":{\"description\":\"Updates the number of pinned table header rows in a table.\",\"properties\":{\"pinnedHeaderRowsCount\":{\"description\":\"The number of table rows to pin, where 0 implies that all rows are unpinned.\",\"format\":\"int32\",\"type\":\"integer\"},\"tableStartLocation\":{\"description\":\"The location where the table starts in the document.\",\"$ref\":\"#/$defs/Input_Location\"}},\"type\":\"object\"},\"Input_RejectSuggestionRequest\":{\"description\":\"Rejects a suggestion.\",\"properties\":{\"suggestionId\":{\"description\":\"The ID of the suggestion.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_ReplaceAllTextRequest\":{\"description\":\"Replaces all instances of text matching a criteria with replace text.\",\"properties\":{\"containsText\":{\"description\":\"Finds text in the document matching this substring.\",\"$ref\":\"#/$defs/Input_SubstringMatchCriteria\"},\"replaceText\":{\"description\":\"The text that will replace the matched text.\",\"type\":\"string\"},\"tabsCriteria\":{\"description\":\"Optional.\",\"$ref\":\"#/$defs/Input_TabsCriteria\"}},\"type\":\"object\"},\"Input_SubstringMatchCriteria\":{\"description\":\"A criteria that matches a specific string of text in the document.\",\"properties\":{\"matchCase\":{\"description\":\"Indicates whether the search should respect case: - `True`: the search is case sensitive.\",\"type\":\"boolean\"},\"searchByRegex\":{\"description\":\"Optional.\",\"type\":\"boolean\"},\"text\":{\"description\":\"The text to search for in the document.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_ReplaceImageRequest\":{\"description\":\"Replaces an existing image with a new image.\",\"properties\":{\"imageObjectId\":{\"description\":\"The ID of the existing image that will be replaced.\",\"type\":\"string\"},\"imageReplaceMethod\":{\"description\":\"The replacement method.\",\"enum\":[\"IMAGE_REPLACE_METHOD_UNSPECIFIED\",\"CENTER_CROP\"],\"type\":\"string\"},\"tabId\":{\"description\":\"The tab that the image to be replaced is in.\",\"type\":\"string\"},\"uri\":{\"description\":\"The URI of the new image.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_ReplaceNamedRangeContentRequest\":{\"description\":\"Replaces the contents of the specified NamedRange or NamedRanges with the given replacement content.\",\"properties\":{\"namedRangeId\":{\"description\":\"The ID of the named range whose content will be replaced.\",\"type\":\"string\"},\"namedRangeName\":{\"description\":\"The name of the NamedRanges whose content will be replaced.\",\"type\":\"string\"},\"tabsCriteria\":{\"description\":\"Optional.\",\"$ref\":\"#/$defs/Input_TabsCriteria\"},\"text\":{\"description\":\"Replaces the content of the specified named range(s) with the given text.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_UnmergeTableCellsRequest\":{\"description\":\"Unmerges cells in a Table.\",\"properties\":{\"tableRange\":{\"description\":\"The table range specifying which cells of the table to unmerge.\",\"$ref\":\"#/$defs/Input_TableRange\"}},\"type\":\"object\"},\"Input_UpdateCommentPostRequest\":{\"description\":\"Updates a Post in a CommentThread or SuggestionThread.\",\"properties\":{\"commentId\":{\"description\":\"The ID of the CommentThread which the post belongs to.\",\"type\":\"string\"},\"content\":{\"description\":\"The new text of the comment, as plain text.\",\"type\":\"string\"},\"postId\":{\"description\":\"The ID of the post being updated.\",\"type\":\"string\"},\"suggestionId\":{\"description\":\"The ID of the SuggestionThread which the post belongs to.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_UpdateDocumentStyleRequest\":{\"description\":\"Updates the DocumentStyle.\",\"properties\":{\"documentStyle\":{\"description\":\"The styles to set on the document.\",\"$ref\":\"#/$defs/Input_DocumentStyle\"},\"fields\":{\"description\":\"The fields that should be updated.\",\"format\":\"google-fieldmask\",\"type\":\"string\"},\"tabId\":{\"description\":\"The tab that contains the style to update.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_DocumentStyle\":{\"description\":\"The style of the document.\",\"properties\":{\"background\":{\"description\":\"The background of the document.\",\"$ref\":\"#/$defs/Input_Background\"},\"defaultFooterId\":{\"description\":\"The ID of the default footer.\",\"type\":\"string\"},\"defaultHeaderId\":{\"description\":\"The ID of the default header.\",\"type\":\"string\"},\"documentFormat\":{\"description\":\"Specifies document-level format settings, such as the document mode (pages vs pageless).\",\"$ref\":\"#/$defs/Input_DocumentFormat\"},\"evenPageFooterId\":{\"description\":\"The ID of the footer used only for even pages.\",\"type\":\"string\"},\"evenPageHeaderId\":{\"description\":\"The ID of the header used only for even pages.\",\"type\":\"string\"},\"firstPageFooterId\":{\"description\":\"The ID of the footer used only for the first page.\",\"type\":\"string\"},\"firstPageHeaderId\":{\"description\":\"The ID of the header used only for the first page.\",\"type\":\"string\"},\"flipPageOrientation\":{\"description\":\"Optional.\",\"type\":\"boolean\"},\"marginBottom\":{\"description\":\"The bottom page margin.\",\"$ref\":\"#/$defs/Input_Dimension\"},\"marginFooter\":{\"description\":\"The amount of space between the bottom of the page and the contents of the footer.\",\"$ref\":\"#/$defs/Input_Dimension\"},\"marginHeader\":{\"description\":\"The amount of space between the top of the page and the contents of the header.\",\"$ref\":\"#/$defs/Input_Dimension\"},\"marginLeft\":{\"description\":\"The left page margin.\",\"$ref\":\"#/$defs/Input_Dimension\"},\"marginRight\":{\"description\":\"The right page margin.\",\"$ref\":\"#/$defs/Input_Dimension\"},\"marginTop\":{\"description\":\"The top page margin.\",\"$ref\":\"#/$defs/Input_Dimension\"},\"pageNumberStart\":{\"description\":\"The page number from which to start counting the number of pages.\",\"format\":\"int32\",\"type\":\"integer\"},\"pageSize\":{\"description\":\"The size of a page in the document.\",\"$ref\":\"#/$defs/Input_Size\"},\"useCustomHeaderFooterMargins\":{\"description\":\"Indicates whether DocumentStyle margin_header, SectionStyle margin_header and DocumentStyle margin_footer, SectionStyle margin_footer are respected.\",\"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\"},\"Input_Background\":{\"description\":\"Represents the background of a document.\",\"properties\":{\"color\":{\"description\":\"The background color.\",\"$ref\":\"#/$defs/Input_OptionalColor\"}},\"type\":\"object\"},\"Input_DocumentFormat\":{\"description\":\"Represents document-level format settings.\",\"properties\":{\"documentMode\":{\"description\":\"Whether the document has pages or is pageless.\",\"enum\":[\"DOCUMENT_MODE_UNSPECIFIED\",\"PAGES\",\"PAGELESS\"],\"type\":\"string\"}},\"type\":\"object\"},\"Input_UpdateDocumentTabPropertiesRequest\":{\"description\":\"Update the properties of a document tab.\",\"properties\":{\"fields\":{\"description\":\"The fields that should be updated.\",\"format\":\"google-fieldmask\",\"type\":\"string\"},\"tabProperties\":{\"description\":\"The tab properties to update.\",\"$ref\":\"#/$defs/Input_TabProperties\"}},\"type\":\"object\"},\"Input_UpdateDropdownDefinitionPropertiesRequest\":{\"description\":\"Updates the properties of a DropdownDefinition.\",\"properties\":{\"dropdownDefinitionId\":{\"description\":\"The ID of the DropdownDefinition to update.\",\"type\":\"string\"},\"dropdownDefinitionProperties\":{\"description\":\"The properties to update.\",\"$ref\":\"#/$defs/Input_DropdownDefinitionProperties\"},\"fields\":{\"description\":\"The fields that should be updated.\",\"format\":\"google-fieldmask\",\"type\":\"string\"},\"selectedOptionIdReplacements\":{\"additionalProperties\":{\"type\":\"string\"},\"description\":\"A map of option IDs to their replacements, used to automatically reassign orphaned Dropdown chips when an option is deleted.\",\"type\":\"object\"},\"tabId\":{\"description\":\"The ID of the tab that contains the dropdown definition to update.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_UpdateDropdownPropertiesRequest\":{\"description\":\"Updates the properties of a Dropdown.\",\"properties\":{\"dropdownId\":{\"description\":\"Required.\",\"type\":\"string\"},\"dropdownProperties\":{\"description\":\"The properties to update.\",\"$ref\":\"#/$defs/Input_DropdownProperties\"},\"fields\":{\"description\":\"The fields that should be updated.\",\"format\":\"google-fieldmask\",\"type\":\"string\"},\"tabId\":{\"description\":\"The ID of the tab that contains the dropdown to update.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_DropdownProperties\":{\"description\":\"Properties specific to a dropdown.\",\"properties\":{\"displayValue\":{\"description\":\"The human-readable display text of the currently selected item.\",\"type\":\"string\"},\"dropdownDefinitionId\":{\"description\":\"The ID of the DropdownDefinition that defines the options for this dropdown.\",\"type\":\"string\"},\"selectedOptionId\":{\"description\":\"The ID of the selected option in this dropdown.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_UpdateNamedStyleRequest\":{\"description\":\"Updates a named style.\",\"properties\":{\"fields\":{\"description\":\"The NamedStyle fields that should be updated.\",\"format\":\"google-fieldmask\",\"type\":\"string\"},\"namedStyle\":{\"description\":\"The document style to update.\",\"$ref\":\"#/$defs/Input_NamedStyle\"},\"tabId\":{\"description\":\"The document tab to update.\",\"type\":\"string\"}},\"type\":\"object\"},\"Input_NamedStyle\":{\"description\":\"A named style.\",\"properties\":{\"namedStyleType\":{\"description\":\"The type of this named style.\",\"enum\":[\"NAMED_STYLE_TYPE_UNSPECIFIED\",\"NORMAL_TEXT\",\"TITLE\",\"SUBTITLE\",\"HEADING_1\",\"HEADING_2\",\"HEADING_3\",\"HEADING_4\",\"HEADING_5\",\"HEADING_6\"],\"type\":\"string\"},\"paragraphStyle\":{\"description\":\"The paragraph style of this named style.\",\"$ref\":\"#/$defs/Input_ParagraphStyle\"},\"textStyle\":{\"description\":\"The text style of this named style.\",\"$ref\":\"#/$defs/Input_TextStyle\"}},\"type\":\"object\"},\"Input_ParagraphStyle\":{\"description\":\"Styles that apply to a whole paragraph.\",\"properties\":{\"alignment\":{\"description\":\"The text alignment for this paragraph.\",\"enum\":[\"ALIGNMENT_UNSPECIFIED\",\"START\",\"CENTER\",\"END\",\"JUSTIFIED\"],\"type\":\"string\"},\"avoidWidowAndOrphan\":{\"description\":\"Whether to avoid widows and orphans for the paragraph.\",\"type\":\"boolean\"},\"borderBetween\":{\"description\":\"The border between this paragraph and the next and previous paragraphs.\",\"$ref\":\"#/$defs/Input_ParagraphBorder\"},\"borderBottom\":{\"description\":\"The border at the bottom of this paragraph.\",\"$ref\":\"#/$defs/Input_ParagraphBorder\"},\"borderLeft\":{\"description\":\"The border to the left of this paragraph.\",\"$ref\":\"#/$defs/Input_ParagraphBorder\"},\"borderRight\":{\"description\":\"The border to the right of this paragraph.\",\"$ref\":\"#/$defs/Input_ParagraphBorder\"},\"borderTop\":{\"description\":\"The border at the top of this paragraph.\",\"$ref\":\"#/$defs/Input_ParagraphBorder\"},\"direction\":{\"description\":\"The text direction of this paragraph.\",\"enum\":[\"CONTENT_DIRECTION_UNSPECIFIED\",\"LEFT_TO_RIGHT\",\"RIGHT_TO_LEFT\"],\"type\":\"string\"},\"headingId\":{\"description\":\"The heading ID of the paragraph.\",\"type\":\"string\"},\"indentEnd\":{\"description\":\"The amount of indentation for the paragraph on the side that corresponds to the end of the text, based on the current paragraph direction.\",\"$ref\":\"#/$defs/Input_Dimension\"},\"indentFirstLine\":{\"description\":\"The amount of indentation for the first line of the paragraph.\",\"$ref\":\"#/$defs/Input_Dimension\"},\"indentStart\":{\"description\":\"The amount of indentation for the paragraph on the side that corresponds to the start of the text, based on the current paragraph direction.\",\"$ref\":\"#/$defs/Input_Dimension\"},\"keepLinesTogether\":{\"description\":\"Whether all lines of the paragraph should be laid out on the same page or column if possible.\",\"type\":\"boolean\"},\"keepWithNext\":{\"description\":\"Whether at least a part of this paragraph should be laid out on the same page or column as the next paragraph if possible.\",\"type\":\"boolean\"},\"lineSpacing\":{\"description\":\"The amount of space between lines, as a percentage of normal, where normal is represented as 100.0.\",\"format\":\"float\",\"type\":\"number\"},\"namedStyleType\":{\"description\":\"The named style type of the paragraph.\",\"enum\":[\"NAMED_STYLE_TYPE_UNSPECIFIED\",\"NORMAL_TEXT\",\"TITLE\",\"SUBTITLE\",\"HEADING_1\",\"HEADING_2\",\"HEADING_3\",\"HEADING_4\",\"HEADING_5\",\"HEADING_6\"],\"type\":\"string\"},\"pageBreakBefore\":{\"description\":\"Whether the current paragraph should always start at the beginning of a page.\",\"type\":\"boolean\"},\"shading\":{\"description\":\"The shading of the paragraph.\",\"$ref\":\"#/$defs/Input_Shading\"},\"spaceAbove\":{\"description\":\"The amount of extra space above the paragraph.\",\"$ref\":\"#/$defs/Input_Dimension\"},\"spaceBelow\":{\"description\":\"The amount of extra space below the paragraph.\",\"$ref\":\"#/$defs/Input_Dimension\"},\"spacingMode\":{\"description\":\"The spacing mode for the paragraph.\",\"enum\":[\"SPACING_MODE_UNSPECIFIED\",\"NEVER_COLLAPSE\",\"COLLAPSE_LISTS\"],\"type\":\"string\"},\"tabStops\":{\"description\":\"A list of the tab stops for this paragraph.\",\"items\":{\"$ref\":\"#/$defs/Input_TabStop\"},\"type\":\"array\"}},\"type\":\"object\"},\"Input_ParagraphBorder\":{\"description\":\"A border around a paragraph.\",\"properties\":{\"color\":{\"description\":\"The color of the border.\",\"$ref\":\"#/$defs/Input_OptionalColor\"},\"dashStyle\":{\"description\":\"The dash style of the border.\",\"enum\":[\"DASH_STYLE_UNSPECIFIED\",\"SOLID\",\"DOT\",\"DASH\"],\"type\":\"string\"},\"padding\":{\"description\":\"The padding of the border.\",\"$ref\":\"#/$defs/Input_Dimension\"},\"width\":{\"description\":\"The width of the border.\",\"$ref\":\"#/$defs/Input_Dimension\"}},\"type\":\"object\"},\"Input_Shading\":{\"description\":\"The shading of a paragraph.\",\"properties\":{\"backgroundColor\":{\"description\":\"The background color of this paragraph shading.\",\"$ref\":\"#/$defs/Input_OptionalColor\"}},\"type\":\"object\"},\"Input_TabStop\":{\"description\":\"A tab stop within a paragraph.\",\"properties\":{\"alignment\":{\"description\":\"The alignment of this tab stop.\",\"enum\":[\"TAB_STOP_ALIGNMENT_UNSPECIFIED\",\"START\",\"CENTER\",\"END\"],\"type\":\"string\"},\"offset\":{\"description\":\"The offset between this tab stop and the start margin.\",\"$ref\":\"#/$defs/Input_Dimension\"}},\"type\":\"object\"},\"Input_UpdateParagraphStyleRequest\":{\"description\":\"Update the styling of all paragraphs that overlap with the given range.\",\"properties\":{\"fields\":{\"description\":\"The fields that should be updated.\",\"format\":\"google-fieldmask\",\"type\":\"string\"},\"paragraphStyle\":{\"description\":\"The styles to set on the paragraphs.\",\"$ref\":\"#/$defs/Input_ParagraphStyle\"},\"range\":{\"description\":\"The range overlapping the paragraphs to style.\",\"$ref\":\"#/$defs/Input_Range\"}},\"type\":\"object\"},\"Input_UpdateSectionStyleRequest\":{\"description\":\"Updates the SectionStyle.\",\"properties\":{\"fields\":{\"description\":\"The fields that should be updated.\",\"format\":\"google-fieldmask\",\"type\":\"string\"},\"range\":{\"description\":\"The range overlapping the sections to style.\",\"$ref\":\"#/$defs/Input_Range\"},\"sectionStyle\":{\"description\":\"The styles to be set on the section.\",\"$ref\":\"#/$defs/Input_SectionStyle\"}},\"type\":\"object\"},\"Input_SectionStyle\":{\"description\":\"The styling that applies to a section.\",\"properties\":{\"columnProperties\":{\"description\":\"The section's columns properties.\",\"items\":{\"$ref\":\"#/$defs/Input_SectionColumnProperties\"},\"type\":\"array\"},\"columnSeparatorStyle\":{\"description\":\"The style of column separators.\",\"enum\":[\"COLUMN_SEPARATOR_STYLE_UNSPECIFIED\",\"NONE\",\"BETWEEN_EACH_COLUMN\"],\"type\":\"string\"},\"contentDirection\":{\"description\":\"The content direction of this section.\",\"enum\":[\"CONTENT_DIRECTION_UNSPECIFIED\",\"LEFT_TO_RIGHT\",\"RIGHT_TO_LEFT\"],\"type\":\"string\"},\"defaultFooterId\":{\"description\":\"The ID of the default footer.\",\"type\":\"string\"},\"defaultHeaderId\":{\"description\":\"The ID of the default header.\",\"type\":\"string\"},\"evenPageFooterId\":{\"description\":\"The ID of the footer used only for even pages.\",\"type\":\"string\"},\"evenPageHeaderId\":{\"description\":\"The ID of the header used only for even pages.\",\"type\":\"string\"},\"firstPageFooterId\":{\"description\":\"The ID of the footer used only for the first page of the section.\",\"type\":\"string\"},\"firstPageHeaderId\":{\"description\":\"The ID of the header used only for the first page of the section.\",\"type\":\"string\"},\"flipPageOrientation\":{\"description\":\"Optional.\",\"type\":\"boolean\"},\"marginBottom\":{\"description\":\"The bottom page margin of the section.\",\"$ref\":\"#/$defs/Input_Dimension\"},\"marginFooter\":{\"description\":\"The footer margin of the section.\",\"$ref\":\"#/$defs/Input_Dimension\"},\"marginHeader\":{\"description\":\"The header margin of the section.\",\"$ref\":\"#/$defs/Input_Dimension\"},\"marginLeft\":{\"description\":\"The left page margin of the section.\",\"$ref\":\"#/$defs/Input_Dimension\"},\"marginRight\":{\"description\":\"The right page margin of the section.\",\"$ref\":\"#/$defs/Input_Dimension\"},\"marginTop\":{\"description\":\"The top page margin of the section.\",\"$ref\":\"#/$defs/Input_Dimension\"},\"pageNumberStart\":{\"description\":\"The page number from which to start counting the number of pages for this section.\",\"format\":\"int32\",\"type\":\"integer\"},\"useFirstPageHeaderFooter\":{\"description\":\"Indicates whether to use the first page header / footer IDs for the first page of the section.\",\"type\":\"boolean\"}},\"type\":\"object\"},\"Input_SectionColumnProperties\":{\"description\":\"Properties that apply to a section's column.\",\"properties\":{\"paddingEnd\":{\"description\":\"The padding at the end of the column.\",\"$ref\":\"#/$defs/Input_Dimension\"}},\"type\":\"object\"},\"Input_UpdateTableCellStyleRequest\":{\"description\":\"Updates the style of a range of table cells.\",\"properties\":{\"fields\":{\"description\":\"The fields that should be updated.\",\"format\":\"google-fieldmask\",\"type\":\"string\"},\"tableCellStyle\":{\"description\":\"The style to set on the table cells.\",\"$ref\":\"#/$defs/Input_TableCellStyle\"},\"tableRange\":{\"description\":\"The table range representing the subset of the table to which the updates are applied.\",\"$ref\":\"#/$defs/Input_TableRange\"},\"tableStartLocation\":{\"description\":\"The location where the table starts in the document.\",\"$ref\":\"#/$defs/Input_Location\"}},\"type\":\"object\"},\"Input_TableCellStyle\":{\"description\":\"The style of a TableCell.\",\"properties\":{\"backgroundColor\":{\"description\":\"The background color of the cell.\",\"$ref\":\"#/$defs/Input_OptionalColor\"},\"borderBottom\":{\"description\":\"The bottom border of the cell.\",\"$ref\":\"#/$defs/Input_TableCellBorder\"},\"borderLeft\":{\"description\":\"The left border of the cell.\",\"$ref\":\"#/$defs/Input_TableCellBorder\"},\"borderRight\":{\"description\":\"The right border of the cell.\",\"$ref\":\"#/$defs/Input_TableCellBorder\"},\"borderTop\":{\"description\":\"The top border of the cell.\",\"$ref\":\"#/$defs/Input_TableCellBorder\"},\"columnSpan\":{\"description\":\"The column span of the cell.\",\"format\":\"int32\",\"type\":\"integer\"},\"contentAlignment\":{\"description\":\"The alignment of the content in the table cell.\",\"enum\":[\"CONTENT_ALIGNMENT_UNSPECIFIED\",\"CONTENT_ALIGNMENT_UNSUPPORTED\",\"TOP\",\"MIDDLE\",\"BOTTOM\"],\"type\":\"string\"},\"paddingBottom\":{\"description\":\"The bottom padding of the cell.\",\"$ref\":\"#/$defs/Input_Dimension\"},\"paddingLeft\":{\"description\":\"The left padding of the cell.\",\"$ref\":\"#/$defs/Input_Dimension\"},\"paddingRight\":{\"description\":\"The right padding of the cell.\",\"$ref\":\"#/$defs/Input_Dimension\"},\"paddingTop\":{\"description\":\"The top padding of the cell.\",\"$ref\":\"#/$defs/Input_Dimension\"},\"rowSpan\":{\"description\":\"The row span of the cell.\",\"format\":\"int32\",\"type\":\"integer\"}},\"type\":\"object\"},\"Input_TableCellBorder\":{\"description\":\"A border around a table cell.\",\"properties\":{\"color\":{\"description\":\"The color of the border.\",\"$ref\":\"#/$defs/Input_OptionalColor\"},\"dashStyle\":{\"description\":\"The dash style of the border.\",\"enum\":[\"DASH_STYLE_UNSPECIFIED\",\"SOLID\",\"DOT\",\"DASH\"],\"type\":\"string\"},\"width\":{\"description\":\"The width of the border.\",\"$ref\":\"#/$defs/Input_Dimension\"}},\"type\":\"object\"},\"Input_UpdateTableColumnPropertiesRequest\":{\"description\":\"Updates the TableColumnProperties of columns in a table.\",\"properties\":{\"columnIndices\":{\"description\":\"The list of zero-based column indices whose property should be updated.\",\"items\":{\"format\":\"int32\",\"type\":\"integer\"},\"type\":\"array\"},\"fields\":{\"description\":\"The fields that should be updated.\",\"format\":\"google-fieldmask\",\"type\":\"string\"},\"tableColumnProperties\":{\"description\":\"The table column properties to update.\",\"$ref\":\"#/$defs/Input_TableColumnProperties\"},\"tableStartLocation\":{\"description\":\"The location where the table starts in the document.\",\"$ref\":\"#/$defs/Input_Location\"}},\"type\":\"object\"},\"Input_TableColumnProperties\":{\"description\":\"The properties of a column in a table.\",\"properties\":{\"width\":{\"description\":\"The width of the column.\",\"$ref\":\"#/$defs/Input_Dimension\"},\"widthType\":{\"description\":\"The width type of the column.\",\"enum\":[\"WIDTH_TYPE_UNSPECIFIED\",\"EVENLY_DISTRIBUTED\",\"FIXED_WIDTH\"],\"type\":\"string\"}},\"type\":\"object\"},\"Input_UpdateTableRowStyleRequest\":{\"description\":\"Updates the TableRowStyle of rows in a table.\",\"properties\":{\"fields\":{\"description\":\"The fields that should be updated.\",\"format\":\"google-fieldmask\",\"type\":\"string\"},\"rowIndices\":{\"description\":\"The list of zero-based row indices whose style should be updated.\",\"items\":{\"format\":\"int32\",\"type\":\"integer\"},\"type\":\"array\"},\"tableRowStyle\":{\"description\":\"The styles to be set on the rows.\",\"$ref\":\"#/$defs/Input_TableRowStyle\"},\"tableStartLocation\":{\"description\":\"The location where the table starts in the document.\",\"$ref\":\"#/$defs/Input_Location\"}},\"type\":\"object\"},\"Input_TableRowStyle\":{\"description\":\"Styles that apply to a table row.\",\"properties\":{\"minRowHeight\":{\"description\":\"The minimum height of the row.\",\"$ref\":\"#/$defs/Input_Dimension\"},\"preventOverflow\":{\"description\":\"Whether the row cannot overflow across page or column boundaries.\",\"type\":\"boolean\"},\"tableHeader\":{\"description\":\"Whether the row is a table header.\",\"type\":\"boolean\"}},\"type\":\"object\"},\"Input_UpdateTextStyleRequest\":{\"description\":\"Update the styling of text.\",\"properties\":{\"fields\":{\"description\":\"The fields that should be updated.\",\"format\":\"google-fieldmask\",\"type\":\"string\"},\"range\":{\"description\":\"The range of text to style.\",\"$ref\":\"#/$defs/Input_Range\"},\"textStyle\":{\"description\":\"The styles to set on the text.\",\"$ref\":\"#/$defs/Input_TextStyle\"}},\"type\":\"object\"},\"Input_WriteControl\":{\"description\":\"Provides control over how write requests are executed.\",\"properties\":{\"requiredRevisionId\":{\"description\":\"The optional revision ID of the document the write request is applied to.\",\"type\":\"string\"},\"targetRevisionId\":{\"description\":\"The optional target revision ID of the document the write request is applied to.\",\"type\":\"string\"},\"writeMode\":{\"description\":\"How the request updates should be applied to the document.\",\"enum\":[\"WRITE_MODE_UNSPECIFIED\",\"EDIT\",\"SUGGEST\"],\"type\":\"string\"}},\"type\":\"object\"}},\"roots\":[{\"$ref\":\"#/$defs/Input_Document\"},null,{\"$ref\":\"#/$defs/Input_BatchUpdateDocumentRequest\"}]}",
+}, { "length": 4078, "definitions": "[]", "parameters": ["[\"prettyPrint\",\"query\",0,{\"t\":\"boolean\"},\"Returns response with indentations and line breaks.\"]", "[\"fields\",\"query\",0,{\"t\":\"string\"},\"Selector specifying which fields to include in a partial response.\"]", "[\"commentsViewMode\",\"query\",0,{\"t\":\"string\",\"e\":[\"COMMENTS_VIEW_MODE_UNSPECIFIED\",\"COMMENTS_VIEW_MODE_DEFAULT_FOR_CURRENT_ACCESS\",\"COMMENTS_VIEW_MODE_OMITTED\",\"COMMENTS_VIEW_MODE_INCLUDED\"]},\"The comments view mode to apply to the document.\"]", "[\"suggestionsViewMode\",\"query\",0,{\"t\":\"string\",\"e\":[\"DEFAULT_FOR_CURRENT_ACCESS\",\"SUGGESTIONS_INLINE\",\"PREVIEW_SUGGESTIONS_ACCEPTED\",\"PREVIEW_WITHOUT_SUGGESTIONS\"]},\"The suggestions view mode to apply to the document.\"]", "[\"includeTabsContent\",\"query\",0,{\"t\":\"boolean\"},\"Whether to populate the `Document.tabs` field instead of the text content fields like `body` and `documentStyle` on `Document`.\"]", "[\"documentId\",\"path\",1,{\"t\":\"string\"},\"The ID of the document to retrieve.\"]", "[\"documentId\",\"path\",1,{\"t\":\"string\"},\"The ID of the document to update.\"]"], "operations": [[[0, 1], "[\"application/json\",{\"t\":\"object\",\"p\":{\"title\":{\"t\":\"string\",\"d\":\"The title of the document.\"}}},1]"], [[0, 1, 2, 3, 4, 5], "0"], [[0, 1, 6], "[\"application/json\",{\"t\":\"object\",\"p\":{\"requests\":{\"t\":\"array\",\"d\":\"A list of updates to apply to the document.\",\"i\":{\"t\":\"object\",\"p\":{\"acceptSuggestion\":{\"t\":\"object\",\"x\":1},\"addCommentReply\":{\"t\":\"object\",\"x\":1},\"addDocumentTab\":{\"t\":\"object\",\"x\":1},\"createDropdownDefinition\":{\"t\":\"object\",\"x\":1},\"createFooter\":{\"t\":\"object\",\"x\":1},\"createFootnote\":{\"t\":\"object\",\"x\":1},\"createHeader\":{\"t\":\"object\",\"x\":1},\"createNamedRange\":{\"t\":\"object\",\"x\":1},\"createParagraphBullets\":{\"t\":\"object\",\"x\":1},\"deleteComment\":{\"t\":\"object\",\"x\":1},\"deleteCommentReply\":{\"t\":\"object\",\"x\":1},\"deleteContentRange\":{\"t\":\"object\",\"x\":1},\"deleteDropdownDefinition\":{\"t\":\"object\",\"x\":1},\"deleteFooter\":{\"t\":\"object\",\"x\":1},\"deleteHeader\":{\"t\":\"object\",\"x\":1},\"deleteNamedRange\":{\"t\":\"object\",\"x\":1},\"deleteParagraphBullets\":{\"t\":\"object\",\"x\":1},\"deletePositionedObject\":{\"t\":\"object\",\"x\":1},\"deleteSuggestion\":{\"t\":\"object\",\"x\":1},\"deleteTab\":{\"t\":\"object\",\"x\":1},\"deleteTableColumn\":{\"t\":\"object\",\"x\":1},\"deleteTableRow\":{\"t\":\"object\",\"x\":1},\"insertComment\":{\"t\":\"object\",\"x\":1},\"insertDate\":{\"t\":\"object\",\"x\":1},\"insertDropdown\":{\"t\":\"object\",\"x\":1},\"insertInlineImage\":{\"t\":\"object\",\"x\":1},\"insertPageBreak\":{\"t\":\"object\",\"x\":1},\"insertPerson\":{\"t\":\"object\",\"x\":1},\"insertRichLink\":{\"t\":\"object\",\"x\":1},\"insertSectionBreak\":{\"t\":\"object\",\"x\":1},\"insertTable\":{\"t\":\"object\",\"x\":1},\"insertTableColumn\":{\"t\":\"object\",\"x\":1},\"insertTableRow\":{\"t\":\"object\",\"x\":1},\"insertText\":{\"t\":\"object\",\"x\":1},\"mergeTableCells\":{\"t\":\"object\",\"x\":1},\"pinTableHeaderRows\":{\"t\":\"object\",\"x\":1},\"rejectSuggestion\":{\"t\":\"object\",\"x\":1},\"replaceAllText\":{\"t\":\"object\",\"x\":1},\"replaceImage\":{\"t\":\"object\",\"x\":1},\"replaceNamedRangeContent\":{\"t\":\"object\",\"x\":1},\"unmergeTableCells\":{\"t\":\"object\",\"x\":1},\"updateCommentPost\":{\"t\":\"object\",\"x\":1},\"updateDocumentStyle\":{\"t\":\"object\",\"x\":1},\"updateDocumentTabProperties\":{\"t\":\"object\",\"x\":1},\"updateDropdownDefinitionProperties\":{\"t\":\"object\",\"x\":1},\"updateDropdownProperties\":{\"t\":\"object\",\"x\":1},\"updateNamedStyle\":{\"t\":\"object\",\"x\":1},\"updateParagraphStyle\":{\"t\":\"object\",\"x\":1},\"updateSectionStyle\":{\"t\":\"object\",\"x\":1},\"updateTableCellStyle\":{\"t\":\"object\",\"x\":1},\"updateTableColumnProperties\":{\"t\":\"object\",\"x\":1},\"updateTableRowStyle\":{\"t\":\"object\",\"x\":1},\"updateTextStyle\":{\"t\":\"object\",\"x\":1}}}},\"writeControl\":{\"t\":\"object\",\"d\":\"Provides control over how write requests are executed.\",\"p\":{\"requiredRevisionId\":{\"t\":\"string\"},\"targetRevisionId\":{\"t\":\"string\"},\"writeMode\":{\"t\":\"string\",\"e\":[\"WRITE_MODE_UNSPECIFIED\",\"EDIT\",\"SUGGEST\"]}}}}},1]"]] });

package/dist/providers/docs/safety.js

@@ -0,0 +1,54 @@
+import { Effect } from "effect";
+import { RequestSecrets } from "../../http/services.js";
+import { googleSafety } from "../_shared/google/kit.js";
+/** ImageProperties.contentUri delegates the requester's image access for 30 minutes.
+ * Keep ordinary authored links/sourceUri, but withhold that vendor capability on
+ * every document response, including tabs, headers and suggested image changes.
+ */
+export function docsSafety(operations) {
+    const base = googleSafety("Google Docs", operations);
+    return {
+        ...base,
+        reviewed: {
+            ...base.reviewed,
+            redact: (data) => {
+                const visit = (value) => {
+                    if (Array.isArray(value))
+                        return value.map(visit);
+                    if (!value || typeof value !== "object")
+                        return value;
+                    return Object.fromEntries(Object.entries(value).map(([key, child]) => [
+                        key,
+                        key === "imageProperties" && child && typeof child === "object" && !Array.isArray(child)
+                            ? Object.fromEntries(Object.entries(child).map(([field, item]) => [
+                                field,
+                                field === "contentUri" ? "[redacted]" : visit(item),
+                            ]))
+                            : visit(child),
+                    ]));
+                };
+                return visit(data);
+            },
+        },
+    };
+}
+/** Check the source lane across runs/paragraphs before either rendering or
+ * hatch selection can split an echoed secret into individually short values. */
+export const docsResult = (data) => RequestSecrets.use((secrets) => Effect.sync(() => {
+    const runs = [];
+    const visit = (value) => {
+        if (!value || typeof value !== "object")
+            return;
+        const run = value["textRun"];
+        if (run && typeof run === "object" && typeof run["content"] === "string")
+            runs.push(run);
+        for (const child of Object.values(value))
+            visit(child);
+    };
+    visit(data);
+    const safe = secrets.parts(runs.map((run) => run["content"]));
+    runs.forEach((run, index) => {
+        run["content"] = safe[index];
+    });
+    return data;
+}));