(Perl) Google Calendar Search Events (List Events with Optional Query Parameters)

See more Google Calendar Examples

Demonstrates how to specify optional query parameters for listing events. This example uses the "q" parameter to free-text search for events, and uses the "timeMin" parameter to specify a lower bound for an event's end time.

Chilkat Perl Downloads Perl Module for Windows, MacOS, Linux, Alpine Linux, Solaris

use chilkat();

# This example requires the Chilkat API to have been previously unlocked.
# See Global Unlock Sample for sample code.

# This example uses a previously obtained access token having permission for the 
# Google Calendar scope.

# In this example, Get Google Calendar OAuth2 Access Token, the access
# token was saved to a JSON file.  This example fetches the access token from the file..
$jsonToken = chilkat::CkJsonObject->new();
$success = $jsonToken->LoadFile("qa_data/tokens/googleCalendar.json");
if ($jsonToken->HasMember("access_token") == 0) {
    print "No access token found." . "\r\n";
    exit;
}

$http = chilkat::CkHttp->new();
$http->put_AuthToken($jsonToken->stringOf("access_token"));

# We'll want to build a URL with the query params..
$sbUrl = chilkat::CkStringBuilder->new();
$sbUrl->Append("https://www.googleapis.com/calendar/v3/calendars/{$calendarId}/events?");

# Use the HTTP request object as a helper for creating the URL encoded query param list..
$req = chilkat::CkHttpRequest->new();

# Find events with the word "pizza".
$req->AddParam("q","pizza");

# Get events for the current date/time or later.
$dt = chilkat::CkDateTime->new();
$dt->SetFromCurrentSystemTime();
$req->AddParam("timeMin",$dt->getAsTimestamp(0));

# Add these query params to the URL:
$sbUrl->Append($req->getUrlEncodedParams());

# Examine the URL..
print "URL: " . $sbUrl->getAsString() . "\r\n";

# The URL looks like this:
# https://www.googleapis.com/calendar/v3/calendars/{$calendarId}/events?q=pizza&timeMin=2017-08-11T13%3A35%3A28Z

# Let's get events in the primary calendar.  A calendar ID could have be used instead of "primary".
$http->SetUrlVar("calendarId","primary");
$sbResponse = chilkat::CkStringBuilder->new();
$success = $http->QuickGetSb($sbUrl->getAsString(),$sbResponse);
if ($success != 1) {
    print $http->lastErrorText() . "\r\n";
    exit;
}

if ($http->get_LastStatus() != 200) {
    # Note: If a 401 unauthorized response is received, it likely means that the OAuth2 access token needs
    # to be refreshed or re-fetched.
    print "Error response status: " . $http->get_LastStatus() . "\r\n";
    print $sbResponse->getAsString() . "\r\n";
    exit;
}

print $sbResponse->getAsString() . "\r\n";

# A sample JSON response:
# (Code for parsing the Google Calendar events is shown below.)

# {
#  "kind": "calendar#events",
#  "etag": "\"p32cafkumkb7ta0g\"",
#  "summary": "support@chilkatcloud.com",
#  "updated": "2017-08-11T13:19:48.143Z",
#  "timeZone": "America/Chicago",
#  "accessRole": "owner",
#  "defaultReminders": [
#   {
#    "method": "popup",
#    "minutes": 10
#   }
#  ],
#  "nextSyncToken": "CJin09aiz9UCEJin09aiz9UCGAU=",
#  "items": [
#   {
#    "kind": "calendar#event",
#    "etag": "\"3004915160212000\"",
#    "id": "02pv1cpdp7vm11htnfi3ii7iie",
#    "status": "confirmed",
#    "htmlLink": "https://www.google.com/calendar/event?eid=MDJwdjFjcGRwN3ZtMTFodG5maTNpaTdpaWUgc3VwcG9ydEBjaGlsa2F0Y2xvdWQuY29t",
#    "created": "2017-08-11T13:19:40.000Z",
#    "updated": "2017-08-11T13:19:40.106Z",
#    "summary": "Eat Lou Malnati's Pizza",
#    "creator": {
#     "email": "support@chilkatcloud.com",
#     "self": true
#    },
#    "organizer": {
#     "email": "support@chilkatcloud.com",
#     "self": true
#    },
#    "start": {
#     "dateTime": "2017-08-12T12:00:00-05:00"
#    },
#    "end": {
#     "dateTime": "2017-08-12T13:00:00-05:00"
#    },
#    "iCalUID": "02pv1cpdp7vm11htnfi3ii7iie@google.com",
#    "sequence": 0,
#    "hangoutLink": "https://plus.google.com/hangouts/_/chilkatcloud.com/support?hceid=c3VwcG9ydEBjaGlsa2F0Y2xvdWQuY29t.02pv1cpdp7vm11htnfi3ii7iie",
#    "reminders": {
#     "useDefault": true
#    }
#   }
#  ]
# }
# 
# 

$json = chilkat::CkJsonObject->new();
$json->LoadSb($sbResponse);

$numEvents = $json->SizeOfArray("items");
$i = 0;
while ($i < $numEvents) {
    $json->put_I($i);
    print $json->stringOf("items[i].summary") . "\r\n";
    print $json->stringOf("items[i].start.dateTime") . "\r\n";
    print $json->stringOf("items[i].end.dateTime") . "\r\n";
    print "--" . "\r\n";
    $i = $i + 1;
}

# Sample output:

# Eat Lou Malnati's Pizza
# 2017-08-12T12:00:00-05:00
# 2017-08-12T13:00:00-05:00
# --