google-cloud-channel 1.0.0 → 1.0.4

Sign up to get free protection for your applications and to get access to all the features.
Files changed (6) hide show
  1. checksums.yaml +4 -4
  2. data/.yardopts +1 -1
  3. data/AUTHENTICATION.md +15 -33
  4. data/lib/google/cloud/channel/version.rb +1 -1
  5. data/lib/google/cloud/channel.rb +14 -16
  6. metadata +13 -7
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 10d5de2351ea720cb2669cb3e1b2a065162b8a25f029da38856d332bcb487270
4
- data.tar.gz: fd98496f6f626d921099fd02798c356b5f9a0a7174a8373ff8d1dd639a4c92c4
3
+ metadata.gz: ddca3593b4f2363aa83066f543c4a3334e5fd210c90bba40619446cd091d20f5
4
+ data.tar.gz: 4f2e1d8fb96f4adea59c74dadaf43c4660667f42d6b19f9942c6ee73fcd9056d
5
5
  SHA512:
6
- metadata.gz: f078c85144cafcc1a8951719c42ea6a0c5f4044f30b538d517acd81aeb9f913aeec1c785807504fc2d33d2a9f9da35966c7105a7465252a5d9a925fe080e271d
7
- data.tar.gz: 06d3dd030c75089ff8e08e29a041c9b6dd4a4390c327649d245a892764cc451dea6bb822e3a23955029971c4d7e739a086c0eab23e80d86de13495985034227f
6
+ metadata.gz: ef0ea42fb7e769ccfcc294394d3f7c1037420fa258bf74124ea168dd3e499792d4b49918813ab7b87425873295fe1805041b6eec391ba7ca2ed3f9e9abaadd40
7
+ data.tar.gz: 89392c9f81895c75a306548e0061ebd382a0f317807c48ad5eac2b163bb5df18761a6c53b8c99ee3a7155889973f58f3c57b0d39cf493ffaeda66e3ae77670c6
data/.yardopts CHANGED
@@ -1,5 +1,5 @@
1
1
  --no-private
2
- --title=Cloud Channel API
2
+ --title="Cloud Channel API"
3
3
  --exclude _pb\.rb$
4
4
  --markup markdown
5
5
  --markup-provider redcarpet
data/AUTHENTICATION.md CHANGED
@@ -66,11 +66,11 @@ The environment variables that google-cloud-channel
66
66
  checks for credentials are configured on the service Credentials class (such as
67
67
  `::Google::Cloud::Channel::V1::CloudChannelService::Credentials`):
68
68
 
69
- 1. `CHANNEL_CREDENTIALS` - Path to JSON file, or JSON contents
70
- 2. `CHANNEL_KEYFILE` - Path to JSON file, or JSON contents
71
- 3. `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
72
- 4. `GOOGLE_CLOUD_KEYFILE` - Path to JSON file, or JSON contents
73
- 5. `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
69
+ * `CHANNEL_CREDENTIALS` - Path to JSON file, or JSON contents
70
+ * `CHANNEL_KEYFILE` - Path to JSON file, or JSON contents
71
+ * `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
72
+ * `GOOGLE_CLOUD_KEYFILE` - Path to JSON file, or JSON contents
73
+ * `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
74
74
 
75
75
  ```ruby
76
76
  require "google/cloud/channel"
@@ -82,8 +82,8 @@ client = Google::Cloud::Channel.cloud_channel_service
82
82
 
83
83
  ### Configuration
84
84
 
85
- The **Credentials JSON** can be configured instead of placing them in
86
- environment variables. Either on an individual client initialization:
85
+ The path to the **Credentials JSON** file can be configured instead of storing
86
+ it in an environment variable. Either on an individual client initialization:
87
87
 
88
88
  ```ruby
89
89
  require "google/cloud/channel"
@@ -93,7 +93,7 @@ client = Google::Cloud::Channel.cloud_channel_service do |config|
93
93
  end
94
94
  ```
95
95
 
96
- Or configured globally for all clients:
96
+ Or globally for all clients:
97
97
 
98
98
  ```ruby
99
99
  require "google/cloud/channel"
@@ -120,15 +120,6 @@ To configure your system for this, simply:
120
120
  **NOTE:** This is _not_ recommended for running in production. The Cloud SDK
121
121
  *should* only be used during development.
122
122
 
