Calendars
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Uma coleção de todas as agendas existentes. Consulte também Agendas x AgendaList.
Para ver uma lista de métodos desse recurso, consulte o final desta página.
Representações de recursos
{
"kind": "calendar#calendar",
"etag": etag,
"id": string,
"summary": string,
"description": string,
"location": string,
"timeZone": string,
"conferenceProperties": {
"allowedConferenceSolutionTypes": [
string
]
}
}
Nome da propriedade |
Valor |
Descrição |
Observações |
conferenceProperties |
nested object |
Propriedades de conferência desta agenda, por exemplo, quais tipos de videoconferências são permitidos. |
|
conferenceProperties.allowedConferenceSolutionTypes[] |
list |
Os tipos de soluções de conferência compatíveis com esta agenda. Os valores possíveis são: "eventHangout" "eventNamedHangout" "hangoutsMeet" Opcional. |
|
description |
string |
Descrição da agenda. Opcional. |
gravável
|
etag |
etag |
ETag do recurso. |
|
id |
string |
Identificador da agenda. Para recuperar IDs, chame o método calendarList.list(). |
|
kind |
string |
Tipo do recurso ("calendar#calendar "). |
|
location |
string |
Localização geográfica da agenda como texto em formato livre. Opcional. |
gravável
|
summary |
string |
Título da agenda. |
gravável
|
timeZone |
string |
O fuso horário da agenda. Formatado como um nome do banco de dados de fuso horário IANA, por exemplo, "Europa/Zurique". Opcional. |
gravável
|
Métodos
- limpar
- Limpa uma agenda principal. Essa operação exclui todos os eventos associados à agenda principal de uma conta.
- delete
- Exclui uma agenda secundária. Use calendar.clear para limpar todos os eventos das agendas principais.
- get
- Retorna metadados de uma agenda.
- inserir
- Cria uma agenda secundária.
- patch
- Atualiza os metadados de uma agenda. Esse método é compatível com a semântica de patch. Cada solicitação de patch consome três unidades de cota. prefira usar uma
get
seguida por uma update
. Os valores de campo especificados substituem os atuais. Os campos não especificados na solicitação permanecem inalterados. Campos de matriz, se especificados, substituem as matrizes existentes. isso descartará os elementos anteriores da matriz.
- update
- Atualiza os metadados de uma agenda.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 2025-07-25 UTC."],[],[],null,["# Calendars\n\nA collection of all existing calendars. See also [Calendars vs CalendarList](/workspace/calendar/api/concepts/events-calendars#calendar_and_calendar_list).\n\nFor a list of [methods](#methods) for this resource, see the end of this page.\n\nResource representations\n------------------------\n\n\u003cbr /\u003e\n\n```text\n{\n \"kind\": \"calendar#calendar\",\n \"etag\": etag,\n \"id\": string,\n \"summary\": string,\n \"description\": string,\n \"location\": string,\n \"timeZone\": string,\n \"conferenceProperties\": {\n \"allowedConferenceSolutionTypes\": [\n string\n ]\n }\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------------------------------------------------|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|\n| `conferenceProperties` | `nested object` | Conferencing properties for this calendar, for example what types of conferences are allowed. | |\n| conferenceProperties.`allowedConferenceSolutionTypes[]` | `list` | The types of conference solutions that are supported for this calendar. The possible values are: - `\"eventHangout\"` - `\"eventNamedHangout\"` - `\"hangoutsMeet\"` Optional. \u003cbr /\u003e | |\n| `description` | `string` | Description of the calendar. Optional. | writable |\n| `etag` | `etag` | ETag of the resource. | |\n| `id` | `string` | Identifier of the calendar. To retrieve IDs call the [calendarList.list()](/calendar/v3/reference/calendarList/list) method. | |\n| `kind` | `string` | Type of the resource (\"`calendar#calendar`\"). | |\n| `location` | `string` | Geographic location of the calendar as free-form text. Optional. | writable |\n| `summary` | `string` | Title of the calendar. | writable |\n| `timeZone` | `string` | The time zone of the calendar. (Formatted as an IANA Time Zone Database name, e.g. \"Europe/Zurich\".) Optional. | writable |\n\nMethods\n-------\n\n[clear](/workspace/calendar/api/v3/reference/calendars/clear)\n: Clears a primary calendar. This operation deletes all events associated with the primary calendar of an account.\n\n[delete](/workspace/calendar/api/v3/reference/calendars/delete)\n: Deletes a secondary calendar. Use calendars.clear for clearing all events on primary calendars.\n\n[get](/workspace/calendar/api/v3/reference/calendars/get)\n: Returns metadata for a calendar.\n\n[insert](/workspace/calendar/api/v3/reference/calendars/insert)\n: Creates a secondary calendar.\n\n[patch](/workspace/calendar/api/v3/reference/calendars/patch)\n: Updates metadata for a calendar. This method supports patch semantics. Note that each patch request consumes three quota units; prefer using a `get` followed by an `update`. The field values you specify replace the existing values. Fields that you don't specify in the request remain unchanged. Array fields, if specified, overwrite the existing arrays; this discards any previous array elements.\n\n[update](/workspace/calendar/api/v3/reference/calendars/update)\n: Updates metadata for a calendar."]]