# preview_sync

Verhalten, Eingaben, Ausgaben und Freigaben für preview_sync.

Source: https://docs.getridian.com/de/developers/tools/preview_sync/
Language: de
Reviewed: 2026-10-06

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

## Verhalten und Grenzen

Prüft, ob eine einseitige Synchronisierung von einem Kalender des Nutzers in einen anderen angelegt werden könnte, ohne etwas anzulegen. Meldet beide Kalender, ob es ginge, und ALLE gefundenen Hindernisse — nicht nur das erste. Nennt bewusst keine Zahl kopierter Termine: Sie wird nicht berechnet und deshalb nicht behauptet. Eine Synchronisierung kopiert fortlaufend, nicht einmal. Eine positive Vorschau ist keine Reservierung: Beim Anlegen laufen dieselben Prüfungen erneut, und die Lage kann sich dazwischen ändern.

## Berechtigungen

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

`sync:read`

[Freigaben und Grenzen](https://docs.getridian.com/de/developers/authentication/)

## Eingabe

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "sourceCalendarId": {
      "type": "string",
      "minLength": 1
    },
    "targetCalendarId": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "sourceCalendarId",
    "targetCalendarId"
  ],
  "additionalProperties": false
}
```

## Ausgabe

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "const": true
    },
    "source": {
      "type": "object",
      "properties": {
        "id": {
          "type": [
            "string",
            "null"
          ]
        },
        "name": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "id",
        "name"
      ],
      "additionalProperties": false
    },
    "target": {
      "type": "object",
      "properties": {
        "id": {
          "type": [
            "string",
            "null"
          ]
        },
        "name": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "id",
        "name"
      ],
      "additionalProperties": false
    },
    "direction": {
      "type": "string",
      "const": "one_way"
    },
    "canCreate": {
      "type": "boolean"
    },
    "blockers": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "effect": {
      "type": "string",
      "const": "ongoing_copy_unknown_volume"
    }
  },
  "required": [
    "ok",
    "source",
    "target",
    "direction",
    "canCreate",
    "blockers",
    "effect"
  ],
  "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](https://docs.getridian.com/de/developers/errors/)