Method: projects.locations.collections.engines.sessions.selectContextFiles

Selects context files to be used in a session.

HTTP request

POST https://discoveryengine.googleapis.com/v1alpha/{name=projects/*/locations/*/collections/*/engines/*/sessions/*}:selectContextFiles

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. The name of the session.

Format: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}

Request body

The request body contains data with the following structure:

JSON representation
{
  "fileSelections": [
    {
      object (FileSelection)
    }
  ]
}
Fields
fileSelections[]

object (FileSelection)

Required. File selection changes. Only files previously uploaded to the session can be selected (or deselected). Files not mentioned here will keep their current selection status.

Response body

If successful, the response body is empty.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the name resource:

  • discoveryengine.sessions.selectContextFiles

For more information, see the IAM documentation.

FileSelection

The selection status of a context file.

JSON representation
{
  "fileId": string,
  "selected": boolean
}
Fields
fileId

string

Required. The ID of the context file.

selected

boolean

Required. Whether the file is selected to be used in the session.