Starting April 29, 2025, Gemini 1.5 Pro and Gemini 1.5 Flash models are not available in projects that have no prior usage of these models, including new projects. For details, see Model versions and lifecycle.
Output only. timestamp when this RagFile was created.
Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
Output only. timestamp when this RagFile was last updated.
Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
Required. The SecretManager secret version resource name (e.g. projects/{project}/secrets/{secret}/versions/{version}) storing the Slack channel access token that has access to the slack channel IDs. See: https://api.slack.com/tutorials/tracks/getting-a-token.
Optional. The starting timestamp for messages to import.
Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
Optional. The ending timestamp for messages to import.
Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
Required. The SecretManager secret version resource name (e.g. projects/{project}/secrets/{secret}/versions/{version}) storing the Jira API key. See Manage API tokens for your Atlassian account.
The Application id for the app registered in Microsoft Azure Portal. The application must also be configured with MS Graph permissions "Files.ReadAll", "Sites.ReadAll" and BrowserSiteLists.Read.All.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-06-27 UTC."],[],[],null,["# REST Resource: projects.locations.ragCorpora.ragFiles\n\nResource: RagFile\n-----------------\n\nA RagFile contains user data for chunking, embedding and indexing.\nFields `name` `string` \nOutput only. The resource name of the RagFile.\n`displayName` `string` \nRequired. The display name of the RagFile. The name can be up to 128 characters long and can consist of any UTF-8 characters.\n`description` `string` \nOptional. The description of the RagFile.\n`createTime` `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` \nOutput only. timestamp when this RagFile was created.\n\nUses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`.\n`updateTime` `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` \nOutput only. timestamp when this RagFile was last updated.\n\nUses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`.\n`fileStatus` `object (`[FileStatus](/vertex-ai/generative-ai/docs/reference/rest/v1/projects.locations.ragCorpora.ragFiles#FileStatus)`)` \nOutput only. state of the RagFile.\n`userMetadata` `string` \nOutput only. The metadata for metadata search. The userMetadata Needs to be in JSON format. \n`rag_file_source` `Union type` \nThe origin location of the RagFile if it is imported from Google Cloud Storage or Google Drive. `rag_file_source` can be only one of the following:\n`gcsSource` `object (`[GcsSource](/vertex-ai/generative-ai/docs/reference/rest/v1/projects.locations.ragCorpora.ragFiles#GcsSource)`)` \nOutput only. Google Cloud Storage location of the RagFile. It does not support wildcards in the Cloud Storage uri for now.\n`googleDriveSource` `object (`[GoogleDriveSource](/vertex-ai/generative-ai/docs/reference/rest/v1/projects.locations.ragCorpora.ragFiles#GoogleDriveSource)`)` \nOutput only. Google Drive location. Supports importing individual files as well as Google Drive folders.\n`directUploadSource` `object (`[DirectUploadSource](/vertex-ai/generative-ai/docs/reference/rest/v1/projects.locations.ragCorpora.ragFiles#DirectUploadSource)`)` \nOutput only. The RagFile is encapsulated and uploaded in the UploadRagFile request.\n`slackSource` `object (`[SlackSource](/vertex-ai/generative-ai/docs/reference/rest/v1/projects.locations.ragCorpora.ragFiles#SlackSource)`)` \nThe RagFile is imported from a Slack channel.\n`jiraSource` `object (`[JiraSource](/vertex-ai/generative-ai/docs/reference/rest/v1/projects.locations.ragCorpora.ragFiles#JiraSource)`)` \nThe RagFile is imported from a Jira query.\n`sharePointSources` `object (`[SharePointSources](/vertex-ai/generative-ai/docs/reference/rest/v1/projects.locations.ragCorpora.ragFiles#SharePointSources)`)` \nThe RagFile is imported from a SharePoint source. \n\nGcsSource\n---------\n\nThe Google Cloud Storage location for the input content.\nFields `uris[]` `string` \nRequired. Google Cloud Storage URI(-s) to the input file(s). May contain wildcards. For more information on wildcards, see \u003chttps://cloud.google.com/storage/docs/wildcards\u003e. \n\nGoogleDriveSource\n-----------------\n\nThe Google Drive location for the input content.\nFields `resourceIds[]` `object (`[ResourceId](/vertex-ai/generative-ai/docs/reference/rest/v1/projects.locations.ragCorpora.ragFiles#ResourceId)`)` \nRequired. Google Drive resource IDs. \n\nResourceId\n----------\n\nThe type and id of the Google Drive resource.\nFields `resourceType` `enum (`[ResourceType](/vertex-ai/generative-ai/docs/reference/rest/v1/projects.locations.ragCorpora.ragFiles#ResourceType)`)` \nRequired. The type of the Google Drive resource.\n`resourceId` `string` \nRequired. The id of the Google Drive resource. \n\nResourceType\n------------\n\nThe type of the Google Drive resource.\n\nDirectUploadSource\n------------------\n\nThis type has no fields. \nThe input content is encapsulated and uploaded in the request.\n\nSlackSource\n-----------\n\nThe Slack source for the ImportRagFilesRequest.\nFields `channels[]` `object (`[SlackChannels](/vertex-ai/generative-ai/docs/reference/rest/v1/projects.locations.ragCorpora.ragFiles#SlackChannels)`)` \nRequired. The Slack channels. \n\nSlackChannels\n-------------\n\nSlackChannels contains the Slack channels and corresponding access token.\nFields `channels[]` `object (`[SlackChannel](/vertex-ai/generative-ai/docs/reference/rest/v1/projects.locations.ragCorpora.ragFiles#SlackChannel)`)` \nRequired. The Slack channel IDs.\n`apiKeyConfig` `object (`[ApiKeyConfig](/vertex-ai/generative-ai/docs/reference/rest/v1/ApiKeyConfig)`)` \nRequired. The SecretManager secret version resource name (e.g. projects/{project}/secrets/{secret}/versions/{version}) storing the Slack channel access token that has access to the slack channel IDs. See: \u003chttps://api.slack.com/tutorials/tracks/getting-a-token\u003e. \n\nSlackChannel\n------------\n\nSlackChannel contains the Slack channel id and the time range to import.\nFields `channelId` `string` \nRequired. The Slack channel id.\n`startTime` `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` \nOptional. The starting timestamp for messages to import.\n\nUses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`.\n`endTime` `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` \nOptional. The ending timestamp for messages to import.\n\nUses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`. \n\nJiraSource\n----------\n\nThe Jira source for the ImportRagFilesRequest.\nFields `jiraQueries[]` `object (`[JiraQueries](/vertex-ai/generative-ai/docs/reference/rest/v1/projects.locations.ragCorpora.ragFiles#JiraQueries)`)` \nRequired. The Jira queries. \n\nJiraQueries\n-----------\n\nJiraQueries contains the Jira queries and corresponding authentication.\nFields `projects[]` `string` \nA list of Jira projects to import in their entirety.\n`customQueries[]` `string` \nA list of custom Jira queries to import. For information about JQL (Jira Query Language), see \u003chttps://support.atlassian.com/jira-service-management-cloud/docs/use-advanced-search-with-jira-query-language-jql/\u003e\n`email` `string` \nRequired. The Jira email address.\n`serverUri` `string` \nRequired. The Jira server URI.\n`apiKeyConfig` `object (`[ApiKeyConfig](/vertex-ai/generative-ai/docs/reference/rest/v1/ApiKeyConfig)`)` \nRequired. The SecretManager secret version resource name (e.g. projects/{project}/secrets/{secret}/versions/{version}) storing the Jira API key. See [Manage API tokens for your Atlassian account](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/). \n\nSharePointSources\n-----------------\n\nThe SharePointSources to pass to ragFiles.import.\nFields `sharePointSources[]` `object (`[SharePointSource](/vertex-ai/generative-ai/docs/reference/rest/v1/projects.locations.ragCorpora.ragFiles#SharePointSource)`)` \nThe SharePoint sources. \n\nSharePointSource\n----------------\n\nAn individual SharePointSource.\nFields `clientId` `string` \nThe Application id for the app registered in Microsoft Azure Portal. The application must also be configured with MS Graph permissions \"Files.ReadAll\", \"Sites.ReadAll\" and BrowserSiteLists.Read.All.\n`clientSecret` `object (`[ApiKeyConfig](/vertex-ai/generative-ai/docs/reference/rest/v1/ApiKeyConfig)`)` \nThe application secret for the app registered in Azure.\n`tenantId` `string` \nUnique identifier of the Azure Active Directory Instance.\n`sharepointSiteName` `string` \nThe name of the SharePoint site to download from. This can be the site name or the site id.\n`fileId` `string` \nOutput only. The SharePoint file id. Output only. \n`folder_source` `Union type` \nThe SharePoint folder source. If not provided, uses \"root\". `folder_source` can be only one of the following:\n`sharepointFolderPath` `string` \nThe path of the SharePoint folder to download from.\n`sharepointFolderId` `string` \nThe id of the SharePoint folder to download from. \n`drive_source` `Union type` \nThe SharePoint drive source. `drive_source` can be only one of the following:\n`driveName` `string` \nThe name of the drive to download from.\n`driveId` `string` \nThe id of the drive to download from. \n\nFileStatus\n----------\n\nRagFile status.\nFields `state` `enum (`[State](/vertex-ai/generative-ai/docs/reference/rest/v1/projects.locations.ragCorpora.ragFiles#State)`)` \nOutput only. RagFile state.\n`errorStatus` `string` \nOutput only. Only when the `state` field is ERROR. \n\nState\n-----\n\nRagFile state."]]