AIgeminigoogle-aivertex-aiai

How to use Draftship with Google Gemini

Gemini's API and consumer app generate email copy that ports cleanly into Draftship blocks. Long context handles entire brand archives in one prompt. Here's the workflow.

HTML import path
API only
Merge syntax
Generate copy with placeholder variables; substitute via your ESP
Image hosting
external
Best for
Teams on Google Workspace or Vertex AI who want long-context generation against entire brand archives.
Watch out for
Gemini's safety filters can refuse generic marketing prompts that mention sales urgency. Rephrase or use Vertex AI for tighter control.

Gemini's edge is long context. You can paste your entire brand archive (every past email you've shipped) into a single prompt and ask for a new draft that matches. With over a million tokens of context, the voice anchor problem mostly disappears.

Three Gemini surfaces

STEP 1Pick surfaceGemini app, API,Vertex AISTEP 2Paste brandarchive + briefLong context handles100+ emailsSTEP 3Gemini returnsblocksJSON or HTML fragmentsSTEP 4Import toDraftshipHeading, text, buttonSTEP 5Edit, export, shipOutlook-safe HTMLDraftship + Gemini flow
Draftship and Gemini integration paths
  • Gemini app (gemini.google.com): consumer chat, fastest path for non-developers.
  • Gemini API: developer access via Google AI Studio. Standard endpoints.
  • Vertex AI: enterprise path with VPC, audit logs, BYOK. Required for regulated industries.

Long context as the differentiator

For email drafting, the big win is the ability to paste 50 or 100 past emails as voice anchors instead of just two or three. The voice consistency across drafts improves dramatically.

Prompt template:

txt
You're writing a marketing email for {{ company }}. Past emails (this is the full archive; match this voice exactly): [paste 30 to 100 past emails, separated by ---] Brief for the new email: - Goal: {{ what action }} - Audience: {{ who reads this }} - Constraints: subject under 50 chars, 2-4 paragraphs, one CTA. Return as JSON: { "subject": "...", "preheader": "...", "blocks": [...] }

The model picks up patterns from the archive that abstract instructions can't capture: phrasing tics, sentence rhythm, even how you transition between paragraphs.

Structured output via Vertex AI

For batch generation, Vertex AI supports response schemas similar to OpenAI's:

bash
curl -X POST https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT/locations/us-central1/publishers/google/models/gemini-2.5-pro:generateContent \ -H 'Authorization: Bearer $(gcloud auth print-access-token)' \ -d '{ "contents": [{ "role": "user", "parts": [{ "text": "Your prompt" }] }], "generationConfig": { "responseMimeType": "application/json", "responseSchema": { ... } } }'

The responseSchema enforces shape. Map the parsed JSON onto Draftship blocks programmatically.

Image generation via Imagen

Google's Imagen (accessible via Vertex AI or Gemini app) generates hero images. Workflow:

1. Prompt Imagen for a 16:9 hero, no text. 2. Download the result. 3. Upload to your CDN or ESP image library. 4. Paste URL into Draftship's Image block.

Imagen tends toward photographic realism. For illustration-style hero art, Midjourney or DALL-E often produce better results.

Safety filter quirks

Gemini's safety filters block prompts they read as harmful, including some legitimate marketing prompts. Examples that get flagged:

  • "Create urgency around the deadline" (read as manipulative)
  • "Persuade users to upgrade" (read as deceptive)

The fix: rephrase neutrally. "Communicate the upgrade benefits" instead of "persuade." Vertex AI offers tighter control over filter aggressiveness for enterprise accounts.

Test send checklist

When Gemini wins over Claude or GPT

The long-context use case: you have hundreds of past emails and want voice consistency. Gemini handles the archive in a single prompt. Claude and GPT can do this too with Project Knowledge or RAG, but Gemini's raw context window is the simplest path.

For Claude prompt patterns, see Use Draftship with Anthropic Claude.

FAQ

Frequently asked questions

Which Gemini model should I use for email copy?
Gemini 2.5 Pro for high-stakes drafting; Flash for high volume. The Pro tier's voice fidelity on long-archive prompts is the differentiator.
Why does Gemini refuse my marketing prompt?
Safety filters flag persuasion-heavy phrasing. Rephrase neutrally. Vertex AI's enterprise tier exposes more control over filter levels.
Can I use Gemini through Google Workspace?
Yes, via Gemini in Gmail and Docs. The drafts pull from your existing emails as context, useful for writing replies in your voice. For new marketing emails, the standalone Gemini app or API gives you more control.
How do I keep brand voice consistent across drafts?
Paste the brand archive into the prompt. Gemini's long context (over 1M tokens) makes this practical. Update the archive quarterly with new examples.
Does Gemini support function calling?
Yes. Define functions (like fetch_brand_voice or get_recent_email) and Gemini can call them mid-generation. Useful for RAG-augmented drafts that pull live data.
Try it yourself

Design in Draftship. Paste into Google Gemini.