feat(connectors): update the api

yoshi-automation · yoshi-automation · commit 8087f14f8942 · 2024-06-04T07:08:55.000Z
#### connectors:v1

The following keys were added:
- schemas.Connector.properties.category (Total Keys: 2)
- schemas.Connector.properties.tags (Total Keys: 3)

#### connectors:v2

The following keys were added:
- resources.projects.resources.locations.resources.connections.resources.entityTypes.resources.entitieswithacls.methods.list (Total Keys: 23)
- schemas.AclInfo (Total Keys: 4)
- schemas.EntityWithACL (Total Keys: 6)
- schemas.ListEntitiesWithACLsResponse (Total Keys: 5)
- schemas.Principal (Total Keys: 4)
- schemas.Readers (Total Keys: 4)
diff --git a/docs/dyn/connectors_v1.projects.locations.providers.connectors.html b/docs/dyn/connectors_v1.projects.locations.providers.connectors.html
@@ -112,6 +112,7 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # Connectors indicates a specific connector type, e.x. Salesforce, SAP etc.
+  &quot;category&quot;: &quot;A String&quot;, # Output only. Category of the connector.
   &quot;createTime&quot;: &quot;A String&quot;, # Output only. Created time.
   &quot;description&quot;: &quot;A String&quot;, # Output only. Description of the resource.
   &quot;displayName&quot;: &quot;A String&quot;, # Output only. Display name.
@@ -134,6 +135,9 @@ <h3>Method Details</h3>
   },
   &quot;launchStage&quot;: &quot;A String&quot;, # Output only. Flag to mark the version indicating the launch stage.
   &quot;name&quot;: &quot;A String&quot;, # Output only. Resource name of the Connector. Format: projects/{project}/locations/{location}/providers/{provider}/connectors/{connector} Only global location is supported for Connector resource.
+  &quot;tags&quot;: [ # Output only. Tags of the connector.
+    &quot;A String&quot;,
+  ],
   &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Updated time.
   &quot;webAssetsLocation&quot;: &quot;A String&quot;, # Output only. Cloud storage location of icons etc consumed by UI.
 }</pre>
