Package: google.golang.org/api/transport/http

Package-Level Functions (total 12, in which 2 are exported)

func NewClient(ctx context.Context, opts ...option.ClientOption) (*http.Client, string, error) NewClient returns an HTTP client for use communicating with a Google cloud service, configured with the given ClientOptions. It also returns the endpoint for the service as specified in the options.

func NewTransport(ctx context.Context, base http.RoundTripper, opts ...option.ClientOption) (http.RoundTripper, error) NewTransport creates an http.RoundTripper for use communicating with a Google cloud service, configured with the given ClientOptions. Its RoundTrip method delegates to base.

/* 10 unexporteds ... *//* 10 unexporteds: */

func addOCTransport(trans http.RoundTripper, settings *internal.DialSettings) http.RoundTripper

func clonedTransport(rt http.RoundTripper) *http.Transport clonedTransport returns the given RoundTripper as a cloned *http.Transport. It returns nil if the RoundTripper can't be cloned or coerced to *http.Transport.

func defaultBaseTransport(ctx context.Context, clientCertSource cert.Source) http.RoundTripper defaultBaseTransport returns the base HTTP transport. On App Engine, this is urlfetch.Transport. Otherwise, use a default transport, taking most defaults from http.DefaultTransport. If TLSCertificate is available, set TLSClientConfig as well.

func fallbackBaseTransport() *http.Transport fallbackBaseTransport is used in <go1.13 as well as in the rare case if http.DefaultTransport has been reassigned something that's not a *http.Transport.

func getClientCertificateSource(settings *internal.DialSettings) (cert.Source, error) getClientCertificateSource returns a default client certificate source, if not provided by the user. A nil default source can be returned if the source does not exist. Any exceptions encountered while initializing the default source will be reported as client error (ex. corrupt metadata file). The overall logic is as follows: 1. If both endpoint override and client certificate are specified, use them as is. 2. If user does not specify client certificate, we will attempt to use default client certificate. 3. If user does not specify endpoint override, we will use defaultMtlsEndpoint if client certificate is available and defaultEndpoint otherwise. Implications of the above logic: 1. If the user specifies a non-mTLS endpoint override but client certificate is available, we will pass along the cert anyway and let the server decide what to do. 2. If the user specifies an mTLS endpoint override but client certificate is not available, we will not fail-fast, but let backend throw error when connecting. We would like to avoid introducing client-side logic that parses whether the endpoint override is an mTLS url, since the url pattern may change at anytime.

func getEndpoint(settings *internal.DialSettings, clientCertSource cert.Source) (string, error) getEndpoint returns the endpoint for the service, taking into account the user-provided endpoint override "settings.Endpoint" If no endpoint override is specified, we will either return the default endpoint or the default mTLS endpoint if a client certificate is available. You can override the default endpoint (mtls vs. regular) by setting the GOOGLE_API_USE_MTLS environment variable. If the endpoint override is an address (host:port) rather than full base URL (ex. https://...), then the user-provided address will be merged into the default endpoint. For example, WithEndpoint("myhost:8000") and WithDefaultEndpoint("https://foo.com/bar/baz") will return "https://myhost:8080/bar/baz"

func getMTLSMode() string

func mergeEndpoints(base, newHost string) (string, error)

func newSettings(opts []option.ClientOption) (*internal.DialSettings, error)

func newTransport(ctx context.Context, base http.RoundTripper, settings *internal.DialSettings) (http.RoundTripper, error)