Google Cloud Dialogflow v2beta1 API - Class DocumentsClientImpl (1.0.0-beta14)

Version 1.0.0-beta14

• 1.0.0-beta21 (latest)
• 1.0.0-beta20

public sealed class DocumentsClientImpl : DocumentsClient

Reference documentation and code samples for the Google Cloud Dialogflow v2beta1 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.UpdateDocument(Document, CallSettings)

DocumentsClient.UpdateDocumentAsync(Document, CallSettings)

DocumentsClient.UpdateDocumentAsync(Document, CancellationToken)

DocumentsClient.ReloadDocumentAsync(ReloadDocumentRequest, CancellationToken)

DocumentsClient.PollOnceReloadDocument(string, CallSettings)

DocumentsClient.PollOnceReloadDocumentAsync(string, CallSettings)

DocumentsClient.ReloadDocument(string, GcsSource, CallSettings)

DocumentsClient.ReloadDocumentAsync(string, GcsSource, CallSettings)

DocumentsClient.ReloadDocumentAsync(string, GcsSource, CancellationToken)

DocumentsClient.ReloadDocument(DocumentName, GcsSource, CallSettings)

DocumentsClient.ReloadDocumentAsync(DocumentName, GcsSource, CallSettings)

DocumentsClient.ReloadDocumentAsync(DocumentName, GcsSource, CancellationToken)

object.GetHashCode()

object.GetType()

object.ToString()

Namespace

Google.Cloud.Dialogflow.V2Beta1

Assembly

Google.Cloud.Dialogflow.V2Beta1.dll

Remarks

Service for managing knowledge [Documents][google.cloud.dialogflow.v2beta1.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

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.v2beta1.KnowledgeOperationMetadata]
• response: [Document][google.cloud.dialogflow.v2beta1.Document]

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

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.v2beta1.KnowledgeOperationMetadata]
• response: [Document][google.cloud.dialogflow.v2beta1.Document]

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

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.v2beta1.KnowledgeOperationMetadata]
• response: An Empty message

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

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.v2beta1.KnowledgeOperationMetadata]
• response: An Empty message

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

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)

GetDocument(GetDocumentRequest, CallSettings)

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

Retrieves the specified document.

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

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.

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

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)

Create 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.v2beta1.KnowledgeOperationMetadata]
• response: [ImportDocumentsResponse][google.cloud.dialogflow.v2beta1.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)

Create 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.v2beta1.KnowledgeOperationMetadata]
• response: [ImportDocumentsResponse][google.cloud.dialogflow.v2beta1.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.

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

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.

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

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. Note: If the document source is Google Cloud Storage URI, its metadata will be replaced with the custom metadata from Google Cloud Storage if the import_gcs_custom_metadata field is set to true in the request.

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

• metadata: [KnowledgeOperationMetadata][google.cloud.dialogflow.v2beta1.KnowledgeOperationMetadata]
• response: [Document][google.cloud.dialogflow.v2beta1.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)

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. Note: If the document source is Google Cloud Storage URI, its metadata will be replaced with the custom metadata from Google Cloud Storage if the import_gcs_custom_metadata field is set to true in the request.

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

• metadata: [KnowledgeOperationMetadata][google.cloud.dialogflow.v2beta1.KnowledgeOperationMetadata]
• response: [Document][google.cloud.dialogflow.v2beta1.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.v2beta1.KnowledgeOperationMetadata]
• response: [Document][google.cloud.dialogflow.v2beta1.Document]

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

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.v2beta1.KnowledgeOperationMetadata]
• response: [Document][google.cloud.dialogflow.v2beta1.Document]

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

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)