docs(regen): regenerate with update proto documentation (#76)

googleapis · Feb 4, 2020 · 867a187 · 867a187
1 parent 3df377b
commit 867a187
Show file tree

Hide file tree

Showing 8 changed files with 184 additions and 123 deletions.
diff --git a/...cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/DetectIntentRequest.java b/...cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/DetectIntentRequest.java
@@ -22,6 +22,8 @@
  *
  *
  * <pre>
+ * ============================================================================
+ * Requests and responses for custom methods.
  * The request to detect user's intent.
  * </pre>
  *
@@ -178,7 +180,9 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    * ID must not exceed 36 bytes.
    * </pre>
    *
-   * <code>string session = 1 [(.google.api.field_behavior) = REQUIRED];</code>
+   * <code>
+   * string session = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
+   * </code>
    *
    * @return The session.
    */
@@ -204,7 +208,9 @@ public java.lang.String getSession() {
    * ID must not exceed 36 bytes.
    * </pre>
    *
-   * <code>string session = 1 [(.google.api.field_behavior) = REQUIRED];</code>
+   * <code>
+   * string session = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
+   * </code>
    *
    * @return The bytes for session.
    */
@@ -624,6 +630,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * <pre>
+   * ============================================================================
+   * Requests and responses for custom methods.
    * The request to detect user's intent.
    * </pre>
    *
@@ -839,7 +847,9 @@ public Builder mergeFrom(
      * ID must not exceed 36 bytes.
      * </pre>
      *
-     * <code>string session = 1 [(.google.api.field_behavior) = REQUIRED];</code>
+     * <code>
+     * string session = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
+     * </code>
      *
      * @return The session.
      */
@@ -865,7 +875,9 @@ public java.lang.String getSession() {
      * ID must not exceed 36 bytes.
      * </pre>
      *
-     * <code>string session = 1 [(.google.api.field_behavior) = REQUIRED];</code>
+     * <code>
+     * string session = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
+     * </code>
      *
      * @return The bytes for session.
      */
@@ -891,7 +903,9 @@ public com.google.protobuf.ByteString getSessionBytes() {
      * ID must not exceed 36 bytes.
      * </pre>
      *
-     * <code>string session = 1 [(.google.api.field_behavior) = REQUIRED];</code>
+     * <code>
+     * string session = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
+     * </code>
      *
      * @param value The session to set.
      * @return This builder for chaining.
@@ -916,7 +930,9 @@ public Builder setSession(java.lang.String value) {
      * ID must not exceed 36 bytes.
      * </pre>
      *
-     * <code>string session = 1 [(.google.api.field_behavior) = REQUIRED];</code>
+     * <code>
+     * string session = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
+     * </code>
      *
      * @return This builder for chaining.
      */
@@ -937,7 +953,9 @@ public Builder clearSession() {
      * ID must not exceed 36 bytes.
      * </pre>
      *
-     * <code>string session = 1 [(.google.api.field_behavior) = REQUIRED];</code>
+     * <code>
+     * string session = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
+     * </code>
      *
      * @param value The bytes for session to set.
      * @return This builder for chaining.

diff --git a/...logflow-v2/src/main/java/com/google/cloud/dialogflow/v2/DetectIntentRequestOrBuilder.java b/...logflow-v2/src/main/java/com/google/cloud/dialogflow/v2/DetectIntentRequestOrBuilder.java
@@ -34,7 +34,9 @@ public interface DetectIntentRequestOrBuilder
    * ID must not exceed 36 bytes.
    * </pre>
    *
-   * <code>string session = 1 [(.google.api.field_behavior) = REQUIRED];</code>
+   * <code>
+   * string session = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
+   * </code>
    *
    * @return The session.
    */
@@ -50,7 +52,9 @@ public interface DetectIntentRequestOrBuilder
    * ID must not exceed 36 bytes.
    * </pre>
    *
-   * <code>string session = 1 [(.google.api.field_behavior) = REQUIRED];</code>
+   * <code>
+   * string session = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
+   * </code>
    *
    * @return The bytes for session.
    */

diff --git a/...google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/SessionProto.java b/...google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/SessionProto.java
diff --git a/proto-google-cloud-dialogflow-v2/src/main/proto/google/cloud/dialogflow/v2/session.proto b/proto-google-cloud-dialogflow-v2/src/main/proto/google/cloud/dialogflow/v2/session.proto
@@ -20,6 +20,7 @@ package google.cloud.dialogflow.v2;
 import "google/api/annotations.proto";
 import "google/api/client.proto";
 import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/cloud/dialogflow/v2/audio_config.proto";
 import "google/cloud/dialogflow/v2/context.proto";
 import "google/cloud/dialogflow/v2/intent.proto";
@@ -36,6 +37,11 @@ option java_multiple_files = true;
 option java_outer_classname = "SessionProto";
 option java_package = "com.google.cloud.dialogflow.v2";
 option objc_class_prefix = "DF";
+option (google.api.resource_definition) = {
+  type: "dialogflow.googleapis.com/Session"
+  pattern: "projects/{project}/locations/{location}/agent/sessions/{session}"
+  pattern: "projects/{project}/agent/sessions/{session}"
+};
 
 // A session represents an interaction with a user. You retrieve user input
 // and pass it to the [DetectIntent][google.cloud.dialogflow.v2.Sessions.DetectIntent] (or
@@ -66,14 +72,21 @@ service Sessions {
   }
 }
 
+// ============================================================================
+// Requests and responses for custom methods.
 // The request to detect user's intent.
 message DetectIntentRequest {
   // Required. The name of the session this query is sent to. Format:
   // `projects/<Project ID>/agent/sessions/<Session ID>`. It's up to the API
   // caller to choose an appropriate session ID. It can be a random number or
   // some type of user identifier (preferably hashed). The length of the session
   // ID must not exceed 36 bytes.
-  string session = 1 [(google.api.field_behavior) = REQUIRED];
+  string session = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "dialogflow.googleapis.com/Session"
+    }
+  ];
 
   // Optional. The parameters of this query.
   QueryParameters query_params = 2 [(google.api.field_behavior) = OPTIONAL];

diff --git a/...ogflow-v2beta1/src/main/java/com/google/cloud/dialogflow/v2beta1/DetectIntentRequest.java b/...ogflow-v2beta1/src/main/java/com/google/cloud/dialogflow/v2beta1/DetectIntentRequest.java
@@ -22,6 +22,8 @@
  *
  *
  * <pre>
+ * ============================================================================
+ * Requests and responses for custom methods.
  * The request to detect user's intent.
  * </pre>
  *
@@ -618,6 +620,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * <pre>
+   * ============================================================================
+   * Requests and responses for custom methods.
    * The request to detect user's intent.
    * </pre>
    *

diff --git a/...ud-dialogflow-v2beta1/src/main/java/com/google/cloud/dialogflow/v2beta1/SessionProto.java b/...ud-dialogflow-v2beta1/src/main/java/com/google/cloud/dialogflow/v2beta1/SessionProto.java
@@ -237,12 +237,16 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "treamingDetectIntentResponse\"\000(\0010\001\032x\312A\031d"
           + "ialogflow.googleapis.com\322AYhttps://www.g"
           + "oogleapis.com/auth/cloud-platform,https:"
-          + "//www.googleapis.com/auth/dialogflowB\252\001\n"
+          + "//www.googleapis.com/auth/dialogflowB\300\002\n"
           + "#com.google.cloud.dialogflow.v2beta1B\014Se"
           + "ssionProtoP\001ZIgoogle.golang.org/genproto"
           + "/googleapis/cloud/dialogflow/v2beta1;dia"
           + "logflow\370\001\001\242\002\002DF\252\002\037Google.Cloud.Dialogflo"
-          + "w.V2beta1b\006proto3"
+          + "w.V2beta1\352A\222\001\n!dialogflow.googleapis.com"
+          + "/Session\022@projects/{project}/locations/{"
+          + "location}/agent/sessions/{session}\022+proj"
+          + "ects/{project}/agent/sessions/{session}b"
+          + "\006proto3"
     };
     descriptor =
         com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom(
@@ -444,6 +448,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
     registry.add(com.google.api.ClientProto.defaultHost);
     registry.add(com.google.api.AnnotationsProto.http);
     registry.add(com.google.api.ClientProto.oauthScopes);
+    registry.add(com.google.api.ResourceProto.resourceDefinition);
     registry.add(com.google.api.ResourceProto.resourceReference);
     com.google.protobuf.Descriptors.FileDescriptor.internalUpdateFileDescriptor(
         descriptor, registry);

diff --git a/...gle-cloud-dialogflow-v2beta1/src/main/proto/google/cloud/dialogflow/v2beta1/session.proto b/...gle-cloud-dialogflow-v2beta1/src/main/proto/google/cloud/dialogflow/v2beta1/session.proto
@@ -38,6 +38,11 @@ option java_multiple_files = true;
 option java_outer_classname = "SessionProto";
 option java_package = "com.google.cloud.dialogflow.v2beta1";
 option objc_class_prefix = "DF";
+option (google.api.resource_definition) = {
+  type: "dialogflow.googleapis.com/Session"
+  pattern: "projects/{project}/locations/{location}/agent/sessions/{session}"
+  pattern: "projects/{project}/agent/sessions/{session}"
+};
 
 // A session represents an interaction with a user. You retrieve user input
 // and pass it to the [DetectIntent][google.cloud.dialogflow.v2beta1.Sessions.DetectIntent] (or
@@ -79,6 +84,8 @@ service Sessions {
   }
 }
 
+// ============================================================================
+// Requests and responses for custom methods.
 // The request to detect user's intent.
 message DetectIntentRequest {
   // Required. The name of the session this query is sent to. Format:

diff --git a/synth.metadata b/synth.metadata
@@ -1,5 +1,5 @@
 {
-  "updateTime": "2020-02-01T08:47:10.504450Z",
+  "updateTime": "2020-02-04T08:47:20.781325Z",
   "sources": [
     {
       "generator": {
@@ -12,9 +12,9 @@
       "git": {
         "name": "googleapis",
         "remote": "https://github.com/googleapis/googleapis.git",
-        "sha": "b5cbe4a4ba64ab19e6627573ff52057a1657773d",
-        "internalRef": "292647187",
-        "log": "b5cbe4a4ba64ab19e6627573ff52057a1657773d\nSecurityCenter v1p1beta1: move file-level option on top to workaround protobuf.js bug.\n\nPiperOrigin-RevId: 292647187\n\nb224b317bf20c6a4fbc5030b4a969c3147f27ad3\nAdds API definitions for bigqueryreservation v1beta1.\n\nPiperOrigin-RevId: 292634722\n\nc1468702f9b17e20dd59007c0804a089b83197d2\nSynchronize new proto/yaml changes.\n\nPiperOrigin-RevId: 292626173\n\nffdfa4f55ab2f0afc11d0eb68f125ccbd5e404bd\nvision: v1p3beta1 publish annotations and retry config\n\nPiperOrigin-RevId: 292605599\n\n78f61482cd028fc1d9892aa5d89d768666a954cd\nvision: v1p1beta1 publish annotations and retry config\n\nPiperOrigin-RevId: 292605125\n\n60bb5a294a604fd1778c7ec87b265d13a7106171\nvision: v1p2beta1 publish annotations and retry config\n\nPiperOrigin-RevId: 292604980\n\n3bcf7aa79d45eb9ec29ab9036e9359ea325a7fc3\nvision: v1p4beta1 publish annotations and retry config\n\nPiperOrigin-RevId: 292604656\n\n2717b8a1c762b26911b45ecc2e4ee01d98401b28\nFix dataproc artman client library generation.\n\nPiperOrigin-RevId: 292555664\n\n"
+        "sha": "69d9945330a5721cd679f17331a78850e2618226",
+        "internalRef": "293080182",
+        "log": "69d9945330a5721cd679f17331a78850e2618226\nAdd file-level `Session` resource definition\n\nPiperOrigin-RevId: 293080182\n\nf6a1a6b417f39694275ca286110bc3c1ca4db0dc\nAdd file-level `Session` resource definition\n\nPiperOrigin-RevId: 293080178\n\n29d40b78e3dc1579b0b209463fbcb76e5767f72a\nExpose managedidentities/v1beta1/ API for client library usage.\n\nPiperOrigin-RevId: 292979741\n\na22129a1fb6e18056d576dfb7717aef74b63734a\nExpose managedidentities/v1/ API for client library usage.\n\nPiperOrigin-RevId: 292968186\n\n"
       }
     },
     {