123
- [gce-how-to]: https://cloud.google.com/compute/docs/authentication#using
124
- [dev-console]: https://console.cloud.google.com/project
125
-
126
- [enable-apis]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/enable-apis.png
127
-
128
- [create-new-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account.png
129
- [create-new-service-account-existing-keys]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account-existing-keys.png
130
- [reuse-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/reuse-service-account.png
131
-
132
123
  ## Creating a Service Account
133
124
 
134
125
  Google Cloud requires **Service Account Credentials** to
@@ -139,31 +130,22 @@ If you are not running this client within
139
130
  [Google Cloud Platform environments](#google-cloud-platform-environments), you
140
131
  need a Google Developers service account.
141
132
 
142
- 1. Visit the [Google Developers Console][dev-console].
133
+ 1. Visit the [Google Cloud Console](https://console.cloud.google.com/project).
143
134
  2. Create a new project or click on an existing project.
144
- 3. Activate the slide-out navigation tray and select **API Manager**. From
135
+ 3. Activate the menu in the upper left and select **APIs & Services**. From
145
136
  here, you will enable the APIs that your application requires.
146
137
 
147
- ![Enable the APIs that your application requires][enable-apis]
148
-
149
138
  *Note: You may need to enable billing in order to use these services.*
150
139
 
151
140
  4. Select **Credentials** from the side navigation.
152
141
 
153
- You should see a screen like one of the following.
154
-
155
- ![Create a new service account][create-new-service-account]
156
-
157
- ![Create a new service account With Existing Keys][create-new-service-account-existing-keys]
158
-
159
- Find the "Add credentials" drop down and select "Service account" to be
160
- guided through downloading a new JSON key file.
142
+ Find the "Create credentials" drop down near the top of the page, and select
143
+ "Service account" to be guided through downloading a new JSON key file.
161
144
 
162
145
  If you want to re-use an existing service account, you can easily generate a
163
- new key file. Just select the account you wish to re-use, and click "Generate
164
- new JSON key":
165
-
166
- ![Re-use an existing service account][reuse-service-account]
146
+ new key file. Just select the account you wish to re-use, click the pencil
147
+ tool on the right side to edit the service account, select the **Keys** tab,
148
+ and then select **Add Key**.
167
149
 
168
150
  The key file you download will be used by this library to authenticate API
169
151
  requests and should be stored in a secure location.
data/lib/google/cloud/channel/version.rb CHANGED
@@ -20,7 +20,7 @@
20
20
  module Google
21
21
  module Cloud
22
22
  module Channel
23
- VERSION = "1.0.0"
23
+ VERSION = "1.0.4"
24
24
  end
25
25
  end
26
26
  end
data/lib/google/cloud/channel.rb CHANGED
@@ -57,27 +57,25 @@ module Google
57
57
  #
58
58
  # ## About CloudChannelService
59
59
  #
60
- # CloudChannelService enables Google cloud resellers and distributors to manage
61
- # their customers, channel partners, entitlements and reports.
60
+ # CloudChannelService lets Google cloud resellers and distributors manage
61
+ # their customers, channel partners, entitlements, and reports.
62
62
  #
63
63
  # Using this service:
64
- # 1. Resellers or distributors can manage a customer entity.
65
- # 2. Distributors can register an authorized reseller in their channel and then
66
- # enable delegated admin access for the reseller.
67
- # 3. Resellers or distributors can manage entitlements for their customers.
64
+ # 1. Resellers and distributors can manage a customer entity.
65
+ # 2. Distributors can register an authorized reseller in their channel and
66
+ # provide them with delegated admin access.
67
+ # 3. Resellers and distributors can manage customer entitlements.
68
68
  #
69
- # The service primarily exposes the following resources:
70
- # - Customers: A Customer represents an entity managed by a reseller or
71
- # distributor. A customer typically represents an enterprise. In an n-tier
72
- # resale channel hierarchy, customers are generally represented as leaf nodes.
73
- # Customers primarily have an Entitlement sub-resource discussed below.
69
+ # CloudChannelService exposes the following resources:
70
+ # - Customers: An entity—usually an enterprise—managed by a reseller or
71
+ # distributor.
74
72
  #
75
- # - Entitlements: An Entitlement represents an entity which provides a
76
- # customer means to start using a service. Entitlements are created or updated
77
- # as a result of a successful fulfillment.
73
+ # - Entitlements: An entity that provides a customer with the means to use
74
+ # a service. Entitlements are created or updated as a result of a successful
75
+ # fulfillment.
78
76
  #
79
- # - ChannelPartnerLinks: A ChannelPartnerLink is an entity that identifies
80
- # links between distributors and their indirect resellers in a channel.
77
+ # - ChannelPartnerLinks: An entity that identifies links between
78
+ # distributors and their indirect resellers in a channel.
81
79
  #
82
80
  # @param version [::String, ::Symbol] The API version to connect to. Optional.
83
81
  # Defaults to `:v1`.
metadata CHANGED
@@ -1,43 +1,49 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-channel
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.0.0
4
+ version: 1.0.4
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2021-03-31 00:00:00.000000000 Z
11
+ date: 2022-01-11 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-cloud-channel-v1
15
15
  requirement: !ruby/object:Gem::Requirement
16
16
  requirements:
17
- - - "~>"
17
+ - - ">="
18
18
  - !ruby/object:Gem::Version
19
19
  version: '0.5'
20
+ - - "<"
21
+ - !ruby/object:Gem::Version
22
+ version: 2.a
20
23
  type: :runtime
21
24
  prerelease: false
22
25
  version_requirements: !ruby/object:Gem::Requirement
23
26
  requirements:
24
- - - "~>"
27
+ - - ">="
25
28
  - !ruby/object:Gem::Version
26
29
  version: '0.5'
30
+ - - "<"
31
+ - !ruby/object:Gem::Version
32
+ version: 2.a
27
33
  - !ruby/object:Gem::Dependency
28
34
  name: google-cloud-core
29
35
  requirement: !ruby/object:Gem::Requirement
30
36
  requirements:
31
37
  - - "~>"
32
38
  - !ruby/object:Gem::Version
33
- version: '1.5'
39
+ version: '1.6'
34
40
  type: :runtime
35
41
  prerelease: false
36
42
  version_requirements: !ruby/object:Gem::Requirement
37
43
  requirements:
38
44
  - - "~>"
39
45
  - !ruby/object:Gem::Version
40
- version: '1.5'
46
+ version: '1.6'
41
47
  - !ruby/object:Gem::Dependency
42
48
  name: google-style
43
49
  requirement: !ruby/object:Gem::Requirement
@@ -184,7 +190,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
184
190
  - !ruby/object:Gem::Version
185
191
  version: '0'
186
192
  requirements: []
187
- rubygems_version: 3.2.13
193
+ rubygems_version: 3.3.4
188
194
  signing_key:
189
195
  specification_version: 4
190
196
  summary: API Client library for the Cloud Channel API