Cloud Firestore API (firestore:v1beta2)

2026-09-02

9 new methods | New API

Additions

    Methods
  • firestore.projects.databases.importDocuments

      HTTP Method : POST

      Description : Imports documents into Google Cloud Firestore. Existing documents with the same name are overwritten. The import occurs in the background and its progress can be monitored and managed via the Operation resource that is created. If an ImportDocuments operation is cancelled, it is possible that a subset of the data has already been imported to Cloud Firestore.

      Flat Path : v1beta2/projects/{projectsId}/databases/{databasesId}:importDocuments

      Parameters :

        name

          Required : Yes

          Location : path

          Type : string

          Pattern : ^projects/[^/]+/databases/[^/]+$

          Description : Database to import into. Should be of the form: `projects/{project_id}/databases/{database_id}`.

      Path : v1beta2/{+name}:importDocuments

      Parameter Order : name

      Scopes :

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/datastore
  • firestore.projects.databases.exportDocuments

      Parameter Order : name

      Parameters :

        name

          Pattern : ^projects/[^/]+/databases/[^/]+$

          Location : path

          Required : Yes

          Description : Database to export. Should be of the form: `projects/{project_id}/databases/{database_id}`.

          Type : string

      Scopes :

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/datastore
    • Description : Exports a copy of all or a subset of documents from Google Cloud Firestore to another storage system, such as Google Cloud Storage. Recent updates to documents may not be reflected in the export. The export occurs in the background and its progress can be monitored and managed via the Operation resource that is created. The output of an export may only be used once the associated operation is done. If an export operation is cancelled before completion it may leave partial data behind in Google Cloud Storage.

      Flat Path : v1beta2/projects/{projectsId}/databases/{databasesId}:exportDocuments

      HTTP Method : POST

      Path : v1beta2/{+name}:exportDocuments

  • firestore.projects.databases.collectionGroups.indexes.delete

      Scopes :

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/datastore
    • Path : v1beta2/{+name}

      Description : Deletes a composite index.

      Parameter Order : name

      Flat Path : v1beta2/projects/{projectsId}/databases/{databasesId}/collectionGroups/{collectionGroupsId}/indexes/{indexesId}

      HTTP Method : DELETE

      Parameters :

        name

          Pattern : ^projects/[^/]+/databases/[^/]+/collectionGroups/[^/]+/indexes/[^/]+$

          Type : string

          Required : Yes

          Description : A name of the form `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/indexes/{index_id}`

          Location : path

  • firestore.projects.databases.collectionGroups.indexes.list

      Parameter Order : parent

      Flat Path : v1beta2/projects/{projectsId}/databases/{databasesId}/collectionGroups/{collectionGroupsId}/indexes

      Scopes :

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/datastore
    • Path : v1beta2/{+parent}/indexes

      Parameters :

        pageSize

          Format : int32

          Type : integer

          Description : The number of results to return.

          Location : query

        parent

          Type : string

          Description : A parent name of the form `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}`

          Required : Yes

          Location : path

          Pattern : ^projects/[^/]+/databases/[^/]+/collectionGroups/[^/]+$

        filter

          Description : The filter to apply to list results.

          Type : string

          Location : query

        pageToken

          Type : string

          Description : A page token, returned from a previous call to FirestoreAdmin.ListIndexes, that may be used to get the next page of results.

          Location : query

      Description : Lists composite indexes.

      HTTP Method : GET

  • firestore.projects.databases.collectionGroups.indexes.create

      Parameters :

        parent

          Description : A parent name of the form `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}`

          Location : path

          Pattern : ^projects/[^/]+/databases/[^/]+/collectionGroups/[^/]+$

          Required : Yes

          Type : string

      Description : Creates a composite index. This returns a google.longrunning.Operation which may be used to track the status of the creation. The metadata for the operation will be the type IndexOperationMetadata.

      Scopes :

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/datastore
    • HTTP Method : POST

      Parameter Order : parent

      Flat Path : v1beta2/projects/{projectsId}/databases/{databasesId}/collectionGroups/{collectionGroupsId}/indexes

      Path : v1beta2/{+parent}/indexes

  • firestore.projects.databases.collectionGroups.indexes.get

      Path : v1beta2/{+name}

      Parameter Order : name

      Parameters :

        name

          Required : Yes

          Location : path

          Type : string

          Pattern : ^projects/[^/]+/databases/[^/]+/collectionGroups/[^/]+/indexes/[^/]+$

          Description : A name of the form `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/indexes/{index_id}`

      Flat Path : v1beta2/projects/{projectsId}/databases/{databasesId}/collectionGroups/{collectionGroupsId}/indexes/{indexesId}

      Scopes :

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/datastore
    • Description : Gets a composite index.

      HTTP Method : GET

  • firestore.projects.databases.collectionGroups.fields.get

      HTTP Method : GET

      Scopes :

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/datastore
    • Flat Path : v1beta2/projects/{projectsId}/databases/{databasesId}/collectionGroups/{collectionGroupsId}/fields/{fieldsId}

      Description : Gets the metadata and configuration for a Field.

      Parameters :

        name

          Pattern : ^projects/[^/]+/databases/[^/]+/collectionGroups/[^/]+/fields/[^/]+$

          Location : path

          Required : Yes

          Type : string

          Description : A name of the form `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/fields/{field_id}`

      Path : v1beta2/{+name}

      Parameter Order : name

  • firestore.projects.databases.collectionGroups.fields.patch

      HTTP Method : PATCH

      Path : v1beta2/{+name}

      Parameters :

        name

          Description : A field name of the form `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/fields/{field_path}` A field path may be a simple field name, e.g. `address` or a path to fields within map_value , e.g. `address.city`, or a special field path. The only valid special field is `*`, which represents any field. Field paths may be quoted using ` (backtick). The only character that needs to be escaped within a quoted field path is the backtick character itself, escaped using a backslash. Special characters in field paths that must be quoted include: `*`, `.`, ``` (backtick), `[`, `]`, as well as any ascii symbolic characters. Examples: (Note: Comments here are written in markdown syntax, so there is an additional layer of backticks to represent a code block) `\`address.city\`` represents a field named `address.city`, not the map key `city` in the field `address`. `\`*\`` represents a field named `*`, not any field. A special `Field` contains the default indexing settings for all fields. This field's resource name is: `projects/{project_id}/databases/{database_id}/collectionGroups/__default__/fields/*` Indexes defined on this `Field` will be applied to all fields which do not have their own `Field` index configuration.

          Required : Yes

          Type : string

          Location : path

          Pattern : ^projects/[^/]+/databases/[^/]+/collectionGroups/[^/]+/fields/[^/]+$

        updateMask

          Format : google-fieldmask

          Location : query

          Type : string

          Description : A mask, relative to the field. If specified, only configuration specified by this field_mask will be updated in the field.

      Description : Updates a field configuration. Currently, field updates apply only to single field index configuration. However, calls to FirestoreAdmin.UpdateField should provide a field mask to avoid changing any configuration that the caller isn't aware of. The field mask should be specified as: `{ paths: "index_config" }`. This call returns a google.longrunning.Operation which may be used to track the status of the field update. The metadata for the operation will be the type FieldOperationMetadata. To configure the default field settings for the database, use the special `Field` with resource name: `projects/{project_id}/databases/{database_id}/collectionGroups/__default__/fields/*`.

      Scopes :

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/datastore
    • Parameter Order : name

      Flat Path : v1beta2/projects/{projectsId}/databases/{databasesId}/collectionGroups/{collectionGroupsId}/fields/{fieldsId}

  • firestore.projects.databases.collectionGroups.fields.list

      Parameter Order : parent

      Path : v1beta2/{+parent}/fields

      Flat Path : v1beta2/projects/{projectsId}/databases/{databasesId}/collectionGroups/{collectionGroupsId}/fields

      Parameters :

        filter

          Description : The filter to apply to list results. Currently, FirestoreAdmin.ListFields only supports listing fields that have been explicitly overridden. To issue this query, call FirestoreAdmin.ListFields with the filter set to `indexConfig.usesAncestorConfig:false`.

          Location : query

          Type : string

        parent

          Pattern : ^projects/[^/]+/databases/[^/]+/collectionGroups/[^/]+$

          Location : path

          Required : Yes

          Description : A parent name of the form `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}`

          Type : string

        pageToken

          Description : A page token, returned from a previous call to FirestoreAdmin.ListFields, that may be used to get the next page of results.

          Type : string

          Location : query

        pageSize

          Type : integer

          Description : The number of results to return.

          Location : query

          Format : int32

      Scopes :

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/datastore
    • Description : Lists the field configuration and metadata for this database. Currently, FirestoreAdmin.ListFields only supports listing fields that have been explicitly overridden. To issue this query, call FirestoreAdmin.ListFields with the filter set to `indexConfig.usesAncestorConfig:false`.

      HTTP Method : GET