company_service_client.rb in google-cloud-talent-0.6.0

- old
+ new

@@ -294,14 +294,12 @@
           #
           # @param parent [String]
           #   Required. Resource name of the tenant under which the company is created.
           #
           #   The format is "projects/{project_id}/tenants/{tenant_id}", for example,
-          #   "projects/api-test-project/tenant/foo".
-          #
-          #   Tenant id is optional and a default tenant is created if unspecified, for
-          #   example, "projects/api-test-project".
+          #   "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant
+          #   is created, for example, "projects/foo".
           # @param company [Google::Cloud::Talent::V4beta1::Company | Hash]
           #   Required. The company to be created.
           #   A hash of the same form as `Google::Cloud::Talent::V4beta1::Company`
           #   can also be provided.
           # @param options [Google::Gax::CallOptions]
@@ -342,11 +340,11 @@
           #
           #   The format is
           #   "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}", for
           #   example, "projects/api-test-project/tenants/foo/companies/bar".
           #
-          #   Tenant id is optional and the default tenant is used if unspecified, for
+          #   If tenant id is unspecified, the default tenant is used, for
           #   example, "projects/api-test-project/companies/bar".
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
           # @yield [result, operation] Access the result along with the RPC operation
@@ -378,12 +376,11 @@
           #   Required. The company resource to replace the current resource in the
           #   system.
           #   A hash of the same form as `Google::Cloud::Talent::V4beta1::Company`
           #   can also be provided.
           # @param update_mask [Google::Protobuf::FieldMask | Hash]
-          #   Optional but strongly recommended for the best service
-          #   experience.
+          #   Strongly recommended for the best service experience.
           #
           #   If
           #   {Google::Cloud::Talent::V4beta1::UpdateCompanyRequest#update_mask update_mask}
           #   is provided, only the specified fields in
           #   {Google::Cloud::Talent::V4beta1::UpdateCompanyRequest#company company} are
@@ -430,14 +427,14 @@
           # @param name [String]
           #   Required. The resource name of the company to be deleted.
           #
           #   The format is
           #   "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}", for
-          #   example, "projects/api-test-project/tenants/foo/companies/bar".
+          #   example, "projects/foo/tenants/bar/companies/baz".
           #
-          #   Tenant id is optional and the default tenant is used if unspecified, for
-          #   example, "projects/api-test-project/companies/bar".
+          #   If tenant id is unspecified, the default tenant is used, for
+          #   example, "projects/foo/companies/bar".
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
           # @yield [result, operation] Access the result along with the RPC operation
           # @yieldparam result []
@@ -466,21 +463,21 @@
           #
           # @param parent [String]
           #   Required. Resource name of the tenant under which the company is created.
           #
           #   The format is "projects/{project_id}/tenants/{tenant_id}", for example,
-          #   "projects/api-test-project/tenant/foo".
+          #   "projects/foo/tenant/bar".
           #
-          #   Tenant id is optional and the default tenant is used if unspecified, for
-          #   example, "projects/api-test-project".
+          #   If tenant id is unspecified, the default tenant will be used, for
+          #   example, "projects/foo".
           # @param page_size [Integer]
           #   The maximum number of resources contained in the underlying API
           #   response. If page streaming is performed per-resource, this
           #   parameter does not affect the return value. If page streaming is
           #   performed per-page, this determines the maximum number of
           #   resources in a page.
           # @param require_open_jobs [true, false]
-          #   Optional. Set to true if the companies requested must have open jobs.
+          #   Set to true if the companies requested must have open jobs.
           #
           #   Defaults to false.
           #
           #   If true, at most
           #   {Google::Cloud::Talent::V4beta1::ListCompaniesRequest#page_size page_size} of