{ "discoveryVersion": "v1", "parameters": { "access_token": { "type": "string", "description": "OAuth access token.", "location": "query" }, "alt": { "type": "string", "description": "Data format for response.", "default": "json", "enum": [ "json", "media", "proto" ], "enumDescriptions": [ "Responses with Content-Type of application/json", "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ], "location": "query" }, "callback": { "type": "string", "description": "JSONP", "location": "query" }, "fields": { "type": "string", "description": "Selector specifying which fields to include in a partial response.", "location": "query" }, "key": { "type": "string", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.", "location": "query" }, "oauth_token": { "type": "string", "description": "OAuth 2.0 token for the current user.", "location": "query" }, "prettyPrint": { "type": "boolean", "description": "Returns response with indentations and line breaks.", "default": "true", "location": "query" }, "quotaUser": { "type": "string", "description": "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.", "location": "query" }, "upload_protocol": { "type": "string", "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", "location": "query" }, "uploadType": { "type": "string", "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", "location": "query" }, "$.xgafv": { "type": "string", "description": "V1 error format.", "enum": [ "1", "2" ], "enumDescriptions": [ "v1 error format", "v2 error format" ], "location": "query" } }, "version_module": true, "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", "x32": "http://www.google.com/images/icons/product/search-32.gif" }, "auth": { "oauth2": { "scopes": { "https://www.googleapis.com/auth/cloud-platform": { "description": "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account." } } } }, "baseUrl": "https://developerconnect.googleapis.com/", "title": "Developer Connect API", "id": "developerconnect:v1", "name": "developerconnect", "ownerName": "Google", "version": "v1", "mtlsRootUrl": "https://developerconnect.mtls.googleapis.com/", "ownerDomain": "google.com", "canonicalName": "Developer Connect", "documentationLink": "http://cloud.google.com/developer-connect/docs/overview", "servicePath": "", "rootUrl": "https://developerconnect.googleapis.com/", "revision": "20260403", "fullyEncodeReservedExpansion": true, "basePath": "", "resources": { "projects": { "resources": { "locations": { "methods": { "list": { "id": "developerconnect.projects.locations.list", "path": "v1/{+name}/locations", "flatPath": "v1/projects/{projectsId}/locations", "httpMethod": "GET", "parameters": { "name": { "description": "The resource that owns the locations collection, if applicable.", "pattern": "^projects/[^/]+$", "location": "path", "required": true, "type": "string" }, "filter": { "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like `\"displayName=tokyo\"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).", "location": "query", "type": "string" }, "pageSize": { "description": "The maximum number of results to return. If not set, the service selects a default.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "description": "A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page.", "location": "query", "type": "string" }, "extraLocationTypes": { "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", "location": "query", "repeated": true, "type": "string" } }, "parameterOrder": [ "name" ], "response": { "$ref": "ListLocationsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the [ListLocationsRequest.name] field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version." }, "get": { "id": "developerconnect.projects.locations.get", "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}", "httpMethod": "GET", "parameters": { "name": { "description": "Resource name for the location.", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "response": { "$ref": "Location" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets information about a location." } }, "resources": { "operations": { "methods": { "list": { "id": "developerconnect.projects.locations.operations.list", "path": "v1/{+name}/operations", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations", "httpMethod": "GET", "parameters": { "name": { "description": "The name of the operation's parent resource.", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "type": "string" }, "filter": { "description": "The standard list filter.", "location": "query", "type": "string" }, "pageSize": { "description": "The standard list page size.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "description": "The standard list page token.", "location": "query", "type": "string" }, "returnPartialSuccess": { "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query", "type": "boolean" } }, "parameterOrder": [ "name" ], "response": { "$ref": "ListOperationsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`." }, "get": { "id": "developerconnect.projects.locations.operations.get", "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", "httpMethod": "GET", "parameters": { "name": { "description": "The name of the operation resource.", "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service." }, "delete": { "id": "developerconnect.projects.locations.operations.delete", "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", "httpMethod": "DELETE", "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "response": { "$ref": "Empty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`." }, "cancel": { "id": "developerconnect.projects.locations.operations.cancel", "path": "v1/{+name}:cancel", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel", "httpMethod": "POST", "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "request": { "$ref": "CancelOperationRequest" }, "response": { "$ref": "Empty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`." } } }, "connections": { "methods": { "list": { "id": "developerconnect.projects.locations.connections.list", "path": "v1/{+parent}/connections", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections", "httpMethod": "GET", "parameters": { "parent": { "description": "Required. Parent value for ListConnectionsRequest", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "type": "string" }, "pageSize": { "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "description": "Optional. A token identifying a page of results the server should return.", "location": "query", "type": "string" }, "filter": { "description": "Optional. Filtering results", "location": "query", "type": "string" }, "orderBy": { "description": "Optional. Hint for how to order the results", "location": "query", "type": "string" } }, "parameterOrder": [ "parent" ], "response": { "$ref": "ListConnectionsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists Connections in a given project and location." }, "get": { "id": "developerconnect.projects.locations.connections.get", "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections/{connectionsId}", "httpMethod": "GET", "parameters": { "name": { "description": "Required. Name of the resource", "pattern": "^projects/[^/]+/locations/[^/]+/connections/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "response": { "$ref": "Connection" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets details of a single Connection." }, "create": { "id": "developerconnect.projects.locations.connections.create", "path": "v1/{+parent}/connections", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections", "httpMethod": "POST", "parameters": { "parent": { "description": "Required. Value for parent.", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "type": "string" }, "connectionId": { "description": "Required. Id of the requesting object If auto-generating Id server-side, remove this field and connection_id from the method_signature of Create RPC", "location": "query", "type": "string" }, "requestId": { "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "location": "query", "type": "string" }, "validateOnly": { "description": "Optional. If set, validate the request, but do not actually post it.", "location": "query", "type": "boolean" } }, "parameterOrder": [ "parent" ], "request": { "$ref": "Connection" }, "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Creates a new Connection in a given project and location." }, "patch": { "id": "developerconnect.projects.locations.connections.patch", "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections/{connectionsId}", "httpMethod": "PATCH", "parameters": { "name": { "description": "Identifier. The resource name of the connection, in the format `projects/{project}/locations/{location}/connections/{connection_id}`.", "pattern": "^projects/[^/]+/locations/[^/]+/connections/[^/]+$", "location": "path", "required": true, "type": "string" }, "updateMask": { "description": "Required. Field mask is used to specify the fields to be overwritten in the Connection resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.", "location": "query", "type": "string", "format": "google-fieldmask" }, "requestId": { "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "location": "query", "type": "string" }, "allowMissing": { "description": "Optional. If set to true, and the connection is not found a new connection will be created. In this situation `update_mask` is ignored. The creation will succeed only if the input connection has all the necessary information (e.g a github_config with both user_oauth_token and installation_id properties).", "location": "query", "type": "boolean" }, "validateOnly": { "description": "Optional. If set, validate the request, but do not actually post it.", "location": "query", "type": "boolean" } }, "parameterOrder": [ "name" ], "request": { "$ref": "Connection" }, "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Updates the parameters of a single Connection." }, "delete": { "id": "developerconnect.projects.locations.connections.delete", "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections/{connectionsId}", "httpMethod": "DELETE", "parameters": { "name": { "description": "Required. Name of the resource", "pattern": "^projects/[^/]+/locations/[^/]+/connections/[^/]+$", "location": "path", "required": true, "type": "string" }, "requestId": { "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "location": "query", "type": "string" }, "validateOnly": { "description": "Optional. If set, validate the request, but do not actually post it.", "location": "query", "type": "boolean" }, "etag": { "description": "Optional. The current etag of the Connection. If an etag is provided and does not match the current etag of the Connection, deletion will be blocked and an ABORTED error will be returned.", "location": "query", "type": "string" } }, "parameterOrder": [ "name" ], "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a single Connection." }, "fetchLinkableGitRepositories": { "id": "developerconnect.projects.locations.connections.fetchLinkableGitRepositories", "path": "v1/{+connection}:fetchLinkableGitRepositories", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections/{connectionsId}:fetchLinkableGitRepositories", "httpMethod": "GET", "parameters": { "connection": { "description": "Required. The name of the Connection. Format: `projects/*/locations/*/connections/*`.", "pattern": "^projects/[^/]+/locations/[^/]+/connections/[^/]+$", "location": "path", "required": true, "type": "string" }, "pageSize": { "description": "Optional. Number of results to return in the list. Defaults to 20.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "description": "Optional. Page start.", "location": "query", "type": "string" } }, "parameterOrder": [ "connection" ], "response": { "$ref": "FetchLinkableGitRepositoriesResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "FetchLinkableGitRepositories returns a list of git repositories from an SCM that are available to be added to a Connection." }, "fetchGitHubInstallations": { "id": "developerconnect.projects.locations.connections.fetchGitHubInstallations", "path": "v1/{+connection}:fetchGitHubInstallations", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections/{connectionsId}:fetchGitHubInstallations", "httpMethod": "GET", "parameters": { "connection": { "description": "Required. The resource name of the connection in the format `projects/*/locations/*/connections/*`.", "pattern": "^projects/[^/]+/locations/[^/]+/connections/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "connection" ], "response": { "$ref": "FetchGitHubInstallationsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "FetchGitHubInstallations returns the list of GitHub Installations that are available to be added to a Connection. For github.com, only installations accessible to the authorizer token are returned. For GitHub Enterprise, all installations are returned." }, "processGitHubEnterpriseWebhook": { "id": "developerconnect.projects.locations.connections.processGitHubEnterpriseWebhook", "path": "v1/{+parent}/connections:processGitHubEnterpriseWebhook", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections:processGitHubEnterpriseWebhook", "httpMethod": "POST", "parameters": { "parent": { "description": "Required. Project and location where the webhook will be received. Format: `projects/*/locations/*`.", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "parent" ], "request": { "$ref": "ProcessGitHubEnterpriseWebhookRequest" }, "response": { "$ref": "Empty" }, "description": "ProcessGitHubEnterpriseWebhook is called by the external GitHub Enterprise instances for notifying events." } }, "resources": { "gitRepositoryLinks": { "methods": { "create": { "id": "developerconnect.projects.locations.connections.gitRepositoryLinks.create", "path": "v1/{+parent}/gitRepositoryLinks", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections/{connectionsId}/gitRepositoryLinks", "httpMethod": "POST", "parameters": { "parent": { "description": "Required. Value for parent.", "pattern": "^projects/[^/]+/locations/[^/]+/connections/[^/]+$", "location": "path", "required": true, "type": "string" }, "gitRepositoryLinkId": { "description": "Required. The ID to use for the repository, which will become the final component of the repository's resource name. This ID should be unique in the connection. Allows alphanumeric characters and any of -._~%!$&'()*+,;=@.", "location": "query", "type": "string" }, "requestId": { "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "location": "query", "type": "string" }, "validateOnly": { "description": "Optional. If set, validate the request, but do not actually post it.", "location": "query", "type": "boolean" } }, "parameterOrder": [ "parent" ], "request": { "$ref": "GitRepositoryLink" }, "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Creates a GitRepositoryLink. Upon linking a Git Repository, Developer Connect will configure the Git Repository to send webhook events to Developer Connect. Connections that use Firebase GitHub Application will have events forwarded to the Firebase service. Connections that use Gemini Code Assist will have events forwarded to Gemini Code Assist service. All other Connections will have events forwarded to Cloud Build." }, "delete": { "id": "developerconnect.projects.locations.connections.gitRepositoryLinks.delete", "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections/{connectionsId}/gitRepositoryLinks/{gitRepositoryLinksId}", "httpMethod": "DELETE", "parameters": { "name": { "description": "Required. Name of the resource", "pattern": "^projects/[^/]+/locations/[^/]+/connections/[^/]+/gitRepositoryLinks/[^/]+$", "location": "path", "required": true, "type": "string" }, "requestId": { "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "location": "query", "type": "string" }, "validateOnly": { "description": "Optional. If set, validate the request, but do not actually post it.", "location": "query", "type": "boolean" }, "etag": { "description": "Optional. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.", "location": "query", "type": "string" } }, "parameterOrder": [ "name" ], "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a single GitRepositoryLink." }, "list": { "id": "developerconnect.projects.locations.connections.gitRepositoryLinks.list", "path": "v1/{+parent}/gitRepositoryLinks", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections/{connectionsId}/gitRepositoryLinks", "httpMethod": "GET", "parameters": { "parent": { "description": "Required. Parent value for ListGitRepositoryLinksRequest", "pattern": "^projects/[^/]+/locations/[^/]+/connections/[^/]+$", "location": "path", "required": true, "type": "string" }, "pageSize": { "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "description": "Optional. A token identifying a page of results the server should return.", "location": "query", "type": "string" }, "filter": { "description": "Optional. Filtering results", "location": "query", "type": "string" }, "orderBy": { "description": "Optional. Hint for how to order the results", "location": "query", "type": "string" } }, "parameterOrder": [ "parent" ], "response": { "$ref": "ListGitRepositoryLinksResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists GitRepositoryLinks in a given project, location, and connection." }, "get": { "id": "developerconnect.projects.locations.connections.gitRepositoryLinks.get", "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections/{connectionsId}/gitRepositoryLinks/{gitRepositoryLinksId}", "httpMethod": "GET", "parameters": { "name": { "description": "Required. Name of the resource", "pattern": "^projects/[^/]+/locations/[^/]+/connections/[^/]+/gitRepositoryLinks/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "response": { "$ref": "GitRepositoryLink" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets details of a single GitRepositoryLink." }, "fetchReadWriteToken": { "id": "developerconnect.projects.locations.connections.gitRepositoryLinks.fetchReadWriteToken", "path": "v1/{+gitRepositoryLink}:fetchReadWriteToken", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections/{connectionsId}/gitRepositoryLinks/{gitRepositoryLinksId}:fetchReadWriteToken", "httpMethod": "POST", "parameters": { "gitRepositoryLink": { "description": "Required. The resource name of the gitRepositoryLink in the format `projects/*/locations/*/connections/*/gitRepositoryLinks/*`.", "pattern": "^projects/[^/]+/locations/[^/]+/connections/[^/]+/gitRepositoryLinks/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "gitRepositoryLink" ], "request": { "$ref": "FetchReadWriteTokenRequest" }, "response": { "$ref": "FetchReadWriteTokenResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Fetches read/write token of a given gitRepositoryLink." }, "fetchReadToken": { "id": "developerconnect.projects.locations.connections.gitRepositoryLinks.fetchReadToken", "path": "v1/{+gitRepositoryLink}:fetchReadToken", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections/{connectionsId}/gitRepositoryLinks/{gitRepositoryLinksId}:fetchReadToken", "httpMethod": "POST", "parameters": { "gitRepositoryLink": { "description": "Required. The resource name of the gitRepositoryLink in the format `projects/*/locations/*/connections/*/gitRepositoryLinks/*`.", "pattern": "^projects/[^/]+/locations/[^/]+/connections/[^/]+/gitRepositoryLinks/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "gitRepositoryLink" ], "request": { "$ref": "FetchReadTokenRequest" }, "response": { "$ref": "FetchReadTokenResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Fetches read token of a given gitRepositoryLink." }, "fetchGitRefs": { "id": "developerconnect.projects.locations.connections.gitRepositoryLinks.fetchGitRefs", "path": "v1/{+gitRepositoryLink}:fetchGitRefs", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections/{connectionsId}/gitRepositoryLinks/{gitRepositoryLinksId}:fetchGitRefs", "httpMethod": "GET", "parameters": { "gitRepositoryLink": { "description": "Required. The resource name of GitRepositoryLink in the format `projects/*/locations/*/connections/*/gitRepositoryLinks/*`.", "pattern": "^projects/[^/]+/locations/[^/]+/connections/[^/]+/gitRepositoryLinks/[^/]+$", "location": "path", "required": true, "type": "string" }, "refType": { "description": "Required. Type of refs to fetch.", "location": "query", "type": "string", "enumDescriptions": [ "No type specified.", "To fetch tags.", "To fetch branches." ], "enum": [ "REF_TYPE_UNSPECIFIED", "TAG", "BRANCH" ] }, "pageSize": { "description": "Optional. Number of results to return in the list. Default to 20.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "description": "Optional. Page start.", "location": "query", "type": "string" } }, "parameterOrder": [ "gitRepositoryLink" ], "response": { "$ref": "FetchGitRefsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Fetch the list of branches or tags for a given repository." }, "processGitLabEnterpriseWebhook": { "id": "developerconnect.projects.locations.connections.gitRepositoryLinks.processGitLabEnterpriseWebhook", "path": "v1/{+name}:processGitLabEnterpriseWebhook", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections/{connectionsId}/gitRepositoryLinks/{gitRepositoryLinksId}:processGitLabEnterpriseWebhook", "httpMethod": "POST", "parameters": { "name": { "description": "Required. The GitRepositoryLink resource where the webhook will be received. Format: `projects/*/locations/*/connections/*/gitRepositoryLinks/*`.", "pattern": "^projects/[^/]+/locations/[^/]+/connections/[^/]+/gitRepositoryLinks/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "request": { "$ref": "ProcessGitLabEnterpriseWebhookRequest" }, "response": { "$ref": "Empty" }, "description": "ProcessGitLabEnterpriseWebhook is called by the external GitLab Enterprise instances for notifying events." }, "processGitLabWebhook": { "id": "developerconnect.projects.locations.connections.gitRepositoryLinks.processGitLabWebhook", "path": "v1/{+name}:processGitLabWebhook", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections/{connectionsId}/gitRepositoryLinks/{gitRepositoryLinksId}:processGitLabWebhook", "httpMethod": "POST", "parameters": { "name": { "description": "Required. The GitRepositoryLink resource where the webhook will be received. Format: `projects/*/locations/*/connections/*/gitRepositoryLinks/*`.", "pattern": "^projects/[^/]+/locations/[^/]+/connections/[^/]+/gitRepositoryLinks/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "request": { "$ref": "ProcessGitLabWebhookRequest" }, "response": { "$ref": "Empty" }, "description": "ProcessGitLabWebhook is called by the GitLab.com for notifying events." }, "processBitbucketDataCenterWebhook": { "id": "developerconnect.projects.locations.connections.gitRepositoryLinks.processBitbucketDataCenterWebhook", "path": "v1/{+name}:processBitbucketDataCenterWebhook", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections/{connectionsId}/gitRepositoryLinks/{gitRepositoryLinksId}:processBitbucketDataCenterWebhook", "httpMethod": "POST", "parameters": { "name": { "description": "Required. The GitRepositoryLink where the webhook will be received. Format: `projects/*/locations/*/connections/*/gitRepositoryLinks/*`.", "pattern": "^projects/[^/]+/locations/[^/]+/connections/[^/]+/gitRepositoryLinks/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "request": { "$ref": "ProcessBitbucketDataCenterWebhookRequest" }, "response": { "$ref": "Empty" }, "description": "ProcessBitbucketDataCenterWebhook is called by the external Bitbucket Data Center instances for notifying events." }, "processBitbucketCloudWebhook": { "id": "developerconnect.projects.locations.connections.gitRepositoryLinks.processBitbucketCloudWebhook", "path": "v1/{+name}:processBitbucketCloudWebhook", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections/{connectionsId}/gitRepositoryLinks/{gitRepositoryLinksId}:processBitbucketCloudWebhook", "httpMethod": "POST", "parameters": { "name": { "description": "Required. The GitRepositoryLink where the webhook will be received. Format: `projects/*/locations/*/connections/*/gitRepositoryLinks/*`.", "pattern": "^projects/[^/]+/locations/[^/]+/connections/[^/]+/gitRepositoryLinks/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "request": { "$ref": "ProcessBitbucketCloudWebhookRequest" }, "response": { "$ref": "Empty" }, "description": "ProcessBitbucketCloudWebhook is called by the external Bitbucket Cloud instances for notifying events." } } } } }, "accountConnectors": { "methods": { "list": { "id": "developerconnect.projects.locations.accountConnectors.list", "path": "v1/{+parent}/accountConnectors", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/accountConnectors", "httpMethod": "GET", "parameters": { "parent": { "description": "Required. Parent value for ListAccountConnectorsRequest", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "type": "string" }, "pageSize": { "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "description": "Optional. A token identifying a page of results the server should return.", "location": "query", "type": "string" }, "filter": { "description": "Optional. Filtering results", "location": "query", "type": "string" }, "orderBy": { "description": "Optional. Hint for how to order the results", "location": "query", "type": "string" } }, "parameterOrder": [ "parent" ], "response": { "$ref": "ListAccountConnectorsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists AccountConnectors in a given project and location." }, "get": { "id": "developerconnect.projects.locations.accountConnectors.get", "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/accountConnectors/{accountConnectorsId}", "httpMethod": "GET", "parameters": { "name": { "description": "Required. Name of the resource", "pattern": "^projects/[^/]+/locations/[^/]+/accountConnectors/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "response": { "$ref": "AccountConnector" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets details of a single AccountConnector." }, "create": { "id": "developerconnect.projects.locations.accountConnectors.create", "path": "v1/{+parent}/accountConnectors", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/accountConnectors", "httpMethod": "POST", "parameters": { "parent": { "description": "Required. Location resource name as the account_connector’s parent.", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "type": "string" }, "accountConnectorId": { "description": "Required. The ID to use for the AccountConnector, which will become the final component of the AccountConnector's resource name. Its format should adhere to https://google.aip.dev/122#resource-id-segments Names must be unique per-project per-location.", "location": "query", "type": "string" }, "requestId": { "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "location": "query", "type": "string" }, "validateOnly": { "description": "Optional. If set, validate the request, but do not actually post it.", "location": "query", "type": "boolean" } }, "parameterOrder": [ "parent" ], "request": { "$ref": "AccountConnector" }, "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Creates a new AccountConnector in a given project and location." }, "patch": { "id": "developerconnect.projects.locations.accountConnectors.patch", "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/accountConnectors/{accountConnectorsId}", "httpMethod": "PATCH", "parameters": { "name": { "description": "Identifier. The resource name of the accountConnector, in the format `projects/{project}/locations/{location}/accountConnectors/{account_connector_id}`.", "pattern": "^projects/[^/]+/locations/[^/]+/accountConnectors/[^/]+$", "location": "path", "required": true, "type": "string" }, "updateMask": { "description": "Optional. The list of fields to be updated.", "location": "query", "type": "string", "format": "google-fieldmask" }, "requestId": { "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "location": "query", "type": "string" }, "allowMissing": { "description": "Optional. If set to true, and the accountConnector is not found a new accountConnector will be created. In this situation `update_mask` is ignored. The creation will succeed only if the input accountConnector has all the necessary", "location": "query", "type": "boolean" }, "validateOnly": { "description": "Optional. If set, validate the request, but do not actually post it.", "location": "query", "type": "boolean" } }, "parameterOrder": [ "name" ], "request": { "$ref": "AccountConnector" }, "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Updates the parameters of a single AccountConnector." }, "delete": { "id": "developerconnect.projects.locations.accountConnectors.delete", "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/accountConnectors/{accountConnectorsId}", "httpMethod": "DELETE", "parameters": { "name": { "description": "Required. Name of the resource", "pattern": "^projects/[^/]+/locations/[^/]+/accountConnectors/[^/]+$", "location": "path", "required": true, "type": "string" }, "requestId": { "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "location": "query", "type": "string" }, "validateOnly": { "description": "Optional. If set, validate the request, but do not actually post it.", "location": "query", "type": "boolean" }, "etag": { "description": "Optional. The current etag of the AccountConnectorn. If an etag is provided and does not match the current etag of the AccountConnector, deletion will be blocked and an ABORTED error will be returned.", "location": "query", "type": "string" }, "force": { "description": "Optional. If set to true, any Users from this AccountConnector will also be deleted. (Otherwise, the request will only work if the AccountConnector has no Users.)", "location": "query", "type": "boolean" } }, "parameterOrder": [ "name" ], "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a single AccountConnector." }, "fetchUserRepositories": { "id": "developerconnect.projects.locations.accountConnectors.fetchUserRepositories", "path": "v1/{+accountConnector}:fetchUserRepositories", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/accountConnectors/{accountConnectorsId}:fetchUserRepositories", "httpMethod": "GET", "parameters": { "accountConnector": { "description": "Required. The name of the Account Connector resource in the format: `projects/*/locations/*/accountConnectors/*`.", "pattern": "^projects/[^/]+/locations/[^/]+/accountConnectors/[^/]+$", "location": "path", "required": true, "type": "string" }, "pageSize": { "description": "Optional. Number of results to return in the list. Defaults to 20.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "description": "Optional. Page start.", "location": "query", "type": "string" }, "repository": { "description": "Optional. The name of the repository. When specified, only the UserRepository with this name will be returned if the repository is accessible under this Account Connector for the calling user.", "location": "query", "type": "string" } }, "parameterOrder": [ "accountConnector" ], "response": { "$ref": "FetchUserRepositoriesResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "FetchUserRepositories returns a list of UserRepos that are available for an account connector resource." } }, "resources": { "users": { "methods": { "fetchAccessToken": { "id": "developerconnect.projects.locations.accountConnectors.users.fetchAccessToken", "path": "v1/{+accountConnector}/users:fetchAccessToken", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/accountConnectors/{accountConnectorsId}/users:fetchAccessToken", "httpMethod": "POST", "parameters": { "accountConnector": { "description": "Required. The resource name of the AccountConnector in the format `projects/*/locations/*/accountConnectors/*`.", "pattern": "^projects/[^/]+/locations/[^/]+/accountConnectors/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountConnector" ], "request": { "$ref": "FetchAccessTokenRequest" }, "response": { "$ref": "FetchAccessTokenResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Fetches OAuth access token based on end user credentials." }, "list": { "id": "developerconnect.projects.locations.accountConnectors.users.list", "path": "v1/{+parent}/users", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/accountConnectors/{accountConnectorsId}/users", "httpMethod": "GET", "parameters": { "parent": { "description": "Required. Parent value for ListUsersRequest", "pattern": "^projects/[^/]+/locations/[^/]+/accountConnectors/[^/]+$", "location": "path", "required": true, "type": "string" }, "pageSize": { "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "description": "Optional. A token identifying a page of results the server should return.", "location": "query", "type": "string" }, "filter": { "description": "Optional. Filtering results", "location": "query", "type": "string" }, "orderBy": { "description": "Optional. Hint for how to order the results", "location": "query", "type": "string" } }, "parameterOrder": [ "parent" ], "response": { "$ref": "ListUsersResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists Users in a given project, location, and account_connector." }, "delete": { "id": "developerconnect.projects.locations.accountConnectors.users.delete", "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/accountConnectors/{accountConnectorsId}/users/{usersId}", "httpMethod": "DELETE", "parameters": { "name": { "description": "Required. Name of the resource", "pattern": "^projects/[^/]+/locations/[^/]+/accountConnectors/[^/]+/users/[^/]+$", "location": "path", "required": true, "type": "string" }, "requestId": { "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "location": "query", "type": "string" }, "validateOnly": { "description": "Optional. If set, validate the request, but do not actually post it.", "location": "query", "type": "boolean" }, "etag": { "description": "Optional. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.", "location": "query", "type": "string" } }, "parameterOrder": [ "name" ], "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a single User." }, "fetchSelf": { "id": "developerconnect.projects.locations.accountConnectors.users.fetchSelf", "path": "v1/{+name}/users:fetchSelf", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/accountConnectors/{accountConnectorsId}/users:fetchSelf", "httpMethod": "GET", "parameters": { "name": { "description": "Required. Name of the AccountConnector resource", "pattern": "^projects/[^/]+/locations/[^/]+/accountConnectors/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "response": { "$ref": "User" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Fetch the User based on the user credentials." }, "deleteSelf": { "id": "developerconnect.projects.locations.accountConnectors.users.deleteSelf", "path": "v1/{+name}/users:deleteSelf", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/accountConnectors/{accountConnectorsId}/users:deleteSelf", "httpMethod": "DELETE", "parameters": { "name": { "description": "Required. Name of the AccountConnector resource", "pattern": "^projects/[^/]+/locations/[^/]+/accountConnectors/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Delete the User based on the user credentials." }, "startOAuthFlow": { "id": "developerconnect.projects.locations.accountConnectors.users.startOAuthFlow", "path": "v1/{+accountConnector}/users:startOAuthFlow", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/accountConnectors/{accountConnectorsId}/users:startOAuthFlow", "httpMethod": "GET", "parameters": { "accountConnector": { "description": "Required. The resource name of the AccountConnector in the format `projects/*/locations/*/accountConnectors/*`.", "pattern": "^projects/[^/]+/locations/[^/]+/accountConnectors/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "accountConnector" ], "response": { "$ref": "StartOAuthResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Starts OAuth flow for an account connector." }, "finishOAuthFlow": { "id": "developerconnect.projects.locations.accountConnectors.users.finishOAuthFlow", "path": "v1/{+accountConnector}/users:finishOAuthFlow", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/accountConnectors/{accountConnectorsId}/users:finishOAuthFlow", "httpMethod": "GET", "parameters": { "accountConnector": { "description": "Required. The resource name of the AccountConnector in the format `projects/*/locations/*/accountConnectors/*`.", "pattern": "^projects/[^/]+/locations/[^/]+/accountConnectors/[^/]+$", "location": "path", "required": true, "type": "string" }, "oauthParams.code": { "description": "Required. The code to be used for getting the token from SCM provider.", "location": "query", "type": "string" }, "oauthParams.ticket": { "description": "Required. The ticket to be used for post processing the callback from SCM provider.", "location": "query", "type": "string" }, "googleOauthParams.scopes": { "description": "Required. The scopes returned by Google OAuth flow.", "location": "query", "repeated": true, "type": "string" }, "googleOauthParams.versionInfo": { "description": "Optional. The version info returned by Google OAuth flow.", "location": "query", "type": "string" }, "googleOauthParams.ticket": { "description": "Required. The ticket to be used for post processing the callback from Google OAuth flow.", "location": "query", "type": "string" } }, "parameterOrder": [ "accountConnector" ], "response": { "$ref": "FinishOAuthResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Finishes OAuth flow for an account connector." } } } } }, "insightsConfigs": { "methods": { "list": { "id": "developerconnect.projects.locations.insightsConfigs.list", "path": "v1/{+parent}/insightsConfigs", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/insightsConfigs", "httpMethod": "GET", "parameters": { "parent": { "description": "Required. Parent value for ListInsightsConfigsRequest.", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "type": "string" }, "pageSize": { "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "description": "Optional. A token identifying a page of results the server should return.", "location": "query", "type": "string" }, "filter": { "description": "Optional. Filtering results. See https://google.aip.dev/160 for more details. Filter string, adhering to the rules in https://google.aip.dev/160. List only InsightsConfigs matching the filter. If filter is empty, all InsightsConfigs are listed.", "location": "query", "type": "string" }, "orderBy": { "description": "Optional. Hint for how to order the results.", "location": "query", "type": "string" } }, "parameterOrder": [ "parent" ], "response": { "$ref": "ListInsightsConfigsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists InsightsConfigs in a given project and location." }, "create": { "id": "developerconnect.projects.locations.insightsConfigs.create", "path": "v1/{+parent}/insightsConfigs", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/insightsConfigs", "httpMethod": "POST", "parameters": { "parent": { "description": "Required. Value for parent.", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "type": "string" }, "insightsConfigId": { "description": "Required. ID of the requesting InsightsConfig.", "location": "query", "type": "string" }, "validateOnly": { "description": "Optional. If set, validate the request, but do not actually post it.", "location": "query", "type": "boolean" } }, "parameterOrder": [ "parent" ], "request": { "$ref": "InsightsConfig" }, "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Creates a new InsightsConfig in a given project and location." }, "get": { "id": "developerconnect.projects.locations.insightsConfigs.get", "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/insightsConfigs/{insightsConfigsId}", "httpMethod": "GET", "parameters": { "name": { "description": "Required. Name of the resource.", "pattern": "^projects/[^/]+/locations/[^/]+/insightsConfigs/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "response": { "$ref": "InsightsConfig" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets details of a single Insight." }, "patch": { "id": "developerconnect.projects.locations.insightsConfigs.patch", "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/insightsConfigs/{insightsConfigsId}", "httpMethod": "PATCH", "parameters": { "name": { "description": "Identifier. The name of the InsightsConfig. Format: projects/{project}/locations/{location}/insightsConfigs/{insightsConfig}", "pattern": "^projects/[^/]+/locations/[^/]+/insightsConfigs/[^/]+$", "location": "path", "required": true, "type": "string" }, "requestId": { "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "location": "query", "type": "string" }, "allowMissing": { "description": "Optional. If set to true, and the insightsConfig is not found a new insightsConfig will be created. In this situation `update_mask` is ignored. The creation will succeed only if the input insightsConfig has all the necessary information (e.g a github_config with both user_oauth_token and installation_id properties).", "location": "query", "type": "boolean" }, "validateOnly": { "description": "Optional. If set, validate the request, but do not actually post it.", "location": "query", "type": "boolean" } }, "parameterOrder": [ "name" ], "request": { "$ref": "InsightsConfig" }, "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Updates the parameters of a single InsightsConfig." }, "delete": { "id": "developerconnect.projects.locations.insightsConfigs.delete", "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/insightsConfigs/{insightsConfigsId}", "httpMethod": "DELETE", "parameters": { "name": { "description": "Required. Value for parent.", "pattern": "^projects/[^/]+/locations/[^/]+/insightsConfigs/[^/]+$", "location": "path", "required": true, "type": "string" }, "requestId": { "description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).", "location": "query", "type": "string" }, "validateOnly": { "description": "Optional. If set, validate the request, but do not actually post it.", "location": "query", "type": "boolean" }, "etag": { "description": "Optional. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.", "location": "query", "type": "string" } }, "parameterOrder": [ "name" ], "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a single Insight." } }, "resources": { "deploymentEvents": { "methods": { "get": { "id": "developerconnect.projects.locations.insightsConfigs.deploymentEvents.get", "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/insightsConfigs/{insightsConfigsId}/deploymentEvents/{deploymentEventsId}", "httpMethod": "GET", "parameters": { "name": { "description": "Required. The name of the deployment event to retrieve. Format: projects/{project}/locations/{location}/insightsConfigs/{insights_config}/deploymentEvents/{uuid}", "pattern": "^projects/[^/]+/locations/[^/]+/insightsConfigs/[^/]+/deploymentEvents/[^/]+$", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "response": { "$ref": "DeploymentEvent" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets a single Deployment Event." }, "list": { "id": "developerconnect.projects.locations.insightsConfigs.deploymentEvents.list", "path": "v1/{+parent}/deploymentEvents", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/insightsConfigs/{insightsConfigsId}/deploymentEvents", "httpMethod": "GET", "parameters": { "parent": { "description": "Required. The parent insights config that owns this collection of deployment events. Format: projects/{project}/locations/{location}/insightsConfigs/{insights_config}", "pattern": "^projects/[^/]+/locations/[^/]+/insightsConfigs/[^/]+$", "location": "path", "required": true, "type": "string" }, "pageSize": { "description": "Optional. The maximum number of deployment events to return. The service may return fewer than this value. If unspecified, at most 50 deployment events will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "description": "Optional. A page token, received from a previous `ListDeploymentEvents` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListDeploymentEvents` must match the call that provided the page token.", "location": "query", "type": "string" }, "filter": { "description": "Optional. Filter expression that matches a subset of the DeploymentEvents. https://google.aip.dev/160.", "location": "query", "type": "string" } }, "parameterOrder": [ "parent" ], "response": { "$ref": "ListDeploymentEventsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists Deployment Events in a given insights config." } } } } } } } } } }, "batchPath": "batch", "protocol": "rest", "schemas": { "ListOperationsResponse": { "id": "ListOperationsResponse", "description": "The response message for Operations.ListOperations.", "type": "object", "properties": { "operations": { "description": "A list of operations that matches the specified filter in the request.", "type": "array", "items": { "$ref": "Operation" } }, "nextPageToken": { "description": "The standard List next-page token.", "type": "string" }, "unreachable": { "description": "Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections. For example, when attempting to list all resources across all supported locations.", "type": "array", "items": { "type": "string" } } } }, "Operation": { "id": "Operation", "description": "This resource represents a long-running operation that is the result of a network API call.", "type": "object", "properties": { "name": { "description": "The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.", "type": "string" }, "metadata": { "description": "Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.", "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." } }, "done": { "description": "If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.", "type": "boolean" }, "error": { "description": "The error result of the operation in case of failure or cancellation.", "$ref": "Status" }, "response": { "description": "The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.", "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." } } } }, "Status": { "id": "Status", "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", "type": "object", "properties": { "code": { "description": "The status code, which should be an enum value of google.rpc.Code.", "type": "integer", "format": "int32" }, "message": { "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.", "type": "string" }, "details": { "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", "type": "array", "items": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." } } } } }, "Empty": { "id": "Empty", "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }", "type": "object", "properties": {} }, "CancelOperationRequest": { "id": "CancelOperationRequest", "description": "The request message for Operations.CancelOperation.", "type": "object", "properties": {} }, "ListConnectionsResponse": { "id": "ListConnectionsResponse", "description": "Message for response to listing Connections", "type": "object", "properties": { "connections": { "description": "The list of Connection", "type": "array", "items": { "$ref": "Connection" } }, "nextPageToken": { "description": "A token identifying a page of results the server should return.", "type": "string" }, "unreachable": { "description": "Locations that could not be reached.", "type": "array", "items": { "type": "string" } } } }, "Connection": { "id": "Connection", "description": "Message describing Connection object", "type": "object", "properties": { "githubConfig": { "description": "Configuration for connections to github.com.", "$ref": "GitHubConfig" }, "githubEnterpriseConfig": { "description": "Configuration for connections to an instance of GitHub Enterprise.", "$ref": "GitHubEnterpriseConfig" }, "gitlabConfig": { "description": "Configuration for connections to gitlab.com.", "$ref": "GitLabConfig" }, "gitlabEnterpriseConfig": { "description": "Configuration for connections to an instance of GitLab Enterprise.", "$ref": "GitLabEnterpriseConfig" }, "bitbucketDataCenterConfig": { "description": "Configuration for connections to an instance of Bitbucket Data Center.", "$ref": "BitbucketDataCenterConfig" }, "bitbucketCloudConfig": { "description": "Configuration for connections to an instance of Bitbucket Clouds.", "$ref": "BitbucketCloudConfig" }, "secureSourceManagerInstanceConfig": { "description": "Configuration for connections to an instance of Secure Source Manager.", "$ref": "SecureSourceManagerInstanceConfig" }, "httpConfig": { "description": "Optional. Configuration for connections to an HTTP service provider.", "$ref": "GenericHTTPEndpointConfig" }, "name": { "description": "Identifier. The resource name of the connection, in the format `projects/{project}/locations/{location}/connections/{connection_id}`.", "type": "string" }, "createTime": { "description": "Output only. [Output only] Create timestamp", "readOnly": true, "type": "string", "format": "google-datetime" }, "updateTime": { "description": "Output only. [Output only] Update timestamp", "readOnly": true, "type": "string", "format": "google-datetime" }, "deleteTime": { "description": "Output only. [Output only] Delete timestamp", "readOnly": true, "type": "string", "format": "google-datetime" }, "labels": { "description": "Optional. Labels as key value pairs", "type": "object", "additionalProperties": { "type": "string" } }, "installationState": { "description": "Output only. Installation state of the Connection.", "readOnly": true, "$ref": "InstallationState" }, "disabled": { "description": "Optional. If disabled is set to true, functionality is disabled for this connection. Repository based API methods and webhooks processing for repositories in this connection will be disabled.", "type": "boolean" }, "reconciling": { "description": "Output only. Set to true when the connection is being set up or updated in the background.", "readOnly": true, "type": "boolean" }, "annotations": { "description": "Optional. Allows clients to store small amounts of arbitrary data.", "type": "object", "additionalProperties": { "type": "string" } }, "etag": { "description": "Optional. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.", "type": "string" }, "uid": { "description": "Output only. A system-assigned unique identifier for the Connection.", "readOnly": true, "type": "string" }, "cryptoKeyConfig": { "description": "Optional. The crypto key configuration. This field is used by the Customer-Managed Encryption Keys (CMEK) feature.", "$ref": "CryptoKeyConfig" }, "gitProxyConfig": { "description": "Optional. Configuration for the git proxy feature. Enabling the git proxy allows clients to perform git operations on the repositories linked in the connection. [Learn more](https://docs.cloud.google.com/developer-connect/docs/configure-git-proxy).", "$ref": "GitProxyConfig" } } }, "GitHubConfig": { "id": "GitHubConfig", "description": "Configuration for connections to github.com.", "type": "object", "properties": { "githubApp": { "description": "Required. Immutable. The GitHub Application that was installed to the GitHub user or organization.", "type": "string", "enumDescriptions": [ "GitHub App not specified.", "The Developer Connect GitHub Application.", "The Firebase GitHub Application.", "The Gemini Code Assist Application.", "The Dataform GitHub Application." ], "enum": [ "GIT_HUB_APP_UNSPECIFIED", "DEVELOPER_CONNECT", "FIREBASE", "GEMINI_CODE_ASSIST", "DATAFORM" ] }, "authorizerCredential": { "description": "Optional. OAuth credential of the account that authorized the GitHub App. It is recommended to use a robot account instead of a human user account. The OAuth token must be tied to the GitHub App of this config.", "$ref": "OAuthCredential" }, "appInstallationId": { "description": "Optional. GitHub App installation id.", "type": "string", "format": "int64" }, "installationUri": { "description": "Output only. The URI to navigate to in order to manage the installation associated with this GitHubConfig.", "readOnly": true, "type": "string" } } }, "OAuthCredential": { "id": "OAuthCredential", "description": "Represents an OAuth token of the account that authorized the Connection, and associated metadata.", "type": "object", "properties": { "oauthTokenSecretVersion": { "description": "Required. A SecretManager resource containing the OAuth token that authorizes the connection. Format: `projects/*/secrets/*/versions/*` or `projects/*/locations/*/secrets/*/versions/*` (if regional secrets are supported in that location).", "type": "string" }, "username": { "description": "Output only. The username associated with this token.", "readOnly": true, "type": "string" } } }, "GitHubEnterpriseConfig": { "id": "GitHubEnterpriseConfig", "description": "Configuration for connections to an instance of GitHub Enterprise.", "type": "object", "properties": { "hostUri": { "description": "Required. The URI of the GitHub Enterprise host this connection is for.", "type": "string" }, "appId": { "description": "Optional. ID of the GitHub App created from the manifest.", "type": "string", "format": "int64" }, "appSlug": { "description": "Output only. The URL-friendly name of the GitHub App.", "readOnly": true, "type": "string" }, "privateKeySecretVersion": { "description": "Optional. SecretManager resource containing the private key of the GitHub App, formatted as `projects/*/secrets/*/versions/*` or `projects/*/locations/*/secrets/*/versions/*` (if regional secrets are supported in that location).", "type": "string" }, "webhookSecretSecretVersion": { "description": "Optional. SecretManager resource containing the webhook secret of the GitHub App, formatted as `projects/*/secrets/*/versions/*` or `projects/*/locations/*/secrets/*/versions/*` (if regional secrets are supported in that location).", "type": "string" }, "appInstallationId": { "description": "Optional. ID of the installation of the GitHub App.", "type": "string", "format": "int64" }, "installationUri": { "description": "Output only. The URI to navigate to in order to manage the installation associated with this GitHubEnterpriseConfig.", "readOnly": true, "type": "string" }, "serviceDirectoryConfig": { "description": "Optional. Configuration for using Service Directory to privately connect to a GitHub Enterprise server. This should only be set if the GitHub Enterprise server is hosted on-premises and not reachable by public internet. If this field is left empty, calls to the GitHub Enterprise server will be made over the public internet.", "$ref": "ServiceDirectoryConfig" }, "serverVersion": { "description": "Output only. GitHub Enterprise version installed at the host_uri.", "readOnly": true, "type": "string" }, "sslCaCertificate": { "description": "Optional. SSL certificate to use for requests to GitHub Enterprise.", "type": "string" }, "organization": { "description": "Optional. Immutable. GitHub Enterprise organization in which the GitHub App is created.", "type": "string" } } }, "ServiceDirectoryConfig": { "id": "ServiceDirectoryConfig", "description": "ServiceDirectoryConfig represents Service Directory configuration for a connection.", "type": "object", "properties": { "service": { "description": "Required. The Service Directory service name. Format: projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}.", "type": "string" } } }, "GitLabConfig": { "id": "GitLabConfig", "description": "Configuration for connections to gitlab.com.", "type": "object", "properties": { "webhookSecretSecretVersion": { "description": "Required. Immutable. SecretManager resource containing the webhook secret of a GitLab project, formatted as `projects/*/secrets/*/versions/*` or `projects/*/locations/*/secrets/*/versions/*` (if regional secrets are supported in that location). This is used to validate webhooks.", "type": "string" }, "readAuthorizerCredential": { "description": "Required. A GitLab personal access token with the minimum `read_api` scope access and a minimum role of `reporter`. The GitLab Projects visible to this Personal Access Token will control which Projects Developer Connect has access to.", "$ref": "UserCredential" }, "authorizerCredential": { "description": "Required. A GitLab personal access token with the minimum `api` scope access and a minimum role of `maintainer`. The GitLab Projects visible to this Personal Access Token will control which Projects Developer Connect has access to.", "$ref": "UserCredential" } } }, "UserCredential": { "id": "UserCredential", "description": "Represents a personal access token that authorized the Connection, and associated metadata.", "type": "object", "properties": { "userTokenSecretVersion": { "description": "Required. A SecretManager resource containing the user token that authorizes the Developer Connect connection. Format: `projects/*/secrets/*/versions/*` or `projects/*/locations/*/secrets/*/versions/*` (if regional secrets are supported in that location).", "type": "string" }, "username": { "description": "Output only. The username associated with this token.", "readOnly": true, "type": "string" } } }, "GitLabEnterpriseConfig": { "id": "GitLabEnterpriseConfig", "description": "Configuration for connections to an instance of GitLab Enterprise.", "type": "object", "properties": { "hostUri": { "description": "Required. The URI of the GitLab Enterprise host this connection is for.", "type": "string" }, "webhookSecretSecretVersion": { "description": "Required. Immutable. SecretManager resource containing the webhook secret of a GitLab project, formatted as `projects/*/secrets/*/versions/*` or `projects/*/locations/*/secrets/*/versions/*` (if regional secrets are supported in that location). This is used to validate webhooks.", "type": "string" }, "readAuthorizerCredential": { "description": "Required. A GitLab personal access token with the minimum `read_api` scope access and a minimum role of `reporter`. The GitLab Projects visible to this Personal Access Token will control which Projects Developer Connect has access to.", "$ref": "UserCredential" }, "authorizerCredential": { "description": "Required. A GitLab personal access token with the minimum `api` scope access and a minimum role of `maintainer`. The GitLab Projects visible to this Personal Access Token will control which Projects Developer Connect has access to.", "$ref": "UserCredential" }, "serviceDirectoryConfig": { "description": "Optional. Configuration for using Service Directory to privately connect to a GitLab Enterprise instance. This should only be set if the GitLab Enterprise server is hosted on-premises and not reachable by public internet. If this field is left empty, calls to the GitLab Enterprise server will be made over the public internet.", "$ref": "ServiceDirectoryConfig" }, "sslCaCertificate": { "description": "Optional. SSL Certificate Authority certificate to use for requests to GitLab Enterprise instance.", "type": "string" }, "serverVersion": { "description": "Output only. Version of the GitLab Enterprise server running on the `host_uri`.", "readOnly": true, "type": "string" } } }, "BitbucketDataCenterConfig": { "id": "BitbucketDataCenterConfig", "description": "Configuration for connections to an instance of Bitbucket Data Center.", "type": "object", "properties": { "hostUri": { "description": "Required. The URI of the Bitbucket Data Center host this connection is for.", "type": "string" }, "webhookSecretSecretVersion": { "description": "Required. Immutable. SecretManager resource containing the webhook secret used to verify webhook events, formatted as `projects/*/secrets/*/versions/*` or `projects/*/locations/*/secrets/*/versions/*` (if regional secrets are supported in that location). This is used to validate webhooks.", "type": "string" }, "readAuthorizerCredential": { "description": "Required. An http access token with the minimum `Repository read` access. It's recommended to use a system account to generate the credentials.", "$ref": "UserCredential" }, "authorizerCredential": { "description": "Required. An http access token with the minimum `Repository admin` scope access. This is needed to create webhooks. It's recommended to use a system account to generate these credentials.", "$ref": "UserCredential" }, "serviceDirectoryConfig": { "description": "Optional. Configuration for using Service Directory to privately connect to a Bitbucket Data Center instance. This should only be set if the Bitbucket Data Center is hosted on-premises and not reachable by public internet. If this field is left empty, calls to the Bitbucket Data Center will be made over the public internet.", "$ref": "ServiceDirectoryConfig" }, "sslCaCertificate": { "description": "Optional. SSL certificate authority to trust when making requests to Bitbucket Data Center.", "type": "string" }, "serverVersion": { "description": "Output only. Version of the Bitbucket Data Center server running on the `host_uri`.", "readOnly": true, "type": "string" } } }, "BitbucketCloudConfig": { "id": "BitbucketCloudConfig", "description": "Configuration for connections to an instance of Bitbucket Cloud.", "type": "object", "properties": { "workspace": { "description": "Required. The Bitbucket Cloud Workspace ID to be connected to Google Cloud Platform.", "type": "string" }, "webhookSecretSecretVersion": { "description": "Required. Immutable. SecretManager resource containing the webhook secret used to verify webhook events, formatted as `projects/*/secrets/*/versions/*` or `projects/*/locations/*/secrets/*/versions/*` (if regional secrets are supported in that location). This is used to validate and create webhooks.", "type": "string" }, "readAuthorizerCredential": { "description": "Required. An access token with the minimum `repository` access. It can either be a workspace, project or repository access token. It's recommended to use a system account to generate the credentials.", "$ref": "UserCredential" }, "authorizerCredential": { "description": "Required. An access token with the minimum `repository`, `pullrequest` and `webhook` scope access. It can either be a workspace, project or repository access token. This is needed to create webhooks. It's recommended to use a system account to generate these credentials.", "$ref": "UserCredential" } } }, "SecureSourceManagerInstanceConfig": { "id": "SecureSourceManagerInstanceConfig", "description": "Configuration for connections to Secure Source Manager instance", "type": "object", "properties": { "instance": { "description": "Required. Immutable. Secure Source Manager instance resource, formatted as `projects/*/locations/*/instances/*`", "type": "string" } } }, "GenericHTTPEndpointConfig": { "id": "GenericHTTPEndpointConfig", "description": "Defines the configuration for connections to an HTTP service provider.", "type": "object", "properties": { "basicAuthentication": { "description": "Optional. Basic authentication with username and password.", "$ref": "BasicAuthentication" }, "bearerTokenAuthentication": { "description": "Optional. Bearer token authentication with a token.", "$ref": "BearerTokenAuthentication" }, "hostUri": { "description": "Required. Immutable. The service provider's https endpoint.", "type": "string" }, "serviceDirectoryConfig": { "description": "Optional. Configuration for using Service Directory to privately connect to a HTTP service provider. This should only be set if the Http service provider is hosted on-premises and not reachable by public internet. If this field is left empty, calls to the HTTP service provider will be made over the public internet.", "$ref": "ServiceDirectoryConfig" }, "sslCaCertificate": { "description": "Optional. The SSL certificate to use for requests to the HTTP service provider.", "type": "string" } } }, "BasicAuthentication": { "id": "BasicAuthentication", "description": "Basic authentication with username and password.", "type": "object", "properties": { "passwordSecretVersion": { "description": "The password SecretManager secret version to authenticate as.", "type": "string" }, "username": { "description": "Required. The username to authenticate as.", "type": "string" } } }, "BearerTokenAuthentication": { "id": "BearerTokenAuthentication", "description": "Bearer token authentication with a token.", "type": "object", "properties": { "tokenSecretVersion": { "description": "Optional. The token SecretManager secret version to authenticate as.", "type": "string" } } }, "InstallationState": { "id": "InstallationState", "description": "Describes stage and necessary actions to be taken by the user to complete the installation. Used for GitHub and GitHub Enterprise based connections.", "type": "object", "properties": { "stage": { "description": "Output only. Current step of the installation process.", "readOnly": true, "type": "string", "enumDescriptions": [ "No stage specified.", "Only for GitHub Enterprise. An App creation has been requested. The user needs to confirm the creation in their GitHub enterprise host.", "User needs to authorize the GitHub (or Enterprise) App via OAuth.", "User needs to follow the link to install the GitHub (or Enterprise) App.", "Installation process has been completed." ], "enum": [ "STAGE_UNSPECIFIED", "PENDING_CREATE_APP", "PENDING_USER_OAUTH", "PENDING_INSTALL_APP", "COMPLETE" ] }, "message": { "description": "Output only. Message of what the user should do next to continue the installation. Empty string if the installation is already complete.", "readOnly": true, "type": "string" }, "actionUri": { "description": "Output only. Link to follow for next action. Empty string if the installation is already complete.", "readOnly": true, "type": "string" } } }, "CryptoKeyConfig": { "id": "CryptoKeyConfig", "description": "The crypto key configuration. This field is used by the Customer-managed encryption keys (CMEK) feature.", "type": "object", "properties": { "keyReference": { "description": "Required. The name of the key which is used to encrypt/decrypt customer data. For key in Cloud KMS, the key should be in the format of `projects/*/locations/*/keyRings/*/cryptoKeys/*`.", "type": "string" } } }, "GitProxyConfig": { "id": "GitProxyConfig", "description": "The git proxy configuration.", "type": "object", "properties": { "enabled": { "description": "Optional. Setting this to true allows the git proxy to be used for performing git operations on the repositories linked in the connection.", "type": "boolean" }, "httpProxyBaseUri": { "description": "Output only. The base URI for the HTTP proxy endpoint. Has the format `https://{generatedID}-c-h-{shortRegion}.developerconnect.dev` Populated only when enabled is set to true. This endpoint is used by other Google services that integrate with Developer Connect.", "readOnly": true, "type": "string" } } }, "GitRepositoryLink": { "id": "GitRepositoryLink", "description": "Message describing the GitRepositoryLink object", "type": "object", "properties": { "name": { "description": "Identifier. Resource name of the repository, in the format `projects/*/locations/*/connections/*/gitRepositoryLinks/*`.", "type": "string" }, "cloneUri": { "description": "Required. Git Clone URI.", "type": "string" }, "createTime": { "description": "Output only. [Output only] Create timestamp", "readOnly": true, "type": "string", "format": "google-datetime" }, "updateTime": { "description": "Output only. [Output only] Update timestamp", "readOnly": true, "type": "string", "format": "google-datetime" }, "deleteTime": { "description": "Output only. [Output only] Delete timestamp", "readOnly": true, "type": "string", "format": "google-datetime" }, "labels": { "description": "Optional. Labels as key value pairs", "type": "object", "additionalProperties": { "type": "string" } }, "etag": { "description": "Optional. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.", "type": "string" }, "reconciling": { "description": "Output only. Set to true when the connection is being set up or updated in the background.", "readOnly": true, "type": "boolean" }, "annotations": { "description": "Optional. Allows clients to store small amounts of arbitrary data.", "type": "object", "additionalProperties": { "type": "string" } }, "uid": { "description": "Output only. A system-assigned unique identifier for the GitRepositoryLink.", "readOnly": true, "type": "string" }, "webhookId": { "description": "Output only. External ID of the webhook created for the repository.", "readOnly": true, "type": "string" }, "gitProxyUri": { "description": "Output only. URI to access the linked repository through the Git Proxy. This field is only populated if the git proxy is enabled for the connection.", "readOnly": true, "type": "string" } } }, "ListGitRepositoryLinksResponse": { "id": "ListGitRepositoryLinksResponse", "description": "Message for response to listing GitRepositoryLinks", "type": "object", "properties": { "gitRepositoryLinks": { "description": "The list of GitRepositoryLinks", "type": "array", "items": { "$ref": "GitRepositoryLink" } }, "nextPageToken": { "description": "A token identifying a page of results the server should return.", "type": "string" }, "unreachable": { "description": "Locations that could not be reached.", "type": "array", "items": { "type": "string" } } } }, "FetchReadWriteTokenRequest": { "id": "FetchReadWriteTokenRequest", "description": "Message for fetching SCM read/write token.", "type": "object", "properties": {} }, "FetchReadWriteTokenResponse": { "id": "FetchReadWriteTokenResponse", "description": "Message for responding to get read/write token.", "type": "object", "properties": { "token": { "description": "The token content.", "type": "string" }, "expirationTime": { "description": "Expiration timestamp. Can be empty if unknown or non-expiring.", "type": "string", "format": "google-datetime" }, "gitUsername": { "description": "The git_username to specify when making a git clone with the token. For example, for GitHub GitRepositoryLinks, this would be \"x-access-token\"", "type": "string" } } }, "FetchReadTokenRequest": { "id": "FetchReadTokenRequest", "description": "Message for fetching SCM read token.", "type": "object", "properties": {} }, "FetchReadTokenResponse": { "id": "FetchReadTokenResponse", "description": "Message for responding to get read token.", "type": "object", "properties": { "token": { "description": "The token content.", "type": "string" }, "expirationTime": { "description": "Expiration timestamp. Can be empty if unknown or non-expiring.", "type": "string", "format": "google-datetime" }, "gitUsername": { "description": "The git_username to specify when making a git clone with the token. For example, for GitHub GitRepositoryLinks, this would be \"x-access-token\"", "type": "string" } } }, "FetchLinkableGitRepositoriesResponse": { "id": "FetchLinkableGitRepositoriesResponse", "description": "Response message for FetchLinkableGitRepositories.", "type": "object", "properties": { "linkableGitRepositories": { "description": "The git repositories that can be linked to the connection.", "type": "array", "items": { "$ref": "LinkableGitRepository" } }, "nextPageToken": { "description": "A token identifying a page of results the server should return.", "type": "string" } } }, "LinkableGitRepository": { "id": "LinkableGitRepository", "description": "LinkableGitRepository represents a git repository that can be linked to a connection.", "type": "object", "properties": { "cloneUri": { "description": "The clone uri of the repository.", "type": "string" } } }, "FetchGitHubInstallationsResponse": { "id": "FetchGitHubInstallationsResponse", "description": "Response of fetching github installations.", "type": "object", "properties": { "installations": { "description": "List of installations available to the OAuth user (for github.com) or all the installations (for GitHub enterprise).", "type": "array", "items": { "$ref": "Installation" } } } }, "Installation": { "id": "Installation", "description": "Represents an installation of the GitHub App.", "type": "object", "properties": { "id": { "description": "ID of the installation in GitHub.", "type": "string", "format": "int64" }, "name": { "description": "Name of the GitHub user or organization that owns this installation.", "type": "string" }, "type": { "description": "Either \"user\" or \"organization\".", "type": "string" } } }, "FetchGitRefsResponse": { "id": "FetchGitRefsResponse", "description": "Response for fetching git refs.", "type": "object", "properties": { "refNames": { "description": "Name of the refs fetched.", "type": "array", "items": { "type": "string" } }, "nextPageToken": { "description": "A token identifying a page of results the server should return.", "type": "string" } } }, "ListAccountConnectorsResponse": { "id": "ListAccountConnectorsResponse", "description": "Message for response to listing AccountConnectors", "type": "object", "properties": { "accountConnectors": { "description": "The list of AccountConnectors", "type": "array", "items": { "$ref": "AccountConnector" } }, "nextPageToken": { "description": "A token identifying a page of results the server should return.", "type": "string" }, "unreachable": { "description": "Locations that could not be reached.", "type": "array", "items": { "type": "string" } } } }, "AccountConnector": { "id": "AccountConnector", "description": "AccountConnector encapsulates what a platform administrator needs to configure for users to connect to the service providers, which includes, among other fields, the OAuth client ID, client secret, and authorization and token endpoints.", "type": "object", "properties": { "customOauthConfig": { "description": "Custom OAuth config.", "$ref": "CustomOAuthConfig" }, "providerOauthConfig": { "description": "Optional. Provider OAuth config.", "$ref": "ProviderOAuthConfig" }, "name": { "description": "Identifier. The resource name of the accountConnector, in the format `projects/{project}/locations/{location}/accountConnectors/{account_connector_id}`.", "type": "string" }, "createTime": { "description": "Output only. The timestamp when the accountConnector was created.", "readOnly": true, "type": "string", "format": "google-datetime" }, "updateTime": { "description": "Output only. The timestamp when the accountConnector was updated.", "readOnly": true, "type": "string", "format": "google-datetime" }, "annotations": { "description": "Optional. Allows users to store small amounts of arbitrary data.", "type": "object", "additionalProperties": { "type": "string" } }, "etag": { "description": "Optional. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.", "type": "string" }, "labels": { "description": "Optional. Labels as key value pairs", "type": "object", "additionalProperties": { "type": "string" } }, "oauthStartUri": { "description": "Output only. Start OAuth flow by clicking on this URL.", "readOnly": true, "type": "string" }, "proxyConfig": { "description": "Optional. Configuration for the http and git proxy features.", "$ref": "ProxyConfig" }, "uid": { "description": "Output only. A system-assigned unique identifier for the Account Connector.", "readOnly": true, "type": "string" } } }, "CustomOAuthConfig": { "id": "CustomOAuthConfig", "description": "Message for a customized OAuth config.", "type": "object", "properties": { "scopes": { "description": "Required. The scopes to be requested during OAuth.", "type": "array", "items": { "type": "string" } }, "clientId": { "description": "Required. The client ID of the OAuth application.", "type": "string" }, "clientSecret": { "description": "Required. Input only. The client secret of the OAuth application. It will be provided as plain text, but encrypted and stored in developer connect. As INPUT_ONLY field, it will not be included in the output.", "type": "string" }, "authUri": { "description": "Required. Immutable. The OAuth2 authorization server URL.", "type": "string" }, "tokenUri": { "description": "Required. Immutable. The OAuth2 token request URL.", "type": "string" }, "serviceDirectoryConfig": { "description": "Optional. Configuration for using Service Directory to connect to a private service.", "$ref": "ServiceDirectoryConfig" }, "sslCaCertificate": { "description": "Optional. SSL certificate to use for requests to a private service.", "type": "string" }, "pkceDisabled": { "description": "Optional. Disable PKCE for this OAuth config. PKCE is enabled by default.", "type": "boolean" }, "hostUri": { "description": "Required. The host URI of the OAuth application.", "type": "string" }, "scmProvider": { "description": "Required. The type of the SCM provider.", "type": "string", "enumDescriptions": [ "The SCM is not specified or BYO Account Connector is not an SCM.", "BYO Account Connector is an instance of GitHub Enterprise.", "BYO Account Connector is an instance of GitLab Enterprise.", "BYO Account Connector is an instance of Bitbucket Data Center." ], "enum": [ "SCM_PROVIDER_UNKNOWN", "GITHUB_ENTERPRISE", "GITLAB_ENTERPRISE", "BITBUCKET_DATA_CENTER" ] }, "serverVersion": { "description": "Output only. SCM server version installed at the host URI.", "readOnly": true, "type": "string" } } }, "ProviderOAuthConfig": { "id": "ProviderOAuthConfig", "description": "ProviderOAuthConfig is the OAuth config for a provider.", "type": "object", "properties": { "systemProviderId": { "description": "Optional. Immutable. Developer Connect provided OAuth.", "type": "string", "enumDescriptions": [ "No system provider specified.", "GitHub provider. Scopes can be found at https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/scopes-for-oauth-apps#available-scopes", "GitLab provider. Scopes can be found at https://docs.gitlab.com/user/profile/personal_access_tokens/#personal-access-token-scopes", "Google provider. Recommended scopes: \"https://www.googleapis.com/auth/drive.readonly\", \"https://www.googleapis.com/auth/documents.readonly\"", "Sentry provider. Scopes can be found at https://docs.sentry.io/api/permissions/", "Rovo provider. Must select the \"rovo\" scope.", "New Relic provider. No scopes are allowed.", "Datastax provider. No scopes are allowed.", "Dynatrace provider." ], "enum": [ "SYSTEM_PROVIDER_UNSPECIFIED", "GITHUB", "GITLAB", "GOOGLE", "SENTRY", "ROVO", "NEW_RELIC", "DATASTAX", "DYNATRACE" ] }, "scopes": { "description": "Required. User selected scopes to apply to the Oauth config In the event of changing scopes, user records under AccountConnector will be deleted and users will re-auth again.", "type": "array", "items": { "type": "string" } } } }, "ProxyConfig": { "id": "ProxyConfig", "description": "The proxy configuration.", "type": "object", "properties": { "enabled": { "description": "Optional. Setting this to true allows the git and http proxies to perform actions on behalf of the user configured under the account connector.", "type": "boolean" }, "httpProxyBaseUri": { "description": "Output only. The base URI for the HTTP proxy endpoint. Has the format `https://{generatedID}-a-h-{shortRegion}.developerconnect.dev` Populated only when `enabled` is set to `true`. This endpoint is used by other Google services that integrate with Developer Connect.", "readOnly": true, "type": "string" } } }, "FetchUserRepositoriesResponse": { "id": "FetchUserRepositoriesResponse", "description": "Response message for FetchUserRepositories.", "type": "object", "properties": { "userRepos": { "description": "The repositories that the user can access with this account connector.", "type": "array", "items": { "$ref": "UserRepository" } }, "nextPageToken": { "description": "A token identifying a page of results the server should return.", "type": "string" } } }, "UserRepository": { "id": "UserRepository", "description": "A user repository that can be linked to the account connector. Consists of the repo name and the git proxy URL to forward requests to this repo.", "type": "object", "properties": { "displayName": { "description": "Output only. The user friendly repo name (e.g., myuser/myrepo)", "readOnly": true, "type": "string" }, "gitProxyUri": { "description": "Output only. The Git proxy URL for this repo. For example: https://us-west1-git.developerconnect.dev/a/my-proj/my-ac/myuser/myrepo.git. Populated only when `proxy_config.enabled` is set to `true` in the Account Connector. This URL is used by other Google services that integrate with Developer Connect.", "readOnly": true, "type": "string" }, "cloneUri": { "description": "Output only. The git clone URL of the repo. For example: https://github.com/myuser/myrepo.git", "readOnly": true, "type": "string" } } }, "FetchAccessTokenRequest": { "id": "FetchAccessTokenRequest", "description": "Message for fetching an OAuth access token.", "type": "object", "properties": {} }, "FetchAccessTokenResponse": { "id": "FetchAccessTokenResponse", "description": "Message for responding to getting an OAuth access token.", "type": "object", "properties": { "token": { "description": "The token content.", "type": "string" }, "expirationTime": { "description": "Expiration timestamp. Can be empty if unknown or non-expiring.", "type": "string", "format": "google-datetime" }, "scopes": { "description": "The scopes of the access token.", "type": "array", "items": { "type": "string" } }, "exchangeError": { "description": "The error resulted from exchanging OAuth tokens from the service provider.", "$ref": "ExchangeError" } } }, "ExchangeError": { "id": "ExchangeError", "description": "Message for representing an error from exchanging OAuth tokens.", "type": "object", "properties": { "code": { "description": "https://datatracker.ietf.org/doc/html/rfc6749#section-5.2 - error", "type": "string" }, "description": { "description": "https://datatracker.ietf.org/doc/html/rfc6749#section-5.2 - error_description", "type": "string" } } }, "ListUsersResponse": { "id": "ListUsersResponse", "description": "Message for response to listing Users", "type": "object", "properties": { "users": { "description": "The list of Users", "type": "array", "items": { "$ref": "User" } }, "nextPageToken": { "description": "A token identifying a page of results the server should return.", "type": "string" }, "unreachable": { "description": "Locations that could not be reached.", "type": "array", "items": { "type": "string" } } } }, "User": { "id": "User", "description": "User represents a user connected to the service providers through a AccountConnector.", "type": "object", "properties": { "name": { "description": "Identifier. Resource name of the user, in the format `projects/*/locations/*/accountConnectors/*/users/*`.", "type": "string" }, "displayName": { "description": "Output only. Developer Connect automatically converts user identity to some human readable description, e.g., email address.", "readOnly": true, "type": "string" }, "createTime": { "description": "Output only. The timestamp when the user was created.", "readOnly": true, "type": "string", "format": "google-datetime" }, "lastTokenRequestTime": { "description": "Output only. The timestamp when the token was last requested.", "readOnly": true, "type": "string", "format": "google-datetime" } } }, "StartOAuthResponse": { "id": "StartOAuthResponse", "description": "Message for responding to starting an OAuth flow.", "type": "object", "properties": { "systemProviderId": { "description": "The ID of the system provider.", "type": "string", "enumDescriptions": [ "No system provider specified.", "GitHub provider. Scopes can be found at https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/scopes-for-oauth-apps#available-scopes", "GitLab provider. Scopes can be found at https://docs.gitlab.com/user/profile/personal_access_tokens/#personal-access-token-scopes", "Google provider. Recommended scopes: \"https://www.googleapis.com/auth/drive.readonly\", \"https://www.googleapis.com/auth/documents.readonly\"", "Sentry provider. Scopes can be found at https://docs.sentry.io/api/permissions/", "Rovo provider. Must select the \"rovo\" scope.", "New Relic provider. No scopes are allowed.", "Datastax provider. No scopes are allowed.", "Dynatrace provider." ], "enum": [ "SYSTEM_PROVIDER_UNSPECIFIED", "GITHUB", "GITLAB", "GOOGLE", "SENTRY", "ROVO", "NEW_RELIC", "DATASTAX", "DYNATRACE" ] }, "ticket": { "description": "The ticket to be used for post processing the callback from the service provider.", "type": "string" }, "codeChallenge": { "description": "Please refer to https://datatracker.ietf.org/doc/html/rfc7636#section-4.1", "type": "string" }, "codeChallengeMethod": { "description": "Please refer to https://datatracker.ietf.org/doc/html/rfc7636#section-4.2", "type": "string" }, "clientId": { "description": "The client ID to the OAuth App of the service provider.", "type": "string" }, "scopes": { "description": "The list of scopes requested by the application.", "type": "array", "items": { "type": "string" } }, "authUri": { "description": "The authorization server URL to the OAuth flow of the service provider.", "type": "string" } } }, "FinishOAuthResponse": { "id": "FinishOAuthResponse", "description": "Message for responding to finishing an OAuth flow.", "type": "object", "properties": { "exchangeError": { "description": "The error resulted from exchanging OAuth tokens from the service provider.", "$ref": "ExchangeError" } } }, "ListInsightsConfigsResponse": { "id": "ListInsightsConfigsResponse", "description": "Request for response to listing InsightsConfigs.", "type": "object", "properties": { "insightsConfigs": { "description": "The list of InsightsConfigs.", "type": "array", "items": { "$ref": "InsightsConfig" } }, "nextPageToken": { "description": "A token identifying a page of results the server should return.", "type": "string" }, "unreachable": { "description": "Locations that could not be reached.", "type": "array", "items": { "type": "string" } } } }, "InsightsConfig": { "id": "InsightsConfig", "description": "The InsightsConfig resource is the core configuration object to capture events from your Software Development Lifecycle. It acts as the central hub for managing how Developer Connect understands your application, its runtime environments, and the artifacts deployed within them.", "type": "object", "properties": { "appHubApplication": { "description": "Optional. The name of the App Hub Application. Format: projects/{project}/locations/{location}/applications/{application}", "type": "string" }, "projects": { "description": "Optional. The projects to track with the InsightsConfig.", "$ref": "Projects" }, "name": { "description": "Identifier. The name of the InsightsConfig. Format: projects/{project}/locations/{location}/insightsConfigs/{insightsConfig}", "type": "string" }, "createTime": { "description": "Output only. Create timestamp.", "readOnly": true, "type": "string", "format": "google-datetime" }, "updateTime": { "description": "Output only. Update timestamp.", "readOnly": true, "type": "string", "format": "google-datetime" }, "runtimeConfigs": { "description": "Output only. The runtime configurations where the application is deployed.", "readOnly": true, "type": "array", "items": { "$ref": "RuntimeConfig" } }, "artifactConfigs": { "description": "Optional. The artifact configurations of the artifacts that are deployed.", "type": "array", "items": { "$ref": "ArtifactConfig" } }, "state": { "description": "Optional. Output only. The state of the InsightsConfig.", "type": "string", "enumDescriptions": [ "No state specified.", "The InsightsConfig is pending application discovery/runtime discovery.", "The initial discovery process is complete.", "The InsightsConfig is in an error state." ], "enum": [ "STATE_UNSPECIFIED", "PENDING", "COMPLETE", "ERROR" ] }, "annotations": { "description": "Optional. User specified annotations. See https://google.aip.dev/148#annotations for more details such as format and size limitations.", "type": "object", "additionalProperties": { "type": "string" } }, "labels": { "description": "Optional. Set of labels associated with an InsightsConfig.", "type": "object", "additionalProperties": { "type": "string" } }, "reconciling": { "description": "Output only. Reconciling (https://google.aip.dev/128#reconciliation). Set to true if the current state of InsightsConfig does not match the user's intended state, and the service is actively updating the resource to reconcile them. This can happen due to user-triggered updates or system actions like failover or maintenance.", "readOnly": true, "type": "boolean" }, "errors": { "description": "Output only. Any errors that occurred while setting up the InsightsConfig. Each error will be in the format: `field_name: error_message`, e.g. GetAppHubApplication: Permission denied while getting App Hub application. Please grant permissions to the P4SA.", "readOnly": true, "type": "array", "items": { "$ref": "Status" } } } }, "Projects": { "id": "Projects", "description": "Projects represents the projects to track with the InsightsConfig.", "type": "object", "properties": { "projectIds": { "description": "Optional. The project IDs. Format: {project}", "type": "array", "items": { "type": "string" } } } }, "RuntimeConfig": { "id": "RuntimeConfig", "description": "RuntimeConfig represents the runtimes where the application is deployed.", "type": "object", "properties": { "gkeWorkload": { "description": "Output only. Google Kubernetes Engine runtime.", "readOnly": true, "$ref": "GKEWorkload" }, "googleCloudRun": { "description": "Output only. Cloud Run runtime.", "readOnly": true, "$ref": "GoogleCloudRun" }, "appHubWorkload": { "description": "Output only. App Hub Workload.", "readOnly": true, "$ref": "AppHubWorkload" }, "appHubService": { "description": "Output only. App Hub Service.", "readOnly": true, "$ref": "AppHubService" }, "uri": { "description": "Required. Immutable. The URI of the runtime configuration. For GKE, this is the cluster name. For Cloud Run, this is the service name.", "type": "string" }, "state": { "description": "Output only. The state of the Runtime.", "readOnly": true, "type": "string", "enumDescriptions": [ "No state specified.", "The runtime configuration has been linked to the InsightsConfig.", "The runtime configuration has been unlinked to the InsightsConfig." ], "enum": [ "STATE_UNSPECIFIED", "LINKED", "UNLINKED" ] } } }, "GKEWorkload": { "id": "GKEWorkload", "description": "GKEWorkload represents the Google Kubernetes Engine runtime.", "type": "object", "properties": { "cluster": { "description": "Required. Immutable. The name of the GKE cluster. Format: `projects/{project}/locations/{location}/clusters/{cluster}`.", "type": "string" }, "deployment": { "description": "Output only. The name of the GKE deployment. Format: `projects/{project}/locations/{location}/clusters/{cluster}/namespaces/{namespace}/deployments/{deployment}`.", "readOnly": true, "type": "string" } } }, "GoogleCloudRun": { "id": "GoogleCloudRun", "description": "GoogleCloudRun represents the Cloud Run runtime.", "type": "object", "properties": { "serviceUri": { "description": "Required. Immutable. The name of the Cloud Run service. Format: `projects/{project}/locations/{location}/services/{service}`.", "type": "string" } } }, "AppHubWorkload": { "id": "AppHubWorkload", "description": "AppHubWorkload represents the App Hub Workload.", "type": "object", "properties": { "workload": { "description": "Required. Output only. Immutable. The name of the App Hub Workload. Format: `projects/{project}/locations/{location}/applications/{application}/workloads/{workload}`.", "readOnly": true, "type": "string" }, "criticality": { "description": "Output only. The criticality of the App Hub Workload.", "readOnly": true, "type": "string" }, "environment": { "description": "Output only. The environment of the App Hub Workload.", "readOnly": true, "type": "string" } } }, "AppHubService": { "id": "AppHubService", "description": "AppHubService represents the App Hub Service.", "type": "object", "properties": { "apphubService": { "description": "Required. Output only. Immutable. The name of the App Hub Service. Format: `projects/{project}/locations/{location}/applications/{application}/services/{service}`.", "readOnly": true, "type": "string" }, "criticality": { "description": "Output only. The criticality of the App Hub Service.", "readOnly": true, "type": "string" }, "environment": { "description": "Output only. The environment of the App Hub Service.", "readOnly": true, "type": "string" } } }, "ArtifactConfig": { "id": "ArtifactConfig", "description": "The artifact config of the artifact that is deployed.", "type": "object", "properties": { "googleArtifactRegistry": { "description": "Optional. Set if the artifact is stored in Artifact registry.", "$ref": "GoogleArtifactRegistry" }, "googleArtifactAnalysis": { "description": "Optional. Set if the artifact metadata is stored in Artifact analysis.", "$ref": "GoogleArtifactAnalysis" }, "uri": { "description": "Required. Immutable. The URI of the artifact that is deployed. e.g. `us-docker.pkg.dev/my-project/my-repo/image`. The URI does not include the tag / digest because it captures a lineage of artifacts.", "type": "string" } } }, "GoogleArtifactRegistry": { "id": "GoogleArtifactRegistry", "description": "Google Artifact Registry configurations.", "type": "object", "properties": { "projectId": { "description": "Required. The host project of Artifact Registry.", "type": "string" }, "artifactRegistryPackage": { "description": "Required. Immutable. The name of the artifact registry package.", "type": "string" } } }, "GoogleArtifactAnalysis": { "id": "GoogleArtifactAnalysis", "description": "Google Artifact Analysis configurations.", "type": "object", "properties": { "projectId": { "description": "Required. The project id of the project where the provenance is stored.", "type": "string" } } }, "DeploymentEvent": { "id": "DeploymentEvent", "description": "The DeploymentEvent resource represents the deployment of the artifact within the InsightsConfig resource.", "type": "object", "properties": { "name": { "description": "Identifier. The name of the DeploymentEvent. This name is provided by Developer Connect insights. Format: projects/{project}/locations/{location}/insightsConfigs/{insights_config}/deploymentEvents/{uuid}", "type": "string" }, "createTime": { "description": "Output only. The create time of the DeploymentEvent.", "readOnly": true, "type": "string", "format": "google-datetime" }, "updateTime": { "description": "Output only. The update time of the DeploymentEvent.", "readOnly": true, "type": "string", "format": "google-datetime" }, "runtimeConfig": { "description": "Output only. The runtime configurations where the DeploymentEvent happened.", "readOnly": true, "$ref": "RuntimeConfig" }, "runtimeDeploymentUri": { "description": "Output only. The runtime assigned URI of the DeploymentEvent. For GKE, this is the fully qualified replica set uri. e.g. container.googleapis.com/projects/{project}/locations/{location}/clusters/{cluster}/k8s/namespaces/{namespace}/apps/replicasets/{replica-set-id} For Cloud Run, this is the revision name.", "readOnly": true, "type": "string" }, "state": { "description": "Output only. The state of the DeploymentEvent.", "readOnly": true, "type": "string", "enumDescriptions": [ "No state specified.", "The deployment is active in the runtime.", "The deployment is not in the runtime." ], "enum": [ "STATE_UNSPECIFIED", "STATE_ACTIVE", "STATE_INACTIVE" ] }, "artifactDeployments": { "description": "Output only. The artifact deployments of the DeploymentEvent. Each artifact deployment contains the artifact uri and the runtime configuration uri. For GKE, this would be all the containers images that are deployed in the pod.", "readOnly": true, "type": "array", "items": { "$ref": "ArtifactDeployment" } }, "deployTime": { "description": "Output only. The time at which the DeploymentEvent was deployed. This would be the min of all ArtifactDeployment deploy_times.", "readOnly": true, "type": "string", "format": "google-datetime" }, "undeployTime": { "description": "Output only. The time at which the DeploymentEvent was undeployed, all artifacts are considered undeployed once this time is set. This would be the max of all ArtifactDeployment undeploy_times. If any ArtifactDeployment is still active (i.e. does not have an undeploy_time), this field will be empty.", "readOnly": true, "type": "string", "format": "google-datetime" } } }, "ArtifactDeployment": { "id": "ArtifactDeployment", "description": "The ArtifactDeployment resource represents the deployment of the artifact within the InsightsConfig resource.", "type": "object", "properties": { "id": { "description": "Output only. Unique identifier of `ArtifactDeployment`.", "readOnly": true, "type": "string" }, "artifactReference": { "description": "Output only. The artifact that is deployed.", "readOnly": true, "type": "string" }, "artifactAlias": { "description": "Output only. The artifact alias in the deployment spec, with Tag/SHA. e.g. us-docker.pkg.dev/my-project/my-repo/image:1.0.0", "readOnly": true, "type": "string" }, "sourceCommitUris": { "description": "Output only. The source commits at which this artifact was built. Extracted from provenance.", "readOnly": true, "type": "array", "items": { "type": "string" } }, "deployTime": { "description": "Output only. The time at which the deployment was deployed.", "readOnly": true, "type": "string", "format": "google-datetime" }, "undeployTime": { "description": "Output only. The time at which the deployment was undeployed, all artifacts are considered undeployed once this time is set.", "readOnly": true, "type": "string", "format": "google-datetime" }, "containerStatusSummary": { "description": "Output only. The summary of container status of the artifact deployment. Format as `ContainerStatusState-Reason : restartCount` e.g. \"Waiting-ImagePullBackOff : 3\"", "readOnly": true, "type": "string" } } }, "ListDeploymentEventsResponse": { "id": "ListDeploymentEventsResponse", "description": "Response to listing DeploymentEvents.", "type": "object", "properties": { "deploymentEvents": { "description": "The list of DeploymentEvents.", "type": "array", "items": { "$ref": "DeploymentEvent" } }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } } }, "ProcessGitHubEnterpriseWebhookRequest": { "id": "ProcessGitHubEnterpriseWebhookRequest", "description": "RPC request object accepted by the ProcessGitHubEnterpriseWebhook RPC method.", "type": "object", "properties": { "body": { "description": "Required. HTTP request body.", "$ref": "HttpBody" } } }, "HttpBody": { "id": "HttpBody", "description": "Message that represents an arbitrary HTTP body. It should only be used for payload formats that can't be represented as JSON, such as raw binary or an HTML page. This message can be used both in streaming and non-streaming API methods in the request as well as the response. It can be used as a top-level request field, which is convenient if one wants to extract parameters from either the URL or HTTP template into the request fields and also want access to the raw HTTP body. Example: message GetResourceRequest { // A unique request id. string request_id = 1; // The raw HTTP body is bound to this field. google.api.HttpBody http_body = 2; } service ResourceService { rpc GetResource(GetResourceRequest) returns (google.api.HttpBody); rpc UpdateResource(google.api.HttpBody) returns (google.protobuf.Empty); } Example with streaming methods: service CaldavService { rpc GetCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); rpc UpdateCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); } Use of this type only changes how the request and response bodies are handled, all other features will continue to work unchanged.", "type": "object", "properties": { "contentType": { "description": "The HTTP Content-Type header value specifying the content type of the body.", "type": "string" }, "data": { "description": "The HTTP request/response body as raw binary.", "type": "string", "format": "byte" }, "extensions": { "description": "Application specific response metadata. Must be set in the first response for streaming APIs.", "type": "array", "items": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." } } } } }, "ProcessGitLabEnterpriseWebhookRequest": { "id": "ProcessGitLabEnterpriseWebhookRequest", "description": "RPC request object accepted by the ProcessGitLabEnterpriseWebhook RPC method.", "type": "object", "properties": { "body": { "description": "Required. HTTP request body.", "$ref": "HttpBody" } } }, "ProcessGitLabWebhookRequest": { "id": "ProcessGitLabWebhookRequest", "description": "RPC request object accepted by the ProcessGitLabWebhook RPC method.", "type": "object", "properties": { "body": { "description": "Required. HTTP request body.", "$ref": "HttpBody" } } }, "ProcessBitbucketDataCenterWebhookRequest": { "id": "ProcessBitbucketDataCenterWebhookRequest", "description": "RPC request object accepted by the ProcessBitbucketDataCenterWebhook RPC method.", "type": "object", "properties": { "body": { "description": "Required. HTTP request body.", "$ref": "HttpBody" } } }, "ProcessBitbucketCloudWebhookRequest": { "id": "ProcessBitbucketCloudWebhookRequest", "description": "RPC request object accepted by the ProcessBitbucketCloudWebhook RPC method.", "type": "object", "properties": { "body": { "description": "Required. HTTP request body.", "$ref": "HttpBody" } } }, "ListLocationsResponse": { "id": "ListLocationsResponse", "description": "The response message for Locations.ListLocations.", "type": "object", "properties": { "locations": { "description": "A list of locations that matches the specified filter in the request.", "type": "array", "items": { "$ref": "Location" } }, "nextPageToken": { "description": "The standard List next-page token.", "type": "string" } } }, "Location": { "id": "Location", "description": "A resource that represents a Google Cloud location.", "type": "object", "properties": { "name": { "description": "Resource name for the location, which may vary between implementations. For example: `\"projects/example-project/locations/us-east1\"`", "type": "string" }, "locationId": { "description": "The canonical id for this location. For example: `\"us-east1\"`.", "type": "string" }, "displayName": { "description": "The friendly name for this location, typically a nearby city name. For example, \"Tokyo\".", "type": "string" }, "labels": { "description": "Cross-service attributes for the location. For example {\"cloud.googleapis.com/region\": \"us-east1\"}", "type": "object", "additionalProperties": { "type": "string" } }, "metadata": { "description": "Service-specific metadata. For example the available capacity at the given location.", "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." } } } }, "OperationMetadata": { "id": "OperationMetadata", "description": "Represents the metadata of the long-running operation.", "type": "object", "properties": { "createTime": { "description": "Output only. The time the operation was created.", "readOnly": true, "type": "string", "format": "google-datetime" }, "endTime": { "description": "Output only. The time the operation finished running.", "readOnly": true, "type": "string", "format": "google-datetime" }, "target": { "description": "Output only. Server-defined resource path for the target of the operation.", "readOnly": true, "type": "string" }, "verb": { "description": "Output only. Name of the verb executed by the operation.", "readOnly": true, "type": "string" }, "statusMessage": { "description": "Output only. Human-readable status of the operation, if any.", "readOnly": true, "type": "string" }, "requestedCancellation": { "description": "Output only. Identifies whether the user has requested cancellation of the operation. Operations that have been cancelled successfully have google.longrunning.Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", "readOnly": true, "type": "boolean" }, "apiVersion": { "description": "Output only. API version used to start the operation.", "readOnly": true, "type": "string" } } } }, "kind": "discovery#restDescription", "endpoints": [ { "endpointUrl": "https://developerconnect.us-central1.rep.googleapis.com/", "location": "us-central1", "description": "Regional Endpoint" }, { "endpointUrl": "https://developerconnect.europe-west1.rep.googleapis.com/", "location": "europe-west1", "description": "Regional Endpoint" }, { "endpointUrl": "https://developerconnect.asia-east1.rep.googleapis.com/", "location": "asia-east1", "description": "Regional Endpoint" }, { "endpointUrl": "https://developerconnect.asia-east2.rep.googleapis.com/", "location": "asia-east2", "description": "Regional Endpoint" }, { "endpointUrl": "https://developerconnect.europe-west4.rep.googleapis.com/", "location": "europe-west4", "description": "Regional Endpoint" }, { "endpointUrl": "https://developerconnect.us-east4.rep.googleapis.com/", "location": "us-east4", "description": "Regional Endpoint" }, { "endpointUrl": "https://developerconnect.us-east5.rep.googleapis.com/", "location": "us-east5", "description": "Regional Endpoint" }, { "endpointUrl": "https://developerconnect.asia-southeast1.rep.googleapis.com/", "location": "asia-southeast1", "description": "Regional Endpoint" }, { "endpointUrl": "https://developerconnect.us-west1.rep.googleapis.com/", "location": "us-west1", "description": "Regional Endpoint" }, { "endpointUrl": "https://developerconnect.us-west2.rep.googleapis.com/", "location": "us-west2", "description": "Regional Endpoint" } ], "description": "Connect third-party source code management to Google" }