Issue 351: Reimplement OAuth2 (Step 3 - Tests, Flows and Credential)

Src/GoogleApis.Auth/OAuth2/TokenRequestExtenstions.cs

 /*
 Copyright 2013 Google Inc
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
 You may obtain a copy of the License at
 
 http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing, software
@@ skipping 18 matching lines @@
 /// <summary>
 /// Extension methods to <seealso cref="Google.Apis.Auth.OAuth2.Requests.Toe
knRequest"/>.
 /// </summary>
 internal static class TokenRequestExtenstions
 {
 /// <summary>
 /// Executes the token request in order to receive a·
 /// <seealso cref="Google.Apis.Auth.OAuth2.Responses.TokenResponse"/>. I
n case the token server returns an·
 /// error, a <seealso cref="Google.Apis.Auth.OAuth2.Responses.TokenRespo
nseException"/> is thrown.
 /// </summary>
- /// <param name="request">The token request</param>
- /// <param name="httpClient">The HTTP client used to create an HTTP requ
 est</param>
- /// <param name="tokenServerUrl">The token server URL</param>
- /// <param name="taskCancellationToken">Cancellation token to cancel ope
 ration</param>
- /// <param name="clock">The clock which is used to set the <seealso cref
 ="Clock.Issued"/> property</param>
- /// <returns>Token response with the new access token</returns>
+ /// <param name="request">The token request.</param>
+ /// <param name="httpClient">The HTTP client used to create an HTTP requ
 est.</param>
+ /// <param name="tokenServerUrl">The token server URL.</param>
+ /// <param name="taskCancellationToken">Cancellation token to cancel ope
 ration.</param>
+ /// <param name="clock">The clock which is used to set the <seealso cref
 ="Clock.Issued"/> property.</param>
+ /// <returns>Token response with the new access token.</returns>
 public static async Task<TokenResponse> Execute(this TokenRequest reques
t, HttpClient httpClient,
 string tokenServerUrl, CancellationToken taskCancellationToken, IClo
ck clock)
 {
 var httpRequest = new HttpRequestMessage(HttpMethod.Post, tokenServe
rUrl);
 httpRequest.Content = ParameterUtils.CreateFormUrlEncodedContent(req
uest);
 
 var response = await httpClient.SendAsync(httpRequest, taskCancellat
ionToken).ConfigureAwait(false);
 var content = await response.Content.ReadAsStringAsync().ConfigureAw
ait(false);
 
 if (!response.IsSuccessStatusCode)
 {
 var error = NewtonsoftJsonSerializer.Instance.Deserialize<TokenE
rrorResponse>(content);
 throw new TokenResponseException(error);
 }
 
 // Gets the token and sets its issued time.
 var newToken = NewtonsoftJsonSerializer.Instance.Deserialize<TokenRe
sponse>(content);
 newToken.Issued = clock.Now;
 return newToken;
 }
 }
 }