Reference documentation and code samples for the Cloud Firestore V1 Client class ExistenceFilter.
A digest of all the documents that match a given target.
Generated from protobuf message google.firestore.v1.ExistenceFilter
Namespace
Google \ Cloud \ Firestore \ V1
Methods
__construct
Constructor.
Parameters
Name
Description
data
array
Optional. Data for populating the Message object.
↳ target_id
int
The target ID to which this filter applies.
↳ count
int
The total count of documents that match target_id. If different from the count of documents in the client that match, the client must manually determine which documents no longer match the target. The client can use the unchanged_names bloom filter to assist with this determination by testing ALL the document names against the filter; if the document name is NOT in the filter, it means the document no longer matches the target.
A bloom filter that, despite its name, contains the UTF-8 byte encodings of the resource names of ALL the documents that match target_id, in the form projects/{project_id}/databases/{database_id}/documents/{document_path}. This bloom filter may be omitted at the server's discretion, such as if it is deemed that the client will not make use of it or if it is too computationally expensive to calculate or transmit. Clients must gracefully handle this field being absent by falling back to the logic used before this field existed; that is, re-add the target without a resume token to figure out which documents in the client's cache are out of sync.
getTargetId
The target ID to which this filter applies.
Returns
Type
Description
int
setTargetId
The target ID to which this filter applies.
Parameter
Name
Description
var
int
Returns
Type
Description
$this
getCount
The total count of documents that match
target_id.
If different from the count of documents in the client that match, the
client must manually determine which documents no longer match the target.
The client can use the unchanged_names bloom filter to assist with
this determination by testing ALL the document names against the filter;
if the document name is NOT in the filter, it means the document no
longer matches the target.
Returns
Type
Description
int
setCount
The total count of documents that match
target_id.
If different from the count of documents in the client that match, the
client must manually determine which documents no longer match the target.
The client can use the unchanged_names bloom filter to assist with
this determination by testing ALL the document names against the filter;
if the document name is NOT in the filter, it means the document no
longer matches the target.
Parameter
Name
Description
var
int
Returns
Type
Description
$this
getUnchangedNames
A bloom filter that, despite its name, contains the UTF-8 byte encodings of
the resource names of ALL the documents that match
target_id, in the form
projects/{project_id}/databases/{database_id}/documents/{document_path}.
This bloom filter may be omitted at the server's discretion, such as if it
is deemed that the client will not make use of it or if it is too
computationally expensive to calculate or transmit. Clients must gracefully
handle this field being absent by falling back to the logic used before
this field existed; that is, re-add the target without a resume token to
figure out which documents in the client's cache are out of sync.
A bloom filter that, despite its name, contains the UTF-8 byte encodings of
the resource names of ALL the documents that match
target_id, in the form
projects/{project_id}/databases/{database_id}/documents/{document_path}.
This bloom filter may be omitted at the server's discretion, such as if it
is deemed that the client will not make use of it or if it is too
computationally expensive to calculate or transmit. Clients must gracefully
handle this field being absent by falling back to the logic used before
this field existed; that is, re-add the target without a resume token to
figure out which documents in the client's cache are out of sync.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Cloud Firestore V1 Client - Class ExistenceFilter (1.53.0)\n\nVersion latestkeyboard_arrow_down\n\n- [1.53.0 (latest)](/php/docs/reference/cloud-firestore/latest/V1.ExistenceFilter)\n- [1.52.0](/php/docs/reference/cloud-firestore/1.52.0/V1.ExistenceFilter)\n- [1.51.0](/php/docs/reference/cloud-firestore/1.51.0/V1.ExistenceFilter)\n- [1.50.0](/php/docs/reference/cloud-firestore/1.50.0/V1.ExistenceFilter)\n- [1.48.1](/php/docs/reference/cloud-firestore/1.48.1/V1.ExistenceFilter)\n- [1.47.3](/php/docs/reference/cloud-firestore/1.47.3/V1.ExistenceFilter)\n- [1.46.0](/php/docs/reference/cloud-firestore/1.46.0/V1.ExistenceFilter)\n- [1.45.2](/php/docs/reference/cloud-firestore/1.45.2/V1.ExistenceFilter)\n- [1.44.1](/php/docs/reference/cloud-firestore/1.44.1/V1.ExistenceFilter)\n- [1.43.3](/php/docs/reference/cloud-firestore/1.43.3/V1.ExistenceFilter)\n- [1.40.0](/php/docs/reference/cloud-firestore/1.40.0/V1.ExistenceFilter)\n- [1.39.0](/php/docs/reference/cloud-firestore/1.39.0/V1.ExistenceFilter)\n- [1.38.0](/php/docs/reference/cloud-firestore/1.38.0/V1.ExistenceFilter)\n- [1.37.7](/php/docs/reference/cloud-firestore/1.37.7/V1.ExistenceFilter)\n- [1.36.1](/php/docs/reference/cloud-firestore/1.36.1/V1.ExistenceFilter)\n- [1.35.0](/php/docs/reference/cloud-firestore/1.35.0/V1.ExistenceFilter)\n- [1.34.0](/php/docs/reference/cloud-firestore/1.34.0/V1.ExistenceFilter)\n- [1.33.0](/php/docs/reference/cloud-firestore/1.33.0/V1.ExistenceFilter)\n- [1.32.0](/php/docs/reference/cloud-firestore/1.32.0/V1.ExistenceFilter)\n- [1.31.0](/php/docs/reference/cloud-firestore/1.31.0/V1.ExistenceFilter)\n- [1.30.0](/php/docs/reference/cloud-firestore/1.30.0/V1.ExistenceFilter)\n- [1.28.0](/php/docs/reference/cloud-firestore/1.28.0/V1.ExistenceFilter)\n- [1.27.3](/php/docs/reference/cloud-firestore/1.27.3/V1.ExistenceFilter) \nReference documentation and code samples for the Cloud Firestore V1 Client class ExistenceFilter.\n\nA digest of all the documents that match a given target.\n\nGenerated from protobuf message `google.firestore.v1.ExistenceFilter`\n\nNamespace\n---------\n\nGoogle \\\\ Cloud \\\\ Firestore \\\\ V1\n\nMethods\n-------\n\n### __construct\n\nConstructor.\n\n### getTargetId\n\nThe target ID to which this filter applies.\n\n### setTargetId\n\nThe target ID to which this filter applies.\n\n### getCount\n\nThe total count of documents that match\n[target_id](/php/docs/reference/cloud-firestore/latest/V1.ExistenceFilter#_Google_Cloud_Firestore_V1_ExistenceFilter__getTargetId__).\n\nIf different from the count of documents in the client that match, the\nclient must manually determine which documents no longer match the target.\nThe client can use the `unchanged_names` bloom filter to assist with\nthis determination by testing ALL the document names against the filter;\nif the document name is NOT in the filter, it means the document no\nlonger matches the target.\n\n### setCount\n\nThe total count of documents that match\n[target_id](/php/docs/reference/cloud-firestore/latest/V1.ExistenceFilter#_Google_Cloud_Firestore_V1_ExistenceFilter__getTargetId__).\n\nIf different from the count of documents in the client that match, the\nclient must manually determine which documents no longer match the target.\nThe client can use the `unchanged_names` bloom filter to assist with\nthis determination by testing ALL the document names against the filter;\nif the document name is NOT in the filter, it means the document no\nlonger matches the target.\n\n### getUnchangedNames\n\nA bloom filter that, despite its name, contains the UTF-8 byte encodings of\nthe resource names of ALL the documents that match\n[target_id](/php/docs/reference/cloud-firestore/latest/V1.ExistenceFilter#_Google_Cloud_Firestore_V1_ExistenceFilter__getTargetId__), in the form\n`projects/{project_id}/databases/{database_id}/documents/{document_path}`.\n\nThis bloom filter may be omitted at the server's discretion, such as if it\nis deemed that the client will not make use of it or if it is too\ncomputationally expensive to calculate or transmit. Clients must gracefully\nhandle this field being absent by falling back to the logic used before\nthis field existed; that is, re-add the target without a resume token to\nfigure out which documents in the client's cache are out of sync.\n\n### hasUnchangedNames\n\n### clearUnchangedNames\n\n### setUnchangedNames\n\nA bloom filter that, despite its name, contains the UTF-8 byte encodings of\nthe resource names of ALL the documents that match\n[target_id](/php/docs/reference/cloud-firestore/latest/V1.ExistenceFilter#_Google_Cloud_Firestore_V1_ExistenceFilter__getTargetId__), in the form\n`projects/{project_id}/databases/{database_id}/documents/{document_path}`.\n\nThis bloom filter may be omitted at the server's discretion, such as if it\nis deemed that the client will not make use of it or if it is too\ncomputationally expensive to calculate or transmit. Clients must gracefully\nhandle this field being absent by falling back to the logic used before\nthis field existed; that is, re-add the target without a resume token to\nfigure out which documents in the client's cache are out of sync."]]