docs: Update doc on ReloadDocument method. (#358)

PiperOrigin-RevId: 341467342

Source-Author: Google APIs <noreply@google.com>
Source-Date: Mon Nov 9 12:58:04 2020 -0800
Source-Repo: googleapis/googleapis
Source-Sha: a830e5d735942a23107840dae8c69eb18b1ea085
Source-Link: googleapis/googleapis@a830e5d

google-cloud-dialogflow/src/main/java/com/google/cloud/dialogflow/v2beta1/DocumentsClient.java

@@ -854,7 +854,9 @@ public final UnaryCallable<UpdateDocumentRequest, Operation> updateDocumentCalla
    * 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.
+   * 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.
    *
    * <p>Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use
    * `projects.knowledgeBases.documents`.
@@ -892,7 +894,9 @@ public final OperationFuture<Document, KnowledgeOperationMetadata> reloadDocumen
    * 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.
+   * 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.
    *
    * <p>Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use
    * `projects.knowledgeBases.documents`.
@@ -927,7 +931,9 @@ public final OperationFuture<Document, KnowledgeOperationMetadata> reloadDocumen
    * 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.
+   * 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.
    *
    * <p>Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use
    * `projects.knowledgeBases.documents`.
@@ -959,7 +965,9 @@ public final OperationFuture<Document, KnowledgeOperationMetadata> reloadDocumen
    * 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.
+   * 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.
    *
    * <p>Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use
    * `projects.knowledgeBases.documents`.
@@ -989,7 +997,9 @@ public final OperationFuture<Document, KnowledgeOperationMetadata> reloadDocumen
    * 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.
+   * 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.
    *
    * <p>Note: The `projects.agent.knowledgeBases.documents` resource is deprecated; only use
    * `projects.knowledgeBases.documents`.

grpc-google-cloud-dialogflow-v2beta1/src/main/java/com/google/cloud/dialogflow/v2beta1/DocumentsGrpc.java

@@ -444,6 +444,9 @@ public void updateDocument(
      * 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.
      * Note: The `projects.agent.knowledgeBases.documents` resource is deprecated;
      * only use `projects.knowledgeBases.documents`.
      * </pre>
@@ -615,6 +618,9 @@ public void updateDocument(
      * 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.
      * Note: The `projects.agent.knowledgeBases.documents` resource is deprecated;
      * only use `projects.knowledgeBases.documents`.
      * </pre>
@@ -726,6 +732,9 @@ public com.google.longrunning.Operation updateDocument(
      * 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.
      * Note: The `projects.agent.knowledgeBases.documents` resource is deprecated;
      * only use `projects.knowledgeBases.documents`.
      * </pre>
@@ -839,6 +848,9 @@ protected DocumentsFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions
      * 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.
      * Note: The `projects.agent.knowledgeBases.documents` resource is deprecated;
      * only use `projects.knowledgeBases.documents`.
      * </pre>

proto-google-cloud-dialogflow-v2beta1/src/main/proto/google/cloud/dialogflow/v2beta1/document.proto

@@ -133,6 +133,9 @@ service Documents {
   // 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.
   //
   // Note: The `projects.agent.knowledgeBases.documents` resource is deprecated;
   // only use `projects.knowledgeBases.documents`.

synth.metadata

@@ -11,16 +11,16 @@
       "git": {
         "name": "googleapis",
         "remote": "https://github.com/googleapis/googleapis.git",
-        "sha": "516017a89c1fbaf3f6ceb461170b9ff8aa952b05",
-        "internalRef": "339508652"
+        "sha": "a830e5d735942a23107840dae8c69eb18b1ea085",
+        "internalRef": "341467342"
       }
     },
     {
       "git": {
         "name": "googleapis",
         "remote": "https://github.com/googleapis/googleapis.git",
-        "sha": "516017a89c1fbaf3f6ceb461170b9ff8aa952b05",
-        "internalRef": "339508652"
+        "sha": "a830e5d735942a23107840dae8c69eb18b1ea085",
+        "internalRef": "341467342"
       }
     },
     {