Google Docs

Use the Google Docs integration to create and modify Google Docs documents.

Configure GoogleDocs on Cortex XSOAR#

  1. Navigate to Settings > Integrations > Servers & Services.
  2. Search for GoogleDocs.
  3. Click Add instance to create and configure a new integration instance.
ParameterDescriptionRequired
service_account_credentialsService Account Private Key file contents (JSON)True
insecureTrust any certificate (not secure)False
proxyUse system proxy settingsFalse
  1. Click Test to validate the URLs, token, and connection.

Commands#

You can execute these commands from the Demisto CLI, as part of an automation, or in a playbook. After you successfully execute a command, a DBot message appears in the War Room with the command details.

google-docs-get-document#


Returns the document that matches the specified document ID.

Base Command#

google-docs-get-document

Input#

Argument NameDescriptionRequired
document_idThe document ID of the document to fetch.Required

Context Output#

PathTypeDescription
GoogleDocs.TitleStringThe title of the document.
GoogleDocs.RevisionIdStringThe revision ID of the updated document.
GoogleDocs.DocumentIdStringThe document ID of the updated document.

Command Example#

!google-docs-get-document document_id=1MjtBlFLwFNsjVwCF0mZLxpRoblVHjLcR3VmZcUuNvzo

Context Example#

{
"GoogleDocs": {
"DocumentId": "1MjtBlFLwFNsjVwCF0mZLxpRoblVHjLcR3VmZcUuNvzo",
"RevisionId": "ALm37BWMd6E3RFLJAI4uq5BdFTiJyeKWjjcVwRdHqv33lE2EWEPv7znT1PmdlB4zLv3xxpTIXlVRJ2Rq71lMCg",
"Title": "testing"
}
}

Human Readable Output#

The document with the title testing was returned. The results are:#

DocumentIdRevisionIdTitle
1MjtBlFLwFNsjVwCF0mZLxpRoblVHjLcR3VmZcUuNvzoALm37BWMd6E3RFLJAI4uq5BdFTiJyeKWjjcVwRdHqv33lE2EWEPv7znT1PmdlB4zLv3xxpTIXlVRJ2Rq71lMCgtesting

google-docs-create-document#


Creates a document.

Base Command#

google-docs-create-document

Input#

Argument NameDescriptionRequired
titleThe title of the document to create.Required

Context Output#

PathTypeDescription
GoogleDocs.TitleStringThe title of the new document.
GoogleDocs.RevisionIdStringThe revision ID of the new document.
GoogleDocs.DocumentIdStringThe document ID of the new document.

Command Example#

!google-docs-create-document title="testing"

Context Example#

{
"GoogleDocs": {
"DocumentId": "12YHG7OISB99ANM3GTbtK9IveiBxyrndnDGuRyyRiA5U",
"RevisionId": "ALm37BWqvcEhS-G00EiPhh2ge7RZz4mYof8Fws-lFE5HfBPwILQJ8ZXmTY0XZCB3sg9a1xiTNzU_jJnFewwaHw",
"Title": "testing"
}
}

Human Readable Output#

The document with the title testing was created. The results are:#

DocumentIdRevisionIdTitle
12YHG7OISB99ANM3GTbtK9IveiBxyrndnDGuRyyRiA5UALm37BWqvcEhS-G00EiPhh2ge7RZz4mYof8Fws-lFE5HfBPwILQJ8ZXmTY0XZCB3sg9a1xiTNzU_jJnFewwaHwtesting

google-docs-update-document#


Updates the document with the specified document ID.

Base Command#

google-docs-update-document

Input#

Argument NameDescriptionRequired
document_idThe document ID of the document to update.Required
actionsUpdates to the document in the format: action1{param1,param2,...};action2{param1,param2,...}.Required
required_revision_idThe target revision ID of the document to which the write request will be applied. If a newer revision exists you will receive an error. If you specify the target_revision_id argument, you cannot use this argument.Optional
target_revision_idThe target revision ID of the document to which the write request will be applied. If a newer revision exists you will receive an error. If you specify the required_revision_id argument, you cannot use this argument.Optional

Context Output#

PathTypeDescription
GoogleDocs.TitleStringThe title of the updated.
GoogleDocs.RevisionIdStringThe revision ID of the updated document.
GoogleDocs.DocumentIdUnknownThe document ID of the updated document.

Command Example#

!google-docs-update-document document_id=1MjtBlFLwFNsjVwCF0mZLxpRoblVHjLcR3VmZcUuNvzo actions=insertText{1,hey};insertText{3,hello}

Context Example#

{
"GoogleDocs": {
"DocumentId": "1MjtBlFLwFNsjVwCF0mZLxpRoblVHjLcR3VmZcUuNvzo",
"RevisionId": "ALm37BWCZhPcqsQ0g1oatbiEtHz2vLXIkZwn9Rt-y0riIUKiuQOfvByrPlJsDW9uW3DRkSwZ7vLBgLgDrrnW9g",
"Title": "testing"
}
}

Human Readable Output#

The document with the title testing and actions insertText{1,hey};insertText{3,hello} was updated. the results are:#

DocumentIdRevisionIdTitle
1MjtBlFLwFNsjVwCF0mZLxpRoblVHjLcR3VmZcUuNvzoALm37BWCZhPcqsQ0g1oatbiEtHz2vLXIkZwn9Rt-y0riIUKiuQOfvByrPlJsDW9uW3DRkSwZ7vLBgLgDrrnW9gtesting