get_subscribe_links

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

Verhalten und Grenzen

Liefert die Links zum Abonnieren: die webcal-Adresse für jede Kalender-App und direkte Links für Google Kalender, Outlook.com, Microsoft 365 und Apple Kalender. Zum Teilen auf einer Website, im Newsletter oder in einer Nachricht.

Berechtigungen

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

public_calendars:read

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."
    }
  },
  "required": [
    "calendar_id"
  ],
  "additionalProperties": false
}

Ausgabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "webcal": {
      "type": "string"
    },
    "feed_url": {
      "type": "string"
    },
    "subscribe_links": {
      "type": "object",
      "properties": {
        "google": {
          "type": "string"
        },
        "outlook": {
          "type": "string"
        },
        "office365": {
          "type": "string"
        },
        "apple": {
          "type": "string"
        }
      },
      "required": [
        "google",
        "outlook",
        "office365",
        "apple"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "webcal",
    "feed_url",
    "subscribe_links"
  ],
  "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