docs(regen): update generate proto documentation (#86)

This PR was generated using Autosynth. 🌈 <details><summary>Log from Synthtool</summary> ``` {synth_log} ``` </details>
googleapis · Mar 10, 2020 · 3e2a860 · 3e2a860
1 parent 2824acd
commit 3e2a860
Show file tree

Hide file tree

Showing 33 changed files with 407 additions and 1,197 deletions.
diff --git a/...oogle-cloud-talent-v4beta1/src/main/java/com/google/cloud/talent/v4beta1/Application.java b/...oogle-cloud-talent-v4beta1/src/main/java/com/google/cloud/talent/v4beta1/Application.java
@@ -941,14 +941,15 @@ public com.google.protobuf.ByteString getProfileBytes() {
    *
    *
    * <pre>
-   * One of either a job or a company is required.
-   * Resource name of the job which the candidate applied for.
+   * Required. Resource name of the job which the candidate applied for.
    * The format is
    * "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}". For example,
    * "projects/foo/tenants/bar/jobs/baz".
    * </pre>
    *
-   * <code>string job = 4 [(.google.api.resource_reference) = { ... }</code>
+   * <code>
+   * string job = 4 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
+   * </code>
    *
    * @return The job.
    */
@@ -967,14 +968,15 @@ public java.lang.String getJob() {
    *
    *
    * <pre>
-   * One of either a job or a company is required.
-   * Resource name of the job which the candidate applied for.
+   * Required. Resource name of the job which the candidate applied for.
    * The format is
    * "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}". For example,
    * "projects/foo/tenants/bar/jobs/baz".
    * </pre>
    *
-   * <code>string job = 4 [(.google.api.resource_reference) = { ... }</code>
+   * <code>
+   * string job = 4 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
+   * </code>
    *
    * @return The bytes for job.
    */
@@ -996,7 +998,6 @@ public com.google.protobuf.ByteString getJobBytes() {
    *
    *
    * <pre>
-   * One of either a job or a company is required.
    * Resource name of the company which the candidate applied for.
    * The format is
    * "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}".
@@ -1022,7 +1023,6 @@ public java.lang.String getCompany() {
    *
    *
    * <pre>
-   * One of either a job or a company is required.
    * Resource name of the company which the candidate applied for.
    * The format is
    * "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}".
@@ -1094,8 +1094,8 @@ public com.google.type.DateOrBuilder getApplicationDateOrBuilder() {
    *
    *
    * <pre>
-   * Required. What is the most recent stage of the application (that is, new, screen,
-   * send cv, hired, finished work)?  This field is intentionally not
+   * Required. What is the most recent stage of the application (that is, new,
+   * screen, send cv, hired, finished work)?  This field is intentionally not
    * comprehensive of every possible status, but instead, represents statuses
    * that would be used to indicate to the ML models good / bad matches.
    * </pre>
@@ -1113,8 +1113,8 @@ public int getStageValue() {
    *
    *
    * <pre>
-   * Required. What is the most recent stage of the application (that is, new, screen,
-   * send cv, hired, finished work)?  This field is intentionally not
+   * Required. What is the most recent stage of the application (that is, new,
+   * screen, send cv, hired, finished work)?  This field is intentionally not
    * comprehensive of every possible status, but instead, represents statuses
    * that would be used to indicate to the ML models good / bad matches.
    * </pre>
@@ -2599,14 +2599,15 @@ public Builder setProfileBytes(com.google.protobuf.ByteString value) {
      *
      *
      * <pre>
-     * One of either a job or a company is required.
-     * Resource name of the job which the candidate applied for.
+     * Required. Resource name of the job which the candidate applied for.
      * The format is
      * "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}". For example,
      * "projects/foo/tenants/bar/jobs/baz".
      * </pre>
      *
-     * <code>string job = 4 [(.google.api.resource_reference) = { ... }</code>
+     * <code>
+     * string job = 4 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
+     * </code>
      *
      * @return The job.
      */
@@ -2625,14 +2626,15 @@ public java.lang.String getJob() {
      *
      *
      * <pre>
-     * One of either a job or a company is required.
-     * Resource name of the job which the candidate applied for.
+     * Required. Resource name of the job which the candidate applied for.
      * The format is
      * "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}". For example,
      * "projects/foo/tenants/bar/jobs/baz".
      * </pre>
      *
-     * <code>string job = 4 [(.google.api.resource_reference) = { ... }</code>
+     * <code>
+     * string job = 4 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
+     * </code>
      *
      * @return The bytes for job.
      */
@@ -2651,14 +2653,15 @@ public com.google.protobuf.ByteString getJobBytes() {
      *
      *
      * <pre>
-     * One of either a job or a company is required.
-     * Resource name of the job which the candidate applied for.
+     * Required. Resource name of the job which the candidate applied for.
      * The format is
      * "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}". For example,
      * "projects/foo/tenants/bar/jobs/baz".
      * </pre>
      *
-     * <code>string job = 4 [(.google.api.resource_reference) = { ... }</code>
+     * <code>
+     * string job = 4 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
+     * </code>
      *
      * @param value The job to set.
      * @return This builder for chaining.
@@ -2676,14 +2679,15 @@ public Builder setJob(java.lang.String value) {
      *
      *
      * <pre>
-     * One of either a job or a company is required.
-     * Resource name of the job which the candidate applied for.
+     * Required. Resource name of the job which the candidate applied for.
      * The format is
      * "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}". For example,
      * "projects/foo/tenants/bar/jobs/baz".
      * </pre>
      *
-     * <code>string job = 4 [(.google.api.resource_reference) = { ... }</code>
+     * <code>
+     * string job = 4 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
+     * </code>
      *
      * @return This builder for chaining.
      */
@@ -2697,14 +2701,15 @@ public Builder clearJob() {
      *
      *
      * <pre>
-     * One of either a job or a company is required.
-     * Resource name of the job which the candidate applied for.
+     * Required. Resource name of the job which the candidate applied for.
      * The format is
      * "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}". For example,
      * "projects/foo/tenants/bar/jobs/baz".
      * </pre>
      *
-     * <code>string job = 4 [(.google.api.resource_reference) = { ... }</code>
+     * <code>
+     * string job = 4 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
+     * </code>
      *
      * @param value The bytes for job to set.
      * @return This builder for chaining.
@@ -2725,7 +2730,6 @@ public Builder setJobBytes(com.google.protobuf.ByteString value) {
      *
      *
      * <pre>
-     * One of either a job or a company is required.
      * Resource name of the company which the candidate applied for.
      * The format is
      * "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}".
@@ -2751,7 +2755,6 @@ public java.lang.String getCompany() {
      *
      *
      * <pre>
-     * One of either a job or a company is required.
      * Resource name of the company which the candidate applied for.
      * The format is
      * "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}".
@@ -2777,7 +2780,6 @@ public com.google.protobuf.ByteString getCompanyBytes() {
      *
      *
      * <pre>
-     * One of either a job or a company is required.
      * Resource name of the company which the candidate applied for.
      * The format is
      * "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}".
@@ -2802,7 +2804,6 @@ public Builder setCompany(java.lang.String value) {
      *
      *
      * <pre>
-     * One of either a job or a company is required.
      * Resource name of the company which the candidate applied for.
      * The format is
      * "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}".
@@ -2823,7 +2824,6 @@ public Builder clearCompany() {
      *
      *
      * <pre>
-     * One of either a job or a company is required.
      * Resource name of the company which the candidate applied for.
      * The format is
      * "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}".
@@ -3028,8 +3028,8 @@ public com.google.type.DateOrBuilder getApplicationDateOrBuilder() {
      *
      *
      * <pre>
-     * Required. What is the most recent stage of the application (that is, new, screen,
-     * send cv, hired, finished work)?  This field is intentionally not
+     * Required. What is the most recent stage of the application (that is, new,
+     * screen, send cv, hired, finished work)?  This field is intentionally not
      * comprehensive of every possible status, but instead, represents statuses
      * that would be used to indicate to the ML models good / bad matches.
      * </pre>
@@ -3047,8 +3047,8 @@ public int getStageValue() {
      *
      *
      * <pre>
-     * Required. What is the most recent stage of the application (that is, new, screen,
-     * send cv, hired, finished work)?  This field is intentionally not
+     * Required. What is the most recent stage of the application (that is, new,
+     * screen, send cv, hired, finished work)?  This field is intentionally not
      * comprehensive of every possible status, but instead, represents statuses
      * that would be used to indicate to the ML models good / bad matches.
      * </pre>
@@ -3069,8 +3069,8 @@ public Builder setStageValue(int value) {
      *
      *
      * <pre>
-     * Required. What is the most recent stage of the application (that is, new, screen,
-     * send cv, hired, finished work)?  This field is intentionally not
+     * Required. What is the most recent stage of the application (that is, new,
+     * screen, send cv, hired, finished work)?  This field is intentionally not
      * comprehensive of every possible status, but instead, represents statuses
      * that would be used to indicate to the ML models good / bad matches.
      * </pre>
@@ -3093,8 +3093,8 @@ public com.google.cloud.talent.v4beta1.Application.ApplicationStage getStage() {
      *
      *
      * <pre>
-     * Required. What is the most recent stage of the application (that is, new, screen,
-     * send cv, hired, finished work)?  This field is intentionally not
+     * Required. What is the most recent stage of the application (that is, new,
+     * screen, send cv, hired, finished work)?  This field is intentionally not
      * comprehensive of every possible status, but instead, represents statuses
      * that would be used to indicate to the ML models good / bad matches.
      * </pre>
@@ -3119,8 +3119,8 @@ public Builder setStage(com.google.cloud.talent.v4beta1.Application.ApplicationS
      *
      *
      * <pre>
-     * Required. What is the most recent stage of the application (that is, new, screen,
-     * send cv, hired, finished work)?  This field is intentionally not
+     * Required. What is the most recent stage of the application (that is, new,
+     * screen, send cv, hired, finished work)?  This field is intentionally not
      * comprehensive of every possible status, but instead, represents statuses
      * that would be used to indicate to the ML models good / bad matches.
      * </pre>

diff --git a/...ud-talent-v4beta1/src/main/java/com/google/cloud/talent/v4beta1/ApplicationOrBuilder.java b/...ud-talent-v4beta1/src/main/java/com/google/cloud/talent/v4beta1/ApplicationOrBuilder.java
@@ -120,14 +120,15 @@ public interface ApplicationOrBuilder
    *
    *
    * <pre>
-   * One of either a job or a company is required.
-   * Resource name of the job which the candidate applied for.
+   * Required. Resource name of the job which the candidate applied for.
    * The format is
    * "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}". For example,
    * "projects/foo/tenants/bar/jobs/baz".
    * </pre>
    *
-   * <code>string job = 4 [(.google.api.resource_reference) = { ... }</code>
+   * <code>
+   * string job = 4 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
+   * </code>
    *
    * @return The job.
    */
@@ -136,14 +137,15 @@ public interface ApplicationOrBuilder
    *
    *
    * <pre>
-   * One of either a job or a company is required.
-   * Resource name of the job which the candidate applied for.
+   * Required. Resource name of the job which the candidate applied for.
    * The format is
    * "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}". For example,
    * "projects/foo/tenants/bar/jobs/baz".
    * </pre>
    *
-   * <code>string job = 4 [(.google.api.resource_reference) = { ... }</code>
+   * <code>
+   * string job = 4 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
+   * </code>
    *
    * @return The bytes for job.
    */
@@ -153,7 +155,6 @@ public interface ApplicationOrBuilder
    *
    *
    * <pre>
-   * One of either a job or a company is required.
    * Resource name of the company which the candidate applied for.
    * The format is
    * "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}".
@@ -169,7 +170,6 @@ public interface ApplicationOrBuilder
    *
    *
    * <pre>
-   * One of either a job or a company is required.
    * Resource name of the company which the candidate applied for.
    * The format is
    * "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}".
@@ -221,8 +221,8 @@ public interface ApplicationOrBuilder
    *
    *
    * <pre>
-   * Required. What is the most recent stage of the application (that is, new, screen,
-   * send cv, hired, finished work)?  This field is intentionally not
+   * Required. What is the most recent stage of the application (that is, new,
+   * screen, send cv, hired, finished work)?  This field is intentionally not
    * comprehensive of every possible status, but instead, represents statuses
    * that would be used to indicate to the ML models good / bad matches.
    * </pre>
@@ -238,8 +238,8 @@ public interface ApplicationOrBuilder
    *
    *
    * <pre>
-   * Required. What is the most recent stage of the application (that is, new, screen,
-   * send cv, hired, finished work)?  This field is intentionally not
+   * Required. What is the most recent stage of the application (that is, new,
+   * screen, send cv, hired, finished work)?  This field is intentionally not
    * comprehensive of every possible status, but instead, represents statuses
    * that would be used to indicate to the ML models good / bad matches.
    * </pre>