feat:added mosaic layout docs:clarified alignment_period max value and updated IAM docs link (#152)

* feat:added mosaic layout docs:clarified alignment_period max value and updated IAM docs link

PiperOrigin-RevId: 362979558

Source-Author: Google APIs <[email protected]>
Source-Date: Mon Mar 15 10:55:19 2021 -0700
Source-Repo: googleapis/googleapis
Source-Sha: 0dafa3963ef6fcb8a7f5daaa4bec12adb04de518
Source-Link: googleapis/googleapis@0dafa39

* build: update links from relative to absolute to pass docs tests

PiperOrigin-RevId: 363712862

Source-Author: Google APIs <[email protected]>
Source-Date: Thu Mar 18 12:06:46 2021 -0700
Source-Repo: googleapis/googleapis
Source-Sha: 4f5e3aeabb80833f0cfd6dd570a7b18787d3a844
Source-Link: googleapis/googleapis@4f5e3ae

Author: yoshi-automation

packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/common.proto

@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2021 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -316,6 +316,8 @@ message Aggregation {
   // `ALIGN_NONE` is specified, this field is required or an error is returned.
   // If no per-series aligner is specified, or the aligner `ALIGN_NONE` is
   // specified, then this field is ignored.
+  //
+  // The maximum value of the `alignment_period` is 2 years, or 104 weeks.
   google.protobuf.Duration alignment_period = 1;
 
   // An `Aligner` describes how to bring the data points in a single

packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/dashboard.proto

@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2021 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -55,6 +55,10 @@ message Dashboard {
     // informational elements like widgets or tiles.
     GridLayout grid_layout = 5;
 
+    // The content is arranged as a grid of tiles, with each content widget
+    // occupying one or more grid blocks.
+    MosaicLayout mosaic_layout = 6;
+
     // The content is divided into equally spaced rows and the widgets are
     // arranged horizontally.
     RowLayout row_layout = 8;

packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/dashboards_service.proto

@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2021 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -40,11 +40,8 @@ service DashboardsService {
       "https://www.googleapis.com/auth/monitoring.read,"
       "https://www.googleapis.com/auth/monitoring.write";
 
-  // Creates a new custom dashboard.
-  //
-  // This method requires the `monitoring.dashboards.create` permission
-  // on the specified project. For more information, see
-  // [Google Cloud IAM](https://cloud.google.com/iam).
+  // Creates a new custom dashboard. For examples on how you can use this API to create dashboards, see [Managing dashboards by API](https://cloud.google.com/monitoring/dashboards/api-dashboard).
+  // This method requires the `monitoring.dashboards.create` permission on the specified project. For more information about permissions, see [Cloud Identity and Access Management](https://cloud.google.com/iam).
   rpc CreateDashboard(CreateDashboardRequest) returns (Dashboard) {
     option (google.api.http) = {
       post: "/v1/{parent=projects/*}/dashboards"
@@ -56,7 +53,7 @@ service DashboardsService {
   //
   // This method requires the `monitoring.dashboards.list` permission
   // on the specified project. For more information, see
-  // [Google Cloud IAM](https://cloud.google.com/iam).
+  // [Cloud Identity and Access Management](https://cloud.google.com/iam).
   rpc ListDashboards(ListDashboardsRequest) returns (ListDashboardsResponse) {
     option (google.api.http) = {
       get: "/v1/{parent=projects/*}/dashboards"
@@ -67,7 +64,7 @@ service DashboardsService {
   //
   // This method requires the `monitoring.dashboards.get` permission
   // on the specified dashboard. For more information, see
-  // [Google Cloud IAM](https://cloud.google.com/iam).
+  // [Cloud Identity and Access Management](https://cloud.google.com/iam).
   rpc GetDashboard(GetDashboardRequest) returns (Dashboard) {
     option (google.api.http) = {
       get: "/v1/{name=projects/*/dashboards/*}"
@@ -78,7 +75,7 @@ service DashboardsService {
   //
   // This method requires the `monitoring.dashboards.delete` permission
   // on the specified dashboard. For more information, see
-  // [Google Cloud IAM](https://cloud.google.com/iam).
+  // [Cloud Identity and Access Management](https://cloud.google.com/iam).
   rpc DeleteDashboard(DeleteDashboardRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v1/{name=projects/*/dashboards/*}"
@@ -89,7 +86,7 @@ service DashboardsService {
   //
   // This method requires the `monitoring.dashboards.update` permission
   // on the specified dashboard. For more information, see
-  // [Google Cloud IAM](https://cloud.google.com/iam).
+  // [Cloud Identity and Access Management](https://cloud.google.com/iam).
   rpc UpdateDashboard(UpdateDashboardRequest) returns (Dashboard) {
     option (google.api.http) = {
       patch: "/v1/{dashboard.name=projects/*/dashboards/*}"

packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/drilldowns.proto

@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2021 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-monitoring-dashboard/protos/google/monitoring/dashboard/v1/layouts.proto

@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2021 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -35,6 +35,42 @@ message GridLayout {
   repeated Widget widgets = 2;
 }
 
+// A mosaic layout divides the available space into a grid of blocks, and
+// overlays the grid with tiles. Unlike `GridLayout`, tiles may span multiple
+// grid blocks and can be placed at arbitrary locations in the grid.
+message MosaicLayout {
+  // A single tile in the mosaic. The placement and size of the tile are
+  // configurable.
+  message Tile {
+    // The zero-indexed position of the tile in grid blocks relative to the
+    // left edge of the grid. Tiles must be contained within the specified
+    // number of columns. `x_pos` cannot be negative.
+    int32 x_pos = 1;
+
+    // The zero-indexed position of the tile in grid blocks relative to the
+    // top edge of the grid. `y_pos` cannot be negative.
+    int32 y_pos = 2;
+
+    // The width of the tile, measured in grid blocks. Tiles must have a
+    // minimum width of 1.
+    int32 width = 3;
+
+    // The height of the tile, measured in grid blocks. Tiles must have a
+    // minimum height of 1.
+    int32 height = 4;
+
+    // The informational widget contained in the tile. For example an `XyChart`.
+    Widget widget = 5;
+  }
+
+  // The number of columns in the mosaic grid. The number of columns must be
+  // between 1 and 12, inclusive.
+  int32 columns = 1;
+
+  // The tiles to display.
+  repeated Tile tiles = 3;
+}
+
 // A simplified layout that divides the available space into rows
 // and arranges a set of widgets horizontally in each row.
 message RowLayout {

packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/metrics.proto

@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2021 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-monitoring-dashboard/protos/google/monitoring/dashboard/v1/scorecard.proto

@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2021 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,6 +19,7 @@ package google.monitoring.dashboard.v1;
 import "google/api/field_behavior.proto";
 import "google/monitoring/dashboard/v1/metrics.proto";
 import "google/protobuf/duration.proto";
+import "google/protobuf/empty.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/monitoring/dashboard/v1;dashboard";
 option java_multiple_files = true;

packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/service.proto

@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2021 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-monitoring-dashboard/protos/google/monitoring/dashboard/v1/text.proto

@@ -1,4 +1,4 @@
-// Copyright 2020 Google LLC
+// Copyright 2021 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-monitoring-dashboard/protos/google/monitoring/dashboard/v1/widget.proto

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