# Developer Connect API . projects . locations . accountConnectors

## Instance Methods

Returns the users Resource.

Close httplib2 connections.

Creates a new AccountConnector in a given project and location.

Deletes a single AccountConnector.

FetchUserRepositories returns a list of UserRepos that are available for an account connector resource.

Retrieves the next page of results.

Gets details of a single AccountConnector.

Lists AccountConnectors in a given project and location.

Retrieves the next page of results.

Updates the parameters of a single AccountConnector.

### Method Details

`close()`

    Close httplib2 connections.

`create(parent, accountConnectorId=None, body=None, requestId=None, validateOnly=None, x__xgafv=None)`

    Creates a new AccountConnector in a given project and location.

    Args:
      parent: string, Required. Location resource name as the account_connector’s parent. (required)
      body: object, The request body.
        The object takes the form of:

    { # 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.
      "annotations": { # Optional. Allows users to store small amounts of arbitrary data.
        "a_key": "A String",
      },
      "createTime": "A String", # Output only. The timestamp when the accountConnector was created.
      "customOauthConfig": { # Message for a customized OAuth config. # Custom OAuth config.
        "authUri": "A String", # Required. Immutable. The OAuth2 authorization server URL.
        "clientId": "A String", # Required. The client ID of the OAuth application.
        "clientSecret": "A String", # 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.
        "hostUri": "A String", # Required. The host URI of the OAuth application.
        "pkceDisabled": True or False, # Optional. Disable PKCE for this OAuth config. PKCE is enabled by default.
        "scmProvider": "A String", # Required. The type of the SCM provider.
        "scopes": [ # Required. The scopes to be requested during OAuth.
          "A String",
        ],
        "serverVersion": "A String", # Output only. SCM server version installed at the host URI.
        "serviceDirectoryConfig": { # ServiceDirectoryConfig represents Service Directory configuration for a connection. # Optional. Configuration for using Service Directory to connect to a private service.
          "service": "A String", # Required. The Service Directory service name. Format: projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}.
        },
        "sslCaCertificate": "A String", # Optional. SSL certificate to use for requests to a private service.
        "tokenUri": "A String", # Required. Immutable. The OAuth2 token request URL.
      },
      "etag": "A String", # 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.
      "labels": { # Optional. Labels as key value pairs
        "a_key": "A String",
      },
      "name": "A String", # Identifier. The resource name of the accountConnector, in the format `projects/{project}/locations/{location}/accountConnectors/{account_connector_id}`.
      "oauthStartUri": "A String", # Output only. Start OAuth flow by clicking on this URL.
      "providerOauthConfig": { # ProviderOAuthConfig is the OAuth config for a provider. # Optional. Provider OAuth config.
        "scopes": [ # 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.
          "A String",
        ],
        "systemProviderId": "A String", # Optional. Immutable. Developer Connect provided OAuth.
      },
      "proxyConfig": { # The proxy configuration. # Optional. Configuration for the http and git proxy features.
        "enabled": True or False, # Optional. Setting this to true allows the git and http proxies to perform actions on behalf of the user configured under the account connector.
      },
      "updateTime": "A String", # Output only. The timestamp when the accountConnector was updated.
    }

      accountConnectorId: string, 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.
      requestId: string, 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).
      validateOnly: boolean, Optional. If set, validate the request, but do not actually post it.
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # This resource represents a long-running operation that is the result of a network API call.
      "done": True or False, # 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": { # 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). # The error result of the operation in case of failure or cancellation.
        "code": 42, # The status code, which should be an enum value of google.rpc.Code.
        "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
          {
            "a_key": "", # Properties of the object. Contains field @type with type URL.
          },
        ],
        "message": "A String", # 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.
      },
      "metadata": { # 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.
        "a_key": "", # Properties of the object. Contains field @type with type URL.
      },
      "name": "A String", # 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}`.
      "response": { # 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`.
        "a_key": "", # Properties of the object. Contains field @type with type URL.
      },
    }