@@ -159,6 +163,7 @@ <h3>Method Details</h3>
     { # Response message for Connectors.ListConnectors.
   &quot;connectors&quot;: [ # A list of connectors.
     { # Connectors indicates a specific connector type, e.x. Salesforce, SAP etc.
+      &quot;category&quot;: &quot;A String&quot;, # Output only. Category of the connector.
       &quot;createTime&quot;: &quot;A String&quot;, # Output only. Created time.
       &quot;description&quot;: &quot;A String&quot;, # Output only. Description of the resource.
       &quot;displayName&quot;: &quot;A String&quot;, # Output only. Display name.
@@ -181,6 +186,9 @@ <h3>Method Details</h3>
       },
       &quot;launchStage&quot;: &quot;A String&quot;, # Output only. Flag to mark the version indicating the launch stage.
       &quot;name&quot;: &quot;A String&quot;, # Output only. Resource name of the Connector. Format: projects/{project}/locations/{location}/providers/{provider}/connectors/{connector} Only global location is supported for Connector resource.
+      &quot;tags&quot;: [ # Output only. Tags of the connector.
+        &quot;A String&quot;,
+      ],
       &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Updated time.
       &quot;webAssetsLocation&quot;: &quot;A String&quot;, # Output only. Cloud storage location of icons etc consumed by UI.
     },
diff --git a/docs/dyn/connectors_v2.projects.locations.connections.entityTypes.entitieswithacls.html b/docs/dyn/connectors_v2.projects.locations.connections.entityTypes.entitieswithacls.html
@@ -0,0 +1,148 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  font-weight: inherit;
+  font-style: inherit;
+  font-size: 100%;
+  font-family: inherit;
+  vertical-align: baseline;
+}
+
+body {
+  font-size: 13px;
+  padding: 1em;
+}
+
+h1 {
+  font-size: 26px;
+  margin-bottom: 1em;
+}
+
+h2 {
+  font-size: 24px;
+  margin-bottom: 1em;
+}
+
+h3 {
+  font-size: 20px;
+  margin-bottom: 1em;
+  margin-top: 1em;
+}
+
+pre, code {
+  line-height: 1.5;
+  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+  margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+  font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+  border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+  margin-top: 0.5em;
+}
+
+.firstline {
+  margin-left: 2 em;
+}
+
+.method  {
+  margin-top: 1em;
+  border: solid 1px #CCC;
+  padding: 1em;
+  background: #EEE;
+}
+
+.details {
+  font-weight: bold;
+  font-size: 14px;
+}
+
+</style>
+
+<h1><a href="connectors_v2.html">Connectors API</a> . <a href="connectors_v2.projects.html">projects</a> . <a href="connectors_v2.projects.locations.html">locations</a> . <a href="connectors_v2.projects.locations.connections.html">connections</a> . <a href="connectors_v2.projects.locations.connections.entityTypes.html">entityTypes</a> . <a href="connectors_v2.projects.locations.connections.entityTypes.entitieswithacls.html">entitieswithacls</a></h1>
+<h2>Instance Methods</h2>
+<p class="toc_element">
+  <code><a href="#close">close()</a></code></p>
+<p class="firstline">Close httplib2 connections.</p>
+<p class="toc_element">
+  <code><a href="#list">list(parent, conditions=None, gsutilUri=None, pageSize=None, pageToken=None, sortBy=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Lists entity rows with ACLs of a particular entity type contained in the request. Note: 1. Currently, only max of one 'sort_by' column is supported. 2. If no 'sort_by' column is provided, the primary key of the table is used. If zero or more than one primary key is available, we default to the unpaginated list entities logic which only returns the first page. 3. The values of the 'sort_by' columns must uniquely identify an entity row, otherwise undefined behaviors may be observed during pagination. 4. Since transactions are not supported, any updates, inserts or deletes during pagination can lead to stale data being returned or other unexpected behaviors.</p>
+<p class="toc_element">
+  <code><a href="#list_next">list_next()</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="close">close()</code>
+  <pre>Close httplib2 connections.</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list">list(parent, conditions=None, gsutilUri=None, pageSize=None, pageToken=None, sortBy=None, x__xgafv=None)</code>
+  <pre>Lists entity rows with ACLs of a particular entity type contained in the request. Note: 1. Currently, only max of one &#x27;sort_by&#x27; column is supported. 2. If no &#x27;sort_by&#x27; column is provided, the primary key of the table is used. If zero or more than one primary key is available, we default to the unpaginated list entities logic which only returns the first page. 3. The values of the &#x27;sort_by&#x27; columns must uniquely identify an entity row, otherwise undefined behaviors may be observed during pagination. 4. Since transactions are not supported, any updates, inserts or deletes during pagination can lead to stale data being returned or other unexpected behaviors.
+
+Args:
+  parent: string, Required. Resource name of the Entity Type. Format: projects/{project}/locations/{location}/connections/{connection}/entityTypes/{type} (required)
+  conditions: string, Conditions to be used when listing entities. From a proto standpoint, There are no restrictions on what can be passed using this field. The connector documentation should have information about what format of filters/conditions are supported.
+  gsutilUri: string, Format: gs://object_path
+  pageSize: integer, Number of entity rows to return. Defaults page size = 25. Max page size = 200.
+  pageToken: string, Page token value if available from a previous request.
+  sortBy: string, List of &#x27;sort_by&#x27; columns to use when returning the results. (repeated)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response message for EntityService.ListEntitiesWithACLs
+  &quot;entitiesWithAcl&quot;: [ # List containing entity rows.
+    { # EntityWithACL refers to a single row of an entity type with ACL information.
+      &quot;acl_info&quot;: { # AclInfo has a list of readers for a resource. This is defined as per the below docs https://cloud.google.com/generative-ai-app-builder/docs/reference/rest/v1alpha/projects.locations.collections.dataStores.branches.documents#aclinfo # ACL information of the entity.
+        &quot;readers&quot;: [ # A list of readers for a resource.
+          { # Readers is a list of principals that have read access to a resource.
+            &quot;principals&quot;: [ # A list of principals that have read access to a resource.
+              { # Principal is a user or group that has access to a resource.
+                &quot;group_id&quot;: &quot;A String&quot;, # The group that has access to a resource.
+                &quot;user_id&quot;: &quot;A String&quot;, # The user that has access to a resource.
+              },
+            ],
+          },
+        ],
+      },
+      &quot;id&quot;: &quot;A String&quot;,
+      &quot;jsonData&quot;: &quot;A String&quot;, # Entity data in JSON format.
+    },
+  ],
+  &quot;nextPageToken&quot;: &quot;A String&quot;, # Next page token if more records are available.
+}</pre>
+</div>
+
+<div class="method">
+    <code class="details" id="list_next">list_next()</code>
+  <pre>Retrieves the next page of results.
+
+        Args:
+          previous_request: The request for the previous page. (required)
+          previous_response: The response from the request for the previous page. (required)
+
+        Returns:
+          A request object that you can call &#x27;execute()&#x27; on to request the next
+          page. Returns None if there are no more items in the collection.
+        </pre>
+</div>
+
+</body></html>
diff --git a/docs/dyn/connectors_v2.projects.locations.connections.entityTypes.html b/docs/dyn/connectors_v2.projects.locations.connections.entityTypes.html
@@ -79,6 +79,11 @@ <h2>Instance Methods</h2>
 </p>
 <p class="firstline">Returns the entities Resource.</p>
 
+<p class="toc_element">
+  <code><a href="connectors_v2.projects.locations.connections.entityTypes.entitieswithacls.html">entitieswithacls()</a></code>
+</p>
+<p class="firstline">Returns the entitieswithacls Resource.</p>
+
 <p class="toc_element">
   <code><a href="#close">close()</a></code></p>
 <p class="firstline">Close httplib2 connections.</p>
diff --git a/googleapiclient/discovery_cache/documents/connectors.v1.json b/googleapiclient/discovery_cache/documents/connectors.v1.json
@@ -2427,7 +2427,7 @@
 }
 }
 },
-"revision": "20240515",
+"revision": "20240529",
 "rootUrl": "https://connectors.googleapis.com/",
 "schemas": {
 "AuditConfig": {
@@ -3103,6 +3103,11 @@
 "description": "Connectors indicates a specific connector type, e.x. Salesforce, SAP etc.",
 "id": "Connector",
 "properties": {
+"category": {
+"description": "Output only. Category of the connector.",
+"readOnly": true,
+"type": "string"
+},
 "createTime": {
 "description": "Output only. Created time.",
 "format": "google-datetime",
@@ -3166,6 +3171,14 @@
 "readOnly": true,
 "type": "string"
 },
+"tags": {
+"description": "Output only. Tags of the connector.",
+"items": {
+"type": "string"
+},
+"readOnly": true,
+"type": "array"
+},
 "updateTime": {
 "description": "Output only. Updated time.",
 "format": "google-datetime",
diff --git a/googleapiclient/discovery_cache/documents/connectors.v2.json b/googleapiclient/discovery_cache/documents/connectors.v2.json
