The "events" collection of methods.
Typical usage is:
$calendarService = new Google_Service_Calendar(...);
$events = $calendarService->events;
Table of Contents
-
$client
: Google_Client
-
$methods
: array<string|int, mixed>
-
$resourceName
: string
-
$rootUrl
: string
-
$serviceName
: string
-
$servicePath
: string
-
$stackParameters
: mixed
-
__construct()
: mixed
-
call()
: Google_Http_Request|expectedClass
- TODO: This function needs simplifying.
-
createRequestUri()
: string
- Parse/expand request parameters and create a fully qualified
request uri.
-
delete()
: mixed
- Deletes an event. (events.delete)
-
get()
: Google_Service_Calendar_Event
- Returns an event. (events.get)
-
import()
: Google_Service_Calendar_Event
- Imports an event. This operation is used to add a private copy of an existing
event to a calendar. (events.import)
-
insert()
: Google_Service_Calendar_Event
- Creates an event. (events.insert)
-
instances()
: Google_Service_Calendar_Events
- Returns instances of the specified recurring event. (events.instances)
-
listEvents()
: Google_Service_Calendar_Events
- Returns events on the specified calendar. (events.listEvents)
-
move()
: Google_Service_Calendar_Event
- Moves an event to another calendar, i.e. changes an event's organizer.
-
patch()
: Google_Service_Calendar_Event
- Updates an event. This method supports patch semantics. (events.patch)
-
quickAdd()
: Google_Service_Calendar_Event
- Creates an event based on a simple text string. (events.quickAdd)
-
update()
: Google_Service_Calendar_Event
- Updates an event. (events.update)
-
watch()
: Google_Service_Calendar_Channel
- Watch for changes to Events resources. (events.watch)
-
convertToArrayAndStripNulls()
: mixed
$client
private
Google_Client
$client
$methods
private
array<string|int, mixed>
$methods
$resourceName
private
string
$resourceName
$rootUrl
private
string
$rootUrl
$serviceName
private
string
$serviceName
$servicePath
private
string
$servicePath
$stackParameters
private
mixed
$stackParameters
= array('alt' => array('type' => 'string', 'location' => 'query'), 'fields' => array('type' => 'string', 'location' => 'query'), 'trace' => array('type' => 'string', 'location' => 'query'), 'userIp' => array('type' => 'string', 'location' => 'query'), 'quotaUser' => array('type' => 'string', 'location' => 'query'), 'data' => array('type' => 'string', 'location' => 'body'), 'mimeType' => array('type' => 'string', 'location' => 'header'), 'uploadType' => array('type' => 'string', 'location' => 'query'), 'mediaUpload' => array('type' => 'complex', 'location' => 'query'), 'prettyPrint' => array('type' => 'string', 'location' => 'query'))
__construct()
public
__construct(mixed $service, mixed $serviceName, mixed $resourceName, mixed $resource) : mixed
Parameters
-
$service
: mixed
-
-
$serviceName
: mixed
-
-
$resourceName
: mixed
-
-
$resource
: mixed
-
Return values
mixed
—
call()
TODO: This function needs simplifying.
public
call( $name, $arguments[, $expectedClass = null ]) : Google_Http_Request|expectedClass
Parameters
-
$name
:
-
-
$arguments
:
-
-
$expectedClass
:
= null
-
- optional, the expected class name
-
throws
-
Google_Exception
Return values
Google_Http_Request|expectedClass
—
createRequestUri()
Parse/expand request parameters and create a fully qualified
request uri.
public
createRequestUri(string $restPath, array<string|int, mixed> $params) : string
Parameters
-
$restPath
: string
-
-
$params
: array<string|int, mixed>
-
-
static
-
Return values
string
—
delete()
Deletes an event. (events.delete)
public
delete(string $calendarId, string $eventId[, array<string|int, mixed> $optParams = array() ]) : mixed
Parameters
-
$calendarId
: string
-
Calendar identifier. To retrieve calendar IDs call
the calendarList.list method. If you want to access the primary calendar of
the currently logged in user, use the "primary" keyword.
-
$eventId
: string
-
-
$optParams
: array<string|int, mixed>
= array()
-
-
opt_param
-
string sendUpdates Guests who should receive notifications about
the deletion of the event.
-
opt_param
-
bool sendNotifications Deprecated. Please use sendUpdates instead.
Whether to send notifications about the deletion of the event. Note that some
emails might still be sent even if you set the value to false. The default is
false.
Return values
mixed
—
get()
Returns an event. (events.get)
public
get(string $calendarId, string $eventId[, array<string|int, mixed> $optParams = array() ]) : Google_Service_Calendar_Event
Parameters
-
$calendarId
: string
-
Calendar identifier. To retrieve calendar IDs call
the calendarList.list method. If you want to access the primary calendar of
the currently logged in user, use the "primary" keyword.
-
$eventId
: string
-
-
$optParams
: array<string|int, mixed>
= array()
-
-
opt_param
-
bool alwaysIncludeEmail Deprecated and ignored. A value will
always be returned in the email field for the organizer, creator and
attendees, even if no real email address is available (i.e. a generated, non-
working value will be provided).
-
opt_param
-
string timeZone Time zone used in the response. Optional. The
default is the time zone of the calendar.
-
opt_param
-
int maxAttendees The maximum number of attendees to include in the
response. If there are more than the specified number of attendees, only the
participant is returned. Optional.
Return values
Google_Service_Calendar_Event
—
import()
Imports an event. This operation is used to add a private copy of an existing
event to a calendar. (events.import)
public
import(string $calendarId, Google_Service_Calendar_Event $postBody[, array<string|int, mixed> $optParams = array() ]) : Google_Service_Calendar_Event
Parameters
-
$calendarId
: string
-
Calendar identifier. To retrieve calendar IDs call
the calendarList.list method. If you want to access the primary calendar of
the currently logged in user, use the "primary" keyword.
-
$postBody
: Google_Service_Calendar_Event
-
-
$optParams
: array<string|int, mixed>
= array()
-
-
opt_param
-
bool supportsAttachments Whether API client performing operation
supports event attachments. Optional. The default is False.
-
opt_param
-
int conferenceDataVersion Version number of conference data
supported by the API client. Version 0 assumes no conference data support and
ignores conference data in the event's body. Version 1 enables support for
copying of ConferenceData as well as for creating new conferences using the
createRequest field of conferenceData. The default is 0.
Return values
Google_Service_Calendar_Event
—
insert()
Creates an event. (events.insert)
public
insert(string $calendarId, Google_Service_Calendar_Event $postBody[, array<string|int, mixed> $optParams = array() ]) : Google_Service_Calendar_Event
Parameters
-
$calendarId
: string
-
Calendar identifier. To retrieve calendar IDs call
the calendarList.list method. If you want to access the primary calendar of
the currently logged in user, use the "primary" keyword.
-
$postBody
: Google_Service_Calendar_Event
-
-
$optParams
: array<string|int, mixed>
= array()
-
-
opt_param
-
bool supportsAttachments Whether API client performing operation
supports event attachments. Optional. The default is False.
-
opt_param
-
int maxAttendees The maximum number of attendees to include in the
response. If there are more than the specified number of attendees, only the
participant is returned. Optional.
-
opt_param
-
int conferenceDataVersion Version number of conference data
supported by the API client. Version 0 assumes no conference data support and
ignores conference data in the event's body. Version 1 enables support for
copying of ConferenceData as well as for creating new conferences using the
createRequest field of conferenceData. The default is 0.
-
opt_param
-
string sendUpdates Whether to send notifications about the
creation of the new event. Note that some emails might still be sent. The
default is false.
-
opt_param
-
bool sendNotifications Deprecated. Please use sendUpdates instead.
Whether to send notifications about the creation of the new event. Note that
some emails might still be sent even if you set the value to false. The
default is false.
Return values
Google_Service_Calendar_Event
—
instances()
Returns instances of the specified recurring event. (events.instances)
public
instances(string $calendarId, string $eventId[, array<string|int, mixed> $optParams = array() ]) : Google_Service_Calendar_Events
Parameters
-
$calendarId
: string
-
Calendar identifier. To retrieve calendar IDs call
the calendarList.list method. If you want to access the primary calendar of
the currently logged in user, use the "primary" keyword.
-
$eventId
: string
-
Recurring event identifier.
-
$optParams
: array<string|int, mixed>
= array()
-
-
opt_param
-
int maxResults Maximum number of events returned on one result
page. By default the value is 250 events. The page size can never be larger
than 2500 events. Optional.
-
opt_param
-
bool alwaysIncludeEmail Deprecated and ignored. A value will
always be returned in the email field for the organizer, creator and
attendees, even if no real email address is available (i.e. a generated, non-
working value will be provided).
-
opt_param
-
string timeMin Lower bound (inclusive) for an event's end time to
filter by. Optional. The default is not to filter by end time. Must be an
RFC3339 timestamp with mandatory time zone offset.
-
opt_param
-
string pageToken Token specifying which result page to return.
Optional.
-
opt_param
-
string timeZone Time zone used in the response. Optional. The
default is the time zone of the calendar.
-
opt_param
-
string timeMax Upper bound (exclusive) for an event's start time
to filter by. Optional. The default is not to filter by start time. Must be
an RFC3339 timestamp with mandatory time zone offset.
-
opt_param
-
int maxAttendees The maximum number of attendees to include in the
response. If there are more than the specified number of attendees, only the
participant is returned. Optional.
-
opt_param
-
bool showDeleted Whether to include deleted events (with status
equals "cancelled") in the result. Cancelled instances of recurring events
will still be included if singleEvents is False. Optional. The default is
False.
-
opt_param
-
string originalStart The original start time of the instance in
the result. Optional.
Return values
Google_Service_Calendar_Events
—
listEvents()
Returns events on the specified calendar. (events.listEvents)
public
listEvents(string $calendarId[, array<string|int, mixed> $optParams = array() ]) : Google_Service_Calendar_Events
Parameters
-
$calendarId
: string
-
Calendar identifier. To retrieve calendar IDs call
the calendarList.list method. If you want to access the primary calendar of
the currently logged in user, use the "primary" keyword.
-
$optParams
: array<string|int, mixed>
= array()
-
-
opt_param
-
string timeMin Lower bound (exclusive) for an event's end time to
filter by. Optional. The default is not to filter by end time. Must be an
RFC3339 timestamp with mandatory time zone offset, for example,
2011-06-03T10:00:00-07:00, 2011-06-03T10:00:00Z. Milliseconds may be provided
but are ignored. If timeMax is set, timeMin must be smaller than timeMax.
-
opt_param
-
string privateExtendedProperty Extended properties constraint
specified as propertyName=value. Matches only private properties. This
parameter might be repeated multiple times to return events that match all
given constraints.
-
opt_param
-
string timeZone Time zone used in the response. Optional. The
default is the time zone of the calendar.
-
opt_param
-
int maxResults Maximum number of events returned on one result
page. The number of events in the resulting page may be less than this value,
or none at all, even if there are more events matching the query. Incomplete
pages can be detected by a non-empty nextPageToken field in the response. By
default the value is 250 events. The page size can never be larger than 2500
events. Optional.
-
opt_param
-
bool alwaysIncludeEmail Deprecated and ignored. A value will
always be returned in the email field for the organizer, creator and
attendees, even if no real email address is available (i.e. a generated, non-
working value will be provided).
-
opt_param
-
bool showDeleted Whether to include deleted events (with status
equals "cancelled") in the result. Cancelled instances of recurring events
(but not the underlying recurring event) will still be included if
showDeleted and singleEvents are both False. If showDeleted and singleEvents
are both True, only single instances of deleted events (but not the
underlying recurring events) are returned. Optional. The default is False.
-
opt_param
-
string q Free text search terms to find events that match these
terms in any field, except for extended properties. Optional.
-
opt_param
-
string syncToken Token obtained from the nextSyncToken field
returned on the last page of results from the previous list request. It makes
the result of this list request contain only entries that have changed since
then. All events deleted since the previous list request will always be in
the result set and it is not allowed to set showDeleted to False. There are
several query parameters that cannot be specified together with nextSyncToken
to ensure consistency of the client state.
These are: - iCalUID - orderBy - privateExtendedProperty - q -
sharedExtendedProperty - timeMin - timeMax - updatedMin If the syncToken
expires, the server will respond with a 410 GONE response code and the client
should clear its storage and perform a full synchronization without any
syncToken. Learn more about incremental synchronization. Optional. The
default is to return all entries.
-
opt_param
-
string updatedMin Lower bound for an event's last modification
time (as a RFC3339 timestamp) to filter by. When specified, entries deleted
since this time will always be included regardless of showDeleted. Optional.
The default is not to filter by last modification time.
-
opt_param
-
string pageToken Token specifying which result page to return.
Optional.
-
opt_param
-
string iCalUID Specifies event ID in the iCalendar format to be
included in the response. Optional.
-
opt_param
-
int maxAttendees The maximum number of attendees to include in the
response. If there are more than the specified number of attendees, only the
participant is returned. Optional.
-
opt_param
-
string orderBy The order of the events returned in the result.
Optional. The default is an unspecified, stable order.
-
opt_param
-
string sharedExtendedProperty Extended properties constraint
specified as propertyName=value. Matches only shared properties. This
parameter might be repeated multiple times to return events that match all
given constraints.
-
opt_param
-
bool singleEvents Whether to expand recurring events into
instances and only return single one-off events and instances of recurring
events, but not the underlying recurring events themselves. Optional. The
default is False.
-
opt_param
-
bool showHiddenInvitations Whether to include hidden invitations
in the result. Optional. The default is False.
-
opt_param
-
string timeMax Upper bound (exclusive) for an event's start time
to filter by. Optional. The default is not to filter by start time. Must be
an RFC3339 timestamp with mandatory time zone offset, for example,
2011-06-03T10:00:00-07:00, 2011-06-03T10:00:00Z. Milliseconds may be provided
but are ignored. If timeMin is set, timeMax must be greater than timeMin.
Return values
Google_Service_Calendar_Events
—
move()
Moves an event to another calendar, i.e. changes an event's organizer.
public
move(string $calendarId, string $eventId, string $destination[, array<string|int, mixed> $optParams = array() ]) : Google_Service_Calendar_Event
Parameters
-
$calendarId
: string
-
Calendar identifier of the source calendar where
the event currently is on.
-
$eventId
: string
-
-
$destination
: string
-
Calendar identifier of the target calendar where
the event is to be moved to.
-
$optParams
: array<string|int, mixed>
= array()
-
-
opt_param
-
bool sendNotifications Deprecated. Please use sendUpdates instead.
Whether to send notifications about the change of the event's organizer. Note
that some emails might still be sent even if you set the value to false. The
default is false.
-
opt_param
-
string sendUpdates Guests who should receive notifications about
the change of the event's organizer.
Return values
Google_Service_Calendar_Event
—
patch()
Updates an event. This method supports patch semantics. (events.patch)
public
patch(string $calendarId, string $eventId, Google_Service_Calendar_Event $postBody[, array<string|int, mixed> $optParams = array() ]) : Google_Service_Calendar_Event
Parameters
-
$calendarId
: string
-
Calendar identifier. To retrieve calendar IDs call
the calendarList.list method. If you want to access the primary calendar of
the currently logged in user, use the "primary" keyword.
-
$eventId
: string
-
-
$postBody
: Google_Service_Calendar_Event
-
-
$optParams
: array<string|int, mixed>
= array()
-
-
opt_param
-
bool supportsAttachments Whether API client performing operation
supports event attachments. Optional. The default is False.
-
opt_param
-
bool alwaysIncludeEmail Deprecated and ignored. A value will
always be returned in the email field for the organizer, creator and
attendees, even if no real email address is available (i.e. a generated, non-
working value will be provided).
-
opt_param
-
int conferenceDataVersion Version number of conference data
supported by the API client. Version 0 assumes no conference data support and
ignores conference data in the event's body. Version 1 enables support for
copying of ConferenceData as well as for creating new conferences using the
createRequest field of conferenceData. The default is 0.
-
opt_param
-
bool sendNotifications Deprecated. Please use sendUpdates instead.
Whether to send notifications about the event update (for example,
description changes, etc.). Note that some emails might still be sent even if
you set the value to false. The default is false.
-
opt_param
-
int maxAttendees The maximum number of attendees to include in the
response. If there are more than the specified number of attendees, only the
participant is returned. Optional.
-
opt_param
-
string sendUpdates Guests who should receive notifications about
the event update (for example, title changes, etc.).
Return values
Google_Service_Calendar_Event
—
quickAdd()
Creates an event based on a simple text string. (events.quickAdd)
public
quickAdd(string $calendarId, string $text[, array<string|int, mixed> $optParams = array() ]) : Google_Service_Calendar_Event
Parameters
-
$calendarId
: string
-
Calendar identifier. To retrieve calendar IDs call
the calendarList.list method. If you want to access the primary calendar of
the currently logged in user, use the "primary" keyword.
-
$text
: string
-
The text describing the event to be created.
-
$optParams
: array<string|int, mixed>
= array()
-
-
opt_param
-
bool sendNotifications Deprecated. Please use sendUpdates instead.
Whether to send notifications about the creation of the event. Note that some
emails might still be sent even if you set the value to false. The default is
false.
-
opt_param
-
string sendUpdates Guests who should receive notifications about
the creation of the new event.
Return values
Google_Service_Calendar_Event
—
update()
Updates an event. (events.update)
public
update(string $calendarId, string $eventId, Google_Service_Calendar_Event $postBody[, array<string|int, mixed> $optParams = array() ]) : Google_Service_Calendar_Event
Parameters
-
$calendarId
: string
-
Calendar identifier. To retrieve calendar IDs call
the calendarList.list method. If you want to access the primary calendar of
the currently logged in user, use the "primary" keyword.
-
$eventId
: string
-
-
$postBody
: Google_Service_Calendar_Event
-
-
$optParams
: array<string|int, mixed>
= array()
-
-
opt_param
-
string sendUpdates Guests who should receive notifications about
the event update (for example, title changes, etc.).
-
opt_param
-
bool supportsAttachments Whether API client performing operation
supports event attachments. Optional. The default is False.
-
opt_param
-
int conferenceDataVersion Version number of conference data
supported by the API client. Version 0 assumes no conference data support and
ignores conference data in the event's body. Version 1 enables support for
copying of ConferenceData as well as for creating new conferences using the
createRequest field of conferenceData. The default is 0.
-
opt_param
-
bool alwaysIncludeEmail Deprecated and ignored. A value will
always be returned in the email field for the organizer, creator and
attendees, even if no real email address is available (i.e. a generated, non-
working value will be provided).
-
opt_param
-
bool sendNotifications Deprecated. Please use sendUpdates instead.
Whether to send notifications about the event update (for example,
description changes, etc.). Note that some emails might still be sent even if
you set the value to false. The default is false.
-
opt_param
-
int maxAttendees The maximum number of attendees to include in the
response. If there are more than the specified number of attendees, only the
participant is returned. Optional.
Return values
Google_Service_Calendar_Event
—
watch()
Watch for changes to Events resources. (events.watch)
public
watch(string $calendarId, Google_Service_Calendar_Channel $postBody[, array<string|int, mixed> $optParams = array() ]) : Google_Service_Calendar_Channel
Parameters
-
$calendarId
: string
-
Calendar identifier. To retrieve calendar IDs call
the calendarList.list method. If you want to access the primary calendar of
the currently logged in user, use the "primary" keyword.
-
$postBody
: Google_Service_Calendar_Channel
-
-
$optParams
: array<string|int, mixed>
= array()
-
-
opt_param
-
string pageToken Token specifying which result page to return.
Optional.
-
opt_param
-
string sharedExtendedProperty Extended properties constraint
specified as propertyName=value. Matches only shared properties. This
parameter might be repeated multiple times to return events that match all
given constraints.
-
opt_param
-
string timeZone Time zone used in the response. Optional. The
default is the time zone of the calendar.
-
opt_param
-
int maxResults Maximum number of events returned on one result
page. The number of events in the resulting page may be less than this value,
or none at all, even if there are more events matching the query. Incomplete
pages can be detected by a non-empty nextPageToken field in the response. By
default the value is 250 events. The page size can never be larger than 2500
events. Optional.
-
opt_param
-
int maxAttendees The maximum number of attendees to include in the
response. If there are more than the specified number of attendees, only the
participant is returned. Optional.
-
opt_param
-
string orderBy The order of the events returned in the result.
Optional. The default is an unspecified, stable order.
-
opt_param
-
string iCalUID Specifies event ID in the iCalendar format to be
included in the response. Optional.
-
opt_param
-
string updatedMin Lower bound for an event's last modification
time (as a RFC3339 timestamp) to filter by. When specified, entries deleted
since this time will always be included regardless of showDeleted. Optional.
The default is not to filter by last modification time.
-
opt_param
-
string q Free text search terms to find events that match these
terms in any field, except for extended properties. Optional.
-
opt_param
-
string syncToken Token obtained from the nextSyncToken field
returned on the last page of results from the previous list request. It makes
the result of this list request contain only entries that have changed since
then. All events deleted since the previous list request will always be in
the result set and it is not allowed to set showDeleted to False. There are
several query parameters that cannot be specified together with nextSyncToken
to ensure consistency of the client state.
These are: - iCalUID - orderBy - privateExtendedProperty - q -
sharedExtendedProperty - timeMin - timeMax - updatedMin If the syncToken
expires, the server will respond with a 410 GONE response code and the client
should clear its storage and perform a full synchronization without any
syncToken. Learn more about incremental synchronization. Optional. The
default is to return all entries.
-
opt_param
-
bool alwaysIncludeEmail Deprecated and ignored. A value will
always be returned in the email field for the organizer, creator and
attendees, even if no real email address is available (i.e. a generated, non-
working value will be provided).
-
opt_param
-
bool singleEvents Whether to expand recurring events into
instances and only return single one-off events and instances of recurring
events, but not the underlying recurring events themselves. Optional. The
default is False.
-
opt_param
-
string privateExtendedProperty Extended properties constraint
specified as propertyName=value. Matches only private properties. This
parameter might be repeated multiple times to return events that match all
given constraints.
-
opt_param
-
string timeMin Lower bound (exclusive) for an event's end time to
filter by. Optional. The default is not to filter by end time. Must be an
RFC3339 timestamp with mandatory time zone offset, for example,
2011-06-03T10:00:00-07:00, 2011-06-03T10:00:00Z. Milliseconds may be provided
but are ignored. If timeMax is set, timeMin must be smaller than timeMax.
-
opt_param
-
string timeMax Upper bound (exclusive) for an event's start time
to filter by. Optional. The default is not to filter by start time. Must be
an RFC3339 timestamp with mandatory time zone offset, for example,
2011-06-03T10:00:00-07:00, 2011-06-03T10:00:00Z. Milliseconds may be provided
but are ignored. If timeMin is set, timeMax must be greater than timeMin.
-
opt_param
-
bool showDeleted Whether to include deleted events (with status
equals "cancelled") in the result. Cancelled instances of recurring events
(but not the underlying recurring event) will still be included if
showDeleted and singleEvents are both False. If showDeleted and singleEvents
are both True, only single instances of deleted events (but not the
underlying recurring events) are returned. Optional. The default is False.
-
opt_param
-
bool showHiddenInvitations Whether to include hidden invitations
in the result. Optional. The default is False.
Return values
Google_Service_Calendar_Channel
—
convertToArrayAndStripNulls()
protected
convertToArrayAndStripNulls(mixed $o) : mixed
Parameters
-
$o
: mixed
-
Return values
mixed
—