public sealed class Target : IMessage<Target>, IEquatable<Target>, IDeepCloneable<Target>, IBufferMessage, IMessage
Reference documentation and code samples for the Firestore v1 API class Target.
A specification of a set of documents to listen to.
Namespace
Google.Cloud.Firestore.V1Assembly
Google.Cloud.Firestore.V1.dll
Constructors
Target()
public Target()
Target(Target)
public Target(Target other)
Parameter | |
---|---|
Name | Description |
other | Target |
Properties
Documents
public Target.Types.DocumentsTarget Documents { get; set; }
A target specified by a set of document names.
Property Value | |
---|---|
Type | Description |
TargetTypesDocumentsTarget |
ExpectedCount
public int? ExpectedCount { get; set; }
The number of documents that last matched the query at the resume token or read time.
This value is only relevant when a resume_type
is provided. This value
being present and greater than zero signals that the client wants
ExistenceFilter.unchanged_names
to be included in the response.
Property Value | |
---|---|
Type | Description |
int |
HasResumeToken
public bool HasResumeToken { get; }
Gets whether the "resume_token" field is set
Property Value | |
---|---|
Type | Description |
bool |
Once
public bool Once { get; set; }
If the target should be removed once it is current and consistent.
Property Value | |
---|---|
Type | Description |
bool |
Query
public Target.Types.QueryTarget Query { get; set; }
A target specified by a query.
Property Value | |
---|---|
Type | Description |
TargetTypesQueryTarget |
ReadTime
public Timestamp ReadTime { get; set; }
Start listening after a specific read_time
.
The client must know the state of matching documents at this time.
Property Value | |
---|---|
Type | Description |
Timestamp |
ResumeToken
public ByteString ResumeToken { get; set; }
A resume token from a prior [TargetChange][google.firestore.v1.TargetChange] for an identical target.
Using a resume token with a different target is unsupported and may fail.
Property Value | |
---|---|
Type | Description |
ByteString |
ResumeTypeCase
public Target.ResumeTypeOneofCase ResumeTypeCase { get; }
Property Value | |
---|---|
Type | Description |
TargetResumeTypeOneofCase |
TargetId
public int TargetId { get; set; }
The target ID that identifies the target on the stream. Must be a positive number and non-zero.
If target_id
is 0 (or unspecified), the server will assign an ID for this
target and return that in a TargetChange::ADD
event. Once a target with
target_id=0
is added, all subsequent targets must also have
target_id=0
. If an AddTarget
request with target_id != 0
is
sent to the server after a target with target_id=0
is added, the server
will immediately send a response with a TargetChange::Remove
event.
Note that if the client sends multiple AddTarget
requests
without an ID, the order of IDs returned in TargetChage.target_ids
are
undefined. Therefore, clients should provide a target ID instead of relying
on the server to assign one.
If target_id
is non-zero, there must not be an existing active target on
this stream with the same ID.
Property Value | |
---|---|
Type | Description |
int |
TargetTypeCase
public Target.TargetTypeOneofCase TargetTypeCase { get; }
Property Value | |
---|---|
Type | Description |
TargetTargetTypeOneofCase |