create_sync

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

Verhalten und Grenzen

Legt eine einseitige Synchronisierung von einem Kalender des Nutzers in einen anderen an, nachdem der Nutzer genau diese Quelle, dieses Ziel und diesen Detailgrad im Chat bestätigt hat. Zuerst preview_sync aufrufen und dem Nutzer sagen, was dabei herauskommt. Dieselben Prüfungen laufen hier erneut, eine Vorschau garantiert also nichts. Eine stabile requestId mitgeben: derselbe Wert mit denselben Angaben liefert dieselbe Synchronisierung statt einer zweiten, derselbe Wert mit anderen Angaben scheitert. Das Ergebnis ist created_pending_processing: Das Paar besteht und die Engine beginnt zu kopieren; synchronisiert ist noch nichts. Regeln ändern, Richtung umkehren oder eine Synchronisierung löschen geht hier nicht — das passiert in der Ridian-App, verlinkt als syncsUrl. Eine so angelegte Synchronisierung läuft als eigener Ridian-Auftrag weiter, auch nachdem der Zugriff dieses Assistenten widerrufen wurde. Der fortlaufende Auftrag ändert und entfernt seine verwalteten Zielkopien, wenn die zugehörigen Quelltermine geändert oder gelöscht werden.

Berechtigungen

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

sync:read, sync:write

Freigaben und Grenzen

Eingabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "sourceCalendarId": {
      "type": "string",
      "minLength": 1
    },
    "targetCalendarId": {
      "type": "string",
      "minLength": 1
    },
    "detailLevel": {
      "type": "string",
      "enum": [
        "busy_only",
        "title_and_time",
        "full_details"
      ],
      "description": "How much of each event reaches the target calendar. Ask the user; do not assume."
    },
    "requestId": {
      "type": "string",
      "minLength": 8,
      "maxLength": 100
    }
  },
  "required": [
    "sourceCalendarId",
    "targetCalendarId",
    "detailLevel",
    "requestId"
  ],
  "additionalProperties": false
}

Ausgabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "const": true
    },
    "status": {
      "type": "string",
      "const": "created_pending_processing"
    },
    "legs": {
      "type": "number"
    },
    "replayed": {
      "type": "boolean"
    },
    "syncsUrl": {
      "type": "string"
    }
  },
  "required": [
    "ok",
    "status",
    "legs",
    "replayed",
    "syncsUrl"
  ],
  "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