google-apis-apigee_v1 0.84.0 → 0.86.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a8b60b48dc8f987c6409b743c8f2867ade0dc923ea84ccbf22fed285aa673b73
-  data.tar.gz: 04e252d78f208f3a55743cb9523dfa1a2026d102661ba4c39d3b77f30dbe0a44
+  metadata.gz: 543f58efb7dc66daf60f595a1e72274cdec0ffb59ce93672a5387c3394847c6e
+  data.tar.gz: 2aed68265e9d3ebd190ddb5fc4168950b4fa46c941d606580632b99908bbaba3
 SHA512:
-  metadata.gz: 0ccea4d388773e9ed554d5bea149d5257d30001a2d1cf4407cc7093891914c24fa34dae5cbbe08b42cebf3e567db8a40852d2313a15a9065a0bd17b29f4df639
-  data.tar.gz: 1a1918bf8dca8aa4bdd5a4c4c638cb0e5c933b832eb83cd5b363624a4860844914fc5f2364fc42da355a87b29ce4b795fec0b9e45d6b24803a3fb48d1614e359
+  metadata.gz: 3768cf670799b91638e8ee0d0b21b96c0b096f898d7ed1bbbec5303701acc222f74be50c1d0fae8a35465da0f6b89ce240a1f8b122051d8f64b483cd41db3826
+  data.tar.gz: ca247a86caa8ce13bff0b722f671b3a8e7e4e2c44cc0c4ee31ce6af5f16e0b0106db55df822d9b3ba5635388cd533335ce995c080707124dad65c26fd03f3f56

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-apigee_v1
 
+### v0.86.0 (2024-03-10)
+
+* Regenerated from discovery document revision 20240305
+
+### v0.85.0 (2024-03-03)
+
+* Regenerated from discovery document revision 20240222
+
 ### v0.84.0 (2024-02-24)
 
 * Regenerated from discovery document revision 20240220

data/lib/google/apis/apigee_v1/classes.rb

@@ -553,6 +553,275 @@ module Google
         end
       end
       
