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