feat!: added ListAccountSummaries method (#40)

PiperOrigin-RevId: 336969301

Source-Author: Google APIs <noreply@google.com>
Source-Date: Tue Oct 13 15:33:17 2020 -0700
Source-Repo: googleapis/googleapis
Source-Sha: 71088f11302e80aae77751d5a915dd2e8b684ec8
Source-Link: googleapis/googleapis@71088f1

Author: yoshi-automation

protos/google/analytics/admin/v1alpha/analytics_admin.proto

@@ -94,6 +94,13 @@ service AnalyticsAdminService {
     };
   }
 
+  // Returns summaries of all accounts accessible by the caller.
+  rpc ListAccountSummaries(ListAccountSummariesRequest) returns (ListAccountSummariesResponse) {
+    option (google.api.http) = {
+      get: "/v1alpha/accountSummaries"
+    };
+  }
+
   // Lookup for a single "App+Web" Property.
   //
   // Throws "Target not found" if no such property found, if property is not
@@ -1342,3 +1349,28 @@ message GetDataSharingSettingsRequest {
     }
   ];
 }
+
+// Request message for ListAccountSummaries RPC.
+message ListAccountSummariesRequest {
+  // The maximum number of AccountSummary resources to return. The service may
+  // return fewer than this value, even if there are additional pages.
+  // If unspecified, at most 50 resources will be returned.
+  // The maximum value is 200; (higher values will be coerced to the maximum)
+  int32 page_size = 1;
+
+  // A page token, received from a previous `ListAccountSummaries` call.
+  // Provide this to retrieve the subsequent page.
+  // When paginating, all other parameters provided to `ListAccountSummaries`
+  // must match the call that provided the page token.
+  string page_token = 2;
+}
+
+// Response message for ListAccountSummaries RPC.
+message ListAccountSummariesResponse {
+  // Account summaries of all accounts the caller has access to.
+  repeated AccountSummary account_summaries = 1;
+
+  // A token, which can be sent as `page_token` to retrieve the next page.
+  // If this field is omitted, there are no subsequent pages.
+  string next_page_token = 2;
+}

protos/google/analytics/admin/v1alpha/resources.proto

@@ -569,3 +569,43 @@ enum MaximumUserAccess {
   // the Firebase link.
   EDITOR_INCLUDING_LINK_MANAGEMENT = 4;
 }
+
+// A virtual resource representing an overview of an account and
+// all its child App+Web properties.
+message AccountSummary {
+  option (google.api.resource) = {
+    type: "analyticsadmin.googleapis.com/AccountSummary"
+    pattern: "accountSummaries/{account_summary}"
+  };
+
+  // Resource name for this account summary.
+  // Format: accountSummaries/{account_id}
+  // Example: "accountSummaries/1000"
+  string name = 1;
+
+  // Resource name of account referred to by this account summary
+  // Format: accounts/{account_id}
+  // Example: "accounts/1000"
+  string account = 2 [(google.api.resource_reference) = {
+                        type: "analyticsadmin.googleapis.com/Account"
+                      }];
+
+  // Display name for the account referred to in this account summary.
+  string display_name = 3;
+
+  // List of summaries for child accounts of this account.
+  repeated PropertySummary property_summaries = 4;
+}
+
+// A virtual resource representing metadata for an App+Web property.
+message PropertySummary {
+  // Resource name of property referred to by this property summary
+  // Format: properties/{property_id}
+  // Example: "properties/1000"
+  string property = 1 [(google.api.resource_reference) = {
+                         type: "analyticsadmin.googleapis.com/Property"
+                       }];
+
+  // Display name for the property referred to in this account summary.
+  string display_name = 2;
+}