1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
|
//-----------------------------------------------------------------------
// <copyright file="GoogleConsumer.cs" company="Andrew Arnott">
// Copyright (c) Andrew Arnott. All rights reserved.
// </copyright>
//-----------------------------------------------------------------------
namespace DotNetOpenAuth.ApplicationBlock {
using System;
using System.Collections.Generic;
using System.Linq;
using System.Xml.Linq;
using DotNetOpenAuth.Messaging;
using DotNetOpenAuth.OAuth;
using DotNetOpenAuth.OAuth.ChannelElements;
/// <summary>
/// A consumer capable of communicating with Google Data APIs.
/// </summary>
public static class GoogleConsumer {
/// <summary>
/// The Consumer to use for accessing Google data APIs.
/// </summary>
private static readonly ServiceProviderDescription GoogleDescription = new ServiceProviderDescription {
RequestTokenEndpoint = new MessageReceivingEndpoint("https://www.google.com/accounts/OAuthGetRequestToken", HttpDeliveryMethods.AuthorizationHeaderRequest | HttpDeliveryMethods.GetRequest),
UserAuthorizationEndpoint = new MessageReceivingEndpoint("https://www.google.com/accounts/OAuthAuthorizeToken", HttpDeliveryMethods.AuthorizationHeaderRequest | HttpDeliveryMethods.GetRequest),
AccessTokenEndpoint = new MessageReceivingEndpoint("https://www.google.com/accounts/OAuthGetAccessToken", HttpDeliveryMethods.AuthorizationHeaderRequest | HttpDeliveryMethods.GetRequest),
TamperProtectionElements = new ITamperProtectionChannelBindingElement[] { new HmacSha1SigningBindingElement() },
};
/// <summary>
/// A mapping between Google's applications and their URI scope values.
/// </summary>
private static readonly Dictionary<Applications, string> DataScopeUris = new Dictionary<Applications, string> {
{ Applications.Contacts, "http://www.google.com/m8/feeds/" },
{ Applications.Calendar, "http://www.google.com/calendar/feeds/" },
};
/// <summary>
/// The URI to get contacts once authorization is granted.
/// </summary>
private static readonly MessageReceivingEndpoint GetContactsEndpoint = new MessageReceivingEndpoint("http://www.google.com/m8/feeds/contacts/default/full/", HttpDeliveryMethods.GetRequest);
/// <summary>
/// The many specific authorization scopes Google offers.
/// </summary>
[Flags]
public enum Applications : long {
/// <summary>
/// The Gmail address book.
/// </summary>
Contacts = 0x1,
/// <summary>
/// Appointments in Google Calendar.
/// </summary>
Calendar = 0x2,
}
/// <summary>
/// Initializes a new instance of the <see cref="WebConsumer"/> class that is prepared to communicate with Google.
/// </summary>
/// <param name="tokenManager">The token manager.</param>
/// <param name="consumerKey">The consumer key.</param>
/// <returns>The newly instantiated <see cref="WebConsumer"/>.</returns>
public static WebConsumer CreateWebConsumer(ITokenManager tokenManager, string consumerKey) {
return new WebConsumer(GoogleDescription, tokenManager) {
ConsumerKey = consumerKey,
};
}
/// <summary>
/// Initializes a new instance of the <see cref="DesktopConsumer"/> class that is prepared to communicate with Google.
/// </summary>
/// <param name="tokenManager">The token manager.</param>
/// <param name="consumerKey">The consumer key.</param>
/// <returns>The newly instantiated <see cref="DesktopConsumer"/>.</returns>
public static DesktopConsumer CreateDesktopConsumer(ITokenManager tokenManager, string consumerKey) {
return new DesktopConsumer(GoogleDescription, tokenManager) {
ConsumerKey = consumerKey,
};
}
/// <summary>
/// Requests authorization from Google to access data from a set of Google applications.
/// </summary>
/// <param name="consumer">The Google consumer previously constructed using <see cref="CreateWebConsumer"/> or <see cref="CreateDesktopConsumer"/>.</param>
/// <param name="requestedAccessScope">The requested access scope.</param>
public static void RequestAuthorization(WebConsumer consumer, Applications requestedAccessScope) {
if (consumer == null) {
throw new ArgumentNullException("consumer");
}
var extraParameters = new Dictionary<string, string> {
{ "scope", GetScopeUri(requestedAccessScope) },
};
Uri callback = Util.GetCallbackUrlFromContext();
var request = consumer.PrepareRequestUserAuthorization(callback, extraParameters, null);
consumer.Channel.Send(request);
}
/// <summary>
/// Requests authorization from Google to access data from a set of Google applications.
/// </summary>
/// <param name="consumer">The Google consumer previously constructed using <see cref="CreateWebConsumer"/> or <see cref="CreateDesktopConsumer"/>.</param>
/// <param name="requestedAccessScope">The requested access scope.</param>
/// <param name="requestToken">The unauthorized request token assigned by Google.</param>
/// <returns>The request token</returns>
public static Uri RequestAuthorization(DesktopConsumer consumer, Applications requestedAccessScope, out string requestToken) {
if (consumer == null) {
throw new ArgumentNullException("consumer");
}
var extraParameters = new Dictionary<string, string> {
{ "scope", GetScopeUri(requestedAccessScope) },
};
return consumer.RequestUserAuthorization(extraParameters, null, out requestToken);
}
/// <summary>
/// Gets the Gmail address book's contents.
/// </summary>
/// <param name="consumer">The Google consumer previously constructed using <see cref="CreateWebConsumer"/> or <see cref="CreateDesktopConsumer"/>.</param>
/// <param name="accessToken">The access token previously retrieved.</param>
/// <returns>An XML document returned by Google.</returns>
public static XDocument GetContacts(ConsumerBase consumer, string accessToken) {
if (consumer == null) {
throw new ArgumentNullException("consumer");
}
var response = consumer.PrepareAuthorizedRequestAndSend(GetContactsEndpoint, accessToken);
string body = response.GetResponseReader().ReadToEnd();
XDocument result = XDocument.Parse(body);
return result;
}
/// <summary>
/// Gets the scope URI in Google's format.
/// </summary>
/// <param name="scope">The scope, which may include one or several Google applications.</param>
/// <returns>A space-delimited list of URIs for the requested Google applications.</returns>
private static string GetScopeUri(Applications scope) {
return string.Join(" ", Util.GetIndividualFlags(scope).Select(app => DataScopeUris[(Applications)app]).ToArray());
}
}
}
|
