Skip to content
This repository was archived by the owner on Aug 10, 2023. It is now read-only.

Conversation

@dennisbyrne
Copy link
Contributor

Tagging @lesv regarding googleapis/google-oauth-java-client#140 . I have ported my sample app to this repo and addressed your comments.

@dpebot dpebot requested a review from JimTravis April 26, 2017 22:05
* you will be given a client_id and a client_secret
* Clone the community repo and run the sample app
* make sure you have [maven installed][install_maven]
* $ git clone https://github.com/GoogleCloudPlatform/community.git
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You can use command syntax on these lines by indenting them with 6 spaces (and leaving an empty line after the bullet-list item. also please remove the $ indicators, they make copy/paste more difficult.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

done

@@ -0,0 +1,17 @@
This sample app uses Google's OAuth 2.0 java lib to authenticate with 23andMe. Once authenticated the app pulls a single genotype for i3003137, a SNP associated with Sickle Cell Anemia.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The tutorial needs header section. Take a look at the other tutorials.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

done

This sample app uses Google's OAuth 2.0 java lib to authenticate with 23andMe. Once authenticated the app pulls a single genotype for i3003137, a SNP associated with Sickle Cell Anemia.

### Instructions
* Create a 23andMe client at https://api.23andme.com/apply/
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Might be write this down as normal text instead of bullet-list items. It just makes markdown harder to write and users follow the tutorials linearly anyway. You can have it like:

### Step 1: do this

Explain

    command

### Step 2: do this

Explain

    command

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

done

### Instructions
* Create a 23andMe client at https://api.23andme.com/apply/
* set your redirect_uri of http://127.0.0.1:8080/Callback
* you will be given a client_id and a client_secret
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

consider using backticks sytax to render them as client_id and client_secret

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

done

@@ -1,3 +1,11 @@
---
title: 23andMe API & google oauth2 in java
description: round trip working example w/ sickle cell anemia
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Capitalize the description and provide a better text (e.g. w/ is not appropriate). These show up in https://cloud.google.com/community/tutorials/, you can take a look at other tutorials for examples.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

done

@@ -1,3 +1,11 @@
---
title: 23andMe API & google oauth2 in java
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some words here need to be capitalized as this is an actual page title. I suggest roughly something like:

Authenticating to 23andMe API with Google OAuth client

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

done

@ahmetb
Copy link
Contributor

ahmetb commented Apr 26, 2017

@jmdobry @lesv It looks like the Java OAuth Client is not directly related to the Cloud but a broader set of Google APIs. Would this tutorial be a good fit for GoogleCloud community page?

Is there a community samples area for developers.google.com projects? The https://developers.google.com/api-client-library/java/google-oauth-java-client/samples page for this project features DailyMotion. This request is fairly similar (a third party API sample). I'm not sure if this content should be here.

@dennisbyrne
Copy link
Contributor Author

@googlebot
Copy link

We found a Contributor License Agreement for you (the sender of this pull request), but were unable to find agreements for the commit author(s). If you authored these, maybe you used a different email address in the git commits than was used to sign the CLA (login here to double check)? If these were authored by someone else, then they will need to sign a CLA as well, and confirm that they're okay with these being contributed to Google.

@lesv
Copy link

lesv commented Apr 26, 2017

@dennisbyrne I think so, it has better SEO than anywhere else you might place it, and we are the ones who maintain that repo.

@lesv
Copy link

lesv commented Apr 26, 2017

@ahmetb Ah - I think it's better here than anywhere else.

@dennisbyrne
Copy link
Contributor Author

Wow ... what are the chances that they would get the same PR ID?

#140
googleapis/google-oauth-java-client#140

@JimTravis
Copy link
Contributor

Dennis, any idea why the CLA bot is complaining about your signing of the CLA?

@dennisbyrne
Copy link
Contributor Author

@JimTravis I have no idea. It may have something to do w/ the fact that these commits were done with [email protected] (I am at work right now) but my primary email address for my github account is [email protected] . I will sign a second CLA as [email protected].

@dennisbyrne
Copy link
Contributor Author

Looks like I can only sign CLAs as google email addresses. Makes sense. I still don't know why the check failed.

@googlebot
Copy link

CLAs look good, thanks!

@dennisbyrne
Copy link
Contributor Author

@JimTravis I figured out why the CLA check failed. The original commit was from [email protected], my primary email for my github account. All subsequent commits were by [email protected]. I have squashed my commits. The check should pass.

@JimTravis JimTravis merged commit c5a3d8e into GoogleCloudPlatform:master Apr 27, 2017
@dennisbyrne
Copy link
Contributor Author

Thanks @JimTravis ... about how long until this shows up at https://cloud.google.com/community/tutorials/

no rush

@jmdobry
Copy link
Member

jmdobry commented Apr 27, 2017

It's been published.

@dennisbyrne
Copy link
Contributor Author

dennisbyrne commented Apr 27, 2017

Great, I'll link to it from https://api.23andme.com/docs . Thanks everyone.

@JimTravis
Copy link
Contributor

JimTravis commented Apr 27, 2017 via email

johnlabarge pushed a commit to johnlabarge/community that referenced this pull request Nov 30, 2018
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants