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