feat(apigee): update the api

#### apigee:v1

The following keys were deleted:
- schemas.GoogleCloudApigeeV1ApiCategoryData.properties.gcpResource.type (Total Keys: 1)

Author: yoshi-automation

docs/dyn/apigee_v1.organizations.appgroups.html

@@ -99,7 +99,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Retrieves the next page of results.</p>
 <p class="toc_element">
   <code><a href="#update">update(name, action=None, body=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Updates an appGroup. This API replaces the existing appGroup details with those specified in the request. Include or exclude any existing details that you want to retain or delete, respectively. Note that the state of the AppGroup should be updated using `action`, and not via AppGroup. **Note**: OAuth access tokens and Key Management Service (KMS) entities (apps, developers, and API products) are cached for 180 seconds (current default). Any custom attributes associated with these entities are cached for at least 180 seconds after the entity is accessed at runtime. Therefore, an `ExpiresIn` element on the OAuthV2 policy won't be able to expire an access token in less than 180 seconds.</p>
+<p class="firstline">Updates an AppGroup. This API replaces the existing AppGroup details with those specified in the request. Include or exclude any existing details that you want to retain or delete, respectively. Note that the state of the AppGroup should be updated using `action`, and not via AppGroup.</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="close">close()</code>
@@ -284,7 +284,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="update">update(name, action=None, body=None, x__xgafv=None)</code>
-  <pre>Updates an appGroup. This API replaces the existing appGroup details with those specified in the request. Include or exclude any existing details that you want to retain or delete, respectively. Note that the state of the AppGroup should be updated using `action`, and not via AppGroup. **Note**: OAuth access tokens and Key Management Service (KMS) entities (apps, developers, and API products) are cached for 180 seconds (current default). Any custom attributes associated with these entities are cached for at least 180 seconds after the entity is accessed at runtime. Therefore, an `ExpiresIn` element on the OAuthV2 policy won&#x27;t be able to expire an access token in less than 180 seconds.
+  <pre>Updates an AppGroup. This API replaces the existing AppGroup details with those specified in the request. Include or exclude any existing details that you want to retain or delete, respectively. Note that the state of the AppGroup should be updated using `action`, and not via AppGroup.
 
 Args:
   name: string, Required. Name of the AppGroup. Use the following structure in your request: `organizations/{org}/appgroups/{app_group_name}` (required)
@@ -309,7 +309,7 @@ <h3>Method Details</h3>
   &quot;status&quot;: &quot;A String&quot;, # Valid values are `active` or `inactive`. Note that the status of the AppGroup should be updated via UpdateAppGroupRequest by setting the action as `active` or `inactive`.
 }
 
-  action: string, Activate or de-activate the appGroup by setting the action as `active` or `inactive`. The `Content-Type` header must be set to `application/octet-stream`, with empty body.
+  action: string, Activate or de-activate the AppGroup by setting the action as `active` or `inactive`. The `Content-Type` header must be set to `application/octet-stream`, with empty body.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format

docs/dyn/apigee_v1.organizations.sites.apicategories.html