`delete(name, etag=None, force=None, requestId=None, validateOnly=None, x__xgafv=None)`

    Deletes a single AccountConnector.

    Args:
      name: string, Required. Name of the resource (required)
      etag: string, 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.
      force: boolean, 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.)
      requestId: string, 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).
      validateOnly: boolean, Optional. If set, validate the request, but do not actually post it.
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # This resource represents a long-running operation that is the result of a network API call.
      "done": True or False, # 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": { # 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). # The error result of the operation in case of failure or cancellation.
        "code": 42, # The status code, which should be an enum value of google.rpc.Code.
        "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
          {
            "a_key": "", # Properties of the object. Contains field @type with type URL.
          },
        ],
        "message": "A String", # 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.
      },
      "metadata": { # 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.
        "a_key": "", # Properties of the object. Contains field @type with type URL.
      },
      "name": "A String", # 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}`.
      "response": { # 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`.
        "a_key": "", # Properties of the object. Contains field @type with type URL.
      },
    }

`fetchUserRepositories(accountConnector, pageSize=None, pageToken=None, repository=None, x__xgafv=None)`

    FetchUserRepositories returns a list of UserRepos that are available for an account connector resource.

    Args:
      accountConnector: string, Required. The name of the Account Connector resource in the format: `projects/*/locations/*/accountConnectors/*`. (required)
      pageSize: integer, Optional. Number of results to return in the list. Defaults to 20.
      pageToken: string, Optional. Page start.
      repository: string, 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.
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # Response message for FetchUserRepositories.
      "nextPageToken": "A String", # A token identifying a page of results the server should return.
      "userRepos": [ # The repositories that the user can access with this account connector.
        { # 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.
          "cloneUri": "A String", # Output only. The git clone URL of the repo. For example: https://github.com/myuser/myrepo.git
          "displayName": "A String", # Output only. The user friendly repo name (e.g., myuser/myrepo)
          "gitProxyUri": "A String", # 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.
        },
      ],
    }

`fetchUserRepositories_next()`

    Retrieves the next page of results.

            Args:
              previous_request: The request for the previous page. (required)
              previous_response: The response from the request for the previous page. (required)

            Returns:
              A request object that you can call 'execute()' on to request the next
              page. Returns None if there are no more items in the collection.

`get(name, x__xgafv=None)`

    Gets details of a single AccountConnector.

    Args:
      name: string, Required. Name of the resource (required)
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # 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.
      "annotations": { # Optional. Allows users to store small amounts of arbitrary data.
        "a_key": "A String",
      },
      "createTime": "A String", # Output only. The timestamp when the accountConnector was created.
      "customOauthConfig": { # Message for a customized OAuth config. # Custom OAuth config.
        "authUri": "A String", # Required. Immutable. The OAuth2 authorization server URL.
        "clientId": "A String", # Required. The client ID of the OAuth application.
        "clientSecret": "A String", # 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.
        "hostUri": "A String", # Required. The host URI of the OAuth application.
        "pkceDisabled": True or False, # Optional. Disable PKCE for this OAuth config. PKCE is enabled by default.
        "scmProvider": "A String", # Required. The type of the SCM provider.
        "scopes": [ # Required. The scopes to be requested during OAuth.
          "A String",
        ],
        "serverVersion": "A String", # Output only. SCM server version installed at the host URI.
        "serviceDirectoryConfig": { # ServiceDirectoryConfig represents Service Directory configuration for a connection. # Optional. Configuration for using Service Directory to connect to a private service.
          "service": "A String", # Required. The Service Directory service name. Format: projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}.
        },
        "sslCaCertificate": "A String", # Optional. SSL certificate to use for requests to a private service.
        "tokenUri": "A String", # Required. Immutable. The OAuth2 token request URL.
      },
      "etag": "A String", # 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.
      "labels": { # Optional. Labels as key value pairs
        "a_key": "A String",
      },
      "name": "A String", # Identifier. The resource name of the accountConnector, in the format `projects/{project}/locations/{location}/accountConnectors/{account_connector_id}`.
      "oauthStartUri": "A String", # Output only. Start OAuth flow by clicking on this URL.
      "providerOauthConfig": { # ProviderOAuthConfig is the OAuth config for a provider. # Optional. Provider OAuth config.
        "scopes": [ # 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.
          "A String",
        ],
        "systemProviderId": "A String", # Optional. Immutable. Developer Connect provided OAuth.
      },
      "proxyConfig": { # The proxy configuration. # Optional. Configuration for the http and git proxy features.
        "enabled": True or False, # Optional. Setting this to true allows the git and http proxies to perform actions on behalf of the user configured under the account connector.
      },
      "updateTime": "A String", # Output only. The timestamp when the accountConnector was updated.
    }

