Discovery Engine API (discoveryengine:v1)

2026-09-01

6 new methods

Additions

    Methods
  • discoveryengine.projects.locations.dataStores.setIamPolicy

      Scopes :

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/discoveryengine.readwrite
    • https://www.googleapis.com/auth/discoveryengine.serving.readwrite
    • HTTP Method : POST

      Description : Sets the IAM access control policy for a DataStore. A `NOT_FOUND` error is returned if the resource does not exist. **Important:** When setting a policy directly on a DataStore resource, the only recommended roles in the bindings are: `roles/discoveryengine.admin` `roles/discoveryengine.agentspaceAdmin` `roles/discoveryengine.viewer` `roles/discoveryengine.agentspaceViewer` `roles/discoveryengine.user` `roles/discoveryengine.agentspaceUser` Attempting to grant any other role will result in a warning in logging.

      Parameter Order : resource

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}:setIamPolicy

      Path : v1/{+resource}:setIamPolicy

      Parameters :

        resource

          Description : REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.

          Pattern : ^projects/[^/]+/locations/[^/]+/dataStores/[^/]+$

          Location : path

          Required : Yes

          Type : string

  • discoveryengine.projects.locations.dataStores.getIamPolicy

      Parameter Order : resource

      Description : Gets the IAM access control policy for a DataStore. A `NOT_FOUND` error is returned if the resource does not exist. An empty policy is returned if the resource exists but does not have a policy set on it.

      Parameters :

        options.requestedPolicyVersion

          Description : Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).

          Location : query

          Format : int32

          Type : integer

        resource

          Location : path

          Pattern : ^projects/[^/]+/locations/[^/]+/dataStores/[^/]+$

          Required : Yes

          Type : string

          Description : REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.

      HTTP Method : GET

      Path : v1/{+resource}:getIamPolicy

      Scopes :

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/discoveryengine.readwrite
    • https://www.googleapis.com/auth/discoveryengine.serving.readwrite
    • Flat Path : v1/projects/{projectsId}/locations/{locationsId}/dataStores/{dataStoresId}:getIamPolicy

  • discoveryengine.projects.locations.collections.setIamPolicy

      Parameter Order : resource

      HTTP Method : POST

      Path : v1/{+resource}:setIamPolicy

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}:setIamPolicy

      Description : Sets the IAM access control policy for a Collection. A `NOT_FOUND` error is returned if the resource does not exist. **Important:** When setting a policy directly on a Collection resource, the only recommended roles in the bindings are: `roles/discoveryengine.admin` `roles/discoveryengine.agentspaceAdmin` `roles/discoveryengine.viewer` `roles/discoveryengine.agentspaceViewer` `roles/discoveryengine.user` `roles/discoveryengine.agentspaceUser` Attempting to grant any other role will result in a warning in logging.

      Parameters :

        resource

          Type : string

          Required : Yes

          Location : path

          Description : REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.

          Pattern : ^projects/[^/]+/locations/[^/]+/collections/[^/]+$

      Scopes :

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/discoveryengine.readwrite
    • https://www.googleapis.com/auth/discoveryengine.serving.readwrite
  • discoveryengine.projects.locations.collections.getIamPolicy

      Scopes :

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/discoveryengine.readwrite
    • https://www.googleapis.com/auth/discoveryengine.serving.readwrite
    • HTTP Method : GET

      Parameters :

        options.requestedPolicyVersion

          Type : integer

          Description : Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).

          Format : int32

          Location : query

        resource

          Required : Yes

          Location : path

          Description : REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.

          Pattern : ^projects/[^/]+/locations/[^/]+/collections/[^/]+$

          Type : string

      Path : v1/{+resource}:getIamPolicy

      Parameter Order : resource

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}:getIamPolicy

      Description : Gets the IAM access control policy for a Collection. A `NOT_FOUND` error is returned if the resource does not exist. An empty policy is returned if the resource exists but does not have a policy set on it.

  • discoveryengine.projects.locations.collections.dataStores.setIamPolicy

      Path : v1/{+resource}:setIamPolicy

      Flat Path : v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}:setIamPolicy

      Parameters :

        resource

          Type : string

          Description : REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.

          Required : Yes

          Pattern : ^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$

          Location : path

      HTTP Method : POST

      Scopes :

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/discoveryengine.readwrite
    • https://www.googleapis.com/auth/discoveryengine.serving.readwrite
    • Description : Sets the IAM access control policy for a DataStore. A `NOT_FOUND` error is returned if the resource does not exist. **Important:** When setting a policy directly on a DataStore resource, the only recommended roles in the bindings are: `roles/discoveryengine.admin` `roles/discoveryengine.agentspaceAdmin` `roles/discoveryengine.viewer` `roles/discoveryengine.agentspaceViewer` `roles/discoveryengine.user` `roles/discoveryengine.agentspaceUser` Attempting to grant any other role will result in a warning in logging.

      Parameter Order : resource

  • discoveryengine.projects.locations.collections.dataStores.getIamPolicy

      Scopes :

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/discoveryengine.readwrite
    • https://www.googleapis.com/auth/discoveryengine.serving.readwrite
    • Flat Path : v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/dataStores/{dataStoresId}:getIamPolicy

      Parameters :

        resource

          Location : path

          Required : Yes

          Pattern : ^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$

          Type : string

          Description : REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.

        options.requestedPolicyVersion

          Location : query

          Type : integer

          Format : int32

          Description : Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).

      Path : v1/{+resource}:getIamPolicy

      Parameter Order : resource

      HTTP Method : GET

      Description : Gets the IAM access control policy for a DataStore. A `NOT_FOUND` error is returned if the resource does not exist. An empty policy is returned if the resource exists but does not have a policy set on it.