+      # `ApiDoc` represents an API catalog item. Catalog items are used in two ways in
+      # a portal: - Users can browse and interact with a visual representation of the
+      # API documentation - The `api_product_name` field provides a link to a backing [
+      # API product] (/apigee/docs/reference/apis/apigee/rest/v1/organizations.
+      # apiproducts). Through this link, portal users can create and manage developer
+      # apps linked to one or more API products.
+      class GoogleCloudApigeeV1ApiDoc
+        include Google::Apis::Core::Hashable
+      
+        # Optional. Boolean flag that manages user access to the catalog item. When true,
+        # the catalog item can be viewed anonymously; otherwise, only registered users
+        # may view it. Note: when the parent portal is enrolled in the [audience
+        # management feature](https://cloud.google.com/apigee/docs/api-platform/publish/
+        # portal/portal-audience#
+        # enrolling_in_the_beta_release_of_the_audience_management_feature), this flag
+        # is ignored; instead visibility must be further managed in the management UI (
+        # see [Manage the visibility of an API in your portal](https://cloud.google.com/
+        # apigee/docs/api-platform/publish/portal/publish-apis#visibility)).
+        # Corresponds to the JSON property `anonAllowed`
+        # @return [Boolean]
+        attr_accessor :anon_allowed
+        alias_method :anon_allowed?, :anon_allowed
+      
+        # Required. Immutable. The `name` field of the associated [API product](/apigee/
+        # docs/reference/apis/apigee/rest/v1/organizations.apiproducts). A portal may
+        # have only one catalog item associated with a given API product.
+        # Corresponds to the JSON property `apiProductName`
+        # @return [String]
+        attr_accessor :api_product_name
+      
+        # Optional. The IDs of the API categories to which this catalog item belongs.
+        # Corresponds to the JSON property `categoryIds`
+        # @return [Array<String>]
+        attr_accessor :category_ids
+      
+        # Optional. Description of the catalog item. Max length is 10,000 characters.
+        # Corresponds to the JSON property `description`
+        # @return [String]
+        attr_accessor :description
+      
+        # Optional. Immutable. DEPRECATED: use the `apiProductName` field instead
+        # Corresponds to the JSON property `edgeAPIProductName`
+        # @return [String]
+        attr_accessor :edge_api_product_name
+      
+        # Optional. DEPRECATED: manage documentation through the `getDocumentation` and `
+        # updateDocumentation` methods
+        # Corresponds to the JSON property `graphqlEndpointUrl`
+        # @return [String]
+        attr_accessor :graphql_endpoint_url
+      
+        # Optional. DEPRECATED: manage documentation through the `getDocumentation` and `
+        # updateDocumentation` methods
+        # Corresponds to the JSON property `graphqlSchema`
+        # @return [String]
+        attr_accessor :graphql_schema
+      
+        # Optional. DEPRECATED: manage documentation through the `getDocumentation` and `
+        # updateDocumentation` methods
+        # Corresponds to the JSON property `graphqlSchemaDisplayName`
+        # @return [String]
+        attr_accessor :graphql_schema_display_name
+      
+        # Output only. The ID of the catalog item.
+        # Corresponds to the JSON property `id`
+        # @return [Fixnum]
+        attr_accessor :id
+      
+        # Optional. Location of the image used for the catalog item in the catalog. For
+        # portal files, this can have the format `/files/`filename``. Max length is 2,
+        # 083 characters.
+        # Corresponds to the JSON property `imageUrl`
+        # @return [String]
+        attr_accessor :image_url
+      
+        # Output only. Time the catalog item was last modified in milliseconds since
+        # epoch.
+        # Corresponds to the JSON property `modified`
+        # @return [Fixnum]
+        attr_accessor :modified
+      
+        # Optional. Denotes whether the catalog item is published to the portal or is in
+        # a draft state. When the parent portal is enrolled in the [audience management
+        # feature](https://cloud.google.com/apigee/docs/api-platform/publish/portal/
+        # portal-audience#
+        # enrolling_in_the_beta_release_of_the_audience_management_feature), the
+        # visibility must be further managed in the management UI (see [Manage the
+        # visibility of an API in your portal](https://cloud.google.com/apigee/docs/api-
+        # platform/publish/portal/publish-apis#visibility)) before it can be visible to
+        # any users. If not enrolled in the audience management feature, the visibility
+        # is further managed by the `anonAllowed` flag.
+        # Corresponds to the JSON property `published`
+        # @return [Boolean]
+        attr_accessor :published
+        alias_method :published?, :published
+      
+        # Optional. Whether a callback URL is required when this catalog item's API
+        # product is enabled in a developer app. When true, a portal user will be
+        # required to input a URL when managing the app (this is typically used for the
+        # app's OAuth flow).
+        # Corresponds to the JSON property `requireCallbackUrl`
+        # @return [Boolean]
+        attr_accessor :require_callback_url
+        alias_method :require_callback_url?, :require_callback_url
+      
+        # Output only. The ID of the parent portal.
+        # Corresponds to the JSON property `siteId`
+        # @return [String]
+        attr_accessor :site_id
+      
+        # Optional. DEPRECATED: DO NOT USE
+        # Corresponds to the JSON property `specId`
+        # @return [String]
+        attr_accessor :spec_id
+      
+        # Required. The user-facing name of the catalog item. `title` must be a non-
+        # empty string with a max length of 255 characters.
+        # Corresponds to the JSON property `title`
+        # @return [String]
+        attr_accessor :title
+      
+        # Optional. DEPRECATED: use the `published` field instead
+        # Corresponds to the JSON property `visibility`
+        # @return [Boolean]
+        attr_accessor :visibility
+        alias_method :visibility?, :visibility
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @anon_allowed = args[:anon_allowed] if args.key?(:anon_allowed)
+          @api_product_name = args[:api_product_name] if args.key?(:api_product_name)
+          @category_ids = args[:category_ids] if args.key?(:category_ids)
+          @description = args[:description] if args.key?(:description)
+          @edge_api_product_name = args[:edge_api_product_name] if args.key?(:edge_api_product_name)
+          @graphql_endpoint_url = args[:graphql_endpoint_url] if args.key?(:graphql_endpoint_url)
+          @graphql_schema = args[:graphql_schema] if args.key?(:graphql_schema)
+          @graphql_schema_display_name = args[:graphql_schema_display_name] if args.key?(:graphql_schema_display_name)
+          @id = args[:id] if args.key?(:id)
+          @image_url = args[:image_url] if args.key?(:image_url)
+          @modified = args[:modified] if args.key?(:modified)
+          @published = args[:published] if args.key?(:published)
+          @require_callback_url = args[:require_callback_url] if args.key?(:require_callback_url)
+          @site_id = args[:site_id] if args.key?(:site_id)
+          @spec_id = args[:spec_id] if args.key?(:spec_id)
+          @title = args[:title] if args.key?(:title)
+          @visibility = args[:visibility] if args.key?(:visibility)
+        end
+      end
+      
+      # The documentation for a catalog item.
+      class GoogleCloudApigeeV1ApiDocDocumentation
+        include Google::Apis::Core::Hashable
+      
+        # GraphQL documentation for a catalog item.
+        # Corresponds to the JSON property `graphqlDocumentation`
+        # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1GraphqlDocumentation]
+        attr_accessor :graphql_documentation
+      
+        # OpenAPI Specification documentation for a catalog item.
+        # Corresponds to the JSON property `oasDocumentation`
+        # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1OasDocumentation]
+        attr_accessor :oas_documentation
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @graphql_documentation = args[:graphql_documentation] if args.key?(:graphql_documentation)
+          @oas_documentation = args[:oas_documentation] if args.key?(:oas_documentation)
+        end
+      end
+      
+      # The catalog item documentation wrapped with response status, error_code, etc.
+      class GoogleCloudApigeeV1ApiDocDocumentationResponse
+        include Google::Apis::Core::Hashable
+      
+        # The documentation for a catalog item.
+        # Corresponds to the JSON property `data`
+        # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDocDocumentation]
+        attr_accessor :data
+      
+        # Output only. Unique error code for the request, if any.
+        # Corresponds to the JSON property `errorCode`
+        # @return [String]
+        attr_accessor :error_code
+      
+        # Output only. Description of the operation.
+        # Corresponds to the JSON property `message`
+        # @return [String]
+        attr_accessor :message
+      
+        # Output only. Unique ID of the request.
+        # Corresponds to the JSON property `requestId`
+        # @return [String]
+        attr_accessor :request_id
+      
+        # Output only. Status of the operation.
+        # Corresponds to the JSON property `status`
+        # @return [String]
+        attr_accessor :status
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @data = args[:data] if args.key?(:data)
+          @error_code = args[:error_code] if args.key?(:error_code)
+          @message = args[:message] if args.key?(:message)
+          @request_id = args[:request_id] if args.key?(:request_id)
+          @status = args[:status] if args.key?(:status)
+        end
+      end
+      
+      # The catalog item resource wrapped with response status, error_code, etc.
+      class GoogleCloudApigeeV1ApiDocResponse
+        include Google::Apis::Core::Hashable
+      
+        # `ApiDoc` represents an API catalog item. Catalog items are used in two ways in
+        # a portal: - Users can browse and interact with a visual representation of the
+        # API documentation - The `api_product_name` field provides a link to a backing [
+        # API product] (/apigee/docs/reference/apis/apigee/rest/v1/organizations.
+        # apiproducts). Through this link, portal users can create and manage developer
+        # apps linked to one or more API products.
+        # Corresponds to the JSON property `data`
+        # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDoc]
+        attr_accessor :data
+      
+        # Unique error code for the request, if any.
+        # Corresponds to the JSON property `errorCode`
+        # @return [String]
+        attr_accessor :error_code
+      
+        # Description of the operation.
+        # Corresponds to the JSON property `message`
+        # @return [String]
+        attr_accessor :message
+      
+        # Unique ID of the request.
+        # Corresponds to the JSON property `requestId`
+        # @return [String]
+        attr_accessor :request_id
+      
+        # Status of the operation.
+        # Corresponds to the JSON property `status`
+        # @return [String]
+        attr_accessor :status
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @data = args[:data] if args.key?(:data)
+          @error_code = args[:error_code] if args.key?(:error_code)
+          @message = args[:message] if args.key?(:message)
+          @request_id = args[:request_id] if args.key?(:request_id)
+          @status = args[:status] if args.key?(:status)
+        end
+      end
+      
       # 
       class GoogleCloudApigeeV1ApiProduct
         include Google::Apis::Core::Hashable
