write_public_calendar_events

Diese Referenz wird aus dem veröffentlichten Werkzeugvertrag erzeugt. Feldnamen und normative Beschreibungen im Schema sind Englisch.

Verhalten und Grenzen

Legt bis zu 100 Termine eines Abo-Kalenders an, ersetzt oder löscht sie. upserts ersetzen einen Termin mit derselben external_id vollständig; deletes entfernen Termine per external_id. Ergebnisse je Eintrag; ein ungültiger Eintrag hält die anderen nicht auf. Inhalte sind öffentlich. Abonnenten sehen Änderungen beim nächsten Abruf (Google bis zu 24 Stunden).

Berechtigungen

Freigegebene Scopes, Konten, Kalender und Sichtbarkeitsregeln begrenzen den Zugriff. Ein Workspace-Admin erhält dadurch keinen pauschalen Zugriff auf fremde Konten.

public_calendars:write

Freigaben und Grenzen

Eingabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "calendar_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Calendar id from list_public_calendars."
    },
    "upserts": {
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "external_id": {
            "type": "string",
            "pattern": "^[A-Za-z0-9._:-]{1,128}$",
            "description": "Your stable id for the event: 1–128 letters, digits and . _ : -. Writing the same id again replaces the event."
          },
          "event": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "minLength": 1,
                "maxLength": 255
              },
              "start": {
                "type": "string",
                "description": "Local \"2027-01-16T10:00\" in the event zone, an ISO timestamp with offset, or a date \"2027-01-16\" for all-day events."
              },
              "end": {
                "description": "Exclusive date for all-day events; otherwise like start. Default: calendar default length.",
                "type": "string"
              },
              "timezone": {
                "type": "string",
                "maxLength": 64
              },
              "all_day": {
                "type": "boolean"
              },
              "location": {
                "type": "string",
                "maxLength": 500
              },
              "url": {
                "description": "https link shown in the event.",
                "type": "string",
                "maxLength": 2000
              },
              "description": {
                "type": "string",
                "maxLength": 65536
              },
              "status": {
                "type": "string",
                "enum": [
                  "confirmed",
                  "tentative",
                  "cancelled"
                ]
              },
              "show_as": {
                "type": "string",
                "enum": [
                  "free",
                  "busy"
                ]
              },
              "categories": {
                "maxItems": 10,
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 50
                }
              },
              "alarms": {
                "description": "Reminders in minutes before start.",
                "maxItems": 3,
                "type": "array",
                "items": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 40320
                }
              },
              "recurrence": {
                "type": "object",
                "properties": {
                  "rules": {
                    "minItems": 1,
                    "maxItems": 5,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 500
                    },
                    "description": "RRULEs such as \"FREQ=WEEKLY;BYDAY=TH;COUNT=6\". DAILY to YEARLY only."
                  },
                  "except_dates": {
                    "maxItems": 1000,
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  }
                },
                "required": [
                  "rules"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "title",
              "start"
            ],
            "additionalProperties": {}
          }
        },
        "required": [
          "external_id",
          "event"
        ],
        "additionalProperties": false
      }
    },
    "deletes": {
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Za-z0-9._:-]{1,128}$",
        "description": "Your stable id for the event: 1–128 letters, digits and . _ : -. Writing the same id again replaces the event."
      }
    }
  },
  "required": [
    "calendar_id"
  ],
  "additionalProperties": false
}

Ausgabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "external_id": {
            "type": "string"
          },
          "status": {
            "type": "number"
          },
          "changed": {
            "type": "boolean"
          },
          "deleted": {
            "type": "boolean"
          },
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "detail": {
                "type": "string"
              }
            },
            "required": [
              "code"
            ],
            "additionalProperties": {}
          }
        },
        "required": [
          "external_id",
          "status"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "results"
  ],
  "additionalProperties": false
}

Fehler und Wiederholungen

Prüfe das Werkzeugergebnis auf Fehler. Wiederhole Schreiboperationen nicht blind nach einem Timeout. Prüfe zuerst den aktuellen Ressourcen- oder Sendestatus.

Fehlerbehandlung