Google Cloud Dialogflow v2 API - Class DocumentsClientImpl (4.12.0)

public sealed class DocumentsClientImpl : DocumentsClient

Reference documentation and code samples for the Google Cloud Dialogflow v2 API class DocumentsClientImpl.

Documents client wrapper implementation, for convenient use.

Inheritance

object > DocumentsClient > DocumentsClientImpl

Inherited Members

DocumentsClient.DefaultEndpoint

DocumentsClient.DefaultScopes

DocumentsClient.ServiceMetadata

DocumentsClient.CreateAsync(CancellationToken)

DocumentsClient.Create()

DocumentsClient.ShutdownDefaultChannelsAsync()

DocumentsClient.ListDocuments(string, string, int?, CallSettings)

DocumentsClient.ListDocumentsAsync(string, string, int?, CallSettings)

DocumentsClient.ListDocuments(KnowledgeBaseName, string, int?, CallSettings)

DocumentsClient.ListDocumentsAsync(KnowledgeBaseName, string, int?, CallSettings)

DocumentsClient.GetDocumentAsync(GetDocumentRequest, CancellationToken)

DocumentsClient.GetDocument(string, CallSettings)

DocumentsClient.GetDocumentAsync(string, CallSettings)

DocumentsClient.GetDocumentAsync(string, CancellationToken)

DocumentsClient.GetDocument(DocumentName, CallSettings)

DocumentsClient.GetDocumentAsync(DocumentName, CallSettings)

DocumentsClient.GetDocumentAsync(DocumentName, CancellationToken)

DocumentsClient.CreateDocumentAsync(CreateDocumentRequest, CancellationToken)

DocumentsClient.PollOnceCreateDocument(string, CallSettings)

DocumentsClient.PollOnceCreateDocumentAsync(string, CallSettings)

DocumentsClient.CreateDocument(string, Document, CallSettings)

DocumentsClient.CreateDocumentAsync(string, Document, CallSettings)

DocumentsClient.CreateDocumentAsync(string, Document, CancellationToken)

DocumentsClient.CreateDocument(KnowledgeBaseName, Document, CallSettings)

DocumentsClient.CreateDocumentAsync(KnowledgeBaseName, Document, CallSettings)

DocumentsClient.CreateDocumentAsync(KnowledgeBaseName, Document, CancellationToken)

DocumentsClient.ImportDocumentsAsync(ImportDocumentsRequest, CancellationToken)

DocumentsClient.PollOnceImportDocuments(string, CallSettings)

DocumentsClient.PollOnceImportDocumentsAsync(string, CallSettings)

DocumentsClient.DeleteDocumentAsync(DeleteDocumentRequest, CancellationToken)

DocumentsClient.PollOnceDeleteDocument(string, CallSettings)

DocumentsClient.PollOnceDeleteDocumentAsync(string, CallSettings)

DocumentsClient.DeleteDocument(string, CallSettings)

DocumentsClient.DeleteDocumentAsync(string, CallSettings)

DocumentsClient.DeleteDocumentAsync(string, CancellationToken)

DocumentsClient.DeleteDocument(DocumentName, CallSettings)

DocumentsClient.DeleteDocumentAsync(DocumentName, CallSettings)

DocumentsClient.DeleteDocumentAsync(DocumentName, CancellationToken)

DocumentsClient.UpdateDocumentAsync(UpdateDocumentRequest, CancellationToken)

DocumentsClient.PollOnceUpdateDocument(string, CallSettings)

DocumentsClient.PollOnceUpdateDocumentAsync(string, CallSettings)

DocumentsClient.UpdateDocument(Document, FieldMask, CallSettings)

DocumentsClient.UpdateDocumentAsync(Document, FieldMask, CallSettings)

DocumentsClient.UpdateDocumentAsync(Document, FieldMask, CancellationToken)

DocumentsClient.ReloadDocumentAsync(ReloadDocumentRequest, CancellationToken)

DocumentsClient.PollOnceReloadDocument(string, CallSettings)

DocumentsClient.PollOnceReloadDocumentAsync(string, CallSettings)

DocumentsClient.ReloadDocument(string, string, CallSettings)

DocumentsClient.ReloadDocumentAsync(string, string, CallSettings)

DocumentsClient.ReloadDocumentAsync(string, string, CancellationToken)

DocumentsClient.ReloadDocument(DocumentName, string, CallSettings)

DocumentsClient.ReloadDocumentAsync(DocumentName, string, CallSettings)

DocumentsClient.ReloadDocumentAsync(DocumentName, string, CancellationToken)