@@ -3602,6 +3871,33 @@ module Google
         end
       end
       
+      # Documentation file contents for a catalog item.
+      class GoogleCloudApigeeV1DocumentationFile
+        include Google::Apis::Core::Hashable
+      
+        # Required. The file contents. The max size is 4 MB.
+        # Corresponds to the JSON property `contents`
+        # NOTE: Values are automatically base64 encoded/decoded in the client library.
+        # @return [String]
+        attr_accessor :contents
+      
+        # Required. A display name for the file, shown in the management UI. Max length
+        # is 255 characters.
+        # Corresponds to the JSON property `displayName`
+        # @return [String]
+        attr_accessor :display_name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @contents = args[:contents] if args.key?(:contents)
+          @display_name = args[:display_name] if args.key?(:display_name)
+        end
+      end
+      
       # Message to enable a disabled SecurityAction.
       class GoogleCloudApigeeV1EnableSecurityActionRequest
         include Google::Apis::Core::Hashable
@@ -4617,6 +4913,32 @@ module Google
         end
       end
       
+      # GraphQL documentation for a catalog item.
+      class GoogleCloudApigeeV1GraphqlDocumentation
+        include Google::Apis::Core::Hashable
+      
+        # Required. The GraphQL endpoint URI to be queried by API consumers. Max length
+        # is 2,083 characters.
+        # Corresponds to the JSON property `endpointUri`
+        # @return [String]
+        attr_accessor :endpoint_uri
+      
+        # Documentation file contents for a catalog item.
+        # Corresponds to the JSON property `schema`
+        # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1DocumentationFile]
+        attr_accessor :schema
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @endpoint_uri = args[:endpoint_uri] if args.key?(:endpoint_uri)
+          @schema = args[:schema] if args.key?(:schema)
+        end
+      end
+      
       # Binds the resources in a proxy or remote service with the gRPC operation and
       # its associated quota enforcement.
       class GoogleCloudApigeeV1GrpcOperationConfig
