@@ -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