upload_inbox_attachment

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

Verhalten und Grenzen

Reserviert Speicher für einen bestehenden Entwurf mit expectedRevision und gibt ein einmaliges binäres Uploadticket zurück. Höchstens 10 Anhänge und 15000000 Rohbytes zusammen pro Nachricht. Datei unverändert per HTTP POST an url mit Authorization: Bearer übertragen; kein Base64 in Toolargumenten. Ticket höchstens fünf Minuten gültig; expiresAt in Unix-Millisekunden. Abschluss prüft tatsächliche Größe/Typ und aktuelle Rechte, hängt die Datei an und erhöht die Entwurfrevision. Dateien nacheinander hochladen und Entwurf vor Bearbeitung/Versand neu lesen. Bei unklarem Ergebnis Anhangsliste und Entwurf prüfen, nicht blind neu reservieren. Offene/fehlgeschlagene Uploads blockieren Versand bis zur Entfernung. Der Client muss binäre HTTP-Übertragung beherrschen; das Tool allein überträgt keine Bytes und belegt keine Clientunterstützung. Kein Mailversand.

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": {
    "draftId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "expectedRevision": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "filename": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "contentType": {
      "type": "string",
      "minLength": 3,
      "maxLength": 150
    },
    "size": {
      "type": "integer",
      "minimum": 0,
      "maximum": 15000000
    }
  },
  "required": [
    "draftId",
    "expectedRevision",
    "filename",
    "contentType",
    "size"
  ],
  "additionalProperties": false
}

Ausgabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "attachmentId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "token": {
      "type": "string"
    },
    "expiresAt": {
      "type": "number"
    },
    "method": {
      "type": "string",
      "enum": [
        "POST",
        "GET"
      ]
    }
  },
  "required": [
    "attachmentId",
    "url",
    "token",
    "expiresAt",
    "method"
  ],
  "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