@@ -5188,6 +5510,56 @@ module Google
         end
       end
       
+      # 
+      class GoogleCloudApigeeV1ListApiDocsResponse
+        include Google::Apis::Core::Hashable
+      
+        # The catalog item resources.
+        # Corresponds to the JSON property `data`
+        # @return [Array<Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDoc>]
+        attr_accessor :data
+      
+        # Unique error code for the request, if any.
+        # Corresponds to the JSON property `errorCode`
+        # @return [String]
+        attr_accessor :error_code
+      
+        # Description of the operation.
+        # Corresponds to the JSON property `message`
+        # @return [String]
+        attr_accessor :message
+      
+        # A token, which can be sent as `page_token` to retrieve the next page. If this
+        # field is omitted, there are no subsequent pages.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        # Unique ID of the request.
+        # Corresponds to the JSON property `requestId`
+        # @return [String]
+        attr_accessor :request_id
+      
+        # Status of the operation.
+        # Corresponds to the JSON property `status`
+        # @return [String]
+        attr_accessor :status
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @data = args[:data] if args.key?(:data)
+          @error_code = args[:error_code] if args.key?(:error_code)
+          @message = args[:message] if args.key?(:message)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+          @request_id = args[:request_id] if args.key?(:request_id)
+          @status = args[:status] if args.key?(:status)
+        end
+      end
+      
       # 
       class GoogleCloudApigeeV1ListApiProductsResponse
         include Google::Apis::Core::Hashable
@@ -6182,6 +6554,31 @@ module Google
         end
       end
       
+      # OpenAPI Specification documentation for a catalog item.
+      class GoogleCloudApigeeV1OasDocumentation
+        include Google::Apis::Core::Hashable
+      
+        # Output only. The format of the input specification file contents.
+        # Corresponds to the JSON property `format`
+        # @return [String]
+        attr_accessor :format
+      
+        # Documentation file contents for a catalog item.
+        # Corresponds to the JSON property `spec`
+        # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1DocumentationFile]
+        attr_accessor :spec
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @format = args[:format] if args.key?(:format)
+          @spec = args[:spec] if args.key?(:spec)
+        end
+      end
+      
       # Represents the pairing of REST resource path and the actions (verbs) allowed
       # on the resource path.
       class GoogleCloudApigeeV1Operation

data/lib/google/apis/apigee_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module ApigeeV1
       # Version of the google-apis-apigee_v1 gem
-      GEM_VERSION = "0.84.0"
+      GEM_VERSION = "0.86.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.14.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20240220"
+      REVISION = "20240305"
     end
   end
 end

data/lib/google/apis/apigee_v1/representations.rb

@@ -124,6 +124,30 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudApigeeV1ApiDoc
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudApigeeV1ApiDocDocumentation
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudApigeeV1ApiDocDocumentationResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudApigeeV1ApiDocResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudApigeeV1ApiProduct
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -472,6 +496,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudApigeeV1DocumentationFile
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudApigeeV1EnableSecurityActionRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -616,6 +646,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudApigeeV1GraphqlDocumentation
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudApigeeV1GrpcOperationConfig
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -706,6 +742,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudApigeeV1ListApiDocsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudApigeeV1ListApiProductsResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -946,6 +988,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudApigeeV1OasDocumentation
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudApigeeV1Operation
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1826,6 +1874,63 @@ module Google
         end
       end
       