@@ -79,19 +79,19 @@ <h2>Instance Methods</h2>
 <p class="firstline">Close httplib2 connections.</p>
 <p class="toc_element">
   <code><a href="#create">create(parent, body=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Creates a new category on the portal.</p>
+<p class="firstline">Creates a new API category.</p>
 <p class="toc_element">
   <code><a href="#delete">delete(name, x__xgafv=None)</a></code></p>
-<p class="firstline">Deletes a category from the portal.</p>
+<p class="firstline">Deletes an API category.</p>
 <p class="toc_element">
   <code><a href="#get">get(name, x__xgafv=None)</a></code></p>
-<p class="firstline">Gets a category on the portal.</p>
+<p class="firstline">Gets an API category.</p>
 <p class="toc_element">
   <code><a href="#list">list(parent, x__xgafv=None)</a></code></p>
-<p class="firstline">Lists the categories on the portal.</p>
+<p class="firstline">Returns the API categories associated with a portal.</p>
 <p class="toc_element">
   <code><a href="#patch">patch(name, body=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Updates a category on the portal.</p>
+<p class="firstline">Updates an API category.</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="close">close()</code>
@@ -100,15 +100,14 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="create">create(parent, body=None, x__xgafv=None)</code>
-  <pre>Creates a new category on the portal.
+  <pre>Creates a new API category.
 
 Args:
   parent: string, Required. Name of the portal. Use the following structure in your request: `organizations/{org}/sites/{site}` (required)
   body: object, The request body.
     The object takes the form of:
 
-{ # the Api category resource.
-  &quot;gcpResource&quot;: &quot;A String&quot;, # GCP name of api category resource.
+{ # `ApiCategoryData` represents an API category. Catalog items can be tagged with API categories; users viewing the API catalog in the portal will have the option to browse the catalog by category.
   &quot;id&quot;: &quot;A String&quot;, # ID of the category (a UUID).
   &quot;name&quot;: &quot;A String&quot;, # Name of the category.
   &quot;siteId&quot;: &quot;A String&quot;, # Name of the portal.
@@ -123,24 +122,23 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # the Api category resource wrapped with response status, error_code etc.
-  &quot;data&quot;: { # the Api category resource. # Details of category.
-    &quot;gcpResource&quot;: &quot;A String&quot;, # GCP name of api category resource.
+    { # The API category resource wrapped with response status, error_code, etc.
+  &quot;data&quot;: { # `ApiCategoryData` represents an API category. Catalog items can be tagged with API categories; users viewing the API catalog in the portal will have the option to browse the catalog by category. # Details of the category.
     &quot;id&quot;: &quot;A String&quot;, # ID of the category (a UUID).
     &quot;name&quot;: &quot;A String&quot;, # Name of the category.
     &quot;siteId&quot;: &quot;A String&quot;, # Name of the portal.
     &quot;updateTime&quot;: &quot;A String&quot;, # Time the category was last modified in milliseconds since epoch.
   },
-  &quot;errorCode&quot;: &quot;A String&quot;, # ID that can be used to find errors in the log files.
+  &quot;errorCode&quot;: &quot;A String&quot;, # Unique error code for the request, if any.
   &quot;message&quot;: &quot;A String&quot;, # Description of the operation.
-  &quot;requestId&quot;: &quot;A String&quot;, # ID that can be used to find request details in the log files.
+  &quot;requestId&quot;: &quot;A String&quot;, # Unique ID of the request.
   &quot;status&quot;: &quot;A String&quot;, # Status of the operation.
 }</pre>
 </div>
 
 <div class="method">
     <code class="details" id="delete">delete(name, x__xgafv=None)</code>
-  <pre>Deletes a category from the portal.
+  <pre>Deletes an API category.
 
 Args:
   name: string, Required. Name of the category. Use the following structure in your request: `organizations/{org}/sites/{site}/apicategories/{apicategory}` (required)
@@ -153,17 +151,17 @@ <h3>Method Details</h3>
   An object of the form:
 
     { # Response for certain delete operations.
-  &quot;errorCode&quot;: &quot;A String&quot;, # ID that can be used to find errors in the log files.
-  &quot;gcpResource&quot;: &quot;A String&quot;, # GCP name of deleted resource.
+  &quot;errorCode&quot;: &quot;A String&quot;, # Unique error code for the request, if any.
+  &quot;gcpResource&quot;: &quot;A String&quot;, # Google Cloud name of deleted resource.
   &quot;message&quot;: &quot;A String&quot;, # Description of the operation.
-  &quot;requestId&quot;: &quot;A String&quot;, # ID that can be used to find request details in the log files.
+  &quot;requestId&quot;: &quot;A String&quot;, # Unique ID of the request.
   &quot;status&quot;: &quot;A String&quot;, # Status of the operation.
 }</pre>
 </div>
 
 <div class="method">
     <code class="details" id="get">get(name, x__xgafv=None)</code>
-  <pre>Gets a category on the portal.
+  <pre>Gets an API category.
 
 Args:
   name: string, Required. Name of the category. Use the following structure in your request: `organizations/{org}/sites/{site}/apicategories/{apicategory}` (required)
@@ -175,24 +173,23 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # the Api category resource wrapped with response status, error_code etc.
-  &quot;data&quot;: { # the Api category resource. # Details of category.
-    &quot;gcpResource&quot;: &quot;A String&quot;, # GCP name of api category resource.
+    { # The API category resource wrapped with response status, error_code, etc.
+  &quot;data&quot;: { # `ApiCategoryData` represents an API category. Catalog items can be tagged with API categories; users viewing the API catalog in the portal will have the option to browse the catalog by category. # Details of the category.
     &quot;id&quot;: &quot;A String&quot;, # ID of the category (a UUID).
     &quot;name&quot;: &quot;A String&quot;, # Name of the category.
     &quot;siteId&quot;: &quot;A String&quot;, # Name of the portal.
     &quot;updateTime&quot;: &quot;A String&quot;, # Time the category was last modified in milliseconds since epoch.
   },
-  &quot;errorCode&quot;: &quot;A String&quot;, # ID that can be used to find errors in the log files.
+  &quot;errorCode&quot;: &quot;A String&quot;, # Unique error code for the request, if any.
   &quot;message&quot;: &quot;A String&quot;, # Description of the operation.
-  &quot;requestId&quot;: &quot;A String&quot;, # ID that can be used to find request details in the log files.
+  &quot;requestId&quot;: &quot;A String&quot;, # Unique ID of the request.
   &quot;status&quot;: &quot;A String&quot;, # Status of the operation.
 }</pre>
 </div>
 
 <div class="method">
     <code class="details" id="list">list(parent, x__xgafv=None)</code>
-  <pre>Lists the categories on the portal.
+  <pre>Returns the API categories associated with a portal.
 
 Args:
   parent: string, Required. Name of the portal. Use the following structure in your request: `organizations/{org}/sites/{site}` (required)
@@ -204,34 +201,32 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # the response for ListApiCategoriesRequest.
-  &quot;data&quot;: [ # Details of categories.
-    { # the Api category resource.
-      &quot;gcpResource&quot;: &quot;A String&quot;, # GCP name of api category resource.
+    { # The response for `ListApiCategoriesRequest`.
+  &quot;data&quot;: [ # Details of the categories.
+    { # `ApiCategoryData` represents an API category. Catalog items can be tagged with API categories; users viewing the API catalog in the portal will have the option to browse the catalog by category.
       &quot;id&quot;: &quot;A String&quot;, # ID of the category (a UUID).
       &quot;name&quot;: &quot;A String&quot;, # Name of the category.
       &quot;siteId&quot;: &quot;A String&quot;, # Name of the portal.
       &quot;updateTime&quot;: &quot;A String&quot;, # Time the category was last modified in milliseconds since epoch.
     },
   ],
-  &quot;errorCode&quot;: &quot;A String&quot;, # ID that can be used to find errors in the log files.
+  &quot;errorCode&quot;: &quot;A String&quot;, # Unique error code for the request, if any.
   &quot;message&quot;: &quot;A String&quot;, # Description of the operation.
-  &quot;requestId&quot;: &quot;A String&quot;, # ID that can be used to find request details in the log files.
+  &quot;requestId&quot;: &quot;A String&quot;, # Unique ID of the request.
   &quot;status&quot;: &quot;A String&quot;, # Status of the operation.
 }</pre>
 </div>
 
 <div class="method">
     <code class="details" id="patch">patch(name, body=None, x__xgafv=None)</code>
-  <pre>Updates a category on the portal.
+  <pre>Updates an API category.
 
 Args:
   name: string, Required. Name of the category. Use the following structure in your request: `organizations/{org}/sites/{site}/apicategories/{apicategory}` (required)
   body: object, The request body.
     The object takes the form of:
 
-{ # the Api category resource.
-  &quot;gcpResource&quot;: &quot;A String&quot;, # GCP name of api category resource.
+{ # `ApiCategoryData` represents an API category. Catalog items can be tagged with API categories; users viewing the API catalog in the portal will have the option to browse the catalog by category.
   &quot;id&quot;: &quot;A String&quot;, # ID of the category (a UUID).
   &quot;name&quot;: &quot;A String&quot;, # Name of the category.
   &quot;siteId&quot;: &quot;A String&quot;, # Name of the portal.
@@ -246,17 +241,16 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # the Api category resource wrapped with response status, error_code etc.
-  &quot;data&quot;: { # the Api category resource. # Details of category.
-    &quot;gcpResource&quot;: &quot;A String&quot;, # GCP name of api category resource.
+    { # The API category resource wrapped with response status, error_code, etc.
+  &quot;data&quot;: { # `ApiCategoryData` represents an API category. Catalog items can be tagged with API categories; users viewing the API catalog in the portal will have the option to browse the catalog by category. # Details of the category.
     &quot;id&quot;: &quot;A String&quot;, # ID of the category (a UUID).
     &quot;name&quot;: &quot;A String&quot;, # Name of the category.
     &quot;siteId&quot;: &quot;A String&quot;, # Name of the portal.
     &quot;updateTime&quot;: &quot;A String&quot;, # Time the category was last modified in milliseconds since epoch.
   },
-  &quot;errorCode&quot;: &quot;A String&quot;, # ID that can be used to find errors in the log files.
+  &quot;errorCode&quot;: &quot;A String&quot;, # Unique error code for the request, if any.
   &quot;message&quot;: &quot;A String&quot;, # Description of the operation.
-  &quot;requestId&quot;: &quot;A String&quot;, # ID that can be used to find request details in the log files.
+  &quot;requestId&quot;: &quot;A String&quot;, # Unique ID of the request.
   &quot;status&quot;: &quot;A String&quot;, # Status of the operation.
 }</pre>
 </div>