fix(proto): update the asset service proto and comments (#90)

Author: yoshi-automation

packages/google-cloud-asset/protos/google/cloud/asset/v1beta1/asset_service.proto

@@ -40,6 +40,10 @@ service AssetService {
     option (google.api.http) = {
       post: "/v1beta1/{parent=projects/*}:exportAssets"
       body: "*"
+      additional_bindings {
+        post: "/v1beta1/{parent=folders/*}:exportAssets"
+        body: "*"
+      }
       additional_bindings {
         post: "/v1beta1/{parent=organizations/*}:exportAssets"
         body: "*"
@@ -64,20 +68,24 @@ service AssetService {
 
 // Export asset request.
 message ExportAssetsRequest {
-  // Required. The relative name of the root asset. This can only be an organization
-  // number (such as "organizations/123"), a project ID (such as
-  // "projects/my-project-id"), or a project number (such as "projects/12345").
+  // Required. The relative name of the root asset. This can only be an
+  // organization number (such as "organizations/123"), a project ID (such as
+  // "projects/my-project-id"), a project number (such as "projects/12345"), or
+  // a folder number (such as "folders/123").
   string parent = 1;
 
-  // Timestamp to take an asset snapshot. This can only be set to a timestamp in
-  // the past or of the current time. If not specified, the current time will be
-  // used. Due to delays in resource data collection and indexing, there is a
-  // volatile window during which running the same query may get different
-  // results.
+  // Timestamp to take an asset snapshot. This can only be set to a timestamp
+  // between 2018-10-02 UTC (inclusive) and the current time. If not specified,
+  // the current time will be used. Due to delays in resource data collection
+  // and indexing, there is a volatile window during which running the same
+  // query may get different results.
   google.protobuf.Timestamp read_time = 2;
 
   // A list of asset types of which to take a snapshot for. For example:
-  // "google.compute.disk". If specified, only matching assets will be returned.
+  // "google.compute.Disk". If specified, only matching assets will be returned.
+  // See [Introduction to Cloud Asset
+  // Inventory](https://cloud.google.com/resource-manager/docs/cloud-asset-inventory/overview)
+  // for all supported asset types.
   repeated string asset_types = 3;
 
   // Asset content type. If not specified, no content but the asset name will be
@@ -120,9 +128,12 @@ message BatchGetAssetsHistoryRequest {
   // Required. The content type.
   ContentType content_type = 3;
 
-  // Required. The time window for the asset history. The start time is
-  // required. The returned results contain all temporal assets whose time
-  // window overlap with read_time_window.
+  // Optional. The time window for the asset history. Both start_time and
+  // end_time are optional and if set, it must be after 2018-10-02 UTC. If
+  // end_time is not set, it is default to current timestamp. If start_time is
+  // not set, the snapshot of the assets at end_time will be returned. The
+  // returned results contain all temporal assets whose time window overlap with
+  // read_time_window.
   TimeWindow read_time_window = 4;
 }
 
@@ -143,10 +154,15 @@ message OutputConfig {
 
 // A Cloud Storage location.
 message GcsDestination {
-  // The path of the Cloud Storage objects. It's the same path that is used by
-  //  gsutil. For example: "gs://bucket_name/object_path". See [Viewing and Editing Object Metadata](https://cloud.google.com/storage/docs/viewing-editing-metadata)
-  // for more information.
-  string uri = 1;
+  // Required.
+  oneof object_uri {
+    // The uri of the Cloud Storage object. It's the same uri that is used by
+    // gsutil. For example: "gs://bucket_name/object_name". See [Viewing and
+    // Editing Object
+    // Metadata](https://cloud.google.com/storage/docs/viewing-editing-metadata)
+    // for more information.
+    string uri = 1;
+  }
 }
 
 // Asset content type.

packages/google-cloud-asset/protos/google/cloud/asset/v1beta1/assets.proto

@@ -44,12 +44,12 @@ message TemporalAsset {
   Asset asset = 3;
 }
 
-// A time window of [start_time, end_time).
+// A time window of (start_time, end_time].
 message TimeWindow {
-  // Start time of the time window (inclusive).
+  // Start time of the time window (exclusive).
   google.protobuf.Timestamp start_time = 1;
 
-  // End time of the time window (exclusive).
+  // End time of the time window (inclusive).
   // Current timestamp if not specified.
   google.protobuf.Timestamp end_time = 2;
 }
@@ -62,7 +62,7 @@ message Asset {
   // for more information.
   string name = 1;
 
-  // Type of the asset. Example: "google.compute.disk".
+  // Type of the asset. Example: "google.compute.Disk".
   string asset_type = 2;
 
   // Representation of the resource.

packages/google-cloud-asset/src/v1beta1/asset_service_client.js

@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC
+// Copyright 2019 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -220,25 +220,29 @@ class AssetServiceClient {
    * @param {Object} request
    *   The request object that will be sent.
    * @param {string} request.parent
-   *   Required. The relative name of the root asset. This can only be an organization
-   *   number (such as "organizations/123"), a project ID (such as
-   *   "projects/my-project-id"), or a project number (such as "projects/12345").
+   *   Required. The relative name of the root asset. This can only be an
+   *   organization number (such as "organizations/123"), a project ID (such as
+   *   "projects/my-project-id"), a project number (such as "projects/12345"), or
+   *   a folder number (such as "folders/123").
    * @param {Object} request.outputConfig
    *   Required. Output configuration indicating where the results will be output
    *   to. All results will be in newline delimited JSON format.
    *
    *   This object should have the same structure as [OutputConfig]{@link google.cloud.asset.v1beta1.OutputConfig}
    * @param {Object} [request.readTime]
-   *   Timestamp to take an asset snapshot. This can only be set to a timestamp in
-   *   the past or of the current time. If not specified, the current time will be
-   *   used. Due to delays in resource data collection and indexing, there is a
-   *   volatile window during which running the same query may get different
-   *   results.
+   *   Timestamp to take an asset snapshot. This can only be set to a timestamp
+   *   between 2018-10-02 UTC (inclusive) and the current time. If not specified,
+   *   the current time will be used. Due to delays in resource data collection
+   *   and indexing, there is a volatile window during which running the same
+   *   query may get different results.
    *
    *   This object should have the same structure as [Timestamp]{@link google.protobuf.Timestamp}
    * @param {string[]} [request.assetTypes]
    *   A list of asset types of which to take a snapshot for. For example:
-   *   "google.compute.disk". If specified, only matching assets will be returned.
+   *   "google.compute.Disk". If specified, only matching assets will be returned.
+   *   See [Introduction to Cloud Asset
+   *   Inventory](https://cloud.google.com/resource-manager/docs/cloud-asset-inventory/overview)
+   *   for all supported asset types.
    * @param {number} [request.contentType]
    *   Asset content type. If not specified, no content but the asset name will be
    *   returned.
@@ -355,9 +359,12 @@ class AssetServiceClient {
    *
    *   The number should be among the values of [ContentType]{@link google.cloud.asset.v1beta1.ContentType}
    * @param {Object} request.readTimeWindow
-   *   Required. The time window for the asset history. The start time is
-   *   required. The returned results contain all temporal assets whose time
-   *   window overlap with read_time_window.
+   *   Optional. The time window for the asset history. Both start_time and
+   *   end_time are optional and if set, it must be after 2018-10-02 UTC. If
+   *   end_time is not set, it is default to current timestamp. If start_time is
+   *   not set, the snapshot of the assets at end_time will be returned. The
+   *   returned results contain all temporal assets whose time window overlap with
+   *   read_time_window.
    *
    *   This object should have the same structure as [TimeWindow]{@link google.cloud.asset.v1beta1.TimeWindow}
    * @param {string[]} [request.assetNames]

packages/google-cloud-asset/src/v1beta1/doc/google/cloud/asset/v1beta1/doc_asset_service.js

@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC
+// Copyright 2019 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -19,22 +19,26 @@
  * Export asset request.
  *
  * @property {string} parent
- *   Required. The relative name of the root asset. This can only be an organization
- *   number (such as "organizations/123"), a project ID (such as
- *   "projects/my-project-id"), or a project number (such as "projects/12345").
+ *   Required. The relative name of the root asset. This can only be an
+ *   organization number (such as "organizations/123"), a project ID (such as
+ *   "projects/my-project-id"), a project number (such as "projects/12345"), or
+ *   a folder number (such as "folders/123").
  *
  * @property {Object} readTime
- *   Timestamp to take an asset snapshot. This can only be set to a timestamp in
- *   the past or of the current time. If not specified, the current time will be
- *   used. Due to delays in resource data collection and indexing, there is a
- *   volatile window during which running the same query may get different
- *   results.
+ *   Timestamp to take an asset snapshot. This can only be set to a timestamp
+ *   between 2018-10-02 UTC (inclusive) and the current time. If not specified,
+ *   the current time will be used. Due to delays in resource data collection
+ *   and indexing, there is a volatile window during which running the same
+ *   query may get different results.
  *
  *   This object should have the same structure as [Timestamp]{@link google.protobuf.Timestamp}
  *
  * @property {string[]} assetTypes
  *   A list of asset types of which to take a snapshot for. For example:
- *   "google.compute.disk". If specified, only matching assets will be returned.
+ *   "google.compute.Disk". If specified, only matching assets will be returned.
+ *   See [Introduction to Cloud Asset
+ *   Inventory](https://cloud.google.com/resource-manager/docs/cloud-asset-inventory/overview)
+ *   for all supported asset types.
  *
  * @property {number} contentType
  *   Asset content type. If not specified, no content but the asset name will be
@@ -103,9 +107,12 @@ const ExportAssetsResponse = {
  *   The number should be among the values of [ContentType]{@link google.cloud.asset.v1beta1.ContentType}
  *
  * @property {Object} readTimeWindow
- *   Required. The time window for the asset history. The start time is
- *   required. The returned results contain all temporal assets whose time
- *   window overlap with read_time_window.
+ *   Optional. The time window for the asset history. Both start_time and
+ *   end_time are optional and if set, it must be after 2018-10-02 UTC. If
+ *   end_time is not set, it is default to current timestamp. If start_time is
+ *   not set, the snapshot of the assets at end_time will be returned. The
+ *   returned results contain all temporal assets whose time window overlap with
+ *   read_time_window.
  *
  *   This object should have the same structure as [TimeWindow]{@link google.cloud.asset.v1beta1.TimeWindow}
  *
@@ -153,8 +160,10 @@ const OutputConfig = {
  * A Cloud Storage location.
  *
  * @property {string} uri
- *   The path of the Cloud Storage objects. It's the same path that is used by
- *    gsutil. For example: "gs://bucket_name/object_path". See [Viewing and Editing Object Metadata](https://cloud.google.com/storage/docs/viewing-editing-metadata)
+ *   The uri of the Cloud Storage object. It's the same uri that is used by
+ *   gsutil. For example: "gs://bucket_name/object_name". See [Viewing and
+ *   Editing Object
+ *   Metadata](https://cloud.google.com/storage/docs/viewing-editing-metadata)
  *   for more information.
  *
  * @typedef GcsDestination

packages/google-cloud-asset/src/v1beta1/doc/google/cloud/asset/v1beta1/doc_assets.js

@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC
+// Copyright 2019 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -41,15 +41,15 @@ const TemporalAsset = {
 };
 
 /**
- * A time window of [start_time, end_time).
+ * A time window of (start_time, end_time].
  *
  * @property {Object} startTime
- *   Start time of the time window (inclusive).
+ *   Start time of the time window (exclusive).
  *
  *   This object should have the same structure as [Timestamp]{@link google.protobuf.Timestamp}
  *
  * @property {Object} endTime
- *   End time of the time window (exclusive).
+ *   End time of the time window (inclusive).
  *   Current timestamp if not specified.
  *
  *   This object should have the same structure as [Timestamp]{@link google.protobuf.Timestamp}
@@ -72,7 +72,7 @@ const TimeWindow = {
  *   for more information.
  *
  * @property {string} assetType
- *   Type of the asset. Example: "google.compute.disk".
+ *   Type of the asset. Example: "google.compute.Disk".
  *
  * @property {Object} resource
  *   Representation of the resource.
@@ -141,4 +141,4 @@ const Asset = {
  */
 const Resource = {
   // This is for documentation. Actual contents will be loaded by gRPC.
-};
+};

packages/google-cloud-asset/src/v1beta1/doc/google/iam/v1/doc_policy.js

@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC
+// Copyright 2019 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

packages/google-cloud-asset/src/v1beta1/doc/google/longrunning/doc_operations.js

@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC
+// Copyright 2019 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

packages/google-cloud-asset/src/v1beta1/doc/google/protobuf/doc_any.js

@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC
+// Copyright 2019 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

packages/google-cloud-asset/src/v1beta1/doc/google/protobuf/doc_struct.js

@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC
+// Copyright 2019 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

packages/google-cloud-asset/src/v1beta1/doc/google/protobuf/doc_timestamp.js

@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC
+// Copyright 2019 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.