+      class GoogleCloudApigeeV1ApiDoc
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :anon_allowed, as: 'anonAllowed'
+          property :api_product_name, as: 'apiProductName'
+          collection :category_ids, as: 'categoryIds'
+          property :description, as: 'description'
+          property :edge_api_product_name, as: 'edgeAPIProductName'
+          property :graphql_endpoint_url, as: 'graphqlEndpointUrl'
+          property :graphql_schema, as: 'graphqlSchema'
+          property :graphql_schema_display_name, as: 'graphqlSchemaDisplayName'
+          property :id, :numeric_string => true, as: 'id'
+          property :image_url, as: 'imageUrl'
+          property :modified, :numeric_string => true, as: 'modified'
+          property :published, as: 'published'
+          property :require_callback_url, as: 'requireCallbackUrl'
+          property :site_id, as: 'siteId'
+          property :spec_id, as: 'specId'
+          property :title, as: 'title'
+          property :visibility, as: 'visibility'
+        end
+      end
+      
+      class GoogleCloudApigeeV1ApiDocDocumentation
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :graphql_documentation, as: 'graphqlDocumentation', class: Google::Apis::ApigeeV1::GoogleCloudApigeeV1GraphqlDocumentation, decorator: Google::Apis::ApigeeV1::GoogleCloudApigeeV1GraphqlDocumentation::Representation
+      
+          property :oas_documentation, as: 'oasDocumentation', class: Google::Apis::ApigeeV1::GoogleCloudApigeeV1OasDocumentation, decorator: Google::Apis::ApigeeV1::GoogleCloudApigeeV1OasDocumentation::Representation
+      
+        end
+      end
+      
+      class GoogleCloudApigeeV1ApiDocDocumentationResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :data, as: 'data', class: Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDocDocumentation, decorator: Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDocDocumentation::Representation
+      
+          property :error_code, as: 'errorCode'
+          property :message, as: 'message'
+          property :request_id, as: 'requestId'
+          property :status, as: 'status'
+        end
+      end
+      
+      class GoogleCloudApigeeV1ApiDocResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :data, as: 'data', class: Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDoc, decorator: Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDoc::Representation
+      
+          property :error_code, as: 'errorCode'
+          property :message, as: 'message'
+          property :request_id, as: 'requestId'
+          property :status, as: 'status'
+        end
+      end
+      
       class GoogleCloudApigeeV1ApiProduct
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -2564,6 +2669,14 @@ module Google
         end
       end
       
+      class GoogleCloudApigeeV1DocumentationFile
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :contents, :base64 => true, as: 'contents'
+          property :display_name, as: 'displayName'
+        end
+      end
+      
       class GoogleCloudApigeeV1EnableSecurityActionRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -2828,6 +2941,15 @@ module Google
         end
       end
       
+      class GoogleCloudApigeeV1GraphqlDocumentation
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :endpoint_uri, as: 'endpointUri'
+          property :schema, as: 'schema', class: Google::Apis::ApigeeV1::GoogleCloudApigeeV1DocumentationFile, decorator: Google::Apis::ApigeeV1::GoogleCloudApigeeV1DocumentationFile::Representation
+      
+        end
+      end
+      
       class GoogleCloudApigeeV1GrpcOperationConfig
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -2980,6 +3102,19 @@ module Google
         end
       end
       
+      class GoogleCloudApigeeV1ListApiDocsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :data, as: 'data', class: Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDoc, decorator: Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDoc::Representation
+      
+          property :error_code, as: 'errorCode'
+          property :message, as: 'message'
+          property :next_page_token, as: 'nextPageToken'
+          property :request_id, as: 'requestId'
+          property :status, as: 'status'
+        end
+      end
+      
       class GoogleCloudApigeeV1ListApiProductsResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -3325,6 +3460,15 @@ module Google
         end
       end
       
+      class GoogleCloudApigeeV1OasDocumentation
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :format, as: 'format'
+          property :spec, as: 'spec', class: Google::Apis::ApigeeV1::GoogleCloudApigeeV1DocumentationFile, decorator: Google::Apis::ApigeeV1::GoogleCloudApigeeV1DocumentationFile::Representation
+      
+        end
+      end
+      
       class GoogleCloudApigeeV1Operation
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/lib/google/apis/apigee_v1/service.rb

