Unipile – Table of Contents<\/title><link href=\"https:\/\/fonts.googleapis.com\/css2?family=Inter:wght@400;500;600;700&family=Poppins:wght@700;800&display=swap\" rel=\"stylesheet\"><style>body { background: #f4f5f7; margin: 0; }#unipile-toc.utc-wrapper { display: block !important; max-width: 1100px !important; margin: 0 auto !important; padding: 0 !important; font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif !important;}#unipile-toc *,#unipile-toc *::before,#unipile-toc *::after { margin: 0 !important; padding: 0 !important; box-sizing: border-box !important; border: none !important; outline: none !important; font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif !important; line-height: normal !important; letter-spacing: normal !important; text-transform: none !important; text-decoration: none !important; list-style: none !important; background: transparent !important; float: none !important;}#unipile-toc .utc-card { background: #ffffff !important; border-radius: 16px !important; border: 1px solid #e5e7eb !important; padding: 32px !important; box-shadow: 0 2px 12px rgba(15, 39, 54, 0.04) !important;}#unipile-toc .utc-header { display: flex !important; align-items: center !important; justify-content: space-between !important; gap: 12px !important; margin-bottom: 24px !important; padding-bottom: 20px !important; border-bottom: 1px solid #e5e7eb !important;}#unipile-toc .utc-header-left { display: flex !important; align-items: center !important; gap: 12px !important;}#unipile-toc .utc-icon-box { width: 36px !important; height: 36px !important; background: rgba(59, 185, 139, 0.12) !important; border-radius: 8px !important; display: flex !important; align-items: center !important; justify-content: center !important; flex-shrink: 0 !important;}#unipile-toc .utc-icon-box svg { width: 18px !important; height: 18px !important; stroke: #3BB98B !important; fill: none !important; stroke-width: 2.2 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}#unipile-toc .utc-title { font-family: 'Poppins', sans-serif !important; font-size: 15px !important; font-weight: 700 !important; color: #0f2736 !important; text-transform: uppercase !important; letter-spacing: 0.5px !important;}#unipile-toc .utc-toggle { display: none !important; align-items: center !important; gap: 6px !important; background: transparent !important; cursor: pointer !important; font-size: 13px !important; font-weight: 600 !important; color: #3BB98B !important; padding: 6px 10px !important; border-radius: 6px !important; transition: background 0.2s ease !important;}#unipile-toc .utc-toggle svg { width: 14px !important; height: 14px !important; stroke: #3BB98B !important; fill: none !important; stroke-width: 2.5 !important; stroke-linecap: round !important; stroke-linejoin: round !important; transition: transform 0.3s ease !important;}#unipile-toc.utc-collapsed .utc-toggle svg { transform: rotate(-90deg) !important;}#unipile-toc .utc-grid { display: grid !important; grid-template-columns: repeat(4, 1fr) !important; gap: 0 !important;}#unipile-toc .utc-col { padding: 0 24px !important; border-left: 1px solid #e5e7eb !important;}#unipile-toc .utc-col:first-child { padding-left: 0 !important; border-left: none !important;}#unipile-toc .utc-col:last-child { padding-right: 0 !important;}#unipile-toc .utc-col-label { font-size: 11px !important; font-weight: 700 !important; color: #94a3b8 !important; text-transform: uppercase !important; letter-spacing: 0.8px !important; margin-bottom: 14px !important; display: block !important;}#unipile-toc .utc-link-list { display: flex !important; flex-direction: column !important; gap: 10px !important;}#unipile-toc .utc-link { display: flex !important; align-items: flex-start !important; gap: 10px !important; cursor: pointer !important; transition: all 0.2s ease !important; text-decoration: none !important; padding: 4px 0 !important;}#unipile-toc .utc-num { width: 18px !important; height: 18px !important; flex-shrink: 0 !important; background: #f4f5f7 !important; border-radius: 4px !important; display: flex !important; align-items: center !important; justify-content: center !important; font-size: 10px !important; font-weight: 700 !important; color: #94a3b8 !important; transition: all 0.2s ease !important; margin-top: 1px !important;}#unipile-toc .utc-num.utc-num-faq { font-size: 8px !important; letter-spacing: 0.2px !important;}#unipile-toc .utc-link-text { font-size: 13px !important; font-weight: 500 !important; color: #383838 !important; line-height: 1.45 !important; transition: color 0.2s ease !important; flex: 1 !important;}#unipile-toc .utc-link:hover .utc-num { background: rgba(59, 185, 139, 0.15) !important; color: #3BB98B !important;}#unipile-toc .utc-link:hover .utc-link-text { color: #0f2736 !important;}#unipile-toc .utc-link.utc-active .utc-num { background: #3BB98B !important; color: #ffffff !important;}#unipile-toc .utc-link.utc-active .utc-link-text { color: #0f2736 !important; font-weight: 600 !important;}#unipile-toc .utc-link.utc-read .utc-num { background: rgba(59, 185, 139, 0.15) !important; color: #3BB98B !important;}#unipile-toc .utc-tag-best { display: inline-block !important; font-size: 9px !important; font-weight: 700 !important; color: #ffffff !important; background: #3BB98B !important; padding: 2px 6px !important; border-radius: 4px !important; text-transform: uppercase !important; letter-spacing: 0.5px !important; margin-left: 6px !important; vertical-align: middle !important;}@media (max-width: 1000px) { #unipile-toc .utc-grid { grid-template-columns: repeat(2, 1fr) !important; gap: 24px 0 !important; } #unipile-toc .utc-col { padding: 0 20px !important; } #unipile-toc .utc-col:nth-child(2n+1) { padding-left: 0 !important; border-left: none !important; } #unipile-toc .utc-col:nth-child(2n) { padding-right: 0 !important; }}@media (max-width: 700px) { #unipile-toc .utc-card { padding: 22px !important; } #unipile-toc .utc-header { margin-bottom: 0 !important; padding-bottom: 0 !important; border-bottom: none !important; } #unipile-toc .utc-toggle { display: flex !important; } #unipile-toc .utc-grid { grid-template-columns: 1fr !important; gap: 22px !important; max-height: 2000px !important; overflow: hidden !important; transition: max-height 0.4s ease, margin-top 0.3s ease, padding-top 0.3s ease, border-top-color 0.3s ease !important; margin-top: 22px !important; padding-top: 22px !important; border-top: 1px solid #e5e7eb !important; } \/* Etat ferme par defaut sur mobile (CSS-first, evite le flash) *\/ #unipile-toc.utc-mobile-init .utc-grid, #unipile-toc.utc-collapsed .utc-grid { max-height: 0 !important; margin-top: 0 !important; padding-top: 0 !important; border-top-color: transparent !important; } #unipile-toc.utc-mobile-init .utc-toggle svg, #unipile-toc.utc-collapsed .utc-toggle svg { transform: rotate(-90deg) !important; } #unipile-toc .utc-col { padding: 0 !important; border-left: none !important; border-top: 1px solid #e5e7eb !important; padding-top: 18px !important; } #unipile-toc .utc-col:first-child { border-top: none !important; padding-top: 0 !important; }}<\/style><\/head><body><div id=\"unipile-toc\" class=\"utc-wrapper utc-mobile-init\"> <div class=\"utc-card\"> <div class=\"utc-header\"> <div class=\"utc-header-left\"> <div class=\"utc-icon-box\"> <svg viewBox=\"0 0 24 24\"><line x1=\"8\" y1=\"6\" x2=\"21\" y2=\"6\"\/><line x1=\"8\" y1=\"12\" x2=\"21\" y2=\"12\"\/><line x1=\"8\" y1=\"18\" x2=\"21\" y2=\"18\"\/><line x1=\"3\" y1=\"6\" x2=\"3.01\" y2=\"6\"\/><line x1=\"3\" y1=\"12\" x2=\"3.01\" y2=\"12\"\/><line x1=\"3\" y1=\"18\" x2=\"3.01\" y2=\"18\"\/><\/svg> <\/div> <span class=\"utc-title\">Table of Contents<\/span> <\/div> <button type=\"button\" class=\"utc-toggle\" aria-label=\"Toggle table of contents\" aria-expanded=\"false\"> <span class=\"utc-toggle-label\">Show<\/span> <svg viewBox=\"0 0 24 24\"><polyline points=\"6 9 12 15 18 9\"\/><\/svg> <\/button> <\/div> <div class=\"utc-grid\">  <div class=\"utc-col\"> <span class=\"utc-col-label\">The Basics<\/span> <div class=\"utc-link-list\"> <a class=\"utc-link\" href=\"#short-answer\"> <span class=\"utc-num\">01<\/span> <span class=\"utc-link-text\">API Key Verdict<\/span> <\/a> <a class=\"utc-link\" href=\"#api-key-does\"> <span class=\"utc-num\">02<\/span> <span class=\"utc-link-text\">What API Keys Do<\/span> <\/a> <a class=\"utc-link\" href=\"#why-oauth\"> <span class=\"utc-num\">03<\/span> <span class=\"utc-link-text\">Why Gmail Needs OAuth<\/span> <\/a> <\/div> <\/div>  <div class=\"utc-col\"> <span class=\"utc-col-label\">Auth Paths<\/span> <div class=\"utc-link-list\"> <a class=\"utc-link\" href=\"#three-paths\"> <span class=\"utc-num\">04<\/span> <span class=\"utc-link-text\">3 Auth Paths Compared<\/span> <\/a> <a class=\"utc-link\" href=\"#path-oauth-client\"> <span class=\"utc-num\">05<\/span> <span class=\"utc-link-text\">Path 1: OAuth Client<\/span> <\/a> <a class=\"utc-link\" href=\"#path-service-account\"> <span class=\"utc-num\">06<\/span> <span class=\"utc-link-text\">Path 2: Service Account<\/span> <\/a> <\/div> <\/div>  <div class=\"utc-col\"> <span class=\"utc-col-label\">Practical Guide<\/span> <div class=\"utc-link-list\"> <a class=\"utc-link\" href=\"#path-unified-api\"> <span class=\"utc-num\">07<\/span> <span class=\"utc-link-text\">Path 3: Unified API<\/span> <\/a> <a class=\"utc-link\" href=\"#common-errors\"> <span class=\"utc-num\">08<\/span> <span class=\"utc-link-text\">Common Errors<\/span> <\/a> <a class=\"utc-link\" href=\"#gmail-scopes\"> <span class=\"utc-num\">09<\/span> <span class=\"utc-link-text\">Gmail API Scopes<\/span> <\/a> <\/div> <\/div>  <div class=\"utc-col\"> <span class=\"utc-col-label\">Decision<\/span> <div class=\"utc-link-list\"> <a class=\"utc-link\" href=\"#decision-tree\"> <span class=\"utc-num\">10<\/span> <span class=\"utc-link-text\"><span>Decision Tree<\/span><span class=\"utc-tag-best\">Best<\/span><\/span> <\/a> <a class=\"utc-link\" href=\"#gmail-api-key-vs-oauth-faq\"> <span class=\"utc-num utc-num-faq\">FAQ<\/span> <span class=\"utc-link-text\">FAQ<\/span> <\/a> <\/div> <\/div> <\/div> <\/div><\/div><script>(function(){ var toc = document.getElementById('unipile-toc'); if (!toc) return; var MOBILE_BP = 700; var toggleBtn = toc.querySelector('.utc-toggle'); var toggleLabel = toc.querySelector('.utc-toggle-label'); \/\/ Synchronise l'etat (collapsed + label + aria) selon la largeur. \/\/ Sur mobile on ferme d'office ; sur desktop l'accordeon n'a pas lieu d'etre. function syncToWidth(){ var isMobile = window.innerWidth <= MOBILE_BP; \/\/ On retire la classe d'init CSS des que le JS prend le relais toc.classList.remove('utc-mobile-init'); if (isMobile) { toc.classList.add('utc-collapsed'); } else { toc.classList.remove('utc-collapsed'); } refreshUI(); } function refreshUI(){ var collapsed = toc.classList.contains('utc-collapsed'); if (toggleLabel) toggleLabel.textContent = collapsed ? 'Show' : 'Hide'; if (toggleBtn) toggleBtn.setAttribute('aria-expanded', collapsed ? 'false' : 'true'); } if (toggleBtn) { toggleBtn.addEventListener('click', function(){ toc.classList.remove('utc-mobile-init'); toc.classList.toggle('utc-collapsed'); refreshUI(); }); } \/\/ Init + suivi du resize \/ rotation (sur desktop -> mobile et inverse) var lastMobile = null; function onResize(){ var isMobile = window.innerWidth <= MOBILE_BP; if (isMobile !== lastMobile) { lastMobile = isMobile; syncToWidth(); } } \/\/ Etat initial : ferme d'office si mobile au chargement if (window.innerWidth <= MOBILE_BP) { toc.classList.remove('utc-mobile-init'); toc.classList.add('utc-collapsed'); } else { toc.classList.remove('utc-mobile-init'); } lastMobile = window.innerWidth <= MOBILE_BP; refreshUI(); window.addEventListener('resize', onResize, { passive: true }); \/\/ Smooth scroll var links = toc.querySelectorAll('.utc-link'); links.forEach(function(link){ link.addEventListener('click', function(e){ var href = link.getAttribute('href'); if (!href || href.charAt(0) !== '#') return; var target = document.getElementById(href.substring(1)); if (target) { e.preventDefault(); var offset = 80; var top = target.getBoundingClientRect().top + window.pageYOffset - offset; window.scrollTo({ top: top, behavior: 'smooth' }); } }); }); \/\/ Scroll-spy var sectionIds = []; links.forEach(function(link){ var href = link.getAttribute('href'); if (href && href.charAt(0) === '#') sectionIds.push(href.substring(1)); }); function updateActive(){ var scrollY = window.pageYOffset + 120; var activeId = null; var readIds = []; sectionIds.forEach(function(id){ var el = document.getElementById(id); if (el) { var top = el.getBoundingClientRect().top + window.pageYOffset; if (top <= scrollY) { activeId = id; readIds.push(id); } } }); links.forEach(function(link){ var href = link.getAttribute('href'); var id = href ? href.substring(1) : ''; link.classList.remove('utc-active', 'utc-read'); if (id === activeId) { link.classList.add('utc-active'); } else if (readIds.indexOf(id) !== -1) { link.classList.add('utc-read'); } }); } if ('IntersectionObserver' in window) { var observer = new IntersectionObserver(function(){ updateActive(); }, { rootMargin: '-120px 0px -60% 0px' }); sectionIds.forEach(function(id){ var el = document.getElementById(id); if (el) observer.observe(el); }); } window.addEventListener('scroll', updateActive, { passive: true }); updateActive();})();<\/script><\/body><\/html>[\/et_pb_code][\/et_pb_column][\/et_pb_row][\/et_pb_section][et_pb_section fb_built=”1″ _builder_version=”4.27.3″ background_color=”transparent” custom_padding=”0px|0px|0px|0px|false|false” global_colors_info=”{}” theme_builder_area=”post_content” da_is_popup=”off” da_exit_intent=”off” da_has_close=”on” da_alt_close=”off” da_dark_close=”off” da_not_modal=”on” da_is_singular=”off” da_with_loader=”off” da_has_shadow=”on” da_disable_devices=”off|off|off”][et_pb_row _builder_version=”4.27.3″ background_color=”transparent” global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_column type=”4_4″ _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_code _builder_version=”4.27.4″ hover_enabled=”0″ global_colors_info=”{}” theme_builder_area=”post_content” sticky_enabled=”0″]<!DOCTYPE html><html lang=\"en\"><head><meta charset=\"UTF-8\"><meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\"><title>Unipile – Gmail API Hero<\/title><link href=\"https:\/\/fonts.googleapis.com\/css2?family=Inter:wght@400;500;600;700&family=Poppins:wght@700;800&display=swap\" rel=\"stylesheet\"><style>body { background: #f4f5f7; margin: 0; }#upl-gako-hero,#upl-gako-hero *,#upl-gako-hero *::before,#upl-gako-hero *::after { margin: 0 !important; padding: 0 !important; box-sizing: border-box !important; border: none !important; outline: none !important; font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif !important; line-height: 1.5 !important; letter-spacing: normal !important; text-transform: none !important; text-decoration: none !important; list-style: none !important;}#upl-gako-hero { background: transparent !important; padding: 60px 20px 50px !important; overflow: hidden !important;}#upl-gako-hero .gako-container { max-width: 1100px !important; margin: 0 auto !important; display: grid !important; grid-template-columns: 1fr 1fr !important; gap: 60px !important; align-items: center !important;}#upl-gako-hero .gako-badge { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: rgba(59, 185, 139, 0.12) !important; color: #2aaa7e !important; padding: 6px 14px !important; border-radius: 20px !important; font-size: 12px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.5px !important; margin-bottom: 20px !important; width: fit-content !important;}#upl-gako-hero .gako-badge .gako-dot { width: 7px !important; height: 7px !important; background: #3BB98B !important; border-radius: 50% !important; flex-shrink: 0 !important;}#upl-gako-hero .gako-h1 { font-family: 'Poppins', sans-serif !important; font-size: 44px !important; font-weight: 700 !important; color: #0f2736 !important; line-height: 1.18 !important; margin-bottom: 20px !important;}#upl-gako-hero .gako-accent { color: #3BB98B !important;}#upl-gako-hero .gako-desc { font-size: 17px !important; color: #383838 !important; line-height: 1.75 !important; margin-bottom: 32px !important;}#upl-gako-hero .gako-actions { display: flex !important; align-items: center !important; gap: 14px !important; flex-wrap: wrap !important;}#upl-gako-hero .gako-cta-primary { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: #DDDF4C !important; color: #0f2736 !important; padding: 14px 28px !important; border-radius: 8px !important; font-size: 0.95rem !important; font-weight: 600 !important; border: 2px solid #DDDF4C !important; transition: transform 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important;}#upl-gako-hero .gako-cta-primary:hover { transform: translateY(-5px) !important;}#upl-gako-hero .gako-cta-primary svg { width: 16px !important; height: 16px !important; stroke: currentColor !important; fill: none !important; stroke-width: 2.5 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}#upl-gako-hero .gako-cta-secondary { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: transparent !important; color: #0f2736 !important; padding: 12px 24px !important; border-radius: 8px !important; font-size: 0.95rem !important; font-weight: 600 !important; border: 2px solid #0f2736 !important; transition: all 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important;}#upl-gako-hero .gako-cta-secondary:hover { background: #0f2736 !important; color: #ffffff !important;}#upl-gako-hero .gako-cta-secondary svg { width: 16px !important; height: 16px !important; stroke: currentColor !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}\/* Code editor *\/#upl-gako-hero .gako-code-wrapper { border-radius: 14px !important; overflow: hidden !important; background: #0d1117 !important; box-shadow: 0 24px 60px rgba(15,39,54,0.18) !important; max-width: 100% !important;}#upl-gako-hero .gako-editor-bar { background: #161b22 !important; padding: 12px 18px !important; display: flex !important; align-items: center !important; gap: 8px !important; border-bottom: 1px solid rgba(255,255,255,0.06) !important;}#upl-gako-hero .gako-dot-r { width: 12px !important; height: 12px !important; border-radius: 50% !important; background: #ff5f57 !important; flex-shrink: 0 !important; }#upl-gako-hero .gako-dot-y { width: 12px !important; height: 12px !important; border-radius: 50% !important; background: #febc2e !important; flex-shrink: 0 !important; }#upl-gako-hero .gako-dot-g { width: 12px !important; height: 12px !important; border-radius: 50% !important; background: #28c840 !important; flex-shrink: 0 !important; }#upl-gako-hero .gako-filename { color: #8b949e !important; font-size: 13px !important; margin-left: 6px !important; font-family: 'Courier New', monospace !important;}#upl-gako-hero .gako-pre { padding: 22px 24px !important; font-size: 13px !important; line-height: 1.8 !important; overflow-x: auto !important; -webkit-overflow-scrolling: touch !important; background: #0d1117 !important;}#upl-gako-hero .gako-pre code { font-family: 'Courier New', monospace !important; white-space: pre !important; display: block !important;}#upl-gako-hero .c { color: #8b949e !important; }#upl-gako-hero .k { color: #ff7b72 !important; }#upl-gako-hero .fn { color: #d2a8ff !important; }#upl-gako-hero .s { color: #a5d6ff !important; }#upl-gako-hero .n { color: #79c0ff !important; }#upl-gako-hero .w { color: #e6edf3 !important; }#upl-gako-hero .gako-editor-ok { background: rgba(59,185,139,0.10) !important; border-top: 1px solid rgba(59,185,139,0.25) !important; color: #3BB98B !important; padding: 11px 24px !important; font-size: 12.5px !important; font-family: 'Courier New', monospace !important; display: flex !important; align-items: center !important; gap: 8px !important;}#upl-gako-hero .gako-editor-ok svg { width: 14px !important; height: 14px !important; stroke: #3BB98B !important; fill: none !important; stroke-width: 2.5 !important; stroke-linecap: round !important; stroke-linejoin: round !important; flex-shrink: 0 !important;}#upl-gako-hero .gako-providers { display: flex !important; align-items: center !important; gap: 10px !important; padding: 12px 18px !important; background: #ffffff !important; border-top: 1px solid #e8ecf0 !important; flex-wrap: wrap !important;}#upl-gako-hero .gako-providers-label { font-size: 11px !important; color: #94a3b8 !important; font-weight: 600 !important; text-transform: uppercase !important; letter-spacing: 0.5px !important;}#upl-gako-hero .gako-providers img { width: 20px !important; height: 20px !important;}@media (max-width: 900px) { #upl-gako-hero .gako-container { grid-template-columns: 1fr !important; gap: 44px !important; } #upl-gako-hero .gako-h1 { font-size: 34px !important; } #upl-gako-hero { padding: 50px 20px !important; }}@media (max-width: 600px) { #upl-gako-hero { padding: 44px 16px !important; } #upl-gako-hero .gako-h1 { font-size: 28px !important; } #upl-gako-hero .gako-desc { font-size: 15.5px !important; } #upl-gako-hero .gako-actions { width: 100% !important; gap: 10px !important; } #upl-gako-hero .gako-cta-primary, #upl-gako-hero .gako-cta-secondary { width: 100% !important; justify-content: center !important; } #upl-gako-hero .gako-code-wrapper { box-shadow: 0 12px 30px rgba(15,39,54,0.16) !important; } #upl-gako-hero .gako-pre { padding: 18px 16px !important; font-size: 11.5px !important; line-height: 1.7 !important; } #upl-gako-hero .gako-editor-ok { font-size: 11px !important; padding: 10px 16px !important; align-items: flex-start !important; } #upl-gako-hero .gako-editor-ok svg { margin-top: 2px !important; }}@media (max-width: 400px) { #upl-gako-hero .gako-h1 { font-size: 23px !important; } #upl-gako-hero .gako-pre { font-size: 10.5px !important; }}<\/style><div id=\"upl-gako-hero\"> <div class=\"gako-container\">  <div> <div class=\"gako-badge\"><span class=\"gako-dot\"><\/span><span>Gmail API Authentication<\/span><\/div> <h2 class=\"gako-h1\">Gmail API Key vs <span class=\"gako-accent\">OAuth<\/span>: Why You Can’t Skip OAuth<\/h2> <pee class=\"gako-desc\">Can you use a Google API key to access Gmail? Short answer: no. Gmail API accesses private user data, which means every request needs explicit user consent through OAuth 2.0. This guide covers the exact error you’ll see if you try an API key, the 3 real authentication paths available today, and how to connect a Gmail mailbox in 3 lines of code using a <a href=\"https:\/\/www.unipile.com\/email-api\/\" style=\"color:#2aaa7e!important;text-decoration:underline!important;\">unified email API<\/a>.<\/pee> <div class=\"gako-actions\"> <span class=\"gako-cta-primary\" data-upl-link=\"https:\/\/dashboard.unipile.com\/signup\/\" data-upl-target=\"_blank\"><span>Start building<\/span><svg viewBox=\"0 0 24 24\"><line x1=\"5\" y1=\"12\" x2=\"19\" y2=\"12\"\/><polyline points=\"12 5 19 12 12 19\"\/><\/svg><\/span> <span class=\"gako-cta-secondary\" data-upl-link=\"https:\/\/www.unipile.com\/communication-api\/email-api\/duplicate-enhance-your-email-software-with-gmail-api-integration\/\" data-upl-target=\"_self\"><span>Gmail API guide<\/span><svg viewBox=\"0 0 24 24\"><polyline points=\"9 18 15 12 9 6\"\/><\/svg><\/span> <\/div> <\/div>  <div> <div class=\"gako-code-wrapper\"> <div class=\"gako-editor-bar\"> <span class=\"gako-dot-r\"><\/span><span class=\"gako-dot-y\"><\/span><span class=\"gako-dot-g\"><\/span> <span class=\"gako-filename\">gmail-auth.js<\/span> <\/div> <div class=\"gako-pre\"><code><span class=\"c\">\/\/ Gmail API Key vs OAuth - the verdict<\/span><span class=\"c\">\/\/ ----------------------------------------<\/span><span class=\"c\">\/\/ WRONG: API key does NOT work with Gmail<\/span><span class=\"k\">const<\/span> <span class=\"w\">res <\/span><span class=\"k\">=<\/span> <span class=\"k\">await<\/span> <span class=\"fn\">fetch<\/span><span class=\"w\">(<\/span> <span class=\"s\">`https:\/\/gmail.googleapis.com\/gmail\/v1\/<\/span><span class=\"s\"> users\/me\/messages?key=<\/span><span class=\"n\">YOUR_API_KEY<\/span><span class=\"s\">`<\/span><span class=\"w\">);<\/span><span class=\"c\">\/\/ Returns: 401 Login Required<\/span><span class=\"c\">\/\/ CORRECT: OAuth 2.0 access token<\/span><span class=\"k\">const<\/span> <span class=\"w\">res <\/span><span class=\"k\">=<\/span> <span class=\"k\">await<\/span> <span class=\"fn\">fetch<\/span><span class=\"w\">(<\/span> <span class=\"s\">'https:\/\/gmail.googleapis.com\/gmail\/v1\/users\/me\/messages'<\/span><span class=\"w\">,<\/span> <span class=\"w\">{<\/span> <span class=\"w\">headers:<\/span> <span class=\"w\">{<\/span> <span class=\"s\">'Authorization'<\/span><span class=\"w\">:<\/span> <span class=\"s\">`Bearer <\/span><span class=\"n\">${accessToken}<\/span><span class=\"s\">`<\/span> <span class=\"w\">}<\/span> <span class=\"w\">}<\/span><span class=\"w\">);<\/span><span class=\"c\">\/\/ OR skip OAuth entirely - use Unipile<\/span><span class=\"k\">const<\/span> <span class=\"w\">mails <\/span><span class=\"k\">=<\/span> <span class=\"k\">await<\/span> <span class=\"fn\">unipile<\/span><span class=\"w\">.<\/span><span class=\"fn\">email<\/span><span class=\"w\">.<\/span><span class=\"fn\">list<\/span><span class=\"w\">(<\/span> <span class=\"w\">{ accountId:<\/span> <span class=\"s\">'linked-account-id'<\/span> <span class=\"w\">}<\/span><span class=\"w\">);<\/span><\/code><\/div> <div class=\"gako-editor-ok\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>No OAuth boilerplate – Unipile handles tokens for you<\/span><\/div> <div class=\"gako-providers\"> <span class=\"gako-providers-label\">Works with<\/span> <img decoding=\"async\" src=\"https:\/\/www.unipile.com\/wp-content\/uploads\/2024\/02\/gmail-3.svg\" alt=\"Gmail\" width=\"20\" height=\"20\"> <img decoding=\"async\" src=\"https:\/\/www.unipile.com\/wp-content\/uploads\/2024\/02\/outlook-2.svg\" alt=\"Outlook\" width=\"20\" height=\"20\"> <img decoding=\"async\" src=\"https:\/\/www.unipile.com\/wp-content\/uploads\/2024\/02\/imap-1.svg\" alt=\"IMAP\" width=\"20\" height=\"20\"> <\/div> <\/div> <\/div> <\/div><\/div><script>(function(){ function init(){ var el = document.getElementById('upl-gako-hero'); if (!el) return; el.addEventListener('click', function(e){ var t = e.target.closest('[data-upl-link]'); if (!t) return; var url = t.getAttribute('data-upl-link'); var target = t.getAttribute('data-upl-target') || '_self'; if (url) window.open(url, target); }); } if (document.readyState === 'loading') { document.addEventListener('DOMContentLoaded', init); } else { init(); }})();<\/script><\/body><\/html>[\/et_pb_code][\/et_pb_column][\/et_pb_row][\/et_pb_section][et_pb_section fb_built=”1″ _builder_version=”4.27.3″ background_color=”transparent” custom_padding=”0px|0px|0px|0px|false|false” global_colors_info=”{}” theme_builder_area=”post_content” da_is_popup=”off” da_exit_intent=”off” da_has_close=”on” da_alt_close=”off” da_dark_close=”off” da_not_modal=”on” da_is_singular=”off” da_with_loader=”off” da_has_shadow=”on” da_disable_devices=”off|off|off”][et_pb_row _builder_version=”4.27.3″ background_color=”transparent” global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_column type=”4_4″ _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_code _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”]<link href=\"https:\/\/fonts.googleapis.com\/css2?family=Inter:wght@400;500;600;700&family=Poppins:wght@700;800&display=swap\" rel=\"stylesheet\"><style>#upl-gako-s1,#upl-gako-s1 *,#upl-gako-s1 *::before,#upl-gako-s1 *::after { margin: 0 !important; padding: 0 !important; box-sizing: border-box !important; border: none !important; outline: none !important; font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif !important; line-height: 1.5 !important; letter-spacing: normal !important; text-transform: none !important; text-decoration: none !important; list-style: none !important;}#upl-gako-s1 { background: transparent !important; padding: 60px 20px !important;}#upl-gako-s1 .s1-container { max-width: 1100px !important; margin: 0 auto !important;}#upl-gako-s1 .s1-badge { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: rgba(59,185,139,0.12) !important; color: #2aaa7e !important; padding: 6px 14px !important; border-radius: 20px !important; font-size: 12px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.5px !important; margin-bottom: 16px !important; width: fit-content !important;}#upl-gako-s1 .s1-badge .s1-dot { width: 7px !important; height: 7px !important; background: #3BB98B !important; border-radius: 50% !important; flex-shrink: 0 !important;}#upl-gako-s1 .s1-h2 { font-family: 'Poppins', sans-serif !important; font-size: 35px !important; font-weight: 700 !important; color: #0f2736 !important; line-height: 1.2 !important; margin-bottom: 16px !important;}#upl-gako-s1 .s1-intro { font-size: 17px !important; color: #383838 !important; line-height: 1.75 !important; margin-bottom: 36px !important;}#upl-gako-s1 .s1-verdict-box { background: #0f2736 !important; border-radius: 16px !important; padding: 28px 32px !important; margin-bottom: 36px !important; display: flex !important; gap: 20px !important; align-items: flex-start !important;}#upl-gako-s1 .s1-verdict-icon { width: 44px !important; height: 44px !important; background: rgba(59,185,139,0.15) !important; border-radius: 10px !important; display: flex !important; align-items: center !important; justify-content: center !important; flex-shrink: 0 !important;}#upl-gako-s1 .s1-verdict-icon svg { width: 22px !important; height: 22px !important; stroke: #3BB98B !important; fill: none !important; stroke-width: 2.5 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}#upl-gako-s1 .s1-verdict-label { font-size: 11px !important; font-weight: 700 !important; color: #3BB98B !important; text-transform: uppercase !important; letter-spacing: 0.8px !important; margin-bottom: 8px !important; display: block !important;}#upl-gako-s1 .s1-verdict-text { font-size: 16px !important; color: rgba(255,255,255,0.88) !important; line-height: 1.7 !important;}#upl-gako-s1 .s1-verdict-text strong { color: #ffffff !important; font-weight: 700 !important;}\/* Error box *\/#upl-gako-s1 .s1-error-grid { display: grid !important; grid-template-columns: 1fr 1fr !important; gap: 20px !important; margin-bottom: 36px !important;}#upl-gako-s1 .s1-error-card { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; overflow: hidden !important;}#upl-gako-s1 .s1-error-header { background: #161b22 !important; padding: 12px 18px !important; display: flex !important; align-items: center !important; gap: 8px !important;}#upl-gako-s1 .s1-dot-r { width: 10px !important; height: 10px !important; border-radius: 50% !important; background: #ff5f57 !important; flex-shrink: 0 !important; }#upl-gako-s1 .s1-dot-y { width: 10px !important; height: 10px !important; border-radius: 50% !important; background: #febc2e !important; flex-shrink: 0 !important; }#upl-gako-s1 .s1-dot-g { width: 10px !important; height: 10px !important; border-radius: 50% !important; background: #28c840 !important; flex-shrink: 0 !important; }#upl-gako-s1 .s1-file { color: #8b949e !important; font-size: 12px !important; font-family: 'Courier New', monospace !important; margin-left: 4px !important; }#upl-gako-s1 .s1-error-body { padding: 18px 20px !important; background: #0d1117 !important; font-family: 'Courier New', monospace !important; font-size: 12.5px !important; line-height: 1.7 !important;}#upl-gako-s1 .er { color: #ff7b72 !important; }#upl-gako-s1 .em { color: #e6edf3 !important; }#upl-gako-s1 .ec { color: #8b949e !important; }#upl-gako-s1 .ev { color: #a5d6ff !important; }#upl-gako-s1 .en { color: #79c0ff !important; }#upl-gako-s1 .s1-error-note { padding: 12px 18px !important; background: rgba(239,68,68,0.06) !important; border-top: 1px solid rgba(239,68,68,0.15) !important; font-size: 12.5px !important; color: #ef4444 !important; font-family: 'Courier New', monospace !important;}\/* Definition cards *\/#upl-gako-s1 .s1-def-grid { display: grid !important; grid-template-columns: 1fr 1fr !important; gap: 20px !important;}#upl-gako-s1 .s1-def-card { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; padding: 24px !important;}#upl-gako-s1 .s1-def-card-icon { width: 40px !important; height: 40px !important; border-radius: 10px !important; display: flex !important; align-items: center !important; justify-content: center !important; margin-bottom: 14px !important;}#upl-gako-s1 .s1-def-card-icon svg { width: 20px !important; height: 20px !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}#upl-gako-s1 .s1-def-card h3 { font-family: 'Poppins', sans-serif !important; font-size: 17px !important; font-weight: 700 !important; color: #0f2736 !important; margin-bottom: 8px !important; line-height: 1.3 !important;}#upl-gako-s1 .s1-def-card p { font-size: 15px !important; color: #4a5568 !important; line-height: 1.7 !important;}#upl-gako-s1 .s1-def-card.red-card { border-color: rgba(239,68,68,0.25) !important; background: rgba(239,68,68,0.03) !important;}#upl-gako-s1 .s1-def-card.green-card { border-color: rgba(59,185,139,0.25) !important; background: rgba(59,185,139,0.03) !important;}#upl-gako-s1 .icon-red { background: rgba(239,68,68,0.10) !important; }#upl-gako-s1 .icon-red svg { stroke: #ef4444 !important; }#upl-gako-s1 .icon-green { background: rgba(59,185,139,0.12) !important; }#upl-gako-s1 .icon-green svg { stroke: #3BB98B !important; }@media (max-width: 900px) { #upl-gako-s1 .s1-h2 { font-size: 28px !important; } #upl-gako-s1 .s1-error-grid { grid-template-columns: 1fr !important; } #upl-gako-s1 .s1-def-grid { grid-template-columns: 1fr !important; } #upl-gako-s1 { padding: 50px 20px !important; }}@media (max-width: 600px) { #upl-gako-s1 .s1-h2 { font-size: 26px !important; }}<\/style><div id=\"upl-gako-s1\"> <div class=\"s1-container\"> <span id=\"short-answer\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"s1-badge\"><span class=\"s1-dot\"><\/span><span>The Short Answer<\/span><\/div> <h2 class=\"s1-h2\">Can You Use an API Key with the Gmail API?<\/h2> <pee class=\"s1-intro\">If you’ve built on Google Cloud before, you know API keys work fine for Maps or Translate. So it’s natural to try the same approach with Gmail. It won’t work. Here’s exactly what happens and why – plus the two-sentence verdict before we go deep.<\/pee> <div class=\"s1-verdict-box\"> <div class=\"s1-verdict-icon\"><svg viewBox=\"0 0 24 24\"><circle cx=\"12\" cy=\"12\" r=\"10\"\/><line x1=\"12\" y1=\"8\" x2=\"12\" y2=\"12\"\/><line x1=\"12\" y1=\"16\" x2=\"12.01\" y2=\"16\"\/><\/svg><\/div> <div> <span class=\"s1-verdict-label\">Verdict<\/span> <pee class=\"s1-verdict-text\"><strong>No. Google API keys cannot authenticate against the Gmail API.<\/strong> Gmail accesses private user data, which requires explicit user consent via OAuth 2.0. There is no flag, no header, no workaround that lets you substitute an API key for an OAuth access token on any Gmail endpoint. The Gmail API will return a <strong>401 Login Required<\/strong> or <strong>403 Daily Limit for Unauthenticated Use Exceeded<\/strong> error every single time.<\/pee> <\/div> <\/div>  <div class=\"s1-error-grid\"> <div class=\"s1-error-card\"> <div class=\"s1-error-header\"> <span class=\"s1-dot-r\"><\/span><span class=\"s1-dot-y\"><\/span><span class=\"s1-dot-g\"><\/span> <span class=\"s1-file\">terminal – API key attempt<\/span> <\/div> <div class=\"s1-error-body\"><span class=\"ec\"># Request with API key<\/span><span class=\"em\">GET \/gmail\/v1\/users\/me\/messages<\/span><span class=\"em\"> ?key=AIzaSy…<\/span><span class=\"ec\"># Response<\/span><span class=\"er\">HTTP\/1.1 401 Unauthorized<\/span><span class=\"ev\">{ “error”: { “code”: <\/span><span class=\"en\">401<\/span><span class=\"ev\">, “message”: “Login Required”, “status”: “UNAUTHENTICATED” }}<\/span><\/div> <div class=\"s1-error-note\">401 Login Required – API key rejected<\/div> <\/div> <div class=\"s1-error-card\"> <div class=\"s1-error-header\"> <span class=\"s1-dot-r\"><\/span><span class=\"s1-dot-y\"><\/span><span class=\"s1-dot-g\"><\/span> <span class=\"s1-file\">terminal – unauthenticated quota hit<\/span> <\/div> <div class=\"s1-error-body\"><span class=\"ec\"># After repeated unauthenticated calls<\/span><span class=\"em\">GET \/gmail\/v1\/users\/me\/messages<\/span><span class=\"em\"> ?key=AIzaSy…<\/span><span class=\"ec\"># Response<\/span><span class=\"er\">HTTP\/1.1 403 Forbidden<\/span><span class=\"ev\">{ “error”: { “code”: <\/span><span class=\"en\">403<\/span><span class=\"ev\">, “message”: “Daily Limit for Unauthenticated Use Exceeded”, “status”: “RESOURCE_EXHAUSTED” }}<\/span><\/div> <div class=\"s1-error-note\">403 Unauthenticated Quota Exceeded<\/div> <\/div> <\/div>  <div class=\"s1-def-grid\"> <div class=\"s1-def-card red-card\"> <div class=\"s1-def-card-icon icon-red\"><svg viewBox=\"0 0 24 24\"><circle cx=\"12\" cy=\"12\" r=\"10\"\/><line x1=\"15\" y1=\"9\" x2=\"9\" y2=\"15\"\/><line x1=\"9\" y1=\"9\" x2=\"15\" y2=\"15\"\/><\/svg><\/div> <h3>API Key – Works for public data only<\/h3> <pee>An API key identifies your Google Cloud project for billing and quota. It works with public APIs (Maps, Translate, YouTube public data) that don’t touch user accounts. Gmail is never public data.<\/pee> <\/div> <div class=\"s1-def-card green-card\"> <div class=\"s1-def-card-icon icon-green\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><\/div> <h3>OAuth 2.0 – Required for Gmail API<\/h3> <pee>OAuth 2.0 generates a user-specific access token after the user explicitly grants consent. Gmail API reads that token on every request to verify both the user’s identity and the scope of access approved. No valid access token = no response.<\/pee> <\/div> <\/div> <\/div><\/div>[\/et_pb_code][\/et_pb_column][\/et_pb_row][\/et_pb_section][et_pb_section fb_built=”1″ _builder_version=”4.27.3″ background_color=”transparent” custom_padding=”0px|0px|0px|0px|false|false” global_colors_info=”{}” theme_builder_area=”post_content” da_is_popup=”off” da_exit_intent=”off” da_has_close=”on” da_alt_close=”off” da_dark_close=”off” da_not_modal=”on” da_is_singular=”off” da_with_loader=”off” da_has_shadow=”on” da_disable_devices=”off|off|off”][et_pb_row _builder_version=”4.27.3″ background_color=”transparent” global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_column type=”4_4″ _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_code _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”]<link href=\"https:\/\/fonts.googleapis.com\/css2?family=Inter:wght@400;500;600;700&family=Poppins:wght@700;800&display=swap\" rel=\"stylesheet\"><style>#upl-gako-s2,#upl-gako-s2 *,#upl-gako-s2 *::before,#upl-gako-s2 *::after { margin: 0 !important; padding: 0 !important; box-sizing: border-box !important; border: none !important; outline: none !important; font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif !important; line-height: 1.5 !important; letter-spacing: normal !important; text-transform: none !important; text-decoration: none !important; list-style: none !important;}#upl-gako-s2 { background: #f4f5f7 !important; padding: 60px 20px !important;}#upl-gako-s2 .s2-container { max-width: 1100px !important; margin: 0 auto !important;}#upl-gako-s2 .s2-badge { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: rgba(221,223,76,0.18) !important; color: #8a8c2e !important; padding: 6px 14px !important; border-radius: 20px !important; font-size: 12px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.5px !important; margin-bottom: 16px !important; width: fit-content !important;}#upl-gako-s2 .s2-badge .s2-dot { width: 7px !important; height: 7px !important; background: #DDDF4C !important; border-radius: 50% !important; flex-shrink: 0 !important;}#upl-gako-s2 .s2-h2 { font-family: 'Poppins', sans-serif !important; font-size: 35px !important; font-weight: 700 !important; color: #0f2736 !important; line-height: 1.2 !important; margin-bottom: 16px !important;}#upl-gako-s2 .s2-intro { font-size: 17px !important; color: #383838 !important; line-height: 1.75 !important; margin-bottom: 40px !important;}\/* Two-col split *\/#upl-gako-s2 .s2-split { display: grid !important; grid-template-columns: 1fr 1fr !important; gap: 28px !important; margin-bottom: 36px !important;}#upl-gako-s2 .s2-col-title { font-family: 'Poppins', sans-serif !important; font-size: 17px !important; font-weight: 700 !important; color: #0f2736 !important; margin-bottom: 16px !important; display: flex !important; align-items: center !important; gap: 10px !important;}#upl-gako-s2 .s2-col-title svg { width: 20px !important; height: 20px !important; stroke: currentColor !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important; flex-shrink: 0 !important;}#upl-gako-s2 .col-yes .s2-col-title { color: #2aaa7e !important; }#upl-gako-s2 .col-no .s2-col-title { color: #ef4444 !important; }#upl-gako-s2 .s2-list-item { display: flex !important; align-items: flex-start !important; gap: 10px !important; padding: 10px 14px !important; background: #ffffff !important; border-radius: 10px !important; margin-bottom: 8px !important; border: 1px solid #e5e7eb !important;}#upl-gako-s2 .s2-list-item-icon { width: 20px !important; height: 20px !important; flex-shrink: 0 !important; border-radius: 50% !important; display: flex !important; align-items: center !important; justify-content: center !important; margin-top: 1px !important;}#upl-gako-s2 .s2-list-item-icon svg { width: 11px !important; height: 11px !important; stroke: currentColor !important; fill: none !important; stroke-width: 3 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}#upl-gako-s2 .icon-ok { background: rgba(59,185,139,0.12) !important; color: #3BB98B !important; }#upl-gako-s2 .icon-no { background: rgba(239,68,68,0.10) !important; color: #ef4444 !important; }#upl-gako-s2 .s2-list-item p { font-size: 15px !important; color: #383838 !important; line-height: 1.6 !important;}#upl-gako-s2 .s2-list-item p strong { color: #0f2736 !important; font-weight: 600 !important;}\/* Callout *\/#upl-gako-s2 .s2-callout { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-left: 4px solid #3BB98B !important; border-radius: 12px !important; padding: 20px 24px !important; display: flex !important; gap: 14px !important; align-items: flex-start !important;}#upl-gako-s2 .s2-callout svg { width: 20px !important; height: 20px !important; stroke: #3BB98B !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important; flex-shrink: 0 !important; margin-top: 2px !important;}#upl-gako-s2 .s2-callout p { font-size: 15px !important; color: #383838 !important; line-height: 1.7 !important;}#upl-gako-s2 .s2-callout p strong { color: #0f2736 !important; font-weight: 700 !important;}@media (max-width: 900px) { #upl-gako-s2 .s2-h2 { font-size: 28px !important; } #upl-gako-s2 .s2-split { grid-template-columns: 1fr !important; } #upl-gako-s2 { padding: 50px 20px !important; }}@media (max-width: 600px) { #upl-gako-s2 .s2-h2 { font-size: 26px !important; }}<\/style><div id=\"upl-gako-s2\"> <div class=\"s2-container\"> <span id=\"api-key-does\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"s2-badge\"><span class=\"s2-dot\"><\/span><span>Concepts<\/span><\/div> <h2 class=\"s2-h2\">What an API Key Actually Does on Google Cloud (and Doesn’t)<\/h2> <pee class=\"s2-intro\">API keys and OAuth tokens are two distinct mechanisms that solve two different problems. Confusing them is one of the most common mistakes when starting with Google APIs. Here’s the clean separation.<\/pee> <div class=\"s2-split\"> <div class=\"col-yes\"> <div class=\"s2-col-title\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>What API keys DO work with<\/span><\/div> <div class=\"s2-list-item\"> <span class=\"s2-list-item-icon icon-ok\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><\/span> <pee><strong>Google Maps Platform<\/strong> – Geocoding, Directions, Places (no user account needed)<\/pee> <\/div> <div class=\"s2-list-item\"> <span class=\"s2-list-item-icon icon-ok\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><\/span> <pee><strong>Cloud Translation API<\/strong> – Translating text, detecting languages<\/pee> <\/div> <div class=\"s2-list-item\"> <span class=\"s2-list-item-icon icon-ok\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><\/span> <pee><strong>YouTube Data API<\/strong> – Reading public video metadata, channels, playlists<\/pee> <\/div> <div class=\"s2-list-item\"> <span class=\"s2-list-item-icon icon-ok\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><\/span> <pee><strong>Cloud Vision \/ Natural Language<\/strong> – ML APIs that process content you upload<\/pee> <\/div> <div class=\"s2-list-item\"> <span class=\"s2-list-item-icon icon-ok\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><\/span> <pee><strong>Billing + Quota tracking<\/strong> – All API key usage is metered against your project<\/pee> <\/div> <\/div> <div class=\"col-no\"> <div class=\"s2-col-title\"><svg viewBox=\"0 0 24 24\"><circle cx=\"12\" cy=\"12\" r=\"10\"\/><line x1=\"15\" y1=\"9\" x2=\"9\" y2=\"15\"\/><line x1=\"9\" y1=\"9\" x2=\"15\" y2=\"15\"\/><\/svg><span>What API keys CANNOT do<\/span><\/div> <div class=\"s2-list-item\"> <span class=\"s2-list-item-icon icon-no\"><svg viewBox=\"0 0 24 24\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"\/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"\/><\/svg><\/span> <pee><strong>Gmail API<\/strong> – Reading, sending, or managing any user’s mailbox<\/pee> <\/div> <div class=\"s2-list-item\"> <span class=\"s2-list-item-icon icon-no\"><svg viewBox=\"0 0 24 24\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"\/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"\/><\/svg><\/span> <pee><strong>Google Calendar API<\/strong> – Reading or writing any user’s calendar events<\/pee> <\/div> <div class=\"s2-list-item\"> <span class=\"s2-list-item-icon icon-no\"><svg viewBox=\"0 0 24 24\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"\/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"\/><\/svg><\/span> <pee><strong>Google Drive API<\/strong> – Accessing, uploading, or listing a user’s files<\/pee> <\/div> <div class=\"s2-list-item\"> <span class=\"s2-list-item-icon icon-no\"><svg viewBox=\"0 0 24 24\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"\/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"\/><\/svg><\/span> <pee><strong>Google Workspace Admin SDK<\/strong> – Any admin-scoped operation on a domain<\/pee> <\/div> <div class=\"s2-list-item\"> <span class=\"s2-list-item-icon icon-no\"><svg viewBox=\"0 0 24 24\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"\/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"\/><\/svg><\/span> <pee><strong>People API (user data)<\/strong> – Any endpoint that touches a user’s contacts or profile<\/pee> <\/div> <\/div> <\/div> <div class=\"s2-callout\"> <svg viewBox=\"0 0 24 24\"><circle cx=\"12\" cy=\"12\" r=\"10\"\/><line x1=\"12\" y1=\"8\" x2=\"12\" y2=\"12\"\/><line x1=\"12\" y1=\"16\" x2=\"12.01\" y2=\"16\"\/><\/svg> <pee>The rule is simple: <strong>if an API touches a user’s account data, Google requires that user to authenticate via OAuth 2.0.<\/strong> API keys are project credentials, not user credentials. Gmail API is always user data. No exceptions. This rule applies regardless of whether your app is public or internal to your company.<\/pee> <\/div> <\/div><\/div>[\/et_pb_code][\/et_pb_column][\/et_pb_row][\/et_pb_section][et_pb_section fb_built=”1″ _builder_version=”4.27.3″ background_color=”transparent” custom_padding=”0px|0px|0px|0px|false|false” global_colors_info=”{}” theme_builder_area=”post_content” da_is_popup=”off” da_exit_intent=”off” da_has_close=”on” da_alt_close=”off” da_dark_close=”off” da_not_modal=”on” da_is_singular=”off” da_with_loader=”off” da_has_shadow=”on” da_disable_devices=”off|off|off”][et_pb_row _builder_version=”4.27.3″ background_color=”transparent” global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_column type=”4_4″ _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_code _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”]<link href=\"https:\/\/fonts.googleapis.com\/css2?family=Inter:wght@400;500;600;700&family=Poppins:wght@700;800&display=swap\" rel=\"stylesheet\"><style>#upl-gako-s3,#upl-gako-s3 *,#upl-gako-s3 *::before,#upl-gako-s3 *::after { margin: 0 !important; padding: 0 !important; box-sizing: border-box !important; border: none !important; outline: none !important; font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif !important; line-height: 1.5 !important; letter-spacing: normal !important; text-transform: none !important; text-decoration: none !important; list-style: none !important;}#upl-gako-s3 { background: transparent !important; padding: 60px 20px !important;}#upl-gako-s3 .s3-container { max-width: 1100px !important; margin: 0 auto !important;}#upl-gako-s3 .s3-badge { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: rgba(59,185,139,0.12) !important; color: #2aaa7e !important; padding: 6px 14px !important; border-radius: 20px !important; font-size: 12px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.5px !important; margin-bottom: 16px !important; width: fit-content !important;}#upl-gako-s3 .s3-badge .s3-dot { width: 7px !important; height: 7px !important; background: #3BB98B !important; border-radius: 50% !important; flex-shrink: 0 !important;}#upl-gako-s3 .s3-h2 { font-family: 'Poppins', sans-serif !important; font-size: 35px !important; font-weight: 700 !important; color: #0f2736 !important; line-height: 1.2 !important; margin-bottom: 16px !important;}#upl-gako-s3 .s3-intro { font-size: 17px !important; color: #383838 !important; line-height: 1.75 !important; margin-bottom: 40px !important;}#upl-gako-s3 .s3-reason-grid { display: grid !important; grid-template-columns: repeat(3, 1fr) !important; gap: 20px !important; margin-bottom: 40px !important;}#upl-gako-s3 .s3-reason-card { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; padding: 24px !important;}#upl-gako-s3 .s3-reason-num { font-family: 'Poppins', sans-serif !important; font-size: 36px !important; font-weight: 800 !important; color: rgba(59,185,139,0.20) !important; line-height: 1 !important; margin-bottom: 12px !important; display: block !important;}#upl-gako-s3 .s3-reason-card h3 { font-family: 'Poppins', sans-serif !important; font-size: 16px !important; font-weight: 700 !important; color: #0f2736 !important; margin-bottom: 10px !important; line-height: 1.35 !important;}#upl-gako-s3 .s3-reason-card p { font-size: 14.5px !important; color: #4a5568 !important; line-height: 1.7 !important;}\/* Deprecation callout *\/#upl-gako-s3 .s3-depr-box { background: rgba(234,67,53,0.06) !important; border: 1px solid rgba(234,67,53,0.20) !important; border-radius: 14px !important; padding: 22px 26px !important; display: flex !important; gap: 16px !important; align-items: flex-start !important; margin-bottom: 40px !important;}#upl-gako-s3 .s3-depr-box svg { width: 22px !important; height: 22px !important; stroke: #ea4335 !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important; flex-shrink: 0 !important; margin-top: 1px !important;}#upl-gako-s3 .s3-depr-label { font-size: 11px !important; font-weight: 700 !important; color: #ea4335 !important; text-transform: uppercase !important; letter-spacing: 0.8px !important; margin-bottom: 6px !important; display: block !important;}#upl-gako-s3 .s3-depr-box p { font-size: 15px !important; color: #383838 !important; line-height: 1.7 !important;}#upl-gako-s3 .s3-depr-box p strong { color: #0f2736 !important; font-weight: 700 !important;}\/* Inline CTA *\/#upl-gako-s3 .s3-cta-strip { background: #0f2736 !important; border-radius: 14px !important; padding: 24px 28px !important; display: flex !important; align-items: center !important; justify-content: space-between !important; gap: 20px !important; flex-wrap: wrap !important;}#upl-gako-s3 .s3-cta-strip p { font-size: 16px !important; color: rgba(255,255,255,0.88) !important; line-height: 1.6 !important;}#upl-gako-s3 .s3-cta-strip p strong { color: #ffffff !important;}#upl-gako-s3 .s3-cta-btn { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: #DDDF4C !important; color: #0f2736 !important; padding: 12px 22px !important; border-radius: 8px !important; font-size: 0.9rem !important; font-weight: 600 !important; border: 2px solid #DDDF4C !important; transition: transform 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important; flex-shrink: 0 !important;}#upl-gako-s3 .s3-cta-btn:hover { transform: translateY(-5px) !important;}#upl-gako-s3 .s3-cta-btn svg { width: 14px !important; height: 14px !important; stroke: currentColor !important; fill: none !important; stroke-width: 2.5 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}@media (max-width: 900px) { #upl-gako-s3 .s3-h2 { font-size: 28px !important; } #upl-gako-s3 .s3-reason-grid { grid-template-columns: 1fr !important; } #upl-gako-s3 { padding: 50px 20px !important; } #upl-gako-s3 .s3-cta-strip { flex-direction: column !important; align-items: flex-start !important; }}@media (max-width: 600px) { #upl-gako-s3 .s3-h2 { font-size: 26px !important; } #upl-gako-s3 .s3-cta-btn { width: 100% !important; justify-content: center !important; }}<\/style><div id=\"upl-gako-s3\"> <div class=\"s3-container\"> <span id=\"why-oauth\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"s3-badge\"><span class=\"s3-dot\"><\/span><span>Architecture<\/span><\/div> <h2 class=\"s3-h2\">Why Gmail Requires OAuth 2.0<\/h2> <pee class=\"s3-intro\">OAuth 2.0 isn’t a bureaucratic hurdle Google invented to slow you down. It’s the only technically sound way to grant scoped, revocable, auditable access to private user data. Gmail’s three core requirements explain why an API key can never substitute.<\/pee> <div class=\"s3-reason-grid\"> <div class=\"s3-reason-card\"> <span class=\"s3-reason-num\">01<\/span> <h3>User consent is non-negotiable<\/h3> <pee>Gmail data belongs to the user, not your application. OAuth 2.0 is the mechanism by which a user explicitly says “yes, this application can read my inbox.” No consent flow = no access. This is a legal requirement under GDPR and a Google platform policy, not just a technical restriction.<\/pee> <\/div> <div class=\"s3-reason-card\"> <span class=\"s3-reason-num\">02<\/span> <h3>Scoped, revocable access<\/h3> <pee>OAuth tokens carry scopes – precise declarations of what the app can and cannot do (read-only, send, full access). Users can see exactly what access they granted and revoke it at any time from their Google Account settings. An API key grants nothing and can revoke nothing at the user level.<\/pee> <\/div> <div class=\"s3-reason-card\"> <span class=\"s3-reason-num\">03<\/span> <h3>Token expiry protects users<\/h3> <pee>Gmail API access tokens expire (typically 1 hour). This means a stolen token is useless after a short window. Your app must silently refresh tokens using a refresh token – which itself can be revoked. API keys, by contrast, are long-lived project credentials with no user-level revocation mechanism.<\/pee> <\/div> <\/div> <div class=\"s3-depr-box\"> <svg viewBox=\"0 0 24 24\"><path d=\"M10.29 3.86L1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z\"\/><line x1=\"12\" y1=\"9\" x2=\"12\" y2=\"13\"\/><line x1=\"12\" y1=\"17\" x2=\"12.01\" y2=\"17\"\/><\/svg> <div> <span class=\"s3-depr-label\">Important: Basic Auth deprecated September 2024<\/span> <pee>Google deprecated username\/password authentication (“Basic Auth”) for Gmail in <strong>September 2024<\/strong>. If you have any legacy integration using stored credentials directly, it has stopped working. OAuth 2.0 is the only remaining authentication mechanism for Gmail API – both for new integrations and migrated ones. <a href=\"https:\/\/support.google.com\/a\/answer\/162106\" target=\"_blank\" rel=\"noopener\" style=\"color:#2aaa7e!important;text-decoration:underline!important;\">See Google’s official announcement<\/a>.<\/pee> <\/div> <\/div> <div class=\"s3-cta-strip\"> <pee><strong>Need to handle OAuth for multiple Gmail accounts in your SaaS?<\/strong> Unipile manages the consent screen, token exchange, and silent refresh for every linked account – so your code never touches a token.<\/pee> <span class=\"s3-cta-btn\" data-upl-link=\"https:\/\/dashboard.unipile.com\/signup\/\" data-upl-target=\"_blank\"><span>Build it with Unipile<\/span><svg viewBox=\"0 0 24 24\"><line x1=\"5\" y1=\"12\" x2=\"19\" y2=\"12\"\/><polyline points=\"12 5 19 12 12 19\"\/><\/svg><\/span> <\/div> <\/div><\/div><script>(function(){ function init(){ var el = document.getElementById('upl-gako-s3'); if (!el) return; el.addEventListener('click', function(e){ var t = e.target.closest('[data-upl-link]'); if (!t) return; var url = t.getAttribute('data-upl-link'); var target = t.getAttribute('data-upl-target') || '_self'; if (url) window.open(url, target); }); } if (document.readyState === 'loading') { document.addEventListener('DOMContentLoaded', init); } else { init(); }})();<\/script>[\/et_pb_code][\/et_pb_column][\/et_pb_row][\/et_pb_section][et_pb_section fb_built=”1″ _builder_version=”4.27.3″ background_color=”transparent” custom_padding=”0px|0px|0px|0px|false|false” global_colors_info=”{}” theme_builder_area=”post_content” da_is_popup=”off” da_exit_intent=”off” da_has_close=”on” da_alt_close=”off” da_dark_close=”off” da_not_modal=”on” da_is_singular=”off” da_with_loader=”off” da_has_shadow=”on” da_disable_devices=”off|off|off”][et_pb_row _builder_version=”4.27.3″ background_color=”transparent” global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_column type=”4_4″ _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_code _builder_version=”4.27.4″ hover_enabled=”0″ global_colors_info=”{}” theme_builder_area=”post_content” sticky_enabled=”0″]<!DOCTYPE html><html lang=\"en\"><head><meta charset=\"UTF-8\"><meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\"><title>Unipile – Gmail Auth Comparison<\/title><link href=\"https:\/\/fonts.googleapis.com\/css2?family=Inter:wght@400;500;600;700&family=Poppins:wght@700;800&display=swap\" rel=\"stylesheet\"><style>body { background: #f4f5f7; margin: 0; }#upl-gako-s4,#upl-gako-s4 *,#upl-gako-s4 *::before,#upl-gako-s4 *::after { margin: 0 !important; padding: 0 !important; box-sizing: border-box !important; border: none !important; outline: none !important; font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif !important; line-height: 1.5 !important; letter-spacing: normal !important; text-transform: none !important; text-decoration: none !important; list-style: none !important;}#upl-gako-s4 { background: #f4f5f7 !important; padding: 60px 20px !important;}#upl-gako-s4 .s4-container { max-width: 1100px !important; margin: 0 auto !important;}#upl-gako-s4 .s4-badge { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: rgba(59,185,139,0.12) !important; color: #2aaa7e !important; padding: 6px 14px !important; border-radius: 20px !important; font-size: 12px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.5px !important; margin-bottom: 16px !important; width: fit-content !important;}#upl-gako-s4 .s4-badge .s4-dot { width: 7px !important; height: 7px !important; background: #3BB98B !important; border-radius: 50% !important; flex-shrink: 0 !important;}#upl-gako-s4 .s4-h2 { font-family: 'Poppins', sans-serif !important; font-size: 35px !important; font-weight: 700 !important; color: #0f2736 !important; line-height: 1.2 !important; margin-bottom: 16px !important;}#upl-gako-s4 .s4-intro { font-size: 17px !important; color: #383838 !important; line-height: 1.75 !important; margin-bottom: 36px !important;}\/* Comparison table *\/#upl-gako-s4 .s4-table-wrap { overflow-x: auto !important; border-radius: 16px !important; border: 1px solid #e5e7eb !important; background: #ffffff !important; margin-bottom: 28px !important;}#upl-gako-s4 table { width: 100% !important; border-collapse: collapse !important;}#upl-gako-s4 thead tr { background: #0f2736 !important;}#upl-gako-s4 thead th { padding: 16px 20px !important; font-family: 'Poppins', sans-serif !important; font-size: 13px !important; font-weight: 700 !important; color: #ffffff !important; text-align: left !important; white-space: nowrap !important;}#upl-gako-s4 thead th:first-child { border-radius: 15px 0 0 0 !important;}#upl-gako-s4 thead th:last-child { border-radius: 0 15px 0 0 !important;}#upl-gako-s4 thead th.col-highlight { background: #3BB98B !important;}#upl-gako-s4 tbody tr { border-bottom: 1px solid #f0f1f3 !important;}#upl-gako-s4 tbody tr:last-child { border-bottom: none !important;}#upl-gako-s4 tbody tr:nth-child(even) td { background: #f8fafc !important;}#upl-gako-s4 tbody tr:nth-child(even) td.col-highlight { background: rgba(59,185,139,0.06) !important;}#upl-gako-s4 tbody td { padding: 14px 20px !important; font-size: 14px !important; color: #383838 !important; vertical-align: top !important;}#upl-gako-s4 tbody td.col-highlight { background: rgba(59,185,139,0.04) !important;}#upl-gako-s4 tbody td.row-label { font-weight: 600 !important; color: #0f2736 !important; font-size: 13.5px !important; white-space: nowrap !important;}#upl-gako-s4 .ok-icon { display: inline-flex !important; align-items: center !important; gap: 6px !important; color: #2aaa7e !important; font-size: 13px !important; font-weight: 600 !important;}#upl-gako-s4 .ok-icon svg { width: 14px !important; height: 14px !important; stroke: #3BB98B !important; fill: none !important; stroke-width: 2.5 !important; stroke-linecap: round !important; stroke-linejoin: round !important; flex-shrink: 0 !important;}#upl-gako-s4 .no-icon { display: inline-flex !important; align-items: center !important; gap: 6px !important; color: #ef4444 !important; font-size: 13px !important; font-weight: 600 !important;}#upl-gako-s4 .no-icon svg { width: 14px !important; height: 14px !important; stroke: #ef4444 !important; fill: none !important; stroke-width: 2.5 !important; stroke-linecap: round !important; stroke-linejoin: round !important; flex-shrink: 0 !important;}#upl-gako-s4 .partial-icon { display: inline-flex !important; align-items: center !important; gap: 6px !important; color: #f59e0b !important; font-size: 13px !important; font-weight: 600 !important;}#upl-gako-s4 .partial-icon svg { width: 14px !important; height: 14px !important; stroke: #f59e0b !important; fill: none !important; stroke-width: 2.5 !important; stroke-linecap: round !important; stroke-linejoin: round !important; flex-shrink: 0 !important;}#upl-gako-s4 .s4-note { font-size: 13px !important; color: #94a3b8 !important; margin-top: 4px !important; line-height: 1.5 !important;}\/* ===== MOBILE CARDS (hidden on desktop) ===== *\/#upl-gako-s4 .s4-cards { display: none !important;}#upl-gako-s4 .s4-card { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; overflow: hidden !important; margin-bottom: 16px !important;}#upl-gako-s4 .s4-card:last-child { margin-bottom: 0 !important;}#upl-gako-s4 .s4-card-head { background: #0f2736 !important; padding: 16px 18px !important;}#upl-gako-s4 .s4-card.is-highlight .s4-card-head { background: #3BB98B !important;}#upl-gako-s4 .s4-card-title { font-family: 'Poppins', sans-serif !important; font-size: 15px !important; font-weight: 700 !important; color: #ffffff !important; line-height: 1.35 !important;}#upl-gako-s4 .s4-card-tag { display: inline-block !important; margin-top: 6px !important; font-size: 10px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.5px !important; color: #ffffff !important; background: rgba(255,255,255,0.18) !important; padding: 3px 8px !important; border-radius: 5px !important;}#upl-gako-s4 .s4-card-row { padding: 13px 18px !important; border-bottom: 1px solid #f0f1f3 !important;}#upl-gako-s4 .s4-card.is-highlight .s4-card-row { background: rgba(59,185,139,0.04) !important;}#upl-gako-s4 .s4-card-row:last-child { border-bottom: none !important;}#upl-gako-s4 .s4-card-label { font-size: 12px !important; font-weight: 600 !important; color: #94a3b8 !important; text-transform: uppercase !important; letter-spacing: 0.3px !important; margin-bottom: 5px !important; display: block !important;}#upl-gako-s4 .s4-card-value { font-size: 14px !important; color: #383838 !important; line-height: 1.55 !important;}@media (max-width: 900px) { #upl-gako-s4 .s4-h2 { font-size: 28px !important; } #upl-gako-s4 { padding: 50px 20px !important; }}@media (max-width: 600px) { #upl-gako-s4 { padding: 50px 16px !important; } #upl-gako-s4 .s4-h2 { font-size: 26px !important; } #upl-gako-s4 .s4-intro { font-size: 15.5px !important; } \/* Switch table -> cards *\/ #upl-gako-s4 .s4-table-wrap { display: none !important; } #upl-gako-s4 .s4-cards { display: block !important; }}@media (max-width: 400px) { #upl-gako-s4 .s4-h2 { font-size: 22px !important; }}<\/style><div id=\"upl-gako-s4\"> <div class=\"s4-container\"> <span id=\"three-paths\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"s4-badge\"><span class=\"s4-dot\"><\/span><span>Comparison<\/span><\/div> <h2 class=\"s4-h2\">The 3 Real Authentication Paths for Gmail API<\/h2> <pee class=\"s4-intro\">Once you’ve accepted that OAuth is unavoidable, the question becomes: which OAuth path fits your use case? There are three architecturally distinct options – each with different tradeoffs on complexity, user scope, and maintenance overhead.<\/pee>  <div class=\"s4-table-wrap\"> <table> <thead> <tr> <th>Criterion<\/th> <th>OAuth 2.0 Client ID (3-legged)<\/th> <th>Service Account + DWD<\/th> <th class=\"col-highlight\">Unified API (Unipile)<\/th> <\/tr> <\/thead> <tbody> <tr> <td class=\"row-label\">User consent required?<\/td> <td><span class=\"ok-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Yes – per user<\/span><\/span><\/td> <td><span class=\"no-icon\"><svg viewBox=\"0 0 24 24\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"\/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"\/><\/svg><span>No (admin delegates)<\/span><\/span><\/td> <td class=\"col-highlight\"><span class=\"ok-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Yes – via Unipile UI<\/span><\/span><\/td> <\/tr> <tr> <td class=\"row-label\">Works with personal Gmail?<\/td> <td><span class=\"ok-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Yes<\/span><\/span><\/td> <td><span class=\"no-icon\"><svg viewBox=\"0 0 24 24\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"\/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"\/><\/svg><span>No (Workspace only)<\/span><\/span><\/td> <td class=\"col-highlight\"><span class=\"ok-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Yes<\/span><\/span><\/td> <\/tr> <tr> <td class=\"row-label\">Multi-tenant SaaS?<\/td> <td><span class=\"ok-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Yes<\/span><\/span><\/td> <td><span class=\"no-icon\"><svg viewBox=\"0 0 24 24\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"\/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"\/><\/svg><span>Same Workspace only<\/span><\/span><\/td> <td class=\"col-highlight\"><span class=\"ok-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Yes, built for it<\/span><\/span><\/td> <\/tr> <tr> <td class=\"row-label\">Token management<\/td> <td>Your code stores + refreshes tokens<div class=\"s4-note\">High maintenance<\/div><\/td> <td>Service account JSON key<div class=\"s4-note\">Admin-managed<\/div><\/td> <td class=\"col-highlight\">Unipile handles all tokens<div class=\"s4-note\">Zero maintenance<\/div><\/td> <\/tr> <tr> <td class=\"row-label\">Google consent screen review?<\/td> <td><span class=\"ok-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Required (sensitive scopes)<\/span><\/span><\/td> <td><span class=\"partial-icon\"><svg viewBox=\"0 0 24 24\"><line x1=\"12\" y1=\"2\" x2=\"12\" y2=\"22\"\/><path d=\"M17 5H9.5a3.5 3.5 0 0 0 0 7h5a3.5 3.5 0 0 1 0 7H6\"\/><\/svg><span>Admin config only<\/span><\/span><\/td> <td class=\"col-highlight\"><span class=\"no-icon\"><svg viewBox=\"0 0 24 24\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"\/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"\/><\/svg><span>Not required<\/span><\/span><\/td> <\/tr> <tr> <td class=\"row-label\">Also supports Outlook + IMAP?<\/td> <td><span class=\"no-icon\"><svg viewBox=\"0 0 24 24\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"\/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"\/><\/svg><span>Gmail only<\/span><\/span><\/td> <td><span class=\"no-icon\"><svg viewBox=\"0 0 24 24\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"\/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"\/><\/svg><span>Gmail\/Workspace only<\/span><\/span><\/td> <td class=\"col-highlight\"><span class=\"ok-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Gmail, Outlook, IMAP<\/span><\/span><\/td> <\/tr> <tr> <td class=\"row-label\">Time to first email read<\/td> <td>2-4 hours setup<div class=\"s4-note\">OAuth app + scopes + consent screen<\/div><\/td> <td>1-2 hours setup<div class=\"s4-note\">Workspace admin required<\/div><\/td> <td class=\"col-highlight\">Under 15 minutes<div class=\"s4-note\">API key + linked account<\/div><\/td> <\/tr> <tr> <td class=\"row-label\">Best for<\/td> <td>SaaS apps connecting external users’ Gmail<\/td> <td>Internal Workspace tooling for your org<\/td> <td class=\"col-highlight\">Any email API use case – no OAuth ops<\/td> <\/tr> <\/tbody> <\/table> <\/div>  <div class=\"s4-cards\">  <div class=\"s4-card\"> <div class=\"s4-card-head\"> <div class=\"s4-card-title\">OAuth 2.0 Client ID (3-legged)<\/div> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">User consent required?<\/span> <span class=\"s4-card-value\"><span class=\"ok-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Yes – per user<\/span><\/span><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Works with personal Gmail?<\/span> <span class=\"s4-card-value\"><span class=\"ok-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Yes<\/span><\/span><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Multi-tenant SaaS?<\/span> <span class=\"s4-card-value\"><span class=\"ok-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Yes<\/span><\/span><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Token management<\/span> <span class=\"s4-card-value\">Your code stores + refreshes tokens<div class=\"s4-note\">High maintenance<\/div><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Google consent screen review?<\/span> <span class=\"s4-card-value\"><span class=\"ok-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Required (sensitive scopes)<\/span><\/span><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Also supports Outlook + IMAP?<\/span> <span class=\"s4-card-value\"><span class=\"no-icon\"><svg viewBox=\"0 0 24 24\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"\/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"\/><\/svg><span>Gmail only<\/span><\/span><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Time to first email read<\/span> <span class=\"s4-card-value\">2-4 hours setup<div class=\"s4-note\">OAuth app + scopes + consent screen<\/div><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Best for<\/span> <span class=\"s4-card-value\">SaaS apps connecting external users’ Gmail<\/span> <\/div> <\/div>  <div class=\"s4-card\"> <div class=\"s4-card-head\"> <div class=\"s4-card-title\">Service Account + DWD<\/div> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">User consent required?<\/span> <span class=\"s4-card-value\"><span class=\"no-icon\"><svg viewBox=\"0 0 24 24\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"\/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"\/><\/svg><span>No (admin delegates)<\/span><\/span><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Works with personal Gmail?<\/span> <span class=\"s4-card-value\"><span class=\"no-icon\"><svg viewBox=\"0 0 24 24\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"\/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"\/><\/svg><span>No (Workspace only)<\/span><\/span><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Multi-tenant SaaS?<\/span> <span class=\"s4-card-value\"><span class=\"no-icon\"><svg viewBox=\"0 0 24 24\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"\/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"\/><\/svg><span>Same Workspace only<\/span><\/span><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Token management<\/span> <span class=\"s4-card-value\">Service account JSON key<div class=\"s4-note\">Admin-managed<\/div><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Google consent screen review?<\/span> <span class=\"s4-card-value\"><span class=\"partial-icon\"><svg viewBox=\"0 0 24 24\"><line x1=\"12\" y1=\"2\" x2=\"12\" y2=\"22\"\/><path d=\"M17 5H9.5a3.5 3.5 0 0 0 0 7h5a3.5 3.5 0 0 1 0 7H6\"\/><\/svg><span>Admin config only<\/span><\/span><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Also supports Outlook + IMAP?<\/span> <span class=\"s4-card-value\"><span class=\"no-icon\"><svg viewBox=\"0 0 24 24\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"\/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"\/><\/svg><span>Gmail\/Workspace only<\/span><\/span><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Time to first email read<\/span> <span class=\"s4-card-value\">1-2 hours setup<div class=\"s4-note\">Workspace admin required<\/div><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Best for<\/span> <span class=\"s4-card-value\">Internal Workspace tooling for your org<\/span> <\/div> <\/div>  <div class=\"s4-card is-highlight\"> <div class=\"s4-card-head\"> <div class=\"s4-card-title\">Unified API (Unipile)<\/div> <span class=\"s4-card-tag\">Recommended<\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">User consent required?<\/span> <span class=\"s4-card-value\"><span class=\"ok-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Yes – via Unipile UI<\/span><\/span><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Works with personal Gmail?<\/span> <span class=\"s4-card-value\"><span class=\"ok-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Yes<\/span><\/span><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Multi-tenant SaaS?<\/span> <span class=\"s4-card-value\"><span class=\"ok-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Yes, built for it<\/span><\/span><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Token management<\/span> <span class=\"s4-card-value\">Unipile handles all tokens<div class=\"s4-note\">Zero maintenance<\/div><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Google consent screen review?<\/span> <span class=\"s4-card-value\"><span class=\"no-icon\"><svg viewBox=\"0 0 24 24\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"\/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"\/><\/svg><span>Not required<\/span><\/span><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Also supports Outlook + IMAP?<\/span> <span class=\"s4-card-value\"><span class=\"ok-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Gmail, Outlook, IMAP<\/span><\/span><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Time to first email read<\/span> <span class=\"s4-card-value\">Under 15 minutes<div class=\"s4-note\">API key + linked account<\/div><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Best for<\/span> <span class=\"s4-card-value\">Any email API use case – no OAuth ops<\/span> <\/div> <\/div> <\/div> <\/div><\/div><\/body><\/html>[\/et_pb_code][\/et_pb_column][\/et_pb_row][\/et_pb_section][et_pb_section fb_built=”1″ _builder_version=”4.27.3″ background_color=”transparent” custom_padding=”0px|0px|0px|0px|false|false” global_colors_info=”{}” theme_builder_area=”post_content” da_is_popup=”off” da_exit_intent=”off” da_has_close=”on” da_alt_close=”off” da_dark_close=”off” da_not_modal=”on” da_is_singular=”off” da_with_loader=”off” da_has_shadow=”on” da_disable_devices=”off|off|off”][et_pb_row _builder_version=”4.27.3″ background_color=”transparent” global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_column type=”4_4″ _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_code _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”]<link href=\"https:\/\/fonts.googleapis.com\/css2?family=Inter:wght@400;500;600;700&family=Poppins:wght@700;800&display=swap\" rel=\"stylesheet\"><style>#upl-gako-s5,#upl-gako-s5 *,#upl-gako-s5 *::before,#upl-gako-s5 *::after { margin: 0 !important; padding: 0 !important; box-sizing: border-box !important; border: none !important; outline: none !important; font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif !important; line-height: 1.5 !important; letter-spacing: normal !important; text-transform: none !important; text-decoration: none !important; list-style: none !important;}#upl-gako-s5 { background: transparent !important; padding: 60px 20px !important;}#upl-gako-s5 .s5-container { max-width: 1100px !important; margin: 0 auto !important;}#upl-gako-s5 .s5-badge { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: rgba(221,223,76,0.18) !important; color: #8a8c2e !important; padding: 6px 14px !important; border-radius: 20px !important; font-size: 12px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.5px !important; margin-bottom: 16px !important; width: fit-content !important;}#upl-gako-s5 .s5-badge .s5-dot { width: 7px !important; height: 7px !important; background: #DDDF4C !important; border-radius: 50% !important; flex-shrink: 0 !important;}#upl-gako-s5 .s5-h2 { font-family: 'Poppins', sans-serif !important; font-size: 35px !important; font-weight: 700 !important; color: #0f2736 !important; line-height: 1.2 !important; margin-bottom: 16px !important;}#upl-gako-s5 .s5-intro { font-size: 17px !important; color: #383838 !important; line-height: 1.75 !important; margin-bottom: 36px !important;}\/* Steps *\/#upl-gako-s5 .s5-steps { display: flex !important; flex-direction: column !important; gap: 16px !important; margin-bottom: 36px !important;}#upl-gako-s5 .s5-step { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 14px !important; padding: 20px 24px !important; display: flex !important; gap: 16px !important; align-items: flex-start !important;}#upl-gako-s5 .s5-step-num { width: 36px !important; height: 36px !important; min-width: 36px !important; background: rgba(221,223,76,0.18) !important; border-radius: 10px !important; display: flex !important; align-items: center !important; justify-content: center !important; font-family: 'Poppins', sans-serif !important; font-size: 14px !important; font-weight: 800 !important; color: #8a8c2e !important;}#upl-gako-s5 .s5-step h3 { font-family: 'Poppins', sans-serif !important; font-size: 15px !important; font-weight: 700 !important; color: #0f2736 !important; margin-bottom: 6px !important; line-height: 1.35 !important;}#upl-gako-s5 .s5-step p { font-size: 14.5px !important; color: #4a5568 !important; line-height: 1.65 !important;}#upl-gako-s5 .s5-step p a { color: #2aaa7e !important; text-decoration: underline !important;}\/* Code block *\/#upl-gako-s5 .s5-code-wrap { border-radius: 14px !important; overflow: hidden !important; background: #0d1117 !important; margin-bottom: 28px !important;}#upl-gako-s5 .s5-editor-bar { background: #161b22 !important; padding: 12px 18px !important; display: flex !important; align-items: center !important; gap: 8px !important; border-bottom: 1px solid rgba(255,255,255,0.06) !important;}#upl-gako-s5 .s5-dot-r { width: 10px !important; height: 10px !important; border-radius: 50% !important; background: #ff5f57 !important; flex-shrink: 0 !important; }#upl-gako-s5 .s5-dot-y { width: 10px !important; height: 10px !important; border-radius: 50% !important; background: #febc2e !important; flex-shrink: 0 !important; }#upl-gako-s5 .s5-dot-g { width: 10px !important; height: 10px !important; border-radius: 50% !important; background: #28c840 !important; flex-shrink: 0 !important; }#upl-gako-s5 .s5-file { color: #8b949e !important; font-size: 12px !important; font-family: 'Courier New', monospace !important; margin-left: 4px !important; }#upl-gako-s5 .s5-pre { padding: 22px 24px !important; font-size: 13px !important; line-height: 1.8 !important; overflow-x: auto !important; background: #0d1117 !important;}#upl-gako-s5 .s5-pre code { font-family: 'Courier New', monospace !important; white-space: pre !important; display: block !important;}#upl-gako-s5 .c { color: #8b949e !important; }#upl-gako-s5 .k { color: #ff7b72 !important; }#upl-gako-s5 .fn { color: #d2a8ff !important; }#upl-gako-s5 .s { color: #a5d6ff !important; }#upl-gako-s5 .n { color: #79c0ff !important; }#upl-gako-s5 .w { color: #e6edf3 !important; }\/* inline CTA *\/#upl-gako-s5 .s5-inline-cta { background: rgba(59,185,139,0.08) !important; border: 1px solid rgba(59,185,139,0.25) !important; border-radius: 12px !important; padding: 18px 22px !important; display: flex !important; align-items: center !important; justify-content: space-between !important; gap: 16px !important; flex-wrap: wrap !important;}#upl-gako-s5 .s5-inline-cta p { font-size: 15px !important; color: #383838 !important; line-height: 1.6 !important;}#upl-gako-s5 .s5-inline-cta p strong { color: #0f2736 !important;}#upl-gako-s5 .s5-inline-cta-btn { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: #DDDF4C !important; color: #0f2736 !important; padding: 10px 20px !important; border-radius: 8px !important; font-size: 0.88rem !important; font-weight: 600 !important; border: 2px solid #DDDF4C !important; transition: transform 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important; flex-shrink: 0 !important;}#upl-gako-s5 .s5-inline-cta-btn:hover { transform: translateY(-5px) !important;}#upl-gako-s5 .s5-inline-cta-btn svg { width: 13px !important; height: 13px !important; stroke: currentColor !important; fill: none !important; stroke-width: 2.5 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}@media (max-width: 900px) { #upl-gako-s5 .s5-h2 { font-size: 28px !important; } #upl-gako-s5 { padding: 50px 20px !important; } #upl-gako-s5 .s5-inline-cta { flex-direction: column !important; align-items: flex-start !important; }}@media (max-width: 600px) { #upl-gako-s5 .s5-h2 { font-size: 26px !important; } #upl-gako-s5 .s5-inline-cta-btn { width: 100% !important; justify-content: center !important; }}<\/style><div id=\"upl-gako-s5\"> <div class=\"s5-container\"> <span id=\"path-oauth-client\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"s5-badge\"><span class=\"s5-dot\"><\/span><span>Path 1 of 3<\/span><\/div> <h2 class=\"s5-h2\">Path 1 – OAuth 2.0 Client ID (Multi-Tenant SaaS)<\/h2> <pee class=\"s5-intro\">If you’re building a SaaS product where your customers connect their own Gmail accounts, the OAuth 2.0 authorization code flow is the standard path. This is the 3-legged flow: your app, Google, and the end user. It requires setting up a Google Cloud project and going through the consent screen verification process for sensitive scopes. For a deep dive into the <a href=\"https:\/\/www.unipile.com\/oauth-email-api\/\" style=\"color:#2aaa7e!important;text-decoration:underline!important;\">OAuth flow for email APIs in detail<\/a>, see our dedicated guide.<\/pee> <div class=\"s5-steps\"> <div class=\"s5-step\"> <div class=\"s5-step-num\">01<\/div> <div> <h3>Create OAuth 2.0 credentials in Google Cloud Console<\/h3> <pee>Go to APIs & Services > Credentials > Create Credentials > OAuth client ID. Choose “Web application”. Configure the authorized redirect URIs for your app. This generates your <code>client_id<\/code> and <code>client_secret<\/code>.<\/pee> <\/div> <\/div> <div class=\"s5-step\"> <div class=\"s5-step-num\">02<\/div> <div> <h3>Enable the Gmail API and declare your scopes<\/h3> <pee>Go to APIs & Services > OAuth consent screen. Add the Gmail scopes you need (e.g. <code>gmail.readonly<\/code>, <code>gmail.send<\/code>). Sensitive and restricted scopes require Google verification – a process that takes days to weeks.<\/pee> <\/div> <\/div> <div class=\"s5-step\"> <div class=\"s5-step-num\">03<\/div> <div> <h3>Redirect users to Google’s authorization URL<\/h3> <pee>When a user clicks “Connect Gmail” in your app, redirect them to Google with your <code>client_id<\/code>, scopes, and <code>redirect_uri<\/code>. After they approve, Google sends back an authorization code to your redirect URI.<\/pee> <\/div> <\/div> <div class=\"s5-step\"> <div class=\"s5-step-num\">04<\/div> <div> <h3>Exchange the code for tokens and store the refresh token<\/h3> <pee>POST the authorization code to Google’s token endpoint. You receive an <code>access_token<\/code> (expires ~1h) and a <code>refresh_token<\/code> (long-lived). Store the refresh token securely – it’s how you get new access tokens without re-prompting the user.<\/pee> <\/div> <\/div> <\/div> <div class=\"s5-code-wrap\"> <div class=\"s5-editor-bar\"> <span class=\"s5-dot-r\"><\/span><span class=\"s5-dot-y\"><\/span><span class=\"s5-dot-g\"><\/span> <span class=\"s5-file\">gmail-oauth-flow.js<\/span> <\/div> <div class=\"s5-pre\"><code><span class=\"k\">const<\/span> <span class=\"w\">{ google } <\/span><span class=\"k\">=<\/span> <span class=\"fn\">require<\/span><span class=\"w\">(<\/span><span class=\"s\">'googleapis'<\/span><span class=\"w\">);<\/span><span class=\"k\">const<\/span> <span class=\"w\">oauth2Client <\/span><span class=\"k\">=<\/span> <span class=\"k\">new<\/span> <span class=\"w\">google.auth.<\/span><span class=\"fn\">OAuth2<\/span><span class=\"w\">(<\/span> <span class=\"w\">process.env.GMAIL_CLIENT_ID,<\/span> <span class=\"w\">process.env.GMAIL_CLIENT_SECRET,<\/span> <span class=\"w\">process.env.GMAIL_REDIRECT_URI<\/span><span class=\"w\">);<\/span><span class=\"c\">\/\/ Step 1: Build the authorization URL<\/span><span class=\"k\">const<\/span> <span class=\"w\">authUrl <\/span><span class=\"k\">=<\/span> <span class=\"w\">oauth2Client.<\/span><span class=\"fn\">generateAuthUrl<\/span><span class=\"w\">({<\/span> <span class=\"w\">access_type:<\/span> <span class=\"s\">'offline'<\/span><span class=\"w\">,<\/span> <span class=\"c\">\/\/ get refresh token<\/span> <span class=\"w\">scope: [<\/span> <span class=\"s\">'https:\/\/www.googleapis.com\/auth\/gmail.readonly'<\/span><span class=\"w\">,<\/span> <span class=\"s\">'https:\/\/www.googleapis.com\/auth\/gmail.send'<\/span> <span class=\"w\">]<\/span><span class=\"w\">});<\/span><span class=\"c\">\/\/ Step 2: Exchange code for tokens (in your callback handler)<\/span><span class=\"k\">async function<\/span> <span class=\"fn\">handleCallback<\/span><span class=\"w\">(code) {<\/span> <span class=\"k\">const<\/span> <span class=\"w\">{ tokens } <\/span><span class=\"k\">=<\/span> <span class=\"k\">await<\/span> <span class=\"w\">oauth2Client.<\/span><span class=\"fn\">getToken<\/span><span class=\"w\">(code);<\/span> <span class=\"w\">oauth2Client.<\/span><span class=\"fn\">setCredentials<\/span><span class=\"w\">(tokens);<\/span> <span class=\"c\">\/\/ Store tokens.refresh_token securely in your DB<\/span> <span class=\"k\">return<\/span> <span class=\"w\">tokens;<\/span><span class=\"w\">}<\/span><span class=\"c\">\/\/ Step 3: Use the access token to call Gmail API<\/span><span class=\"k\">async function<\/span> <span class=\"fn\">listMessages<\/span><span class=\"w\">(accessToken) {<\/span> <span class=\"k\">const<\/span> <span class=\"w\">gmail <\/span><span class=\"k\">=<\/span> <span class=\"w\">google.<\/span><span class=\"fn\">gmail<\/span><span class=\"w\">({ version:<\/span> <span class=\"s\">'v1'<\/span><span class=\"w\">, auth: oauth2Client });<\/span> <span class=\"k\">const<\/span> <span class=\"w\">res <\/span><span class=\"k\">=<\/span> <span class=\"k\">await<\/span> <span class=\"w\">gmail.users.messages.<\/span><span class=\"fn\">list<\/span><span class=\"w\">({ userId:<\/span> <span class=\"s\">'me'<\/span> <span class=\"w\">});<\/span> <span class=\"k\">return<\/span> <span class=\"w\">res.data.messages;<\/span><span class=\"w\">}<\/span><\/code><\/div> <\/div> <div class=\"s5-inline-cta\"> <pee><strong>Maintaining refresh tokens at scale is the #1 pain point<\/strong> in self-managed Gmail OAuth. Token rotation, database migrations, silent failures on expired tokens – all of this is handled automatically when you use a <a href=\"https:\/\/www.unipile.com\/email-api-providers\/\" style=\"color:#2aaa7e!important;text-decoration:underline!important;\">unified email API provider<\/a>.<\/pee> <span class=\"s5-inline-cta-btn\" data-upl-link=\"https:\/\/dashboard.unipile.com\/signup\/\" data-upl-target=\"_blank\"><span>Build your Gmail integration<\/span><svg viewBox=\"0 0 24 24\"><line x1=\"5\" y1=\"12\" x2=\"19\" y2=\"12\"\/><polyline points=\"12 5 19 12 12 19\"\/><\/svg><\/span> <\/div> <\/div><\/div><script>(function(){ function init(){ var el = document.getElementById('upl-gako-s5'); if (!el) return; el.addEventListener('click', function(e){ var t = e.target.closest('[data-upl-link]'); if (!t) return; var url = t.getAttribute('data-upl-link'); var target = t.getAttribute('data-upl-target') || '_self'; if (url) window.open(url, target); }); } if (document.readyState === 'loading') { document.addEventListener('DOMContentLoaded', init); } else { init(); }})();<\/script>[\/et_pb_code][\/et_pb_column][\/et_pb_row][\/et_pb_section][et_pb_section fb_built=”1″ _builder_version=”4.27.3″ background_color=”transparent” custom_padding=”0px|0px|0px|0px|false|false” global_colors_info=”{}” theme_builder_area=”post_content” da_is_popup=”off” da_exit_intent=”off” da_has_close=”on” da_alt_close=”off” da_dark_close=”off” da_not_modal=”on” da_is_singular=”off” da_with_loader=”off” da_has_shadow=”on” da_disable_devices=”off|off|off”][et_pb_row _builder_version=”4.27.3″ background_color=”transparent” global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_column type=”4_4″ _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_code _builder_version=”4.27.4″ hover_enabled=”0″ global_colors_info=”{}” theme_builder_area=”post_content” sticky_enabled=”0″]<!DOCTYPE html><html lang=\"en\"><head><meta charset=\"UTF-8\"><meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\"><title>Unipile – Path 2 Service Account<\/title><link href=\"https:\/\/fonts.googleapis.com\/css2?family=Inter:wght@400;500;600;700&family=Poppins:wght@700;800&display=swap\" rel=\"stylesheet\"><style>body { background: #f4f5f7; margin: 0; }#upl-gako-s6,#upl-gako-s6 *,#upl-gako-s6 *::before,#upl-gako-s6 *::after { margin: 0 !important; padding: 0 !important; box-sizing: border-box !important; border: none !important; outline: none !important; font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif !important; line-height: 1.5 !important; letter-spacing: normal !important; text-transform: none !important; text-decoration: none !important; list-style: none !important;}#upl-gako-s6 { background: #f4f5f7 !important; padding: 60px 20px !important; overflow: hidden !important;}#upl-gako-s6 .s6-container { max-width: 1100px !important; width: 100% !important; margin: 0 auto !important;}#upl-gako-s6 .s6-badge { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: rgba(221,223,76,0.18) !important; color: #8a8c2e !important; padding: 6px 14px !important; border-radius: 20px !important; font-size: 12px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.5px !important; margin-bottom: 16px !important; width: fit-content !important;}#upl-gako-s6 .s6-badge .s6-dot { width: 7px !important; height: 7px !important; background: #DDDF4C !important; border-radius: 50% !important; flex-shrink: 0 !important;}#upl-gako-s6 .s6-h2 { font-family: 'Poppins', sans-serif !important; font-size: 35px !important; font-weight: 700 !important; color: #0f2736 !important; line-height: 1.2 !important; margin-bottom: 16px !important;}#upl-gako-s6 .s6-intro { font-size: 17px !important; color: #383838 !important; line-height: 1.75 !important; margin-bottom: 36px !important;}#upl-gako-s6 .s6-layout { display: grid !important; grid-template-columns: 1fr 1fr !important; gap: 28px !important; margin-bottom: 36px !important; align-items: start !important;}\/* Empeche les colonnes Grid de deborder a cause du contenu non-cassable (code en white-space: pre) *\/#upl-gako-s6 .s6-layout > div { min-width: 0 !important;}#upl-gako-s6 .s6-warning-box { background: rgba(234,67,53,0.06) !important; border: 1px solid rgba(234,67,53,0.20) !important; border-radius: 14px !important; padding: 20px 22px !important; margin-bottom: 24px !important;}#upl-gako-s6 .s6-warning-label { display: flex !important; align-items: center !important; gap: 8px !important; font-size: 12px !important; font-weight: 700 !important; color: #ea4335 !important; text-transform: uppercase !important; letter-spacing: 0.8px !important; margin-bottom: 10px !important;}#upl-gako-s6 .s6-warning-label svg { width: 16px !important; height: 16px !important; stroke: #ea4335 !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important; flex-shrink: 0 !important;}#upl-gako-s6 .s6-warning-box p { font-size: 14.5px !important; color: #383838 !important; line-height: 1.65 !important;}#upl-gako-s6 .s6-warning-box p strong { color: #0f2736 !important; font-weight: 700 !important;}#upl-gako-s6 .s6-limit-list { display: flex !important; flex-direction: column !important; gap: 10px !important;}#upl-gako-s6 .s6-limit-item { display: flex !important; align-items: flex-start !important; gap: 10px !important; padding: 12px 16px !important; background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 10px !important;}#upl-gako-s6 .s6-limit-item svg { width: 16px !important; height: 16px !important; stroke: #f59e0b !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important; flex-shrink: 0 !important; margin-top: 2px !important;}#upl-gako-s6 .s6-limit-item p { font-size: 14px !important; color: #383838 !important; line-height: 1.6 !important;}#upl-gako-s6 .s6-limit-item p strong { color: #0f2736 !important; font-weight: 600 !important;}\/* Code block *\/#upl-gako-s6 .s6-code-wrap { border-radius: 14px !important; overflow: hidden !important; background: #0d1117 !important; max-width: 100% !important;}#upl-gako-s6 .s6-editor-bar { background: #161b22 !important; padding: 12px 18px !important; display: flex !important; align-items: center !important; gap: 8px !important; border-bottom: 1px solid rgba(255,255,255,0.06) !important;}#upl-gako-s6 .s6-dot-r { width: 10px !important; height: 10px !important; border-radius: 50% !important; background: #ff5f57 !important; flex-shrink: 0 !important; }#upl-gako-s6 .s6-dot-y { width: 10px !important; height: 10px !important; border-radius: 50% !important; background: #febc2e !important; flex-shrink: 0 !important; }#upl-gako-s6 .s6-dot-g { width: 10px !important; height: 10px !important; border-radius: 50% !important; background: #28c840 !important; flex-shrink: 0 !important; }#upl-gako-s6 .s6-file { color: #8b949e !important; font-size: 12px !important; font-family: 'Courier New', monospace !important; margin-left: 4px !important; }#upl-gako-s6 .s6-pre { padding: 22px 24px !important; font-size: 13px !important; line-height: 1.8 !important; overflow-x: auto !important; -webkit-overflow-scrolling: touch !important; background: #0d1117 !important;}#upl-gako-s6 .s6-pre code { font-family: 'Courier New', monospace !important; white-space: pre !important; display: block !important;}#upl-gako-s6 .c { color: #8b949e !important; }#upl-gako-s6 .k { color: #ff7b72 !important; }#upl-gako-s6 .fn { color: #d2a8ff !important; }#upl-gako-s6 .s { color: #a5d6ff !important; }#upl-gako-s6 .n { color: #79c0ff !important; }#upl-gako-s6 .w { color: #e6edf3 !important; }#upl-gako-s6 .s6-editor-ok { background: rgba(59,185,139,0.10) !important; border-top: 1px solid rgba(59,185,139,0.25) !important; color: #3BB98B !important; padding: 11px 24px !important; font-size: 12.5px !important; font-family: 'Courier New', monospace !important; display: flex !important; align-items: center !important; gap: 8px !important;}#upl-gako-s6 .s6-editor-ok svg { width: 14px !important; height: 14px !important; stroke: #3BB98B !important; fill: none !important; stroke-width: 2.5 !important; stroke-linecap: round !important; stroke-linejoin: round !important; flex-shrink: 0 !important;}@media (max-width: 900px) { #upl-gako-s6 .s6-h2 { font-size: 28px !important; } #upl-gako-s6 .s6-layout { grid-template-columns: 1fr !important; } #upl-gako-s6 { padding: 50px 20px !important; }}@media (max-width: 600px) { #upl-gako-s6 { padding: 50px 16px !important; } #upl-gako-s6 .s6-h2 { font-size: 26px !important; } #upl-gako-s6 .s6-intro { font-size: 15.5px !important; } #upl-gako-s6 .s6-warning-box { padding: 16px 18px !important; } #upl-gako-s6 .s6-warning-box p { font-size: 13.5px !important; } #upl-gako-s6 .s6-limit-item p { font-size: 13.5px !important; } #upl-gako-s6 .s6-pre { padding: 18px 16px !important; font-size: 11.5px !important; line-height: 1.7 !important; } #upl-gako-s6 .s6-editor-ok { font-size: 11px !important; padding: 10px 16px !important; align-items: flex-start !important; } #upl-gako-s6 .s6-editor-ok svg { margin-top: 2px !important; }}@media (max-width: 400px) { #upl-gako-s6 .s6-h2 { font-size: 22px !important; } #upl-gako-s6 .s6-pre { font-size: 10.5px !important; }}<\/style><div id=\"upl-gako-s6\"> <div class=\"s6-container\"> <span id=\"path-service-account\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"s6-badge\"><span class=\"s6-dot\"><\/span><span>Path 2 of 3<\/span><\/div> <h2 class=\"s6-h2\">Path 2 – Service Account + Domain-Wide Delegation (Workspace Internal)<\/h2> <pee class=\"s6-intro\">If your use case is internal to a Google Workspace organization – think internal tooling, HR automation, or a company-wide email analytics dashboard – service accounts with Domain-Wide Delegation (DWD) let you access mailboxes without per-user consent flows. A Workspace admin grants the delegation once. The critical caveat: this path does not work for personal Gmail addresses.<\/pee> <div class=\"s6-layout\"> <div> <div class=\"s6-warning-box\"> <div class=\"s6-warning-label\"><svg viewBox=\"0 0 24 24\"><path d=\"M10.29 3.86L1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z\"\/><line x1=\"12\" y1=\"9\" x2=\"12\" y2=\"13\"\/><line x1=\"12\" y1=\"17\" x2=\"12.01\" y2=\"17\"\/><\/svg><span>Hard limit – read before starting<\/span><\/div> <pee><strong>Service accounts cannot access personal Gmail accounts (@gmail.com).<\/strong> DWD only works within a Google Workspace domain. If your users sign up with personal Gmail addresses, you must use Path 1 (OAuth Client ID) or Path 3 (Unified API). Attempting DWD on a personal account returns a 403 error.<\/pee> <\/div> <div class=\"s6-limit-list\"> <div class=\"s6-limit-item\"><svg viewBox=\"0 0 24 24\"><circle cx=\"12\" cy=\"12\" r=\"10\"\/><line x1=\"12\" y1=\"8\" x2=\"12\" y2=\"12\"\/><line x1=\"12\" y1=\"16\" x2=\"12.01\" y2=\"16\"\/><\/svg><pee><strong>Workspace admin required:<\/strong> DWD must be configured by a Google Workspace admin at admin.google.com. You cannot do this as a developer without admin access.<\/pee><\/div> <div class=\"s6-limit-item\"><svg viewBox=\"0 0 24 24\"><circle cx=\"12\" cy=\"12\" r=\"10\"\/><line x1=\"12\" y1=\"8\" x2=\"12\" y2=\"12\"\/><line x1=\"12\" y1=\"16\" x2=\"12.01\" y2=\"16\"\/><\/svg><pee><strong>JSON key security:<\/strong> The service account JSON key is a long-lived credential. Treat it like a private key – rotate it regularly and never commit it to source control.<\/pee><\/div> <div class=\"s6-limit-item\"><svg viewBox=\"0 0 24 24\"><circle cx=\"12\" cy=\"12\" r=\"10\"\/><line x1=\"12\" y1=\"8\" x2=\"12\" y2=\"12\"\/><line x1=\"12\" y1=\"16\" x2=\"12.01\" y2=\"16\"\/><\/svg><pee><strong>Scope declaration required:<\/strong> The admin must explicitly approve each Gmail scope during DWD setup. You cannot request scopes at runtime. See <a href=\"https:\/\/support.google.com\/a\/answer\/162106\" target=\"_blank\" rel=\"noopener\" style=\"color:#2aaa7e!important;text-decoration:underline!important;\">Google’s DWD guide<\/a>.<\/pee><\/div> <\/div> <\/div> <div> <div class=\"s6-code-wrap\"> <div class=\"s6-editor-bar\"> <span class=\"s6-dot-r\"><\/span><span class=\"s6-dot-y\"><\/span><span class=\"s6-dot-g\"><\/span> <span class=\"s6-file\">gmail-service-account.py<\/span> <\/div> <div class=\"s6-pre\"><code><span class=\"k\">from<\/span> <span class=\"w\">google.oauth2 <\/span><span class=\"k\">import<\/span> <span class=\"w\">service_account<\/span><span class=\"k\">from<\/span> <span class=\"w\">googleapiclient.discovery <\/span><span class=\"k\">import<\/span> <span class=\"fn\">build<\/span><span class=\"c\"># Path to your service account JSON key<\/span><span class=\"w\">SERVICE_ACCOUNT_FILE <\/span><span class=\"k\">=<\/span> <span class=\"s\">'service-account.json'<\/span><span class=\"w\">SCOPES <\/span><span class=\"k\">=<\/span> <span class=\"w\">[<\/span> <span class=\"s\">'https:\/\/www.googleapis.com\/auth\/gmail.readonly'<\/span><span class=\"w\">]<\/span><span class=\"c\"># Impersonate a user in your Workspace domain<\/span><span class=\"c\"># (Domain-Wide Delegation must be enabled by admin)<\/span><span class=\"k\">def<\/span> <span class=\"fn\">get_gmail_service<\/span><span class=\"w\">(user_email):<\/span> <span class=\"w\">creds <\/span><span class=\"k\">=<\/span> <span class=\"w\">service_account.Credentials.<\/span><span class=\"fn\">from_service_account_file<\/span><span class=\"w\">(<\/span> <span class=\"w\">SERVICE_ACCOUNT_FILE,<\/span> <span class=\"w\">scopes<\/span><span class=\"k\">=<\/span><span class=\"w\">SCOPES<\/span> <span class=\"w\">)<\/span> <span class=\"c\"># This is Domain-Wide Delegation: impersonate user<\/span> <span class=\"w\">delegated_creds <\/span><span class=\"k\">=<\/span> <span class=\"w\">creds.<\/span><span class=\"fn\">with_subject<\/span><span class=\"w\">(user_email)<\/span> <span class=\"k\">return<\/span> <span class=\"fn\">build<\/span><span class=\"w\">(<\/span><span class=\"s\">'gmail'<\/span><span class=\"w\">,<\/span> <span class=\"s\">'v1'<\/span><span class=\"w\">, credentials<\/span><span class=\"k\">=<\/span><span class=\"w\">delegated_creds)<\/span><span class=\"c\"># List messages for a Workspace user<\/span><span class=\"w\">service <\/span><span class=\"k\">=<\/span> <span class=\"fn\">get_gmail_service<\/span><span class=\"w\">(<\/span><span class=\"s\">'alice@yourcompany.com'<\/span><span class=\"w\">)<\/span><span class=\"w\">results <\/span><span class=\"k\">=<\/span> <span class=\"w\">service.users().messages().<\/span><span class=\"fn\">list<\/span><span class=\"w\">(<\/span> <span class=\"w\">userId<\/span><span class=\"k\">=<\/span><span class=\"s\">'me'<\/span><span class=\"w\">).<\/span><span class=\"fn\">execute<\/span><span class=\"w\">()<\/span><\/code><\/div> <div class=\"s6-editor-ok\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Works only for Workspace users – never personal @gmail.com<\/span><\/div> <\/div> <\/div> <\/div> <\/div><\/div><\/body><\/html>[\/et_pb_code][\/et_pb_column][\/et_pb_row][\/et_pb_section][et_pb_section fb_built=”1″ _builder_version=”4.27.3″ background_color=”transparent” custom_padding=”0px|0px|0px|0px|false|false” global_colors_info=”{}” theme_builder_area=”post_content” da_is_popup=”off” da_exit_intent=”off” da_has_close=”on” da_alt_close=”off” da_dark_close=”off” da_not_modal=”on” da_is_singular=”off” da_with_loader=”off” da_has_shadow=”on” da_disable_devices=”off|off|off”][et_pb_row _builder_version=”4.27.3″ background_color=”transparent” global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_column type=”4_4″ _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_code _builder_version=”4.27.4″ hover_enabled=”0″ global_colors_info=”{}” theme_builder_area=”post_content” sticky_enabled=”0″]<!DOCTYPE html><html lang=\"en\"><head><meta charset=\"UTF-8\"><meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\"><title>Unipile – Path 3 Unified API<\/title><link href=\"https:\/\/fonts.googleapis.com\/css2?family=Inter:wght@400;500;600;700&family=Poppins:wght@700;800&display=swap\" rel=\"stylesheet\"><style>body { background: #f4f5f7; margin: 0; }#upl-gako-s7,#upl-gako-s7 *,#upl-gako-s7 *::before,#upl-gako-s7 *::after { margin: 0 !important; padding: 0 !important; box-sizing: border-box !important; border: none !important; outline: none !important; font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif !important; line-height: 1.5 !important; letter-spacing: normal !important; text-transform: none !important; text-decoration: none !important; list-style: none !important;}#upl-gako-s7 { background: transparent !important; padding: 60px 20px !important; overflow: hidden !important;}#upl-gako-s7 .s7-container { max-width: 1100px !important; width: 100% !important; margin: 0 auto !important;}#upl-gako-s7 .s7-badge { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: rgba(59,185,139,0.12) !important; color: #2aaa7e !important; padding: 6px 14px !important; border-radius: 20px !important; font-size: 12px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.5px !important; margin-bottom: 16px !important; width: fit-content !important;}#upl-gako-s7 .s7-badge .s7-dot { width: 7px !important; height: 7px !important; background: #3BB98B !important; border-radius: 50% !important; flex-shrink: 0 !important;}#upl-gako-s7 .s7-h2 { font-family: 'Poppins', sans-serif !important; font-size: 35px !important; font-weight: 700 !important; color: #0f2736 !important; line-height: 1.2 !important; margin-bottom: 16px !important;}#upl-gako-s7 .s7-intro { font-size: 17px !important; color: #383838 !important; line-height: 1.75 !important; margin-bottom: 36px !important;}#upl-gako-s7 .s7-layout { display: grid !important; grid-template-columns: 1fr 1fr !important; gap: 40px !important; align-items: start !important; margin-bottom: 36px !important;}\/* Empeche les colonnes Grid de deborder a cause du contenu non-cassable (code en white-space: pre) *\/#upl-gako-s7 .s7-layout > div { min-width: 0 !important;}#upl-gako-s7 .s7-benefits { display: flex !important; flex-direction: column !important; gap: 14px !important; margin-bottom: 28px !important;}#upl-gako-s7 .s7-benefit { display: flex !important; align-items: flex-start !important; gap: 12px !important;}#upl-gako-s7 .s7-benefit-icon { width: 34px !important; height: 34px !important; min-width: 34px !important; background: rgba(59,185,139,0.12) !important; border-radius: 8px !important; display: flex !important; align-items: center !important; justify-content: center !important;}#upl-gako-s7 .s7-benefit-icon svg { width: 16px !important; height: 16px !important; stroke: #3BB98B !important; fill: none !important; stroke-width: 2.2 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}#upl-gako-s7 .s7-benefit > div { min-width: 0 !important;}#upl-gako-s7 .s7-benefit h3 { font-size: 15px !important; font-weight: 700 !important; color: #0f2736 !important; margin-bottom: 4px !important; line-height: 1.35 !important;}#upl-gako-s7 .s7-benefit p { font-size: 14px !important; color: #4a5568 !important; line-height: 1.65 !important; overflow-wrap: break-word !important; word-wrap: break-word !important;}#upl-gako-s7 .s7-providers-row { display: flex !important; align-items: center !important; gap: 12px !important; padding: 16px 20px !important; background: #f8fafc !important; border: 1px solid #e5e7eb !important; border-radius: 12px !important; flex-wrap: wrap !important;}#upl-gako-s7 .s7-providers-row img { width: 28px !important; height: 28px !important;}#upl-gako-s7 .s7-providers-label { font-size: 13px !important; color: #64748b !important; font-weight: 600 !important;}\/* Code block *\/#upl-gako-s7 .s7-code-wrap { border-radius: 14px !important; overflow: hidden !important; background: #0d1117 !important; max-width: 100% !important;}#upl-gako-s7 .s7-editor-bar { background: #161b22 !important; padding: 12px 18px !important; display: flex !important; align-items: center !important; gap: 8px !important; border-bottom: 1px solid rgba(255,255,255,0.06) !important;}#upl-gako-s7 .s7-dot-r { width: 10px !important; height: 10px !important; border-radius: 50% !important; background: #ff5f57 !important; flex-shrink: 0 !important; }#upl-gako-s7 .s7-dot-y { width: 10px !important; height: 10px !important; border-radius: 50% !important; background: #febc2e !important; flex-shrink: 0 !important; }#upl-gako-s7 .s7-dot-g { width: 10px !important; height: 10px !important; border-radius: 50% !important; background: #28c840 !important; flex-shrink: 0 !important; }#upl-gako-s7 .s7-file { color: #8b949e !important; font-size: 12px !important; font-family: 'Courier New', monospace !important; margin-left: 4px !important; }#upl-gako-s7 .s7-pre { padding: 22px 24px !important; font-size: 13px !important; line-height: 1.8 !important; overflow-x: auto !important; -webkit-overflow-scrolling: touch !important; background: #0d1117 !important;}#upl-gako-s7 .s7-pre code { font-family: 'Courier New', monospace !important; white-space: pre !important; display: block !important;}#upl-gako-s7 .c { color: #8b949e !important; }#upl-gako-s7 .k { color: #ff7b72 !important; }#upl-gako-s7 .fn { color: #d2a8ff !important; }#upl-gako-s7 .s { color: #a5d6ff !important; }#upl-gako-s7 .n { color: #79c0ff !important; }#upl-gako-s7 .w { color: #e6edf3 !important; }#upl-gako-s7 .s7-editor-ok { background: rgba(59,185,139,0.10) !important; border-top: 1px solid rgba(59,185,139,0.25) !important; color: #3BB98B !important; padding: 11px 24px !important; font-size: 12.5px !important; font-family: 'Courier New', monospace !important; display: flex !important; align-items: center !important; gap: 8px !important;}#upl-gako-s7 .s7-editor-ok svg { width: 14px !important; height: 14px !important; stroke: #3BB98B !important; fill: none !important; stroke-width: 2.5 !important; stroke-linecap: round !important; stroke-linejoin: round !important; flex-shrink: 0 !important;}\/* CTA strip *\/#upl-gako-s7 .s7-cta-strip { background: #0f2736 !important; border-radius: 14px !important; padding: 28px 32px !important; display: flex !important; align-items: center !important; justify-content: space-between !important; gap: 24px !important; flex-wrap: wrap !important;}#upl-gako-s7 .s7-cta-text { min-width: 0 !important;}#upl-gako-s7 .s7-cta-text h3 { font-family: 'Poppins', sans-serif !important; font-size: 20px !important; font-weight: 700 !important; color: #ffffff !important; margin-bottom: 8px !important; line-height: 1.3 !important;}#upl-gako-s7 .s7-cta-text p { font-size: 15px !important; color: rgba(255,255,255,0.75) !important; line-height: 1.6 !important;}#upl-gako-s7 .s7-cta-actions { display: flex !important; gap: 12px !important; flex-wrap: wrap !important; flex-shrink: 0 !important;}#upl-gako-s7 .s7-btn-primary { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: #DDDF4C !important; color: #0f2736 !important; padding: 12px 22px !important; border-radius: 8px !important; font-size: 0.9rem !important; font-weight: 600 !important; border: 2px solid #DDDF4C !important; transition: transform 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important;}#upl-gako-s7 .s7-btn-primary:hover { transform: translateY(-5px) !important;}#upl-gako-s7 .s7-btn-primary svg { width: 14px !important; height: 14px !important; stroke: currentColor !important; fill: none !important; stroke-width: 2.5 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}#upl-gako-s7 .s7-btn-secondary { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: transparent !important; color: #ffffff !important; padding: 12px 22px !important; border-radius: 8px !important; font-size: 0.9rem !important; font-weight: 600 !important; border: 2px solid rgba(255,255,255,0.30) !important; transition: all 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important;}#upl-gako-s7 .s7-btn-secondary:hover { border-color: rgba(255,255,255,0.70) !important;}#upl-gako-s7 .s7-btn-secondary svg { width: 14px !important; height: 14px !important; stroke: currentColor !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}@media (max-width: 900px) { #upl-gako-s7 .s7-h2 { font-size: 28px !important; } #upl-gako-s7 .s7-layout { grid-template-columns: 1fr !important; } #upl-gako-s7 { padding: 50px 20px !important; } #upl-gako-s7 .s7-cta-strip { flex-direction: column !important; align-items: flex-start !important; }}@media (max-width: 600px) { #upl-gako-s7 { padding: 50px 16px !important; } #upl-gako-s7 .s7-h2 { font-size: 26px !important; } #upl-gako-s7 .s7-intro { font-size: 15.5px !important; } #upl-gako-s7 .s7-cta-strip { padding: 22px 20px !important; } #upl-gako-s7 .s7-cta-text h3 { font-size: 18px !important; } #upl-gako-s7 .s7-btn-primary, #upl-gako-s7 .s7-btn-secondary { width: 100% !important; justify-content: center !important; } #upl-gako-s7 .s7-cta-actions { width: 100% !important; } #upl-gako-s7 .s7-pre { padding: 18px 16px !important; font-size: 11.5px !important; line-height: 1.7 !important; } #upl-gako-s7 .s7-editor-ok { font-size: 11px !important; padding: 10px 16px !important; align-items: flex-start !important; } #upl-gako-s7 .s7-editor-ok svg { margin-top: 2px !important; }}@media (max-width: 400px) { #upl-gako-s7 .s7-h2 { font-size: 22px !important; } #upl-gako-s7 .s7-pre { font-size: 10.5px !important; }}<\/style><div id=\"upl-gako-s7\"> <div class=\"s7-container\"> <span id=\"path-unified-api\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"s7-badge\"><span class=\"s7-dot\"><\/span><span>Path 3 of 3 – Recommended<\/span><\/div> <h2 class=\"s7-h2\">Path 3 – Unified Email API (Skip the OAuth Boilerplate)<\/h2> <pee class=\"s7-intro\">If your goal is to read, send, or sync email in a production SaaS application – and you’d rather not spend engineering cycles managing OAuth infrastructure – a unified email API like Unipile abstracts the entire authentication layer. Understand <a href=\"https:\/\/www.unipile.com\/email-sync-api\/\" style=\"color:#2aaa7e!important;text-decoration:underline!important;\">how email sync works under the hood<\/a>, or go straight to the code. This approach also gives you Gmail, Outlook, and IMAP under one API – no separate integration for each provider.<\/pee> <div class=\"s7-layout\"> <div> <div class=\"s7-benefits\"> <div class=\"s7-benefit\"> <div class=\"s7-benefit-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><\/div> <div> <h3>No Google Cloud setup required<\/h3> <pee>No OAuth client ID, no consent screen, no scope review with Google. Unipile’s own verified OAuth app handles user authorization.<\/pee> <\/div> <\/div> <div class=\"s7-benefit\"> <div class=\"s7-benefit-icon\"><svg viewBox=\"0 0 24 24\"><path d=\"M21 16V8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16z\"\/><\/svg><\/div> <div> <h3>Automatic token rotation<\/h3> <pee>Access tokens and refresh tokens are managed entirely by Unipile. Your database never stores a Google OAuth token.<\/pee> <\/div> <\/div> <div class=\"s7-benefit\"> <div class=\"s7-benefit-icon\"><svg viewBox=\"0 0 24 24\"><rect x=\"2\" y=\"3\" width=\"20\" height=\"14\" rx=\"2\" ry=\"2\"\/><line x1=\"8\" y1=\"21\" x2=\"16\" y2=\"21\"\/><line x1=\"12\" y1=\"17\" x2=\"12\" y2=\"21\"\/><\/svg><\/div> <div> <h3>Works for personal Gmail + Outlook + IMAP<\/h3> <pee>One API, three provider universes. When you <a href=\"https:\/\/www.unipile.com\/email-api-providers\/\" style=\"color:#2aaa7e!important;text-decoration:underline!important;\">compare email sync API providers<\/a>, cross-provider support is a major differentiator.<\/pee> <\/div> <\/div> <div class=\"s7-benefit\"> <div class=\"s7-benefit-icon\"><svg viewBox=\"0 0 24 24\"><circle cx=\"12\" cy=\"12\" r=\"10\"\/><line x1=\"12\" y1=\"8\" x2=\"12\" y2=\"12\"\/><line x1=\"12\" y1=\"16\" x2=\"12.01\" y2=\"16\"\/><\/svg><\/div> <div> <h3>Webhook delivery on new messages<\/h3> <pee>Instead of polling Gmail’s API, Unipile pushes new email events to your webhook endpoint in real-time, per linked account.<\/pee> <\/div> <\/div> <\/div> <div class=\"s7-providers-row\"> <span class=\"s7-providers-label\">Supported providers:<\/span> <img decoding=\"async\" src=\"https:\/\/www.unipile.com\/wp-content\/uploads\/2024\/02\/gmail-3.svg\" alt=\"Gmail\" width=\"28\" height=\"28\"> <img decoding=\"async\" src=\"https:\/\/www.unipile.com\/wp-content\/uploads\/2024\/02\/outlook-2.svg\" alt=\"Outlook\" width=\"28\" height=\"28\"> <img decoding=\"async\" src=\"https:\/\/www.unipile.com\/wp-content\/uploads\/2024\/02\/imap-1.svg\" alt=\"IMAP\" width=\"28\" height=\"28\"> <\/div> <\/div> <div> <div class=\"s7-code-wrap\"> <div class=\"s7-editor-bar\"> <span class=\"s7-dot-r\"><\/span><span class=\"s7-dot-y\"><\/span><span class=\"s7-dot-g\"><\/span> <span class=\"s7-file\">unipile-gmail.js<\/span> <\/div> <div class=\"s7-pre\"><code><span class=\"c\">\/\/ 3 lines to read a Gmail mailbox via Unipile<\/span><span class=\"c\">\/\/ No OAuth setup, no token management<\/span><span class=\"k\">const<\/span> <span class=\"w\">{ UnipileClient } <\/span><span class=\"k\">=<\/span> <span class=\"fn\">require<\/span><span class=\"w\">(<\/span><span class=\"s\">'unipile-node-sdk'<\/span><span class=\"w\">);<\/span><span class=\"k\">const<\/span> <span class=\"w\">client <\/span><span class=\"k\">=<\/span> <span class=\"k\">new<\/span> <span class=\"fn\">UnipileClient<\/span><span class=\"w\">({<\/span> <span class=\"w\">token: process.env.UNIPILE_API_KEY<\/span><span class=\"w\">});<\/span><span class=\"c\">\/\/ List emails from a linked Gmail account<\/span><span class=\"c\">\/\/ accountId = the Unipile linked account ID<\/span><span class=\"k\">const<\/span> <span class=\"w\">emails <\/span><span class=\"k\">=<\/span> <span class=\"k\">await<\/span> <span class=\"w\">client.email.<\/span><span class=\"fn\">listMessages<\/span><span class=\"w\">({<\/span> <span class=\"w\">account_id:<\/span> <span class=\"s\">'linked-account-id'<\/span><span class=\"w\">,<\/span> <span class=\"w\">limit:<\/span> <span class=\"n\">20<\/span><span class=\"w\">});<\/span><span class=\"c\">\/\/ Send an email on behalf of the linked account<\/span><span class=\"k\">await<\/span> <span class=\"w\">client.email.<\/span><span class=\"fn\">send<\/span><span class=\"w\">({<\/span> <span class=\"w\">account_id:<\/span> <span class=\"s\">'linked-account-id'<\/span><span class=\"w\">,<\/span> <span class=\"w\">to:<\/span> <span class=\"s\">'recipient@example.com'<\/span><span class=\"w\">,<\/span> <span class=\"w\">subject:<\/span> <span class=\"s\">'Hello from Unipile'<\/span><span class=\"w\">,<\/span> <span class=\"w\">body:<\/span> <span class=\"s\">'No OAuth token in sight.'<\/span><span class=\"w\">});<\/span><span class=\"c\">\/\/ Works identically for Outlook and IMAP<\/span><span class=\"c\">\/\/ Just swap the account_id<\/span><\/code><\/div> <div class=\"s7-editor-ok\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Same code for Gmail, Outlook, and IMAP linked accounts<\/span><\/div> <\/div> <\/div> <\/div> <div class=\"s7-cta-strip\"> <div class=\"s7-cta-text\"> <h3>Build your Gmail integration without OAuth ops<\/h3> <pee>Start with the <a href=\"https:\/\/www.unipile.com\/communication-api\/email-api\/duplicate-enhance-your-email-software-with-gmail-api-integration\/\" style=\"color:#DDDF4C!important;text-decoration:underline!important;\">complete Gmail API integration guide<\/a>, then deploy with Unipile as your auth and sync layer.<\/pee> <\/div> <div class=\"s7-cta-actions\"> <span class=\"s7-btn-primary\" data-upl-link=\"https:\/\/dashboard.unipile.com\/signup\/\" data-upl-target=\"_blank\"><span>Start building<\/span><svg viewBox=\"0 0 24 24\"><line x1=\"5\" y1=\"12\" x2=\"19\" y2=\"12\"\/><polyline points=\"12 5 19 12 12 19\"\/><\/svg><\/span> <span class=\"s7-btn-secondary\" data-upl-link=\"https:\/\/developer.unipile.com\/docs\/getting-started\" data-upl-target=\"_blank\"><span>View docs<\/span><svg viewBox=\"0 0 24 24\"><polyline points=\"9 18 15 12 9 6\"\/><\/svg><\/span> <\/div> <\/div> <\/div><\/div><script>(function(){ function init(){ var el = document.getElementById('upl-gako-s7'); if (!el) return; el.addEventListener('click', function(e){ var t = e.target.closest('[data-upl-link]'); if (!t) return; var url = t.getAttribute('data-upl-link'); var target = t.getAttribute('data-upl-target') || '_self'; if (url) window.open(url, target); }); } if (document.readyState === 'loading') { document.addEventListener('DOMContentLoaded', init); } else { init(); }})();<\/script><\/body><\/html>[\/et_pb_code][\/et_pb_column][\/et_pb_row][\/et_pb_section][et_pb_section fb_built=”1″ _builder_version=”4.27.3″ background_color=”transparent” custom_padding=”0px|0px|0px|0px|false|false” global_colors_info=”{}” theme_builder_area=”post_content” da_is_popup=”off” da_exit_intent=”off” da_has_close=”on” da_alt_close=”off” da_dark_close=”off” da_not_modal=”on” da_is_singular=”off” da_with_loader=”off” da_has_shadow=”on” da_disable_devices=”off|off|off”][et_pb_row _builder_version=”4.27.3″ background_color=”transparent” global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_column type=”4_4″ _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_code _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”]<link href=\"https:\/\/fonts.googleapis.com\/css2?family=Inter:wght@400;500;600;700&family=Poppins:wght@700;800&display=swap\" rel=\"stylesheet\"><style>#upl-gako-s8,#upl-gako-s8 *,#upl-gako-s8 *::before,#upl-gako-s8 *::after { margin: 0 !important; padding: 0 !important; box-sizing: border-box !important; border: none !important; outline: none !important; font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif !important; line-height: 1.5 !important; letter-spacing: normal !important; text-transform: none !important; text-decoration: none !important; list-style: none !important;}#upl-gako-s8 { background: #f4f5f7 !important; padding: 60px 20px !important;}#upl-gako-s8 .s8-container { max-width: 1100px !important; margin: 0 auto !important;}#upl-gako-s8 .s8-badge { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: rgba(239,68,68,0.10) !important; color: #dc2626 !important; padding: 6px 14px !important; border-radius: 20px !important; font-size: 12px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.5px !important; margin-bottom: 16px !important; width: fit-content !important;}#upl-gako-s8 .s8-badge .s8-dot { width: 7px !important; height: 7px !important; background: #ef4444 !important; border-radius: 50% !important; flex-shrink: 0 !important;}#upl-gako-s8 .s8-h2 { font-family: 'Poppins', sans-serif !important; font-size: 35px !important; font-weight: 700 !important; color: #0f2736 !important; line-height: 1.2 !important; margin-bottom: 16px !important;}#upl-gako-s8 .s8-intro { font-size: 17px !important; color: #383838 !important; line-height: 1.75 !important; margin-bottom: 40px !important;}#upl-gako-s8 .s8-error-list { display: flex !important; flex-direction: column !important; gap: 28px !important;}#upl-gako-s8 .s8-error-item { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; overflow: hidden !important;}#upl-gako-s8 .s8-error-item-header { padding: 18px 24px !important; display: flex !important; align-items: center !important; gap: 14px !important; border-bottom: 1px solid #f0f1f3 !important;}#upl-gako-s8 .s8-error-code { display: inline-flex !important; align-items: center !important; gap: 6px !important; background: rgba(239,68,68,0.10) !important; color: #dc2626 !important; padding: 4px 10px !important; border-radius: 6px !important; font-size: 12px !important; font-weight: 700 !important; font-family: 'Courier New', monospace !important; white-space: nowrap !important;}#upl-gako-s8 .s8-error-title { font-family: 'Poppins', sans-serif !important; font-size: 16px !important; font-weight: 700 !important; color: #0f2736 !important;}#upl-gako-s8 .s8-error-body { padding: 20px 24px !important; display: grid !important; grid-template-columns: 1fr 1fr !important; gap: 20px !important;}#upl-gako-s8 .s8-cause-label { font-size: 11px !important; font-weight: 700 !important; color: #94a3b8 !important; text-transform: uppercase !important; letter-spacing: 0.8px !important; margin-bottom: 8px !important; display: block !important;}#upl-gako-s8 .s8-cause-text { font-size: 14.5px !important; color: #383838 !important; line-height: 1.65 !important;}#upl-gako-s8 .s8-cause-text strong { color: #0f2736 !important; font-weight: 700 !important;}\/* Code block inline *\/#upl-gako-s8 .s8-code-wrap { border-radius: 10px !important; overflow: hidden !important; background: #0d1117 !important; margin-top: 12px !important;}#upl-gako-s8 .s8-code-bar { background: #161b22 !important; padding: 8px 14px !important; display: flex !important; align-items: center !important; gap: 6px !important; border-bottom: 1px solid rgba(255,255,255,0.06) !important;}#upl-gako-s8 .sd-r { width: 8px !important; height: 8px !important; border-radius: 50% !important; background: #ff5f57 !important; flex-shrink: 0 !important; }#upl-gako-s8 .sd-y { width: 8px !important; height: 8px !important; border-radius: 50% !important; background: #febc2e !important; flex-shrink: 0 !important; }#upl-gako-s8 .sd-g { width: 8px !important; height: 8px !important; border-radius: 50% !important; background: #28c840 !important; flex-shrink: 0 !important; }#upl-gako-s8 .s8-code-pre { padding: 14px 16px !important; font-family: 'Courier New', monospace !important; font-size: 12px !important; line-height: 1.7 !important; overflow-x: auto !important; background: #0d1117 !important;}#upl-gako-s8 .s8-code-pre code { white-space: pre !important; display: block !important;}#upl-gako-s8 .er { color: #ff7b72 !important; }#upl-gako-s8 .em { color: #e6edf3 !important; }#upl-gako-s8 .ec { color: #8b949e !important; }#upl-gako-s8 .ev { color: #a5d6ff !important; }#upl-gako-s8 .en { color: #79c0ff !important; }@media (max-width: 900px) { #upl-gako-s8 .s8-h2 { font-size: 28px !important; } #upl-gako-s8 .s8-error-body { grid-template-columns: 1fr !important; } #upl-gako-s8 { padding: 50px 20px !important; }}@media (max-width: 600px) { #upl-gako-s8 .s8-h2 { font-size: 26px !important; } #upl-gako-s8 .s8-error-item-header { flex-wrap: wrap !important; }}<\/style><div id=\"upl-gako-s8\"> <div class=\"s8-container\"> <span id=\"common-errors\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"s8-badge\"><span class=\"s8-dot\"><\/span><span>Troubleshooting<\/span><\/div> <h2 class=\"s8-h2\">Common Errors When You Try to Use an API Key with Gmail<\/h2> <pee class=\"s8-intro\">If you’ve landed on this article because your Gmail API call is failing, here are the two errors you’ll encounter and exactly what each one means – with the raw response body so you can recognize them instantly.<\/pee> <div class=\"s8-error-list\">  <div class=\"s8-error-item\"> <div class=\"s8-error-item-header\"> <span class=\"s8-error-code\">HTTP 401<\/span> <span class=\"s8-error-title\">Login Required \/ UNAUTHENTICATED<\/span> <\/div> <div class=\"s8-error-body\"> <div> <span class=\"s8-cause-label\">What causes it<\/span> <pee class=\"s8-cause-text\">You sent a request to the Gmail API with either an API key (<code>?key=AIza...<\/code>) or with no authorization at all. Gmail API requires a valid OAuth 2.0 access token in the <code>Authorization: Bearer<\/code> header. <strong>This is the first error you’ll see<\/strong> when experimenting with an API key for the first time.<\/pee> <pee class=\"s8-cause-text\" style=\"margin-top:10px!important;\"><strong>Fix:<\/strong> Implement one of the 3 auth paths above. The API key is not the solution – you need an OAuth access token.<\/pee> <\/div> <div> <div class=\"s8-code-wrap\"> <div class=\"s8-code-bar\"><span class=\"sd-r\"><\/span><span class=\"sd-y\"><\/span><span class=\"sd-g\"><\/span><\/div> <div class=\"s8-code-pre\"><code><span class=\"er\">HTTP\/1.1 401 Unauthorized<\/span><span class=\"em\">Content-Type: application\/json<\/span><span class=\"ev\">{ \"error\": { \"code\": <\/span><span class=\"en\">401<\/span><span class=\"ev\">, \"message\": \"Request is missing required authentication credential. Expected OAuth 2 access token, login cookie or other valid authentication credential. See https:\/\/ developers.google.com\/ identity\/sign-in\/web\/...\", \"status\": \"UNAUTHENTICATED\", \"errors\": [{ \"message\": \"Login Required\", \"domain\": \"googleapis.com\", \"reason\": \"required\", \"location\": \"Authorization\", \"locationType\": \"header\" }] }}<\/span><\/code><\/div> <\/div> <\/div> <\/div> <\/div>  <div class=\"s8-error-item\"> <div class=\"s8-error-item-header\"> <span class=\"s8-error-code\">HTTP 403<\/span> <span class=\"s8-error-title\">Daily Limit for Unauthenticated Use Exceeded<\/span> <\/div> <div class=\"s8-error-body\"> <div> <span class=\"s8-cause-label\">What causes it<\/span> <pee class=\"s8-cause-text\">After repeated unauthenticated requests (even with an API key), Google’s quota system blocks further unauthenticated calls from your IP or project. This is not a rate limit for authenticated users – it specifically means <strong>your requests were never authenticated<\/strong> and you’ve exhausted the tiny free quota for anonymous calls.<\/pee> <pee class=\"s8-cause-text\" style=\"margin-top:10px!important;\"><strong>Fix:<\/strong> Same as above – your API key approach will never work. Use OAuth 2.0 access tokens. This error will disappear once your requests carry a valid Bearer token.<\/pee> <\/div> <div> <div class=\"s8-code-wrap\"> <div class=\"s8-code-bar\"><span class=\"sd-r\"><\/span><span class=\"sd-y\"><\/span><span class=\"sd-g\"><\/span><\/div> <div class=\"s8-code-pre\"><code><span class=\"er\">HTTP\/1.1 403 Forbidden<\/span><span class=\"em\">Content-Type: application\/json<\/span><span class=\"ev\">{ \"error\": { \"code\": <\/span><span class=\"en\">403<\/span><span class=\"ev\">, \"message\": \"Daily Limit for Unauthenticated Use Exceeded. Continued use requires signup.\", \"status\": \"RESOURCE_EXHAUSTED\", \"errors\": [{ \"message\": \"Daily Limit for Unauthenticated Use Exceeded.\", \"domain\": \"usageLimits\", \"reason\": \"dailyLimitExceededUnreg\" }] }}<\/span><\/code><\/div> <\/div> <\/div> <\/div> <\/div> <\/div> <\/div><\/div>[\/et_pb_code][\/et_pb_column][\/et_pb_row][\/et_pb_section][et_pb_section fb_built=”1″ _builder_version=”4.27.3″ background_color=”transparent” custom_padding=”0px|0px|0px|0px|false|false” global_colors_info=”{}” theme_builder_area=”post_content” da_is_popup=”off” da_exit_intent=”off” da_has_close=”on” da_alt_close=”off” da_dark_close=”off” da_not_modal=”on” da_is_singular=”off” da_with_loader=”off” da_has_shadow=”on” da_disable_devices=”off|off|off”][et_pb_row _builder_version=”4.27.3″ background_color=”transparent” global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_column type=”4_4″ _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_code _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”]<link href=\"https:\/\/fonts.googleapis.com\/css2?family=Inter:wght@400;500;600;700&family=Poppins:wght@700;800&display=swap\" rel=\"stylesheet\"><style>#upl-gako-s9,#upl-gako-s9 *,#upl-gako-s9 *::before,#upl-gako-s9 *::after { margin: 0 !important; padding: 0 !important; box-sizing: border-box !important; border: none !important; outline: none !important; font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif !important; line-height: 1.5 !important; letter-spacing: normal !important; text-transform: none !important; text-decoration: none !important; list-style: none !important;}#upl-gako-s9 { background: transparent !important; padding: 60px 20px !important;}#upl-gako-s9 .s9-container { max-width: 1100px !important; margin: 0 auto !important;}#upl-gako-s9 .s9-badge { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: rgba(221,223,76,0.18) !important; color: #8a8c2e !important; padding: 6px 14px !important; border-radius: 20px !important; font-size: 12px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.5px !important; margin-bottom: 16px !important; width: fit-content !important;}#upl-gako-s9 .s9-badge .s9-dot { width: 7px !important; height: 7px !important; background: #DDDF4C !important; border-radius: 50% !important; flex-shrink: 0 !important;}#upl-gako-s9 .s9-h2 { font-family: 'Poppins', sans-serif !important; font-size: 35px !important; font-weight: 700 !important; color: #0f2736 !important; line-height: 1.2 !important; margin-bottom: 16px !important;}#upl-gako-s9 .s9-intro { font-size: 17px !important; color: #383838 !important; line-height: 1.75 !important; margin-bottom: 36px !important;}#upl-gako-s9 .s9-table-wrap { overflow-x: auto !important; border-radius: 16px !important; border: 1px solid #e5e7eb !important; background: #ffffff !important; margin-bottom: 28px !important;}#upl-gako-s9 table { width: 100% !important; border-collapse: collapse !important;}#upl-gako-s9 thead tr { background: #0f2736 !important;}#upl-gako-s9 thead th { padding: 14px 18px !important; font-family: 'Poppins', sans-serif !important; font-size: 12.5px !important; font-weight: 700 !important; color: #ffffff !important; text-align: left !important; white-space: nowrap !important;}#upl-gako-s9 thead th:first-child { border-radius: 15px 0 0 0 !important; }#upl-gako-s9 thead th:last-child { border-radius: 0 15px 0 0 !important; }#upl-gako-s9 tbody tr { border-bottom: 1px solid #f0f1f3 !important; }#upl-gako-s9 tbody tr:last-child { border-bottom: none !important; }#upl-gako-s9 tbody tr:nth-child(even) td { background: #f8fafc !important; }#upl-gako-s9 tbody td { padding: 14px 18px !important; font-size: 13.5px !important; color: #383838 !important; vertical-align: top !important;}#upl-gako-s9 tbody td.scope-col { font-family: 'Courier New', monospace !important; font-size: 12px !important; color: #0f2736 !important; font-weight: 700 !important; white-space: nowrap !important;}#upl-gako-s9 .s9-pill { display: inline-flex !important; align-items: center !important; gap: 4px !important; padding: 3px 9px !important; border-radius: 20px !important; font-size: 11px !important; font-weight: 700 !important; white-space: nowrap !important;}#upl-gako-s9 .pill-sensitive { background: rgba(245,158,11,0.12) !important; color: #b45309 !important;}#upl-gako-s9 .pill-restricted { background: rgba(239,68,68,0.10) !important; color: #dc2626 !important;}#upl-gako-s9 .pill-basic { background: rgba(59,185,139,0.12) !important; color: #2aaa7e !important;}\/* Verification callout *\/#upl-gako-s9 .s9-verification-box { background: rgba(245,158,11,0.06) !important; border: 1px solid rgba(245,158,11,0.25) !important; border-radius: 14px !important; padding: 20px 24px !important; display: flex !important; gap: 14px !important; align-items: flex-start !important; margin-bottom: 28px !important;}#upl-gako-s9 .s9-verification-box svg { width: 20px !important; height: 20px !important; stroke: #f59e0b !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important; flex-shrink: 0 !important; margin-top: 2px !important;}#upl-gako-s9 .s9-vbox-label { font-size: 11px !important; font-weight: 700 !important; color: #f59e0b !important; text-transform: uppercase !important; letter-spacing: 0.8px !important; margin-bottom: 6px !important; display: block !important;}#upl-gako-s9 .s9-verification-box p { font-size: 14.5px !important; color: #383838 !important; line-height: 1.65 !important;}#upl-gako-s9 .s9-verification-box p strong { color: #0f2736 !important; font-weight: 700 !important;}\/* inline CTA *\/#upl-gako-s9 .s9-inline-cta { background: rgba(59,185,139,0.08) !important; border: 1px solid rgba(59,185,139,0.25) !important; border-radius: 12px !important; padding: 18px 22px !important; display: flex !important; align-items: center !important; justify-content: space-between !important; gap: 16px !important; flex-wrap: wrap !important;}#upl-gako-s9 .s9-inline-cta p { font-size: 15px !important; color: #383838 !important; line-height: 1.6 !important;}#upl-gako-s9 .s9-inline-cta p strong { color: #0f2736 !important;}#upl-gako-s9 .s9-icta-btn { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: #DDDF4C !important; color: #0f2736 !important; padding: 10px 20px !important; border-radius: 8px !important; font-size: 0.88rem !important; font-weight: 600 !important; border: 2px solid #DDDF4C !important; transition: transform 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important; flex-shrink: 0 !important;}#upl-gako-s9 .s9-icta-btn:hover { transform: translateY(-5px) !important;}#upl-gako-s9 .s9-icta-btn svg { width: 13px !important; height: 13px !important; stroke: currentColor !important; fill: none !important; stroke-width: 2.5 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}@media (max-width: 900px) { #upl-gako-s9 .s9-h2 { font-size: 28px !important; } #upl-gako-s9 { padding: 50px 20px !important; } #upl-gako-s9 .s9-inline-cta { flex-direction: column !important; align-items: flex-start !important; }}@media (max-width: 600px) { #upl-gako-s9 .s9-h2 { font-size: 26px !important; } #upl-gako-s9 .s9-icta-btn { width: 100% !important; justify-content: center !important; } #upl-gako-s9 thead th { font-size: 11px !important; padding: 10px 12px !important; } #upl-gako-s9 tbody td { font-size: 12px !important; padding: 10px 12px !important; }}<\/style><div id=\"upl-gako-s9\"> <div class=\"s9-container\"> <span id=\"gmail-scopes\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"s9-badge\"><span class=\"s9-dot\"><\/span><span>Reference<\/span><\/div> <h2 class=\"s9-h2\">Gmail API Scopes You’ll Actually Need<\/h2> <pee class=\"s9-intro\">Once you accept that OAuth is required, scope selection is the next critical decision. Google classifies Gmail scopes into three tiers based on the sensitivity of the data they expose. Requesting more than you need triggers a longer verification process – and in some cases, a full security assessment by Google.<\/pee> <div class=\"s9-verification-box\"> <svg viewBox=\"0 0 24 24\"><path d=\"M10.29 3.86L1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z\"\/><line x1=\"12\" y1=\"9\" x2=\"12\" y2=\"13\"\/><line x1=\"12\" y1=\"17\" x2=\"12.01\" y2=\"17\"\/><\/svg> <div> <span class=\"s9-vbox-label\">Scope verification tiers<\/span> <pee><strong>Sensitive scopes<\/strong> (yellow) require Google to review your OAuth consent screen and verify your app’s privacy policy. <strong>Restricted scopes<\/strong> (red) require a formal security assessment, a video demonstration, and sometimes a third-party security audit. Plan 2-6 weeks minimum for restricted scope approval. If you use Unipile as your auth layer, this verification process falls on Unipile – not your app.<\/pee> <\/div> <\/div> <div class=\"s9-table-wrap\"> <table> <thead> <tr> <th>Scope<\/th> <th>Access Level<\/th> <th>Tier<\/th> <th>Use Case<\/th> <\/tr> <\/thead> <tbody> <tr> <td class=\"scope-col\">gmail.readonly<\/td> <td>Read all messages, threads, labels, settings<\/td> <td><span class=\"s9-pill pill-sensitive\">Sensitive<\/span><\/td> <td>Email analytics, inbox audit tools, CRM sync (read-only)<\/td> <\/tr> <tr> <td class=\"scope-col\">gmail.send<\/td> <td>Send email on behalf of the user<\/td> <td><span class=\"s9-pill pill-sensitive\">Sensitive<\/span><\/td> <td>Transactional user-side emails, CRM follow-ups, outreach tools<\/td> <\/tr> <tr> <td class=\"scope-col\">gmail.compose<\/td> <td>Create, read, update, delete drafts; send messages<\/td> <td><span class=\"s9-pill pill-sensitive\">Sensitive<\/span><\/td> <td>Email composer integrations, draft management<\/td> <\/tr> <tr> <td class=\"scope-col\">gmail.modify<\/td> <td>Read, send, modify (labels, archive) – no delete<\/td> <td><span class=\"s9-pill pill-restricted\">Restricted<\/span><\/td> <td>Full inbox management, CRM sync with write, archival workflows<\/td> <\/tr> <tr> <td class=\"scope-col\">mail.google.com<\/td> <td>Full access – read, write, delete, settings<\/td> <td><span class=\"s9-pill pill-restricted\">Restricted<\/span><\/td> <td>Full-featured email clients, backup tools, admin migration<\/td> <\/tr> <tr> <td class=\"scope-col\">gmail.metadata<\/td> <td>Message metadata only (no body)<\/td> <td><span class=\"s9-pill pill-basic\">Non-sensitive<\/span><\/td> <td>Analytics on email volume, sender\/recipient patterns (no content)<\/td> <\/tr> <\/tbody> <\/table> <\/div> <div class=\"s9-inline-cta\"> <pee><strong>Building a multi-tenant SaaS that needs gmail.modify or mail.google.com?<\/strong> The restricted scope review adds weeks to your launch timeline. With Unipile, you skip the consent screen review entirely – Unipile’s verified OAuth app covers the scopes your integration needs.<\/pee> <span class=\"s9-icta-btn\" data-upl-link=\"https:\/\/dashboard.unipile.com\/signup\/\" data-upl-target=\"_blank\"><span>Build with Unipile<\/span><svg viewBox=\"0 0 24 24\"><line x1=\"5\" y1=\"12\" x2=\"19\" y2=\"12\"\/><polyline points=\"12 5 19 12 12 19\"\/><\/svg><\/span> <\/div> <\/div><\/div><script>(function(){ function init(){ var el = document.getElementById('upl-gako-s9'); if (!el) return; el.addEventListener('click', function(e){ var t = e.target.closest('[data-upl-link]'); if (!t) return; var url = t.getAttribute('data-upl-link'); var target = t.getAttribute('data-upl-target') || '_self'; if (url) window.open(url, target); }); } if (document.readyState === 'loading') { document.addEventListener('DOMContentLoaded', init); } else { init(); }})();<\/script>[\/et_pb_code][\/et_pb_column][\/et_pb_row][\/et_pb_section][et_pb_section fb_built=”1″ _builder_version=”4.27.3″ background_color=”transparent” custom_padding=”0px|0px|0px|0px|false|false” global_colors_info=”{}” theme_builder_area=”post_content” da_is_popup=”off” da_exit_intent=”off” da_has_close=”on” da_alt_close=”off” da_dark_close=”off” da_not_modal=”on” da_is_singular=”off” da_with_loader=”off” da_has_shadow=”on” da_disable_devices=”off|off|off”][et_pb_row _builder_version=”4.27.3″ background_color=”transparent” global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_column type=”4_4″ _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_code _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”]<link href=\"https:\/\/fonts.googleapis.com\/css2?family=Inter:wght@400;500;600;700&family=Poppins:wght@700;800&display=swap\" rel=\"stylesheet\"><style>#upl-gako-s10,#upl-gako-s10 *,#upl-gako-s10 *::before,#upl-gako-s10 *::after { margin: 0 !important; padding: 0 !important; box-sizing: border-box !important; border: none !important; outline: none !important; font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif !important; line-height: 1.5 !important; letter-spacing: normal !important; text-transform: none !important; text-decoration: none !important; list-style: none !important;}#upl-gako-s10 { background: #f4f5f7 !important; padding: 60px 20px !important;}#upl-gako-s10 .s10-container { max-width: 1100px !important; margin: 0 auto !important;}#upl-gako-s10 .s10-badge { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: rgba(59,185,139,0.12) !important; color: #2aaa7e !important; padding: 6px 14px !important; border-radius: 20px !important; font-size: 12px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.5px !important; margin-bottom: 16px !important; width: fit-content !important;}#upl-gako-s10 .s10-badge .s10-dot { width: 7px !important; height: 7px !important; background: #3BB98B !important; border-radius: 50% !important; flex-shrink: 0 !important;}#upl-gako-s10 .s10-h2 { font-family: 'Poppins', sans-serif !important; font-size: 35px !important; font-weight: 700 !important; color: #0f2736 !important; line-height: 1.2 !important; margin-bottom: 16px !important;}#upl-gako-s10 .s10-intro { font-size: 17px !important; color: #383838 !important; line-height: 1.75 !important; margin-bottom: 40px !important;}#upl-gako-s10 .s10-cards { display: grid !important; grid-template-columns: repeat(3, 1fr) !important; gap: 20px !important; margin-bottom: 40px !important;}#upl-gako-s10 .s10-card { background: #ffffff !important; border: 2px solid #e5e7eb !important; border-radius: 16px !important; padding: 26px !important; display: flex !important; flex-direction: column !important; gap: 0 !important;}#upl-gako-s10 .s10-card.card-highlight { border-color: #3BB98B !important; background: rgba(59,185,139,0.04) !important;}#upl-gako-s10 .s10-card-eyebrow { font-size: 11px !important; font-weight: 700 !important; color: #94a3b8 !important; text-transform: uppercase !important; letter-spacing: 0.8px !important; margin-bottom: 10px !important; display: block !important;}#upl-gako-s10 .s10-card.card-highlight .s10-card-eyebrow { color: #3BB98B !important;}#upl-gako-s10 .s10-card h3 { font-family: 'Poppins', sans-serif !important; font-size: 16px !important; font-weight: 700 !important; color: #0f2736 !important; margin-bottom: 12px !important; line-height: 1.35 !important;}#upl-gako-s10 .s10-card-q { font-size: 14px !important; font-weight: 600 !important; color: #64748b !important; margin-bottom: 6px !important;}#upl-gako-s10 .s10-card-a { font-size: 14.5px !important; color: #383838 !important; line-height: 1.65 !important; margin-bottom: 16px !important;}#upl-gako-s10 .s10-card-verdict { margin-top: auto !important; padding-top: 16px !important; border-top: 1px solid #e5e7eb !important;}#upl-gako-s10 .s10-card.card-highlight .s10-card-verdict { border-top-color: rgba(59,185,139,0.30) !important;}#upl-gako-s10 .s10-card-verdict-label { font-size: 11px !important; font-weight: 700 !important; color: #94a3b8 !important; text-transform: uppercase !important; letter-spacing: 0.5px !important; margin-bottom: 6px !important; display: block !important;}#upl-gako-s10 .s10-verdict-pill { display: inline-flex !important; align-items: center !important; gap: 6px !important; padding: 5px 12px !important; border-radius: 20px !important; font-size: 12px !important; font-weight: 700 !important;}#upl-gako-s10 .s10-verdict-pill svg { width: 12px !important; height: 12px !important; stroke: currentColor !important; fill: none !important; stroke-width: 2.5 !important; stroke-linecap: round !important; stroke-linejoin: round !important; flex-shrink: 0 !important;}#upl-gako-s10 .pill-path1 { background: rgba(59,130,246,0.10) !important; color: #2563eb !important; }#upl-gako-s10 .pill-path2 { background: rgba(168,85,247,0.10) !important; color: #7c3aed !important; }#upl-gako-s10 .pill-path3 { background: rgba(59,185,139,0.12) !important; color: #2aaa7e !important; }\/* CTA final strip *\/#upl-gako-s10 .s10-final-cta { background: #0f2736 !important; border-radius: 16px !important; padding: 40px 40px !important; text-align: center !important;}#upl-gako-s10 .s10-final-cta h3 { font-family: 'Poppins', sans-serif !important; font-size: 26px !important; font-weight: 700 !important; color: #ffffff !important; margin-bottom: 12px !important; line-height: 1.3 !important;}#upl-gako-s10 .s10-final-cta p { font-size: 16px !important; color: rgba(255,255,255,0.75) !important; line-height: 1.7 !important; margin-bottom: 28px !important;}#upl-gako-s10 .s10-final-cta p a { color: #DDDF4C !important; text-decoration: underline !important;}#upl-gako-s10 .s10-final-actions { display: flex !important; align-items: center !important; justify-content: center !important; gap: 14px !important; flex-wrap: wrap !important;}#upl-gako-s10 .s10-final-btn-primary { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: #DDDF4C !important; color: #0f2736 !important; padding: 14px 28px !important; border-radius: 8px !important; font-size: 1rem !important; font-weight: 600 !important; border: 2px solid #DDDF4C !important; transition: transform 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important;}#upl-gako-s10 .s10-final-btn-primary:hover { transform: translateY(-5px) !important;}#upl-gako-s10 .s10-final-btn-primary svg { width: 16px !important; height: 16px !important; stroke: currentColor !important; fill: none !important; stroke-width: 2.5 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}#upl-gako-s10 .s10-final-btn-secondary { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: transparent !important; color: #ffffff !important; padding: 14px 28px !important; border-radius: 8px !important; font-size: 1rem !important; font-weight: 600 !important; border: 2px solid rgba(255,255,255,0.30) !important; transition: all 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important;}#upl-gako-s10 .s10-final-btn-secondary:hover { border-color: rgba(255,255,255,0.70) !important;}#upl-gako-s10 .s10-final-btn-secondary svg { width: 16px !important; height: 16px !important; stroke: currentColor !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}\/* Cross-links *\/#upl-gako-s10 .s10-crosslinks { display: grid !important; grid-template-columns: repeat(2, 1fr) !important; gap: 12px !important; margin-top: 28px !important;}#upl-gako-s10 .s10-crosslink { background: rgba(255,255,255,0.06) !important; border: 1px solid rgba(255,255,255,0.12) !important; border-radius: 10px !important; padding: 14px 18px !important; display: flex !important; align-items: center !important; gap: 10px !important; cursor: pointer !important; transition: background 0.2s ease !important;}#upl-gako-s10 .s10-crosslink:hover { background: rgba(255,255,255,0.10) !important;}#upl-gako-s10 .s10-crosslink svg { width: 16px !important; height: 16px !important; stroke: #DDDF4C !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important; flex-shrink: 0 !important;}#upl-gako-s10 .s10-crosslink-text { font-size: 13px !important; color: rgba(255,255,255,0.80) !important; line-height: 1.4 !important;}#upl-gako-s10 .s10-crosslink-text strong { color: #ffffff !important; display: block !important; font-size: 13px !important; font-weight: 600 !important; margin-bottom: 2px !important;}@media (max-width: 900px) { #upl-gako-s10 .s10-h2 { font-size: 28px !important; } #upl-gako-s10 .s10-cards { grid-template-columns: 1fr !important; } #upl-gako-s10 .s10-crosslinks { grid-template-columns: 1fr !important; } #upl-gako-s10 { padding: 50px 20px !important; } #upl-gako-s10 .s10-final-cta { padding: 32px 24px !important; }}@media (max-width: 600px) { #upl-gako-s10 .s10-h2 { font-size: 26px !important; } #upl-gako-s10 .s10-final-btn-primary, #upl-gako-s10 .s10-final-btn-secondary { width: 100% !important; justify-content: center !important; } #upl-gako-s10 .s10-final-cta h3 { font-size: 22px !important; }}<\/style><div id=\"upl-gako-s10\"> <div class=\"s10-container\"> <span id=\"decision-tree\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"s10-badge\"><span class=\"s10-dot\"><\/span><span>Decision Guide<\/span><\/div> <h2 class=\"s10-h2\">Decision Tree: Which Auth Method for Your Use Case?<\/h2> <pee class=\"s10-intro\">Answer three questions and you’ll know exactly which Gmail API authentication path applies to your project. There’s no universal answer – each path solves a different problem. For the full <a href=\"https:\/\/www.unipile.com\/communication-api\/email-api\/duplicate-enhance-your-email-software-with-gmail-api-integration\/\" style=\"color:#2aaa7e!important;text-decoration:underline!important;\">complete Gmail API integration guide<\/a>, continue to the Gmail hub. For <a href=\"https:\/\/www.unipile.com\/microsoft-graph-api-email\/\" style=\"color:#2aaa7e!important;text-decoration:underline!important;\">the equivalent for Outlook \/ Microsoft 365<\/a>, see our Microsoft Graph OAuth guide.<\/pee> <div class=\"s10-cards\">  <div class=\"s10-card\"> <span class=\"s10-card-eyebrow\">Use case A<\/span> <h3>SaaS app where customers connect their own Gmail<\/h3> <div> <pee class=\"s10-card-q\">Are your users external (not your employees)?<\/pee> <pee class=\"s10-card-a\">Yes – they’re your customers with personal Gmail or Google Workspace accounts.<\/pee> <pee class=\"s10-card-q\">Do you need to support many different Google domains?<\/pee> <pee class=\"s10-card-a\">Yes – multi-tenant. Each user connects their own account.<\/pee> <\/div> <div class=\"s10-card-verdict\"> <span class=\"s10-card-verdict-label\">Recommended path<\/span> <span class=\"s10-verdict-pill pill-path1\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Path 1 – OAuth Client ID<\/span><\/span> <pee style=\"font-size:13px!important;color:#64748b!important;margin-top:8px!important;line-height:1.5!important;\">Or Path 3 (Unified API) to skip the OAuth infrastructure entirely.<\/pee> <\/div> <\/div>  <div class=\"s10-card\"> <span class=\"s10-card-eyebrow\">Use case B<\/span> <h3>Internal tool for your own Google Workspace org<\/h3> <div> <pee class=\"s10-card-q\">Are all users on the same Workspace domain (your employees)?<\/pee> <pee class=\"s10-card-a\">Yes – company.com accounts only. No external Gmail users.<\/pee> <pee class=\"s10-card-q\">Do you have a Workspace admin who can configure DWD?<\/pee> <pee class=\"s10-card-a\">Yes – admin access available in admin.google.com.<\/pee> <\/div> <div class=\"s10-card-verdict\"> <span class=\"s10-card-verdict-label\">Recommended path<\/span> <span class=\"s10-verdict-pill pill-path2\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Path 2 – Service Account + DWD<\/span><\/span> <pee style=\"font-size:13px!important;color:#64748b!important;margin-top:8px!important;line-height:1.5!important;\">No per-user consent flows. Admin delegates once.<\/pee> <\/div> <\/div>  <div class=\"s10-card card-highlight\"> <span class=\"s10-card-eyebrow\">Use case C – Most common<\/span> <h3>SaaS app that needs Gmail + Outlook + IMAP under one API<\/h3> <div> <pee class=\"s10-card-q\">Do your users have a mix of Gmail, Outlook, and IMAP accounts?<\/pee> <pee class=\"s10-card-a\">Yes – you can’t predict which provider each user will connect.<\/pee> <pee class=\"s10-card-q\">Do you want to avoid running separate OAuth integrations per provider?<\/pee> <pee class=\"s10-card-a\">Yes – managing Google OAuth + Microsoft OAuth + IMAP is too much complexity.<\/pee> <\/div> <div class=\"s10-card-verdict\"> <span class=\"s10-card-verdict-label\">Recommended path<\/span> <span class=\"s10-verdict-pill pill-path3\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Path 3 – Unified API (Unipile)<\/span><\/span> <pee style=\"font-size:13px!important;color:#2aaa7e!important;margin-top:8px!important;line-height:1.5!important;\">One API key. Gmail, Outlook, IMAP. No OAuth ops.<\/pee> <\/div> <\/div> <\/div>  <div class=\"s10-final-cta\"> <h3>Start building your Gmail integration today<\/h3> <pee>No matter which path you choose, Unipile gives you a <a href=\"https:\/\/www.unipile.com\/email-api\/\" style=\"color:#DDDF4C!important;text-decoration:underline!important;\">unified email API overview<\/a> to understand the architecture before you commit to an approach. Or skip straight to the dashboard and link your first account in minutes.<\/pee> <div class=\"s10-final-actions\"> <span class=\"s10-final-btn-primary\" data-upl-link=\"https:\/\/dashboard.unipile.com\/signup\/\" data-upl-target=\"_blank\"><span>Build it with Unipile<\/span><svg viewBox=\"0 0 24 24\"><line x1=\"5\" y1=\"12\" x2=\"19\" y2=\"12\"\/><polyline points=\"12 5 19 12 12 19\"\/><\/svg><\/span> <span class=\"s10-final-btn-secondary\" data-upl-link=\"https:\/\/developer.unipile.com\/docs\/getting-started\" data-upl-target=\"_blank\"><span>Read the docs<\/span><svg viewBox=\"0 0 24 24\"><polyline points=\"9 18 15 12 9 6\"\/><\/svg><\/span> <\/div> <div class=\"s10-crosslinks\"> <div class=\"s10-crosslink\" data-upl-link=\"https:\/\/www.unipile.com\/communication-api\/email-api\/duplicate-enhance-your-email-software-with-gmail-api-integration\/\" data-upl-target=\"_self\"> <svg viewBox=\"0 0 24 24\"><polyline points=\"9 18 15 12 9 6\"\/><\/svg> <div class=\"s10-crosslink-text\"><strong>Gmail API integration guide<\/strong>Complete setup, endpoints, and code examples<\/div> <\/div> <div class=\"s10-crosslink\" data-upl-link=\"https:\/\/www.unipile.com\/oauth-email-api\/\" data-upl-target=\"_self\"> <svg viewBox=\"0 0 24 24\"><polyline points=\"9 18 15 12 9 6\"\/><\/svg> <div class=\"s10-crosslink-text\"><strong>OAuth flow for email APIs in detail<\/strong>Deep dive into the authorization code flow<\/div> <\/div> <div class=\"s10-crosslink\" data-upl-link=\"https:\/\/www.unipile.com\/email-sync-api\/\" data-upl-target=\"_self\"> <svg viewBox=\"0 0 24 24\"><polyline points=\"9 18 15 12 9 6\"\/><\/svg> <div class=\"s10-crosslink-text\"><strong>How email sync works under the hood<\/strong>Webhooks, polling, and delta sync explained<\/div> <\/div> <div class=\"s10-crosslink\" data-upl-link=\"https:\/\/www.unipile.com\/email-api-providers\/\" data-upl-target=\"_self\"> <svg viewBox=\"0 0 24 24\"><polyline points=\"9 18 15 12 9 6\"\/><\/svg> <div class=\"s10-crosslink-text\"><strong>Compare email sync API providers<\/strong>Unipile vs. building OAuth yourself<\/div> <\/div> <\/div> <\/div> <\/div><\/div><script>(function(){ function init(){ var el = document.getElementById('upl-gako-s10'); if (!el) return; el.addEventListener('click', function(e){ var t = e.target.closest('[data-upl-link]'); if (!t) return; var url = t.getAttribute('data-upl-link'); var target = t.getAttribute('data-upl-target') || '_self'; if (url) window.open(url, target); }); } if (document.readyState === 'loading') { document.addEventListener('DOMContentLoaded', init); } else { init(); }})();<\/script>[\/et_pb_code][\/et_pb_column][\/et_pb_row][\/et_pb_section][et_pb_section fb_built=”1″ _builder_version=”4.27.3″ background_color=”transparent” custom_padding=”0px|0px|0px|0px|false|false” global_colors_info=”{}” theme_builder_area=”post_content” da_is_popup=”off” da_exit_intent=”off” da_has_close=”on” da_alt_close=”off” da_dark_close=”off” da_not_modal=”on” da_is_singular=”off” da_with_loader=”off” da_has_shadow=”on” da_disable_devices=”off|off|off”][et_pb_row _builder_version=”4.27.3″ background_color=”transparent” global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_column type=”4_4″ _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_code _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”]<script type=\"application\/ld+json\">{ \"@context\": \"https:\/\/schema.org\", \"@type\": \"FAQPage\", \"mainEntity\": [ { \"@type\": \"Question\", \"name\": \"Can I use a Google API key to access Gmail?\", \"acceptedAnswer\": { \"@type\": \"Answer\", \"text\": \"No. Google API keys only work for public, non-user-specific APIs like Maps, Translate, or YouTube Data (public content). Gmail API accesses private user mailbox data, which requires explicit user consent via OAuth 2.0. Sending a request to the Gmail API with only an API key returns a 401 Login Required or 403 Daily Limit for Unauthenticated Use Exceeded error.\" } }, { \"@type\": \"Question\", \"name\": \"Does the Gmail API require OAuth 2.0?\", \"acceptedAnswer\": { \"@type\": \"Answer\", \"text\": \"Yes, always. Gmail API access is user-data access, which means every request must be tied to an authenticated user who has granted consent via an OAuth 2.0 flow. There is no workaround: no API key, no basic auth (deprecated September 2024), no magic header. The three supported authentication paths are: OAuth 2.0 Client ID (multi-tenant), Service Account with Domain-Wide Delegation (Workspace only), and a unified email API like Unipile that handles the OAuth layer for you.\" } }, { \"@type\": \"Question\", \"name\": \"What's the difference between an API key and an OAuth client ID on Google Cloud?\", \"acceptedAnswer\": { \"@type\": \"Answer\", \"text\": \"An API key identifies your Google Cloud project for billing and quota purposes. It works only for APIs that serve public data (Maps, Translate, etc.). An OAuth client ID is used to initiate a consent flow where a real user approves your app's access to their account. The OAuth client ID is what generates the access token and refresh token that Gmail API actually accepts. These are two entirely different mechanisms: one identifies a project, the other authenticates a user.\" } }, { \"@type\": \"Question\", \"name\": \"Can a service account read Gmail without user consent?\", \"acceptedAnswer\": { \"@type\": \"Answer\", \"text\": \"Only if Domain-Wide Delegation (DWD) is enabled by a Google Workspace admin. A service account by itself cannot access any Gmail inbox. With DWD configured, the service account can impersonate any user in the organization and access their mailbox without interactive consent. Important: this only works for Google Workspace (business) accounts. It does not work for personal Gmail addresses (@gmail.com).\" } }, { \"@type\": \"Question\", \"name\": \"Why does Gmail API return 'Login Required' with my API key?\", \"acceptedAnswer\": { \"@type\": \"Answer\", \"text\": \"Because Gmail API does not accept API keys. The 401 Login Required error means the request lacks a valid OAuth 2.0 access token in the Authorization header. Gmail API expects: Authorization: Bearer {access_token} - where the access token was obtained via an OAuth 2.0 flow (authorization code, service account JWT, or a unified API token). Simply appending ?key=YOUR_API_KEY to the Gmail API URL will not work and will either return 401 or 403.\" } }, { \"@type\": \"Question\", \"name\": \"Is there a way to use Gmail API without managing OAuth myself?\", \"acceptedAnswer\": { \"@type\": \"Answer\", \"text\": \"Yes. A unified email API like Unipile handles the entire OAuth layer: the consent screen, the token exchange, and the silent refresh token rotation. Your application never stores or manages access tokens or refresh tokens. You simply call the Unipile API with your own API key, and Unipile handles all OAuth communication with Google on behalf of your linked accounts. This removes the Google consent screen approval process and the token management complexity from your codebase.\" } } ]}<\/script><link href=\"https:\/\/fonts.googleapis.com\/css2?family=Inter:wght@400;500;600;700&family=Poppins:wght@700;800&display=swap\" rel=\"stylesheet\"><style>#upl-gako-faq,#upl-gako-faq *,#upl-gako-faq *::before,#upl-gako-faq *::after { margin: 0 !important; padding: 0 !important; box-sizing: border-box !important; border: none !important; outline: none !important; font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif !important; line-height: 1.5 !important; letter-spacing: normal !important; text-transform: none !important; text-decoration: none !important; list-style: none !important;}#upl-gako-faq { background: #f4f5f7 !important; padding: 70px 24px !important;}#upl-gako-faq .faq-container { max-width: 900px !important; margin: 0 auto !important;}#upl-gako-faq .faq-badge { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: rgba(59,185,139,0.12) !important; color: #2aaa7e !important; padding: 6px 14px !important; border-radius: 20px !important; font-size: 12px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.5px !important; margin-bottom: 16px !important; width: fit-content !important;}#upl-gako-faq .faq-badge .faq-dot { width: 7px !important; height: 7px !important; background: #3BB98B !important; border-radius: 50% !important; flex-shrink: 0 !important;}#upl-gako-faq .faq-h2 { font-family: 'Poppins', sans-serif !important; font-size: 35px !important; font-weight: 700 !important; color: #0f2736 !important; line-height: 1.2 !important; margin-bottom: 12px !important;}#upl-gako-faq .faq-intro { font-size: 16px !important; color: #383838 !important; line-height: 1.75 !important; margin-bottom: 36px !important;}#upl-gako-faq .faq-list { display: flex !important; flex-direction: column !important; gap: 12px !important; margin-bottom: 40px !important;}#upl-gako-faq .faq-item { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; overflow: hidden !important; transition: border-color 0.2s ease !important;}#upl-gako-faq .faq-item.active { border-color: #3BB98B !important;}#upl-gako-faq .faq-item-header { padding: 20px 24px !important; display: flex !important; align-items: center !important; gap: 16px !important; cursor: pointer !important; user-select: none !important;}#upl-gako-faq .faq-num { width: 38px !important; height: 38px !important; min-width: 38px !important; border-radius: 10px !important; background: rgba(59,185,139,0.10) !important; color: #2aaa7e !important; display: flex !important; align-items: center !important; justify-content: center !important; font-family: 'Poppins', sans-serif !important; font-size: 13px !important; font-weight: 700 !important; transition: background 0.2s ease, color 0.2s ease !important; flex-shrink: 0 !important;}#upl-gako-faq .faq-item.active .faq-num { background: #3BB98B !important; color: #ffffff !important;}#upl-gako-faq .faq-question { font-size: 16px !important; font-weight: 600 !important; color: #0f2736 !important; line-height: 1.4 !important; flex: 1 !important;}#upl-gako-faq .faq-toggle { width: 22px !important; height: 22px !important; min-width: 22px !important; border-radius: 6px !important; background: rgba(59,185,139,0.08) !important; display: flex !important; align-items: center !important; justify-content: center !important; transition: background 0.2s ease, transform 0.3s ease !important; flex-shrink: 0 !important;}#upl-gako-faq .faq-item.active .faq-toggle { background: #3BB98B !important; transform: rotate(45deg) !important;}#upl-gako-faq .faq-toggle svg { width: 14px !important; height: 14px !important; stroke: #3BB98B !important; fill: none !important; stroke-width: 2.5 !important; stroke-linecap: round !important; stroke-linejoin: round !important; transition: stroke 0.2s ease !important;}#upl-gako-faq .faq-item.active .faq-toggle svg { stroke: #ffffff !important;}#upl-gako-faq .faq-body { max-height: 0 !important; overflow: hidden !important; transition: max-height 0.35s ease !important;}#upl-gako-faq .faq-body.open { max-height: 800px !important;}#upl-gako-faq .faq-answer { padding: 0 28px 28px 76px !important; font-size: 15px !important; color: #4a5568 !important; line-height: 1.78 !important;}#upl-gako-faq .faq-answer a { color: #2aaa7e !important; text-decoration: underline !important;}#upl-gako-faq .faq-answer strong { color: #0f2736 !important; font-weight: 700 !important;}#upl-gako-faq .faq-answer code { background: rgba(0,0,0,0.06) !important; padding: 2px 5px !important; border-radius: 4px !important; font-family: 'Courier New', monospace !important; font-size: 12.5px !important;}\/* CTA bar *\/#upl-gako-faq .faq-cta-bar { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; padding: 24px 28px !important; display: flex !important; align-items: center !important; justify-content: space-between !important; gap: 20px !important; flex-wrap: wrap !important;}#upl-gako-faq .faq-cta-text { font-size: 15.5px !important; color: #383838 !important; line-height: 1.6 !important;}#upl-gako-faq .faq-cta-text strong { color: #0f2736 !important;}#upl-gako-faq .faq-cta-btn { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: #DDDF4C !important; color: #0f2736 !important; border: 2px solid #DDDF4C !important; padding: 12px 22px !important; border-radius: 8px !important; font-size: 0.9rem !important; font-weight: 600 !important; cursor: pointer !important; white-space: nowrap !important; transition: transform 0.3s ease !important; flex-shrink: 0 !important;}#upl-gako-faq .faq-cta-btn:hover { transform: translateY(-3px) !important;}#upl-gako-faq .faq-cta-btn svg { width: 14px !important; height: 14px !important; stroke: currentColor !important; fill: none !important; stroke-width: 2.5 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}@media (max-width: 900px) { #upl-gako-faq .faq-h2 { font-size: 28px !important; } #upl-gako-faq { padding: 50px 16px !important; } #upl-gako-faq .faq-answer { padding: 0 16px 20px 16px !important; }}@media (max-width: 600px) { #upl-gako-faq .faq-h2 { font-size: 26px !important; } #upl-gako-faq .faq-cta-bar { flex-direction: column !important; align-items: flex-start !important; } #upl-gako-faq .faq-cta-btn { width: 100% !important; justify-content: center !important; }}<\/style><div id=\"upl-gako-faq\"> <div class=\"faq-container\"> <span id=\"gmail-api-key-vs-oauth-faq\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"faq-badge\"><span class=\"faq-dot\"><\/span><span>FAQ<\/span><\/div> <h2 class=\"faq-h2\">Frequently Asked Questions<\/h2> <pee class=\"faq-intro\">The most common questions about Gmail API authentication, API keys vs OAuth tokens, and how to access Gmail programmatically without managing OAuth yourself.<\/pee> <div class=\"faq-list\"> <div class=\"faq-item\" data-faq-idx=\"0\"> <div class=\"faq-item-header\"> <div class=\"faq-num\">01<\/div> <pee class=\"faq-question\">Can I use a Google API key to access Gmail?<\/pee> <div class=\"faq-toggle\"><svg viewBox=\"0 0 24 24\"><line x1=\"12\" y1=\"5\" x2=\"12\" y2=\"19\"\/><line x1=\"5\" y1=\"12\" x2=\"19\" y2=\"12\"\/><\/svg><\/div> <\/div> <div class=\"faq-body\"> <div class=\"faq-answer\"> <pee>No. Google API keys only work for public, non-user-specific APIs like Maps, Translate, or YouTube Data (public content). Gmail API accesses <strong>private user mailbox data<\/strong>, which requires explicit user consent via OAuth 2.0. Sending a request to the Gmail API with only an API key returns a <code>401 Login Required<\/code> or <code>403 Daily Limit for Unauthenticated Use Exceeded<\/code> error – every time, with no exception.<\/pee> <\/div> <\/div> <\/div> <div class=\"faq-item\" data-faq-idx=\"1\"> <div class=\"faq-item-header\"> <div class=\"faq-num\">02<\/div> <pee class=\"faq-question\">Does the Gmail API require OAuth 2.0?<\/pee> <div class=\"faq-toggle\"><svg viewBox=\"0 0 24 24\"><line x1=\"12\" y1=\"5\" x2=\"12\" y2=\"19\"\/><line x1=\"5\" y1=\"12\" x2=\"19\" y2=\"12\"\/><\/svg><\/div> <\/div> <div class=\"faq-body\"> <div class=\"faq-answer\"> <pee>Yes, always. Gmail API access is user-data access, which means every request must be tied to an authenticated user who has granted consent via an OAuth 2.0 flow. There is no workaround: no API key, no basic auth (<strong>deprecated September 2024<\/strong>), no magic header. The three supported authentication paths are: OAuth 2.0 Client ID (multi-tenant), Service Account with Domain-Wide Delegation (Workspace only), and a unified email API like Unipile that handles the OAuth layer for you.<\/pee> <\/div> <\/div> <\/div> <div class=\"faq-item\" data-faq-idx=\"2\"> <div class=\"faq-item-header\"> <div class=\"faq-num\">03<\/div> <pee class=\"faq-question\">What’s the difference between an API key and an OAuth client ID on Google Cloud?<\/pee> <div class=\"faq-toggle\"><svg viewBox=\"0 0 24 24\"><line x1=\"12\" y1=\"5\" x2=\"12\" y2=\"19\"\/><line x1=\"5\" y1=\"12\" x2=\"19\" y2=\"12\"\/><\/svg><\/div> <\/div> <div class=\"faq-body\"> <div class=\"faq-answer\"> <pee>An <strong>API key<\/strong> identifies your Google Cloud project for billing and quota purposes. It works only for APIs that serve public data (Maps, Translate, etc.). An <strong>OAuth client ID<\/strong> is used to initiate a consent flow where a real user approves your app’s access to their account. The OAuth client ID generates the access token and refresh token that Gmail API actually accepts. These are two entirely different mechanisms: one identifies a project, the other authenticates a user.<\/pee> <\/div> <\/div> <\/div> <div class=\"faq-item\" data-faq-idx=\"3\"> <div class=\"faq-item-header\"> <div class=\"faq-num\">04<\/div> <pee class=\"faq-question\">Can a service account read Gmail without user consent?<\/pee> <div class=\"faq-toggle\"><svg viewBox=\"0 0 24 24\"><line x1=\"12\" y1=\"5\" x2=\"12\" y2=\"19\"\/><line x1=\"5\" y1=\"12\" x2=\"19\" y2=\"12\"\/><\/svg><\/div> <\/div> <div class=\"faq-body\"> <div class=\"faq-answer\"> <pee>Only if <strong>Domain-Wide Delegation (DWD)<\/strong> is enabled by a Google Workspace admin. A service account by itself cannot access any Gmail inbox. With DWD configured, the service account can impersonate any user in the organization and access their mailbox without interactive consent. Critical limitation: this only works for Google Workspace (business) accounts. It does not work for personal Gmail addresses (<code>@gmail.com<\/code>). See <a href=\"https:\/\/support.google.com\/a\/answer\/162106\" target=\"_blank\" rel=\"noopener\">Google’s official DWD documentation<\/a>.<\/pee> <\/div> <\/div> <\/div> <div class=\"faq-item\" data-faq-idx=\"4\"> <div class=\"faq-item-header\"> <div class=\"faq-num\">05<\/div> <pee class=\"faq-question\">Why does Gmail API return “Login Required” with my API key?<\/pee> <div class=\"faq-toggle\"><svg viewBox=\"0 0 24 24\"><line x1=\"12\" y1=\"5\" x2=\"12\" y2=\"19\"\/><line x1=\"5\" y1=\"12\" x2=\"19\" y2=\"12\"\/><\/svg><\/div> <\/div> <div class=\"faq-body\"> <div class=\"faq-answer\"> <pee>Because <strong>Gmail API does not accept API keys<\/strong>. The <code>401 Login Required<\/code> error means the request lacks a valid OAuth 2.0 access token in the <code>Authorization<\/code> header. Gmail API expects: <code>Authorization: Bearer {access_token}<\/code> – where the access token was obtained via an OAuth 2.0 flow (authorization code, service account JWT, or a unified API token). Simply appending <code>?key=YOUR_API_KEY<\/code> to the Gmail API URL will not work and will return 401 or 403.<\/pee> <\/div> <\/div> <\/div> <div class=\"faq-item\" data-faq-idx=\"5\"> <div class=\"faq-item-header\"> <div class=\"faq-num\">06<\/div> <pee class=\"faq-question\">Is there a way to use Gmail API without managing OAuth myself?<\/pee> <div class=\"faq-toggle\"><svg viewBox=\"0 0 24 24\"><line x1=\"12\" y1=\"5\" x2=\"12\" y2=\"19\"\/><line x1=\"5\" y1=\"12\" x2=\"19\" y2=\"12\"\/><\/svg><\/div> <\/div> <div class=\"faq-body\"> <div class=\"faq-answer\"> <pee>Yes. A unified email API like <a href=\"https:\/\/www.unipile.com\/email-api\/\">Unipile<\/a> handles the entire OAuth layer: the consent screen, the token exchange, and the silent refresh token rotation. Your application never stores or manages access tokens or refresh tokens. You call the Unipile API with your own API key, and Unipile handles all OAuth communication with Google on behalf of your <strong>linked accounts<\/strong>. This removes the Google consent screen approval process and the token management complexity from your codebase – and gives you Gmail, Outlook, and IMAP under one unified interface.<\/pee> <\/div> <\/div> <\/div> <\/div>  <div class=\"faq-cta-bar\"> <pee class=\"faq-cta-text\"><strong>Still have questions about Gmail API authentication?<\/strong> Our team can walk you through the right setup for your use case.<\/pee> <span class=\"faq-cta-btn\" onclick=\"if(window.$crisp){$crisp.push(['do','chat:open'])}\"><span>Talk to an expert<\/span><svg viewBox=\"0 0 24 24\"><line x1=\"5\" y1=\"12\" x2=\"19\" y2=\"12\"\/><polyline points=\"12 5 19 12 12 19\"\/><\/svg><\/span> <\/div> <\/div><\/div><script>(function(){ function init(){ var faq = document.getElementById('upl-gako-faq'); if (!faq) return; var items = faq.querySelectorAll('.faq-item'); items.forEach(function(item){ var header = item.querySelector('.faq-item-header'); var body = item.querySelector('.faq-body'); if (!header || !body) return; header.addEventListener('click', function(){ var isOpen = item.classList.contains('active'); items.forEach(function(i){ i.classList.remove('active'); var b = i.querySelector('.faq-body'); if (b) b.classList.remove('open'); }); if (!isOpen) { item.classList.add('active'); body.classList.add('open'); } }); }); } if (document.readyState === 'loading') { document.addEventListener('DOMContentLoaded', init); } else { init(); }})();<\/script>[\/et_pb_code][\/et_pb_column][\/et_pb_row][\/et_pb_section]\n","protected":false},"excerpt":{"rendered":"<p>Path 1 of 3 Path 1 – OAuth 2.0 Client ID (Multi-Tenant SaaS) If you’re building a SaaS product where your customers connect their own Gmail accounts, the OAuth 2.0 authorization code flow is the standard path. This is the 3-legged flow: your app, Google, and the end user. It requires setting up a Google […]<\/p>\n","protected":false},"author":4,"featured_media":278949,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_et_pb_use_builder":"on","_et_pb_old_content":"","_et_gb_content_width":"","inline_featured_image":false,"footnotes":""},"categories":[69,73],"tags":[],"post_folder":[],"class_list":["post-278929","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-api-guidelines","category-email-api-integration"],"yoast_head":"\n<title>Gmail API Key vs OAuth: Why You Can't Skip OAuth (and What to Use Instead) - Unipile<\/title>\n<meta name=\"description\" content=\"Learn when to use Gmail API keys vs OAuth. Compare security, ease of setup, and real-world scenarios. See OAuth best practices for production apps. Start building.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.unipile.com\/tr\/gmail-api-anahtari-vs-oauth\/\" \/>\n<meta property=\"og:locale\" content=\"tr_TR\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Gmail API Key vs OAuth: Why You Can't Skip OAuth (and What to Use Instead) - Unipile\" \/>\n<meta property=\"og:description\" content=\"Learn when to use Gmail API keys vs OAuth. Compare security, ease of setup, and real-world scenarios. See OAuth best practices for production apps. Start building.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.unipile.com\/tr\/gmail-api-anahtari-vs-oauth\/\" \/>\n<meta property=\"og:site_name\" content=\"Unipile\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/unipilefr\" \/>\n<meta property=\"article:published_time\" content=\"2026-05-25T09:49:40+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-05-25T09:50:32+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.unipile.com\/wp-content\/uploads\/2026\/05\/gmail-api-key-vs-oauth.png\" \/>\n\t<meta property=\"og:image:width\" content=\"2400\" \/>\n\t<meta property=\"og:image:height\" content=\"1260\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"Damien Girardeau\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@UnipileAPI\" \/>\n<meta name=\"twitter:site\" content=\"@UnipileAPI\" \/>\n<meta name=\"twitter:label1\" content=\"Yazan:\" \/>\n\t<meta name=\"twitter:data1\" content=\"Damien Girardeau\" \/>\n\t<meta name=\"twitter:label2\" content=\"Tahmini okuma s\u00fcresi\" \/>\n\t<meta name=\"twitter:data2\" content=\"17 dakika\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-key-vs-oauth\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-key-vs-oauth\\\/\"},\"author\":{\"name\":\"Damien Girardeau\",\"@id\":\"https:\\\/\\\/www.unipile.com\\\/#\\\/schema\\\/person\\\/a2ac44e22bdc27d497ce8b58716a673e\"},\"headline\":\"Gmail API Key vs OAuth: Why You Can’t Skip OAuth (and What to Use Instead)\",\"datePublished\":\"2026-05-25T09:49:40+00:00\",\"dateModified\":\"2026-05-25T09:50:32+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-key-vs-oauth\\\/\"},\"wordCount\":5025,\"publisher\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/#organization\"},\"image\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-key-vs-oauth\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/www.unipile.com\\\/wp-content\\\/uploads\\\/2026\\\/05\\\/gmail-api-key-vs-oauth.png\",\"articleSection\":[\"API Guidelines\",\"Email API Integration\"],\"inLanguage\":\"tr\"},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-key-vs-oauth\\\/\",\"url\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-key-vs-oauth\\\/\",\"name\":\"Gmail API Key vs OAuth: Why You Can't Skip OAuth (and What to Use Instead) - Unipile\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-key-vs-oauth\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-key-vs-oauth\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/www.unipile.com\\\/wp-content\\\/uploads\\\/2026\\\/05\\\/gmail-api-key-vs-oauth.png\",\"datePublished\":\"2026-05-25T09:49:40+00:00\",\"dateModified\":\"2026-05-25T09:50:32+00:00\",\"description\":\"Learn when to use Gmail API keys vs OAuth. Compare security, ease of setup, and real-world scenarios. See OAuth best practices for production apps. Start building.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-key-vs-oauth\\\/#breadcrumb\"},\"inLanguage\":\"tr\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.unipile.com\\\/gmail-api-key-vs-oauth\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"tr\",\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-key-vs-oauth\\\/#primaryimage\",\"url\":\"https:\\\/\\\/www.unipile.com\\\/wp-content\\\/uploads\\\/2026\\\/05\\\/gmail-api-key-vs-oauth.png\",\"contentUrl\":\"https:\\\/\\\/www.unipile.com\\\/wp-content\\\/uploads\\\/2026\\\/05\\\/gmail-api-key-vs-oauth.png\",\"width\":2400,\"height\":1260,\"caption\":\"Gmail API Key vs OAuth: why OAuth is required and how to implement it\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-key-vs-oauth\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Accueil\",\"item\":\"https:\\\/\\\/www.unipile.com\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Gmail API Key vs OAuth: Why You Can’t Skip OAuth (and What to Use Instead)\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/www.unipile.com\\\/#website\",\"url\":\"https:\\\/\\\/www.unipile.com\\\/\",\"name\":\"Unipile\",\"description\":\"Integrate Messaging & Email, Connect with Ease via API\",\"publisher\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/www.unipile.com\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"tr\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/www.unipile.com\\\/#organization\",\"name\":\"Unipile\",\"url\":\"https:\\\/\\\/www.unipile.com\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"tr\",\"@id\":\"https:\\\/\\\/www.unipile.com\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/www.unipile.com\\\/wp-content\\\/uploads\\\/2021\\\/05\\\/logo-unipile.png\",\"contentUrl\":\"https:\\\/\\\/www.unipile.com\\\/wp-content\\\/uploads\\\/2021\\\/05\\\/logo-unipile.png\",\"width\":200,\"height\":49,\"caption\":\"Unipile\"},\"image\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/#\\\/schema\\\/logo\\\/image\\\/\"},\"sameAs\":[\"https:\\\/\\\/www.facebook.com\\\/unipilefr\",\"https:\\\/\\\/x.com\\\/UnipileAPI\",\"https:\\\/\\\/www.linkedin.com\\\/company\\\/unipile\\\/\"]},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/www.unipile.com\\\/#\\\/schema\\\/person\\\/a2ac44e22bdc27d497ce8b58716a673e\",\"name\":\"Damien Girardeau\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"tr\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/12dd140720736a8db29f540c42a17d2680cd54a04fb26bb7b55423c179b065a9?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/12dd140720736a8db29f540c42a17d2680cd54a04fb26bb7b55423c179b065a9?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/12dd140720736a8db29f540c42a17d2680cd54a04fb26bb7b55423c179b065a9?s=96&d=mm&r=g\",\"caption\":\"Damien Girardeau\"}}]}<\/script>\n","yoast_head_json":{"title":"Gmail API Anahtar\u0131 vs OAuth: Neden OAuth'u Atlayamazs\u0131n\u0131z (ve Yerine Ne Kullanmal\u0131s\u0131n\u0131z) - Unipile","description":"Gmail API anahtarlar\u0131n\u0131n ne zaman ve OAuth'un ne zaman kullan\u0131laca\u011f\u0131n\u0131 \u00f6\u011frenin. G\u00fcvenlik, kurulum kolayl\u0131\u011f\u0131 ve ger\u00e7ek d\u00fcnya senaryolar\u0131n\u0131 kar\u015f\u0131la\u015ft\u0131r\u0131n. \u00dcretim uygulamalar\u0131 i\u00e7in OAuth en iyi uygulamalar\u0131n\u0131 g\u00f6r\u00fcn. Olu\u015fturmaya ba\u015flay\u0131n.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.unipile.com\/tr\/gmail-api-anahtari-vs-oauth\/","og_locale":"tr_TR","og_type":"article","og_title":"Gmail API Key vs OAuth: Why You Can't Skip OAuth (and What to Use Instead) - Unipile","og_description":"Learn when to use Gmail API keys vs OAuth. Compare security, ease of setup, and real-world scenarios. See OAuth best practices for production apps. Start building.","og_url":"https:\/\/www.unipile.com\/tr\/gmail-api-anahtari-vs-oauth\/","og_site_name":"Unipile","article_publisher":"https:\/\/www.facebook.com\/unipilefr","article_published_time":"2026-05-25T09:49:40+00:00","article_modified_time":"2026-05-25T09:50:32+00:00","og_image":[{"width":2400,"height":1260,"url":"https:\/\/www.unipile.com\/wp-content\/uploads\/2026\/05\/gmail-api-key-vs-oauth.png","type":"image\/png"}],"author":"Damien Girardeau","twitter_card":"summary_large_image","twitter_creator":"@UnipileAPI","twitter_site":"@UnipileAPI","twitter_misc":{"Yazan:":"Damien Girardeau","Tahmini okuma s\u00fcresi":"17 dakika"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.unipile.com\/gmail-api-key-vs-oauth\/#article","isPartOf":{"@id":"https:\/\/www.unipile.com\/gmail-api-key-vs-oauth\/"},"author":{"name":"Damien Girardeau","@id":"https:\/\/www.unipile.com\/#\/schema\/person\/a2ac44e22bdc27d497ce8b58716a673e"},"headline":"Gmail API Key vs OAuth: Why You Can’t Skip OAuth (and What to Use Instead)","datePublished":"2026-05-25T09:49:40+00:00","dateModified":"2026-05-25T09:50:32+00:00","mainEntityOfPage":{"@id":"https:\/\/www.unipile.com\/gmail-api-key-vs-oauth\/"},"wordCount":5025,"publisher":{"@id":"https:\/\/www.unipile.com\/#organization"},"image":{"@id":"https:\/\/www.unipile.com\/gmail-api-key-vs-oauth\/#primaryimage"},"thumbnailUrl":"https:\/\/www.unipile.com\/wp-content\/uploads\/2026\/05\/gmail-api-key-vs-oauth.png","articleSection":["API Guidelines","Email API Integration"],"inLanguage":"tr"},{"@type":"WebPage","@id":"https:\/\/www.unipile.com\/gmail-api-key-vs-oauth\/","url":"https:\/\/www.unipile.com\/gmail-api-key-vs-oauth\/","name":"Gmail API Anahtar\u0131 vs OAuth: Neden OAuth'u Atlayamazs\u0131n\u0131z (ve Yerine Ne Kullanmal\u0131s\u0131n\u0131z) - Unipile","isPartOf":{"@id":"https:\/\/www.unipile.com\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.unipile.com\/gmail-api-key-vs-oauth\/#primaryimage"},"image":{"@id":"https:\/\/www.unipile.com\/gmail-api-key-vs-oauth\/#primaryimage"},"thumbnailUrl":"https:\/\/www.unipile.com\/wp-content\/uploads\/2026\/05\/gmail-api-key-vs-oauth.png","datePublished":"2026-05-25T09:49:40+00:00","dateModified":"2026-05-25T09:50:32+00:00","description":"Gmail API anahtarlar\u0131n\u0131n ne zaman ve OAuth'un ne zaman kullan\u0131laca\u011f\u0131n\u0131 \u00f6\u011frenin. G\u00fcvenlik, kurulum kolayl\u0131\u011f\u0131 ve ger\u00e7ek d\u00fcnya senaryolar\u0131n\u0131 kar\u015f\u0131la\u015ft\u0131r\u0131n. \u00dcretim uygulamalar\u0131 i\u00e7in OAuth en iyi uygulamalar\u0131n\u0131 g\u00f6r\u00fcn. Olu\u015fturmaya ba\u015flay\u0131n.","breadcrumb":{"@id":"https:\/\/www.unipile.com\/gmail-api-key-vs-oauth\/#breadcrumb"},"inLanguage":"tr","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.unipile.com\/gmail-api-key-vs-oauth\/"]}]},{"@type":"ImageObject","inLanguage":"tr","@id":"https:\/\/www.unipile.com\/gmail-api-key-vs-oauth\/#primaryimage","url":"https:\/\/www.unipile.com\/wp-content\/uploads\/2026\/05\/gmail-api-key-vs-oauth.png","contentUrl":"https:\/\/www.unipile.com\/wp-content\/uploads\/2026\/05\/gmail-api-key-vs-oauth.png","width":2400,"height":1260,"caption":"Gmail API Key vs OAuth: why OAuth is required and how to implement it"},{"@type":"BreadcrumbList","@id":"https:\/\/www.unipile.com\/gmail-api-key-vs-oauth\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Accueil","item":"https:\/\/www.unipile.com\/"},{"@type":"ListItem","position":2,"name":"Gmail API Key vs OAuth: Why You Can’t Skip OAuth (and What to Use Instead)"}]},{"@type":"WebSite","@id":"https:\/\/www.unipile.com\/#website","url":"https:\/\/www.unipile.com\/","name":"Unipile","description":"Mesajla\u015fma ve E-postay\u0131 Entegre Edin, API ile Kolayca Ba\u011flan\u0131n","publisher":{"@id":"https:\/\/www.unipile.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.unipile.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"tr"},{"@type":"Organization","@id":"https:\/\/www.unipile.com\/#organization","name":"Unipile","url":"https:\/\/www.unipile.com\/","logo":{"@type":"ImageObject","inLanguage":"tr","@id":"https:\/\/www.unipile.com\/#\/schema\/logo\/image\/","url":"https:\/\/www.unipile.com\/wp-content\/uploads\/2021\/05\/logo-unipile.png","contentUrl":"https:\/\/www.unipile.com\/wp-content\/uploads\/2021\/05\/logo-unipile.png","width":200,"height":49,"caption":"Unipile"},"image":{"@id":"https:\/\/www.unipile.com\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/unipilefr","https:\/\/x.com\/UnipileAPI","https:\/\/www.linkedin.com\/company\/unipile\/"]},{"@type":"Person","@id":"https:\/\/www.unipile.com\/#\/schema\/person\/a2ac44e22bdc27d497ce8b58716a673e","name":"Damien Girardeau","image":{"@type":"ImageObject","inLanguage":"tr","@id":"https:\/\/secure.gravatar.com\/avatar\/12dd140720736a8db29f540c42a17d2680cd54a04fb26bb7b55423c179b065a9?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/12dd140720736a8db29f540c42a17d2680cd54a04fb26bb7b55423c179b065a9?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/12dd140720736a8db29f540c42a17d2680cd54a04fb26bb7b55423c179b065a9?s=96&d=mm&r=g","caption":"Damien Girardeau"}}]}},"_links":{"self":[{"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/posts\/278929","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/comments?post=278929"}],"version-history":[{"count":4,"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/posts\/278929\/revisions"}],"predecessor-version":[{"id":278948,"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/posts\/278929\/revisions\/278948"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/media\/278949"}],"wp:attachment":[{"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/media?parent=278929"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/categories?post=278929"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/tags?post=278929"},{"taxonomy":"post_folder","embeddable":true,"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/post_folder?post=278929"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}

{"id":278929,"date":"2026-05-25T11:49:40","date_gmt":"2026-05-25T09:49:40","guid":{"rendered":"https:\/\/www.unipile.com\/?p=278929"},"modified":"2026-05-25T11:50:32","modified_gmt":"2026-05-25T09:50:32","slug":"gmail-api-anahtari-vs-oauth","status":"publish","type":"post","link":"https:\/\/www.unipile.com\/tr\/gmail-api-key-vs-oauth\/","title":{"rendered":"Gmail API Anahtar\u0131 vs OAuth: Neden OAuth'u Atlayamazs\u0131n\u0131z (ve Bunun Yerine Ne Kullanmal\u0131s\u0131n\u0131z)"},"content":{"rendered":"\n[et_pb_section fb_built=”1″ _builder_version=”4.27.3″ background_color=”transparent” custom_padding=”0px|0px|0px|0px|false|false” global_colors_info=”{}” theme_builder_area=”post_content” da_is_popup=”off” da_exit_intent=”off” da_has_close=”on” da_alt_close=”off” da_dark_close=”off” da_not_modal=”on” da_is_singular=”off” da_with_loader=”off” da_has_shadow=”on” da_disable_devices=”off|off|off”][et_pb_row _builder_version=”4.27.3″ background_color=”transparent” global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_column type=”4_4″ _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_code _builder_version=”4.27.4″ hover_enabled=”0″ global_colors_info=”{}” theme_builder_area=”post_content” sticky_enabled=”0″]Unipile – Table of Contents<\/title><link href=\"https:\/\/fonts.googleapis.com\/css2?family=Inter:wght@400;500;600;700&family=Poppins:wght@700;800&display=swap\" rel=\"stylesheet\"><style>body { background: #f4f5f7; margin: 0; }#unipile-toc.utc-wrapper { display: block !important; max-width: 1100px !important; margin: 0 auto !important; padding: 0 !important; font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif !important;}#unipile-toc *,#unipile-toc *::before,#unipile-toc *::after { margin: 0 !important; padding: 0 !important; box-sizing: border-box !important; border: none !important; outline: none !important; font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif !important; line-height: normal !important; letter-spacing: normal !important; text-transform: none !important; text-decoration: none !important; list-style: none !important; background: transparent !important; float: none !important;}#unipile-toc .utc-card { background: #ffffff !important; border-radius: 16px !important; border: 1px solid #e5e7eb !important; padding: 32px !important; box-shadow: 0 2px 12px rgba(15, 39, 54, 0.04) !important;}#unipile-toc .utc-header { display: flex !important; align-items: center !important; justify-content: space-between !important; gap: 12px !important; margin-bottom: 24px !important; padding-bottom: 20px !important; border-bottom: 1px solid #e5e7eb !important;}#unipile-toc .utc-header-left { display: flex !important; align-items: center !important; gap: 12px !important;}#unipile-toc .utc-icon-box { width: 36px !important; height: 36px !important; background: rgba(59, 185, 139, 0.12) !important; border-radius: 8px !important; display: flex !important; align-items: center !important; justify-content: center !important; flex-shrink: 0 !important;}#unipile-toc .utc-icon-box svg { width: 18px !important; height: 18px !important; stroke: #3BB98B !important; fill: none !important; stroke-width: 2.2 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}#unipile-toc .utc-title { font-family: 'Poppins', sans-serif !important; font-size: 15px !important; font-weight: 700 !important; color: #0f2736 !important; text-transform: uppercase !important; letter-spacing: 0.5px !important;}#unipile-toc .utc-toggle { display: none !important; align-items: center !important; gap: 6px !important; background: transparent !important; cursor: pointer !important; font-size: 13px !important; font-weight: 600 !important; color: #3BB98B !important; padding: 6px 10px !important; border-radius: 6px !important; transition: background 0.2s ease !important;}#unipile-toc .utc-toggle svg { width: 14px !important; height: 14px !important; stroke: #3BB98B !important; fill: none !important; stroke-width: 2.5 !important; stroke-linecap: round !important; stroke-linejoin: round !important; transition: transform 0.3s ease !important;}#unipile-toc.utc-collapsed .utc-toggle svg { transform: rotate(-90deg) !important;}#unipile-toc .utc-grid { display: grid !important; grid-template-columns: repeat(4, 1fr) !important; gap: 0 !important;}#unipile-toc .utc-col { padding: 0 24px !important; border-left: 1px solid #e5e7eb !important;}#unipile-toc .utc-col:first-child { padding-left: 0 !important; border-left: none !important;}#unipile-toc .utc-col:last-child { padding-right: 0 !important;}#unipile-toc .utc-col-label { font-size: 11px !important; font-weight: 700 !important; color: #94a3b8 !important; text-transform: uppercase !important; letter-spacing: 0.8px !important; margin-bottom: 14px !important; display: block !important;}#unipile-toc .utc-link-list { display: flex !important; flex-direction: column !important; gap: 10px !important;}#unipile-toc .utc-link { display: flex !important; align-items: flex-start !important; gap: 10px !important; cursor: pointer !important; transition: all 0.2s ease !important; text-decoration: none !important; padding: 4px 0 !important;}#unipile-toc .utc-num { width: 18px !important; height: 18px !important; flex-shrink: 0 !important; background: #f4f5f7 !important; border-radius: 4px !important; display: flex !important; align-items: center !important; justify-content: center !important; font-size: 10px !important; font-weight: 700 !important; color: #94a3b8 !important; transition: all 0.2s ease !important; margin-top: 1px !important;}#unipile-toc .utc-num.utc-num-faq { font-size: 8px !important; letter-spacing: 0.2px !important;}#unipile-toc .utc-link-text { font-size: 13px !important; font-weight: 500 !important; color: #383838 !important; line-height: 1.45 !important; transition: color 0.2s ease !important; flex: 1 !important;}#unipile-toc .utc-link:hover .utc-num { background: rgba(59, 185, 139, 0.15) !important; color: #3BB98B !important;}#unipile-toc .utc-link:hover .utc-link-text { color: #0f2736 !important;}#unipile-toc .utc-link.utc-active .utc-num { background: #3BB98B !important; color: #ffffff !important;}#unipile-toc .utc-link.utc-active .utc-link-text { color: #0f2736 !important; font-weight: 600 !important;}#unipile-toc .utc-link.utc-read .utc-num { background: rgba(59, 185, 139, 0.15) !important; color: #3BB98B !important;}#unipile-toc .utc-tag-best { display: inline-block !important; font-size: 9px !important; font-weight: 700 !important; color: #ffffff !important; background: #3BB98B !important; padding: 2px 6px !important; border-radius: 4px !important; text-transform: uppercase !important; letter-spacing: 0.5px !important; margin-left: 6px !important; vertical-align: middle !important;}@media (max-width: 1000px) { #unipile-toc .utc-grid { grid-template-columns: repeat(2, 1fr) !important; gap: 24px 0 !important; } #unipile-toc .utc-col { padding: 0 20px !important; } #unipile-toc .utc-col:nth-child(2n+1) { padding-left: 0 !important; border-left: none !important; } #unipile-toc .utc-col:nth-child(2n) { padding-right: 0 !important; }}@media (max-width: 700px) { #unipile-toc .utc-card { padding: 22px !important; } #unipile-toc .utc-header { margin-bottom: 0 !important; padding-bottom: 0 !important; border-bottom: none !important; } #unipile-toc .utc-toggle { display: flex !important; } #unipile-toc .utc-grid { grid-template-columns: 1fr !important; gap: 22px !important; max-height: 2000px !important; overflow: hidden !important; transition: max-height 0.4s ease, margin-top 0.3s ease, padding-top 0.3s ease, border-top-color 0.3s ease !important; margin-top: 22px !important; padding-top: 22px !important; border-top: 1px solid #e5e7eb !important; } \/* Etat ferme par defaut sur mobile (CSS-first, evite le flash) *\/ #unipile-toc.utc-mobile-init .utc-grid, #unipile-toc.utc-collapsed .utc-grid { max-height: 0 !important; margin-top: 0 !important; padding-top: 0 !important; border-top-color: transparent !important; } #unipile-toc.utc-mobile-init .utc-toggle svg, #unipile-toc.utc-collapsed .utc-toggle svg { transform: rotate(-90deg) !important; } #unipile-toc .utc-col { padding: 0 !important; border-left: none !important; border-top: 1px solid #e5e7eb !important; padding-top: 18px !important; } #unipile-toc .utc-col:first-child { border-top: none !important; padding-top: 0 !important; }}<\/style><\/head><body><div id=\"unipile-toc\" class=\"utc-wrapper utc-mobile-init\"> <div class=\"utc-card\"> <div class=\"utc-header\"> <div class=\"utc-header-left\"> <div class=\"utc-icon-box\"> <svg viewBox=\"0 0 24 24\"><line x1=\"8\" y1=\"6\" x2=\"21\" y2=\"6\"\/><line x1=\"8\" y1=\"12\" x2=\"21\" y2=\"12\"\/><line x1=\"8\" y1=\"18\" x2=\"21\" y2=\"18\"\/><line x1=\"3\" y1=\"6\" x2=\"3.01\" y2=\"6\"\/><line x1=\"3\" y1=\"12\" x2=\"3.01\" y2=\"12\"\/><line x1=\"3\" y1=\"18\" x2=\"3.01\" y2=\"18\"\/><\/svg> <\/div> <span class=\"utc-title\">Table of Contents<\/span> <\/div> <button type=\"button\" class=\"utc-toggle\" aria-label=\"Toggle table of contents\" aria-expanded=\"false\"> <span class=\"utc-toggle-label\">Show<\/span> <svg viewBox=\"0 0 24 24\"><polyline points=\"6 9 12 15 18 9\"\/><\/svg> <\/button> <\/div> <div class=\"utc-grid\">  <div class=\"utc-col\"> <span class=\"utc-col-label\">The Basics<\/span> <div class=\"utc-link-list\"> <a class=\"utc-link\" href=\"#short-answer\"> <span class=\"utc-num\">01<\/span> <span class=\"utc-link-text\">API Key Verdict<\/span> <\/a> <a class=\"utc-link\" href=\"#api-key-does\"> <span class=\"utc-num\">02<\/span> <span class=\"utc-link-text\">What API Keys Do<\/span> <\/a> <a class=\"utc-link\" href=\"#why-oauth\"> <span class=\"utc-num\">03<\/span> <span class=\"utc-link-text\">Why Gmail Needs OAuth<\/span> <\/a> <\/div> <\/div>  <div class=\"utc-col\"> <span class=\"utc-col-label\">Auth Paths<\/span> <div class=\"utc-link-list\"> <a class=\"utc-link\" href=\"#three-paths\"> <span class=\"utc-num\">04<\/span> <span class=\"utc-link-text\">3 Auth Paths Compared<\/span> <\/a> <a class=\"utc-link\" href=\"#path-oauth-client\"> <span class=\"utc-num\">05<\/span> <span class=\"utc-link-text\">Path 1: OAuth Client<\/span> <\/a> <a class=\"utc-link\" href=\"#path-service-account\"> <span class=\"utc-num\">06<\/span> <span class=\"utc-link-text\">Path 2: Service Account<\/span> <\/a> <\/div> <\/div>  <div class=\"utc-col\"> <span class=\"utc-col-label\">Practical Guide<\/span> <div class=\"utc-link-list\"> <a class=\"utc-link\" href=\"#path-unified-api\"> <span class=\"utc-num\">07<\/span> <span class=\"utc-link-text\">Path 3: Unified API<\/span> <\/a> <a class=\"utc-link\" href=\"#common-errors\"> <span class=\"utc-num\">08<\/span> <span class=\"utc-link-text\">Common Errors<\/span> <\/a> <a class=\"utc-link\" href=\"#gmail-scopes\"> <span class=\"utc-num\">09<\/span> <span class=\"utc-link-text\">Gmail API Scopes<\/span> <\/a> <\/div> <\/div>  <div class=\"utc-col\"> <span class=\"utc-col-label\">Decision<\/span> <div class=\"utc-link-list\"> <a class=\"utc-link\" href=\"#decision-tree\"> <span class=\"utc-num\">10<\/span> <span class=\"utc-link-text\"><span>Decision Tree<\/span><span class=\"utc-tag-best\">Best<\/span><\/span> <\/a> <a class=\"utc-link\" href=\"#gmail-api-key-vs-oauth-faq\"> <span class=\"utc-num utc-num-faq\">FAQ<\/span> <span class=\"utc-link-text\">FAQ<\/span> <\/a> <\/div> <\/div> <\/div> <\/div><\/div><script>(function(){ var toc = document.getElementById('unipile-toc'); if (!toc) return; var MOBILE_BP = 700; var toggleBtn = toc.querySelector('.utc-toggle'); var toggleLabel = toc.querySelector('.utc-toggle-label'); \/\/ Synchronise l'etat (collapsed + label + aria) selon la largeur. \/\/ Sur mobile on ferme d'office ; sur desktop l'accordeon n'a pas lieu d'etre. function syncToWidth(){ var isMobile = window.innerWidth <= MOBILE_BP; \/\/ On retire la classe d'init CSS des que le JS prend le relais toc.classList.remove('utc-mobile-init'); if (isMobile) { toc.classList.add('utc-collapsed'); } else { toc.classList.remove('utc-collapsed'); } refreshUI(); } function refreshUI(){ var collapsed = toc.classList.contains('utc-collapsed'); if (toggleLabel) toggleLabel.textContent = collapsed ? 'Show' : 'Hide'; if (toggleBtn) toggleBtn.setAttribute('aria-expanded', collapsed ? 'false' : 'true'); } if (toggleBtn) { toggleBtn.addEventListener('click', function(){ toc.classList.remove('utc-mobile-init'); toc.classList.toggle('utc-collapsed'); refreshUI(); }); } \/\/ Init + suivi du resize \/ rotation (sur desktop -> mobile et inverse) var lastMobile = null; function onResize(){ var isMobile = window.innerWidth <= MOBILE_BP; if (isMobile !== lastMobile) { lastMobile = isMobile; syncToWidth(); } } \/\/ Etat initial : ferme d'office si mobile au chargement if (window.innerWidth <= MOBILE_BP) { toc.classList.remove('utc-mobile-init'); toc.classList.add('utc-collapsed'); } else { toc.classList.remove('utc-mobile-init'); } lastMobile = window.innerWidth <= MOBILE_BP; refreshUI(); window.addEventListener('resize', onResize, { passive: true }); \/\/ Smooth scroll var links = toc.querySelectorAll('.utc-link'); links.forEach(function(link){ link.addEventListener('click', function(e){ var href = link.getAttribute('href'); if (!href || href.charAt(0) !== '#') return; var target = document.getElementById(href.substring(1)); if (target) { e.preventDefault(); var offset = 80; var top = target.getBoundingClientRect().top + window.pageYOffset - offset; window.scrollTo({ top: top, behavior: 'smooth' }); } }); }); \/\/ Scroll-spy var sectionIds = []; links.forEach(function(link){ var href = link.getAttribute('href'); if (href && href.charAt(0) === '#') sectionIds.push(href.substring(1)); }); function updateActive(){ var scrollY = window.pageYOffset + 120; var activeId = null; var readIds = []; sectionIds.forEach(function(id){ var el = document.getElementById(id); if (el) { var top = el.getBoundingClientRect().top + window.pageYOffset; if (top <= scrollY) { activeId = id; readIds.push(id); } } }); links.forEach(function(link){ var href = link.getAttribute('href'); var id = href ? href.substring(1) : ''; link.classList.remove('utc-active', 'utc-read'); if (id === activeId) { link.classList.add('utc-active'); } else if (readIds.indexOf(id) !== -1) { link.classList.add('utc-read'); } }); } if ('IntersectionObserver' in window) { var observer = new IntersectionObserver(function(){ updateActive(); }, { rootMargin: '-120px 0px -60% 0px' }); sectionIds.forEach(function(id){ var el = document.getElementById(id); if (el) observer.observe(el); }); } window.addEventListener('scroll', updateActive, { passive: true }); updateActive();})();<\/script><\/body><\/html>[\/et_pb_code][\/et_pb_column][\/et_pb_row][\/et_pb_section][et_pb_section fb_built=”1″ _builder_version=”4.27.3″ background_color=”transparent” custom_padding=”0px|0px|0px|0px|false|false” global_colors_info=”{}” theme_builder_area=”post_content” da_is_popup=”off” da_exit_intent=”off” da_has_close=”on” da_alt_close=”off” da_dark_close=”off” da_not_modal=”on” da_is_singular=”off” da_with_loader=”off” da_has_shadow=”on” da_disable_devices=”off|off|off”][et_pb_row _builder_version=”4.27.3″ background_color=”transparent” global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_column type=”4_4″ _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_code _builder_version=”4.27.4″ hover_enabled=”0″ global_colors_info=”{}” theme_builder_area=”post_content” sticky_enabled=”0″]<!DOCTYPE html><html lang=\"en\"><head><meta charset=\"UTF-8\"><meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\"><title>Unipile – Gmail API Hero<\/title><link href=\"https:\/\/fonts.googleapis.com\/css2?family=Inter:wght@400;500;600;700&family=Poppins:wght@700;800&display=swap\" rel=\"stylesheet\"><style>body { background: #f4f5f7; margin: 0; }#upl-gako-hero,#upl-gako-hero *,#upl-gako-hero *::before,#upl-gako-hero *::after { margin: 0 !important; padding: 0 !important; box-sizing: border-box !important; border: none !important; outline: none !important; font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif !important; line-height: 1.5 !important; letter-spacing: normal !important; text-transform: none !important; text-decoration: none !important; list-style: none !important;}#upl-gako-hero { background: transparent !important; padding: 60px 20px 50px !important; overflow: hidden !important;}#upl-gako-hero .gako-container { max-width: 1100px !important; margin: 0 auto !important; display: grid !important; grid-template-columns: 1fr 1fr !important; gap: 60px !important; align-items: center !important;}#upl-gako-hero .gako-badge { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: rgba(59, 185, 139, 0.12) !important; color: #2aaa7e !important; padding: 6px 14px !important; border-radius: 20px !important; font-size: 12px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.5px !important; margin-bottom: 20px !important; width: fit-content !important;}#upl-gako-hero .gako-badge .gako-dot { width: 7px !important; height: 7px !important; background: #3BB98B !important; border-radius: 50% !important; flex-shrink: 0 !important;}#upl-gako-hero .gako-h1 { font-family: 'Poppins', sans-serif !important; font-size: 44px !important; font-weight: 700 !important; color: #0f2736 !important; line-height: 1.18 !important; margin-bottom: 20px !important;}#upl-gako-hero .gako-accent { color: #3BB98B !important;}#upl-gako-hero .gako-desc { font-size: 17px !important; color: #383838 !important; line-height: 1.75 !important; margin-bottom: 32px !important;}#upl-gako-hero .gako-actions { display: flex !important; align-items: center !important; gap: 14px !important; flex-wrap: wrap !important;}#upl-gako-hero .gako-cta-primary { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: #DDDF4C !important; color: #0f2736 !important; padding: 14px 28px !important; border-radius: 8px !important; font-size: 0.95rem !important; font-weight: 600 !important; border: 2px solid #DDDF4C !important; transition: transform 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important;}#upl-gako-hero .gako-cta-primary:hover { transform: translateY(-5px) !important;}#upl-gako-hero .gako-cta-primary svg { width: 16px !important; height: 16px !important; stroke: currentColor !important; fill: none !important; stroke-width: 2.5 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}#upl-gako-hero .gako-cta-secondary { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: transparent !important; color: #0f2736 !important; padding: 12px 24px !important; border-radius: 8px !important; font-size: 0.95rem !important; font-weight: 600 !important; border: 2px solid #0f2736 !important; transition: all 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important;}#upl-gako-hero .gako-cta-secondary:hover { background: #0f2736 !important; color: #ffffff !important;}#upl-gako-hero .gako-cta-secondary svg { width: 16px !important; height: 16px !important; stroke: currentColor !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}\/* Code editor *\/#upl-gako-hero .gako-code-wrapper { border-radius: 14px !important; overflow: hidden !important; background: #0d1117 !important; box-shadow: 0 24px 60px rgba(15,39,54,0.18) !important; max-width: 100% !important;}#upl-gako-hero .gako-editor-bar { background: #161b22 !important; padding: 12px 18px !important; display: flex !important; align-items: center !important; gap: 8px !important; border-bottom: 1px solid rgba(255,255,255,0.06) !important;}#upl-gako-hero .gako-dot-r { width: 12px !important; height: 12px !important; border-radius: 50% !important; background: #ff5f57 !important; flex-shrink: 0 !important; }#upl-gako-hero .gako-dot-y { width: 12px !important; height: 12px !important; border-radius: 50% !important; background: #febc2e !important; flex-shrink: 0 !important; }#upl-gako-hero .gako-dot-g { width: 12px !important; height: 12px !important; border-radius: 50% !important; background: #28c840 !important; flex-shrink: 0 !important; }#upl-gako-hero .gako-filename { color: #8b949e !important; font-size: 13px !important; margin-left: 6px !important; font-family: 'Courier New', monospace !important;}#upl-gako-hero .gako-pre { padding: 22px 24px !important; font-size: 13px !important; line-height: 1.8 !important; overflow-x: auto !important; -webkit-overflow-scrolling: touch !important; background: #0d1117 !important;}#upl-gako-hero .gako-pre code { font-family: 'Courier New', monospace !important; white-space: pre !important; display: block !important;}#upl-gako-hero .c { color: #8b949e !important; }#upl-gako-hero .k { color: #ff7b72 !important; }#upl-gako-hero .fn { color: #d2a8ff !important; }#upl-gako-hero .s { color: #a5d6ff !important; }#upl-gako-hero .n { color: #79c0ff !important; }#upl-gako-hero .w { color: #e6edf3 !important; }#upl-gako-hero .gako-editor-ok { background: rgba(59,185,139,0.10) !important; border-top: 1px solid rgba(59,185,139,0.25) !important; color: #3BB98B !important; padding: 11px 24px !important; font-size: 12.5px !important; font-family: 'Courier New', monospace !important; display: flex !important; align-items: center !important; gap: 8px !important;}#upl-gako-hero .gako-editor-ok svg { width: 14px !important; height: 14px !important; stroke: #3BB98B !important; fill: none !important; stroke-width: 2.5 !important; stroke-linecap: round !important; stroke-linejoin: round !important; flex-shrink: 0 !important;}#upl-gako-hero .gako-providers { display: flex !important; align-items: center !important; gap: 10px !important; padding: 12px 18px !important; background: #ffffff !important; border-top: 1px solid #e8ecf0 !important; flex-wrap: wrap !important;}#upl-gako-hero .gako-providers-label { font-size: 11px !important; color: #94a3b8 !important; font-weight: 600 !important; text-transform: uppercase !important; letter-spacing: 0.5px !important;}#upl-gako-hero .gako-providers img { width: 20px !important; height: 20px !important;}@media (max-width: 900px) { #upl-gako-hero .gako-container { grid-template-columns: 1fr !important; gap: 44px !important; } #upl-gako-hero .gako-h1 { font-size: 34px !important; } #upl-gako-hero { padding: 50px 20px !important; }}@media (max-width: 600px) { #upl-gako-hero { padding: 44px 16px !important; } #upl-gako-hero .gako-h1 { font-size: 28px !important; } #upl-gako-hero .gako-desc { font-size: 15.5px !important; } #upl-gako-hero .gako-actions { width: 100% !important; gap: 10px !important; } #upl-gako-hero .gako-cta-primary, #upl-gako-hero .gako-cta-secondary { width: 100% !important; justify-content: center !important; } #upl-gako-hero .gako-code-wrapper { box-shadow: 0 12px 30px rgba(15,39,54,0.16) !important; } #upl-gako-hero .gako-pre { padding: 18px 16px !important; font-size: 11.5px !important; line-height: 1.7 !important; } #upl-gako-hero .gako-editor-ok { font-size: 11px !important; padding: 10px 16px !important; align-items: flex-start !important; } #upl-gako-hero .gako-editor-ok svg { margin-top: 2px !important; }}@media (max-width: 400px) { #upl-gako-hero .gako-h1 { font-size: 23px !important; } #upl-gako-hero .gako-pre { font-size: 10.5px !important; }}<\/style><div id=\"upl-gako-hero\"> <div class=\"gako-container\">  <div> <div class=\"gako-badge\"><span class=\"gako-dot\"><\/span><span>Gmail API Authentication<\/span><\/div> <h2 class=\"gako-h1\">Gmail API Key vs <span class=\"gako-accent\">OAuth<\/span>: Why You Can’t Skip OAuth<\/h2> <pee class=\"gako-desc\">Can you use a Google API key to access Gmail? Short answer: no. Gmail API accesses private user data, which means every request needs explicit user consent through OAuth 2.0. This guide covers the exact error you’ll see if you try an API key, the 3 real authentication paths available today, and how to connect a Gmail mailbox in 3 lines of code using a <a href=\"https:\/\/www.unipile.com\/email-api\/\" style=\"color:#2aaa7e!important;text-decoration:underline!important;\">unified email API<\/a>.<\/pee> <div class=\"gako-actions\"> <span class=\"gako-cta-primary\" data-upl-link=\"https:\/\/dashboard.unipile.com\/signup\/\" data-upl-target=\"_blank\"><span>Start building<\/span><svg viewBox=\"0 0 24 24\"><line x1=\"5\" y1=\"12\" x2=\"19\" y2=\"12\"\/><polyline points=\"12 5 19 12 12 19\"\/><\/svg><\/span> <span class=\"gako-cta-secondary\" data-upl-link=\"https:\/\/www.unipile.com\/communication-api\/email-api\/duplicate-enhance-your-email-software-with-gmail-api-integration\/\" data-upl-target=\"_self\"><span>Gmail API guide<\/span><svg viewBox=\"0 0 24 24\"><polyline points=\"9 18 15 12 9 6\"\/><\/svg><\/span> <\/div> <\/div>  <div> <div class=\"gako-code-wrapper\"> <div class=\"gako-editor-bar\"> <span class=\"gako-dot-r\"><\/span><span class=\"gako-dot-y\"><\/span><span class=\"gako-dot-g\"><\/span> <span class=\"gako-filename\">gmail-auth.js<\/span> <\/div> <div class=\"gako-pre\"><code><span class=\"c\">\/\/ Gmail API Key vs OAuth - the verdict<\/span><span class=\"c\">\/\/ ----------------------------------------<\/span><span class=\"c\">\/\/ WRONG: API key does NOT work with Gmail<\/span><span class=\"k\">const<\/span> <span class=\"w\">res <\/span><span class=\"k\">=<\/span> <span class=\"k\">await<\/span> <span class=\"fn\">fetch<\/span><span class=\"w\">(<\/span> <span class=\"s\">`https:\/\/gmail.googleapis.com\/gmail\/v1\/<\/span><span class=\"s\"> users\/me\/messages?key=<\/span><span class=\"n\">YOUR_API_KEY<\/span><span class=\"s\">`<\/span><span class=\"w\">);<\/span><span class=\"c\">\/\/ Returns: 401 Login Required<\/span><span class=\"c\">\/\/ CORRECT: OAuth 2.0 access token<\/span><span class=\"k\">const<\/span> <span class=\"w\">res <\/span><span class=\"k\">=<\/span> <span class=\"k\">await<\/span> <span class=\"fn\">fetch<\/span><span class=\"w\">(<\/span> <span class=\"s\">'https:\/\/gmail.googleapis.com\/gmail\/v1\/users\/me\/messages'<\/span><span class=\"w\">,<\/span> <span class=\"w\">{<\/span> <span class=\"w\">headers:<\/span> <span class=\"w\">{<\/span> <span class=\"s\">'Authorization'<\/span><span class=\"w\">:<\/span> <span class=\"s\">`Bearer <\/span><span class=\"n\">${accessToken}<\/span><span class=\"s\">`<\/span> <span class=\"w\">}<\/span> <span class=\"w\">}<\/span><span class=\"w\">);<\/span><span class=\"c\">\/\/ OR skip OAuth entirely - use Unipile<\/span><span class=\"k\">const<\/span> <span class=\"w\">mails <\/span><span class=\"k\">=<\/span> <span class=\"k\">await<\/span> <span class=\"fn\">unipile<\/span><span class=\"w\">.<\/span><span class=\"fn\">email<\/span><span class=\"w\">.<\/span><span class=\"fn\">list<\/span><span class=\"w\">(<\/span> <span class=\"w\">{ accountId:<\/span> <span class=\"s\">'linked-account-id'<\/span> <span class=\"w\">}<\/span><span class=\"w\">);<\/span><\/code><\/div> <div class=\"gako-editor-ok\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>No OAuth boilerplate – Unipile handles tokens for you<\/span><\/div> <div class=\"gako-providers\"> <span class=\"gako-providers-label\">Works with<\/span> <img decoding=\"async\" src=\"https:\/\/www.unipile.com\/wp-content\/uploads\/2024\/02\/gmail-3.svg\" alt=\"Gmail\" width=\"20\" height=\"20\"> <img decoding=\"async\" src=\"https:\/\/www.unipile.com\/wp-content\/uploads\/2024\/02\/outlook-2.svg\" alt=\"Outlook\" width=\"20\" height=\"20\"> <img decoding=\"async\" src=\"https:\/\/www.unipile.com\/wp-content\/uploads\/2024\/02\/imap-1.svg\" alt=\"IMAP\" width=\"20\" height=\"20\"> <\/div> <\/div> <\/div> <\/div><\/div><script>(function(){ function init(){ var el = document.getElementById('upl-gako-hero'); if (!el) return; el.addEventListener('click', function(e){ var t = e.target.closest('[data-upl-link]'); if (!t) return; var url = t.getAttribute('data-upl-link'); var target = t.getAttribute('data-upl-target') || '_self'; if (url) window.open(url, target); }); } if (document.readyState === 'loading') { document.addEventListener('DOMContentLoaded', init); } else { init(); }})();<\/script><\/body><\/html>[\/et_pb_code][\/et_pb_column][\/et_pb_row][\/et_pb_section][et_pb_section fb_built=”1″ _builder_version=”4.27.3″ background_color=”transparent” custom_padding=”0px|0px|0px|0px|false|false” global_colors_info=”{}” theme_builder_area=”post_content” da_is_popup=”off” da_exit_intent=”off” da_has_close=”on” da_alt_close=”off” da_dark_close=”off” da_not_modal=”on” da_is_singular=”off” da_with_loader=”off” da_has_shadow=”on” da_disable_devices=”off|off|off”][et_pb_row _builder_version=”4.27.3″ background_color=”transparent” global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_column type=”4_4″ _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_code _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”]<link href=\"https:\/\/fonts.googleapis.com\/css2?family=Inter:wght@400;500;600;700&family=Poppins:wght@700;800&display=swap\" rel=\"stylesheet\"><style>#upl-gako-s1,#upl-gako-s1 *,#upl-gako-s1 *::before,#upl-gako-s1 *::after { margin: 0 !important; padding: 0 !important; box-sizing: border-box !important; border: none !important; outline: none !important; font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif !important; line-height: 1.5 !important; letter-spacing: normal !important; text-transform: none !important; text-decoration: none !important; list-style: none !important;}#upl-gako-s1 { background: transparent !important; padding: 60px 20px !important;}#upl-gako-s1 .s1-container { max-width: 1100px !important; margin: 0 auto !important;}#upl-gako-s1 .s1-badge { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: rgba(59,185,139,0.12) !important; color: #2aaa7e !important; padding: 6px 14px !important; border-radius: 20px !important; font-size: 12px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.5px !important; margin-bottom: 16px !important; width: fit-content !important;}#upl-gako-s1 .s1-badge .s1-dot { width: 7px !important; height: 7px !important; background: #3BB98B !important; border-radius: 50% !important; flex-shrink: 0 !important;}#upl-gako-s1 .s1-h2 { font-family: 'Poppins', sans-serif !important; font-size: 35px !important; font-weight: 700 !important; color: #0f2736 !important; line-height: 1.2 !important; margin-bottom: 16px !important;}#upl-gako-s1 .s1-intro { font-size: 17px !important; color: #383838 !important; line-height: 1.75 !important; margin-bottom: 36px !important;}#upl-gako-s1 .s1-verdict-box { background: #0f2736 !important; border-radius: 16px !important; padding: 28px 32px !important; margin-bottom: 36px !important; display: flex !important; gap: 20px !important; align-items: flex-start !important;}#upl-gako-s1 .s1-verdict-icon { width: 44px !important; height: 44px !important; background: rgba(59,185,139,0.15) !important; border-radius: 10px !important; display: flex !important; align-items: center !important; justify-content: center !important; flex-shrink: 0 !important;}#upl-gako-s1 .s1-verdict-icon svg { width: 22px !important; height: 22px !important; stroke: #3BB98B !important; fill: none !important; stroke-width: 2.5 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}#upl-gako-s1 .s1-verdict-label { font-size: 11px !important; font-weight: 700 !important; color: #3BB98B !important; text-transform: uppercase !important; letter-spacing: 0.8px !important; margin-bottom: 8px !important; display: block !important;}#upl-gako-s1 .s1-verdict-text { font-size: 16px !important; color: rgba(255,255,255,0.88) !important; line-height: 1.7 !important;}#upl-gako-s1 .s1-verdict-text strong { color: #ffffff !important; font-weight: 700 !important;}\/* Error box *\/#upl-gako-s1 .s1-error-grid { display: grid !important; grid-template-columns: 1fr 1fr !important; gap: 20px !important; margin-bottom: 36px !important;}#upl-gako-s1 .s1-error-card { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; overflow: hidden !important;}#upl-gako-s1 .s1-error-header { background: #161b22 !important; padding: 12px 18px !important; display: flex !important; align-items: center !important; gap: 8px !important;}#upl-gako-s1 .s1-dot-r { width: 10px !important; height: 10px !important; border-radius: 50% !important; background: #ff5f57 !important; flex-shrink: 0 !important; }#upl-gako-s1 .s1-dot-y { width: 10px !important; height: 10px !important; border-radius: 50% !important; background: #febc2e !important; flex-shrink: 0 !important; }#upl-gako-s1 .s1-dot-g { width: 10px !important; height: 10px !important; border-radius: 50% !important; background: #28c840 !important; flex-shrink: 0 !important; }#upl-gako-s1 .s1-file { color: #8b949e !important; font-size: 12px !important; font-family: 'Courier New', monospace !important; margin-left: 4px !important; }#upl-gako-s1 .s1-error-body { padding: 18px 20px !important; background: #0d1117 !important; font-family: 'Courier New', monospace !important; font-size: 12.5px !important; line-height: 1.7 !important;}#upl-gako-s1 .er { color: #ff7b72 !important; }#upl-gako-s1 .em { color: #e6edf3 !important; }#upl-gako-s1 .ec { color: #8b949e !important; }#upl-gako-s1 .ev { color: #a5d6ff !important; }#upl-gako-s1 .en { color: #79c0ff !important; }#upl-gako-s1 .s1-error-note { padding: 12px 18px !important; background: rgba(239,68,68,0.06) !important; border-top: 1px solid rgba(239,68,68,0.15) !important; font-size: 12.5px !important; color: #ef4444 !important; font-family: 'Courier New', monospace !important;}\/* Definition cards *\/#upl-gako-s1 .s1-def-grid { display: grid !important; grid-template-columns: 1fr 1fr !important; gap: 20px !important;}#upl-gako-s1 .s1-def-card { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; padding: 24px !important;}#upl-gako-s1 .s1-def-card-icon { width: 40px !important; height: 40px !important; border-radius: 10px !important; display: flex !important; align-items: center !important; justify-content: center !important; margin-bottom: 14px !important;}#upl-gako-s1 .s1-def-card-icon svg { width: 20px !important; height: 20px !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}#upl-gako-s1 .s1-def-card h3 { font-family: 'Poppins', sans-serif !important; font-size: 17px !important; font-weight: 700 !important; color: #0f2736 !important; margin-bottom: 8px !important; line-height: 1.3 !important;}#upl-gako-s1 .s1-def-card p { font-size: 15px !important; color: #4a5568 !important; line-height: 1.7 !important;}#upl-gako-s1 .s1-def-card.red-card { border-color: rgba(239,68,68,0.25) !important; background: rgba(239,68,68,0.03) !important;}#upl-gako-s1 .s1-def-card.green-card { border-color: rgba(59,185,139,0.25) !important; background: rgba(59,185,139,0.03) !important;}#upl-gako-s1 .icon-red { background: rgba(239,68,68,0.10) !important; }#upl-gako-s1 .icon-red svg { stroke: #ef4444 !important; }#upl-gako-s1 .icon-green { background: rgba(59,185,139,0.12) !important; }#upl-gako-s1 .icon-green svg { stroke: #3BB98B !important; }@media (max-width: 900px) { #upl-gako-s1 .s1-h2 { font-size: 28px !important; } #upl-gako-s1 .s1-error-grid { grid-template-columns: 1fr !important; } #upl-gako-s1 .s1-def-grid { grid-template-columns: 1fr !important; } #upl-gako-s1 { padding: 50px 20px !important; }}@media (max-width: 600px) { #upl-gako-s1 .s1-h2 { font-size: 26px !important; }}<\/style><div id=\"upl-gako-s1\"> <div class=\"s1-container\"> <span id=\"short-answer\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"s1-badge\"><span class=\"s1-dot\"><\/span><span>The Short Answer<\/span><\/div> <h2 class=\"s1-h2\">Can You Use an API Key with the Gmail API?<\/h2> <pee class=\"s1-intro\">If you’ve built on Google Cloud before, you know API keys work fine for Maps or Translate. So it’s natural to try the same approach with Gmail. It won’t work. Here’s exactly what happens and why – plus the two-sentence verdict before we go deep.<\/pee> <div class=\"s1-verdict-box\"> <div class=\"s1-verdict-icon\"><svg viewBox=\"0 0 24 24\"><circle cx=\"12\" cy=\"12\" r=\"10\"\/><line x1=\"12\" y1=\"8\" x2=\"12\" y2=\"12\"\/><line x1=\"12\" y1=\"16\" x2=\"12.01\" y2=\"16\"\/><\/svg><\/div> <div> <span class=\"s1-verdict-label\">Verdict<\/span> <pee class=\"s1-verdict-text\"><strong>No. Google API keys cannot authenticate against the Gmail API.<\/strong> Gmail accesses private user data, which requires explicit user consent via OAuth 2.0. There is no flag, no header, no workaround that lets you substitute an API key for an OAuth access token on any Gmail endpoint. The Gmail API will return a <strong>401 Login Required<\/strong> or <strong>403 Daily Limit for Unauthenticated Use Exceeded<\/strong> error every single time.<\/pee> <\/div> <\/div>  <div class=\"s1-error-grid\"> <div class=\"s1-error-card\"> <div class=\"s1-error-header\"> <span class=\"s1-dot-r\"><\/span><span class=\"s1-dot-y\"><\/span><span class=\"s1-dot-g\"><\/span> <span class=\"s1-file\">terminal – API key attempt<\/span> <\/div> <div class=\"s1-error-body\"><span class=\"ec\"># Request with API key<\/span><span class=\"em\">GET \/gmail\/v1\/users\/me\/messages<\/span><span class=\"em\"> ?key=AIzaSy…<\/span><span class=\"ec\"># Response<\/span><span class=\"er\">HTTP\/1.1 401 Unauthorized<\/span><span class=\"ev\">{ “error”: { “code”: <\/span><span class=\"en\">401<\/span><span class=\"ev\">, “message”: “Login Required”, “status”: “UNAUTHENTICATED” }}<\/span><\/div> <div class=\"s1-error-note\">401 Login Required – API key rejected<\/div> <\/div> <div class=\"s1-error-card\"> <div class=\"s1-error-header\"> <span class=\"s1-dot-r\"><\/span><span class=\"s1-dot-y\"><\/span><span class=\"s1-dot-g\"><\/span> <span class=\"s1-file\">terminal – unauthenticated quota hit<\/span> <\/div> <div class=\"s1-error-body\"><span class=\"ec\"># After repeated unauthenticated calls<\/span><span class=\"em\">GET \/gmail\/v1\/users\/me\/messages<\/span><span class=\"em\"> ?key=AIzaSy…<\/span><span class=\"ec\"># Response<\/span><span class=\"er\">HTTP\/1.1 403 Forbidden<\/span><span class=\"ev\">{ “error”: { “code”: <\/span><span class=\"en\">403<\/span><span class=\"ev\">, “message”: “Daily Limit for Unauthenticated Use Exceeded”, “status”: “RESOURCE_EXHAUSTED” }}<\/span><\/div> <div class=\"s1-error-note\">403 Unauthenticated Quota Exceeded<\/div> <\/div> <\/div>  <div class=\"s1-def-grid\"> <div class=\"s1-def-card red-card\"> <div class=\"s1-def-card-icon icon-red\"><svg viewBox=\"0 0 24 24\"><circle cx=\"12\" cy=\"12\" r=\"10\"\/><line x1=\"15\" y1=\"9\" x2=\"9\" y2=\"15\"\/><line x1=\"9\" y1=\"9\" x2=\"15\" y2=\"15\"\/><\/svg><\/div> <h3>API Key – Works for public data only<\/h3> <pee>An API key identifies your Google Cloud project for billing and quota. It works with public APIs (Maps, Translate, YouTube public data) that don’t touch user accounts. Gmail is never public data.<\/pee> <\/div> <div class=\"s1-def-card green-card\"> <div class=\"s1-def-card-icon icon-green\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><\/div> <h3>OAuth 2.0 – Required for Gmail API<\/h3> <pee>OAuth 2.0 generates a user-specific access token after the user explicitly grants consent. Gmail API reads that token on every request to verify both the user’s identity and the scope of access approved. No valid access token = no response.<\/pee> <\/div> <\/div> <\/div><\/div>[\/et_pb_code][\/et_pb_column][\/et_pb_row][\/et_pb_section][et_pb_section fb_built=”1″ _builder_version=”4.27.3″ background_color=”transparent” custom_padding=”0px|0px|0px|0px|false|false” global_colors_info=”{}” theme_builder_area=”post_content” da_is_popup=”off” da_exit_intent=”off” da_has_close=”on” da_alt_close=”off” da_dark_close=”off” da_not_modal=”on” da_is_singular=”off” da_with_loader=”off” da_has_shadow=”on” da_disable_devices=”off|off|off”][et_pb_row _builder_version=”4.27.3″ background_color=”transparent” global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_column type=”4_4″ _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_code _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”]<link href=\"https:\/\/fonts.googleapis.com\/css2?family=Inter:wght@400;500;600;700&family=Poppins:wght@700;800&display=swap\" rel=\"stylesheet\"><style>#upl-gako-s2,#upl-gako-s2 *,#upl-gako-s2 *::before,#upl-gako-s2 *::after { margin: 0 !important; padding: 0 !important; box-sizing: border-box !important; border: none !important; outline: none !important; font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif !important; line-height: 1.5 !important; letter-spacing: normal !important; text-transform: none !important; text-decoration: none !important; list-style: none !important;}#upl-gako-s2 { background: #f4f5f7 !important; padding: 60px 20px !important;}#upl-gako-s2 .s2-container { max-width: 1100px !important; margin: 0 auto !important;}#upl-gako-s2 .s2-badge { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: rgba(221,223,76,0.18) !important; color: #8a8c2e !important; padding: 6px 14px !important; border-radius: 20px !important; font-size: 12px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.5px !important; margin-bottom: 16px !important; width: fit-content !important;}#upl-gako-s2 .s2-badge .s2-dot { width: 7px !important; height: 7px !important; background: #DDDF4C !important; border-radius: 50% !important; flex-shrink: 0 !important;}#upl-gako-s2 .s2-h2 { font-family: 'Poppins', sans-serif !important; font-size: 35px !important; font-weight: 700 !important; color: #0f2736 !important; line-height: 1.2 !important; margin-bottom: 16px !important;}#upl-gako-s2 .s2-intro { font-size: 17px !important; color: #383838 !important; line-height: 1.75 !important; margin-bottom: 40px !important;}\/* Two-col split *\/#upl-gako-s2 .s2-split { display: grid !important; grid-template-columns: 1fr 1fr !important; gap: 28px !important; margin-bottom: 36px !important;}#upl-gako-s2 .s2-col-title { font-family: 'Poppins', sans-serif !important; font-size: 17px !important; font-weight: 700 !important; color: #0f2736 !important; margin-bottom: 16px !important; display: flex !important; align-items: center !important; gap: 10px !important;}#upl-gako-s2 .s2-col-title svg { width: 20px !important; height: 20px !important; stroke: currentColor !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important; flex-shrink: 0 !important;}#upl-gako-s2 .col-yes .s2-col-title { color: #2aaa7e !important; }#upl-gako-s2 .col-no .s2-col-title { color: #ef4444 !important; }#upl-gako-s2 .s2-list-item { display: flex !important; align-items: flex-start !important; gap: 10px !important; padding: 10px 14px !important; background: #ffffff !important; border-radius: 10px !important; margin-bottom: 8px !important; border: 1px solid #e5e7eb !important;}#upl-gako-s2 .s2-list-item-icon { width: 20px !important; height: 20px !important; flex-shrink: 0 !important; border-radius: 50% !important; display: flex !important; align-items: center !important; justify-content: center !important; margin-top: 1px !important;}#upl-gako-s2 .s2-list-item-icon svg { width: 11px !important; height: 11px !important; stroke: currentColor !important; fill: none !important; stroke-width: 3 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}#upl-gako-s2 .icon-ok { background: rgba(59,185,139,0.12) !important; color: #3BB98B !important; }#upl-gako-s2 .icon-no { background: rgba(239,68,68,0.10) !important; color: #ef4444 !important; }#upl-gako-s2 .s2-list-item p { font-size: 15px !important; color: #383838 !important; line-height: 1.6 !important;}#upl-gako-s2 .s2-list-item p strong { color: #0f2736 !important; font-weight: 600 !important;}\/* Callout *\/#upl-gako-s2 .s2-callout { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-left: 4px solid #3BB98B !important; border-radius: 12px !important; padding: 20px 24px !important; display: flex !important; gap: 14px !important; align-items: flex-start !important;}#upl-gako-s2 .s2-callout svg { width: 20px !important; height: 20px !important; stroke: #3BB98B !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important; flex-shrink: 0 !important; margin-top: 2px !important;}#upl-gako-s2 .s2-callout p { font-size: 15px !important; color: #383838 !important; line-height: 1.7 !important;}#upl-gako-s2 .s2-callout p strong { color: #0f2736 !important; font-weight: 700 !important;}@media (max-width: 900px) { #upl-gako-s2 .s2-h2 { font-size: 28px !important; } #upl-gako-s2 .s2-split { grid-template-columns: 1fr !important; } #upl-gako-s2 { padding: 50px 20px !important; }}@media (max-width: 600px) { #upl-gako-s2 .s2-h2 { font-size: 26px !important; }}<\/style><div id=\"upl-gako-s2\"> <div class=\"s2-container\"> <span id=\"api-key-does\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"s2-badge\"><span class=\"s2-dot\"><\/span><span>Concepts<\/span><\/div> <h2 class=\"s2-h2\">What an API Key Actually Does on Google Cloud (and Doesn’t)<\/h2> <pee class=\"s2-intro\">API keys and OAuth tokens are two distinct mechanisms that solve two different problems. Confusing them is one of the most common mistakes when starting with Google APIs. Here’s the clean separation.<\/pee> <div class=\"s2-split\"> <div class=\"col-yes\"> <div class=\"s2-col-title\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>What API keys DO work with<\/span><\/div> <div class=\"s2-list-item\"> <span class=\"s2-list-item-icon icon-ok\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><\/span> <pee><strong>Google Maps Platform<\/strong> – Geocoding, Directions, Places (no user account needed)<\/pee> <\/div> <div class=\"s2-list-item\"> <span class=\"s2-list-item-icon icon-ok\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><\/span> <pee><strong>Cloud Translation API<\/strong> – Translating text, detecting languages<\/pee> <\/div> <div class=\"s2-list-item\"> <span class=\"s2-list-item-icon icon-ok\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><\/span> <pee><strong>YouTube Data API<\/strong> – Reading public video metadata, channels, playlists<\/pee> <\/div> <div class=\"s2-list-item\"> <span class=\"s2-list-item-icon icon-ok\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><\/span> <pee><strong>Cloud Vision \/ Natural Language<\/strong> – ML APIs that process content you upload<\/pee> <\/div> <div class=\"s2-list-item\"> <span class=\"s2-list-item-icon icon-ok\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><\/span> <pee><strong>Billing + Quota tracking<\/strong> – All API key usage is metered against your project<\/pee> <\/div> <\/div> <div class=\"col-no\"> <div class=\"s2-col-title\"><svg viewBox=\"0 0 24 24\"><circle cx=\"12\" cy=\"12\" r=\"10\"\/><line x1=\"15\" y1=\"9\" x2=\"9\" y2=\"15\"\/><line x1=\"9\" y1=\"9\" x2=\"15\" y2=\"15\"\/><\/svg><span>What API keys CANNOT do<\/span><\/div> <div class=\"s2-list-item\"> <span class=\"s2-list-item-icon icon-no\"><svg viewBox=\"0 0 24 24\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"\/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"\/><\/svg><\/span> <pee><strong>Gmail API<\/strong> – Reading, sending, or managing any user’s mailbox<\/pee> <\/div> <div class=\"s2-list-item\"> <span class=\"s2-list-item-icon icon-no\"><svg viewBox=\"0 0 24 24\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"\/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"\/><\/svg><\/span> <pee><strong>Google Calendar API<\/strong> – Reading or writing any user’s calendar events<\/pee> <\/div> <div class=\"s2-list-item\"> <span class=\"s2-list-item-icon icon-no\"><svg viewBox=\"0 0 24 24\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"\/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"\/><\/svg><\/span> <pee><strong>Google Drive API<\/strong> – Accessing, uploading, or listing a user’s files<\/pee> <\/div> <div class=\"s2-list-item\"> <span class=\"s2-list-item-icon icon-no\"><svg viewBox=\"0 0 24 24\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"\/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"\/><\/svg><\/span> <pee><strong>Google Workspace Admin SDK<\/strong> – Any admin-scoped operation on a domain<\/pee> <\/div> <div class=\"s2-list-item\"> <span class=\"s2-list-item-icon icon-no\"><svg viewBox=\"0 0 24 24\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"\/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"\/><\/svg><\/span> <pee><strong>People API (user data)<\/strong> – Any endpoint that touches a user’s contacts or profile<\/pee> <\/div> <\/div> <\/div> <div class=\"s2-callout\"> <svg viewBox=\"0 0 24 24\"><circle cx=\"12\" cy=\"12\" r=\"10\"\/><line x1=\"12\" y1=\"8\" x2=\"12\" y2=\"12\"\/><line x1=\"12\" y1=\"16\" x2=\"12.01\" y2=\"16\"\/><\/svg> <pee>The rule is simple: <strong>if an API touches a user’s account data, Google requires that user to authenticate via OAuth 2.0.<\/strong> API keys are project credentials, not user credentials. Gmail API is always user data. No exceptions. This rule applies regardless of whether your app is public or internal to your company.<\/pee> <\/div> <\/div><\/div>[\/et_pb_code][\/et_pb_column][\/et_pb_row][\/et_pb_section][et_pb_section fb_built=”1″ _builder_version=”4.27.3″ background_color=”transparent” custom_padding=”0px|0px|0px|0px|false|false” global_colors_info=”{}” theme_builder_area=”post_content” da_is_popup=”off” da_exit_intent=”off” da_has_close=”on” da_alt_close=”off” da_dark_close=”off” da_not_modal=”on” da_is_singular=”off” da_with_loader=”off” da_has_shadow=”on” da_disable_devices=”off|off|off”][et_pb_row _builder_version=”4.27.3″ background_color=”transparent” global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_column type=”4_4″ _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_code _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”]<link href=\"https:\/\/fonts.googleapis.com\/css2?family=Inter:wght@400;500;600;700&family=Poppins:wght@700;800&display=swap\" rel=\"stylesheet\"><style>#upl-gako-s3,#upl-gako-s3 *,#upl-gako-s3 *::before,#upl-gako-s3 *::after { margin: 0 !important; padding: 0 !important; box-sizing: border-box !important; border: none !important; outline: none !important; font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif !important; line-height: 1.5 !important; letter-spacing: normal !important; text-transform: none !important; text-decoration: none !important; list-style: none !important;}#upl-gako-s3 { background: transparent !important; padding: 60px 20px !important;}#upl-gako-s3 .s3-container { max-width: 1100px !important; margin: 0 auto !important;}#upl-gako-s3 .s3-badge { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: rgba(59,185,139,0.12) !important; color: #2aaa7e !important; padding: 6px 14px !important; border-radius: 20px !important; font-size: 12px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.5px !important; margin-bottom: 16px !important; width: fit-content !important;}#upl-gako-s3 .s3-badge .s3-dot { width: 7px !important; height: 7px !important; background: #3BB98B !important; border-radius: 50% !important; flex-shrink: 0 !important;}#upl-gako-s3 .s3-h2 { font-family: 'Poppins', sans-serif !important; font-size: 35px !important; font-weight: 700 !important; color: #0f2736 !important; line-height: 1.2 !important; margin-bottom: 16px !important;}#upl-gako-s3 .s3-intro { font-size: 17px !important; color: #383838 !important; line-height: 1.75 !important; margin-bottom: 40px !important;}#upl-gako-s3 .s3-reason-grid { display: grid !important; grid-template-columns: repeat(3, 1fr) !important; gap: 20px !important; margin-bottom: 40px !important;}#upl-gako-s3 .s3-reason-card { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; padding: 24px !important;}#upl-gako-s3 .s3-reason-num { font-family: 'Poppins', sans-serif !important; font-size: 36px !important; font-weight: 800 !important; color: rgba(59,185,139,0.20) !important; line-height: 1 !important; margin-bottom: 12px !important; display: block !important;}#upl-gako-s3 .s3-reason-card h3 { font-family: 'Poppins', sans-serif !important; font-size: 16px !important; font-weight: 700 !important; color: #0f2736 !important; margin-bottom: 10px !important; line-height: 1.35 !important;}#upl-gako-s3 .s3-reason-card p { font-size: 14.5px !important; color: #4a5568 !important; line-height: 1.7 !important;}\/* Deprecation callout *\/#upl-gako-s3 .s3-depr-box { background: rgba(234,67,53,0.06) !important; border: 1px solid rgba(234,67,53,0.20) !important; border-radius: 14px !important; padding: 22px 26px !important; display: flex !important; gap: 16px !important; align-items: flex-start !important; margin-bottom: 40px !important;}#upl-gako-s3 .s3-depr-box svg { width: 22px !important; height: 22px !important; stroke: #ea4335 !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important; flex-shrink: 0 !important; margin-top: 1px !important;}#upl-gako-s3 .s3-depr-label { font-size: 11px !important; font-weight: 700 !important; color: #ea4335 !important; text-transform: uppercase !important; letter-spacing: 0.8px !important; margin-bottom: 6px !important; display: block !important;}#upl-gako-s3 .s3-depr-box p { font-size: 15px !important; color: #383838 !important; line-height: 1.7 !important;}#upl-gako-s3 .s3-depr-box p strong { color: #0f2736 !important; font-weight: 700 !important;}\/* Inline CTA *\/#upl-gako-s3 .s3-cta-strip { background: #0f2736 !important; border-radius: 14px !important; padding: 24px 28px !important; display: flex !important; align-items: center !important; justify-content: space-between !important; gap: 20px !important; flex-wrap: wrap !important;}#upl-gako-s3 .s3-cta-strip p { font-size: 16px !important; color: rgba(255,255,255,0.88) !important; line-height: 1.6 !important;}#upl-gako-s3 .s3-cta-strip p strong { color: #ffffff !important;}#upl-gako-s3 .s3-cta-btn { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: #DDDF4C !important; color: #0f2736 !important; padding: 12px 22px !important; border-radius: 8px !important; font-size: 0.9rem !important; font-weight: 600 !important; border: 2px solid #DDDF4C !important; transition: transform 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important; flex-shrink: 0 !important;}#upl-gako-s3 .s3-cta-btn:hover { transform: translateY(-5px) !important;}#upl-gako-s3 .s3-cta-btn svg { width: 14px !important; height: 14px !important; stroke: currentColor !important; fill: none !important; stroke-width: 2.5 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}@media (max-width: 900px) { #upl-gako-s3 .s3-h2 { font-size: 28px !important; } #upl-gako-s3 .s3-reason-grid { grid-template-columns: 1fr !important; } #upl-gako-s3 { padding: 50px 20px !important; } #upl-gako-s3 .s3-cta-strip { flex-direction: column !important; align-items: flex-start !important; }}@media (max-width: 600px) { #upl-gako-s3 .s3-h2 { font-size: 26px !important; } #upl-gako-s3 .s3-cta-btn { width: 100% !important; justify-content: center !important; }}<\/style><div id=\"upl-gako-s3\"> <div class=\"s3-container\"> <span id=\"why-oauth\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"s3-badge\"><span class=\"s3-dot\"><\/span><span>Architecture<\/span><\/div> <h2 class=\"s3-h2\">Why Gmail Requires OAuth 2.0<\/h2> <pee class=\"s3-intro\">OAuth 2.0 isn’t a bureaucratic hurdle Google invented to slow you down. It’s the only technically sound way to grant scoped, revocable, auditable access to private user data. Gmail’s three core requirements explain why an API key can never substitute.<\/pee> <div class=\"s3-reason-grid\"> <div class=\"s3-reason-card\"> <span class=\"s3-reason-num\">01<\/span> <h3>User consent is non-negotiable<\/h3> <pee>Gmail data belongs to the user, not your application. OAuth 2.0 is the mechanism by which a user explicitly says “yes, this application can read my inbox.” No consent flow = no access. This is a legal requirement under GDPR and a Google platform policy, not just a technical restriction.<\/pee> <\/div> <div class=\"s3-reason-card\"> <span class=\"s3-reason-num\">02<\/span> <h3>Scoped, revocable access<\/h3> <pee>OAuth tokens carry scopes – precise declarations of what the app can and cannot do (read-only, send, full access). Users can see exactly what access they granted and revoke it at any time from their Google Account settings. An API key grants nothing and can revoke nothing at the user level.<\/pee> <\/div> <div class=\"s3-reason-card\"> <span class=\"s3-reason-num\">03<\/span> <h3>Token expiry protects users<\/h3> <pee>Gmail API access tokens expire (typically 1 hour). This means a stolen token is useless after a short window. Your app must silently refresh tokens using a refresh token – which itself can be revoked. API keys, by contrast, are long-lived project credentials with no user-level revocation mechanism.<\/pee> <\/div> <\/div> <div class=\"s3-depr-box\"> <svg viewBox=\"0 0 24 24\"><path d=\"M10.29 3.86L1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z\"\/><line x1=\"12\" y1=\"9\" x2=\"12\" y2=\"13\"\/><line x1=\"12\" y1=\"17\" x2=\"12.01\" y2=\"17\"\/><\/svg> <div> <span class=\"s3-depr-label\">Important: Basic Auth deprecated September 2024<\/span> <pee>Google deprecated username\/password authentication (“Basic Auth”) for Gmail in <strong>September 2024<\/strong>. If you have any legacy integration using stored credentials directly, it has stopped working. OAuth 2.0 is the only remaining authentication mechanism for Gmail API – both for new integrations and migrated ones. <a href=\"https:\/\/support.google.com\/a\/answer\/162106\" target=\"_blank\" rel=\"noopener\" style=\"color:#2aaa7e!important;text-decoration:underline!important;\">See Google’s official announcement<\/a>.<\/pee> <\/div> <\/div> <div class=\"s3-cta-strip\"> <pee><strong>Need to handle OAuth for multiple Gmail accounts in your SaaS?<\/strong> Unipile manages the consent screen, token exchange, and silent refresh for every linked account – so your code never touches a token.<\/pee> <span class=\"s3-cta-btn\" data-upl-link=\"https:\/\/dashboard.unipile.com\/signup\/\" data-upl-target=\"_blank\"><span>Build it with Unipile<\/span><svg viewBox=\"0 0 24 24\"><line x1=\"5\" y1=\"12\" x2=\"19\" y2=\"12\"\/><polyline points=\"12 5 19 12 12 19\"\/><\/svg><\/span> <\/div> <\/div><\/div><script>(function(){ function init(){ var el = document.getElementById('upl-gako-s3'); if (!el) return; el.addEventListener('click', function(e){ var t = e.target.closest('[data-upl-link]'); if (!t) return; var url = t.getAttribute('data-upl-link'); var target = t.getAttribute('data-upl-target') || '_self'; if (url) window.open(url, target); }); } if (document.readyState === 'loading') { document.addEventListener('DOMContentLoaded', init); } else { init(); }})();<\/script>[\/et_pb_code][\/et_pb_column][\/et_pb_row][\/et_pb_section][et_pb_section fb_built=”1″ _builder_version=”4.27.3″ background_color=”transparent” custom_padding=”0px|0px|0px|0px|false|false” global_colors_info=”{}” theme_builder_area=”post_content” da_is_popup=”off” da_exit_intent=”off” da_has_close=”on” da_alt_close=”off” da_dark_close=”off” da_not_modal=”on” da_is_singular=”off” da_with_loader=”off” da_has_shadow=”on” da_disable_devices=”off|off|off”][et_pb_row _builder_version=”4.27.3″ background_color=”transparent” global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_column type=”4_4″ _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_code _builder_version=”4.27.4″ hover_enabled=”0″ global_colors_info=”{}” theme_builder_area=”post_content” sticky_enabled=”0″]<!DOCTYPE html><html lang=\"en\"><head><meta charset=\"UTF-8\"><meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\"><title>Unipile – Gmail Auth Comparison<\/title><link href=\"https:\/\/fonts.googleapis.com\/css2?family=Inter:wght@400;500;600;700&family=Poppins:wght@700;800&display=swap\" rel=\"stylesheet\"><style>body { background: #f4f5f7; margin: 0; }#upl-gako-s4,#upl-gako-s4 *,#upl-gako-s4 *::before,#upl-gako-s4 *::after { margin: 0 !important; padding: 0 !important; box-sizing: border-box !important; border: none !important; outline: none !important; font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif !important; line-height: 1.5 !important; letter-spacing: normal !important; text-transform: none !important; text-decoration: none !important; list-style: none !important;}#upl-gako-s4 { background: #f4f5f7 !important; padding: 60px 20px !important;}#upl-gako-s4 .s4-container { max-width: 1100px !important; margin: 0 auto !important;}#upl-gako-s4 .s4-badge { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: rgba(59,185,139,0.12) !important; color: #2aaa7e !important; padding: 6px 14px !important; border-radius: 20px !important; font-size: 12px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.5px !important; margin-bottom: 16px !important; width: fit-content !important;}#upl-gako-s4 .s4-badge .s4-dot { width: 7px !important; height: 7px !important; background: #3BB98B !important; border-radius: 50% !important; flex-shrink: 0 !important;}#upl-gako-s4 .s4-h2 { font-family: 'Poppins', sans-serif !important; font-size: 35px !important; font-weight: 700 !important; color: #0f2736 !important; line-height: 1.2 !important; margin-bottom: 16px !important;}#upl-gako-s4 .s4-intro { font-size: 17px !important; color: #383838 !important; line-height: 1.75 !important; margin-bottom: 36px !important;}\/* Comparison table *\/#upl-gako-s4 .s4-table-wrap { overflow-x: auto !important; border-radius: 16px !important; border: 1px solid #e5e7eb !important; background: #ffffff !important; margin-bottom: 28px !important;}#upl-gako-s4 table { width: 100% !important; border-collapse: collapse !important;}#upl-gako-s4 thead tr { background: #0f2736 !important;}#upl-gako-s4 thead th { padding: 16px 20px !important; font-family: 'Poppins', sans-serif !important; font-size: 13px !important; font-weight: 700 !important; color: #ffffff !important; text-align: left !important; white-space: nowrap !important;}#upl-gako-s4 thead th:first-child { border-radius: 15px 0 0 0 !important;}#upl-gako-s4 thead th:last-child { border-radius: 0 15px 0 0 !important;}#upl-gako-s4 thead th.col-highlight { background: #3BB98B !important;}#upl-gako-s4 tbody tr { border-bottom: 1px solid #f0f1f3 !important;}#upl-gako-s4 tbody tr:last-child { border-bottom: none !important;}#upl-gako-s4 tbody tr:nth-child(even) td { background: #f8fafc !important;}#upl-gako-s4 tbody tr:nth-child(even) td.col-highlight { background: rgba(59,185,139,0.06) !important;}#upl-gako-s4 tbody td { padding: 14px 20px !important; font-size: 14px !important; color: #383838 !important; vertical-align: top !important;}#upl-gako-s4 tbody td.col-highlight { background: rgba(59,185,139,0.04) !important;}#upl-gako-s4 tbody td.row-label { font-weight: 600 !important; color: #0f2736 !important; font-size: 13.5px !important; white-space: nowrap !important;}#upl-gako-s4 .ok-icon { display: inline-flex !important; align-items: center !important; gap: 6px !important; color: #2aaa7e !important; font-size: 13px !important; font-weight: 600 !important;}#upl-gako-s4 .ok-icon svg { width: 14px !important; height: 14px !important; stroke: #3BB98B !important; fill: none !important; stroke-width: 2.5 !important; stroke-linecap: round !important; stroke-linejoin: round !important; flex-shrink: 0 !important;}#upl-gako-s4 .no-icon { display: inline-flex !important; align-items: center !important; gap: 6px !important; color: #ef4444 !important; font-size: 13px !important; font-weight: 600 !important;}#upl-gako-s4 .no-icon svg { width: 14px !important; height: 14px !important; stroke: #ef4444 !important; fill: none !important; stroke-width: 2.5 !important; stroke-linecap: round !important; stroke-linejoin: round !important; flex-shrink: 0 !important;}#upl-gako-s4 .partial-icon { display: inline-flex !important; align-items: center !important; gap: 6px !important; color: #f59e0b !important; font-size: 13px !important; font-weight: 600 !important;}#upl-gako-s4 .partial-icon svg { width: 14px !important; height: 14px !important; stroke: #f59e0b !important; fill: none !important; stroke-width: 2.5 !important; stroke-linecap: round !important; stroke-linejoin: round !important; flex-shrink: 0 !important;}#upl-gako-s4 .s4-note { font-size: 13px !important; color: #94a3b8 !important; margin-top: 4px !important; line-height: 1.5 !important;}\/* ===== MOBILE CARDS (hidden on desktop) ===== *\/#upl-gako-s4 .s4-cards { display: none !important;}#upl-gako-s4 .s4-card { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; overflow: hidden !important; margin-bottom: 16px !important;}#upl-gako-s4 .s4-card:last-child { margin-bottom: 0 !important;}#upl-gako-s4 .s4-card-head { background: #0f2736 !important; padding: 16px 18px !important;}#upl-gako-s4 .s4-card.is-highlight .s4-card-head { background: #3BB98B !important;}#upl-gako-s4 .s4-card-title { font-family: 'Poppins', sans-serif !important; font-size: 15px !important; font-weight: 700 !important; color: #ffffff !important; line-height: 1.35 !important;}#upl-gako-s4 .s4-card-tag { display: inline-block !important; margin-top: 6px !important; font-size: 10px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.5px !important; color: #ffffff !important; background: rgba(255,255,255,0.18) !important; padding: 3px 8px !important; border-radius: 5px !important;}#upl-gako-s4 .s4-card-row { padding: 13px 18px !important; border-bottom: 1px solid #f0f1f3 !important;}#upl-gako-s4 .s4-card.is-highlight .s4-card-row { background: rgba(59,185,139,0.04) !important;}#upl-gako-s4 .s4-card-row:last-child { border-bottom: none !important;}#upl-gako-s4 .s4-card-label { font-size: 12px !important; font-weight: 600 !important; color: #94a3b8 !important; text-transform: uppercase !important; letter-spacing: 0.3px !important; margin-bottom: 5px !important; display: block !important;}#upl-gako-s4 .s4-card-value { font-size: 14px !important; color: #383838 !important; line-height: 1.55 !important;}@media (max-width: 900px) { #upl-gako-s4 .s4-h2 { font-size: 28px !important; } #upl-gako-s4 { padding: 50px 20px !important; }}@media (max-width: 600px) { #upl-gako-s4 { padding: 50px 16px !important; } #upl-gako-s4 .s4-h2 { font-size: 26px !important; } #upl-gako-s4 .s4-intro { font-size: 15.5px !important; } \/* Switch table -> cards *\/ #upl-gako-s4 .s4-table-wrap { display: none !important; } #upl-gako-s4 .s4-cards { display: block !important; }}@media (max-width: 400px) { #upl-gako-s4 .s4-h2 { font-size: 22px !important; }}<\/style><div id=\"upl-gako-s4\"> <div class=\"s4-container\"> <span id=\"three-paths\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"s4-badge\"><span class=\"s4-dot\"><\/span><span>Comparison<\/span><\/div> <h2 class=\"s4-h2\">The 3 Real Authentication Paths for Gmail API<\/h2> <pee class=\"s4-intro\">Once you’ve accepted that OAuth is unavoidable, the question becomes: which OAuth path fits your use case? There are three architecturally distinct options – each with different tradeoffs on complexity, user scope, and maintenance overhead.<\/pee>  <div class=\"s4-table-wrap\"> <table> <thead> <tr> <th>Criterion<\/th> <th>OAuth 2.0 Client ID (3-legged)<\/th> <th>Service Account + DWD<\/th> <th class=\"col-highlight\">Unified API (Unipile)<\/th> <\/tr> <\/thead> <tbody> <tr> <td class=\"row-label\">User consent required?<\/td> <td><span class=\"ok-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Yes – per user<\/span><\/span><\/td> <td><span class=\"no-icon\"><svg viewBox=\"0 0 24 24\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"\/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"\/><\/svg><span>No (admin delegates)<\/span><\/span><\/td> <td class=\"col-highlight\"><span class=\"ok-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Yes – via Unipile UI<\/span><\/span><\/td> <\/tr> <tr> <td class=\"row-label\">Works with personal Gmail?<\/td> <td><span class=\"ok-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Yes<\/span><\/span><\/td> <td><span class=\"no-icon\"><svg viewBox=\"0 0 24 24\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"\/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"\/><\/svg><span>No (Workspace only)<\/span><\/span><\/td> <td class=\"col-highlight\"><span class=\"ok-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Yes<\/span><\/span><\/td> <\/tr> <tr> <td class=\"row-label\">Multi-tenant SaaS?<\/td> <td><span class=\"ok-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Yes<\/span><\/span><\/td> <td><span class=\"no-icon\"><svg viewBox=\"0 0 24 24\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"\/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"\/><\/svg><span>Same Workspace only<\/span><\/span><\/td> <td class=\"col-highlight\"><span class=\"ok-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Yes, built for it<\/span><\/span><\/td> <\/tr> <tr> <td class=\"row-label\">Token management<\/td> <td>Your code stores + refreshes tokens<div class=\"s4-note\">High maintenance<\/div><\/td> <td>Service account JSON key<div class=\"s4-note\">Admin-managed<\/div><\/td> <td class=\"col-highlight\">Unipile handles all tokens<div class=\"s4-note\">Zero maintenance<\/div><\/td> <\/tr> <tr> <td class=\"row-label\">Google consent screen review?<\/td> <td><span class=\"ok-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Required (sensitive scopes)<\/span><\/span><\/td> <td><span class=\"partial-icon\"><svg viewBox=\"0 0 24 24\"><line x1=\"12\" y1=\"2\" x2=\"12\" y2=\"22\"\/><path d=\"M17 5H9.5a3.5 3.5 0 0 0 0 7h5a3.5 3.5 0 0 1 0 7H6\"\/><\/svg><span>Admin config only<\/span><\/span><\/td> <td class=\"col-highlight\"><span class=\"no-icon\"><svg viewBox=\"0 0 24 24\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"\/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"\/><\/svg><span>Not required<\/span><\/span><\/td> <\/tr> <tr> <td class=\"row-label\">Also supports Outlook + IMAP?<\/td> <td><span class=\"no-icon\"><svg viewBox=\"0 0 24 24\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"\/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"\/><\/svg><span>Gmail only<\/span><\/span><\/td> <td><span class=\"no-icon\"><svg viewBox=\"0 0 24 24\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"\/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"\/><\/svg><span>Gmail\/Workspace only<\/span><\/span><\/td> <td class=\"col-highlight\"><span class=\"ok-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Gmail, Outlook, IMAP<\/span><\/span><\/td> <\/tr> <tr> <td class=\"row-label\">Time to first email read<\/td> <td>2-4 hours setup<div class=\"s4-note\">OAuth app + scopes + consent screen<\/div><\/td> <td>1-2 hours setup<div class=\"s4-note\">Workspace admin required<\/div><\/td> <td class=\"col-highlight\">Under 15 minutes<div class=\"s4-note\">API key + linked account<\/div><\/td> <\/tr> <tr> <td class=\"row-label\">Best for<\/td> <td>SaaS apps connecting external users’ Gmail<\/td> <td>Internal Workspace tooling for your org<\/td> <td class=\"col-highlight\">Any email API use case – no OAuth ops<\/td> <\/tr> <\/tbody> <\/table> <\/div>  <div class=\"s4-cards\">  <div class=\"s4-card\"> <div class=\"s4-card-head\"> <div class=\"s4-card-title\">OAuth 2.0 Client ID (3-legged)<\/div> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">User consent required?<\/span> <span class=\"s4-card-value\"><span class=\"ok-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Yes – per user<\/span><\/span><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Works with personal Gmail?<\/span> <span class=\"s4-card-value\"><span class=\"ok-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Yes<\/span><\/span><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Multi-tenant SaaS?<\/span> <span class=\"s4-card-value\"><span class=\"ok-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Yes<\/span><\/span><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Token management<\/span> <span class=\"s4-card-value\">Your code stores + refreshes tokens<div class=\"s4-note\">High maintenance<\/div><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Google consent screen review?<\/span> <span class=\"s4-card-value\"><span class=\"ok-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Required (sensitive scopes)<\/span><\/span><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Also supports Outlook + IMAP?<\/span> <span class=\"s4-card-value\"><span class=\"no-icon\"><svg viewBox=\"0 0 24 24\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"\/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"\/><\/svg><span>Gmail only<\/span><\/span><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Time to first email read<\/span> <span class=\"s4-card-value\">2-4 hours setup<div class=\"s4-note\">OAuth app + scopes + consent screen<\/div><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Best for<\/span> <span class=\"s4-card-value\">SaaS apps connecting external users’ Gmail<\/span> <\/div> <\/div>  <div class=\"s4-card\"> <div class=\"s4-card-head\"> <div class=\"s4-card-title\">Service Account + DWD<\/div> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">User consent required?<\/span> <span class=\"s4-card-value\"><span class=\"no-icon\"><svg viewBox=\"0 0 24 24\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"\/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"\/><\/svg><span>No (admin delegates)<\/span><\/span><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Works with personal Gmail?<\/span> <span class=\"s4-card-value\"><span class=\"no-icon\"><svg viewBox=\"0 0 24 24\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"\/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"\/><\/svg><span>No (Workspace only)<\/span><\/span><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Multi-tenant SaaS?<\/span> <span class=\"s4-card-value\"><span class=\"no-icon\"><svg viewBox=\"0 0 24 24\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"\/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"\/><\/svg><span>Same Workspace only<\/span><\/span><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Token management<\/span> <span class=\"s4-card-value\">Service account JSON key<div class=\"s4-note\">Admin-managed<\/div><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Google consent screen review?<\/span> <span class=\"s4-card-value\"><span class=\"partial-icon\"><svg viewBox=\"0 0 24 24\"><line x1=\"12\" y1=\"2\" x2=\"12\" y2=\"22\"\/><path d=\"M17 5H9.5a3.5 3.5 0 0 0 0 7h5a3.5 3.5 0 0 1 0 7H6\"\/><\/svg><span>Admin config only<\/span><\/span><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Also supports Outlook + IMAP?<\/span> <span class=\"s4-card-value\"><span class=\"no-icon\"><svg viewBox=\"0 0 24 24\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"\/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"\/><\/svg><span>Gmail\/Workspace only<\/span><\/span><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Time to first email read<\/span> <span class=\"s4-card-value\">1-2 hours setup<div class=\"s4-note\">Workspace admin required<\/div><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Best for<\/span> <span class=\"s4-card-value\">Internal Workspace tooling for your org<\/span> <\/div> <\/div>  <div class=\"s4-card is-highlight\"> <div class=\"s4-card-head\"> <div class=\"s4-card-title\">Unified API (Unipile)<\/div> <span class=\"s4-card-tag\">Recommended<\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">User consent required?<\/span> <span class=\"s4-card-value\"><span class=\"ok-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Yes – via Unipile UI<\/span><\/span><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Works with personal Gmail?<\/span> <span class=\"s4-card-value\"><span class=\"ok-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Yes<\/span><\/span><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Multi-tenant SaaS?<\/span> <span class=\"s4-card-value\"><span class=\"ok-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Yes, built for it<\/span><\/span><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Token management<\/span> <span class=\"s4-card-value\">Unipile handles all tokens<div class=\"s4-note\">Zero maintenance<\/div><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Google consent screen review?<\/span> <span class=\"s4-card-value\"><span class=\"no-icon\"><svg viewBox=\"0 0 24 24\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"\/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"\/><\/svg><span>Not required<\/span><\/span><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Also supports Outlook + IMAP?<\/span> <span class=\"s4-card-value\"><span class=\"ok-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Gmail, Outlook, IMAP<\/span><\/span><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Time to first email read<\/span> <span class=\"s4-card-value\">Under 15 minutes<div class=\"s4-note\">API key + linked account<\/div><\/span> <\/div> <div class=\"s4-card-row\"> <span class=\"s4-card-label\">Best for<\/span> <span class=\"s4-card-value\">Any email API use case – no OAuth ops<\/span> <\/div> <\/div> <\/div> <\/div><\/div><\/body><\/html>[\/et_pb_code][\/et_pb_column][\/et_pb_row][\/et_pb_section][et_pb_section fb_built=”1″ _builder_version=”4.27.3″ background_color=”transparent” custom_padding=”0px|0px|0px|0px|false|false” global_colors_info=”{}” theme_builder_area=”post_content” da_is_popup=”off” da_exit_intent=”off” da_has_close=”on” da_alt_close=”off” da_dark_close=”off” da_not_modal=”on” da_is_singular=”off” da_with_loader=”off” da_has_shadow=”on” da_disable_devices=”off|off|off”][et_pb_row _builder_version=”4.27.3″ background_color=”transparent” global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_column type=”4_4″ _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_code _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”]<link href=\"https:\/\/fonts.googleapis.com\/css2?family=Inter:wght@400;500;600;700&family=Poppins:wght@700;800&display=swap\" rel=\"stylesheet\"><style>#upl-gako-s5,#upl-gako-s5 *,#upl-gako-s5 *::before,#upl-gako-s5 *::after { margin: 0 !important; padding: 0 !important; box-sizing: border-box !important; border: none !important; outline: none !important; font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif !important; line-height: 1.5 !important; letter-spacing: normal !important; text-transform: none !important; text-decoration: none !important; list-style: none !important;}#upl-gako-s5 { background: transparent !important; padding: 60px 20px !important;}#upl-gako-s5 .s5-container { max-width: 1100px !important; margin: 0 auto !important;}#upl-gako-s5 .s5-badge { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: rgba(221,223,76,0.18) !important; color: #8a8c2e !important; padding: 6px 14px !important; border-radius: 20px !important; font-size: 12px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.5px !important; margin-bottom: 16px !important; width: fit-content !important;}#upl-gako-s5 .s5-badge .s5-dot { width: 7px !important; height: 7px !important; background: #DDDF4C !important; border-radius: 50% !important; flex-shrink: 0 !important;}#upl-gako-s5 .s5-h2 { font-family: 'Poppins', sans-serif !important; font-size: 35px !important; font-weight: 700 !important; color: #0f2736 !important; line-height: 1.2 !important; margin-bottom: 16px !important;}#upl-gako-s5 .s5-intro { font-size: 17px !important; color: #383838 !important; line-height: 1.75 !important; margin-bottom: 36px !important;}\/* Steps *\/#upl-gako-s5 .s5-steps { display: flex !important; flex-direction: column !important; gap: 16px !important; margin-bottom: 36px !important;}#upl-gako-s5 .s5-step { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 14px !important; padding: 20px 24px !important; display: flex !important; gap: 16px !important; align-items: flex-start !important;}#upl-gako-s5 .s5-step-num { width: 36px !important; height: 36px !important; min-width: 36px !important; background: rgba(221,223,76,0.18) !important; border-radius: 10px !important; display: flex !important; align-items: center !important; justify-content: center !important; font-family: 'Poppins', sans-serif !important; font-size: 14px !important; font-weight: 800 !important; color: #8a8c2e !important;}#upl-gako-s5 .s5-step h3 { font-family: 'Poppins', sans-serif !important; font-size: 15px !important; font-weight: 700 !important; color: #0f2736 !important; margin-bottom: 6px !important; line-height: 1.35 !important;}#upl-gako-s5 .s5-step p { font-size: 14.5px !important; color: #4a5568 !important; line-height: 1.65 !important;}#upl-gako-s5 .s5-step p a { color: #2aaa7e !important; text-decoration: underline !important;}\/* Code block *\/#upl-gako-s5 .s5-code-wrap { border-radius: 14px !important; overflow: hidden !important; background: #0d1117 !important; margin-bottom: 28px !important;}#upl-gako-s5 .s5-editor-bar { background: #161b22 !important; padding: 12px 18px !important; display: flex !important; align-items: center !important; gap: 8px !important; border-bottom: 1px solid rgba(255,255,255,0.06) !important;}#upl-gako-s5 .s5-dot-r { width: 10px !important; height: 10px !important; border-radius: 50% !important; background: #ff5f57 !important; flex-shrink: 0 !important; }#upl-gako-s5 .s5-dot-y { width: 10px !important; height: 10px !important; border-radius: 50% !important; background: #febc2e !important; flex-shrink: 0 !important; }#upl-gako-s5 .s5-dot-g { width: 10px !important; height: 10px !important; border-radius: 50% !important; background: #28c840 !important; flex-shrink: 0 !important; }#upl-gako-s5 .s5-file { color: #8b949e !important; font-size: 12px !important; font-family: 'Courier New', monospace !important; margin-left: 4px !important; }#upl-gako-s5 .s5-pre { padding: 22px 24px !important; font-size: 13px !important; line-height: 1.8 !important; overflow-x: auto !important; background: #0d1117 !important;}#upl-gako-s5 .s5-pre code { font-family: 'Courier New', monospace !important; white-space: pre !important; display: block !important;}#upl-gako-s5 .c { color: #8b949e !important; }#upl-gako-s5 .k { color: #ff7b72 !important; }#upl-gako-s5 .fn { color: #d2a8ff !important; }#upl-gako-s5 .s { color: #a5d6ff !important; }#upl-gako-s5 .n { color: #79c0ff !important; }#upl-gako-s5 .w { color: #e6edf3 !important; }\/* inline CTA *\/#upl-gako-s5 .s5-inline-cta { background: rgba(59,185,139,0.08) !important; border: 1px solid rgba(59,185,139,0.25) !important; border-radius: 12px !important; padding: 18px 22px !important; display: flex !important; align-items: center !important; justify-content: space-between !important; gap: 16px !important; flex-wrap: wrap !important;}#upl-gako-s5 .s5-inline-cta p { font-size: 15px !important; color: #383838 !important; line-height: 1.6 !important;}#upl-gako-s5 .s5-inline-cta p strong { color: #0f2736 !important;}#upl-gako-s5 .s5-inline-cta-btn { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: #DDDF4C !important; color: #0f2736 !important; padding: 10px 20px !important; border-radius: 8px !important; font-size: 0.88rem !important; font-weight: 600 !important; border: 2px solid #DDDF4C !important; transition: transform 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important; flex-shrink: 0 !important;}#upl-gako-s5 .s5-inline-cta-btn:hover { transform: translateY(-5px) !important;}#upl-gako-s5 .s5-inline-cta-btn svg { width: 13px !important; height: 13px !important; stroke: currentColor !important; fill: none !important; stroke-width: 2.5 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}@media (max-width: 900px) { #upl-gako-s5 .s5-h2 { font-size: 28px !important; } #upl-gako-s5 { padding: 50px 20px !important; } #upl-gako-s5 .s5-inline-cta { flex-direction: column !important; align-items: flex-start !important; }}@media (max-width: 600px) { #upl-gako-s5 .s5-h2 { font-size: 26px !important; } #upl-gako-s5 .s5-inline-cta-btn { width: 100% !important; justify-content: center !important; }}<\/style><div id=\"upl-gako-s5\"> <div class=\"s5-container\"> <span id=\"path-oauth-client\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"s5-badge\"><span class=\"s5-dot\"><\/span><span>Path 1 of 3<\/span><\/div> <h2 class=\"s5-h2\">Path 1 – OAuth 2.0 Client ID (Multi-Tenant SaaS)<\/h2> <pee class=\"s5-intro\">If you’re building a SaaS product where your customers connect their own Gmail accounts, the OAuth 2.0 authorization code flow is the standard path. This is the 3-legged flow: your app, Google, and the end user. It requires setting up a Google Cloud project and going through the consent screen verification process for sensitive scopes. For a deep dive into the <a href=\"https:\/\/www.unipile.com\/oauth-email-api\/\" style=\"color:#2aaa7e!important;text-decoration:underline!important;\">OAuth flow for email APIs in detail<\/a>, see our dedicated guide.<\/pee> <div class=\"s5-steps\"> <div class=\"s5-step\"> <div class=\"s5-step-num\">01<\/div> <div> <h3>Create OAuth 2.0 credentials in Google Cloud Console<\/h3> <pee>Go to APIs & Services > Credentials > Create Credentials > OAuth client ID. Choose “Web application”. Configure the authorized redirect URIs for your app. This generates your <code>client_id<\/code> and <code>client_secret<\/code>.<\/pee> <\/div> <\/div> <div class=\"s5-step\"> <div class=\"s5-step-num\">02<\/div> <div> <h3>Enable the Gmail API and declare your scopes<\/h3> <pee>Go to APIs & Services > OAuth consent screen. Add the Gmail scopes you need (e.g. <code>gmail.readonly<\/code>, <code>gmail.send<\/code>). Sensitive and restricted scopes require Google verification – a process that takes days to weeks.<\/pee> <\/div> <\/div> <div class=\"s5-step\"> <div class=\"s5-step-num\">03<\/div> <div> <h3>Redirect users to Google’s authorization URL<\/h3> <pee>When a user clicks “Connect Gmail” in your app, redirect them to Google with your <code>client_id<\/code>, scopes, and <code>redirect_uri<\/code>. After they approve, Google sends back an authorization code to your redirect URI.<\/pee> <\/div> <\/div> <div class=\"s5-step\"> <div class=\"s5-step-num\">04<\/div> <div> <h3>Exchange the code for tokens and store the refresh token<\/h3> <pee>POST the authorization code to Google’s token endpoint. You receive an <code>access_token<\/code> (expires ~1h) and a <code>refresh_token<\/code> (long-lived). Store the refresh token securely – it’s how you get new access tokens without re-prompting the user.<\/pee> <\/div> <\/div> <\/div> <div class=\"s5-code-wrap\"> <div class=\"s5-editor-bar\"> <span class=\"s5-dot-r\"><\/span><span class=\"s5-dot-y\"><\/span><span class=\"s5-dot-g\"><\/span> <span class=\"s5-file\">gmail-oauth-flow.js<\/span> <\/div> <div class=\"s5-pre\"><code><span class=\"k\">const<\/span> <span class=\"w\">{ google } <\/span><span class=\"k\">=<\/span> <span class=\"fn\">require<\/span><span class=\"w\">(<\/span><span class=\"s\">'googleapis'<\/span><span class=\"w\">);<\/span><span class=\"k\">const<\/span> <span class=\"w\">oauth2Client <\/span><span class=\"k\">=<\/span> <span class=\"k\">new<\/span> <span class=\"w\">google.auth.<\/span><span class=\"fn\">OAuth2<\/span><span class=\"w\">(<\/span> <span class=\"w\">process.env.GMAIL_CLIENT_ID,<\/span> <span class=\"w\">process.env.GMAIL_CLIENT_SECRET,<\/span> <span class=\"w\">process.env.GMAIL_REDIRECT_URI<\/span><span class=\"w\">);<\/span><span class=\"c\">\/\/ Step 1: Build the authorization URL<\/span><span class=\"k\">const<\/span> <span class=\"w\">authUrl <\/span><span class=\"k\">=<\/span> <span class=\"w\">oauth2Client.<\/span><span class=\"fn\">generateAuthUrl<\/span><span class=\"w\">({<\/span> <span class=\"w\">access_type:<\/span> <span class=\"s\">'offline'<\/span><span class=\"w\">,<\/span> <span class=\"c\">\/\/ get refresh token<\/span> <span class=\"w\">scope: [<\/span> <span class=\"s\">'https:\/\/www.googleapis.com\/auth\/gmail.readonly'<\/span><span class=\"w\">,<\/span> <span class=\"s\">'https:\/\/www.googleapis.com\/auth\/gmail.send'<\/span> <span class=\"w\">]<\/span><span class=\"w\">});<\/span><span class=\"c\">\/\/ Step 2: Exchange code for tokens (in your callback handler)<\/span><span class=\"k\">async function<\/span> <span class=\"fn\">handleCallback<\/span><span class=\"w\">(code) {<\/span> <span class=\"k\">const<\/span> <span class=\"w\">{ tokens } <\/span><span class=\"k\">=<\/span> <span class=\"k\">await<\/span> <span class=\"w\">oauth2Client.<\/span><span class=\"fn\">getToken<\/span><span class=\"w\">(code);<\/span> <span class=\"w\">oauth2Client.<\/span><span class=\"fn\">setCredentials<\/span><span class=\"w\">(tokens);<\/span> <span class=\"c\">\/\/ Store tokens.refresh_token securely in your DB<\/span> <span class=\"k\">return<\/span> <span class=\"w\">tokens;<\/span><span class=\"w\">}<\/span><span class=\"c\">\/\/ Step 3: Use the access token to call Gmail API<\/span><span class=\"k\">async function<\/span> <span class=\"fn\">listMessages<\/span><span class=\"w\">(accessToken) {<\/span> <span class=\"k\">const<\/span> <span class=\"w\">gmail <\/span><span class=\"k\">=<\/span> <span class=\"w\">google.<\/span><span class=\"fn\">gmail<\/span><span class=\"w\">({ version:<\/span> <span class=\"s\">'v1'<\/span><span class=\"w\">, auth: oauth2Client });<\/span> <span class=\"k\">const<\/span> <span class=\"w\">res <\/span><span class=\"k\">=<\/span> <span class=\"k\">await<\/span> <span class=\"w\">gmail.users.messages.<\/span><span class=\"fn\">list<\/span><span class=\"w\">({ userId:<\/span> <span class=\"s\">'me'<\/span> <span class=\"w\">});<\/span> <span class=\"k\">return<\/span> <span class=\"w\">res.data.messages;<\/span><span class=\"w\">}<\/span><\/code><\/div> <\/div> <div class=\"s5-inline-cta\"> <pee><strong>Maintaining refresh tokens at scale is the #1 pain point<\/strong> in self-managed Gmail OAuth. Token rotation, database migrations, silent failures on expired tokens – all of this is handled automatically when you use a <a href=\"https:\/\/www.unipile.com\/email-api-providers\/\" style=\"color:#2aaa7e!important;text-decoration:underline!important;\">unified email API provider<\/a>.<\/pee> <span class=\"s5-inline-cta-btn\" data-upl-link=\"https:\/\/dashboard.unipile.com\/signup\/\" data-upl-target=\"_blank\"><span>Build your Gmail integration<\/span><svg viewBox=\"0 0 24 24\"><line x1=\"5\" y1=\"12\" x2=\"19\" y2=\"12\"\/><polyline points=\"12 5 19 12 12 19\"\/><\/svg><\/span> <\/div> <\/div><\/div><script>(function(){ function init(){ var el = document.getElementById('upl-gako-s5'); if (!el) return; el.addEventListener('click', function(e){ var t = e.target.closest('[data-upl-link]'); if (!t) return; var url = t.getAttribute('data-upl-link'); var target = t.getAttribute('data-upl-target') || '_self'; if (url) window.open(url, target); }); } if (document.readyState === 'loading') { document.addEventListener('DOMContentLoaded', init); } else { init(); }})();<\/script>[\/et_pb_code][\/et_pb_column][\/et_pb_row][\/et_pb_section][et_pb_section fb_built=”1″ _builder_version=”4.27.3″ background_color=”transparent” custom_padding=”0px|0px|0px|0px|false|false” global_colors_info=”{}” theme_builder_area=”post_content” da_is_popup=”off” da_exit_intent=”off” da_has_close=”on” da_alt_close=”off” da_dark_close=”off” da_not_modal=”on” da_is_singular=”off” da_with_loader=”off” da_has_shadow=”on” da_disable_devices=”off|off|off”][et_pb_row _builder_version=”4.27.3″ background_color=”transparent” global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_column type=”4_4″ _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_code _builder_version=”4.27.4″ hover_enabled=”0″ global_colors_info=”{}” theme_builder_area=”post_content” sticky_enabled=”0″]<!DOCTYPE html><html lang=\"en\"><head><meta charset=\"UTF-8\"><meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\"><title>Unipile – Path 2 Service Account<\/title><link href=\"https:\/\/fonts.googleapis.com\/css2?family=Inter:wght@400;500;600;700&family=Poppins:wght@700;800&display=swap\" rel=\"stylesheet\"><style>body { background: #f4f5f7; margin: 0; }#upl-gako-s6,#upl-gako-s6 *,#upl-gako-s6 *::before,#upl-gako-s6 *::after { margin: 0 !important; padding: 0 !important; box-sizing: border-box !important; border: none !important; outline: none !important; font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif !important; line-height: 1.5 !important; letter-spacing: normal !important; text-transform: none !important; text-decoration: none !important; list-style: none !important;}#upl-gako-s6 { background: #f4f5f7 !important; padding: 60px 20px !important; overflow: hidden !important;}#upl-gako-s6 .s6-container { max-width: 1100px !important; width: 100% !important; margin: 0 auto !important;}#upl-gako-s6 .s6-badge { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: rgba(221,223,76,0.18) !important; color: #8a8c2e !important; padding: 6px 14px !important; border-radius: 20px !important; font-size: 12px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.5px !important; margin-bottom: 16px !important; width: fit-content !important;}#upl-gako-s6 .s6-badge .s6-dot { width: 7px !important; height: 7px !important; background: #DDDF4C !important; border-radius: 50% !important; flex-shrink: 0 !important;}#upl-gako-s6 .s6-h2 { font-family: 'Poppins', sans-serif !important; font-size: 35px !important; font-weight: 700 !important; color: #0f2736 !important; line-height: 1.2 !important; margin-bottom: 16px !important;}#upl-gako-s6 .s6-intro { font-size: 17px !important; color: #383838 !important; line-height: 1.75 !important; margin-bottom: 36px !important;}#upl-gako-s6 .s6-layout { display: grid !important; grid-template-columns: 1fr 1fr !important; gap: 28px !important; margin-bottom: 36px !important; align-items: start !important;}\/* Empeche les colonnes Grid de deborder a cause du contenu non-cassable (code en white-space: pre) *\/#upl-gako-s6 .s6-layout > div { min-width: 0 !important;}#upl-gako-s6 .s6-warning-box { background: rgba(234,67,53,0.06) !important; border: 1px solid rgba(234,67,53,0.20) !important; border-radius: 14px !important; padding: 20px 22px !important; margin-bottom: 24px !important;}#upl-gako-s6 .s6-warning-label { display: flex !important; align-items: center !important; gap: 8px !important; font-size: 12px !important; font-weight: 700 !important; color: #ea4335 !important; text-transform: uppercase !important; letter-spacing: 0.8px !important; margin-bottom: 10px !important;}#upl-gako-s6 .s6-warning-label svg { width: 16px !important; height: 16px !important; stroke: #ea4335 !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important; flex-shrink: 0 !important;}#upl-gako-s6 .s6-warning-box p { font-size: 14.5px !important; color: #383838 !important; line-height: 1.65 !important;}#upl-gako-s6 .s6-warning-box p strong { color: #0f2736 !important; font-weight: 700 !important;}#upl-gako-s6 .s6-limit-list { display: flex !important; flex-direction: column !important; gap: 10px !important;}#upl-gako-s6 .s6-limit-item { display: flex !important; align-items: flex-start !important; gap: 10px !important; padding: 12px 16px !important; background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 10px !important;}#upl-gako-s6 .s6-limit-item svg { width: 16px !important; height: 16px !important; stroke: #f59e0b !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important; flex-shrink: 0 !important; margin-top: 2px !important;}#upl-gako-s6 .s6-limit-item p { font-size: 14px !important; color: #383838 !important; line-height: 1.6 !important;}#upl-gako-s6 .s6-limit-item p strong { color: #0f2736 !important; font-weight: 600 !important;}\/* Code block *\/#upl-gako-s6 .s6-code-wrap { border-radius: 14px !important; overflow: hidden !important; background: #0d1117 !important; max-width: 100% !important;}#upl-gako-s6 .s6-editor-bar { background: #161b22 !important; padding: 12px 18px !important; display: flex !important; align-items: center !important; gap: 8px !important; border-bottom: 1px solid rgba(255,255,255,0.06) !important;}#upl-gako-s6 .s6-dot-r { width: 10px !important; height: 10px !important; border-radius: 50% !important; background: #ff5f57 !important; flex-shrink: 0 !important; }#upl-gako-s6 .s6-dot-y { width: 10px !important; height: 10px !important; border-radius: 50% !important; background: #febc2e !important; flex-shrink: 0 !important; }#upl-gako-s6 .s6-dot-g { width: 10px !important; height: 10px !important; border-radius: 50% !important; background: #28c840 !important; flex-shrink: 0 !important; }#upl-gako-s6 .s6-file { color: #8b949e !important; font-size: 12px !important; font-family: 'Courier New', monospace !important; margin-left: 4px !important; }#upl-gako-s6 .s6-pre { padding: 22px 24px !important; font-size: 13px !important; line-height: 1.8 !important; overflow-x: auto !important; -webkit-overflow-scrolling: touch !important; background: #0d1117 !important;}#upl-gako-s6 .s6-pre code { font-family: 'Courier New', monospace !important; white-space: pre !important; display: block !important;}#upl-gako-s6 .c { color: #8b949e !important; }#upl-gako-s6 .k { color: #ff7b72 !important; }#upl-gako-s6 .fn { color: #d2a8ff !important; }#upl-gako-s6 .s { color: #a5d6ff !important; }#upl-gako-s6 .n { color: #79c0ff !important; }#upl-gako-s6 .w { color: #e6edf3 !important; }#upl-gako-s6 .s6-editor-ok { background: rgba(59,185,139,0.10) !important; border-top: 1px solid rgba(59,185,139,0.25) !important; color: #3BB98B !important; padding: 11px 24px !important; font-size: 12.5px !important; font-family: 'Courier New', monospace !important; display: flex !important; align-items: center !important; gap: 8px !important;}#upl-gako-s6 .s6-editor-ok svg { width: 14px !important; height: 14px !important; stroke: #3BB98B !important; fill: none !important; stroke-width: 2.5 !important; stroke-linecap: round !important; stroke-linejoin: round !important; flex-shrink: 0 !important;}@media (max-width: 900px) { #upl-gako-s6 .s6-h2 { font-size: 28px !important; } #upl-gako-s6 .s6-layout { grid-template-columns: 1fr !important; } #upl-gako-s6 { padding: 50px 20px !important; }}@media (max-width: 600px) { #upl-gako-s6 { padding: 50px 16px !important; } #upl-gako-s6 .s6-h2 { font-size: 26px !important; } #upl-gako-s6 .s6-intro { font-size: 15.5px !important; } #upl-gako-s6 .s6-warning-box { padding: 16px 18px !important; } #upl-gako-s6 .s6-warning-box p { font-size: 13.5px !important; } #upl-gako-s6 .s6-limit-item p { font-size: 13.5px !important; } #upl-gako-s6 .s6-pre { padding: 18px 16px !important; font-size: 11.5px !important; line-height: 1.7 !important; } #upl-gako-s6 .s6-editor-ok { font-size: 11px !important; padding: 10px 16px !important; align-items: flex-start !important; } #upl-gako-s6 .s6-editor-ok svg { margin-top: 2px !important; }}@media (max-width: 400px) { #upl-gako-s6 .s6-h2 { font-size: 22px !important; } #upl-gako-s6 .s6-pre { font-size: 10.5px !important; }}<\/style><div id=\"upl-gako-s6\"> <div class=\"s6-container\"> <span id=\"path-service-account\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"s6-badge\"><span class=\"s6-dot\"><\/span><span>Path 2 of 3<\/span><\/div> <h2 class=\"s6-h2\">Path 2 – Service Account + Domain-Wide Delegation (Workspace Internal)<\/h2> <pee class=\"s6-intro\">If your use case is internal to a Google Workspace organization – think internal tooling, HR automation, or a company-wide email analytics dashboard – service accounts with Domain-Wide Delegation (DWD) let you access mailboxes without per-user consent flows. A Workspace admin grants the delegation once. The critical caveat: this path does not work for personal Gmail addresses.<\/pee> <div class=\"s6-layout\"> <div> <div class=\"s6-warning-box\"> <div class=\"s6-warning-label\"><svg viewBox=\"0 0 24 24\"><path d=\"M10.29 3.86L1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z\"\/><line x1=\"12\" y1=\"9\" x2=\"12\" y2=\"13\"\/><line x1=\"12\" y1=\"17\" x2=\"12.01\" y2=\"17\"\/><\/svg><span>Hard limit – read before starting<\/span><\/div> <pee><strong>Service accounts cannot access personal Gmail accounts (@gmail.com).<\/strong> DWD only works within a Google Workspace domain. If your users sign up with personal Gmail addresses, you must use Path 1 (OAuth Client ID) or Path 3 (Unified API). Attempting DWD on a personal account returns a 403 error.<\/pee> <\/div> <div class=\"s6-limit-list\"> <div class=\"s6-limit-item\"><svg viewBox=\"0 0 24 24\"><circle cx=\"12\" cy=\"12\" r=\"10\"\/><line x1=\"12\" y1=\"8\" x2=\"12\" y2=\"12\"\/><line x1=\"12\" y1=\"16\" x2=\"12.01\" y2=\"16\"\/><\/svg><pee><strong>Workspace admin required:<\/strong> DWD must be configured by a Google Workspace admin at admin.google.com. You cannot do this as a developer without admin access.<\/pee><\/div> <div class=\"s6-limit-item\"><svg viewBox=\"0 0 24 24\"><circle cx=\"12\" cy=\"12\" r=\"10\"\/><line x1=\"12\" y1=\"8\" x2=\"12\" y2=\"12\"\/><line x1=\"12\" y1=\"16\" x2=\"12.01\" y2=\"16\"\/><\/svg><pee><strong>JSON key security:<\/strong> The service account JSON key is a long-lived credential. Treat it like a private key – rotate it regularly and never commit it to source control.<\/pee><\/div> <div class=\"s6-limit-item\"><svg viewBox=\"0 0 24 24\"><circle cx=\"12\" cy=\"12\" r=\"10\"\/><line x1=\"12\" y1=\"8\" x2=\"12\" y2=\"12\"\/><line x1=\"12\" y1=\"16\" x2=\"12.01\" y2=\"16\"\/><\/svg><pee><strong>Scope declaration required:<\/strong> The admin must explicitly approve each Gmail scope during DWD setup. You cannot request scopes at runtime. See <a href=\"https:\/\/support.google.com\/a\/answer\/162106\" target=\"_blank\" rel=\"noopener\" style=\"color:#2aaa7e!important;text-decoration:underline!important;\">Google’s DWD guide<\/a>.<\/pee><\/div> <\/div> <\/div> <div> <div class=\"s6-code-wrap\"> <div class=\"s6-editor-bar\"> <span class=\"s6-dot-r\"><\/span><span class=\"s6-dot-y\"><\/span><span class=\"s6-dot-g\"><\/span> <span class=\"s6-file\">gmail-service-account.py<\/span> <\/div> <div class=\"s6-pre\"><code><span class=\"k\">from<\/span> <span class=\"w\">google.oauth2 <\/span><span class=\"k\">import<\/span> <span class=\"w\">service_account<\/span><span class=\"k\">from<\/span> <span class=\"w\">googleapiclient.discovery <\/span><span class=\"k\">import<\/span> <span class=\"fn\">build<\/span><span class=\"c\"># Path to your service account JSON key<\/span><span class=\"w\">SERVICE_ACCOUNT_FILE <\/span><span class=\"k\">=<\/span> <span class=\"s\">'service-account.json'<\/span><span class=\"w\">SCOPES <\/span><span class=\"k\">=<\/span> <span class=\"w\">[<\/span> <span class=\"s\">'https:\/\/www.googleapis.com\/auth\/gmail.readonly'<\/span><span class=\"w\">]<\/span><span class=\"c\"># Impersonate a user in your Workspace domain<\/span><span class=\"c\"># (Domain-Wide Delegation must be enabled by admin)<\/span><span class=\"k\">def<\/span> <span class=\"fn\">get_gmail_service<\/span><span class=\"w\">(user_email):<\/span> <span class=\"w\">creds <\/span><span class=\"k\">=<\/span> <span class=\"w\">service_account.Credentials.<\/span><span class=\"fn\">from_service_account_file<\/span><span class=\"w\">(<\/span> <span class=\"w\">SERVICE_ACCOUNT_FILE,<\/span> <span class=\"w\">scopes<\/span><span class=\"k\">=<\/span><span class=\"w\">SCOPES<\/span> <span class=\"w\">)<\/span> <span class=\"c\"># This is Domain-Wide Delegation: impersonate user<\/span> <span class=\"w\">delegated_creds <\/span><span class=\"k\">=<\/span> <span class=\"w\">creds.<\/span><span class=\"fn\">with_subject<\/span><span class=\"w\">(user_email)<\/span> <span class=\"k\">return<\/span> <span class=\"fn\">build<\/span><span class=\"w\">(<\/span><span class=\"s\">'gmail'<\/span><span class=\"w\">,<\/span> <span class=\"s\">'v1'<\/span><span class=\"w\">, credentials<\/span><span class=\"k\">=<\/span><span class=\"w\">delegated_creds)<\/span><span class=\"c\"># List messages for a Workspace user<\/span><span class=\"w\">service <\/span><span class=\"k\">=<\/span> <span class=\"fn\">get_gmail_service<\/span><span class=\"w\">(<\/span><span class=\"s\">'alice@yourcompany.com'<\/span><span class=\"w\">)<\/span><span class=\"w\">results <\/span><span class=\"k\">=<\/span> <span class=\"w\">service.users().messages().<\/span><span class=\"fn\">list<\/span><span class=\"w\">(<\/span> <span class=\"w\">userId<\/span><span class=\"k\">=<\/span><span class=\"s\">'me'<\/span><span class=\"w\">).<\/span><span class=\"fn\">execute<\/span><span class=\"w\">()<\/span><\/code><\/div> <div class=\"s6-editor-ok\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Works only for Workspace users – never personal @gmail.com<\/span><\/div> <\/div> <\/div> <\/div> <\/div><\/div><\/body><\/html>[\/et_pb_code][\/et_pb_column][\/et_pb_row][\/et_pb_section][et_pb_section fb_built=”1″ _builder_version=”4.27.3″ background_color=”transparent” custom_padding=”0px|0px|0px|0px|false|false” global_colors_info=”{}” theme_builder_area=”post_content” da_is_popup=”off” da_exit_intent=”off” da_has_close=”on” da_alt_close=”off” da_dark_close=”off” da_not_modal=”on” da_is_singular=”off” da_with_loader=”off” da_has_shadow=”on” da_disable_devices=”off|off|off”][et_pb_row _builder_version=”4.27.3″ background_color=”transparent” global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_column type=”4_4″ _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_code _builder_version=”4.27.4″ hover_enabled=”0″ global_colors_info=”{}” theme_builder_area=”post_content” sticky_enabled=”0″]<!DOCTYPE html><html lang=\"en\"><head><meta charset=\"UTF-8\"><meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\"><title>Unipile – Path 3 Unified API<\/title><link href=\"https:\/\/fonts.googleapis.com\/css2?family=Inter:wght@400;500;600;700&family=Poppins:wght@700;800&display=swap\" rel=\"stylesheet\"><style>body { background: #f4f5f7; margin: 0; }#upl-gako-s7,#upl-gako-s7 *,#upl-gako-s7 *::before,#upl-gako-s7 *::after { margin: 0 !important; padding: 0 !important; box-sizing: border-box !important; border: none !important; outline: none !important; font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif !important; line-height: 1.5 !important; letter-spacing: normal !important; text-transform: none !important; text-decoration: none !important; list-style: none !important;}#upl-gako-s7 { background: transparent !important; padding: 60px 20px !important; overflow: hidden !important;}#upl-gako-s7 .s7-container { max-width: 1100px !important; width: 100% !important; margin: 0 auto !important;}#upl-gako-s7 .s7-badge { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: rgba(59,185,139,0.12) !important; color: #2aaa7e !important; padding: 6px 14px !important; border-radius: 20px !important; font-size: 12px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.5px !important; margin-bottom: 16px !important; width: fit-content !important;}#upl-gako-s7 .s7-badge .s7-dot { width: 7px !important; height: 7px !important; background: #3BB98B !important; border-radius: 50% !important; flex-shrink: 0 !important;}#upl-gako-s7 .s7-h2 { font-family: 'Poppins', sans-serif !important; font-size: 35px !important; font-weight: 700 !important; color: #0f2736 !important; line-height: 1.2 !important; margin-bottom: 16px !important;}#upl-gako-s7 .s7-intro { font-size: 17px !important; color: #383838 !important; line-height: 1.75 !important; margin-bottom: 36px !important;}#upl-gako-s7 .s7-layout { display: grid !important; grid-template-columns: 1fr 1fr !important; gap: 40px !important; align-items: start !important; margin-bottom: 36px !important;}\/* Empeche les colonnes Grid de deborder a cause du contenu non-cassable (code en white-space: pre) *\/#upl-gako-s7 .s7-layout > div { min-width: 0 !important;}#upl-gako-s7 .s7-benefits { display: flex !important; flex-direction: column !important; gap: 14px !important; margin-bottom: 28px !important;}#upl-gako-s7 .s7-benefit { display: flex !important; align-items: flex-start !important; gap: 12px !important;}#upl-gako-s7 .s7-benefit-icon { width: 34px !important; height: 34px !important; min-width: 34px !important; background: rgba(59,185,139,0.12) !important; border-radius: 8px !important; display: flex !important; align-items: center !important; justify-content: center !important;}#upl-gako-s7 .s7-benefit-icon svg { width: 16px !important; height: 16px !important; stroke: #3BB98B !important; fill: none !important; stroke-width: 2.2 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}#upl-gako-s7 .s7-benefit > div { min-width: 0 !important;}#upl-gako-s7 .s7-benefit h3 { font-size: 15px !important; font-weight: 700 !important; color: #0f2736 !important; margin-bottom: 4px !important; line-height: 1.35 !important;}#upl-gako-s7 .s7-benefit p { font-size: 14px !important; color: #4a5568 !important; line-height: 1.65 !important; overflow-wrap: break-word !important; word-wrap: break-word !important;}#upl-gako-s7 .s7-providers-row { display: flex !important; align-items: center !important; gap: 12px !important; padding: 16px 20px !important; background: #f8fafc !important; border: 1px solid #e5e7eb !important; border-radius: 12px !important; flex-wrap: wrap !important;}#upl-gako-s7 .s7-providers-row img { width: 28px !important; height: 28px !important;}#upl-gako-s7 .s7-providers-label { font-size: 13px !important; color: #64748b !important; font-weight: 600 !important;}\/* Code block *\/#upl-gako-s7 .s7-code-wrap { border-radius: 14px !important; overflow: hidden !important; background: #0d1117 !important; max-width: 100% !important;}#upl-gako-s7 .s7-editor-bar { background: #161b22 !important; padding: 12px 18px !important; display: flex !important; align-items: center !important; gap: 8px !important; border-bottom: 1px solid rgba(255,255,255,0.06) !important;}#upl-gako-s7 .s7-dot-r { width: 10px !important; height: 10px !important; border-radius: 50% !important; background: #ff5f57 !important; flex-shrink: 0 !important; }#upl-gako-s7 .s7-dot-y { width: 10px !important; height: 10px !important; border-radius: 50% !important; background: #febc2e !important; flex-shrink: 0 !important; }#upl-gako-s7 .s7-dot-g { width: 10px !important; height: 10px !important; border-radius: 50% !important; background: #28c840 !important; flex-shrink: 0 !important; }#upl-gako-s7 .s7-file { color: #8b949e !important; font-size: 12px !important; font-family: 'Courier New', monospace !important; margin-left: 4px !important; }#upl-gako-s7 .s7-pre { padding: 22px 24px !important; font-size: 13px !important; line-height: 1.8 !important; overflow-x: auto !important; -webkit-overflow-scrolling: touch !important; background: #0d1117 !important;}#upl-gako-s7 .s7-pre code { font-family: 'Courier New', monospace !important; white-space: pre !important; display: block !important;}#upl-gako-s7 .c { color: #8b949e !important; }#upl-gako-s7 .k { color: #ff7b72 !important; }#upl-gako-s7 .fn { color: #d2a8ff !important; }#upl-gako-s7 .s { color: #a5d6ff !important; }#upl-gako-s7 .n { color: #79c0ff !important; }#upl-gako-s7 .w { color: #e6edf3 !important; }#upl-gako-s7 .s7-editor-ok { background: rgba(59,185,139,0.10) !important; border-top: 1px solid rgba(59,185,139,0.25) !important; color: #3BB98B !important; padding: 11px 24px !important; font-size: 12.5px !important; font-family: 'Courier New', monospace !important; display: flex !important; align-items: center !important; gap: 8px !important;}#upl-gako-s7 .s7-editor-ok svg { width: 14px !important; height: 14px !important; stroke: #3BB98B !important; fill: none !important; stroke-width: 2.5 !important; stroke-linecap: round !important; stroke-linejoin: round !important; flex-shrink: 0 !important;}\/* CTA strip *\/#upl-gako-s7 .s7-cta-strip { background: #0f2736 !important; border-radius: 14px !important; padding: 28px 32px !important; display: flex !important; align-items: center !important; justify-content: space-between !important; gap: 24px !important; flex-wrap: wrap !important;}#upl-gako-s7 .s7-cta-text { min-width: 0 !important;}#upl-gako-s7 .s7-cta-text h3 { font-family: 'Poppins', sans-serif !important; font-size: 20px !important; font-weight: 700 !important; color: #ffffff !important; margin-bottom: 8px !important; line-height: 1.3 !important;}#upl-gako-s7 .s7-cta-text p { font-size: 15px !important; color: rgba(255,255,255,0.75) !important; line-height: 1.6 !important;}#upl-gako-s7 .s7-cta-actions { display: flex !important; gap: 12px !important; flex-wrap: wrap !important; flex-shrink: 0 !important;}#upl-gako-s7 .s7-btn-primary { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: #DDDF4C !important; color: #0f2736 !important; padding: 12px 22px !important; border-radius: 8px !important; font-size: 0.9rem !important; font-weight: 600 !important; border: 2px solid #DDDF4C !important; transition: transform 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important;}#upl-gako-s7 .s7-btn-primary:hover { transform: translateY(-5px) !important;}#upl-gako-s7 .s7-btn-primary svg { width: 14px !important; height: 14px !important; stroke: currentColor !important; fill: none !important; stroke-width: 2.5 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}#upl-gako-s7 .s7-btn-secondary { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: transparent !important; color: #ffffff !important; padding: 12px 22px !important; border-radius: 8px !important; font-size: 0.9rem !important; font-weight: 600 !important; border: 2px solid rgba(255,255,255,0.30) !important; transition: all 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important;}#upl-gako-s7 .s7-btn-secondary:hover { border-color: rgba(255,255,255,0.70) !important;}#upl-gako-s7 .s7-btn-secondary svg { width: 14px !important; height: 14px !important; stroke: currentColor !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}@media (max-width: 900px) { #upl-gako-s7 .s7-h2 { font-size: 28px !important; } #upl-gako-s7 .s7-layout { grid-template-columns: 1fr !important; } #upl-gako-s7 { padding: 50px 20px !important; } #upl-gako-s7 .s7-cta-strip { flex-direction: column !important; align-items: flex-start !important; }}@media (max-width: 600px) { #upl-gako-s7 { padding: 50px 16px !important; } #upl-gako-s7 .s7-h2 { font-size: 26px !important; } #upl-gako-s7 .s7-intro { font-size: 15.5px !important; } #upl-gako-s7 .s7-cta-strip { padding: 22px 20px !important; } #upl-gako-s7 .s7-cta-text h3 { font-size: 18px !important; } #upl-gako-s7 .s7-btn-primary, #upl-gako-s7 .s7-btn-secondary { width: 100% !important; justify-content: center !important; } #upl-gako-s7 .s7-cta-actions { width: 100% !important; } #upl-gako-s7 .s7-pre { padding: 18px 16px !important; font-size: 11.5px !important; line-height: 1.7 !important; } #upl-gako-s7 .s7-editor-ok { font-size: 11px !important; padding: 10px 16px !important; align-items: flex-start !important; } #upl-gako-s7 .s7-editor-ok svg { margin-top: 2px !important; }}@media (max-width: 400px) { #upl-gako-s7 .s7-h2 { font-size: 22px !important; } #upl-gako-s7 .s7-pre { font-size: 10.5px !important; }}<\/style><div id=\"upl-gako-s7\"> <div class=\"s7-container\"> <span id=\"path-unified-api\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"s7-badge\"><span class=\"s7-dot\"><\/span><span>Path 3 of 3 – Recommended<\/span><\/div> <h2 class=\"s7-h2\">Path 3 – Unified Email API (Skip the OAuth Boilerplate)<\/h2> <pee class=\"s7-intro\">If your goal is to read, send, or sync email in a production SaaS application – and you’d rather not spend engineering cycles managing OAuth infrastructure – a unified email API like Unipile abstracts the entire authentication layer. Understand <a href=\"https:\/\/www.unipile.com\/email-sync-api\/\" style=\"color:#2aaa7e!important;text-decoration:underline!important;\">how email sync works under the hood<\/a>, or go straight to the code. This approach also gives you Gmail, Outlook, and IMAP under one API – no separate integration for each provider.<\/pee> <div class=\"s7-layout\"> <div> <div class=\"s7-benefits\"> <div class=\"s7-benefit\"> <div class=\"s7-benefit-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><\/div> <div> <h3>No Google Cloud setup required<\/h3> <pee>No OAuth client ID, no consent screen, no scope review with Google. Unipile’s own verified OAuth app handles user authorization.<\/pee> <\/div> <\/div> <div class=\"s7-benefit\"> <div class=\"s7-benefit-icon\"><svg viewBox=\"0 0 24 24\"><path d=\"M21 16V8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16z\"\/><\/svg><\/div> <div> <h3>Automatic token rotation<\/h3> <pee>Access tokens and refresh tokens are managed entirely by Unipile. Your database never stores a Google OAuth token.<\/pee> <\/div> <\/div> <div class=\"s7-benefit\"> <div class=\"s7-benefit-icon\"><svg viewBox=\"0 0 24 24\"><rect x=\"2\" y=\"3\" width=\"20\" height=\"14\" rx=\"2\" ry=\"2\"\/><line x1=\"8\" y1=\"21\" x2=\"16\" y2=\"21\"\/><line x1=\"12\" y1=\"17\" x2=\"12\" y2=\"21\"\/><\/svg><\/div> <div> <h3>Works for personal Gmail + Outlook + IMAP<\/h3> <pee>One API, three provider universes. When you <a href=\"https:\/\/www.unipile.com\/email-api-providers\/\" style=\"color:#2aaa7e!important;text-decoration:underline!important;\">compare email sync API providers<\/a>, cross-provider support is a major differentiator.<\/pee> <\/div> <\/div> <div class=\"s7-benefit\"> <div class=\"s7-benefit-icon\"><svg viewBox=\"0 0 24 24\"><circle cx=\"12\" cy=\"12\" r=\"10\"\/><line x1=\"12\" y1=\"8\" x2=\"12\" y2=\"12\"\/><line x1=\"12\" y1=\"16\" x2=\"12.01\" y2=\"16\"\/><\/svg><\/div> <div> <h3>Webhook delivery on new messages<\/h3> <pee>Instead of polling Gmail’s API, Unipile pushes new email events to your webhook endpoint in real-time, per linked account.<\/pee> <\/div> <\/div> <\/div> <div class=\"s7-providers-row\"> <span class=\"s7-providers-label\">Supported providers:<\/span> <img decoding=\"async\" src=\"https:\/\/www.unipile.com\/wp-content\/uploads\/2024\/02\/gmail-3.svg\" alt=\"Gmail\" width=\"28\" height=\"28\"> <img decoding=\"async\" src=\"https:\/\/www.unipile.com\/wp-content\/uploads\/2024\/02\/outlook-2.svg\" alt=\"Outlook\" width=\"28\" height=\"28\"> <img decoding=\"async\" src=\"https:\/\/www.unipile.com\/wp-content\/uploads\/2024\/02\/imap-1.svg\" alt=\"IMAP\" width=\"28\" height=\"28\"> <\/div> <\/div> <div> <div class=\"s7-code-wrap\"> <div class=\"s7-editor-bar\"> <span class=\"s7-dot-r\"><\/span><span class=\"s7-dot-y\"><\/span><span class=\"s7-dot-g\"><\/span> <span class=\"s7-file\">unipile-gmail.js<\/span> <\/div> <div class=\"s7-pre\"><code><span class=\"c\">\/\/ 3 lines to read a Gmail mailbox via Unipile<\/span><span class=\"c\">\/\/ No OAuth setup, no token management<\/span><span class=\"k\">const<\/span> <span class=\"w\">{ UnipileClient } <\/span><span class=\"k\">=<\/span> <span class=\"fn\">require<\/span><span class=\"w\">(<\/span><span class=\"s\">'unipile-node-sdk'<\/span><span class=\"w\">);<\/span><span class=\"k\">const<\/span> <span class=\"w\">client <\/span><span class=\"k\">=<\/span> <span class=\"k\">new<\/span> <span class=\"fn\">UnipileClient<\/span><span class=\"w\">({<\/span> <span class=\"w\">token: process.env.UNIPILE_API_KEY<\/span><span class=\"w\">});<\/span><span class=\"c\">\/\/ List emails from a linked Gmail account<\/span><span class=\"c\">\/\/ accountId = the Unipile linked account ID<\/span><span class=\"k\">const<\/span> <span class=\"w\">emails <\/span><span class=\"k\">=<\/span> <span class=\"k\">await<\/span> <span class=\"w\">client.email.<\/span><span class=\"fn\">listMessages<\/span><span class=\"w\">({<\/span> <span class=\"w\">account_id:<\/span> <span class=\"s\">'linked-account-id'<\/span><span class=\"w\">,<\/span> <span class=\"w\">limit:<\/span> <span class=\"n\">20<\/span><span class=\"w\">});<\/span><span class=\"c\">\/\/ Send an email on behalf of the linked account<\/span><span class=\"k\">await<\/span> <span class=\"w\">client.email.<\/span><span class=\"fn\">send<\/span><span class=\"w\">({<\/span> <span class=\"w\">account_id:<\/span> <span class=\"s\">'linked-account-id'<\/span><span class=\"w\">,<\/span> <span class=\"w\">to:<\/span> <span class=\"s\">'recipient@example.com'<\/span><span class=\"w\">,<\/span> <span class=\"w\">subject:<\/span> <span class=\"s\">'Hello from Unipile'<\/span><span class=\"w\">,<\/span> <span class=\"w\">body:<\/span> <span class=\"s\">'No OAuth token in sight.'<\/span><span class=\"w\">});<\/span><span class=\"c\">\/\/ Works identically for Outlook and IMAP<\/span><span class=\"c\">\/\/ Just swap the account_id<\/span><\/code><\/div> <div class=\"s7-editor-ok\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Same code for Gmail, Outlook, and IMAP linked accounts<\/span><\/div> <\/div> <\/div> <\/div> <div class=\"s7-cta-strip\"> <div class=\"s7-cta-text\"> <h3>Build your Gmail integration without OAuth ops<\/h3> <pee>Start with the <a href=\"https:\/\/www.unipile.com\/communication-api\/email-api\/duplicate-enhance-your-email-software-with-gmail-api-integration\/\" style=\"color:#DDDF4C!important;text-decoration:underline!important;\">complete Gmail API integration guide<\/a>, then deploy with Unipile as your auth and sync layer.<\/pee> <\/div> <div class=\"s7-cta-actions\"> <span class=\"s7-btn-primary\" data-upl-link=\"https:\/\/dashboard.unipile.com\/signup\/\" data-upl-target=\"_blank\"><span>Start building<\/span><svg viewBox=\"0 0 24 24\"><line x1=\"5\" y1=\"12\" x2=\"19\" y2=\"12\"\/><polyline points=\"12 5 19 12 12 19\"\/><\/svg><\/span> <span class=\"s7-btn-secondary\" data-upl-link=\"https:\/\/developer.unipile.com\/docs\/getting-started\" data-upl-target=\"_blank\"><span>View docs<\/span><svg viewBox=\"0 0 24 24\"><polyline points=\"9 18 15 12 9 6\"\/><\/svg><\/span> <\/div> <\/div> <\/div><\/div><script>(function(){ function init(){ var el = document.getElementById('upl-gako-s7'); if (!el) return; el.addEventListener('click', function(e){ var t = e.target.closest('[data-upl-link]'); if (!t) return; var url = t.getAttribute('data-upl-link'); var target = t.getAttribute('data-upl-target') || '_self'; if (url) window.open(url, target); }); } if (document.readyState === 'loading') { document.addEventListener('DOMContentLoaded', init); } else { init(); }})();<\/script><\/body><\/html>[\/et_pb_code][\/et_pb_column][\/et_pb_row][\/et_pb_section][et_pb_section fb_built=”1″ _builder_version=”4.27.3″ background_color=”transparent” custom_padding=”0px|0px|0px|0px|false|false” global_colors_info=”{}” theme_builder_area=”post_content” da_is_popup=”off” da_exit_intent=”off” da_has_close=”on” da_alt_close=”off” da_dark_close=”off” da_not_modal=”on” da_is_singular=”off” da_with_loader=”off” da_has_shadow=”on” da_disable_devices=”off|off|off”][et_pb_row _builder_version=”4.27.3″ background_color=”transparent” global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_column type=”4_4″ _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_code _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”]<link href=\"https:\/\/fonts.googleapis.com\/css2?family=Inter:wght@400;500;600;700&family=Poppins:wght@700;800&display=swap\" rel=\"stylesheet\"><style>#upl-gako-s8,#upl-gako-s8 *,#upl-gako-s8 *::before,#upl-gako-s8 *::after { margin: 0 !important; padding: 0 !important; box-sizing: border-box !important; border: none !important; outline: none !important; font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif !important; line-height: 1.5 !important; letter-spacing: normal !important; text-transform: none !important; text-decoration: none !important; list-style: none !important;}#upl-gako-s8 { background: #f4f5f7 !important; padding: 60px 20px !important;}#upl-gako-s8 .s8-container { max-width: 1100px !important; margin: 0 auto !important;}#upl-gako-s8 .s8-badge { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: rgba(239,68,68,0.10) !important; color: #dc2626 !important; padding: 6px 14px !important; border-radius: 20px !important; font-size: 12px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.5px !important; margin-bottom: 16px !important; width: fit-content !important;}#upl-gako-s8 .s8-badge .s8-dot { width: 7px !important; height: 7px !important; background: #ef4444 !important; border-radius: 50% !important; flex-shrink: 0 !important;}#upl-gako-s8 .s8-h2 { font-family: 'Poppins', sans-serif !important; font-size: 35px !important; font-weight: 700 !important; color: #0f2736 !important; line-height: 1.2 !important; margin-bottom: 16px !important;}#upl-gako-s8 .s8-intro { font-size: 17px !important; color: #383838 !important; line-height: 1.75 !important; margin-bottom: 40px !important;}#upl-gako-s8 .s8-error-list { display: flex !important; flex-direction: column !important; gap: 28px !important;}#upl-gako-s8 .s8-error-item { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; overflow: hidden !important;}#upl-gako-s8 .s8-error-item-header { padding: 18px 24px !important; display: flex !important; align-items: center !important; gap: 14px !important; border-bottom: 1px solid #f0f1f3 !important;}#upl-gako-s8 .s8-error-code { display: inline-flex !important; align-items: center !important; gap: 6px !important; background: rgba(239,68,68,0.10) !important; color: #dc2626 !important; padding: 4px 10px !important; border-radius: 6px !important; font-size: 12px !important; font-weight: 700 !important; font-family: 'Courier New', monospace !important; white-space: nowrap !important;}#upl-gako-s8 .s8-error-title { font-family: 'Poppins', sans-serif !important; font-size: 16px !important; font-weight: 700 !important; color: #0f2736 !important;}#upl-gako-s8 .s8-error-body { padding: 20px 24px !important; display: grid !important; grid-template-columns: 1fr 1fr !important; gap: 20px !important;}#upl-gako-s8 .s8-cause-label { font-size: 11px !important; font-weight: 700 !important; color: #94a3b8 !important; text-transform: uppercase !important; letter-spacing: 0.8px !important; margin-bottom: 8px !important; display: block !important;}#upl-gako-s8 .s8-cause-text { font-size: 14.5px !important; color: #383838 !important; line-height: 1.65 !important;}#upl-gako-s8 .s8-cause-text strong { color: #0f2736 !important; font-weight: 700 !important;}\/* Code block inline *\/#upl-gako-s8 .s8-code-wrap { border-radius: 10px !important; overflow: hidden !important; background: #0d1117 !important; margin-top: 12px !important;}#upl-gako-s8 .s8-code-bar { background: #161b22 !important; padding: 8px 14px !important; display: flex !important; align-items: center !important; gap: 6px !important; border-bottom: 1px solid rgba(255,255,255,0.06) !important;}#upl-gako-s8 .sd-r { width: 8px !important; height: 8px !important; border-radius: 50% !important; background: #ff5f57 !important; flex-shrink: 0 !important; }#upl-gako-s8 .sd-y { width: 8px !important; height: 8px !important; border-radius: 50% !important; background: #febc2e !important; flex-shrink: 0 !important; }#upl-gako-s8 .sd-g { width: 8px !important; height: 8px !important; border-radius: 50% !important; background: #28c840 !important; flex-shrink: 0 !important; }#upl-gako-s8 .s8-code-pre { padding: 14px 16px !important; font-family: 'Courier New', monospace !important; font-size: 12px !important; line-height: 1.7 !important; overflow-x: auto !important; background: #0d1117 !important;}#upl-gako-s8 .s8-code-pre code { white-space: pre !important; display: block !important;}#upl-gako-s8 .er { color: #ff7b72 !important; }#upl-gako-s8 .em { color: #e6edf3 !important; }#upl-gako-s8 .ec { color: #8b949e !important; }#upl-gako-s8 .ev { color: #a5d6ff !important; }#upl-gako-s8 .en { color: #79c0ff !important; }@media (max-width: 900px) { #upl-gako-s8 .s8-h2 { font-size: 28px !important; } #upl-gako-s8 .s8-error-body { grid-template-columns: 1fr !important; } #upl-gako-s8 { padding: 50px 20px !important; }}@media (max-width: 600px) { #upl-gako-s8 .s8-h2 { font-size: 26px !important; } #upl-gako-s8 .s8-error-item-header { flex-wrap: wrap !important; }}<\/style><div id=\"upl-gako-s8\"> <div class=\"s8-container\"> <span id=\"common-errors\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"s8-badge\"><span class=\"s8-dot\"><\/span><span>Troubleshooting<\/span><\/div> <h2 class=\"s8-h2\">Common Errors When You Try to Use an API Key with Gmail<\/h2> <pee class=\"s8-intro\">If you’ve landed on this article because your Gmail API call is failing, here are the two errors you’ll encounter and exactly what each one means – with the raw response body so you can recognize them instantly.<\/pee> <div class=\"s8-error-list\">  <div class=\"s8-error-item\"> <div class=\"s8-error-item-header\"> <span class=\"s8-error-code\">HTTP 401<\/span> <span class=\"s8-error-title\">Login Required \/ UNAUTHENTICATED<\/span> <\/div> <div class=\"s8-error-body\"> <div> <span class=\"s8-cause-label\">What causes it<\/span> <pee class=\"s8-cause-text\">You sent a request to the Gmail API with either an API key (<code>?key=AIza...<\/code>) or with no authorization at all. Gmail API requires a valid OAuth 2.0 access token in the <code>Authorization: Bearer<\/code> header. <strong>This is the first error you’ll see<\/strong> when experimenting with an API key for the first time.<\/pee> <pee class=\"s8-cause-text\" style=\"margin-top:10px!important;\"><strong>Fix:<\/strong> Implement one of the 3 auth paths above. The API key is not the solution – you need an OAuth access token.<\/pee> <\/div> <div> <div class=\"s8-code-wrap\"> <div class=\"s8-code-bar\"><span class=\"sd-r\"><\/span><span class=\"sd-y\"><\/span><span class=\"sd-g\"><\/span><\/div> <div class=\"s8-code-pre\"><code><span class=\"er\">HTTP\/1.1 401 Unauthorized<\/span><span class=\"em\">Content-Type: application\/json<\/span><span class=\"ev\">{ \"error\": { \"code\": <\/span><span class=\"en\">401<\/span><span class=\"ev\">, \"message\": \"Request is missing required authentication credential. Expected OAuth 2 access token, login cookie or other valid authentication credential. See https:\/\/ developers.google.com\/ identity\/sign-in\/web\/...\", \"status\": \"UNAUTHENTICATED\", \"errors\": [{ \"message\": \"Login Required\", \"domain\": \"googleapis.com\", \"reason\": \"required\", \"location\": \"Authorization\", \"locationType\": \"header\" }] }}<\/span><\/code><\/div> <\/div> <\/div> <\/div> <\/div>  <div class=\"s8-error-item\"> <div class=\"s8-error-item-header\"> <span class=\"s8-error-code\">HTTP 403<\/span> <span class=\"s8-error-title\">Daily Limit for Unauthenticated Use Exceeded<\/span> <\/div> <div class=\"s8-error-body\"> <div> <span class=\"s8-cause-label\">What causes it<\/span> <pee class=\"s8-cause-text\">After repeated unauthenticated requests (even with an API key), Google’s quota system blocks further unauthenticated calls from your IP or project. This is not a rate limit for authenticated users – it specifically means <strong>your requests were never authenticated<\/strong> and you’ve exhausted the tiny free quota for anonymous calls.<\/pee> <pee class=\"s8-cause-text\" style=\"margin-top:10px!important;\"><strong>Fix:<\/strong> Same as above – your API key approach will never work. Use OAuth 2.0 access tokens. This error will disappear once your requests carry a valid Bearer token.<\/pee> <\/div> <div> <div class=\"s8-code-wrap\"> <div class=\"s8-code-bar\"><span class=\"sd-r\"><\/span><span class=\"sd-y\"><\/span><span class=\"sd-g\"><\/span><\/div> <div class=\"s8-code-pre\"><code><span class=\"er\">HTTP\/1.1 403 Forbidden<\/span><span class=\"em\">Content-Type: application\/json<\/span><span class=\"ev\">{ \"error\": { \"code\": <\/span><span class=\"en\">403<\/span><span class=\"ev\">, \"message\": \"Daily Limit for Unauthenticated Use Exceeded. Continued use requires signup.\", \"status\": \"RESOURCE_EXHAUSTED\", \"errors\": [{ \"message\": \"Daily Limit for Unauthenticated Use Exceeded.\", \"domain\": \"usageLimits\", \"reason\": \"dailyLimitExceededUnreg\" }] }}<\/span><\/code><\/div> <\/div> <\/div> <\/div> <\/div> <\/div> <\/div><\/div>[\/et_pb_code][\/et_pb_column][\/et_pb_row][\/et_pb_section][et_pb_section fb_built=”1″ _builder_version=”4.27.3″ background_color=”transparent” custom_padding=”0px|0px|0px|0px|false|false” global_colors_info=”{}” theme_builder_area=”post_content” da_is_popup=”off” da_exit_intent=”off” da_has_close=”on” da_alt_close=”off” da_dark_close=”off” da_not_modal=”on” da_is_singular=”off” da_with_loader=”off” da_has_shadow=”on” da_disable_devices=”off|off|off”][et_pb_row _builder_version=”4.27.3″ background_color=”transparent” global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_column type=”4_4″ _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_code _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”]<link href=\"https:\/\/fonts.googleapis.com\/css2?family=Inter:wght@400;500;600;700&family=Poppins:wght@700;800&display=swap\" rel=\"stylesheet\"><style>#upl-gako-s9,#upl-gako-s9 *,#upl-gako-s9 *::before,#upl-gako-s9 *::after { margin: 0 !important; padding: 0 !important; box-sizing: border-box !important; border: none !important; outline: none !important; font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif !important; line-height: 1.5 !important; letter-spacing: normal !important; text-transform: none !important; text-decoration: none !important; list-style: none !important;}#upl-gako-s9 { background: transparent !important; padding: 60px 20px !important;}#upl-gako-s9 .s9-container { max-width: 1100px !important; margin: 0 auto !important;}#upl-gako-s9 .s9-badge { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: rgba(221,223,76,0.18) !important; color: #8a8c2e !important; padding: 6px 14px !important; border-radius: 20px !important; font-size: 12px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.5px !important; margin-bottom: 16px !important; width: fit-content !important;}#upl-gako-s9 .s9-badge .s9-dot { width: 7px !important; height: 7px !important; background: #DDDF4C !important; border-radius: 50% !important; flex-shrink: 0 !important;}#upl-gako-s9 .s9-h2 { font-family: 'Poppins', sans-serif !important; font-size: 35px !important; font-weight: 700 !important; color: #0f2736 !important; line-height: 1.2 !important; margin-bottom: 16px !important;}#upl-gako-s9 .s9-intro { font-size: 17px !important; color: #383838 !important; line-height: 1.75 !important; margin-bottom: 36px !important;}#upl-gako-s9 .s9-table-wrap { overflow-x: auto !important; border-radius: 16px !important; border: 1px solid #e5e7eb !important; background: #ffffff !important; margin-bottom: 28px !important;}#upl-gako-s9 table { width: 100% !important; border-collapse: collapse !important;}#upl-gako-s9 thead tr { background: #0f2736 !important;}#upl-gako-s9 thead th { padding: 14px 18px !important; font-family: 'Poppins', sans-serif !important; font-size: 12.5px !important; font-weight: 700 !important; color: #ffffff !important; text-align: left !important; white-space: nowrap !important;}#upl-gako-s9 thead th:first-child { border-radius: 15px 0 0 0 !important; }#upl-gako-s9 thead th:last-child { border-radius: 0 15px 0 0 !important; }#upl-gako-s9 tbody tr { border-bottom: 1px solid #f0f1f3 !important; }#upl-gako-s9 tbody tr:last-child { border-bottom: none !important; }#upl-gako-s9 tbody tr:nth-child(even) td { background: #f8fafc !important; }#upl-gako-s9 tbody td { padding: 14px 18px !important; font-size: 13.5px !important; color: #383838 !important; vertical-align: top !important;}#upl-gako-s9 tbody td.scope-col { font-family: 'Courier New', monospace !important; font-size: 12px !important; color: #0f2736 !important; font-weight: 700 !important; white-space: nowrap !important;}#upl-gako-s9 .s9-pill { display: inline-flex !important; align-items: center !important; gap: 4px !important; padding: 3px 9px !important; border-radius: 20px !important; font-size: 11px !important; font-weight: 700 !important; white-space: nowrap !important;}#upl-gako-s9 .pill-sensitive { background: rgba(245,158,11,0.12) !important; color: #b45309 !important;}#upl-gako-s9 .pill-restricted { background: rgba(239,68,68,0.10) !important; color: #dc2626 !important;}#upl-gako-s9 .pill-basic { background: rgba(59,185,139,0.12) !important; color: #2aaa7e !important;}\/* Verification callout *\/#upl-gako-s9 .s9-verification-box { background: rgba(245,158,11,0.06) !important; border: 1px solid rgba(245,158,11,0.25) !important; border-radius: 14px !important; padding: 20px 24px !important; display: flex !important; gap: 14px !important; align-items: flex-start !important; margin-bottom: 28px !important;}#upl-gako-s9 .s9-verification-box svg { width: 20px !important; height: 20px !important; stroke: #f59e0b !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important; flex-shrink: 0 !important; margin-top: 2px !important;}#upl-gako-s9 .s9-vbox-label { font-size: 11px !important; font-weight: 700 !important; color: #f59e0b !important; text-transform: uppercase !important; letter-spacing: 0.8px !important; margin-bottom: 6px !important; display: block !important;}#upl-gako-s9 .s9-verification-box p { font-size: 14.5px !important; color: #383838 !important; line-height: 1.65 !important;}#upl-gako-s9 .s9-verification-box p strong { color: #0f2736 !important; font-weight: 700 !important;}\/* inline CTA *\/#upl-gako-s9 .s9-inline-cta { background: rgba(59,185,139,0.08) !important; border: 1px solid rgba(59,185,139,0.25) !important; border-radius: 12px !important; padding: 18px 22px !important; display: flex !important; align-items: center !important; justify-content: space-between !important; gap: 16px !important; flex-wrap: wrap !important;}#upl-gako-s9 .s9-inline-cta p { font-size: 15px !important; color: #383838 !important; line-height: 1.6 !important;}#upl-gako-s9 .s9-inline-cta p strong { color: #0f2736 !important;}#upl-gako-s9 .s9-icta-btn { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: #DDDF4C !important; color: #0f2736 !important; padding: 10px 20px !important; border-radius: 8px !important; font-size: 0.88rem !important; font-weight: 600 !important; border: 2px solid #DDDF4C !important; transition: transform 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important; flex-shrink: 0 !important;}#upl-gako-s9 .s9-icta-btn:hover { transform: translateY(-5px) !important;}#upl-gako-s9 .s9-icta-btn svg { width: 13px !important; height: 13px !important; stroke: currentColor !important; fill: none !important; stroke-width: 2.5 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}@media (max-width: 900px) { #upl-gako-s9 .s9-h2 { font-size: 28px !important; } #upl-gako-s9 { padding: 50px 20px !important; } #upl-gako-s9 .s9-inline-cta { flex-direction: column !important; align-items: flex-start !important; }}@media (max-width: 600px) { #upl-gako-s9 .s9-h2 { font-size: 26px !important; } #upl-gako-s9 .s9-icta-btn { width: 100% !important; justify-content: center !important; } #upl-gako-s9 thead th { font-size: 11px !important; padding: 10px 12px !important; } #upl-gako-s9 tbody td { font-size: 12px !important; padding: 10px 12px !important; }}<\/style><div id=\"upl-gako-s9\"> <div class=\"s9-container\"> <span id=\"gmail-scopes\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"s9-badge\"><span class=\"s9-dot\"><\/span><span>Reference<\/span><\/div> <h2 class=\"s9-h2\">Gmail API Scopes You’ll Actually Need<\/h2> <pee class=\"s9-intro\">Once you accept that OAuth is required, scope selection is the next critical decision. Google classifies Gmail scopes into three tiers based on the sensitivity of the data they expose. Requesting more than you need triggers a longer verification process – and in some cases, a full security assessment by Google.<\/pee> <div class=\"s9-verification-box\"> <svg viewBox=\"0 0 24 24\"><path d=\"M10.29 3.86L1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z\"\/><line x1=\"12\" y1=\"9\" x2=\"12\" y2=\"13\"\/><line x1=\"12\" y1=\"17\" x2=\"12.01\" y2=\"17\"\/><\/svg> <div> <span class=\"s9-vbox-label\">Scope verification tiers<\/span> <pee><strong>Sensitive scopes<\/strong> (yellow) require Google to review your OAuth consent screen and verify your app’s privacy policy. <strong>Restricted scopes<\/strong> (red) require a formal security assessment, a video demonstration, and sometimes a third-party security audit. Plan 2-6 weeks minimum for restricted scope approval. If you use Unipile as your auth layer, this verification process falls on Unipile – not your app.<\/pee> <\/div> <\/div> <div class=\"s9-table-wrap\"> <table> <thead> <tr> <th>Scope<\/th> <th>Access Level<\/th> <th>Tier<\/th> <th>Use Case<\/th> <\/tr> <\/thead> <tbody> <tr> <td class=\"scope-col\">gmail.readonly<\/td> <td>Read all messages, threads, labels, settings<\/td> <td><span class=\"s9-pill pill-sensitive\">Sensitive<\/span><\/td> <td>Email analytics, inbox audit tools, CRM sync (read-only)<\/td> <\/tr> <tr> <td class=\"scope-col\">gmail.send<\/td> <td>Send email on behalf of the user<\/td> <td><span class=\"s9-pill pill-sensitive\">Sensitive<\/span><\/td> <td>Transactional user-side emails, CRM follow-ups, outreach tools<\/td> <\/tr> <tr> <td class=\"scope-col\">gmail.compose<\/td> <td>Create, read, update, delete drafts; send messages<\/td> <td><span class=\"s9-pill pill-sensitive\">Sensitive<\/span><\/td> <td>Email composer integrations, draft management<\/td> <\/tr> <tr> <td class=\"scope-col\">gmail.modify<\/td> <td>Read, send, modify (labels, archive) – no delete<\/td> <td><span class=\"s9-pill pill-restricted\">Restricted<\/span><\/td> <td>Full inbox management, CRM sync with write, archival workflows<\/td> <\/tr> <tr> <td class=\"scope-col\">mail.google.com<\/td> <td>Full access – read, write, delete, settings<\/td> <td><span class=\"s9-pill pill-restricted\">Restricted<\/span><\/td> <td>Full-featured email clients, backup tools, admin migration<\/td> <\/tr> <tr> <td class=\"scope-col\">gmail.metadata<\/td> <td>Message metadata only (no body)<\/td> <td><span class=\"s9-pill pill-basic\">Non-sensitive<\/span><\/td> <td>Analytics on email volume, sender\/recipient patterns (no content)<\/td> <\/tr> <\/tbody> <\/table> <\/div> <div class=\"s9-inline-cta\"> <pee><strong>Building a multi-tenant SaaS that needs gmail.modify or mail.google.com?<\/strong> The restricted scope review adds weeks to your launch timeline. With Unipile, you skip the consent screen review entirely – Unipile’s verified OAuth app covers the scopes your integration needs.<\/pee> <span class=\"s9-icta-btn\" data-upl-link=\"https:\/\/dashboard.unipile.com\/signup\/\" data-upl-target=\"_blank\"><span>Build with Unipile<\/span><svg viewBox=\"0 0 24 24\"><line x1=\"5\" y1=\"12\" x2=\"19\" y2=\"12\"\/><polyline points=\"12 5 19 12 12 19\"\/><\/svg><\/span> <\/div> <\/div><\/div><script>(function(){ function init(){ var el = document.getElementById('upl-gako-s9'); if (!el) return; el.addEventListener('click', function(e){ var t = e.target.closest('[data-upl-link]'); if (!t) return; var url = t.getAttribute('data-upl-link'); var target = t.getAttribute('data-upl-target') || '_self'; if (url) window.open(url, target); }); } if (document.readyState === 'loading') { document.addEventListener('DOMContentLoaded', init); } else { init(); }})();<\/script>[\/et_pb_code][\/et_pb_column][\/et_pb_row][\/et_pb_section][et_pb_section fb_built=”1″ _builder_version=”4.27.3″ background_color=”transparent” custom_padding=”0px|0px|0px|0px|false|false” global_colors_info=”{}” theme_builder_area=”post_content” da_is_popup=”off” da_exit_intent=”off” da_has_close=”on” da_alt_close=”off” da_dark_close=”off” da_not_modal=”on” da_is_singular=”off” da_with_loader=”off” da_has_shadow=”on” da_disable_devices=”off|off|off”][et_pb_row _builder_version=”4.27.3″ background_color=”transparent” global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_column type=”4_4″ _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_code _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”]<link href=\"https:\/\/fonts.googleapis.com\/css2?family=Inter:wght@400;500;600;700&family=Poppins:wght@700;800&display=swap\" rel=\"stylesheet\"><style>#upl-gako-s10,#upl-gako-s10 *,#upl-gako-s10 *::before,#upl-gako-s10 *::after { margin: 0 !important; padding: 0 !important; box-sizing: border-box !important; border: none !important; outline: none !important; font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif !important; line-height: 1.5 !important; letter-spacing: normal !important; text-transform: none !important; text-decoration: none !important; list-style: none !important;}#upl-gako-s10 { background: #f4f5f7 !important; padding: 60px 20px !important;}#upl-gako-s10 .s10-container { max-width: 1100px !important; margin: 0 auto !important;}#upl-gako-s10 .s10-badge { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: rgba(59,185,139,0.12) !important; color: #2aaa7e !important; padding: 6px 14px !important; border-radius: 20px !important; font-size: 12px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.5px !important; margin-bottom: 16px !important; width: fit-content !important;}#upl-gako-s10 .s10-badge .s10-dot { width: 7px !important; height: 7px !important; background: #3BB98B !important; border-radius: 50% !important; flex-shrink: 0 !important;}#upl-gako-s10 .s10-h2 { font-family: 'Poppins', sans-serif !important; font-size: 35px !important; font-weight: 700 !important; color: #0f2736 !important; line-height: 1.2 !important; margin-bottom: 16px !important;}#upl-gako-s10 .s10-intro { font-size: 17px !important; color: #383838 !important; line-height: 1.75 !important; margin-bottom: 40px !important;}#upl-gako-s10 .s10-cards { display: grid !important; grid-template-columns: repeat(3, 1fr) !important; gap: 20px !important; margin-bottom: 40px !important;}#upl-gako-s10 .s10-card { background: #ffffff !important; border: 2px solid #e5e7eb !important; border-radius: 16px !important; padding: 26px !important; display: flex !important; flex-direction: column !important; gap: 0 !important;}#upl-gako-s10 .s10-card.card-highlight { border-color: #3BB98B !important; background: rgba(59,185,139,0.04) !important;}#upl-gako-s10 .s10-card-eyebrow { font-size: 11px !important; font-weight: 700 !important; color: #94a3b8 !important; text-transform: uppercase !important; letter-spacing: 0.8px !important; margin-bottom: 10px !important; display: block !important;}#upl-gako-s10 .s10-card.card-highlight .s10-card-eyebrow { color: #3BB98B !important;}#upl-gako-s10 .s10-card h3 { font-family: 'Poppins', sans-serif !important; font-size: 16px !important; font-weight: 700 !important; color: #0f2736 !important; margin-bottom: 12px !important; line-height: 1.35 !important;}#upl-gako-s10 .s10-card-q { font-size: 14px !important; font-weight: 600 !important; color: #64748b !important; margin-bottom: 6px !important;}#upl-gako-s10 .s10-card-a { font-size: 14.5px !important; color: #383838 !important; line-height: 1.65 !important; margin-bottom: 16px !important;}#upl-gako-s10 .s10-card-verdict { margin-top: auto !important; padding-top: 16px !important; border-top: 1px solid #e5e7eb !important;}#upl-gako-s10 .s10-card.card-highlight .s10-card-verdict { border-top-color: rgba(59,185,139,0.30) !important;}#upl-gako-s10 .s10-card-verdict-label { font-size: 11px !important; font-weight: 700 !important; color: #94a3b8 !important; text-transform: uppercase !important; letter-spacing: 0.5px !important; margin-bottom: 6px !important; display: block !important;}#upl-gako-s10 .s10-verdict-pill { display: inline-flex !important; align-items: center !important; gap: 6px !important; padding: 5px 12px !important; border-radius: 20px !important; font-size: 12px !important; font-weight: 700 !important;}#upl-gako-s10 .s10-verdict-pill svg { width: 12px !important; height: 12px !important; stroke: currentColor !important; fill: none !important; stroke-width: 2.5 !important; stroke-linecap: round !important; stroke-linejoin: round !important; flex-shrink: 0 !important;}#upl-gako-s10 .pill-path1 { background: rgba(59,130,246,0.10) !important; color: #2563eb !important; }#upl-gako-s10 .pill-path2 { background: rgba(168,85,247,0.10) !important; color: #7c3aed !important; }#upl-gako-s10 .pill-path3 { background: rgba(59,185,139,0.12) !important; color: #2aaa7e !important; }\/* CTA final strip *\/#upl-gako-s10 .s10-final-cta { background: #0f2736 !important; border-radius: 16px !important; padding: 40px 40px !important; text-align: center !important;}#upl-gako-s10 .s10-final-cta h3 { font-family: 'Poppins', sans-serif !important; font-size: 26px !important; font-weight: 700 !important; color: #ffffff !important; margin-bottom: 12px !important; line-height: 1.3 !important;}#upl-gako-s10 .s10-final-cta p { font-size: 16px !important; color: rgba(255,255,255,0.75) !important; line-height: 1.7 !important; margin-bottom: 28px !important;}#upl-gako-s10 .s10-final-cta p a { color: #DDDF4C !important; text-decoration: underline !important;}#upl-gako-s10 .s10-final-actions { display: flex !important; align-items: center !important; justify-content: center !important; gap: 14px !important; flex-wrap: wrap !important;}#upl-gako-s10 .s10-final-btn-primary { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: #DDDF4C !important; color: #0f2736 !important; padding: 14px 28px !important; border-radius: 8px !important; font-size: 1rem !important; font-weight: 600 !important; border: 2px solid #DDDF4C !important; transition: transform 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important;}#upl-gako-s10 .s10-final-btn-primary:hover { transform: translateY(-5px) !important;}#upl-gako-s10 .s10-final-btn-primary svg { width: 16px !important; height: 16px !important; stroke: currentColor !important; fill: none !important; stroke-width: 2.5 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}#upl-gako-s10 .s10-final-btn-secondary { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: transparent !important; color: #ffffff !important; padding: 14px 28px !important; border-radius: 8px !important; font-size: 1rem !important; font-weight: 600 !important; border: 2px solid rgba(255,255,255,0.30) !important; transition: all 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important;}#upl-gako-s10 .s10-final-btn-secondary:hover { border-color: rgba(255,255,255,0.70) !important;}#upl-gako-s10 .s10-final-btn-secondary svg { width: 16px !important; height: 16px !important; stroke: currentColor !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}\/* Cross-links *\/#upl-gako-s10 .s10-crosslinks { display: grid !important; grid-template-columns: repeat(2, 1fr) !important; gap: 12px !important; margin-top: 28px !important;}#upl-gako-s10 .s10-crosslink { background: rgba(255,255,255,0.06) !important; border: 1px solid rgba(255,255,255,0.12) !important; border-radius: 10px !important; padding: 14px 18px !important; display: flex !important; align-items: center !important; gap: 10px !important; cursor: pointer !important; transition: background 0.2s ease !important;}#upl-gako-s10 .s10-crosslink:hover { background: rgba(255,255,255,0.10) !important;}#upl-gako-s10 .s10-crosslink svg { width: 16px !important; height: 16px !important; stroke: #DDDF4C !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important; flex-shrink: 0 !important;}#upl-gako-s10 .s10-crosslink-text { font-size: 13px !important; color: rgba(255,255,255,0.80) !important; line-height: 1.4 !important;}#upl-gako-s10 .s10-crosslink-text strong { color: #ffffff !important; display: block !important; font-size: 13px !important; font-weight: 600 !important; margin-bottom: 2px !important;}@media (max-width: 900px) { #upl-gako-s10 .s10-h2 { font-size: 28px !important; } #upl-gako-s10 .s10-cards { grid-template-columns: 1fr !important; } #upl-gako-s10 .s10-crosslinks { grid-template-columns: 1fr !important; } #upl-gako-s10 { padding: 50px 20px !important; } #upl-gako-s10 .s10-final-cta { padding: 32px 24px !important; }}@media (max-width: 600px) { #upl-gako-s10 .s10-h2 { font-size: 26px !important; } #upl-gako-s10 .s10-final-btn-primary, #upl-gako-s10 .s10-final-btn-secondary { width: 100% !important; justify-content: center !important; } #upl-gako-s10 .s10-final-cta h3 { font-size: 22px !important; }}<\/style><div id=\"upl-gako-s10\"> <div class=\"s10-container\"> <span id=\"decision-tree\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"s10-badge\"><span class=\"s10-dot\"><\/span><span>Decision Guide<\/span><\/div> <h2 class=\"s10-h2\">Decision Tree: Which Auth Method for Your Use Case?<\/h2> <pee class=\"s10-intro\">Answer three questions and you’ll know exactly which Gmail API authentication path applies to your project. There’s no universal answer – each path solves a different problem. For the full <a href=\"https:\/\/www.unipile.com\/communication-api\/email-api\/duplicate-enhance-your-email-software-with-gmail-api-integration\/\" style=\"color:#2aaa7e!important;text-decoration:underline!important;\">complete Gmail API integration guide<\/a>, continue to the Gmail hub. For <a href=\"https:\/\/www.unipile.com\/microsoft-graph-api-email\/\" style=\"color:#2aaa7e!important;text-decoration:underline!important;\">the equivalent for Outlook \/ Microsoft 365<\/a>, see our Microsoft Graph OAuth guide.<\/pee> <div class=\"s10-cards\">  <div class=\"s10-card\"> <span class=\"s10-card-eyebrow\">Use case A<\/span> <h3>SaaS app where customers connect their own Gmail<\/h3> <div> <pee class=\"s10-card-q\">Are your users external (not your employees)?<\/pee> <pee class=\"s10-card-a\">Yes – they’re your customers with personal Gmail or Google Workspace accounts.<\/pee> <pee class=\"s10-card-q\">Do you need to support many different Google domains?<\/pee> <pee class=\"s10-card-a\">Yes – multi-tenant. Each user connects their own account.<\/pee> <\/div> <div class=\"s10-card-verdict\"> <span class=\"s10-card-verdict-label\">Recommended path<\/span> <span class=\"s10-verdict-pill pill-path1\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Path 1 – OAuth Client ID<\/span><\/span> <pee style=\"font-size:13px!important;color:#64748b!important;margin-top:8px!important;line-height:1.5!important;\">Or Path 3 (Unified API) to skip the OAuth infrastructure entirely.<\/pee> <\/div> <\/div>  <div class=\"s10-card\"> <span class=\"s10-card-eyebrow\">Use case B<\/span> <h3>Internal tool for your own Google Workspace org<\/h3> <div> <pee class=\"s10-card-q\">Are all users on the same Workspace domain (your employees)?<\/pee> <pee class=\"s10-card-a\">Yes – company.com accounts only. No external Gmail users.<\/pee> <pee class=\"s10-card-q\">Do you have a Workspace admin who can configure DWD?<\/pee> <pee class=\"s10-card-a\">Yes – admin access available in admin.google.com.<\/pee> <\/div> <div class=\"s10-card-verdict\"> <span class=\"s10-card-verdict-label\">Recommended path<\/span> <span class=\"s10-verdict-pill pill-path2\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Path 2 – Service Account + DWD<\/span><\/span> <pee style=\"font-size:13px!important;color:#64748b!important;margin-top:8px!important;line-height:1.5!important;\">No per-user consent flows. Admin delegates once.<\/pee> <\/div> <\/div>  <div class=\"s10-card card-highlight\"> <span class=\"s10-card-eyebrow\">Use case C – Most common<\/span> <h3>SaaS app that needs Gmail + Outlook + IMAP under one API<\/h3> <div> <pee class=\"s10-card-q\">Do your users have a mix of Gmail, Outlook, and IMAP accounts?<\/pee> <pee class=\"s10-card-a\">Yes – you can’t predict which provider each user will connect.<\/pee> <pee class=\"s10-card-q\">Do you want to avoid running separate OAuth integrations per provider?<\/pee> <pee class=\"s10-card-a\">Yes – managing Google OAuth + Microsoft OAuth + IMAP is too much complexity.<\/pee> <\/div> <div class=\"s10-card-verdict\"> <span class=\"s10-card-verdict-label\">Recommended path<\/span> <span class=\"s10-verdict-pill pill-path3\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><span>Path 3 – Unified API (Unipile)<\/span><\/span> <pee style=\"font-size:13px!important;color:#2aaa7e!important;margin-top:8px!important;line-height:1.5!important;\">One API key. Gmail, Outlook, IMAP. No OAuth ops.<\/pee> <\/div> <\/div> <\/div>  <div class=\"s10-final-cta\"> <h3>Start building your Gmail integration today<\/h3> <pee>No matter which path you choose, Unipile gives you a <a href=\"https:\/\/www.unipile.com\/email-api\/\" style=\"color:#DDDF4C!important;text-decoration:underline!important;\">unified email API overview<\/a> to understand the architecture before you commit to an approach. Or skip straight to the dashboard and link your first account in minutes.<\/pee> <div class=\"s10-final-actions\"> <span class=\"s10-final-btn-primary\" data-upl-link=\"https:\/\/dashboard.unipile.com\/signup\/\" data-upl-target=\"_blank\"><span>Build it with Unipile<\/span><svg viewBox=\"0 0 24 24\"><line x1=\"5\" y1=\"12\" x2=\"19\" y2=\"12\"\/><polyline points=\"12 5 19 12 12 19\"\/><\/svg><\/span> <span class=\"s10-final-btn-secondary\" data-upl-link=\"https:\/\/developer.unipile.com\/docs\/getting-started\" data-upl-target=\"_blank\"><span>Read the docs<\/span><svg viewBox=\"0 0 24 24\"><polyline points=\"9 18 15 12 9 6\"\/><\/svg><\/span> <\/div> <div class=\"s10-crosslinks\"> <div class=\"s10-crosslink\" data-upl-link=\"https:\/\/www.unipile.com\/communication-api\/email-api\/duplicate-enhance-your-email-software-with-gmail-api-integration\/\" data-upl-target=\"_self\"> <svg viewBox=\"0 0 24 24\"><polyline points=\"9 18 15 12 9 6\"\/><\/svg> <div class=\"s10-crosslink-text\"><strong>Gmail API integration guide<\/strong>Complete setup, endpoints, and code examples<\/div> <\/div> <div class=\"s10-crosslink\" data-upl-link=\"https:\/\/www.unipile.com\/oauth-email-api\/\" data-upl-target=\"_self\"> <svg viewBox=\"0 0 24 24\"><polyline points=\"9 18 15 12 9 6\"\/><\/svg> <div class=\"s10-crosslink-text\"><strong>OAuth flow for email APIs in detail<\/strong>Deep dive into the authorization code flow<\/div> <\/div> <div class=\"s10-crosslink\" data-upl-link=\"https:\/\/www.unipile.com\/email-sync-api\/\" data-upl-target=\"_self\"> <svg viewBox=\"0 0 24 24\"><polyline points=\"9 18 15 12 9 6\"\/><\/svg> <div class=\"s10-crosslink-text\"><strong>How email sync works under the hood<\/strong>Webhooks, polling, and delta sync explained<\/div> <\/div> <div class=\"s10-crosslink\" data-upl-link=\"https:\/\/www.unipile.com\/email-api-providers\/\" data-upl-target=\"_self\"> <svg viewBox=\"0 0 24 24\"><polyline points=\"9 18 15 12 9 6\"\/><\/svg> <div class=\"s10-crosslink-text\"><strong>Compare email sync API providers<\/strong>Unipile vs. building OAuth yourself<\/div> <\/div> <\/div> <\/div> <\/div><\/div><script>(function(){ function init(){ var el = document.getElementById('upl-gako-s10'); if (!el) return; el.addEventListener('click', function(e){ var t = e.target.closest('[data-upl-link]'); if (!t) return; var url = t.getAttribute('data-upl-link'); var target = t.getAttribute('data-upl-target') || '_self'; if (url) window.open(url, target); }); } if (document.readyState === 'loading') { document.addEventListener('DOMContentLoaded', init); } else { init(); }})();<\/script>[\/et_pb_code][\/et_pb_column][\/et_pb_row][\/et_pb_section][et_pb_section fb_built=”1″ _builder_version=”4.27.3″ background_color=”transparent” custom_padding=”0px|0px|0px|0px|false|false” global_colors_info=”{}” theme_builder_area=”post_content” da_is_popup=”off” da_exit_intent=”off” da_has_close=”on” da_alt_close=”off” da_dark_close=”off” da_not_modal=”on” da_is_singular=”off” da_with_loader=”off” da_has_shadow=”on” da_disable_devices=”off|off|off”][et_pb_row _builder_version=”4.27.3″ background_color=”transparent” global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_column type=”4_4″ _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”][et_pb_code _builder_version=”4.27.3″ global_colors_info=”{}” theme_builder_area=”post_content”]<script type=\"application\/ld+json\">{ \"@context\": \"https:\/\/schema.org\", \"@type\": \"FAQPage\", \"mainEntity\": [ { \"@type\": \"Question\", \"name\": \"Can I use a Google API key to access Gmail?\", \"acceptedAnswer\": { \"@type\": \"Answer\", \"text\": \"No. Google API keys only work for public, non-user-specific APIs like Maps, Translate, or YouTube Data (public content). Gmail API accesses private user mailbox data, which requires explicit user consent via OAuth 2.0. Sending a request to the Gmail API with only an API key returns a 401 Login Required or 403 Daily Limit for Unauthenticated Use Exceeded error.\" } }, { \"@type\": \"Question\", \"name\": \"Does the Gmail API require OAuth 2.0?\", \"acceptedAnswer\": { \"@type\": \"Answer\", \"text\": \"Yes, always. Gmail API access is user-data access, which means every request must be tied to an authenticated user who has granted consent via an OAuth 2.0 flow. There is no workaround: no API key, no basic auth (deprecated September 2024), no magic header. The three supported authentication paths are: OAuth 2.0 Client ID (multi-tenant), Service Account with Domain-Wide Delegation (Workspace only), and a unified email API like Unipile that handles the OAuth layer for you.\" } }, { \"@type\": \"Question\", \"name\": \"What's the difference between an API key and an OAuth client ID on Google Cloud?\", \"acceptedAnswer\": { \"@type\": \"Answer\", \"text\": \"An API key identifies your Google Cloud project for billing and quota purposes. It works only for APIs that serve public data (Maps, Translate, etc.). An OAuth client ID is used to initiate a consent flow where a real user approves your app's access to their account. The OAuth client ID is what generates the access token and refresh token that Gmail API actually accepts. These are two entirely different mechanisms: one identifies a project, the other authenticates a user.\" } }, { \"@type\": \"Question\", \"name\": \"Can a service account read Gmail without user consent?\", \"acceptedAnswer\": { \"@type\": \"Answer\", \"text\": \"Only if Domain-Wide Delegation (DWD) is enabled by a Google Workspace admin. A service account by itself cannot access any Gmail inbox. With DWD configured, the service account can impersonate any user in the organization and access their mailbox without interactive consent. Important: this only works for Google Workspace (business) accounts. It does not work for personal Gmail addresses (@gmail.com).\" } }, { \"@type\": \"Question\", \"name\": \"Why does Gmail API return 'Login Required' with my API key?\", \"acceptedAnswer\": { \"@type\": \"Answer\", \"text\": \"Because Gmail API does not accept API keys. The 401 Login Required error means the request lacks a valid OAuth 2.0 access token in the Authorization header. Gmail API expects: Authorization: Bearer {access_token} - where the access token was obtained via an OAuth 2.0 flow (authorization code, service account JWT, or a unified API token). Simply appending ?key=YOUR_API_KEY to the Gmail API URL will not work and will either return 401 or 403.\" } }, { \"@type\": \"Question\", \"name\": \"Is there a way to use Gmail API without managing OAuth myself?\", \"acceptedAnswer\": { \"@type\": \"Answer\", \"text\": \"Yes. A unified email API like Unipile handles the entire OAuth layer: the consent screen, the token exchange, and the silent refresh token rotation. Your application never stores or manages access tokens or refresh tokens. You simply call the Unipile API with your own API key, and Unipile handles all OAuth communication with Google on behalf of your linked accounts. This removes the Google consent screen approval process and the token management complexity from your codebase.\" } } ]}<\/script><link href=\"https:\/\/fonts.googleapis.com\/css2?family=Inter:wght@400;500;600;700&family=Poppins:wght@700;800&display=swap\" rel=\"stylesheet\"><style>#upl-gako-faq,#upl-gako-faq *,#upl-gako-faq *::before,#upl-gako-faq *::after { margin: 0 !important; padding: 0 !important; box-sizing: border-box !important; border: none !important; outline: none !important; font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif !important; line-height: 1.5 !important; letter-spacing: normal !important; text-transform: none !important; text-decoration: none !important; list-style: none !important;}#upl-gako-faq { background: #f4f5f7 !important; padding: 70px 24px !important;}#upl-gako-faq .faq-container { max-width: 900px !important; margin: 0 auto !important;}#upl-gako-faq .faq-badge { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: rgba(59,185,139,0.12) !important; color: #2aaa7e !important; padding: 6px 14px !important; border-radius: 20px !important; font-size: 12px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.5px !important; margin-bottom: 16px !important; width: fit-content !important;}#upl-gako-faq .faq-badge .faq-dot { width: 7px !important; height: 7px !important; background: #3BB98B !important; border-radius: 50% !important; flex-shrink: 0 !important;}#upl-gako-faq .faq-h2 { font-family: 'Poppins', sans-serif !important; font-size: 35px !important; font-weight: 700 !important; color: #0f2736 !important; line-height: 1.2 !important; margin-bottom: 12px !important;}#upl-gako-faq .faq-intro { font-size: 16px !important; color: #383838 !important; line-height: 1.75 !important; margin-bottom: 36px !important;}#upl-gako-faq .faq-list { display: flex !important; flex-direction: column !important; gap: 12px !important; margin-bottom: 40px !important;}#upl-gako-faq .faq-item { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; overflow: hidden !important; transition: border-color 0.2s ease !important;}#upl-gako-faq .faq-item.active { border-color: #3BB98B !important;}#upl-gako-faq .faq-item-header { padding: 20px 24px !important; display: flex !important; align-items: center !important; gap: 16px !important; cursor: pointer !important; user-select: none !important;}#upl-gako-faq .faq-num { width: 38px !important; height: 38px !important; min-width: 38px !important; border-radius: 10px !important; background: rgba(59,185,139,0.10) !important; color: #2aaa7e !important; display: flex !important; align-items: center !important; justify-content: center !important; font-family: 'Poppins', sans-serif !important; font-size: 13px !important; font-weight: 700 !important; transition: background 0.2s ease, color 0.2s ease !important; flex-shrink: 0 !important;}#upl-gako-faq .faq-item.active .faq-num { background: #3BB98B !important; color: #ffffff !important;}#upl-gako-faq .faq-question { font-size: 16px !important; font-weight: 600 !important; color: #0f2736 !important; line-height: 1.4 !important; flex: 1 !important;}#upl-gako-faq .faq-toggle { width: 22px !important; height: 22px !important; min-width: 22px !important; border-radius: 6px !important; background: rgba(59,185,139,0.08) !important; display: flex !important; align-items: center !important; justify-content: center !important; transition: background 0.2s ease, transform 0.3s ease !important; flex-shrink: 0 !important;}#upl-gako-faq .faq-item.active .faq-toggle { background: #3BB98B !important; transform: rotate(45deg) !important;}#upl-gako-faq .faq-toggle svg { width: 14px !important; height: 14px !important; stroke: #3BB98B !important; fill: none !important; stroke-width: 2.5 !important; stroke-linecap: round !important; stroke-linejoin: round !important; transition: stroke 0.2s ease !important;}#upl-gako-faq .faq-item.active .faq-toggle svg { stroke: #ffffff !important;}#upl-gako-faq .faq-body { max-height: 0 !important; overflow: hidden !important; transition: max-height 0.35s ease !important;}#upl-gako-faq .faq-body.open { max-height: 800px !important;}#upl-gako-faq .faq-answer { padding: 0 28px 28px 76px !important; font-size: 15px !important; color: #4a5568 !important; line-height: 1.78 !important;}#upl-gako-faq .faq-answer a { color: #2aaa7e !important; text-decoration: underline !important;}#upl-gako-faq .faq-answer strong { color: #0f2736 !important; font-weight: 700 !important;}#upl-gako-faq .faq-answer code { background: rgba(0,0,0,0.06) !important; padding: 2px 5px !important; border-radius: 4px !important; font-family: 'Courier New', monospace !important; font-size: 12.5px !important;}\/* CTA bar *\/#upl-gako-faq .faq-cta-bar { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; padding: 24px 28px !important; display: flex !important; align-items: center !important; justify-content: space-between !important; gap: 20px !important; flex-wrap: wrap !important;}#upl-gako-faq .faq-cta-text { font-size: 15.5px !important; color: #383838 !important; line-height: 1.6 !important;}#upl-gako-faq .faq-cta-text strong { color: #0f2736 !important;}#upl-gako-faq .faq-cta-btn { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: #DDDF4C !important; color: #0f2736 !important; border: 2px solid #DDDF4C !important; padding: 12px 22px !important; border-radius: 8px !important; font-size: 0.9rem !important; font-weight: 600 !important; cursor: pointer !important; white-space: nowrap !important; transition: transform 0.3s ease !important; flex-shrink: 0 !important;}#upl-gako-faq .faq-cta-btn:hover { transform: translateY(-3px) !important;}#upl-gako-faq .faq-cta-btn svg { width: 14px !important; height: 14px !important; stroke: currentColor !important; fill: none !important; stroke-width: 2.5 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}@media (max-width: 900px) { #upl-gako-faq .faq-h2 { font-size: 28px !important; } #upl-gako-faq { padding: 50px 16px !important; } #upl-gako-faq .faq-answer { padding: 0 16px 20px 16px !important; }}@media (max-width: 600px) { #upl-gako-faq .faq-h2 { font-size: 26px !important; } #upl-gako-faq .faq-cta-bar { flex-direction: column !important; align-items: flex-start !important; } #upl-gako-faq .faq-cta-btn { width: 100% !important; justify-content: center !important; }}<\/style><div id=\"upl-gako-faq\"> <div class=\"faq-container\"> <span id=\"gmail-api-key-vs-oauth-faq\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"faq-badge\"><span class=\"faq-dot\"><\/span><span>FAQ<\/span><\/div> <h2 class=\"faq-h2\">Frequently Asked Questions<\/h2> <pee class=\"faq-intro\">The most common questions about Gmail API authentication, API keys vs OAuth tokens, and how to access Gmail programmatically without managing OAuth yourself.<\/pee> <div class=\"faq-list\"> <div class=\"faq-item\" data-faq-idx=\"0\"> <div class=\"faq-item-header\"> <div class=\"faq-num\">01<\/div> <pee class=\"faq-question\">Can I use a Google API key to access Gmail?<\/pee> <div class=\"faq-toggle\"><svg viewBox=\"0 0 24 24\"><line x1=\"12\" y1=\"5\" x2=\"12\" y2=\"19\"\/><line x1=\"5\" y1=\"12\" x2=\"19\" y2=\"12\"\/><\/svg><\/div> <\/div> <div class=\"faq-body\"> <div class=\"faq-answer\"> <pee>No. Google API keys only work for public, non-user-specific APIs like Maps, Translate, or YouTube Data (public content). Gmail API accesses <strong>private user mailbox data<\/strong>, which requires explicit user consent via OAuth 2.0. Sending a request to the Gmail API with only an API key returns a <code>401 Login Required<\/code> or <code>403 Daily Limit for Unauthenticated Use Exceeded<\/code> error – every time, with no exception.<\/pee> <\/div> <\/div> <\/div> <div class=\"faq-item\" data-faq-idx=\"1\"> <div class=\"faq-item-header\"> <div class=\"faq-num\">02<\/div> <pee class=\"faq-question\">Does the Gmail API require OAuth 2.0?<\/pee> <div class=\"faq-toggle\"><svg viewBox=\"0 0 24 24\"><line x1=\"12\" y1=\"5\" x2=\"12\" y2=\"19\"\/><line x1=\"5\" y1=\"12\" x2=\"19\" y2=\"12\"\/><\/svg><\/div> <\/div> <div class=\"faq-body\"> <div class=\"faq-answer\"> <pee>Yes, always. Gmail API access is user-data access, which means every request must be tied to an authenticated user who has granted consent via an OAuth 2.0 flow. There is no workaround: no API key, no basic auth (<strong>deprecated September 2024<\/strong>), no magic header. The three supported authentication paths are: OAuth 2.0 Client ID (multi-tenant), Service Account with Domain-Wide Delegation (Workspace only), and a unified email API like Unipile that handles the OAuth layer for you.<\/pee> <\/div> <\/div> <\/div> <div class=\"faq-item\" data-faq-idx=\"2\"> <div class=\"faq-item-header\"> <div class=\"faq-num\">03<\/div> <pee class=\"faq-question\">What’s the difference between an API key and an OAuth client ID on Google Cloud?<\/pee> <div class=\"faq-toggle\"><svg viewBox=\"0 0 24 24\"><line x1=\"12\" y1=\"5\" x2=\"12\" y2=\"19\"\/><line x1=\"5\" y1=\"12\" x2=\"19\" y2=\"12\"\/><\/svg><\/div> <\/div> <div class=\"faq-body\"> <div class=\"faq-answer\"> <pee>An <strong>API key<\/strong> identifies your Google Cloud project for billing and quota purposes. It works only for APIs that serve public data (Maps, Translate, etc.). An <strong>OAuth client ID<\/strong> is used to initiate a consent flow where a real user approves your app’s access to their account. The OAuth client ID generates the access token and refresh token that Gmail API actually accepts. These are two entirely different mechanisms: one identifies a project, the other authenticates a user.<\/pee> <\/div> <\/div> <\/div> <div class=\"faq-item\" data-faq-idx=\"3\"> <div class=\"faq-item-header\"> <div class=\"faq-num\">04<\/div> <pee class=\"faq-question\">Can a service account read Gmail without user consent?<\/pee> <div class=\"faq-toggle\"><svg viewBox=\"0 0 24 24\"><line x1=\"12\" y1=\"5\" x2=\"12\" y2=\"19\"\/><line x1=\"5\" y1=\"12\" x2=\"19\" y2=\"12\"\/><\/svg><\/div> <\/div> <div class=\"faq-body\"> <div class=\"faq-answer\"> <pee>Only if <strong>Domain-Wide Delegation (DWD)<\/strong> is enabled by a Google Workspace admin. A service account by itself cannot access any Gmail inbox. With DWD configured, the service account can impersonate any user in the organization and access their mailbox without interactive consent. Critical limitation: this only works for Google Workspace (business) accounts. It does not work for personal Gmail addresses (<code>@gmail.com<\/code>). See <a href=\"https:\/\/support.google.com\/a\/answer\/162106\" target=\"_blank\" rel=\"noopener\">Google’s official DWD documentation<\/a>.<\/pee> <\/div> <\/div> <\/div> <div class=\"faq-item\" data-faq-idx=\"4\"> <div class=\"faq-item-header\"> <div class=\"faq-num\">05<\/div> <pee class=\"faq-question\">Why does Gmail API return “Login Required” with my API key?<\/pee> <div class=\"faq-toggle\"><svg viewBox=\"0 0 24 24\"><line x1=\"12\" y1=\"5\" x2=\"12\" y2=\"19\"\/><line x1=\"5\" y1=\"12\" x2=\"19\" y2=\"12\"\/><\/svg><\/div> <\/div> <div class=\"faq-body\"> <div class=\"faq-answer\"> <pee>Because <strong>Gmail API does not accept API keys<\/strong>. The <code>401 Login Required<\/code> error means the request lacks a valid OAuth 2.0 access token in the <code>Authorization<\/code> header. Gmail API expects: <code>Authorization: Bearer {access_token}<\/code> – where the access token was obtained via an OAuth 2.0 flow (authorization code, service account JWT, or a unified API token). Simply appending <code>?key=YOUR_API_KEY<\/code> to the Gmail API URL will not work and will return 401 or 403.<\/pee> <\/div> <\/div> <\/div> <div class=\"faq-item\" data-faq-idx=\"5\"> <div class=\"faq-item-header\"> <div class=\"faq-num\">06<\/div> <pee class=\"faq-question\">Is there a way to use Gmail API without managing OAuth myself?<\/pee> <div class=\"faq-toggle\"><svg viewBox=\"0 0 24 24\"><line x1=\"12\" y1=\"5\" x2=\"12\" y2=\"19\"\/><line x1=\"5\" y1=\"12\" x2=\"19\" y2=\"12\"\/><\/svg><\/div> <\/div> <div class=\"faq-body\"> <div class=\"faq-answer\"> <pee>Yes. A unified email API like <a href=\"https:\/\/www.unipile.com\/email-api\/\">Unipile<\/a> handles the entire OAuth layer: the consent screen, the token exchange, and the silent refresh token rotation. Your application never stores or manages access tokens or refresh tokens. You call the Unipile API with your own API key, and Unipile handles all OAuth communication with Google on behalf of your <strong>linked accounts<\/strong>. This removes the Google consent screen approval process and the token management complexity from your codebase – and gives you Gmail, Outlook, and IMAP under one unified interface.<\/pee> <\/div> <\/div> <\/div> <\/div>  <div class=\"faq-cta-bar\"> <pee class=\"faq-cta-text\"><strong>Still have questions about Gmail API authentication?<\/strong> Our team can walk you through the right setup for your use case.<\/pee> <span class=\"faq-cta-btn\" onclick=\"if(window.$crisp){$crisp.push(['do','chat:open'])}\"><span>Talk to an expert<\/span><svg viewBox=\"0 0 24 24\"><line x1=\"5\" y1=\"12\" x2=\"19\" y2=\"12\"\/><polyline points=\"12 5 19 12 12 19\"\/><\/svg><\/span> <\/div> <\/div><\/div><script>(function(){ function init(){ var faq = document.getElementById('upl-gako-faq'); if (!faq) return; var items = faq.querySelectorAll('.faq-item'); items.forEach(function(item){ var header = item.querySelector('.faq-item-header'); var body = item.querySelector('.faq-body'); if (!header || !body) return; header.addEventListener('click', function(){ var isOpen = item.classList.contains('active'); items.forEach(function(i){ i.classList.remove('active'); var b = i.querySelector('.faq-body'); if (b) b.classList.remove('open'); }); if (!isOpen) { item.classList.add('active'); body.classList.add('open'); } }); }); } if (document.readyState === 'loading') { document.addEventListener('DOMContentLoaded', init); } else { init(); }})();<\/script>[\/et_pb_code][\/et_pb_column][\/et_pb_row][\/et_pb_section]\n","protected":false},"excerpt":{"rendered":"<p>Path 1 of 3 Path 1 – OAuth 2.0 Client ID (Multi-Tenant SaaS) If you’re building a SaaS product where your customers connect their own Gmail accounts, the OAuth 2.0 authorization code flow is the standard path. This is the 3-legged flow: your app, Google, and the end user. It requires setting up a Google […]<\/p>\n","protected":false},"author":4,"featured_media":278949,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_et_pb_use_builder":"on","_et_pb_old_content":"","_et_gb_content_width":"","inline_featured_image":false,"footnotes":""},"categories":[69,73],"tags":[],"post_folder":[],"class_list":["post-278929","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-api-guidelines","category-email-api-integration"],"yoast_head":"\n<title>Gmail API Key vs OAuth: Why You Can't Skip OAuth (and What to Use Instead) - Unipile<\/title>\n<meta name=\"description\" content=\"Learn when to use Gmail API keys vs OAuth. Compare security, ease of setup, and real-world scenarios. See OAuth best practices for production apps. Start building.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.unipile.com\/tr\/gmail-api-anahtari-vs-oauth\/\" \/>\n<meta property=\"og:locale\" content=\"tr_TR\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Gmail API Key vs OAuth: Why You Can't Skip OAuth (and What to Use Instead) - Unipile\" \/>\n<meta property=\"og:description\" content=\"Learn when to use Gmail API keys vs OAuth. Compare security, ease of setup, and real-world scenarios. See OAuth best practices for production apps. Start building.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.unipile.com\/tr\/gmail-api-anahtari-vs-oauth\/\" \/>\n<meta property=\"og:site_name\" content=\"Unipile\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/unipilefr\" \/>\n<meta property=\"article:published_time\" content=\"2026-05-25T09:49:40+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-05-25T09:50:32+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.unipile.com\/wp-content\/uploads\/2026\/05\/gmail-api-key-vs-oauth.png\" \/>\n\t<meta property=\"og:image:width\" content=\"2400\" \/>\n\t<meta property=\"og:image:height\" content=\"1260\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"Damien Girardeau\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@UnipileAPI\" \/>\n<meta name=\"twitter:site\" content=\"@UnipileAPI\" \/>\n<meta name=\"twitter:label1\" content=\"Yazan:\" \/>\n\t<meta name=\"twitter:data1\" content=\"Damien Girardeau\" \/>\n\t<meta name=\"twitter:label2\" content=\"Tahmini okuma s\u00fcresi\" \/>\n\t<meta name=\"twitter:data2\" content=\"17 dakika\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-key-vs-oauth\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-key-vs-oauth\\\/\"},\"author\":{\"name\":\"Damien Girardeau\",\"@id\":\"https:\\\/\\\/www.unipile.com\\\/#\\\/schema\\\/person\\\/a2ac44e22bdc27d497ce8b58716a673e\"},\"headline\":\"Gmail API Key vs OAuth: Why You Can’t Skip OAuth (and What to Use Instead)\",\"datePublished\":\"2026-05-25T09:49:40+00:00\",\"dateModified\":\"2026-05-25T09:50:32+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-key-vs-oauth\\\/\"},\"wordCount\":5025,\"publisher\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/#organization\"},\"image\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-key-vs-oauth\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/www.unipile.com\\\/wp-content\\\/uploads\\\/2026\\\/05\\\/gmail-api-key-vs-oauth.png\",\"articleSection\":[\"API Guidelines\",\"Email API Integration\"],\"inLanguage\":\"tr\"},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-key-vs-oauth\\\/\",\"url\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-key-vs-oauth\\\/\",\"name\":\"Gmail API Key vs OAuth: Why You Can't Skip OAuth (and What to Use Instead) - Unipile\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-key-vs-oauth\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-key-vs-oauth\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/www.unipile.com\\\/wp-content\\\/uploads\\\/2026\\\/05\\\/gmail-api-key-vs-oauth.png\",\"datePublished\":\"2026-05-25T09:49:40+00:00\",\"dateModified\":\"2026-05-25T09:50:32+00:00\",\"description\":\"Learn when to use Gmail API keys vs OAuth. Compare security, ease of setup, and real-world scenarios. See OAuth best practices for production apps. Start building.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-key-vs-oauth\\\/#breadcrumb\"},\"inLanguage\":\"tr\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.unipile.com\\\/gmail-api-key-vs-oauth\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"tr\",\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-key-vs-oauth\\\/#primaryimage\",\"url\":\"https:\\\/\\\/www.unipile.com\\\/wp-content\\\/uploads\\\/2026\\\/05\\\/gmail-api-key-vs-oauth.png\",\"contentUrl\":\"https:\\\/\\\/www.unipile.com\\\/wp-content\\\/uploads\\\/2026\\\/05\\\/gmail-api-key-vs-oauth.png\",\"width\":2400,\"height\":1260,\"caption\":\"Gmail API Key vs OAuth: why OAuth is required and how to implement it\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-key-vs-oauth\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Accueil\",\"item\":\"https:\\\/\\\/www.unipile.com\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Gmail API Key vs OAuth: Why You Can’t Skip OAuth (and What to Use Instead)\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/www.unipile.com\\\/#website\",\"url\":\"https:\\\/\\\/www.unipile.com\\\/\",\"name\":\"Unipile\",\"description\":\"Integrate Messaging & Email, Connect with Ease via API\",\"publisher\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/www.unipile.com\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"tr\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/www.unipile.com\\\/#organization\",\"name\":\"Unipile\",\"url\":\"https:\\\/\\\/www.unipile.com\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"tr\",\"@id\":\"https:\\\/\\\/www.unipile.com\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/www.unipile.com\\\/wp-content\\\/uploads\\\/2021\\\/05\\\/logo-unipile.png\",\"contentUrl\":\"https:\\\/\\\/www.unipile.com\\\/wp-content\\\/uploads\\\/2021\\\/05\\\/logo-unipile.png\",\"width\":200,\"height\":49,\"caption\":\"Unipile\"},\"image\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/#\\\/schema\\\/logo\\\/image\\\/\"},\"sameAs\":[\"https:\\\/\\\/www.facebook.com\\\/unipilefr\",\"https:\\\/\\\/x.com\\\/UnipileAPI\",\"https:\\\/\\\/www.linkedin.com\\\/company\\\/unipile\\\/\"]},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/www.unipile.com\\\/#\\\/schema\\\/person\\\/a2ac44e22bdc27d497ce8b58716a673e\",\"name\":\"Damien Girardeau\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"tr\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/12dd140720736a8db29f540c42a17d2680cd54a04fb26bb7b55423c179b065a9?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/12dd140720736a8db29f540c42a17d2680cd54a04fb26bb7b55423c179b065a9?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/12dd140720736a8db29f540c42a17d2680cd54a04fb26bb7b55423c179b065a9?s=96&d=mm&r=g\",\"caption\":\"Damien Girardeau\"}}]}<\/script>\n","yoast_head_json":{"title":"Gmail API Anahtar\u0131 vs OAuth: Neden OAuth'u Atlayamazs\u0131n\u0131z (ve Yerine Ne Kullanmal\u0131s\u0131n\u0131z) - Unipile","description":"Gmail API anahtarlar\u0131n\u0131n ne zaman ve OAuth'un ne zaman kullan\u0131laca\u011f\u0131n\u0131 \u00f6\u011frenin. G\u00fcvenlik, kurulum kolayl\u0131\u011f\u0131 ve ger\u00e7ek d\u00fcnya senaryolar\u0131n\u0131 kar\u015f\u0131la\u015ft\u0131r\u0131n. \u00dcretim uygulamalar\u0131 i\u00e7in OAuth en iyi uygulamalar\u0131n\u0131 g\u00f6r\u00fcn. Olu\u015fturmaya ba\u015flay\u0131n.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.unipile.com\/tr\/gmail-api-anahtari-vs-oauth\/","og_locale":"tr_TR","og_type":"article","og_title":"Gmail API Key vs OAuth: Why You Can't Skip OAuth (and What to Use Instead) - Unipile","og_description":"Learn when to use Gmail API keys vs OAuth. Compare security, ease of setup, and real-world scenarios. See OAuth best practices for production apps. Start building.","og_url":"https:\/\/www.unipile.com\/tr\/gmail-api-anahtari-vs-oauth\/","og_site_name":"Unipile","article_publisher":"https:\/\/www.facebook.com\/unipilefr","article_published_time":"2026-05-25T09:49:40+00:00","article_modified_time":"2026-05-25T09:50:32+00:00","og_image":[{"width":2400,"height":1260,"url":"https:\/\/www.unipile.com\/wp-content\/uploads\/2026\/05\/gmail-api-key-vs-oauth.png","type":"image\/png"}],"author":"Damien Girardeau","twitter_card":"summary_large_image","twitter_creator":"@UnipileAPI","twitter_site":"@UnipileAPI","twitter_misc":{"Yazan:":"Damien Girardeau","Tahmini okuma s\u00fcresi":"17 dakika"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.unipile.com\/gmail-api-key-vs-oauth\/#article","isPartOf":{"@id":"https:\/\/www.unipile.com\/gmail-api-key-vs-oauth\/"},"author":{"name":"Damien Girardeau","@id":"https:\/\/www.unipile.com\/#\/schema\/person\/a2ac44e22bdc27d497ce8b58716a673e"},"headline":"Gmail API Key vs OAuth: Why You Can’t Skip OAuth (and What to Use Instead)","datePublished":"2026-05-25T09:49:40+00:00","dateModified":"2026-05-25T09:50:32+00:00","mainEntityOfPage":{"@id":"https:\/\/www.unipile.com\/gmail-api-key-vs-oauth\/"},"wordCount":5025,"publisher":{"@id":"https:\/\/www.unipile.com\/#organization"},"image":{"@id":"https:\/\/www.unipile.com\/gmail-api-key-vs-oauth\/#primaryimage"},"thumbnailUrl":"https:\/\/www.unipile.com\/wp-content\/uploads\/2026\/05\/gmail-api-key-vs-oauth.png","articleSection":["API Guidelines","Email API Integration"],"inLanguage":"tr"},{"@type":"WebPage","@id":"https:\/\/www.unipile.com\/gmail-api-key-vs-oauth\/","url":"https:\/\/www.unipile.com\/gmail-api-key-vs-oauth\/","name":"Gmail API Anahtar\u0131 vs OAuth: Neden OAuth'u Atlayamazs\u0131n\u0131z (ve Yerine Ne Kullanmal\u0131s\u0131n\u0131z) - Unipile","isPartOf":{"@id":"https:\/\/www.unipile.com\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.unipile.com\/gmail-api-key-vs-oauth\/#primaryimage"},"image":{"@id":"https:\/\/www.unipile.com\/gmail-api-key-vs-oauth\/#primaryimage"},"thumbnailUrl":"https:\/\/www.unipile.com\/wp-content\/uploads\/2026\/05\/gmail-api-key-vs-oauth.png","datePublished":"2026-05-25T09:49:40+00:00","dateModified":"2026-05-25T09:50:32+00:00","description":"Gmail API anahtarlar\u0131n\u0131n ne zaman ve OAuth'un ne zaman kullan\u0131laca\u011f\u0131n\u0131 \u00f6\u011frenin. G\u00fcvenlik, kurulum kolayl\u0131\u011f\u0131 ve ger\u00e7ek d\u00fcnya senaryolar\u0131n\u0131 kar\u015f\u0131la\u015ft\u0131r\u0131n. \u00dcretim uygulamalar\u0131 i\u00e7in OAuth en iyi uygulamalar\u0131n\u0131 g\u00f6r\u00fcn. Olu\u015fturmaya ba\u015flay\u0131n.","breadcrumb":{"@id":"https:\/\/www.unipile.com\/gmail-api-key-vs-oauth\/#breadcrumb"},"inLanguage":"tr","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.unipile.com\/gmail-api-key-vs-oauth\/"]}]},{"@type":"ImageObject","inLanguage":"tr","@id":"https:\/\/www.unipile.com\/gmail-api-key-vs-oauth\/#primaryimage","url":"https:\/\/www.unipile.com\/wp-content\/uploads\/2026\/05\/gmail-api-key-vs-oauth.png","contentUrl":"https:\/\/www.unipile.com\/wp-content\/uploads\/2026\/05\/gmail-api-key-vs-oauth.png","width":2400,"height":1260,"caption":"Gmail API Key vs OAuth: why OAuth is required and how to implement it"},{"@type":"BreadcrumbList","@id":"https:\/\/www.unipile.com\/gmail-api-key-vs-oauth\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Accueil","item":"https:\/\/www.unipile.com\/"},{"@type":"ListItem","position":2,"name":"Gmail API Key vs OAuth: Why You Can’t Skip OAuth (and What to Use Instead)"}]},{"@type":"WebSite","@id":"https:\/\/www.unipile.com\/#website","url":"https:\/\/www.unipile.com\/","name":"Unipile","description":"Mesajla\u015fma ve E-postay\u0131 Entegre Edin, API ile Kolayca Ba\u011flan\u0131n","publisher":{"@id":"https:\/\/www.unipile.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.unipile.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"tr"},{"@type":"Organization","@id":"https:\/\/www.unipile.com\/#organization","name":"Unipile","url":"https:\/\/www.unipile.com\/","logo":{"@type":"ImageObject","inLanguage":"tr","@id":"https:\/\/www.unipile.com\/#\/schema\/logo\/image\/","url":"https:\/\/www.unipile.com\/wp-content\/uploads\/2021\/05\/logo-unipile.png","contentUrl":"https:\/\/www.unipile.com\/wp-content\/uploads\/2021\/05\/logo-unipile.png","width":200,"height":49,"caption":"Unipile"},"image":{"@id":"https:\/\/www.unipile.com\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/unipilefr","https:\/\/x.com\/UnipileAPI","https:\/\/www.linkedin.com\/company\/unipile\/"]},{"@type":"Person","@id":"https:\/\/www.unipile.com\/#\/schema\/person\/a2ac44e22bdc27d497ce8b58716a673e","name":"Damien Girardeau","image":{"@type":"ImageObject","inLanguage":"tr","@id":"https:\/\/secure.gravatar.com\/avatar\/12dd140720736a8db29f540c42a17d2680cd54a04fb26bb7b55423c179b065a9?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/12dd140720736a8db29f540c42a17d2680cd54a04fb26bb7b55423c179b065a9?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/12dd140720736a8db29f540c42a17d2680cd54a04fb26bb7b55423c179b065a9?s=96&d=mm&r=g","caption":"Damien Girardeau"}}]}},"_links":{"self":[{"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/posts\/278929","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/comments?post=278929"}],"version-history":[{"count":4,"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/posts\/278929\/revisions"}],"predecessor-version":[{"id":278948,"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/posts\/278929\/revisions\/278948"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/media\/278949"}],"wp:attachment":[{"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/media?parent=278929"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/categories?post=278929"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/tags?post=278929"},{"taxonomy":"post_folder","embeddable":true,"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/post_folder?post=278929"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}