DocumentsClient.ExportDocumentAsync(ExportDocumentRequest, CancellationToken)

DocumentsClient.PollOnceExportDocument(string, CallSettings)

DocumentsClient.PollOnceExportDocumentAsync(string, CallSettings)

object.GetHashCode()

object.GetType()

object.ToString()

Namespace

Google.Cloud.Dialogflow.V2

Assembly

Google.Cloud.Dialogflow.V2.dll

Remarks

Service for managing knowledge [Documents][google.cloud.dialogflow.v2.Document].

Constructors

DocumentsClientImpl(DocumentsClient, DocumentsSettings, ILogger)

public DocumentsClientImpl(Documents.DocumentsClient grpcClient, DocumentsSettings settings, ILogger logger)

Constructs a client wrapper for the Documents service, with the specified gRPC client and settings.

Parameters
Name	Description
`grpcClient`	`DocumentsDocumentsClient` The underlying gRPC client.
`settings`	`DocumentsSettings` The base DocumentsSettings used within this client.
`logger`	`ILogger` Optional ILogger to use within this client.

Properties

CreateDocumentOperationsClient

public override OperationsClient CreateDocumentOperationsClient { get; }

The long-running operations client for CreateDocument.

Property Value
Type	Description
`OperationsClient`

Overrides

DocumentsClient.CreateDocumentOperationsClient

DeleteDocumentOperationsClient

public override OperationsClient DeleteDocumentOperationsClient { get; }

The long-running operations client for DeleteDocument.

Property Value
Type	Description
`OperationsClient`

Overrides

DocumentsClient.DeleteDocumentOperationsClient

ExportDocumentOperationsClient

public override OperationsClient ExportDocumentOperationsClient { get; }

The long-running operations client for ExportDocument.

Property Value
Type	Description
`OperationsClient`

Overrides

DocumentsClient.ExportDocumentOperationsClient

GrpcClient

public override Documents.DocumentsClient GrpcClient { get; }

The underlying gRPC Documents client

Property Value
Type	Description
`DocumentsDocumentsClient`

Overrides

DocumentsClient.GrpcClient

ImportDocumentsOperationsClient

public override OperationsClient ImportDocumentsOperationsClient { get; }

The long-running operations client for ImportDocuments.

Property Value
Type	Description
`OperationsClient`

Overrides

DocumentsClient.ImportDocumentsOperationsClient

LocationsClient

public override LocationsClient LocationsClient { get; }

The LocationsClient associated with this client.

Property Value
Type	Description
`LocationsClient`

Overrides

DocumentsClient.LocationsClient

ReloadDocumentOperationsClient

public override OperationsClient ReloadDocumentOperationsClient { get; }

The long-running operations client for ReloadDocument.

Property Value
Type	Description
`OperationsClient`

Overrides

DocumentsClient.ReloadDocumentOperationsClient

UpdateDocumentOperationsClient

public override OperationsClient UpdateDocumentOperationsClient { get; }

The long-running operations client for UpdateDocument.

Property Value
Type	Description
`OperationsClient`

Overrides

DocumentsClient.UpdateDocumentOperationsClient

Methods

CreateDocument(CreateDocumentRequest, CallSettings)

public override Operation<Document, KnowledgeOperationMetadata> CreateDocument(CreateDocumentRequest request, CallSettings callSettings = null)

Creates a new document.

This method is a long-running operation. The returned Operation type has the following method-specific fields:

metadata: [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]
response: [Document][google.cloud.dialogflow.v2.Document]

Parameters
Name	Description
`request`	`CreateDocumentRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`OperationDocumentKnowledgeOperationMetadata`	The RPC response.

Overrides

DocumentsClient.CreateDocument(CreateDocumentRequest, CallSettings)

CreateDocumentAsync(CreateDocumentRequest, CallSettings)

public override Task<Operation<Document, KnowledgeOperationMetadata>> CreateDocumentAsync(CreateDocumentRequest request, CallSettings callSettings = null)

Creates a new document.

This method is a long-running operation. The returned Operation type has the following method-specific fields:

metadata: [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]
response: [Document][google.cloud.dialogflow.v2.Document]

Parameters
Name	Description
`request`	`CreateDocumentRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`TaskOperationDocumentKnowledgeOperationMetadata`	A Task containing the RPC response.

Overrides

DocumentsClient.CreateDocumentAsync(CreateDocumentRequest, CallSettings)

DeleteDocument(DeleteDocumentRequest, CallSettings)

