Der Subscription-Typ bestimmt, welche Fehler Sie sehen werden. Wählen Sie ihn deshalb anhand der Fehlerbilder und nicht anhand des Tutorials.
StreamingPull hält pro Subscriber einen langlebigen Stream offen und ist in den High-Level-Client-Libraries der Standard. Es liefert den besten Durchsatz und die beste Latenz, und die Client-Library übernimmt die Lease-Verlängerung. Die Fehlerbilder liegen beim Client: zu viele ausstehende Daten im Speicher, durch Proxys zurückgesetzte Streams und eine auslaufende Lease-Verlängerung. Wenn Nachrichten wiederholt zurückkommen, lesen wir zuerst die Flow-Control-Einstellungen des Clients.
Pull (unary) bietet die meiste Kontrolle: Sie entscheiden, wann Sie anfragen und wann Sie bestätigen. Es passt zu Batch-artigen Consumern und Workern, die anhand des Rückstaus skalieren. Typische Fehler sind zu langsames Polling, ein Worker-Pool, in dem jeder Worker einen Batch hält, und Bestätigen erst nach einem langen nachgelagerten Aufruf.
Push übergibt die Zustellung an einen HTTPS-Endpoint, was zu Cloud Run und Functions passt. Der Service steuert die Rate anhand der Antworten Ihres Endpoints, sodass die Latenz des Endpoints zur Zustellrate wird. Typische Fehler sind langsame Antworten, eine nicht passende Audience des OIDC-Tokens und Cold Starts, die die Ack Deadline verfehlen. Push-Subscriptions unterstützen keine Exactly-once-Zustellung (Dokumentation von Google Cloud, abgerufen am 17. November 2026).
BigQuery- und Cloud-Storage-Subscriptions schreiben Nachrichten ohne Subscriber-Code direkt in eine Tabelle oder einen Bucket. Typische Fehler sind Schema-Abweichungen (Nachrichten, die nicht zur Tabelle passen, landen im Dead-Letter-Pfad oder werden wiederholt), Quotas am Ziel und Kosten.
Unsere Faustregel: StreamingPull für dauerhaft laufende Services, Pull für geplante oder automatisch skalierte Worker, Push, wenn der Consumer bereits ein anfragegesteuerter Service mit vorhersagbarer Latenz ist, und eine direkte Export-Subscription, wenn keine Transformation nötig ist. Wir prüfen jede Subscription anhand des Traffic-Profils und ihres Handlers und sagen klar, wenn ein Wechsel des Subscription-Typs eine ganze Klasse von Vorfällen beseitigen würde.