feat: Add TestMatrix.extended_invalid_matrix_details that provides ad…

…ditional details when a matrix is INVALID

---
feat: Allow client to use API key to access device catalog in autopush deployment

---
feat: A new field bundle_location is added to GetApkDetailsRequest
docs: Updated docs to refelect this change
PiperOrigin-RevId: 609472108

google/devtools/testing/v1/application_details.proto

@@ -18,6 +18,7 @@ package google.devtools.testing.v1;
 
 import "google/api/annotations.proto";
 import "google/api/client.proto";
+import "google/api/field_behavior.proto";
 import "google/devtools/testing/v1/test_execution.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/devtools/testing/v1;testing";
@@ -41,7 +42,7 @@ service ApplicationDetailService {
   }
 }
 
-// Android application details based on application manifest and apk archive
+// Android application details based on application manifest and archive
 // contents.
 message ApkDetail {
   ApkManifest apk_manifest = 1;
@@ -130,14 +131,17 @@ message UsesFeature {
   bool is_required = 2;
 }
 
-// A request to get the details of an Android application APK.
+// A request to get the details of an Android application.
 message GetApkDetailsRequest {
-  // The APK to be parsed for details.
-  FileReference location = 1;
+  // Optional. The APK to be parsed for details.
+  FileReference location = 1 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The App Bundle to be parsed for details.
+  FileReference bundle_location = 2 [(google.api.field_behavior) = OPTIONAL];
 }
 
-// Response containing the details of the specified Android application APK.
+// Response containing the details of the specified Android application.
 message GetApkDetailsResponse {
-  // Details of the Android APK.
+  // Details of the Android App.
   ApkDetail apk_detail = 1;
 }

google/devtools/testing/v1/test_execution.proto

@@ -149,6 +149,12 @@ message TestMatrix {
   // Only useful for matrices in the INVALID state.
   InvalidMatrixDetails invalid_matrix_details = 11;
 
+  // Output only. Details about why a matrix was deemed invalid.
+  // If multiple checks can be safely performed, they will be reported but no
+  // assumptions should be made about the length of this list.
+  repeated MatrixErrorDetail extended_invalid_matrix_details = 22
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
   // The number of times a TestExecution should be re-attempted if one or more
   // of its test cases fail for any reason.
   // The maximum number of reruns allowed is 10.
@@ -172,6 +178,18 @@ message TestMatrix {
   bool fail_fast = 17;
 }
 
+// Describes a single error or issue with a matrix.
+message MatrixErrorDetail {
+  // Output only. The reason for the error. This is a constant value in
+  // UPPER_SNAKE_CASE that identifies the cause of the error.
+  string reason = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. A human-readable message about how the error in the
+  // TestMatrix. Expands on the `reason` field with additional details and
+  // possible options to fix the issue.
+  string message = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
 // A single test executed in a single environment.
 message TestExecution {
   // Output only. Unique id set by the service.