This is an automated email from the ASF dual-hosted git repository.
davsclaus pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel.git
The following commit(s) were added to refs/heads/main by this push:
new c99ab9270838 CAMEL-24344/CAMEL-24345: add the 4.18.5 upgrade notes for
the backported camel-google fixes (#25894)
c99ab9270838 is described below
commit c99ab927083859b37beee5de1673d6f5bad02f50
Author: Andrea Cosentino <[email protected]>
AuthorDate: Sun Aug 30 12:16:20 2026 +0200
CAMEL-24344/CAMEL-24345: add the 4.18.5 upgrade notes for the backported
camel-google fixes (#25894)
The upgrade guides of every release line live on main, so the notes for the
google-mail raw format change and for the vertexai jsonMode option have to
be
added here rather than on the branch the fixes are backported to.
The vertexai note only covers jsonMode: camel-4.18.x has no streaming
implementation to apply streamOutputMode to.
Co-authored-by: Claude Opus 5 (1M context) <[email protected]>
---
.../ROOT/pages/camel-4x-upgrade-guide-4_18.adoc | 18 ++++++++++++++++++
1 file changed, 18 insertions(+)
diff --git
a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_18.adoc
b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_18.adoc
index a426ad44550e..773d6e0c0297 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_18.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_18.adoc
@@ -51,6 +51,24 @@
from("spring-redis://localhost:6379?command=SUBSCRIBE&channels=myChannel"
Setting the `serializer` option to a custom `RedisSerializer` bypasses the
filter entirely, since
Camel then no longer controls how the payload is read.
+=== camel-google-mail - the raw option now returns the message
+
+The `google-mail-stream` consumer always asked the Gmail API for the `FULL`
message format, but the
+`raw` field is only populated for the `RAW` format, so `raw=true` produced a
`null` body. The consumer
+now requests the format that matches the option.
+
+Because the Gmail API does not return the parsed `payload` for the `RAW`
format, a route running with
+`raw=true` no longer receives the `CamelGoogleMailStreamSubject`, `...From`,
`...To`, `...Cc`, `...Bcc`
+and `...MessageId` headers — those values are part of the RFC 2822 content
that is now in the body.
+`CamelGoogleMailStreamId`, `...ThreadId` and `...LabelIds` are still set.
Routes that need the parsed
+headers should keep the default `raw=false`.
+
+=== camel-google-vertexai - the jsonMode option is now applied
+
+The option was declared and documented but never read, so it had no effect.
`jsonMode=true` now sets
+the response MIME type of the request to `application/json`, so the model is
asked to answer with
+JSON. The default `false` leaves the request untouched.
+
== Upgrading from 4.18.3 to 4.18.4
=== camel-core - Multicast EIP honors UseOriginalAggregationStrategy