`list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)`

    Lists AccountConnectors in a given project and location.

    Args:
      parent: string, Required. Parent value for ListAccountConnectorsRequest (required)
      filter: string, Optional. Filtering results
      orderBy: string, Optional. Hint for how to order the results
      pageSize: integer, Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
      pageToken: string, Optional. A token identifying a page of results the server should return.
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # Message for response to listing AccountConnectors
      "accountConnectors": [ # The list of AccountConnectors
        { # 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.
          "annotations": { # Optional. Allows users to store small amounts of arbitrary data.
            "a_key": "A String",
          },
          "createTime": "A String", # Output only. The timestamp when the accountConnector was created.
          "customOauthConfig": { # Message for a customized OAuth config. # Custom OAuth config.
            "authUri": "A String", # Required. Immutable. The OAuth2 authorization server URL.
            "clientId": "A String", # Required. The client ID of the OAuth application.
            "clientSecret": "A String", # 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.
            "hostUri": "A String", # Required. The host URI of the OAuth application.
            "pkceDisabled": True or False, # Optional. Disable PKCE for this OAuth config. PKCE is enabled by default.
            "scmProvider": "A String", # Required. The type of the SCM provider.
            "scopes": [ # Required. The scopes to be requested during OAuth.
              "A String",
            ],
            "serverVersion": "A String", # Output only. SCM server version installed at the host URI.
            "serviceDirectoryConfig": { # ServiceDirectoryConfig represents Service Directory configuration for a connection. # Optional. Configuration for using Service Directory to connect to a private service.
              "service": "A String", # Required. The Service Directory service name. Format: projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}.
            },
            "sslCaCertificate": "A String", # Optional. SSL certificate to use for requests to a private service.
            "tokenUri": "A String", # Required. Immutable. The OAuth2 token request URL.
          },
          "etag": "A String", # 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.
          "labels": { # Optional. Labels as key value pairs
            "a_key": "A String",
          },
          "name": "A String", # Identifier. The resource name of the accountConnector, in the format `projects/{project}/locations/{location}/accountConnectors/{account_connector_id}`.
          "oauthStartUri": "A String", # Output only. Start OAuth flow by clicking on this URL.
          "providerOauthConfig": { # ProviderOAuthConfig is the OAuth config for a provider. # Optional. Provider OAuth config.
            "scopes": [ # 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.
              "A String",
            ],
            "systemProviderId": "A String", # Optional. Immutable. Developer Connect provided OAuth.
          },
          "proxyConfig": { # The proxy configuration. # Optional. Configuration for the http and git proxy features.
            "enabled": True or False, # Optional. Setting this to true allows the git and http proxies to perform actions on behalf of the user configured under the account connector.
          },
          "updateTime": "A String", # Output only. The timestamp when the accountConnector was updated.
        },
      ],
      "nextPageToken": "A String", # A token identifying a page of results the server should return.
      "unreachable": [ # Locations that could not be reached.
        "A String",
      ],
    }

