save_inbox_draft

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

Verhalten und Grenzen

Speichert einen Entwurf ohne Versand. to/cc/bcc explizit angeben, insgesamt höchstens 50 unterschiedliche Mailadressen; Betreff bis 998 Zeichen ohne Steuerzeichen, Text bis 100000 Zeichen. Leere Empfänger und Texte sind als Entwurf erlaubt. Neuanlage ohne id/expectedRevision, mit stabiler requestId (8–128 ASCII-Buchstaben, Ziffern, Unterstriche oder Bindestriche); bei unklarem Ergebnis denselben Schlüssel/Inhalt wiederholen. Bearbeiten mit id und aktueller expectedRevision; das ersetzt Betreff, Empfänger und Text des Entwurfs, der vorige Inhalt bleibt nicht erhalten. Bei Konflikt neu lesen, keine fremden Änderungen überschreiben. replyToEntryId aus get_inbox_thread ist nur eine Threadreferenz im selben Postfach, keine Empfängerableitung oder Versandfreigabe. Bestehende Anhänge bleiben erhalten; Verwaltung über Anhangstools. Optionales html (höchstens 200000 UTF-8-Bytes und 200000 Zeichen) wird auf einfache Formatierung und sichere http/https/mailto-Links reduziert; Skripte, Styles, Bilder, Formulare und eingebettete Medien entfallen. Bei vorhandenem html wird text aus dem bereinigten Inhalt abgeleitet und ersetzt den übergebenen Text. Ohne html wird ein formatierter Entwurf durch Klartext ersetzt. Nach dem Speichern den normalisierten Inhalt mit get_inbox_draft prüfen. Keine freien Absender oder automatische Übernahme zitierter Adressen.

Berechtigungen

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

inbox:write

Freigaben und Grenzen

Eingabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "to": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 320,
        "format": "email",
        "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
      }
    },
    "cc": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 320,
        "format": "email",
        "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
      }
    },
    "bcc": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 320,
        "format": "email",
        "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
      }
    },
    "subject": {
      "type": "string",
      "maxLength": 998
    },
    "text": {
      "type": "string",
      "maxLength": 100000
    },
    "html": {
      "type": "string",
      "maxLength": 200000
    },
    "replyToEntryId": {
      "type": "string"
    },
    "inboxId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "expectedRevision": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "requestId": {
      "type": "string",
      "pattern": "^[a-zA-Z0-9_-]{8,128}$"
    }
  },
  "required": [
    "to",
    "cc",
    "bcc",
    "subject",
    "text",
    "inboxId",
    "requestId"
  ],
  "additionalProperties": false
}

Ausgabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "revision": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "id",
    "revision"
  ],
  "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