Visitar URL original
Merge pull request #1106 from dhermes/add-troubleshooting-to-auth · googleapis/google-cloud-python@531bdc6 · GitHub
Skip to content

Commit 531bdc6

Browse files
committed
Merge pull request #1106 from dhermes/add-troubleshooting-to-auth
Adding troubleshooting to auth doc.
2 parents 0dfe5eb + f599dc4 commit 531bdc6

1 file changed

Lines changed: 72 additions & 0 deletions

File tree

‎docs/gcloud-auth.rst‎

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -180,3 +180,75 @@ and stored in a file and then and deserialized with
180180

181181
.. _client secrets: https://developers.google.com/api-client-library/python/guide/aaa_oauth#flow_from_clientsecrets
182182
.. _webserver flow: https://developers.google.com/api-client-library/python/guide/aaa_oauth#OAuth2WebServerFlow
183+
184+
Troubleshooting
185+
===============
186+
187+
Setting up a Service Account
188+
----------------------------
189+
190+
If your application is not running on Google Compute Engine,
191+
you need a `Google Developers Service Account`_.
192+
193+
#. Visit the `Google Developers Console`_.
194+
195+
#. Create a new project or click on an existing project.
196+
197+
#. Navigate to **APIs & auth** > **APIs** and enable the APIs
198+
that your application requires.
199+
200+
.. raw:: html
201+
202+
<img src="https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authorization/enable-apis.png"/>
203+
204+
.. note::
205+
206+
You may need to enable billing in order to use these services.
207+
208+
* **BigQuery**
209+
210+
* BigQuery API
211+
212+
* **Datastore**
213+
214+
* Google Cloud Datastore API
215+
216+
* **Pub/Sub**
217+
218+
* Google Cloud Pub/Sub
219+
220+
* **Search**
221+
222+
* Google Cloud Search API
223+
224+
* **Storage**
225+
226+
* Google Cloud Storage
227+
* Google Cloud Storage JSON API
228+
229+
#. Navigate to **APIs & auth** > **Credentials**.
230+
231+
You should see a screen like one of the following:
232+
233+
.. raw:: html
234+
235+
<img src="https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authorization/create-new-service-account.png">
236+
237+
.. raw:: html
238+
239+
<img src="https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authorization/create-new-service-account-existing-keys.png">
240+
241+
Find the "Add credentials" drop down and select "Service account" to be
242+
guided through downloading a new JSON keyfile.
243+
244+
If you want to re-use an existing service account,
245+
you can easily generate a new keyfile.
246+
Just select the account you wish to re-use,
247+
and click **Generate new JSON key**:
248+
249+
.. raw:: html
250+
251+
<img src="https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authorization/reuse-service-account.png">
252+
253+
.. _Google Developers Console: https://console.developers.google.com/project
254+
.. _Google Developers Service Account: https://developers.google.com/accounts/docs/OAuth2ServiceAccount

0 commit comments

Comments
 (0)