public override Operation<Empty, KnowledgeOperationMetadata> DeleteDocument(DeleteDocumentRequest request, CallSettings callSettings = null)

Deletes the specified document.

This method is a long-running operation. The returned Operation type has the following method-specific fields:

metadata: [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]
response: An Empty message

Parameters
Name	Description
`request`	`DeleteDocumentRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`OperationEmptyKnowledgeOperationMetadata`	The RPC response.

Overrides

DocumentsClient.DeleteDocument(DeleteDocumentRequest, CallSettings)

DeleteDocumentAsync(DeleteDocumentRequest, CallSettings)

public override Task<Operation<Empty, KnowledgeOperationMetadata>> DeleteDocumentAsync(DeleteDocumentRequest request, CallSettings callSettings = null)

Deletes the specified document.

This method is a long-running operation. The returned Operation type has the following method-specific fields:

metadata: [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]
response: An Empty message

Parameters
Name	Description
`request`	`DeleteDocumentRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`TaskOperationEmptyKnowledgeOperationMetadata`	A Task containing the RPC response.

Overrides

DocumentsClient.DeleteDocumentAsync(DeleteDocumentRequest, CallSettings)

ExportDocument(ExportDocumentRequest, CallSettings)

public override Operation<Document, KnowledgeOperationMetadata> ExportDocument(ExportDocumentRequest request, CallSettings callSettings = null)

Exports a smart messaging candidate document into the specified destination.

This method is a long-running operation. The returned Operation type has the following method-specific fields:

metadata: [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]
response: [Document][google.cloud.dialogflow.v2.Document]

Parameters
Name	Description
`request`	`ExportDocumentRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`OperationDocumentKnowledgeOperationMetadata`	The RPC response.

Overrides

DocumentsClient.ExportDocument(ExportDocumentRequest, CallSettings)

ExportDocumentAsync(ExportDocumentRequest, CallSettings)

public override Task<Operation<Document, KnowledgeOperationMetadata>> ExportDocumentAsync(ExportDocumentRequest request, CallSettings callSettings = null)

Exports a smart messaging candidate document into the specified destination.

This method is a long-running operation. The returned Operation type has the following method-specific fields:

metadata: [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]
response: [Document][google.cloud.dialogflow.v2.Document]

Parameters
Name	Description
`request`	`ExportDocumentRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`TaskOperationDocumentKnowledgeOperationMetadata`	A Task containing the RPC response.

Overrides

DocumentsClient.ExportDocumentAsync(ExportDocumentRequest, CallSettings)

GetDocument(GetDocumentRequest, CallSettings)

public override Document GetDocument(GetDocumentRequest request, CallSettings callSettings = null)

Retrieves the specified document.

Parameters
Name	Description
`request`	`GetDocumentRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`Document`	The RPC response.

Overrides

DocumentsClient.GetDocument(GetDocumentRequest, CallSettings)

GetDocumentAsync(GetDocumentRequest, CallSettings)

public override Task<Document> GetDocumentAsync(GetDocumentRequest request, CallSettings callSettings = null)

Retrieves the specified document.

Parameters
Name	Description
`request`	`GetDocumentRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`TaskDocument`	A Task containing the RPC response.

Overrides

DocumentsClient.GetDocumentAsync(GetDocumentRequest, CallSettings)

ImportDocuments(ImportDocumentsRequest, CallSettings)

public override Operation<ImportDocumentsResponse, KnowledgeOperationMetadata> ImportDocuments(ImportDocumentsRequest request, CallSettings callSettings = null)

Creates documents by importing data from external sources. Dialogflow supports up to 350 documents in each request. If you try to import more, Dialogflow will return an error.

This method is a long-running operation. The returned Operation type has the following method-specific fields:

metadata: [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]
response: [ImportDocumentsResponse][google.cloud.dialogflow.v2.ImportDocumentsResponse]

Parameters
Name	Description
`request`	`ImportDocumentsRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`OperationImportDocumentsResponseKnowledgeOperationMetadata`	The RPC response.

Overrides

DocumentsClient.ImportDocuments(ImportDocumentsRequest, CallSettings)

ImportDocumentsAsync(ImportDocumentsRequest, CallSettings)

public override Task<Operation<ImportDocumentsResponse, KnowledgeOperationMetadata>> ImportDocumentsAsync(ImportDocumentsRequest request, CallSettings callSettings = null)

Creates documents by importing data from external sources. Dialogflow supports up to 350 documents in each request. If you try to import more, Dialogflow will return an error.

This method is a long-running operation. The returned Operation type has the following method-specific fields:

metadata: [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]
response: [ImportDocumentsResponse][google.cloud.dialogflow.v2.ImportDocumentsResponse]

Parameters
Name	Description
`request`	`ImportDocumentsRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`TaskOperationImportDocumentsResponseKnowledgeOperationMetadata`	A Task containing the RPC response.

