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