Skip to main content

documents

Creates, updates, deletes, gets or lists a documents resource.

Overview

Namedocuments
TypeResource
Idgoogle.threatintelligence.documents

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
namestringIdentifier. Server generated name for the alert document. format is projects/{project}/alerts/{alert}/documents/{document}
aiSummarystringOutput only. AI summary of the document.
authorstringOutput only. The author of the document.
collectionTimestring (google-datetime)Output only. Time when the origin source collected the intel.
contentstringOutput only. The content of the document.
createTimestring (google-datetime)Output only. The timestamp of the original external publication of the document.
ingestTimestring (google-datetime)Output only. Time when GTI received the intel.
languageCodestringOutput only. The language code of the document.
sourcestringOutput only. Source of the intel item, e.g. DarkMarket.
sourceUpdateTimestring (google-datetime)Output only. Time when the intel was last updated by the source.
sourceUristringOutput only. URI of the intel item from the source.
titlestringOutput only. The title of the document, if available.
translationobjectOutput only. The translation of the document, if available. (id: AlertDocumentTranslation)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectprojectsId, alertsId, documentsIdGets a specific document associated with an alert.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
alertsIdstring
documentsIdstring
projectsIdstring

SELECT examples

Gets a specific document associated with an alert.

SELECT
name,
aiSummary,
author,
collectionTime,
content,
createTime,
ingestTime,
languageCode,
source,
sourceUpdateTime,
sourceUri,
title,
translation
FROM google.threatintelligence.documents
WHERE projectsId = '{{ projectsId }}' -- required
AND alertsId = '{{ alertsId }}' -- required
AND documentsId = '{{ documentsId }}' -- required
;