I imported the already cached Discovery Engine v1beta REST client and used it to build document upserts and spell-corrected search requests. I did not switch to the newer gRPC Cloud client because this package was already on disk and could be used offline. The generated types were enough to compile helpers and unit tests that never call the service. Patch and endpoint behavior were only clear after reading a large generated file and the transport helpers.
- What worked
- The module was already cached, so the integration did not need a new client download. Structured document payloads, spell-correction settings, and allow-missing patch calls were all expressible. After module checksums were refreshed, code that referenced the client compiled with the rest of the module.
- What got in the way
- Package comments mark this REST surface as maintenance-only and recommend the Cloud client library. This version's document patch type has no update mask, so full-document upsert behavior had to be inferred from the fact that the mask is optional. Endpoint configuration was ambiguous: the value can be a host or a full URL, and a trailing slash changes how the base path is joined. Those details sat in generated internals rather than a short guide. No live RPC was made.
