Merge branch 'dev' of https://github.com/CodeBeamOrg/CodeBeam.GoogleApis.Blazor into dev

Author: mckaragoz

README.md

@@ -10,7 +10,7 @@
 This repo is still in earlier stage of development, but all completed parts already tested with real world applications.
 
 ## Documentation
-Prepairing.
+Please look at examples.
 
 
 ## Contributing
@@ -22,22 +22,89 @@ Welcome to all contributors!
 Nothing special with this package.
 ### Step 1: Inject HttpClientFactory
 
+Add Services into program.cs
+```cs
+builder.Services.AddCodeBeamGoogleApiServices();
+```
+
 For blazor component files
 ```razor
-@inject IHttpClientFactory HttpClientFactory
+@inject CalendarService CalendarService
 ```
 For cs files
 ```cs
-[Inject] IHttpClientFactory HttpClientFactory { get; set; }
+[Inject] CalendarService CalendarService { get; set; }
 ```
 
-### Step 2: Create an instance of needed api class and implement
+### Step 2: Implement whatever you want
 ```cs
-private void NewCalendar()
+private void CreateCalendar()
 {
-  CalendarService calendarService = new CalendarService(HttpClientFactory);
-  calendarService.AddCalendar(_accessToken, "Calendar Title"); //Can get access token with AuthService.
+    GoogleCalendarListModel googleCalendarListModel = new GoogleCalendarListModel()
+    {
+        summary = "Test Calendar",
+        description = "Created By CodeBeam",
+        timeZone = "Europe/Istanbul",
+    };
+    CalendarService.AddCalendar(googleCalendarListModel);
 }
 ```
 
 ### Step 3: null. That's all.
+
+# Examples
+## How To Use Auth Service To Get Permission From a Google Account
+#### Step 1. Request Authorization Code
+```cs
+private async Task RequestCode()
+{
+    List<Scope> scopes = new();
+    scopes.Add(Scope.OAuth2Email); //Not required, but useful for get user email in future.
+    scopes.Add(Scope.Calendar);
+    await AuthService.RequestAuthorizationCode(AuthService.GetClientId(), scopes, NavigationManager.BaseUri + "v1/browser-callback"); //"v1/browser-callback" is your page that method returns and opens the page as a new tab
+}
+```
+#### Step 2. Get Access Token With Obtained Authorization Code in Step 1
+These codes should be in the callback page.
+Blazor Component
+```razor
+@page "/v1/browser-callback"
+```
+Code
+```cs
+[Parameter]
+[SupplyParameterFromQuery]
+public string Code { get; set; }
+
+string _accessToken = "";
+protected override async Task OnAfterRenderAsync(bool firstRender)
+{
+    if (firstRender)
+    {
+        var request = AuthService.AuthorizeCredential(Code, AuthService.GetCliendId(), AuthService.GetClientSecret(), NavigationManager.BaseUri + "v1/browser-callback");
+        // This method is built in this package. You also can write your own method to process request result.
+        _accessToken = AuthService.GetValueFromCredential(request, CredentialValueType.AccessToken);
+    }
+}
+```
+
+#### Step 3. You can store this access token (can also obtain refresh token etc. with same way) in your database or make a cookie. You can use this token to call calendar, drive etc. features.
+
+
+## How To Create a Calendar Event
+#### Make an instance of GoogleCalendarEventModel and add it. Notice that for datetimes like event start and end, need to use GetProperDateTimeFormat method.
+```cs
+[Inject] CalendarService CalendarService { get; set; }
+private void AddEvent()
+{
+    GoogleCalendarEventModel googleCalendarEvent = new()
+    {
+        summary = "Test Event",
+        description = "Some Description",
+        start = new Start { dateTime = CalendarService.GetProperDateTimeFormat(DateTime.Now) },
+        end = new End { dateTime = CalendarService.GetProperDateTimeFormat(DateTime.Now) },
+    };
+    // If you don't know the id of calendar which will the event be added, use FindCalendarId method. In this case, the event added the calendar which has "Test Calendar" title.
+    string result = CalendarService.AddEvent(googleCalendarEvent, CalendarService.FindCalendarId(CalendarValueType.Summary, "Test Calendar"));
+}
+```