`list_next()`

    Retrieves the next page of results.

            Args:
              previous_request: The request for the previous page. (required)
              previous_response: The response from the request for the previous page. (required)

            Returns:
              A request object that you can call 'execute()' on to request the next
              page. Returns None if there are no more items in the collection.

`patch(name, allowMissing=None, body=None, requestId=None, updateMask=None, validateOnly=None, x__xgafv=None)`

    Updates the parameters of a single AccountConnector.

    Args:
      name: string, Identifier. The resource name of the accountConnector, in the format `projects/{project}/locations/{location}/accountConnectors/{account_connector_id}`. (required)
      body: object, The request body.
        The object takes the form of:

    { # 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.
      "annotations": { # Optional. Allows users to store small amounts of arbitrary data.
        "a_key": "A String",
      },
      "createTime": "A String", # Output only. The timestamp when the accountConnector was created.
      "customOauthConfig": { # Message for a customized OAuth config. # Custom OAuth config.
        "authUri": "A String", # Required. Immutable. The OAuth2 authorization server URL.
        "clientId": "A String", # Required. The client ID of the OAuth application.
        "clientSecret": "A String", # 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.
        "hostUri": "A String", # Required. The host URI of the OAuth application.
        "pkceDisabled": True or False, # Optional. Disable PKCE for this OAuth config. PKCE is enabled by default.
        "scmProvider": "A String", # Required. The type of the SCM provider.
        "scopes": [ # Required. The scopes to be requested during OAuth.
          "A String",
        ],
        "serverVersion": "A String", # Output only. SCM server version installed at the host URI.
        "serviceDirectoryConfig": { # ServiceDirectoryConfig represents Service Directory configuration for a connection. # Optional. Configuration for using Service Directory to connect to a private service.
          "service": "A String", # Required. The Service Directory service name. Format: projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}.
        },
        "sslCaCertificate": "A String", # Optional. SSL certificate to use for requests to a private service.
        "tokenUri": "A String", # Required. Immutable. The OAuth2 token request URL.
      },
      "etag": "A String", # 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.
      "labels": { # Optional. Labels as key value pairs
        "a_key": "A String",
      },
      "name": "A String", # Identifier. The resource name of the accountConnector, in the format `projects/{project}/locations/{location}/accountConnectors/{account_connector_id}`.
      "oauthStartUri": "A String", # Output only. Start OAuth flow by clicking on this URL.
      "providerOauthConfig": { # ProviderOAuthConfig is the OAuth config for a provider. # Optional. Provider OAuth config.
        "scopes": [ # 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.
          "A String",
        ],
        "systemProviderId": "A String", # Optional. Immutable. Developer Connect provided OAuth.
      },
      "proxyConfig": { # The proxy configuration. # Optional. Configuration for the http and git proxy features.
        "enabled": True or False, # Optional. Setting this to true allows the git and http proxies to perform actions on behalf of the user configured under the account connector.
      },
      "updateTime": "A String", # Output only. The timestamp when the accountConnector was updated.
    }

      allowMissing: boolean, 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
      requestId: string, 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).
      updateMask: string, Optional. The list of fields to be updated.
      validateOnly: boolean, Optional. If set, validate the request, but do not actually post it.
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # This resource represents a long-running operation that is the result of a network API call.
      "done": True or False, # 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": { # 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). # The error result of the operation in case of failure or cancellation.
        "code": 42, # The status code, which should be an enum value of google.rpc.Code.
        "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
          {
            "a_key": "", # Properties of the object. Contains field @type with type URL.
          },
        ],
        "message": "A String", # 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.
      },
      "metadata": { # 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.
        "a_key": "", # Properties of the object. Contains field @type with type URL.
      },
      "name": "A String", # 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}`.
      "response": { # 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`.
        "a_key": "", # Properties of the object. Contains field @type with type URL.
      },
    }