{ "fullyEncodeReservedExpansion": true, "resources": { "projects": { "resources": { "locations": { "methods": { "list": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "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.", "parameters": { "name": { "description": "The resource that owns the locations collection, if applicable.", "pattern": "^projects/[^/]+$", "required": true, "type": "string", "location": "path" }, "extraLocationTypes": { "location": "query", "repeated": true, "description": "Optional. Do not use this field unless explicitly documented otherwise. This is primarily for internal usage.", "type": "string" }, "pageToken": { "location": "query", "description": "A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page.", "type": "string" }, "filter": { "location": "query", "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).", "type": "string" }, "pageSize": { "location": "query", "description": "The maximum number of results to return. If not set, the service selects a default.", "type": "integer", "format": "int32" } }, "id": "developerconnect.projects.locations.list", "parameterOrder": [ "name" ], "path": "v1/{+name}/locations", "flatPath": "v1/projects/{projectsId}/locations", "response": { "$ref": "ListLocationsResponse" } }, "get": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "description": "Gets information about a location.", "parameters": { "name": { "description": "Resource name for the location.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string", "location": "path" } }, "id": "developerconnect.projects.locations.get", "parameterOrder": [ "name" ], "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}", "response": { "$ref": "Location" } } }, "resources": { "insightsConfigs": { "methods": { "list": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/insightsConfigs", "response": { "$ref": "ListInsightsConfigsResponse" }, "path": "v1/{+parent}/insightsConfigs", "parameterOrder": [ "parent" ], "id": "developerconnect.projects.locations.insightsConfigs.list", "parameters": { "pageSize": { "format": "int32", "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", "type": "integer", "location": "query" }, "filter": { "location": "query", "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.", "type": "string" }, "parent": { "description": "Required. Parent value for ListInsightsConfigsRequest.", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "type": "string", "location": "path" }, "pageToken": { "location": "query", "description": "Optional. A token identifying a page of results the server should return.", "type": "string" }, "orderBy": { "description": "Optional. Hint for how to order the results.", "type": "string", "location": "query" } }, "description": "Lists InsightsConfigs in a given project and location.", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "create": { "parameters": { "insightsConfigId": { "location": "query", "description": "Required. ID of the requesting InsightsConfig.", "type": "string" }, "parent": { "type": "string", "location": "path", "description": "Required. Value for parent.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$" }, "validateOnly": { "location": "query", "description": "Optional. If set, validate the request, but do not actually post it.", "type": "boolean" } }, "parameterOrder": [ "parent" ], "id": "developerconnect.projects.locations.insightsConfigs.create", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "InsightsConfig" }, "description": "Creates a new InsightsConfig in a given project and location.", "httpMethod": "POST", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/insightsConfigs", "response": { "$ref": "Operation" }, "path": "v1/{+parent}/insightsConfigs" }, "get": { "description": "Gets details of a single Insight.", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "developerconnect.projects.locations.insightsConfigs.get", "parameters": { "name": { "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/insightsConfigs/[^/]+$", "description": "Required. Name of the resource.", "location": "path", "type": "string" } }, "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/insightsConfigs/{insightsConfigsId}", "response": { "$ref": "InsightsConfig" } }, "delete": { "httpMethod": "DELETE", "description": "Deletes a single Insight.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "developerconnect.projects.locations.insightsConfigs.delete", "parameterOrder": [ "name" ], "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/insightsConfigs/[^/]+$", "required": true, "description": "Required. Value for parent.", "location": "path", "type": "string" }, "validateOnly": { "location": "query", "description": "Optional. If set, validate the request, but do not actually post it.", "type": "boolean" }, "requestId": { "location": "query", "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).", "type": "string" }, "etag": { "location": "query", "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" } }, "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/insightsConfigs/{insightsConfigsId}", "response": { "$ref": "Operation" } }, "patch": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/insightsConfigs/{insightsConfigsId}", "response": { "$ref": "Operation" }, "path": "v1/{+name}", "parameters": { "requestId": { "location": "query", "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).", "type": "string" }, "allowMissing": { "location": "query", "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).", "type": "boolean" }, "name": { "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/insightsConfigs/[^/]+$", "description": "Identifier. The name of the InsightsConfig. Format: projects/{project}/locations/{location}/insightsConfigs/{insightsConfig}", "location": "path", "type": "string" }, "validateOnly": { "description": "Optional. If set, validate the request, but do not actually post it.", "type": "boolean", "location": "query" } }, "id": "developerconnect.projects.locations.insightsConfigs.patch", "parameterOrder": [ "name" ], "request": { "$ref": "InsightsConfig" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "PATCH", "description": "Updates the parameters of a single InsightsConfig." } }, "resources": { "deploymentEvents": { "methods": { "get": { "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/insightsConfigs/{insightsConfigsId}/deploymentEvents/{deploymentEventsId}", "response": { "$ref": "DeploymentEvent" }, "httpMethod": "GET", "description": "Gets a single Deployment Event.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "developerconnect.projects.locations.insightsConfigs.deploymentEvents.get", "parameterOrder": [ "name" ], "parameters": { "name": { "type": "string", "location": "path", "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/[^/]+$", "required": true } } }, "list": { "path": "v1/{+parent}/deploymentEvents", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/insightsConfigs/{insightsConfigsId}/deploymentEvents", "response": { "$ref": "ListDeploymentEventsResponse" }, "description": "Lists Deployment Events in a given insights config.", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "id": "developerconnect.projects.locations.insightsConfigs.deploymentEvents.list", "parameters": { "pageSize": { "location": "query", "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.", "type": "integer", "format": "int32" }, "filter": { "description": "Optional. Filter expression that matches a subset of the DeploymentEvents. https://google.aip.dev/160.", "type": "string", "location": "query" }, "orderBy": { "description": "Optional. Field to use to order the list of DeploymentEvents. Expects AIP-132 format \"field_name asc\" or \"field_name desc\", e.g. \"deploy_time desc\" Supported fields for ordering are: deploy_time, update_time. Currently, only sorting by a single field is supported. If this field is not provided, the list will be sorted by \"deploy_time desc\". For more details on the ordering syntax, see https://google.aip.dev/132#ordering.", "type": "string", "location": "query" }, "pageToken": { "location": "query", "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.", "type": "string" }, "parent": { "location": "path", "type": "string", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/insightsConfigs/[^/]+$", "description": "Required. The parent insights config that owns this collection of deployment events. Format: projects/{project}/locations/{location}/insightsConfigs/{insights_config}" } } } } } } }, "operations": { "methods": { "cancel": { "parameterOrder": [ "name" ], "id": "developerconnect.projects.locations.operations.cancel", "parameters": { "name": { "location": "path", "type": "string", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be cancelled." } }, "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`.", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "CancelOperationRequest" }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel", "response": { "$ref": "Empty" }, "path": "v1/{+name}:cancel" }, "get": { "httpMethod": "GET", "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.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "developerconnect.projects.locations.operations.get", "parameterOrder": [ "name" ], "parameters": { "name": { "type": "string", "location": "path", "description": "The name of the operation resource.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$" } }, "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", "response": { "$ref": "Operation" } }, "delete": { "id": "developerconnect.projects.locations.operations.delete", "parameterOrder": [ "name" ], "parameters": { "name": { "type": "string", "location": "path", "description": "The name of the operation resource to be deleted.", "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", "required": true } }, "httpMethod": "DELETE", "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`.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", "response": { "$ref": "Empty" }, "path": "v1/{+name}" }, "list": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations", "response": { "$ref": "ListOperationsResponse" }, "path": "v1/{+name}/operations", "parameters": { "filter": { "description": "The standard list filter.", "type": "string", "location": "query" }, "pageSize": { "format": "int32", "description": "The standard list page size.", "type": "integer", "location": "query" }, "returnPartialSuccess": { "location": "query", "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.", "type": "boolean" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "description": "The name of the operation's parent resource.", "location": "path", "type": "string" }, "pageToken": { "description": "The standard list page token.", "type": "string", "location": "query" } }, "id": "developerconnect.projects.locations.operations.list", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`." } } }, "connections": { "methods": { "fetchGitHubInstallations": { "parameters": { "connection": { "type": "string", "location": "path", "description": "Required. The resource name of the connection in the format `projects/*/locations/*/connections/*`.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/connections/[^/]+$" } }, "id": "developerconnect.projects.locations.connections.fetchGitHubInstallations", "parameterOrder": [ "connection" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "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.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections/{connectionsId}:fetchGitHubInstallations", "response": { "$ref": "FetchGitHubInstallationsResponse" }, "path": "v1/{+connection}:fetchGitHubInstallations" }, "list": { "parameters": { "pageSize": { "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", "type": "integer", "format": "int32", "location": "query" }, "filter": { "description": "Optional. Filtering results", "type": "string", "location": "query" }, "orderBy": { "location": "query", "description": "Optional. Hint for how to order the results", "type": "string" }, "pageToken": { "description": "Optional. A token identifying a page of results the server should return.", "type": "string", "location": "query" }, "parent": { "description": "Required. Parent value for ListConnectionsRequest", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "type": "string", "location": "path" } }, "parameterOrder": [ "parent" ], "id": "developerconnect.projects.locations.connections.list", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists Connections in a given project and location.", "httpMethod": "GET", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections", "response": { "$ref": "ListConnectionsResponse" }, "path": "v1/{+parent}/connections" }, "get": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections/{connectionsId}", "response": { "$ref": "Connection" }, "path": "v1/{+name}", "parameterOrder": [ "name" ], "id": "developerconnect.projects.locations.connections.get", "parameters": { "name": { "description": "Required. Name of the resource", "pattern": "^projects/[^/]+/locations/[^/]+/connections/[^/]+$", "required": true, "type": "string", "location": "path" } }, "description": "Gets details of a single Connection.", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "create": { "path": "v1/{+parent}/connections", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections", "response": { "$ref": "Operation" }, "request": { "$ref": "Connection" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "description": "Creates a new Connection in a given project and location.", "parameters": { "validateOnly": { "location": "query", "description": "Optional. If set, validate the request, but do not actually post it.", "type": "boolean" }, "parent": { "location": "path", "type": "string", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. Value for parent." }, "connectionId": { "location": "query", "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", "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).", "type": "string", "location": "query" } }, "id": "developerconnect.projects.locations.connections.create", "parameterOrder": [ "parent" ] }, "delete": { "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections/{connectionsId}", "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "DELETE", "description": "Deletes a single Connection.", "parameters": { "name": { "type": "string", "location": "path", "description": "Required. Name of the resource", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/connections/[^/]+$" }, "validateOnly": { "description": "Optional. If set, validate the request, but do not actually post it.", "type": "boolean", "location": "query" }, "requestId": { "location": "query", "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).", "type": "string" }, "etag": { "location": "query", "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.", "type": "string" } }, "id": "developerconnect.projects.locations.connections.delete", "parameterOrder": [ "name" ] }, "patch": { "id": "developerconnect.projects.locations.connections.patch", "parameterOrder": [ "name" ], "parameters": { "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).", "type": "string", "location": "query" }, "validateOnly": { "location": "query", "description": "Optional. If set, validate the request, but do not actually post it.", "type": "boolean" }, "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).", "type": "boolean", "location": "query" }, "name": { "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/connections/[^/]+$", "description": "Identifier. The resource name of the connection, in the format `projects/{project}/locations/{location}/connections/{connection_id}`.", "location": "path", "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.", "type": "string", "format": "google-fieldmask", "location": "query" } }, "httpMethod": "PATCH", "description": "Updates the parameters of a single Connection.", "request": { "$ref": "Connection" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections/{connectionsId}", "response": { "$ref": "Operation" }, "path": "v1/{+name}" }, "fetchLinkableGitRepositories": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections/{connectionsId}:fetchLinkableGitRepositories", "response": { "$ref": "FetchLinkableGitRepositoriesResponse" }, "path": "v1/{+connection}:fetchLinkableGitRepositories", "parameterOrder": [ "connection" ], "id": "developerconnect.projects.locations.connections.fetchLinkableGitRepositories", "parameters": { "connection": { "location": "path", "type": "string", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/connections/[^/]+$", "description": "Required. The name of the Connection. Format: `projects/*/locations/*/connections/*`." }, "pageToken": { "location": "query", "description": "Optional. Page start.", "type": "string" }, "pageSize": { "format": "int32", "description": "Optional. Number of results to return in the list. Defaults to 20.", "type": "integer", "location": "query" } }, "description": "FetchLinkableGitRepositories returns a list of git repositories from an SCM that are available to be added to a Connection.", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "processGitHubEnterpriseWebhook": { "path": "v1/{+parent}/connections:processGitHubEnterpriseWebhook", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections:processGitHubEnterpriseWebhook", "response": { "$ref": "Empty" }, "request": { "$ref": "ProcessGitHubEnterpriseWebhookRequest" }, "httpMethod": "POST", "description": "ProcessGitHubEnterpriseWebhook is called by the external GitHub Enterprise instances for notifying events.", "parameters": { "parent": { "type": "string", "location": "path", "description": "Required. Project and location where the webhook will be received. Format: `projects/*/locations/*`.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$" } }, "id": "developerconnect.projects.locations.connections.processGitHubEnterpriseWebhook", "parameterOrder": [ "parent" ] } }, "resources": { "gitRepositoryLinks": { "methods": { "processBitbucketDataCenterWebhook": { "parameterOrder": [ "name" ], "id": "developerconnect.projects.locations.connections.gitRepositoryLinks.processBitbucketDataCenterWebhook", "parameters": { "name": { "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/connections/[^/]+/gitRepositoryLinks/[^/]+$", "description": "Required. The GitRepositoryLink where the webhook will be received. Format: `projects/*/locations/*/connections/*/gitRepositoryLinks/*`.", "location": "path", "type": "string" } }, "description": "ProcessBitbucketDataCenterWebhook is called by the external Bitbucket Data Center instances for notifying events.", "httpMethod": "POST", "request": { "$ref": "ProcessBitbucketDataCenterWebhookRequest" }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections/{connectionsId}/gitRepositoryLinks/{gitRepositoryLinksId}:processBitbucketDataCenterWebhook", "response": { "$ref": "Empty" }, "path": "v1/{+name}:processBitbucketDataCenterWebhook" }, "processBitbucketCloudWebhook": { "description": "ProcessBitbucketCloudWebhook is called by the external Bitbucket Cloud instances for notifying events.", "httpMethod": "POST", "request": { "$ref": "ProcessBitbucketCloudWebhookRequest" }, "parameterOrder": [ "name" ], "id": "developerconnect.projects.locations.connections.gitRepositoryLinks.processBitbucketCloudWebhook", "parameters": { "name": { "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/connections/[^/]+/gitRepositoryLinks/[^/]+$", "description": "Required. The GitRepositoryLink where the webhook will be received. Format: `projects/*/locations/*/connections/*/gitRepositoryLinks/*`.", "location": "path", "type": "string" } }, "path": "v1/{+name}:processBitbucketCloudWebhook", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections/{connectionsId}/gitRepositoryLinks/{gitRepositoryLinksId}:processBitbucketCloudWebhook", "response": { "$ref": "Empty" } }, "get": { "httpMethod": "GET", "description": "Gets details of a single GitRepositoryLink.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "developerconnect.projects.locations.connections.gitRepositoryLinks.get", "parameterOrder": [ "name" ], "parameters": { "name": { "location": "path", "type": "string", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/connections/[^/]+/gitRepositoryLinks/[^/]+$", "description": "Required. Name of the resource" } }, "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections/{connectionsId}/gitRepositoryLinks/{gitRepositoryLinksId}", "response": { "$ref": "GitRepositoryLink" } }, "fetchReadWriteToken": { "path": "v1/{+gitRepositoryLink}:fetchReadWriteToken", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections/{connectionsId}/gitRepositoryLinks/{gitRepositoryLinksId}:fetchReadWriteToken", "response": { "$ref": "FetchReadWriteTokenResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "FetchReadWriteTokenRequest" }, "description": "Fetches read/write token of a given gitRepositoryLink.", "httpMethod": "POST", "parameters": { "gitRepositoryLink": { "type": "string", "location": "path", "description": "Required. The resource name of the gitRepositoryLink in the format `projects/*/locations/*/connections/*/gitRepositoryLinks/*`.", "pattern": "^projects/[^/]+/locations/[^/]+/connections/[^/]+/gitRepositoryLinks/[^/]+$", "required": true } }, "parameterOrder": [ "gitRepositoryLink" ], "id": "developerconnect.projects.locations.connections.gitRepositoryLinks.fetchReadWriteToken" }, "processGitLabWebhook": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections/{connectionsId}/gitRepositoryLinks/{gitRepositoryLinksId}:processGitLabWebhook", "response": { "$ref": "Empty" }, "path": "v1/{+name}:processGitLabWebhook", "parameters": { "name": { "location": "path", "type": "string", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/connections/[^/]+/gitRepositoryLinks/[^/]+$", "description": "Required. The GitRepositoryLink resource where the webhook will be received. Format: `projects/*/locations/*/connections/*/gitRepositoryLinks/*`." } }, "id": "developerconnect.projects.locations.connections.gitRepositoryLinks.processGitLabWebhook", "parameterOrder": [ "name" ], "request": { "$ref": "ProcessGitLabWebhookRequest" }, "httpMethod": "POST", "description": "ProcessGitLabWebhook is called by the GitLab.com for notifying events." }, "list": { "path": "v1/{+parent}/gitRepositoryLinks", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections/{connectionsId}/gitRepositoryLinks", "response": { "$ref": "ListGitRepositoryLinksResponse" }, "description": "Lists GitRepositoryLinks in a given project, location, and connection.", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "id": "developerconnect.projects.locations.connections.gitRepositoryLinks.list", "parameters": { "pageSize": { "location": "query", "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", "type": "integer", "format": "int32" }, "filter": { "description": "Optional. Filtering results", "type": "string", "location": "query" }, "orderBy": { "location": "query", "description": "Optional. Hint for how to order the results", "type": "string" }, "pageToken": { "description": "Optional. A token identifying a page of results the server should return.", "type": "string", "location": "query" }, "parent": { "description": "Required. Parent value for ListGitRepositoryLinksRequest", "pattern": "^projects/[^/]+/locations/[^/]+/connections/[^/]+$", "required": true, "type": "string", "location": "path" } } }, "processGitLabEnterpriseWebhook": { "request": { "$ref": "ProcessGitLabEnterpriseWebhookRequest" }, "httpMethod": "POST", "description": "ProcessGitLabEnterpriseWebhook is called by the external GitLab Enterprise instances for notifying events.", "parameters": { "name": { "location": "path", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/connections/[^/]+/gitRepositoryLinks/[^/]+$", "required": true, "description": "Required. The GitRepositoryLink resource where the webhook will be received. Format: `projects/*/locations/*/connections/*/gitRepositoryLinks/*`." } }, "id": "developerconnect.projects.locations.connections.gitRepositoryLinks.processGitLabEnterpriseWebhook", "parameterOrder": [ "name" ], "path": "v1/{+name}:processGitLabEnterpriseWebhook", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections/{connectionsId}/gitRepositoryLinks/{gitRepositoryLinksId}:processGitLabEnterpriseWebhook", "response": { "$ref": "Empty" } }, "create": { "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.", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GitRepositoryLink" }, "parameterOrder": [ "parent" ], "id": "developerconnect.projects.locations.connections.gitRepositoryLinks.create", "parameters": { "parent": { "location": "path", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/connections/[^/]+$", "required": true, "description": "Required. Value for parent." }, "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 -._~%!$&'()*+,;=@.", "type": "string", "location": "query" }, "validateOnly": { "location": "query", "description": "Optional. If set, validate the request, but do not actually post it.", "type": "boolean" }, "requestId": { "location": "query", "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).", "type": "string" } }, "path": "v1/{+parent}/gitRepositoryLinks", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections/{connectionsId}/gitRepositoryLinks", "response": { "$ref": "Operation" } }, "delete": { "parameterOrder": [ "name" ], "id": "developerconnect.projects.locations.connections.gitRepositoryLinks.delete", "parameters": { "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).", "type": "string", "location": "query" }, "etag": { "location": "query", "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" }, "name": { "description": "Required. Name of the resource", "pattern": "^projects/[^/]+/locations/[^/]+/connections/[^/]+/gitRepositoryLinks/[^/]+$", "required": true, "type": "string", "location": "path" }, "validateOnly": { "description": "Optional. If set, validate the request, but do not actually post it.", "type": "boolean", "location": "query" } }, "description": "Deletes a single GitRepositoryLink.", "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections/{connectionsId}/gitRepositoryLinks/{gitRepositoryLinksId}", "response": { "$ref": "Operation" }, "path": "v1/{+name}" }, "fetchReadToken": { "path": "v1/{+gitRepositoryLink}:fetchReadToken", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections/{connectionsId}/gitRepositoryLinks/{gitRepositoryLinksId}:fetchReadToken", "response": { "$ref": "FetchReadTokenResponse" }, "request": { "$ref": "FetchReadTokenRequest" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "description": "Fetches read token of a given gitRepositoryLink.", "parameters": { "gitRepositoryLink": { "location": "path", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/connections/[^/]+/gitRepositoryLinks/[^/]+$", "required": true, "description": "Required. The resource name of the gitRepositoryLink in the format `projects/*/locations/*/connections/*/gitRepositoryLinks/*`." } }, "id": "developerconnect.projects.locations.connections.gitRepositoryLinks.fetchReadToken", "parameterOrder": [ "gitRepositoryLink" ] }, "fetchGitRefs": { "path": "v1/{+gitRepositoryLink}:fetchGitRefs", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/connections/{connectionsId}/gitRepositoryLinks/{gitRepositoryLinksId}:fetchGitRefs", "response": { "$ref": "FetchGitRefsResponse" }, "description": "Fetch the list of branches or tags for a given repository.", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "gitRepositoryLink" ], "id": "developerconnect.projects.locations.connections.gitRepositoryLinks.fetchGitRefs", "parameters": { "gitRepositoryLink": { "type": "string", "location": "path", "description": "Required. The resource name of GitRepositoryLink in the format `projects/*/locations/*/connections/*/gitRepositoryLinks/*`.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/connections/[^/]+/gitRepositoryLinks/[^/]+$" }, "pageToken": { "description": "Optional. Page start.", "type": "string", "location": "query" }, "refType": { "location": "query", "enum": [ "REF_TYPE_UNSPECIFIED", "TAG", "BRANCH" ], "type": "string", "description": "Required. Type of refs to fetch.", "enumDescriptions": [ "No type specified.", "To fetch tags.", "To fetch branches." ] }, "pageSize": { "location": "query", "description": "Optional. Number of results to return in the list. Default to 20.", "type": "integer", "format": "int32" } } } } } } }, "accountConnectors": { "methods": { "list": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/accountConnectors", "response": { "$ref": "ListAccountConnectorsResponse" }, "path": "v1/{+parent}/accountConnectors", "parameterOrder": [ "parent" ], "id": "developerconnect.projects.locations.accountConnectors.list", "parameters": { "pageSize": { "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", "type": "integer", "format": "int32", "location": "query" }, "filter": { "location": "query", "description": "Optional. Filtering results", "type": "string" }, "orderBy": { "location": "query", "description": "Optional. Hint for how to order the results", "type": "string" }, "pageToken": { "location": "query", "description": "Optional. A token identifying a page of results the server should return.", "type": "string" }, "parent": { "location": "path", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "description": "Required. Parent value for ListAccountConnectorsRequest" } }, "description": "Lists AccountConnectors in a given project and location.", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "parameterOrder": [ "name" ], "id": "developerconnect.projects.locations.accountConnectors.get", "parameters": { "name": { "type": "string", "location": "path", "description": "Required. Name of the resource", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/accountConnectors/[^/]+$" } }, "description": "Gets details of a single AccountConnector.", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/accountConnectors/{accountConnectorsId}", "response": { "$ref": "AccountConnector" }, "path": "v1/{+name}" }, "create": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/accountConnectors", "response": { "$ref": "Operation" }, "path": "v1/{+parent}/accountConnectors", "parameterOrder": [ "parent" ], "id": "developerconnect.projects.locations.accountConnectors.create", "parameters": { "requestId": { "location": "query", "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).", "type": "string" }, "parent": { "description": "Required. Location resource name as the account_connector’s parent.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string", "location": "path" }, "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.", "type": "string", "location": "query" }, "validateOnly": { "description": "Optional. If set, validate the request, but do not actually post it.", "type": "boolean", "location": "query" } }, "description": "Creates a new AccountConnector in a given project and location.", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "AccountConnector" } }, "delete": { "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/accountConnectors/{accountConnectorsId}", "response": { "$ref": "Operation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "DELETE", "description": "Deletes a single AccountConnector.", "parameters": { "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).", "type": "string", "location": "query" }, "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.", "type": "string", "location": "query" }, "validateOnly": { "description": "Optional. If set, validate the request, but do not actually post it.", "type": "boolean", "location": "query" }, "name": { "description": "Required. Name of the resource", "pattern": "^projects/[^/]+/locations/[^/]+/accountConnectors/[^/]+$", "required": true, "type": "string", "location": "path" }, "force": { "location": "query", "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.)", "type": "boolean" } }, "id": "developerconnect.projects.locations.accountConnectors.delete", "parameterOrder": [ "name" ] }, "patch": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/accountConnectors/{accountConnectorsId}", "response": { "$ref": "Operation" }, "path": "v1/{+name}", "parameters": { "validateOnly": { "description": "Optional. If set, validate the request, but do not actually post it.", "type": "boolean", "location": "query" }, "requestId": { "location": "query", "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).", "type": "string" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/accountConnectors/[^/]+$", "required": true, "description": "Identifier. The resource name of the accountConnector, in the format `projects/{project}/locations/{location}/accountConnectors/{account_connector_id}`.", "location": "path", "type": "string" }, "updateMask": { "description": "Optional. The list of fields to be updated.", "type": "string", "format": "google-fieldmask", "location": "query" }, "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", "type": "boolean", "location": "query" } }, "id": "developerconnect.projects.locations.accountConnectors.patch", "parameterOrder": [ "name" ], "request": { "$ref": "AccountConnector" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "PATCH", "description": "Updates the parameters of a single AccountConnector." }, "fetchUserRepositories": { "id": "developerconnect.projects.locations.accountConnectors.fetchUserRepositories", "parameterOrder": [ "accountConnector" ], "parameters": { "pageSize": { "format": "int32", "description": "Optional. Number of results to return in the list. Defaults to 20.", "type": "integer", "location": "query" }, "accountConnector": { "location": "path", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/accountConnectors/[^/]+$", "required": true, "description": "Required. The name of the Account Connector resource in the format: `projects/*/locations/*/accountConnectors/*`." }, "pageToken": { "location": "query", "description": "Optional. Page start.", "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.", "type": "string", "location": "query" } }, "httpMethod": "GET", "description": "FetchUserRepositories returns a list of UserRepos that are available for an account connector resource.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/accountConnectors/{accountConnectorsId}:fetchUserRepositories", "response": { "$ref": "FetchUserRepositoriesResponse" }, "path": "v1/{+accountConnector}:fetchUserRepositories" } }, "resources": { "users": { "methods": { "fetchSelf": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/accountConnectors/{accountConnectorsId}/users:fetchSelf", "response": { "$ref": "User" }, "path": "v1/{+name}/users:fetchSelf", "parameters": { "name": { "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/accountConnectors/[^/]+$", "description": "Required. Name of the AccountConnector resource", "location": "path", "type": "string" } }, "parameterOrder": [ "name" ], "id": "developerconnect.projects.locations.accountConnectors.users.fetchSelf", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Fetch the User based on the user credentials.", "httpMethod": "GET" }, "list": { "parameters": { "pageSize": { "location": "query", "description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.", "type": "integer", "format": "int32" }, "filter": { "description": "Optional. Filtering results", "type": "string", "location": "query" }, "orderBy": { "location": "query", "description": "Optional. Hint for how to order the results", "type": "string" }, "pageToken": { "location": "query", "description": "Optional. A token identifying a page of results the server should return.", "type": "string" }, "parent": { "location": "path", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/accountConnectors/[^/]+$", "required": true, "description": "Required. Parent value for ListUsersRequest" } }, "id": "developerconnect.projects.locations.accountConnectors.users.list", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "description": "Lists Users in a given project, location, and account_connector.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/accountConnectors/{accountConnectorsId}/users", "response": { "$ref": "ListUsersResponse" }, "path": "v1/{+parent}/users" }, "deleteSelf": { "path": "v1/{+name}/users:deleteSelf", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/accountConnectors/{accountConnectorsId}/users:deleteSelf", "response": { "$ref": "Operation" }, "description": "Delete the User based on the user credentials.", "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "id": "developerconnect.projects.locations.accountConnectors.users.deleteSelf", "parameters": { "name": { "type": "string", "location": "path", "description": "Required. Name of the AccountConnector resource", "pattern": "^projects/[^/]+/locations/[^/]+/accountConnectors/[^/]+$", "required": true } } }, "startOAuthFlow": { "description": "Starts OAuth flow for an account connector.", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "accountConnector" ], "id": "developerconnect.projects.locations.accountConnectors.users.startOAuthFlow", "parameters": { "accountConnector": { "pattern": "^projects/[^/]+/locations/[^/]+/accountConnectors/[^/]+$", "required": true, "description": "Required. The resource name of the AccountConnector in the format `projects/*/locations/*/accountConnectors/*`.", "location": "path", "type": "string" } }, "path": "v1/{+accountConnector}/users:startOAuthFlow", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/accountConnectors/{accountConnectorsId}/users:startOAuthFlow", "response": { "$ref": "StartOAuthResponse" } }, "delete": { "parameters": { "requestId": { "location": "query", "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).", "type": "string" }, "etag": { "location": "query", "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" }, "name": { "location": "path", "type": "string", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/accountConnectors/[^/]+/users/[^/]+$", "description": "Required. Name of the resource" }, "validateOnly": { "description": "Optional. If set, validate the request, but do not actually post it.", "type": "boolean", "location": "query" } }, "parameterOrder": [ "name" ], "id": "developerconnect.projects.locations.accountConnectors.users.delete", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Deletes a single User.", "httpMethod": "DELETE", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/accountConnectors/{accountConnectorsId}/users/{usersId}", "response": { "$ref": "Operation" }, "path": "v1/{+name}" }, "fetchAccessToken": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/accountConnectors/{accountConnectorsId}/users:fetchAccessToken", "response": { "$ref": "FetchAccessTokenResponse" }, "path": "v1/{+accountConnector}/users:fetchAccessToken", "parameterOrder": [ "accountConnector" ], "id": "developerconnect.projects.locations.accountConnectors.users.fetchAccessToken", "parameters": { "accountConnector": { "description": "Required. The resource name of the AccountConnector in the format `projects/*/locations/*/accountConnectors/*`.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/accountConnectors/[^/]+$", "type": "string", "location": "path" } }, "description": "Fetches OAuth access token based on end user credentials.", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "FetchAccessTokenRequest" } }, "finishOAuthFlow": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/accountConnectors/{accountConnectorsId}/users:finishOAuthFlow", "response": { "$ref": "FinishOAuthResponse" }, "path": "v1/{+accountConnector}/users:finishOAuthFlow", "id": "developerconnect.projects.locations.accountConnectors.users.finishOAuthFlow", "parameterOrder": [ "accountConnector" ], "parameters": { "oauthParams.code": { "location": "query", "description": "Required. The code to be used for getting the token from SCM provider.", "type": "string" }, "oauthParams.ticket": { "description": "Required. The ticket to be used for post processing the callback from SCM provider.", "type": "string", "location": "query" }, "googleOauthParams.ticket": { "description": "Required. The ticket to be used for post processing the callback from Google OAuth flow.", "type": "string", "location": "query" }, "accountConnector": { "location": "path", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/accountConnectors/[^/]+$", "required": true, "description": "Required. The resource name of the AccountConnector in the format `projects/*/locations/*/accountConnectors/*`." }, "googleOauthParams.scopes": { "repeated": true, "description": "Required. The scopes returned by Google OAuth flow.", "type": "string", "location": "query" }, "googleOauthParams.versionInfo": { "description": "Optional. The version info returned by Google OAuth flow.", "type": "string", "location": "query" } }, "httpMethod": "GET", "description": "Finishes OAuth flow for an account connector.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] } } } } } } } } } }, "baseUrl": "https://developerconnect.googleapis.com/", "canonicalName": "Developer Connect", "id": "developerconnect:v1", "ownerDomain": "google.com", "name": "developerconnect", "batchPath": "batch", "description": "Connect third-party source code management to Google", "discoveryVersion": "v1", "version": "v1", "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", "x32": "http://www.google.com/images/icons/product/search-32.gif" }, "protocol": "rest", "kind": "discovery#restDescription", "endpoints": [ { "endpointUrl": "https://developerconnect.us-central1.rep.googleapis.com/", "location": "us-central1", "description": "Regional Endpoint" }, { "description": "Regional Endpoint", "endpointUrl": "https://developerconnect.europe-west1.rep.googleapis.com/", "location": "europe-west1" }, { "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" }, { "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" } ], "basePath": "", "servicePath": "", "version_module": true, "ownerName": "Google", "parameters": { "callback": { "location": "query", "type": "string", "description": "JSONP" }, "$.xgafv": { "enum": [ "1", "2" ], "location": "query", "type": "string", "description": "V1 error format.", "enumDescriptions": [ "v1 error format", "v2 error format" ] }, "access_token": { "type": "string", "description": "OAuth access token.", "location": "query" }, "alt": { "enum": [ "json", "media", "proto" ], "location": "query", "type": "string", "default": "json", "enumDescriptions": [ "Responses with Content-Type of application/json", "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ], "description": "Data format for response." }, "prettyPrint": { "default": "true", "type": "boolean", "description": "Returns response with indentations and line breaks.", "location": "query" }, "upload_protocol": { "type": "string", "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", "location": "query" }, "oauth_token": { "location": "query", "type": "string", "description": "OAuth 2.0 token for the current user." }, "key": { "location": "query", "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." }, "uploadType": { "type": "string", "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", "location": "query" }, "fields": { "type": "string", "description": "Selector specifying which fields to include in a partial response.", "location": "query" }, "quotaUser": { "location": "query", "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." } }, "schemas": { "ProcessBitbucketCloudWebhookRequest": { "description": "RPC request object accepted by the ProcessBitbucketCloudWebhook RPC method.", "type": "object", "id": "ProcessBitbucketCloudWebhookRequest", "properties": { "body": { "description": "Required. HTTP request body.", "$ref": "HttpBody" } } }, "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", "id": "UserRepository", "properties": { "gitProxyUri": { "readOnly": true, "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.", "type": "string" }, "cloneUri": { "description": "Output only. The git clone URL of the repo. For example: https://github.com/myuser/myrepo.git", "type": "string", "readOnly": true }, "displayName": { "description": "Output only. The user friendly repo name (e.g., myuser/myrepo)", "type": "string", "readOnly": true } } }, "GitRepositoryLink": { "description": "Message describing the GitRepositoryLink object", "type": "object", "id": "GitRepositoryLink", "properties": { "reconciling": { "description": "Output only. Set to true when the connection is being set up or updated in the background.", "type": "boolean", "readOnly": true }, "createTime": { "readOnly": true, "description": "Output only. [Output only] Create timestamp", "type": "string", "format": "google-datetime" }, "updateTime": { "description": "Output only. [Output only] Update timestamp", "type": "string", "format": "google-datetime", "readOnly": true }, "uid": { "description": "Output only. A system-assigned unique identifier for the GitRepositoryLink.", "type": "string", "readOnly": true }, "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" }, "cloneUri": { "description": "Required. Git Clone URI.", "type": "string" }, "annotations": { "additionalProperties": { "type": "string" }, "description": "Optional. Allows clients to store small amounts of arbitrary data.", "type": "object" }, "labels": { "additionalProperties": { "type": "string" }, "description": "Optional. Labels as key value pairs", "type": "object" }, "deleteTime": { "format": "google-datetime", "description": "Output only. [Output only] Delete timestamp", "type": "string", "readOnly": true }, "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.", "type": "string", "readOnly": true }, "webhookId": { "readOnly": true, "description": "Output only. External ID of the webhook created for the repository.", "type": "string" }, "name": { "description": "Identifier. Resource name of the repository, in the format `projects/*/locations/*/connections/*/gitRepositoryLinks/*`.", "type": "string" } } }, "ListGitRepositoryLinksResponse": { "id": "ListGitRepositoryLinksResponse", "properties": { "nextPageToken": { "description": "A token identifying a page of results the server should return.", "type": "string" }, "gitRepositoryLinks": { "description": "The list of GitRepositoryLinks", "type": "array", "items": { "$ref": "GitRepositoryLink" } }, "unreachable": { "description": "Locations that could not be reached.", "type": "array", "items": { "type": "string" } } }, "description": "Message for response to listing GitRepositoryLinks", "type": "object" }, "FetchGitHubInstallationsResponse": { "id": "FetchGitHubInstallationsResponse", "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" } } }, "description": "Response of fetching github installations.", "type": "object" }, "ListInsightsConfigsResponse": { "id": "ListInsightsConfigsResponse", "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" } } }, "description": "Request for response to listing InsightsConfigs.", "type": "object" }, "BasicAuthentication": { "id": "BasicAuthentication", "properties": { "passwordSecretVersion": { "description": "The password SecretManager secret version to authenticate as.", "type": "string" }, "username": { "description": "Required. The username to authenticate as.", "type": "string" } }, "description": "Basic authentication with username and password.", "type": "object" }, "FetchReadTokenRequest": { "id": "FetchReadTokenRequest", "properties": {}, "description": "Message for fetching SCM read token.", "type": "object" }, "ProcessGitHubEnterpriseWebhookRequest": { "description": "RPC request object accepted by the ProcessGitHubEnterpriseWebhook RPC method.", "type": "object", "id": "ProcessGitHubEnterpriseWebhookRequest", "properties": { "body": { "description": "Required. HTTP request body.", "$ref": "HttpBody" } } }, "SecureSourceManagerInstanceConfig": { "id": "SecureSourceManagerInstanceConfig", "properties": { "instance": { "description": "Required. Immutable. Secure Source Manager instance resource, formatted as `projects/*/locations/*/instances/*`", "type": "string" } }, "description": "Configuration for connections to Secure Source Manager instance", "type": "object" }, "FetchReadWriteTokenRequest": { "description": "Message for fetching SCM read/write token.", "type": "object", "id": "FetchReadWriteTokenRequest", "properties": {} }, "ProcessGitLabWebhookRequest": { "description": "RPC request object accepted by the ProcessGitLabWebhook RPC method.", "type": "object", "id": "ProcessGitLabWebhookRequest", "properties": { "body": { "description": "Required. HTTP request body.", "$ref": "HttpBody" } } }, "ProviderOAuthConfig": { "id": "ProviderOAuthConfig", "properties": { "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" } }, "systemProviderId": { "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." ], "description": "Optional. Immutable. Developer Connect provided OAuth.", "type": "string", "enum": [ "SYSTEM_PROVIDER_UNSPECIFIED", "GITHUB", "GITLAB", "GOOGLE", "SENTRY", "ROVO", "NEW_RELIC", "DATASTAX", "DYNATRACE" ] } }, "description": "ProviderOAuthConfig is the OAuth config for a provider.", "type": "object" }, "CustomOAuthConfig": { "id": "CustomOAuthConfig", "properties": { "sslCaCertificate": { "description": "Optional. SSL certificate to use for requests to a private service.", "type": "string" }, "authUri": { "description": "Required. Immutable. The OAuth2 authorization server URL.", "type": "string" }, "pkceDisabled": { "description": "Optional. Disable PKCE for this OAuth config. PKCE is enabled by default.", "type": "boolean" }, "clientId": { "description": "Required. The client ID of the OAuth application.", "type": "string" }, "scmProvider": { "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." ], "description": "Required. The type of the SCM provider.", "type": "string", "enum": [ "SCM_PROVIDER_UNKNOWN", "GITHUB_ENTERPRISE", "GITLAB_ENTERPRISE", "BITBUCKET_DATA_CENTER" ] }, "scopes": { "description": "Required. The scopes to be requested during OAuth.", "type": "array", "items": { "type": "string" } }, "serviceDirectoryConfig": { "description": "Optional. Configuration for using Service Directory to connect to a private service.", "$ref": "ServiceDirectoryConfig" }, "hostUri": { "description": "Required. The host URI of the OAuth application.", "type": "string" }, "tokenUri": { "description": "Required. Immutable. The OAuth2 token request URL.", "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" }, "serverVersion": { "description": "Output only. SCM server version installed at the host URI.", "type": "string", "readOnly": true } }, "description": "Message for a customized OAuth config.", "type": "object" }, "ListUsersResponse": { "description": "Message for response to listing Users", "type": "object", "id": "ListUsersResponse", "properties": { "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" } }, "users": { "description": "The list of Users", "type": "array", "items": { "$ref": "User" } } } }, "LinkableGitRepository": { "id": "LinkableGitRepository", "properties": { "cloneUri": { "description": "The clone uri of the repository.", "type": "string" } }, "description": "LinkableGitRepository represents a git repository that can be linked to a connection.", "type": "object" }, "RuntimeConfig": { "id": "RuntimeConfig", "properties": { "state": { "description": "Output only. The state of the Runtime.", "enumDescriptions": [ "No state specified.", "The runtime configuration has been linked to the InsightsConfig.", "The runtime configuration has been unlinked to the InsightsConfig." ], "readOnly": true, "type": "string", "enum": [ "STATE_UNSPECIFIED", "LINKED", "UNLINKED" ] }, "googleCloudRun": { "description": "Output only. Cloud Run runtime.", "$ref": "GoogleCloudRun", "readOnly": true }, "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" }, "appHubWorkload": { "readOnly": true, "description": "Output only. App Hub Workload.", "$ref": "AppHubWorkload" }, "gkeWorkload": { "description": "Output only. Google Kubernetes Engine runtime.", "$ref": "GKEWorkload", "readOnly": true }, "appHubService": { "description": "Output only. App Hub Service.", "$ref": "AppHubService", "readOnly": true } }, "description": "RuntimeConfig represents the runtimes where the application is deployed.", "type": "object" }, "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", "id": "Empty", "properties": {} }, "ListConnectionsResponse": { "id": "ListConnectionsResponse", "properties": { "nextPageToken": { "description": "A token identifying a page of results the server should return.", "type": "string" }, "connections": { "description": "The list of Connection", "type": "array", "items": { "$ref": "Connection" } }, "unreachable": { "description": "Locations that could not be reached.", "type": "array", "items": { "type": "string" } } }, "description": "Message for response to listing Connections", "type": "object" }, "GoogleCloudRun": { "id": "GoogleCloudRun", "properties": { "serviceUri": { "description": "Required. Immutable. The name of the Cloud Run service. Format: `projects/{project}/locations/{location}/services/{service}`.", "type": "string" } }, "description": "GoogleCloudRun represents the Cloud Run runtime.", "type": "object" }, "GitLabEnterpriseConfig": { "description": "Configuration for connections to an instance of GitLab Enterprise.", "type": "object", "id": "GitLabEnterpriseConfig", "properties": { "serverVersion": { "readOnly": true, "description": "Output only. Version of the GitLab Enterprise server running on the `host_uri`.", "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" }, "sslCaCertificate": { "description": "Optional. SSL Certificate Authority certificate to use for requests to GitLab Enterprise instance.", "type": "string" }, "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" }, "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" } } }, "ArtifactConfig": { "id": "ArtifactConfig", "properties": { "googleArtifactAnalysis": { "description": "Optional. Set if the artifact metadata is stored in Artifact analysis.", "$ref": "GoogleArtifactAnalysis" }, "googleArtifactRegistry": { "description": "Optional. Set if the artifact is stored in Artifact registry.", "$ref": "GoogleArtifactRegistry" }, "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" } }, "description": "The artifact config of the artifact that is deployed.", "type": "object" }, "FetchReadTokenResponse": { "id": "FetchReadTokenResponse", "properties": { "token": { "description": "The token content.", "type": "string" }, "expirationTime": { "format": "google-datetime", "description": "Expiration timestamp. Can be empty if unknown or non-expiring.", "type": "string" }, "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" } }, "description": "Message for responding to get read token.", "type": "object" }, "FetchAccessTokenRequest": { "description": "Message for fetching an OAuth access token.", "type": "object", "id": "FetchAccessTokenRequest", "properties": {} }, "OperationMetadata": { "description": "Represents the metadata of the long-running operation.", "type": "object", "id": "OperationMetadata", "properties": { "apiVersion": { "readOnly": true, "description": "Output only. API version used to start the operation.", "type": "string" }, "createTime": { "readOnly": true, "format": "google-datetime", "description": "Output only. The time the operation was created.", "type": "string" }, "target": { "readOnly": true, "description": "Output only. Server-defined resource path for the target of the operation.", "type": "string" }, "verb": { "readOnly": true, "description": "Output only. Name of the verb executed by the operation.", "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`.", "type": "boolean", "readOnly": true }, "endTime": { "description": "Output only. The time the operation finished running.", "type": "string", "format": "google-datetime", "readOnly": true }, "statusMessage": { "readOnly": true, "description": "Output only. Human-readable status of the operation, if any.", "type": "string" } } }, "Operation": { "id": "Operation", "properties": { "response": { "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." }, "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" }, "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": { "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." }, "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" }, "error": { "description": "The error result of the operation in case of failure or cancellation.", "$ref": "Status" }, "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" } }, "description": "This resource represents a long-running operation that is the result of a network API call.", "type": "object" }, "FetchGitRefsResponse": { "description": "Response for fetching git refs.", "type": "object", "id": "FetchGitRefsResponse", "properties": { "nextPageToken": { "description": "A token identifying a page of results the server should return.", "type": "string" }, "refNames": { "description": "Name of the refs fetched.", "type": "array", "items": { "type": "string" } } } }, "User": { "description": "User represents a user connected to the service providers through a AccountConnector.", "type": "object", "id": "User", "properties": { "lastTokenRequestTime": { "description": "Output only. The timestamp when the token was last requested.", "type": "string", "format": "google-datetime", "readOnly": true }, "displayName": { "readOnly": true, "description": "Output only. Developer Connect automatically converts user identity to some human readable description, e.g., email address.", "type": "string" }, "createTime": { "description": "Output only. The timestamp when the user was created.", "type": "string", "format": "google-datetime", "readOnly": true }, "name": { "description": "Identifier. Resource name of the user, in the format `projects/*/locations/*/accountConnectors/*/users/*`.", "type": "string" } } }, "FetchUserRepositoriesResponse": { "id": "FetchUserRepositoriesResponse", "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" } }, "description": "Response message for FetchUserRepositories.", "type": "object" }, "ExchangeError": { "id": "ExchangeError", "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" } }, "description": "Message for representing an error from exchanging OAuth tokens.", "type": "object" }, "GitLabConfig": { "description": "Configuration for connections to gitlab.com.", "type": "object", "id": "GitLabConfig", "properties": { "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" }, "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" } } }, "InstallationState": { "id": "InstallationState", "properties": { "stage": { "type": "string", "enum": [ "STAGE_UNSPECIFIED", "PENDING_CREATE_APP", "PENDING_USER_OAUTH", "PENDING_INSTALL_APP", "COMPLETE" ], "description": "Output only. Current step of the installation process.", "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." ], "readOnly": true }, "message": { "readOnly": true, "description": "Output only. Message of what the user should do next to continue the installation. Empty string if the installation is already complete.", "type": "string" }, "actionUri": { "readOnly": true, "description": "Output only. Link to follow for next action. Empty string if the installation is already complete.", "type": "string" } }, "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" }, "ProxyConfig": { "description": "The proxy configuration.", "type": "object", "id": "ProxyConfig", "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.", "type": "string", "readOnly": true } } }, "ListOperationsResponse": { "description": "The response message for Operations.ListOperations.", "type": "object", "id": "ListOperationsResponse", "properties": { "operations": { "description": "A list of operations that matches the specified filter in the request.", "type": "array", "items": { "$ref": "Operation" } }, "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" } }, "nextPageToken": { "description": "The standard List next-page token.", "type": "string" } } }, "GitHubConfig": { "id": "GitHubConfig", "properties": { "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" }, "installationUri": { "description": "Output only. The URI to navigate to in order to manage the installation associated with this GitHubConfig.", "type": "string", "readOnly": true }, "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" ] }, "appInstallationId": { "description": "Optional. GitHub App installation id.", "type": "string", "format": "int64" } }, "description": "Configuration for connections to github.com.", "type": "object" }, "FetchLinkableGitRepositoriesResponse": { "id": "FetchLinkableGitRepositoriesResponse", "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" } }, "description": "Response message for FetchLinkableGitRepositories.", "type": "object" }, "FetchReadWriteTokenResponse": { "description": "Message for responding to get read/write token.", "type": "object", "id": "FetchReadWriteTokenResponse", "properties": { "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" }, "expirationTime": { "format": "google-datetime", "description": "Expiration timestamp. Can be empty if unknown or non-expiring.", "type": "string" }, "token": { "description": "The token content.", "type": "string" } } }, "ProcessBitbucketDataCenterWebhookRequest": { "description": "RPC request object accepted by the ProcessBitbucketDataCenterWebhook RPC method.", "type": "object", "id": "ProcessBitbucketDataCenterWebhookRequest", "properties": { "body": { "description": "Required. HTTP request body.", "$ref": "HttpBody" } } }, "CancelOperationRequest": { "id": "CancelOperationRequest", "properties": {}, "description": "The request message for Operations.CancelOperation.", "type": "object" }, "GenericHTTPEndpointConfig": { "description": "Defines the configuration for connections to an HTTP service provider.", "type": "object", "id": "GenericHTTPEndpointConfig", "properties": { "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" }, "basicAuthentication": { "description": "Optional. Basic authentication with username and password.", "$ref": "BasicAuthentication" }, "sslCaCertificate": { "description": "Optional. The SSL certificate to use for requests to the HTTP service provider.", "type": "string" }, "bearerTokenAuthentication": { "description": "Optional. Bearer token authentication with a token.", "$ref": "BearerTokenAuthentication" } } }, "UserCredential": { "description": "Represents a personal access token that authorized the Connection, and associated metadata.", "type": "object", "id": "UserCredential", "properties": { "username": { "description": "Output only. The username associated with this token.", "type": "string", "readOnly": true }, "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" } } }, "Projects": { "description": "Projects represents the projects to track with the InsightsConfig.", "type": "object", "id": "Projects", "properties": { "projectIds": { "description": "Optional. The project IDs. Format: {project}", "type": "array", "items": { "type": "string" } } } }, "ListDeploymentEventsResponse": { "id": "ListDeploymentEventsResponse", "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" } }, "description": "Response to listing DeploymentEvents.", "type": "object" }, "GKEWorkload": { "id": "GKEWorkload", "properties": { "deployment": { "description": "Output only. The name of the GKE deployment. Format: `projects/{project}/locations/{location}/clusters/{cluster}/namespaces/{namespace}/deployments/{deployment}`.", "type": "string", "readOnly": true }, "cluster": { "description": "Required. Immutable. The name of the GKE cluster. Format: `projects/{project}/locations/{location}/clusters/{cluster}`.", "type": "string" } }, "description": "GKEWorkload represents the Google Kubernetes Engine runtime.", "type": "object" }, "ProcessGitLabEnterpriseWebhookRequest": { "id": "ProcessGitLabEnterpriseWebhookRequest", "properties": { "body": { "description": "Required. HTTP request body.", "$ref": "HttpBody" } }, "description": "RPC request object accepted by the ProcessGitLabEnterpriseWebhook RPC method.", "type": "object" }, "BitbucketCloudConfig": { "description": "Configuration for connections to an instance of Bitbucket Cloud.", "type": "object", "id": "BitbucketCloudConfig", "properties": { "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" }, "workspace": { "description": "Required. The Bitbucket Cloud Workspace ID to be connected to Google Cloud Platform.", "type": "string" } } }, "DeploymentEvent": { "description": "The DeploymentEvent resource represents the deployment of the artifact within the InsightsConfig resource.", "type": "object", "id": "DeploymentEvent", "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" }, "runtimeConfig": { "readOnly": true, "description": "Output only. The runtime configurations where the DeploymentEvent happened.", "$ref": "RuntimeConfig" }, "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.", "type": "array", "items": { "$ref": "ArtifactDeployment" }, "readOnly": true }, "runtimeDeploymentUri": { "readOnly": true, "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.", "type": "string" }, "deployTime": { "readOnly": true, "format": "google-datetime", "description": "Output only. The time at which the DeploymentEvent was deployed. This would be the min of all ArtifactDeployment deploy_times.", "type": "string" }, "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.", "type": "string", "format": "google-datetime", "readOnly": true }, "state": { "readOnly": true, "enumDescriptions": [ "No state specified.", "The deployment is active in the runtime.", "The deployment is not in the runtime." ], "description": "Output only. The state of the DeploymentEvent.", "enum": [ "STATE_UNSPECIFIED", "STATE_ACTIVE", "STATE_INACTIVE" ], "type": "string" }, "createTime": { "readOnly": true, "description": "Output only. The create time of the DeploymentEvent.", "type": "string", "format": "google-datetime" }, "updateTime": { "readOnly": true, "format": "google-datetime", "description": "Output only. The update time of the DeploymentEvent.", "type": "string" } } }, "BearerTokenAuthentication": { "id": "BearerTokenAuthentication", "properties": { "tokenSecretVersion": { "description": "Optional. The token SecretManager secret version to authenticate as.", "type": "string" } }, "description": "Bearer token authentication with a token.", "type": "object" }, "CryptoKeyConfig": { "id": "CryptoKeyConfig", "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" } }, "description": "The crypto key configuration. This field is used by the Customer-managed encryption keys (CMEK) feature.", "type": "object" }, "GitHubEnterpriseConfig": { "description": "Configuration for connections to an instance of GitHub Enterprise.", "type": "object", "id": "GitHubEnterpriseConfig", "properties": { "appInstallationId": { "format": "int64", "description": "Optional. ID of the installation of the GitHub App.", "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" }, "installationUri": { "readOnly": true, "description": "Output only. The URI to navigate to in order to manage the installation associated with this GitHubEnterpriseConfig.", "type": "string" }, "sslCaCertificate": { "description": "Optional. SSL certificate to use for requests to GitHub Enterprise.", "type": "string" }, "appSlug": { "readOnly": true, "description": "Output only. The URL-friendly name of the GitHub App.", "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" }, "appId": { "description": "Optional. ID of the GitHub App created from the manifest.", "type": "string", "format": "int64" }, "hostUri": { "description": "Required. The URI of the GitHub Enterprise host this connection is for.", "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" }, "organization": { "description": "Optional. Immutable. GitHub Enterprise organization in which the GitHub App is created.", "type": "string" }, "serverVersion": { "description": "Output only. GitHub Enterprise version installed at the host_uri.", "type": "string", "readOnly": true } } }, "FetchAccessTokenResponse": { "description": "Message for responding to getting an OAuth access token.", "type": "object", "id": "FetchAccessTokenResponse", "properties": { "token": { "description": "The token content.", "type": "string" }, "exchangeError": { "description": "The error resulted from exchanging OAuth tokens from the service provider.", "$ref": "ExchangeError" }, "expirationTime": { "format": "google-datetime", "description": "Expiration timestamp. Can be empty if unknown or non-expiring.", "type": "string" }, "scopes": { "description": "The scopes of the access token.", "type": "array", "items": { "type": "string" } } } }, "GoogleArtifactAnalysis": { "id": "GoogleArtifactAnalysis", "properties": { "projectId": { "description": "Required. The project id of the project where the provenance is stored.", "type": "string" } }, "description": "Google Artifact Analysis configurations.", "type": "object" }, "FinishOAuthResponse": { "description": "Message for responding to finishing an OAuth flow.", "type": "object", "id": "FinishOAuthResponse", "properties": { "exchangeError": { "description": "The error resulted from exchanging OAuth tokens from the service provider.", "$ref": "ExchangeError" } } }, "ServiceDirectoryConfig": { "description": "ServiceDirectoryConfig represents Service Directory configuration for a connection.", "type": "object", "id": "ServiceDirectoryConfig", "properties": { "service": { "description": "Required. The Service Directory service name. Format: projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}.", "type": "string" } } }, "Installation": { "description": "Represents an installation of the GitHub App.", "type": "object", "id": "Installation", "properties": { "type": { "description": "Either \"user\" or \"organization\".", "type": "string" }, "id": { "format": "int64", "description": "ID of the installation in GitHub.", "type": "string" }, "name": { "description": "Name of the GitHub user or organization that owns this installation.", "type": "string" } } }, "GoogleArtifactRegistry": { "id": "GoogleArtifactRegistry", "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" } }, "description": "Google Artifact Registry configurations.", "type": "object" }, "Status": { "id": "Status", "properties": { "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": { "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." }, "type": "object" } }, "code": { "format": "int32", "description": "The status code, which should be an enum value of google.rpc.Code.", "type": "integer" }, "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" } }, "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" }, "BitbucketDataCenterConfig": { "id": "BitbucketDataCenterConfig", "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" }, "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" }, "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" }, "serverVersion": { "readOnly": true, "description": "Output only. Version of the Bitbucket Data Center server running on the `host_uri`.", "type": "string" } }, "description": "Configuration for connections to an instance of Bitbucket Data Center.", "type": "object" }, "ListLocationsResponse": { "description": "The response message for Locations.ListLocations.", "type": "object", "id": "ListLocationsResponse", "properties": { "nextPageToken": { "description": "The standard List next-page token.", "type": "string" }, "locations": { "description": "A list of locations that matches the specified filter in the request.", "type": "array", "items": { "$ref": "Location" } } } }, "ListAccountConnectorsResponse": { "id": "ListAccountConnectorsResponse", "properties": { "nextPageToken": { "description": "A token identifying a page of results the server should return.", "type": "string" }, "accountConnectors": { "description": "The list of AccountConnectors", "type": "array", "items": { "$ref": "AccountConnector" } }, "unreachable": { "description": "Locations that could not be reached.", "type": "array", "items": { "type": "string" } } }, "description": "Message for response to listing AccountConnectors", "type": "object" }, "InsightsConfig": { "id": "InsightsConfig", "properties": { "appHubApplication": { "description": "Optional. The name of the App Hub Application. Format: projects/{project}/locations/{location}/applications/{application}", "type": "string" }, "createTime": { "readOnly": true, "description": "Output only. Create timestamp.", "type": "string", "format": "google-datetime" }, "updateTime": { "description": "Output only. Update timestamp.", "type": "string", "format": "google-datetime", "readOnly": true }, "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.", "type": "boolean", "readOnly": true }, "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" ] }, "labels": { "additionalProperties": { "type": "string" }, "description": "Optional. Set of labels associated with an InsightsConfig.", "type": "object" }, "annotations": { "additionalProperties": { "type": "string" }, "description": "Optional. User specified annotations. See https://google.aip.dev/148#annotations for more details such as format and size limitations.", "type": "object" }, "projects": { "description": "Optional. The projects to track with the InsightsConfig.", "$ref": "Projects" }, "artifactConfigs": { "description": "Optional. The artifact configurations of the artifacts that are deployed.", "type": "array", "items": { "$ref": "ArtifactConfig" } }, "runtimeConfigs": { "description": "Output only. The runtime configurations where the application is deployed.", "type": "array", "items": { "$ref": "RuntimeConfig" }, "readOnly": true }, "name": { "description": "Identifier. The name of the InsightsConfig. Format: projects/{project}/locations/{location}/insightsConfigs/{insightsConfig}", "type": "string" }, "errors": { "readOnly": true, "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.", "type": "array", "items": { "$ref": "Status" } } }, "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" }, "ArtifactDeployment": { "id": "ArtifactDeployment", "properties": { "artifactReference": { "description": "Output only. The artifact that is deployed.", "type": "string", "readOnly": true }, "id": { "readOnly": true, "description": "Output only. Unique identifier of `ArtifactDeployment`.", "type": "string" }, "sourceCommitUris": { "readOnly": true, "description": "Output only. The source commits at which this artifact was built. Extracted from provenance.", "type": "array", "items": { "type": "string" } }, "undeployTime": { "readOnly": true, "description": "Output only. The time at which the deployment was undeployed, all artifacts are considered undeployed once this time is set.", "type": "string", "format": "google-datetime" }, "containerStatusSummary": { "readOnly": true, "description": "Output only. The summary of container status of the artifact deployment. Format as `ContainerStatusState-Reason : restartCount` e.g. \"Waiting-ImagePullBackOff : 3\"", "type": "string" }, "sourceCodeUris": { "readOnly": true, "description": "Output only. The URIs of the source code, if available. For Cloud Run source deploy for example: `gs://my-bucket/my-folder/1234567890.abcde-fdbe.zip#1234567890`", "type": "array", "items": { "type": "string" } }, "artifactAlias": { "readOnly": true, "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", "type": "string" }, "deployTime": { "description": "Output only. The time at which the deployment was deployed.", "type": "string", "format": "google-datetime", "readOnly": true } }, "description": "The ArtifactDeployment resource represents the deployment of the artifact within the InsightsConfig resource.", "type": "object" }, "GitProxyConfig": { "description": "The git proxy configuration.", "type": "object", "id": "GitProxyConfig", "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.", "type": "string", "readOnly": true } } }, "StartOAuthResponse": { "id": "StartOAuthResponse", "properties": { "scopes": { "description": "The list of scopes requested by the application.", "type": "array", "items": { "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" }, "authUri": { "description": "The authorization server URL to the OAuth flow of the service provider.", "type": "string" }, "ticket": { "description": "The ticket to be used for post processing the callback from the service provider.", "type": "string" }, "clientId": { "description": "The client ID to the OAuth App of the service provider.", "type": "string" }, "systemProviderId": { "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." ], "description": "The ID of the system provider.", "type": "string", "enum": [ "SYSTEM_PROVIDER_UNSPECIFIED", "GITHUB", "GITLAB", "GOOGLE", "SENTRY", "ROVO", "NEW_RELIC", "DATASTAX", "DYNATRACE" ] } }, "description": "Message for responding to starting an OAuth flow.", "type": "object" }, "AppHubWorkload": { "id": "AppHubWorkload", "properties": { "criticality": { "description": "Output only. The criticality of the App Hub Workload.", "type": "string", "readOnly": true }, "workload": { "readOnly": true, "description": "Required. Output only. Immutable. The name of the App Hub Workload. Format: `projects/{project}/locations/{location}/applications/{application}/workloads/{workload}`.", "type": "string" }, "environment": { "readOnly": true, "description": "Output only. The environment of the App Hub Workload.", "type": "string" } }, "description": "AppHubWorkload represents the App Hub Workload.", "type": "object" }, "Location": { "id": "Location", "properties": { "metadata": { "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." }, "description": "Service-specific metadata. For example the available capacity at the given location.", "type": "object" }, "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": { "additionalProperties": { "type": "string" }, "description": "Cross-service attributes for the location. For example {\"cloud.googleapis.com/region\": \"us-east1\"}", "type": "object" }, "name": { "description": "Resource name for the location, which may vary between implementations. For example: `\"projects/example-project/locations/us-east1\"`", "type": "string" } }, "description": "A resource that represents a Google Cloud location.", "type": "object" }, "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", "id": "HttpBody", "properties": { "contentType": { "description": "The HTTP Content-Type header value specifying the content type of the body.", "type": "string" }, "data": { "format": "byte", "description": "The HTTP request/response body as raw binary.", "type": "string" }, "extensions": { "description": "Application specific response metadata. Must be set in the first response for streaming APIs.", "type": "array", "items": { "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." }, "type": "object" } } } }, "OAuthCredential": { "description": "Represents an OAuth token of the account that authorized the Connection, and associated metadata.", "type": "object", "id": "OAuthCredential", "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.", "type": "string", "readOnly": true } } }, "Connection": { "description": "Message describing Connection object", "type": "object", "id": "Connection", "properties": { "githubEnterpriseConfig": { "description": "Configuration for connections to an instance of GitHub Enterprise.", "$ref": "GitHubEnterpriseConfig" }, "cryptoKeyConfig": { "description": "Optional. The crypto key configuration. This field is used by the Customer-Managed Encryption Keys (CMEK) feature.", "$ref": "CryptoKeyConfig" }, "githubConfig": { "description": "Configuration for connections to github.com.", "$ref": "GitHubConfig" }, "gitlabConfig": { "description": "Configuration for connections to gitlab.com.", "$ref": "GitLabConfig" }, "secureSourceManagerInstanceConfig": { "description": "Configuration for connections to an instance of Secure Source Manager.", "$ref": "SecureSourceManagerInstanceConfig" }, "annotations": { "description": "Optional. Allows clients to store small amounts of arbitrary data.", "type": "object", "additionalProperties": { "type": "string" } }, "labels": { "additionalProperties": { "type": "string" }, "description": "Optional. Labels as key value pairs", "type": "object" }, "createTime": { "format": "google-datetime", "description": "Output only. [Output only] Create timestamp", "type": "string", "readOnly": true }, "httpConfig": { "description": "Optional. Configuration for connections to an HTTP service provider.", "$ref": "GenericHTTPEndpointConfig" }, "reconciling": { "description": "Output only. Set to true when the connection is being set up or updated in the background.", "type": "boolean", "readOnly": true }, "gitlabEnterpriseConfig": { "description": "Configuration for connections to an instance of GitLab Enterprise.", "$ref": "GitLabEnterpriseConfig" }, "name": { "description": "Identifier. The resource name of the connection, in the format `projects/{project}/locations/{location}/connections/{connection_id}`.", "type": "string" }, "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" }, "bitbucketDataCenterConfig": { "description": "Configuration for connections to an instance of Bitbucket Data Center.", "$ref": "BitbucketDataCenterConfig" }, "deleteTime": { "format": "google-datetime", "description": "Output only. [Output only] Delete timestamp", "type": "string", "readOnly": true }, "installationState": { "description": "Output only. Installation state of the Connection.", "$ref": "InstallationState", "readOnly": true }, "updateTime": { "description": "Output only. [Output only] Update timestamp", "type": "string", "format": "google-datetime", "readOnly": true }, "uid": { "description": "Output only. A system-assigned unique identifier for the Connection.", "type": "string", "readOnly": true }, "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" }, "bitbucketCloudConfig": { "description": "Configuration for connections to an instance of Bitbucket Clouds.", "$ref": "BitbucketCloudConfig" }, "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" } } }, "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", "id": "AccountConnector", "properties": { "annotations": { "additionalProperties": { "type": "string" }, "description": "Optional. Allows users to store small amounts of arbitrary data.", "type": "object" }, "labels": { "additionalProperties": { "type": "string" }, "description": "Optional. Labels as key value pairs", "type": "object" }, "oauthStartUri": { "readOnly": true, "description": "Output only. Start OAuth flow by clicking on this URL.", "type": "string" }, "customOauthConfig": { "description": "Custom OAuth config.", "$ref": "CustomOAuthConfig" }, "createTime": { "description": "Output only. The timestamp when the accountConnector was created.", "type": "string", "format": "google-datetime", "readOnly": true }, "updateTime": { "readOnly": true, "description": "Output only. The timestamp when the accountConnector was updated.", "type": "string", "format": "google-datetime" }, "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.", "type": "string", "readOnly": true }, "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" }, "name": { "description": "Identifier. The resource name of the accountConnector, in the format `projects/{project}/locations/{location}/accountConnectors/{account_connector_id}`.", "type": "string" }, "providerOauthConfig": { "description": "Optional. Provider OAuth config.", "$ref": "ProviderOAuthConfig" } } }, "AppHubService": { "description": "AppHubService represents the App Hub Service.", "type": "object", "id": "AppHubService", "properties": { "environment": { "readOnly": true, "description": "Output only. The environment of the App Hub Service.", "type": "string" }, "apphubService": { "description": "Required. Output only. Immutable. The name of the App Hub Service. Format: `projects/{project}/locations/{location}/applications/{application}/services/{service}`.", "type": "string", "readOnly": true }, "criticality": { "readOnly": true, "description": "Output only. The criticality of the App Hub Service.", "type": "string" } } } }, "revision": "20260804", "mtlsRootUrl": "https://developerconnect.mtls.googleapis.com/", "title": "Developer Connect API", "rootUrl": "https://developerconnect.googleapis.com/", "documentationLink": "http://cloud.google.com/developer-connect/docs/overview", "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." } } } } }