googleapi/transport: deprecate transport

Fixes #340

Change-Id: I8292d04f727a224833422be7681d5b5407c914c6
Reviewed-on: https://code-review.googlesource.com/c/google-api-go-client/+/49070
Reviewed-by: kokoro <noreply+kokoro@google.com>
Reviewed-by: Cody Oss <codyoss@google.com>
diff --git a/googleapi/transport/apikey.go b/googleapi/transport/apikey.go
index 4b6c0d5..61720ec 100644
--- a/googleapi/transport/apikey.go
+++ b/googleapi/transport/apikey.go
@@ -4,6 +4,10 @@
 
 // Package transport contains HTTP transports used to make
 // authenticated API requests.
+//
+// This package is DEPRECATED. Users should instead use,
+//
+//     service, err := NewService(..., option.WithAPIKey(...))
 package transport
 
 import (
@@ -13,6 +17,8 @@
 
 // APIKey is an HTTP Transport which wraps an underlying transport and
 // appends an API Key "key" parameter to the URL of outgoing requests.
+//
+// Deprecated: please use NewService(..., option.WithAPIKey(...)) instead.
 type APIKey struct {
 	// Key is the API Key to set on requests.
 	Key string