Add filters to a Google Drive data store

Console

1. In the Google Cloud console navigation menu, click Data stores.
2. Select your Google Drive data store.
3. Click View/edit parameters.
4. In the View/edit parameters panel, add or update the folder filter and shared drive filter. For each filter, choose Include or Exclude mode and provide the folder IDs or shared drive IDs.
5. Click Save.

REST

To add or update filters in an existing Google Drive data store, call the updateDataConnector method.

Inclusion lists are set under admin_filter and exclusion lists are set under admin_exclusion_filter. For each filter type, populate the list under admin_filter or under admin_exclusion_filter, but not both.

In the request body, you must include all filter lists that you want to keep in the data store, including filter lists that you aren't updating.

    curl -X PATCH \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json" \
        -H "X-Goog-User-Project: PROJECT_ID" \
        "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/COLLECTION_ID/dataConnector?updateMask=params" \
        -d '{
          "params": {
            "admin_filter": {
              "SharedDriveIds": INCLUDED_SHARED_DRIVE_IDS,
              "FolderIds": INCLUDED_FOLDER_IDS
            },
            "admin_exclusion_filter": {
              "SharedDriveIds": EXCLUDED_SHARED_DRIVE_IDS,
              "FolderIds": EXCLUDED_FOLDER_IDS
            }
          }
        }'
    

Replace the following:

• PROJECT_ID: Your project ID.
• ENDPOINT_LOCATION: The region of your application. For example, us or eu.
• LOCATION: The location of your data connector. It must be global or us.
• COLLECTION_ID: The ID of the collection that contains your data connector. The collection ID is provided when you create a data store. The collection ID isn't the same as the data store ID.
• INCLUDED_SHARED_DRIVE_IDS: A list of shared drive IDs to include in search, for example ["0ABCdEfGhIjKlMnOpQ"]. Use an empty list [] if you aren't setting an inclusion list for shared drives.
• INCLUDED_FOLDER_IDS: A list of folder IDs to include in search, for example ["1AbCdEfGhIjKlMnOpQrStUvWxYz"]. Use an empty list [] if you aren't setting an inclusion list for folders.
• EXCLUDED_SHARED_DRIVE_IDS: A list of shared drive IDs to exclude from search. Use an empty list [] if you aren't setting an exclusion list for shared drives.
• EXCLUDED_FOLDER_IDS: A list of folder IDs to exclude from search. Use an empty list [] if you aren't setting an exclusion list for folders.

Console

1. In the Google Cloud console navigation menu, click Data stores.
2. Select your Google Drive data store.
3. Click View/edit parameters.
4. In the View/edit parameters panel, delete the folder IDs or shared drive IDs from the filters that you want to remove.
5. Click Save.

REST

To remove filters from an existing Google Drive data store, call the updateDataConnector method.

Remove a specific filter

To remove a specific filter while keeping others, send an update request. Include the filter lists that you want to retain and set an empty list [] for the filter that you want to remove.

For example, to remove the folder inclusion list while retaining the shared drive inclusion list, use the following command:

    curl -X PATCH \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json" \
        -H "X-Goog-User-Project: PROJECT_ID" \
        "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/COLLECTION_ID/dataConnector?updateMask=params" \
        -d '{
          "params": {
            "admin_filter": {
              "SharedDriveIds": INCLUDED_SHARED_DRIVE_IDS,
              "FolderIds": []
            }
          }
        }'
    

Replace the following:

• PROJECT_ID: Your project ID.
• ENDPOINT_LOCATION: The region of your application. For example, us or eu.
• LOCATION: The location of your data connector. It must be global or us.
• COLLECTION_ID: The ID of the collection that contains your data connector. The collection ID is provided when you create a data store. The collection ID isn't the same as the data store ID.
• INCLUDED_SHARED_DRIVE_IDS: A list of shared drive IDs to include in search, for example ["0ABCdEfGhIjKlMnOpQ"].

Remove all filters

To remove all filters from the data store, send an update request with empty lists for every filter under both admin_filter and admin_exclusion_filter:

    curl -X PATCH \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json" \
        -H "X-Goog-User-Project: PROJECT_ID" \
        "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/COLLECTION_ID/dataConnector?updateMask=params" \
        -d '{
          "params": {
            "admin_filter": {
              "SharedDriveIds": [],
              "FolderIds": []
            },
            "admin_exclusion_filter": {
              "SharedDriveIds": [],
              "FolderIds": []
            }
          }
        }'
    

Replace the following:

• PROJECT_ID: Your project ID.
• ENDPOINT_LOCATION: The region of your application. For example, us or eu.
• LOCATION: The location of your data connector. It must be global or us.
• COLLECTION_ID: The ID of the collection that contains your data connector. The collection ID is provided when you create a data store. The collection ID isn't the same as the data store ID.