Overrides

DocumentsClient.ImportDocumentsAsync(ImportDocumentsRequest, CallSettings)

ListDocuments(ListDocumentsRequest, CallSettings)

public override PagedEnumerable<ListDocumentsResponse, Document> ListDocuments(ListDocumentsRequest request, CallSettings callSettings = null)

Returns the list of all documents of the knowledge base.

Parameters
Name	Description
`request`	`ListDocumentsRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`PagedEnumerableListDocumentsResponseDocument`	A pageable sequence of Document resources.

Overrides

DocumentsClient.ListDocuments(ListDocumentsRequest, CallSettings)

ListDocumentsAsync(ListDocumentsRequest, CallSettings)

public override PagedAsyncEnumerable<ListDocumentsResponse, Document> ListDocumentsAsync(ListDocumentsRequest request, CallSettings callSettings = null)

Returns the list of all documents of the knowledge base.

Parameters
Name	Description
`request`	`ListDocumentsRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`PagedAsyncEnumerableListDocumentsResponseDocument`	A pageable asynchronous sequence of Document resources.

Overrides

DocumentsClient.ListDocumentsAsync(ListDocumentsRequest, CallSettings)

ReloadDocument(ReloadDocumentRequest, CallSettings)

public override Operation<Document, KnowledgeOperationMetadata> ReloadDocument(ReloadDocumentRequest request, CallSettings callSettings = null)

Reloads the specified document from its specified source, content_uri or content. The previously loaded content of the document will be deleted. Note: Even when the content of the document has not changed, there still may be side effects because of internal implementation changes.

This method is a long-running operation. The returned Operation type has the following method-specific fields:

metadata: [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]
response: [Document][google.cloud.dialogflow.v2.Document]

Note: The projects.agent.knowledgeBases.documents resource is deprecated; only use projects.knowledgeBases.documents.

Parameters
Name	Description
`request`	`ReloadDocumentRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`OperationDocumentKnowledgeOperationMetadata`	The RPC response.

Overrides

DocumentsClient.ReloadDocument(ReloadDocumentRequest, CallSettings)

ReloadDocumentAsync(ReloadDocumentRequest, CallSettings)

public override Task<Operation<Document, KnowledgeOperationMetadata>> ReloadDocumentAsync(ReloadDocumentRequest request, CallSettings callSettings = null)

This method is a long-running operation. The returned Operation type has the following method-specific fields:

metadata: [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]
response: [Document][google.cloud.dialogflow.v2.Document]

Note: The projects.agent.knowledgeBases.documents resource is deprecated; only use projects.knowledgeBases.documents.

Parameters
Name	Description
`request`	`ReloadDocumentRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`TaskOperationDocumentKnowledgeOperationMetadata`	A Task containing the RPC response.

Overrides

DocumentsClient.ReloadDocumentAsync(ReloadDocumentRequest, CallSettings)

UpdateDocument(UpdateDocumentRequest, CallSettings)

public override Operation<Document, KnowledgeOperationMetadata> UpdateDocument(UpdateDocumentRequest request, CallSettings callSettings = null)

Updates the specified document.

This method is a long-running operation. The returned Operation type has the following method-specific fields:

metadata: [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]
response: [Document][google.cloud.dialogflow.v2.Document]

Parameters
Name	Description
`request`	`UpdateDocumentRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`OperationDocumentKnowledgeOperationMetadata`	The RPC response.

Overrides

DocumentsClient.UpdateDocument(UpdateDocumentRequest, CallSettings)

UpdateDocumentAsync(UpdateDocumentRequest, CallSettings)

public override Task<Operation<Document, KnowledgeOperationMetadata>> UpdateDocumentAsync(UpdateDocumentRequest request, CallSettings callSettings = null)

Updates the specified document.

This method is a long-running operation. The returned Operation type has the following method-specific fields:

metadata: [KnowledgeOperationMetadata][google.cloud.dialogflow.v2.KnowledgeOperationMetadata]
response: [Document][google.cloud.dialogflow.v2.Document]

Parameters
Name	Description
`request`	`UpdateDocumentRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`TaskOperationDocumentKnowledgeOperationMetadata`	A Task containing the RPC response.

Overrides

DocumentsClient.UpdateDocumentAsync(UpdateDocumentRequest, CallSettings)