Filter content by label for a Google Drive external content connector

  • Release version: Australia
  • Updated June 26, 2026
  • 2 minutes to read
  • Configure a label filter for your Google Drive external content connector. The connector only retrieves content that has one or more of your specified label values applied.

    Before you begin

    Role required: admin

    About this task

    The Google Drive external content connector supports the use of labels to filter retrieved content. You can specify a list of label value IDs for your Google Drive connectors to check for during content crawls. The connectors only retrieve content items that have one or more of your specified label values applied.
    Note:
    This task is optional. If you don't specify a list of label value IDs, your Google Drive connectors ignore labels when retrieving content items.

    To learn more about labels and their IDs and values in Google Drive, see the Labels overview Google developer guide.

    Procedure

    1. Navigate to the External Content Connector Configuration Tables [sn_ext_conn_base_connector_configuration] table's list view.
      1. Select All.
      2. In the Filter field, enter sn_ext_conn_base_connector_configuration.list.
      3. Press Enter.
    2. If the Advanced Configuration field doesn't appear in the list view, add it to the list view.
      1. Select the Personalize List icon .
      2. In the Personalize List Columns dialog box, find the Advanced Configuration field in the Available list and use the Add icon to move it to the Selected list.
      3. Select OK.
    3. Use the list editor to add the google_drive_label_include_filter property to the Advanced Configuration field value.
      To learn more about the list editor, see Use the list editor.
      1. Double-click or long-press (or use the keyboard shortcut) to open the Advanced Configuration field value.
        The list editor pane opens and displays the current field value.
      2. In the Advanced Configuration JSON object literal, add this new JSON property.
        "google_drive_label_include_filter": [ "label_id_1" ]
      3. Inside the brackets for the new JSON property's array value, replace the placeholder "label_id_1" string with a comma-separated list of label value IDs that you want Google Drive external connectors to use as filters when retrieving content.
        As an example, you might replace "label_id_1" as follows to filter on three label values with the specified IDs:
        "google_drive_label_include_filter": [ 
           "0Nlvb5ey59iFqWKEF8r8JjE2TykSaYY87y8RNNEbbFcb",
           "EmOlI66ZEgwIbZH2iDvPTbAQ4lGEETKf363RNNEbbFcb",
           "LXpSpR3Tedghc59mo8hE3MiWsG4Xxqi2bzeSNNEbbFcb"
        ]
        With this JSON property specified, your Google Drive connectors only retrieve content items that have at least one of the three specified label values applied.
        Note:
        To find the ID for a Google Drive label value, edit the label value in Google Drive. The label value's ID appears in the Label details section of the Preview pane on the editor page. For details on editing labels in Google Drive, see the Edit and monitor classification labels for your organization Google Workspace Help resource.
      4. Select the Save icon or press Enter.
        The list editor pane closes and the field value is updated with your changes.

    Result

    When you run content crawls for your Google Drive external content connectors, the connectors only retrieve content items that have one or more of your specified label values applied.