/core/externals/update-engine/externals/gdata-objectivec-client/Source/Clients/Calendar/GDataServiceGoogleCalendar.h

 1/* Copyright (c) 2007 Google Inc.
 2 *
 3 * Licensed under the Apache License, Version 2.0 (the "License");
 4 * you may not use this file except in compliance with the License.
 5 * You may obtain a copy of the License at
 6 *
 7 *     http://www.apache.org/licenses/LICENSE-2.0
 8 *
 9 * Unless required by applicable law or agreed to in writing, software
10 * distributed under the License is distributed on an "AS IS" BASIS,
11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 * See the License for the specific language governing permissions and
13 * limitations under the License.
14 */
15
16//
17//  GDataServiceGoogleCalendar.h
18//
19
20#if !GDATA_REQUIRE_SERVICE_INCLUDES || GDATA_INCLUDE_CALENDAR_SERVICE
21
22#import "GDataServiceGoogle.h"
23
24#undef _EXTERN
25#undef _INITIALIZE_AS
26#ifdef GDATASERVICEGOOGLECALENDAR_DEFINE_GLOBALS
27#define _EXTERN 
28#define _INITIALIZE_AS(x) =x
29#else
30#define _EXTERN GDATA_EXTERN
31#define _INITIALIZE_AS(x)
32#endif
33
34// default feed of calendars
35_EXTERN NSString* const kGDataGoogleCalendarDefaultFeed _INITIALIZE_AS(@"https://www.google.com/calendar/feeds/default");
36
37// owned calendars; supports inserting and deleting calendars
38_EXTERN NSString* const kGDataGoogleCalendarDefaultOwnCalendarsFeed _INITIALIZE_AS(@"https://www.google.com/calendar/feeds/default/owncalendars/full");
39
40// subscribed calendars; insert adds a subscription, delete removes a subscription
41_EXTERN NSString* const kGDataGoogleCalendarDefaultAllCalendarsFeed _INITIALIZE_AS(@"https://www.google.com/calendar/feeds/default/allcalendars/full");
42
43// calendar events feed
44_EXTERN NSString* const kGDataGoogleCalendarDefaultPrivateFullFeed _INITIALIZE_AS(@"https://www.google.com/calendar/feeds/default/private/full");
45
46
47// QuickAdd:  
48//
49// Google Calendar can parse natural language text to create a
50// Calendar entry.  Create the entry by setting the content, 
51// then insert it into the calendar:
52//
53//  GDataEntryCalendarEvent *newEvent = [GDataEntryCalendarEvent calendarEvent];
54//  [newEvent setContentWithString:@"Party today at 4pm"];
55//  [newEvent setIsQuickAdd:YES];
56//
57// then pass the event to fetchEntryByInsertingEntry:
58//
59
60
61@interface GDataServiceGoogleCalendar : GDataServiceGoogle
62
63+ (NSURL *)calendarFeedURLForUsername:(NSString *)username;
64
65+ (NSURL *)settingsFeedURLForUsername:(NSString *)username;
66
67+ (NSURL *)freeBusyURLForUsername:(NSString *)username;
68
69+ (NSURL *)freeBusyURLForGroup:(NSString *)groupname;
70
71- (GDataServiceTicket *)fetchCalendarFeedForUsername:(NSString *)username
72                                            delegate:(id)delegate
73                                   didFinishSelector:(SEL)finishedSelector;
74
75// clients may use these fetch methods of GDataServiceGoogle
76//
77//  - (GDataServiceTicket *)fetchFeedWithURL:(NSURL *)feedURL delegate:(id)delegate didFinishSelector:(SEL)finishedSelector;
78//  - (GDataServiceTicket *)fetchFeedWithQuery:(GDataQuery *)query delegate:(id)delegate didFinishSelector:(SEL)finishedSelector;
79//  - (GDataServiceTicket *)fetchEntryWithURL:(NSURL *)entryURL delegate:(id)delegate didFinishSelector:(SEL)finishedSelector;
80//  - (GDataServiceTicket *)fetchEntryByInsertingEntry:(GDataEntryBase *)entryToInsert forFeedURL:(NSURL *)feedURL delegate:(id)delegate didFinishSelector:(SEL)finishedSelector;
81//  - (GDataServiceTicket *)fetchEntryByUpdatingEntry:(GDataEntryBase *)entryToUpdate delegate:(id)delegate didFinishSelector:(SEL)finishedSelector;
82//  - (GDataServiceTicket *)deleteEntry:(GDataEntryBase *)entryToDelete delegate:(id)delegate didFinishSelector:(SEL)finishedSelector;
83//  - (GDataServiceTicket *)deleteResourceURL:(NSURL *)resourceEditURL ETag:(NSString *)etag delegate:(id)delegate didFinishSelector:(SEL)finishedSelector;
84//  - (GDataServiceTicket *)fetchFeedWithBatchFeed:(GDataFeedBase *)batchFeed forBatchFeedURL:(NSURL *)feedURL delegate:(id)delegate didFinishSelector:(SEL)finishedSelector;
85//
86// finishedSelector has a signature like this for feed fetches:
87// - (void)serviceTicket:(GDataServiceTicket *)ticket finishedWithFeed:(GDataFeedBase *)feed error:(NSError *)error;
88//
89// or this for entry fetches:
90// - (void)serviceTicket:(GDataServiceTicket *)ticket finishedWithEntry:(GDataEntryBase *)entry error:(NSError *)error;
91//
92// The class of the returned feed or entry is determined by the URL fetched.
93
94
95+ (NSString *)serviceRootURLString;
96
97@end
98
99#endif // !GDATA_REQUIRE_SERVICE_INCLUDES || GDATA_INCLUDE_CALENDAR_SERVICE