@@ -11532,6 +11532,244 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Creates a new catalog item.
+        # @param [String] parent
+        #   Required. Name of the portal. Use the following structure in your request: `
+        #   organizations/`org`/sites/`site``
+        # @param [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDoc] google_cloud_apigee_v1_api_doc_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDocResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDocResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def create_organization_site_apidoc(parent, google_cloud_apigee_v1_api_doc_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+parent}/apidocs', options)
+          command.request_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDoc::Representation
+          command.request_object = google_cloud_apigee_v1_api_doc_object
+          command.response_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDocResponse::Representation
+          command.response_class = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDocResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Deletes a catalog item.
+        # @param [String] name
+        #   Required. Name of the catalog item. Use the following structure in your
+        #   request: `organizations/`org`/sites/`site`/apidocs/`apidoc``
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ApigeeV1::GoogleCloudApigeeV1DeleteResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1DeleteResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def delete_organization_site_apidoc(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1DeleteResponse::Representation
+          command.response_class = Google::Apis::ApigeeV1::GoogleCloudApigeeV1DeleteResponse
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets a catalog item.
+        # @param [String] name
+        #   Required. Name of the catalog item. Use the following structure in your
+        #   request: `organizations/`org`/sites/`site`/apidocs/`apidoc``
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDocResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDocResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_organization_site_apidoc(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDocResponse::Representation
+          command.response_class = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDocResponse
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets the documentation for the specified catalog item.
+        # @param [String] name
+        #   Required. Resource name of the catalog item documentation. Use the following
+        #   structure in your request: `organizations/`org`/sites/`site`/apidocs/`apidoc`/
+        #   documentation`
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDocDocumentationResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDocDocumentationResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_organization_site_apidoc_documentation(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDocDocumentationResponse::Representation
+          command.response_class = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDocDocumentationResponse
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Returns the catalog items associated with a portal.
+        # @param [String] parent
+        #   Required. Name of the portal. Use the following structure in your request: `
+        #   organizations/`org`/sites/`site``
+        # @param [Fixnum] page_size
+        #   Optional. The maximum number of items to return. The service may return fewer
+        #   than this value. If unspecified, at most 25 books will be returned. The
+        #   maximum value is 100; values above 100 will be coerced to 100.
+        # @param [String] page_token
+        #   Optional. A page token, received from a previous `ListApiDocs` call. Provide
+        #   this to retrieve the subsequent page.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ListApiDocsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ListApiDocsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_organization_site_apidocs(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+parent}/apidocs', options)
+          command.response_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ListApiDocsResponse::Representation
+          command.response_class = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ListApiDocsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Updates a catalog item.
+        # @param [String] name
+        #   Required. Name of the catalog item. Use the following structure in your
+        #   request: `organizations/`org`/sites/`site`/apidocs/`apidoc``
+        # @param [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDoc] google_cloud_apigee_v1_api_doc_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDocResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDocResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def update_organization_site_apidoc(name, google_cloud_apigee_v1_api_doc_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:put, 'v1/{+name}', options)
+          command.request_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDoc::Representation
+          command.request_object = google_cloud_apigee_v1_api_doc_object
+          command.response_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDocResponse::Representation
+          command.response_class = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDocResponse
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Updates the documentation for the specified catalog item. Note that the
+        # documentation file contents will not be populated in the return message.
+        # @param [String] name
+        #   Required. Resource name of the catalog item documentation. Use the following
+        #   structure in your request: `organizations/`org`/sites/`site`/apidocs/`apidoc`/
+        #   documentation`
+        # @param [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDocDocumentation] google_cloud_apigee_v1_api_doc_documentation_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDocDocumentationResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDocDocumentationResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def update_organization_site_apidoc_documentation(name, google_cloud_apigee_v1_api_doc_documentation_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:patch, 'v1/{+name}', options)
+          command.request_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDocDocumentation::Representation
+          command.request_object = google_cloud_apigee_v1_api_doc_documentation_object
+          command.response_representation = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDocDocumentationResponse::Representation
+          command.response_class = Google::Apis::ApigeeV1::GoogleCloudApigeeV1ApiDocDocumentationResponse
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Provisions a new Apigee organization with a functioning runtime. This is the
         # standard way to create trial organizations for a free Apigee trial.
         # @param [String] project

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-apigee_v1
 version: !ruby/object:Gem::Version
-  version: 0.84.0
+  version: 0.86.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-02-25 00:00:00.000000000 Z
+date: 2024-03-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-apigee_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-apigee_v1/v0.84.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-apigee_v1/v0.86.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-apigee_v1
 post_install_message: 
 rdoc_options: []