Unipile – Send Email via API in Python TOC<\/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 { margin: 0; padding: 0; background: #f4f5f7; font-family: 'Inter', sans-serif;}<\/style><\/head><body><link href=\"https:\/\/fonts.googleapis.com\/css2?family=Inter:wght@400;500;600;700&family=Poppins:wght@700;800&display=swap\" rel=\"stylesheet\"><style>#unipile-toc,#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 { all: initial !important; 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 .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 !important; margin-top: 22px !important; padding-top: 22px !important; border-top: 1px solid #e5e7eb !important; } #unipile-toc.utc-collapsed .utc-grid { max-height: 0 !important; margin-top: 0 !important; padding-top: 0 !important; border-top: none !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><div id=\"unipile-toc\" class=\"utc-collapsed\"> <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\"> <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\">Getting Started<\/span> <div class=\"utc-link-list\"> <a class=\"utc-link\" href=\"#pe-why\"> <span class=\"utc-num\">01<\/span> <span class=\"utc-link-text\">Why Send Email via API<\/span> <\/a> <a class=\"utc-link\" href=\"#pe-prereq\"> <span class=\"utc-num\">02<\/span> <span class=\"utc-link-text\">Prerequisites & Setup<\/span> <\/a> <a class=\"utc-link\" href=\"#pe-methods\"> <span class=\"utc-num\">03<\/span> <span class=\"utc-link-text\">Choosing Your Method<\/span> <\/a> <\/div> <\/div>  <div class=\"utc-col\"> <span class=\"utc-col-label\">Provider Examples<\/span> <div class=\"utc-link-list\"> <a class=\"utc-link\" href=\"#pe-gmail\"> <span class=\"utc-num\">04<\/span> <span class=\"utc-link-text\">Sending via Gmail<\/span> <\/a> <a class=\"utc-link\" href=\"#pe-outlook\"> <span class=\"utc-num\">05<\/span> <span class=\"utc-link-text\">Sending via Outlook<\/span> <\/a> <a class=\"utc-link\" href=\"#pe-smtp\"> <span class=\"utc-num\">06<\/span> <span class=\"utc-link-text\">Sending via SMTP<\/span> <\/a> <\/div> <\/div>  <div class=\"utc-col\"> <span class=\"utc-col-label\">Going Further<\/span> <div class=\"utc-link-list\"> <a class=\"utc-link\" href=\"#pe-attachments\"> <span class=\"utc-num\">07<\/span> <span class=\"utc-link-text\">Attachments & HTML Emails<\/span> <\/a> <a class=\"utc-link\" href=\"#pe-errors\"> <span class=\"utc-num\">08<\/span> <span class=\"utc-link-text\">Error Handling & Delivery<\/span> <\/a> <\/div> <\/div>  <div class=\"utc-col\"> <span class=\"utc-col-label\">Help & Resources<\/span> <div class=\"utc-link-list\"> <a class=\"utc-link\" href=\"#pe-unipile\"> <span class=\"utc-num\">09<\/span> <span class=\"utc-link-text\">Send with Unipile<span class=\"utc-tag-best\">Best<\/span><\/span> <\/a> <a class=\"utc-link\" href=\"#pe-faq\"> <span class=\"utc-num utc-num-faq\">FAQ<\/span> <span class=\"utc-link-text\">Frequently Asked Questions<\/span> <\/a> <\/div> <\/div> <\/div> <\/div><\/div><script>(function(){ var toc = document.getElementById('unipile-toc'); if (!toc) return; var toggleBtn = toc.querySelector('.utc-toggle'); var toggleLabel = toc.querySelector('.utc-toggle-label'); if (toggleBtn) { toggleBtn.addEventListener('click', function(){ var isCollapsed = toc.classList.toggle('utc-collapsed'); if (toggleLabel) toggleLabel.textContent = isCollapsed ? 'Show' : 'Hide'; }); \/\/ Mobile: rester ferm\u00e9. Desktop: ouvrir (la grille s'affiche toujours >700px). if (window.innerWidth > 700) { toc.classList.remove('utc-collapsed'); if (toggleLabel) toggleLabel.textContent = 'Hide'; } else { toc.classList.add('utc-collapsed'); if (toggleLabel) toggleLabel.textContent = 'Show'; } } 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' }); } }); }); 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 Scopes 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; }#unipile-gas-hero,#unipile-gas-hero *,#unipile-gas-hero *::before,#unipile-gas-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;}#unipile-gas-hero { padding: 64px 20px 60px !important; overflow: hidden !important;}#unipile-gas-hero .gas-hero-inner { max-width: 1100px !important; width: 100% !important; margin: 0 auto !important; display: grid !important; grid-template-columns: 1fr 1fr !important; gap: 56px !important; align-items: center !important;}\/* Empeche les colonnes Grid de deborder a cause du contenu non-cassable (code en white-space: pre) *\/#unipile-gas-hero .gas-hero-inner > div { min-width: 0 !important;}#unipile-gas-hero .gas-eyebrow { 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; width: fit-content !important; margin-bottom: 20px !important;}#unipile-gas-hero .gas-eyebrow-dot { width: 7px !important; height: 7px !important; background: #3BB98B !important; border-radius: 50% !important; flex-shrink: 0 !important; display: inline-block !important;}#unipile-gas-hero h2.gas-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;}#unipile-gas-hero h2.gas-h1 .gas-accent { color: #3BB98B !important;}#unipile-gas-hero .gas-desc { font-size: 16px !important; line-height: 1.75 !important; color: #383838 !important; margin-bottom: 28px !important;}#unipile-gas-hero .gas-desc code { font-family: 'Courier New', monospace !important; background: rgba(15,39,54,0.06) !important; color: #0f2736 !important; padding: 1px 6px !important; border-radius: 4px !important; font-size: 13.5px !important; white-space: nowrap !important;}#unipile-gas-hero .gas-meta { display: flex !important; align-items: center !important; gap: 16px !important; flex-wrap: wrap !important; margin-bottom: 28px !important;}#unipile-gas-hero .gas-meta-item { display: flex !important; align-items: center !important; gap: 6px !important; font-size: 13px !important; color: #718096 !important;}#unipile-gas-hero .gas-meta-item svg { width: 14px !important; height: 14px !important; stroke: #3BB98B !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important; flex-shrink: 0 !important;}#unipile-gas-hero .gas-meta-sep { width: 4px !important; height: 4px !important; background: #cbd5e0 !important; border-radius: 50% !important; flex-shrink: 0 !important; display: inline-block !important;}#unipile-gas-hero .gas-tags { display: flex !important; flex-wrap: wrap !important; gap: 8px !important; margin-bottom: 32px !important;}#unipile-gas-hero .gas-tag { background: #ffffff !important; color: #4a5568 !important; padding: 5px 12px !important; border-radius: 6px !important; font-size: 12px !important; font-weight: 500 !important; border: 1px solid #e2e8f0 !important;}#unipile-gas-hero .gas-actions { display: flex !important; align-items: center !important; gap: 14px !important; flex-wrap: wrap !important;}#unipile-gas-hero .gas-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: 15px !important; font-weight: 600 !important; border: 2px solid #DDDF4C !important; transition: all 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important;}#unipile-gas-hero .gas-cta-primary:hover { transform: translateY(-5px) !important;}#unipile-gas-hero .gas-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; flex-shrink: 0 !important;}#unipile-gas-hero .gas-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: 15px !important; font-weight: 600 !important; border: 2px solid #0f2736 !important; transition: all 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important;}#unipile-gas-hero .gas-cta-secondary:hover { background: #0f2736 !important; color: #ffffff !important;}\/* Code mockup *\/#unipile-gas-hero .gas-code-wrap { border-radius: 14px !important; overflow: hidden !important; background: #0d1117 !important; max-width: 100% !important;}#unipile-gas-hero .gas-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;}#unipile-gas-hero .gas-dot { width: 12px !important; height: 12px !important; border-radius: 50% !important; display: inline-block !important; flex-shrink: 0 !important;}#unipile-gas-hero .gas-dot-r { background: #ff5f57 !important; }#unipile-gas-hero .gas-dot-y { background: #febc2e !important; }#unipile-gas-hero .gas-dot-g { background: #28c840 !important; }#unipile-gas-hero .gas-filename { color: #8b949e !important; font-size: 13px !important; margin-left: 6px !important; font-family: 'Courier New', monospace !important;}#unipile-gas-hero .gas-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;}#unipile-gas-hero .gas-pre code { font-family: 'Courier New', monospace !important; white-space: pre !important; display: block !important;}#unipile-gas-hero .gc { color: #8b949e !important; }#unipile-gas-hero .gk { color: #ff7b72 !important; }#unipile-gas-hero .gfn { color: #d2a8ff !important; }#unipile-gas-hero .gs { color: #a5d6ff !important; }#unipile-gas-hero .gw { color: #e6edf3 !important; }#unipile-gas-hero .gn { color: #79c0ff !important; }#unipile-gas-hero .gas-scope-tag { display: inline-block !important; background: rgba(59, 185, 139, 0.15) !important; color: #3BB98B !important; padding: 2px 8px !important; border-radius: 4px !important; font-size: 11.5px !important; font-family: 'Courier New', monospace !important; font-weight: 600 !important; white-space: nowrap !important;}#unipile-gas-hero .gas-scope-list { padding: 16px 24px !important; background: #0d1117 !important; display: flex !important; flex-direction: column !important; gap: 8px !important; border-top: 1px solid rgba(255,255,255,0.06) !important;}#unipile-gas-hero .gas-scope-row { display: flex !important; align-items: center !important; gap: 10px !important; flex-wrap: wrap !important;}#unipile-gas-hero .gas-scope-label { font-size: 11.5px !important; color: #8b949e !important; font-family: 'Courier New', monospace !important;}#unipile-gas-hero .gas-scope-badge { display: inline-flex !important; align-items: center !important; gap: 4px !important; padding: 2px 8px !important; border-radius: 4px !important; font-size: 10px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.4px !important; font-family: 'Inter', sans-serif !important;}#unipile-gas-hero .gas-badge-restricted { background: rgba(234, 67, 53, 0.15) !important; color: #ea4335 !important;}#unipile-gas-hero .gas-badge-sensitive { background: rgba(251, 188, 4, 0.15) !important; color: #d97706 !important;}#unipile-gas-hero .gas-badge-basic { background: rgba(59, 185, 139, 0.15) !important; color: #2aaa7e !important;}@media (max-width: 900px) { #unipile-gas-hero { padding: 50px 20px !important; } #unipile-gas-hero .gas-hero-inner { grid-template-columns: 1fr !important; gap: 40px !important; } #unipile-gas-hero h2.gas-h1 { font-size: 32px !important; }}@media (max-width: 600px) { #unipile-gas-hero { padding: 40px 16px !important; } #unipile-gas-hero h2.gas-h1 { font-size: 28px !important; } #unipile-gas-hero .gas-desc { font-size: 15px !important; } #unipile-gas-hero .gas-actions { flex-direction: column !important; align-items: stretch !important; } #unipile-gas-hero .gas-cta-primary, #unipile-gas-hero .gas-cta-secondary { justify-content: center !important; width: 100% !important; } #unipile-gas-hero .gas-pre { padding: 18px 16px !important; font-size: 11.5px !important; line-height: 1.7 !important; } #unipile-gas-hero .gas-scope-list { padding: 14px 16px !important; }}@media (max-width: 400px) { #unipile-gas-hero h2.gas-h1 { font-size: 24px !important; } #unipile-gas-hero .gas-pre { font-size: 10.5px !important; }}<\/style><div id=\"unipile-gas-hero\"> <div class=\"gas-hero-inner\"> <div class=\"gas-hero-left\"> <div class=\"gas-eyebrow\"><span class=\"gas-eyebrow-dot\"><\/span><span>Gmail API Guide<\/span><\/div> <h2 class=\"gas-h1\">Gmail API Scopes Explained: Choose the <span class=\"gas-accent\">Right Permissions<\/span> for Your App<\/h2> <pee class=\"gas-desc\">Every Gmail API scope documented: from <code>gmail.readonly<\/code> to <code>mail.google.com<\/code>. Understand the 3 sensitivity levels, pick the minimum scope your app actually needs, and ship your OAuth flow faster.<\/pee> <div class=\"gas-actions\"> <a class=\"gas-cta-primary\" href=\"https:\/\/dashboard.unipile.com\/signup\/\" 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><\/a> <a class=\"gas-cta-secondary\" href=\"https:\/\/www.unipile.com\/email-api-guide\/\" target=\"_self\"><span>Email API Guide<\/span><\/a> <\/div> <\/div> <div class=\"gas-hero-right\"> <div class=\"gas-code-wrap\"> <div class=\"gas-editor-bar\"> <span class=\"gas-dot gas-dot-r\"><\/span> <span class=\"gas-dot gas-dot-y\"><\/span> <span class=\"gas-dot gas-dot-g\"><\/span> <span class=\"gas-filename\">gmail-oauth-scopes.js<\/span> <\/div> <div class=\"gas-pre\"><code><span class=\"gc\">\/\/ Request Gmail API scopes in OAuth flow<\/span><span class=\"gk\">const<\/span> <span class=\"gw\">SCOPES<\/span> <span class=\"gw\">=<\/span> <span class=\"gw\">[<\/span> <span class=\"gs\">'https:\/\/www.googleapis.com\/auth\/gmail.readonly'<\/span><span class=\"gw\">,<\/span> <span class=\"gs\">'https:\/\/www.googleapis.com\/auth\/gmail.send'<\/span><span class=\"gw\">,<\/span> <span class=\"gs\">'https:\/\/www.googleapis.com\/auth\/gmail.labels'<\/span><span class=\"gw\">,<\/span><span class=\"gw\">];<\/span><span class=\"gk\">const<\/span> <span class=\"gw\">authUrl<\/span> <span class=\"gw\">=<\/span> <span class=\"gw\">oauth2Client.<\/span><span class=\"gfn\">generateAuthUrl<\/span><span class=\"gw\">({<\/span> <span class=\"gw\">access_type:<\/span> <span class=\"gs\">'offline'<\/span><span class=\"gw\">,<\/span> <span class=\"gw\">scope:<\/span> <span class=\"gw\">SCOPES,<\/span> <span class=\"gw\">prompt:<\/span> <span class=\"gs\">'consent'<\/span><span class=\"gw\">,<\/span><span class=\"gw\">});<\/span><\/code><\/div> <div class=\"gas-scope-list\"> <div class=\"gas-scope-row\"> <span class=\"gas-scope-label\">gmail.readonly<\/span> <span class=\"gas-scope-badge gas-badge-restricted\"><span>Restricted<\/span><\/span> <\/div> <div class=\"gas-scope-row\"> <span class=\"gas-scope-label\">gmail.send<\/span> <span class=\"gas-scope-badge gas-badge-sensitive\"><span>Sensitive<\/span><\/span> <\/div> <div class=\"gas-scope-row\"> <span class=\"gas-scope-label\">gmail.labels<\/span> <span class=\"gas-scope-badge gas-badge-basic\"><span>Non-sensitive<\/span><\/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.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>#unipile-gas-what,#unipile-gas-what *,#unipile-gas-what *::before,#unipile-gas-what *::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;}#unipile-gas-what { background: #f4f5f7 !important; padding: 72px 20px !important;}#unipile-gas-what .gas-what-inner { max-width: 1100px !important; margin: 0 auto !important;}#unipile-gas-what .gas-eyebrow { 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; width: fit-content !important; margin-bottom: 16px !important;}#unipile-gas-what .gas-eyebrow-dot { width: 7px !important; height: 7px !important; background: #3BB98B !important; border-radius: 50% !important; flex-shrink: 0 !important; display: inline-block !important;}#unipile-gas-what 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;}#unipile-gas-what .gas-intro { font-size: 16px !important; line-height: 1.75 !important; color: #383838 !important; margin-bottom: 36px !important;}#unipile-gas-what .gas-definition-card { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; padding: 32px !important; margin-bottom: 32px !important; border-left: 4px solid #3BB98B !important;}#unipile-gas-what .gas-definition-label { font-size: 11px !important; font-weight: 700 !important; color: #94a3b8 !important; text-transform: uppercase !important; letter-spacing: 0.8px !important; margin-bottom: 12px !important; display: block !important;}#unipile-gas-what .gas-definition-text { font-size: 17px !important; line-height: 1.75 !important; color: #1e293b !important; font-weight: 400 !important;}#unipile-gas-what .gas-definition-text strong { color: #0f2736 !important; font-weight: 700 !important;}#unipile-gas-what .gas-why-grid { display: grid !important; grid-template-columns: repeat(3, 1fr) !important; gap: 20px !important; margin-bottom: 36px !important;}#unipile-gas-what .gas-why-card { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; padding: 24px !important;}#unipile-gas-what .gas-why-icon { width: 44px !important; height: 44px !important; border-radius: 10px !important; background: rgba(59, 185, 139, 0.12) !important; display: flex !important; align-items: center !important; justify-content: center !important; margin-bottom: 14px !important;}#unipile-gas-what .gas-why-icon svg { width: 22px !important; height: 22px !important; stroke: #3BB98B !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}#unipile-gas-what .gas-why-title { font-size: 15px !important; font-weight: 700 !important; color: #0f2736 !important; margin-bottom: 8px !important; display: block !important;}#unipile-gas-what .gas-why-text { font-size: 14px !important; line-height: 1.65 !important; color: #4a5568 !important;}#unipile-gas-what .gas-cta-strip { background: #0f2736 !important; border-radius: 16px !important; padding: 28px 32px !important; display: flex !important; align-items: center !important; justify-content: space-between !important; gap: 20px !important; flex-wrap: wrap !important;}#unipile-gas-what .gas-cta-strip-text { font-size: 16px !important; color: rgba(255,255,255,0.88) !important; line-height: 1.5 !important;}#unipile-gas-what .gas-cta-strip-text strong { color: #ffffff !important; font-weight: 700 !important;}#unipile-gas-what .gas-cta-btn { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: #DDDF4C !important; color: #0f2736 !important; padding: 12px 24px !important; border-radius: 8px !important; font-size: 14px !important; font-weight: 700 !important; border: 2px solid #DDDF4C !important; transition: all 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important; text-decoration: none !important;}#unipile-gas-what .gas-cta-btn:hover { transform: translateY(-5px) !important;}#unipile-gas-what .gas-cta-btn svg { width: 15px !important; height: 15px !important; stroke: currentColor !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) { #unipile-gas-what { padding: 56px 20px !important; } #unipile-gas-what h2 { font-size: 28px !important; } #unipile-gas-what .gas-why-grid { grid-template-columns: 1fr !important; } #unipile-gas-what .gas-cta-strip { flex-direction: column !important; text-align: center !important; } #unipile-gas-what .gas-cta-btn { width: 100% !important; justify-content: center !important; }}@media (max-width: 600px) { #unipile-gas-what { padding: 44px 16px !important; } #unipile-gas-what h2 { font-size: 26px !important; } #unipile-gas-what .gas-definition-card { padding: 24px 20px !important; }}<\/style><div id=\"unipile-gas-what\"> <span id=\"gas-what\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"gas-what-inner\"> <div class=\"gas-eyebrow\"><span class=\"gas-eyebrow-dot\"><\/span><span>Fundamentals<\/span><\/div> <h2>What Are Gmail API Scopes?<\/h2> <pee class=\"gas-intro\">Before writing a single line of OAuth code, you need to understand what Gmail API scopes are and why choosing the wrong one can block your app from going to production. This section gives you the foundational knowledge in under two minutes.<\/pee> <div class=\"gas-definition-card\"> <span class=\"gas-definition-label\">Definition<\/span> <pee class=\"gas-definition-text\"><strong>Gmail API scopes<\/strong> are OAuth 2.0 permission strings that define exactly which Gmail resources your application can access on behalf of a user. When a user authorizes your app, Google presents a consent screen listing the Gmail API scopes your app requested. The user grants or denies access based on those scopes. Once granted, your access token is limited to exactly the actions those scopes permit – nothing more.<\/pee> <\/div> <div class=\"gas-why-grid\"> <div class=\"gas-why-card\"> <div class=\"gas-why-icon\"> <svg viewBox=\"0 0 24 24\"><path d=\"M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10z\"\/><\/svg> <\/div> <span class=\"gas-why-title\">Security boundary<\/span> <pee class=\"gas-why-text\">Gmail API scopes create a hard boundary around what your token can do. Even if your server is compromised, an attacker with a <code>gmail.readonly<\/code> token cannot send or delete emails. Scopes are enforced server-side by Google.<\/pee> <\/div> <div class=\"gas-why-card\"> <div class=\"gas-why-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> <span class=\"gas-why-title\">Google verification gate<\/span> <pee class=\"gas-why-text\">Restricted Gmail API scopes require your app to pass Google’s security assessment before you can use them in production with more than 100 test users. The wrong scope choice can add weeks or months to your launch timeline.<\/pee> <\/div> <div class=\"gas-why-card\"> <div class=\"gas-why-icon\"> <svg viewBox=\"0 0 24 24\"><polyline points=\"22 12 18 12 15 21 9 3 6 12 2 12\"\/><\/svg> <\/div> <span class=\"gas-why-title\">User trust signal<\/span> <pee class=\"gas-why-text\">Requesting more Gmail API permissions than your app needs triggers a “This app wants broad access to your Google Account” warning. Minimal Gmail API scopes produce a simpler consent screen, increasing conversion and user trust.<\/pee> <\/div> <\/div> <div class=\"gas-cta-strip\"> <pee class=\"gas-cta-strip-text\"><strong>Skip scope management entirely.<\/strong> Unipile handles Gmail OAuth and scopes internally – your team focuses on product logic, not permission strings.<\/pee> <a class=\"gas-cta-btn\" href=\"https:\/\/dashboard.unipile.com\/signup\/\" 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><\/a> <\/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.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 Scope Sensitivity Levels<\/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-gas-levels,#unipile-gas-levels *,#unipile-gas-levels *::before,#unipile-gas-levels *::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;}#unipile-gas-levels { padding: 72px 20px !important; overflow: hidden !important;}#unipile-gas-levels .gas-levels-inner { max-width: 1100px !important; width: 100% !important; margin: 0 auto !important;}#unipile-gas-levels .gas-eyebrow { 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; width: fit-content !important; margin-bottom: 16px !important;}#unipile-gas-levels .gas-eyebrow-dot { width: 7px !important; height: 7px !important; background: #3BB98B !important; border-radius: 50% !important; flex-shrink: 0 !important; display: inline-block !important;}#unipile-gas-levels 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;}#unipile-gas-levels .gas-intro { font-size: 16px !important; line-height: 1.75 !important; color: #383838 !important; margin-bottom: 40px !important;}#unipile-gas-levels .gas-levels-grid { display: grid !important; grid-template-columns: repeat(3, 1fr) !important; gap: 20px !important; margin-bottom: 40px !important;}#unipile-gas-levels .gas-levels-grid > div { min-width: 0 !important;}#unipile-gas-levels .gas-level-card { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; padding: 28px !important; position: relative !important;}#unipile-gas-levels .gas-level-badge { 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; text-transform: uppercase !important; letter-spacing: 0.4px !important; margin-bottom: 16px !important; width: fit-content !important;}#unipile-gas-levels .gas-badge-ns { background: rgba(59, 185, 139, 0.12) !important; color: #2aaa7e !important;}#unipile-gas-levels .gas-badge-s { background: rgba(251, 188, 4, 0.15) !important; color: #d97706 !important;}#unipile-gas-levels .gas-badge-r { background: rgba(234, 67, 53, 0.12) !important; color: #dc2626 !important;}#unipile-gas-levels .gas-level-dot { width: 8px !important; height: 8px !important; border-radius: 50% !important; flex-shrink: 0 !important; display: inline-block !important;}#unipile-gas-levels .gas-dot-ns { background: #3BB98B !important; }#unipile-gas-levels .gas-dot-s { background: #f59e0b !important; }#unipile-gas-levels .gas-dot-r { background: #ef4444 !important; }#unipile-gas-levels .gas-level-title { font-family: 'Poppins', sans-serif !important; font-size: 18px !important; font-weight: 700 !important; color: #0f2736 !important; margin-bottom: 12px !important; display: block !important;}#unipile-gas-levels .gas-level-desc { font-size: 14px !important; line-height: 1.7 !important; color: #4a5568 !important; margin-bottom: 18px !important;}#unipile-gas-levels .gas-level-divider { height: 1px !important; background: #e5e7eb !important; margin-bottom: 16px !important;}#unipile-gas-levels .gas-level-meta-row { display: flex !important; align-items: flex-start !important; gap: 8px !important; margin-bottom: 10px !important;}#unipile-gas-levels .gas-level-meta-label { font-size: 11px !important; font-weight: 700 !important; color: #94a3b8 !important; text-transform: uppercase !important; letter-spacing: 0.5px !important; min-width: 80px !important; padding-top: 1px !important; flex-shrink: 0 !important; display: block !important;}#unipile-gas-levels .gas-level-meta-val { font-size: 13px !important; color: #383838 !important; line-height: 1.5 !important;}#unipile-gas-levels .gas-level-scopes { display: flex !important; flex-direction: column !important; gap: 6px !important; margin-top: 4px !important;}#unipile-gas-levels .gas-scope-chip { display: inline-block !important; background: #f4f5f7 !important; color: #383838 !important; padding: 3px 10px !important; border-radius: 5px !important; font-size: 12px !important; font-family: 'Courier New', monospace !important; font-weight: 500 !important; width: fit-content !important; max-width: 100% !important; overflow-wrap: break-word !important; word-break: break-all !important;}\/* ===== Desktop table ===== *\/#unipile-gas-levels .gas-comparison-table { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; overflow: hidden !important; margin-bottom: 32px !important; width: 100% !important;}#unipile-gas-levels .gas-comparison-table table { width: 100% !important; border-collapse: collapse !important;}#unipile-gas-levels .gas-comparison-table thead tr { background: #0f2736 !important;}#unipile-gas-levels .gas-comparison-table thead th { padding: 14px 18px !important; font-size: 12px !important; font-weight: 700 !important; color: rgba(255,255,255,0.85) !important; text-align: left !important; text-transform: uppercase !important; letter-spacing: 0.5px !important;}#unipile-gas-levels .gas-comparison-table tbody tr { border-bottom: 1px solid #f0f2f5 !important;}#unipile-gas-levels .gas-comparison-table tbody tr:last-child { border-bottom: none !important;}#unipile-gas-levels .gas-comparison-table tbody td { padding: 14px 18px !important; font-size: 14px !important; color: #383838 !important; vertical-align: middle !important;}#unipile-gas-levels .gas-comparison-table tbody tr:hover { background: #f8fafc !important;}#unipile-gas-levels .gas-tbl-badge { display: inline-flex !important; align-items: center !important; gap: 5px !important; padding: 4px 10px !important; border-radius: 12px !important; font-size: 11px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.3px !important; white-space: nowrap !important;}#unipile-gas-levels .tbl-ns { background: rgba(59, 185, 139, 0.12) !important; color: #2aaa7e !important;}#unipile-gas-levels .tbl-s { background: rgba(251, 188, 4, 0.15) !important; color: #d97706 !important;}#unipile-gas-levels .tbl-r { background: rgba(234, 67, 53, 0.12) !important; color: #dc2626 !important;}#unipile-gas-levels .gas-check { color: #3BB98B !important; font-weight: 700 !important; font-size: 16px !important;}#unipile-gas-levels .gas-cross { color: #ef4444 !important; font-weight: 700 !important; font-size: 16px !important;}#unipile-gas-levels .gas-partial { color: #f59e0b !important; font-weight: 700 !important; font-size: 16px !important;}\/* ===== Mobile cards (hidden on desktop) ===== *\/#unipile-gas-levels .gas-cmp-cards { display: none !important;}#unipile-gas-levels .gas-cmp-card { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 14px !important; overflow: hidden !important; margin-bottom: 14px !important;}#unipile-gas-levels .gas-cmp-card:last-child { margin-bottom: 0 !important;}#unipile-gas-levels .gas-cmp-card-head { background: #0f2736 !important; padding: 13px 16px !important;}#unipile-gas-levels .gas-cmp-card-title { font-size: 14px !important; font-weight: 700 !important; color: #ffffff !important; line-height: 1.4 !important;}#unipile-gas-levels .gas-cmp-row { display: flex !important; align-items: center !important; justify-content: space-between !important; gap: 12px !important; padding: 11px 16px !important; border-bottom: 1px solid #f0f2f5 !important;}#unipile-gas-levels .gas-cmp-row:last-child { border-bottom: none !important;}#unipile-gas-levels .gas-cmp-level { display: inline-flex !important; align-items: center !important; gap: 7px !important; font-size: 12px !important; font-weight: 600 !important; color: #4a5568 !important;}#unipile-gas-levels .gas-cmp-level .gas-level-dot { width: 7px !important; height: 7px !important;}#unipile-gas-levels .gas-cmp-val { font-size: 13px !important; color: #383838 !important; text-align: right !important; font-weight: 500 !important;}@media (max-width: 900px) { #unipile-gas-levels { padding: 56px 20px !important; } #unipile-gas-levels h2 { font-size: 28px !important; } #unipile-gas-levels .gas-levels-grid { grid-template-columns: 1fr !important; }}@media (max-width: 600px) { #unipile-gas-levels { padding: 44px 16px !important; } #unipile-gas-levels h2 { font-size: 26px !important; } #unipile-gas-levels .gas-level-card { padding: 22px !important; } \/* Switch table -> cards *\/ #unipile-gas-levels .gas-comparison-table { display: none !important; } #unipile-gas-levels .gas-cmp-cards { display: block !important; }}@media (max-width: 400px) { #unipile-gas-levels h2 { font-size: 22px !important; }}<\/style><div id=\"unipile-gas-levels\"> <span id=\"gas-levels\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"gas-levels-inner\"> <div class=\"gas-eyebrow\"><span class=\"gas-eyebrow-dot\"><\/span><span>Scope Classification<\/span><\/div> <h2>The 3 Sensitivity Levels Explained<\/h2> <pee class=\"gas-intro\">Google classifies all Gmail API scopes into 3 sensitivity levels. Each level determines the verification requirements before your app can go live. Understanding this classification is the most important decision you make when planning your Gmail integration.<\/pee> <div class=\"gas-levels-grid\"> <div class=\"gas-level-card\"> <div class=\"gas-level-badge gas-badge-ns\"><span class=\"gas-level-dot gas-dot-ns\"><\/span><span>Non-sensitive<\/span><\/div> <span class=\"gas-level-title\">Non-sensitive Scopes<\/span> <pee class=\"gas-level-desc\">The lowest risk tier. These scopes access limited, non-personal Gmail data. Google does not require a formal security assessment to use them in production.<\/pee> <div class=\"gas-level-divider\"><\/div> <div class=\"gas-level-meta-row\"> <span class=\"gas-level-meta-label\">Verification<\/span> <span class=\"gas-level-meta-val\">Standard OAuth app review only<\/span> <\/div> <div class=\"gas-level-meta-row\"> <span class=\"gas-level-meta-label\">Test users<\/span> <span class=\"gas-level-meta-val\">Unlimited once app is verified<\/span> <\/div> <div class=\"gas-level-meta-row\"> <span class=\"gas-level-meta-label\">Examples<\/span> <div class=\"gas-level-scopes\"> <span class=\"gas-scope-chip\">gmail.labels<\/span> <span class=\"gas-scope-chip\">gmail.addons.current.action.compose<\/span> <\/div> <\/div> <\/div> <div class=\"gas-level-card\"> <div class=\"gas-level-badge gas-badge-s\"><span class=\"gas-level-dot gas-dot-s\"><\/span><span>Sensitive<\/span><\/div> <span class=\"gas-level-title\">Sensitive Scopes<\/span> <pee class=\"gas-level-desc\">Medium risk tier. These scopes access Gmail message data that could expose personal information. Additional verification is required before production use.<\/pee> <div class=\"gas-level-divider\"><\/div> <div class=\"gas-level-meta-row\"> <span class=\"gas-level-meta-label\">Verification<\/span> <span class=\"gas-level-meta-val\">Google OAuth app verification required<\/span> <\/div> <div class=\"gas-level-meta-row\"> <span class=\"gas-level-meta-label\">Test users<\/span> <span class=\"gas-level-meta-val\">Up to 100 while in testing<\/span> <\/div> <div class=\"gas-level-meta-row\"> <span class=\"gas-level-meta-label\">Examples<\/span> <div class=\"gas-level-scopes\"> <span class=\"gas-scope-chip\">gmail.send<\/span> <span class=\"gas-scope-chip\">gmail.addons.current.message.readonly<\/span> <\/div> <\/div> <\/div> <div class=\"gas-level-card\"> <div class=\"gas-level-badge gas-badge-r\"><span class=\"gas-level-dot gas-dot-r\"><\/span><span>Restricted<\/span><\/div> <span class=\"gas-level-title\">Restricted Scopes<\/span> <pee class=\"gas-level-desc\">Highest risk tier. These scopes grant broad or sensitive access to Gmail data. Google requires a formal security assessment by an approved third-party auditor.<\/pee> <div class=\"gas-level-divider\"><\/div> <div class=\"gas-level-meta-row\"> <span class=\"gas-level-meta-label\">Verification<\/span> <span class=\"gas-level-meta-val\">Annual security assessment (~$500\/yr)<\/span> <\/div> <div class=\"gas-level-meta-row\"> <span class=\"gas-level-meta-label\">Test users<\/span> <span class=\"gas-level-meta-val\">Up to 100 while in testing<\/span> <\/div> <div class=\"gas-level-meta-row\"> <span class=\"gas-level-meta-label\">Examples<\/span> <div class=\"gas-level-scopes\"> <span class=\"gas-scope-chip\">gmail.readonly<\/span> <span class=\"gas-scope-chip\">gmail.modify<\/span> <span class=\"gas-scope-chip\">mail.google.com\/<\/span> <\/div> <\/div> <\/div> <\/div>  <div class=\"gas-comparison-table\"> <table> <thead> <tr> <th>Criteria<\/th> <th>Non-sensitive<\/th> <th>Sensitive<\/th> <th>Restricted<\/th> <\/tr> <\/thead> <tbody> <tr> <td>Accesses message body<\/td> <td><span class=\"gas-cross\">No<\/span><\/td> <td><span class=\"gas-partial\">Sometimes<\/span><\/td> <td><span class=\"gas-check\">Yes<\/span><\/td> <\/tr> <tr> <td>Security assessment required<\/td> <td><span class=\"gas-cross\">No<\/span><\/td> <td><span class=\"gas-cross\">No<\/span><\/td> <td><span class=\"gas-check\">Yes<\/span><\/td> <\/tr> <tr> <td>App review required<\/td> <td><span class=\"gas-check\">Yes<\/span><\/td> <td><span class=\"gas-check\">Yes<\/span><\/td> <td><span class=\"gas-check\">Yes<\/span><\/td> <\/tr> <tr> <td>Annual re-certification<\/td> <td><span class=\"gas-cross\">No<\/span><\/td> <td><span class=\"gas-cross\">No<\/span><\/td> <td><span class=\"gas-check\">Yes<\/span><\/td> <\/tr> <tr> <td>Consent screen warning level<\/td> <td>Standard<\/td> <td>Standard + disclosure<\/td> <td>Broad access warning<\/td> <\/tr> <tr> <td>Typical cost to verify<\/td> <td>Free<\/td> <td>Free<\/td> <td>~$500\/yr (assessor)<\/td> <\/tr> <\/tbody> <\/table> <\/div>  <div class=\"gas-cmp-cards\"> <div class=\"gas-cmp-card\"> <div class=\"gas-cmp-card-head\"><div class=\"gas-cmp-card-title\">Accesses message body<\/div><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-ns\"><\/span>Non-sensitive<\/span><span class=\"gas-cmp-val\"><span class=\"gas-cross\">No<\/span><\/span><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-s\"><\/span>Sensitive<\/span><span class=\"gas-cmp-val\"><span class=\"gas-partial\">Sometimes<\/span><\/span><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-r\"><\/span>Restricted<\/span><span class=\"gas-cmp-val\"><span class=\"gas-check\">Yes<\/span><\/span><\/div> <\/div> <div class=\"gas-cmp-card\"> <div class=\"gas-cmp-card-head\"><div class=\"gas-cmp-card-title\">Security assessment required<\/div><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-ns\"><\/span>Non-sensitive<\/span><span class=\"gas-cmp-val\"><span class=\"gas-cross\">No<\/span><\/span><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-s\"><\/span>Sensitive<\/span><span class=\"gas-cmp-val\"><span class=\"gas-cross\">No<\/span><\/span><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-r\"><\/span>Restricted<\/span><span class=\"gas-cmp-val\"><span class=\"gas-check\">Yes<\/span><\/span><\/div> <\/div> <div class=\"gas-cmp-card\"> <div class=\"gas-cmp-card-head\"><div class=\"gas-cmp-card-title\">App review required<\/div><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-ns\"><\/span>Non-sensitive<\/span><span class=\"gas-cmp-val\"><span class=\"gas-check\">Yes<\/span><\/span><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-s\"><\/span>Sensitive<\/span><span class=\"gas-cmp-val\"><span class=\"gas-check\">Yes<\/span><\/span><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-r\"><\/span>Restricted<\/span><span class=\"gas-cmp-val\"><span class=\"gas-check\">Yes<\/span><\/span><\/div> <\/div> <div class=\"gas-cmp-card\"> <div class=\"gas-cmp-card-head\"><div class=\"gas-cmp-card-title\">Annual re-certification<\/div><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-ns\"><\/span>Non-sensitive<\/span><span class=\"gas-cmp-val\"><span class=\"gas-cross\">No<\/span><\/span><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-s\"><\/span>Sensitive<\/span><span class=\"gas-cmp-val\"><span class=\"gas-cross\">No<\/span><\/span><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-r\"><\/span>Restricted<\/span><span class=\"gas-cmp-val\"><span class=\"gas-check\">Yes<\/span><\/span><\/div> <\/div> <div class=\"gas-cmp-card\"> <div class=\"gas-cmp-card-head\"><div class=\"gas-cmp-card-title\">Consent screen warning level<\/div><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-ns\"><\/span>Non-sensitive<\/span><span class=\"gas-cmp-val\">Standard<\/span><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-s\"><\/span>Sensitive<\/span><span class=\"gas-cmp-val\">Standard + disclosure<\/span><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-r\"><\/span>Restricted<\/span><span class=\"gas-cmp-val\">Broad access warning<\/span><\/div> <\/div> <div class=\"gas-cmp-card\"> <div class=\"gas-cmp-card-head\"><div class=\"gas-cmp-card-title\">Typical cost to verify<\/div><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-ns\"><\/span>Non-sensitive<\/span><span class=\"gas-cmp-val\">Free<\/span><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-s\"><\/span>Sensitive<\/span><span class=\"gas-cmp-val\">Free<\/span><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-r\"><\/span>Restricted<\/span><span class=\"gas-cmp-val\">~$500\/yr (assessor)<\/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>#unipile-gas-ref,#unipile-gas-ref *,#unipile-gas-ref *::before,#unipile-gas-ref *::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;}#unipile-gas-ref { background: #f4f5f7 !important; padding: 72px 20px !important;}#unipile-gas-ref .gas-ref-inner { max-width: 1100px !important; margin: 0 auto !important;}#unipile-gas-ref .gas-eyebrow { 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; width: fit-content !important; margin-bottom: 16px !important;}#unipile-gas-ref .gas-eyebrow-dot { width: 7px !important; height: 7px !important; background: #DDDF4C !important; border-radius: 50% !important; flex-shrink: 0 !important; display: inline-block !important;}#unipile-gas-ref 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;}#unipile-gas-ref .gas-intro { font-size: 16px !important; line-height: 1.75 !important; color: #383838 !important; margin-bottom: 40px !important;}#unipile-gas-ref .gas-section-label { display: flex !important; align-items: center !important; gap: 10px !important; margin-bottom: 16px !important;}#unipile-gas-ref .gas-section-badge { 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; text-transform: uppercase !important; letter-spacing: 0.4px !important; flex-shrink: 0 !important;}#unipile-gas-ref .sec-ns { background: rgba(59, 185, 139, 0.12) !important; color: #2aaa7e !important;}#unipile-gas-ref .sec-s { background: rgba(251, 188, 4, 0.15) !important; color: #d97706 !important;}#unipile-gas-ref .sec-r { background: rgba(234, 67, 53, 0.12) !important; color: #dc2626 !important;}#unipile-gas-ref .gas-sec-dot { width: 8px !important; height: 8px !important; border-radius: 50% !important; flex-shrink: 0 !important; display: inline-block !important;}#unipile-gas-ref .dot-ns { background: #3BB98B !important; }#unipile-gas-ref .dot-s { background: #f59e0b !important; }#unipile-gas-ref .dot-r { background: #ef4444 !important; }#unipile-gas-ref .gas-ref-table { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; overflow: hidden !important; margin-bottom: 32px !important; width: 100% !important;}#unipile-gas-ref .gas-ref-table table { width: 100% !important; border-collapse: collapse !important;}#unipile-gas-ref .gas-ref-table thead tr { background: #0f2736 !important;}#unipile-gas-ref .gas-ref-table thead th { padding: 14px 18px !important; font-size: 11px !important; font-weight: 700 !important; color: rgba(255,255,255,0.75) !important; text-align: left !important; text-transform: uppercase !important; letter-spacing: 0.6px !important;}#unipile-gas-ref .gas-ref-table tbody tr { border-bottom: 1px solid #f0f2f5 !important; transition: background 0.15s ease !important;}#unipile-gas-ref .gas-ref-table tbody tr:last-child { border-bottom: none !important;}#unipile-gas-ref .gas-ref-table tbody tr:hover { background: #f8fafc !important;}#unipile-gas-ref .gas-ref-table tbody td { padding: 14px 18px !important; font-size: 13.5px !important; color: #383838 !important; vertical-align: top !important;}#unipile-gas-ref .gas-ref-table .td-scope { font-family: 'Courier New', monospace !important; font-size: 12.5px !important; color: #0f2736 !important; font-weight: 600 !important; white-space: nowrap !important;}#unipile-gas-ref .gas-ref-table .td-access { min-width: 100px !important;}#unipile-gas-ref .gas-access-badge { display: inline-flex !important; align-items: center !important; gap: 4px !important; padding: 3px 9px !important; border-radius: 10px !important; font-size: 11px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.3px !important; white-space: nowrap !important;}#unipile-gas-ref .acc-ns { background: rgba(59, 185, 139, 0.12) !important; color: #2aaa7e !important; }#unipile-gas-ref .acc-s { background: rgba(251, 188, 4, 0.15) !important; color: #d97706 !important; }#unipile-gas-ref .acc-r { background: rgba(234, 67, 53, 0.12) !important; color: #dc2626 !important; }#unipile-gas-ref .gas-new-badge { display: inline-block !important; background: rgba(59, 185, 139, 0.12) !important; color: #2aaa7e !important; font-size: 9px !important; font-weight: 700 !important; padding: 1px 5px !important; border-radius: 3px !important; text-transform: uppercase !important; letter-spacing: 0.3px !important; vertical-align: middle !important; margin-left: 4px !important; font-family: 'Inter', sans-serif !important;}#unipile-gas-ref .gas-cta-strip { background: #0f2736 !important; border-radius: 16px !important; padding: 28px 32px !important; display: flex !important; align-items: center !important; justify-content: space-between !important; gap: 20px !important; flex-wrap: wrap !important;}#unipile-gas-ref .gas-cta-strip-text { font-size: 16px !important; color: rgba(255,255,255,0.88) !important; line-height: 1.5 !important;}#unipile-gas-ref .gas-cta-strip-text strong { color: #ffffff !important; font-weight: 700 !important;}#unipile-gas-ref .gas-cta-btn { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: #DDDF4C !important; color: #0f2736 !important; padding: 12px 24px !important; border-radius: 8px !important; font-size: 14px !important; font-weight: 700 !important; border: 2px solid #DDDF4C !important; transition: all 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important; text-decoration: none !important;}#unipile-gas-ref .gas-cta-btn:hover { transform: translateY(-5px) !important;}#unipile-gas-ref .gas-cta-btn svg { width: 15px !important; height: 15px !important; stroke: currentColor !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) { #unipile-gas-ref { padding: 56px 20px !important; } #unipile-gas-ref h2 { font-size: 28px !important; } #unipile-gas-ref .gas-cta-strip { flex-direction: column !important; text-align: center !important; } #unipile-gas-ref .gas-cta-btn { width: 100% !important; justify-content: center !important; }}@media (max-width: 600px) { #unipile-gas-ref { padding: 44px 16px !important; } #unipile-gas-ref h2 { font-size: 26px !important; } #unipile-gas-ref .gas-ref-table { overflow-x: auto !important; } #unipile-gas-ref .gas-ref-table table { min-width: 600px !important; }}<\/style><div id=\"unipile-gas-ref\"> <span id=\"gas-ref\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"gas-ref-inner\"> <div class=\"gas-eyebrow\"><span class=\"gas-eyebrow-dot\"><\/span><span>Full Reference<\/span><\/div> <h2>Full Gmail API Scope Reference<\/h2> <pee class=\"gas-intro\">The complete list of Gmail API scopes, grouped by sensitivity level. Use this table as your single reference when choosing gmail api permissions for your application. Scopes marked “2026” reflect the latest additions to Google’s scope list.<\/pee>  <div class=\"gas-section-label\"> <span class=\"gas-section-badge sec-ns\"><span class=\"gas-sec-dot dot-ns\"><\/span><span>Non-sensitive<\/span><\/span> <\/div> <div class=\"gas-ref-table\"> <table> <thead> <tr> <th>Scope URI<\/th> <th>Access Level<\/th> <th>What It Accesses<\/th> <th>When to Use<\/th> <\/tr> <\/thead> <tbody> <tr> <td class=\"td-scope\">gmail.addons.current.action.compose<\/td> <td class=\"td-access\"><span class=\"gas-access-badge acc-ns\"><span>Non-sensitive<\/span><\/span><\/td> <td>Allows add-ons to compose and send email during a compose action<\/td> <td>Gmail add-ons that draft or send email on behalf of user within the compose window<\/td> <\/tr> <tr> <td class=\"td-scope\">gmail.addons.current.message.action<\/td> <td class=\"td-access\"><span class=\"gas-access-badge acc-ns\"><span>Non-sensitive<\/span><\/span><\/td> <td>Allows add-ons to view the current email during a message action<\/td> <td>Gmail add-ons that react to a message action (archiving, labeling) in the message context<\/td> <\/tr> <tr> <td class=\"td-scope\">gmail.labels <span class=\"gas-new-badge\">2026<\/span><\/td> <td class=\"td-access\"><span class=\"gas-access-badge acc-ns\"><span>Non-sensitive<\/span><\/span><\/td> <td>See and edit labels (create, rename, delete), but not message content<\/td> <td>Apps that organize email with labels without needing to read message bodies<\/td> <\/tr> <\/tbody> <\/table> <\/div>  <div class=\"gas-section-label\"> <span class=\"gas-section-badge sec-s\"><span class=\"gas-sec-dot dot-s\"><\/span><span>Sensitive<\/span><\/span> <\/div> <div class=\"gas-ref-table\"> <table> <thead> <tr> <th>Scope URI<\/th> <th>Access Level<\/th> <th>What It Accesses<\/th> <th>When to Use<\/th> <\/tr> <\/thead> <tbody> <tr> <td class=\"td-scope\">gmail.addons.current.message.metadata<\/td> <td class=\"td-access\"><span class=\"gas-access-badge acc-s\"><span>Sensitive<\/span><\/span><\/td> <td>Email headers and metadata (From, To, Subject, Date) in add-on context – not message body<\/td> <td>Add-ons that display contextual information based on sender or subject without reading body<\/td> <\/tr> <tr> <td class=\"td-scope\">gmail.addons.current.message.readonly<\/td> <td class=\"td-access\"><span class=\"gas-access-badge acc-s\"><span>Sensitive<\/span><\/span><\/td> <td>Full read access to the current email including body and attachments, in add-on context<\/td> <td>Add-ons that analyze or extract data from the currently open message<\/td> <\/tr> <tr> <td class=\"td-scope\">gmail.send<\/td> <td class=\"td-access\"><span class=\"gas-access-badge acc-s\"><span>Sensitive<\/span><\/span><\/td> <td>Send email on behalf of the authenticated user – no read or modify access<\/td> <td>Apps that only send transactional or outreach emails and do not need to read inbox<\/td> <\/tr> <\/tbody> <\/table> <\/div>  <div class=\"gas-section-label\"> <span class=\"gas-section-badge sec-r\"><span class=\"gas-sec-dot dot-r\"><\/span><span>Restricted<\/span><\/span> <\/div> <div class=\"gas-ref-table\"> <table> <thead> <tr> <th>Scope URI<\/th> <th>Access Level<\/th> <th>What It Accesses<\/th> <th>When to Use<\/th> <\/tr> <\/thead> <tbody> <tr> <td class=\"td-scope\">mail.google.com\/<\/td> <td class=\"td-access\"><span class=\"gas-access-badge acc-r\"><span>Restricted<\/span><\/span><\/td> <td>Full mailbox access: read, compose, send, and permanently delete emails and settings<\/td> <td>Only when you need every Gmail capability in one scope – typically legacy integrations<\/td> <\/tr> <tr> <td class=\"td-scope\">gmail.readonly<\/td> <td class=\"td-access\"><span class=\"gas-access-badge acc-r\"><span>Restricted<\/span><\/span><\/td> <td>Read-only access to all messages, threads, labels, and settings – cannot send or modify<\/td> <td>Analytics, archiving, search, or email intelligence tools that only read inbox data<\/td> <\/tr> <tr> <td class=\"td-scope\">gmail.compose<\/td> <td class=\"td-access\"><span class=\"gas-access-badge acc-r\"><span>Restricted<\/span><\/span><\/td> <td>Create and manage drafts, and send those drafts – no access to existing emails<\/td> <td>Draft management tools, email composers, or apps that queue emails before sending<\/td> <\/tr> <tr> <td class=\"td-scope\">gmail.insert <span class=\"gas-new-badge\">2026<\/span><\/td> <td class=\"td-access\"><span class=\"gas-access-badge acc-r\"><span>Restricted<\/span><\/span><\/td> <td>Insert messages into Gmail mailbox only – cannot read or send existing emails<\/td> <td>Migration tools or systems that import emails into Gmail from external sources<\/td> <\/tr> <tr> <td class=\"td-scope\">gmail.modify<\/td> <td class=\"td-access\"><span class=\"gas-access-badge acc-r\"><span>Restricted<\/span><\/span><\/td> <td>Read, compose, send, and manage emails and labels – cannot permanently delete<\/td> <td>Full-featured email clients, CRM sync tools, helpdesk integrations needing read+send+label<\/td> <\/tr> <tr> <td class=\"td-scope\">gmail.metadata<\/td> <td class=\"td-access\"><span class=\"gas-access-badge acc-r\"><span>Restricted<\/span><\/span><\/td> <td>Headers and labels only – no access to email body or attachments<\/td> <td>Apps that categorize or route emails based on metadata without reading private content<\/td> <\/tr> <tr> <td class=\"td-scope\">gmail.settings.basic<\/td> <td class=\"td-access\"><span class=\"gas-access-badge acc-r\"><span>Restricted<\/span><\/span><\/td> <td>Manage basic Gmail settings: filters, forwarding rules, POP\/IMAP settings<\/td> <td>Email productivity tools that configure Gmail routing or filtering on behalf of users<\/td> <\/tr> <tr> <td class=\"td-scope\">gmail.settings.sharing<\/td> <td class=\"td-access\"><span class=\"gas-access-badge acc-r\"><span>Restricted<\/span><\/span><\/td> <td>Sensitive settings management: send-as aliases, delegates, vacation responders (domain admin only)<\/td> <td>Workspace admin tools only – requires domain administrator privileges to enable<\/td> <\/tr> <\/tbody> <\/table> <\/div> <div class=\"gas-cta-strip\"> <pee class=\"gas-cta-strip-text\"><strong>Don’t manage these gmail api scopes manually.<\/strong> Unipile’s Gmail integration handles OAuth scope requests, token refresh, and re-authorization flows automatically across your users’ linked accounts.<\/pee> <a class=\"gas-cta-btn\" href=\"https:\/\/dashboard.unipile.com\/signup\/\" target=\"_blank\"><span>Build your Gmail app<\/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><\/a> <\/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.4″ hover_enabled=”0″ global_colors_info=”{}” theme_builder_area=”post_content” sticky_enabled=”0″]<link href=\"https:\/\/fonts.googleapis.com\/css2?family=Inter:wght@400;500;600;700&family=Poppins:wght@700;800&display=swap\" rel=\"stylesheet\"><style>#unipile-gas-matrix,#unipile-gas-matrix *,#unipile-gas-matrix *::before,#unipile-gas-matrix *::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;}#unipile-gas-matrix { padding: 72px 20px !important;}#unipile-gas-matrix .gas-matrix-inner { max-width: 1100px !important; margin: 0 auto !important;}#unipile-gas-matrix .gas-eyebrow { 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; width: fit-content !important; margin-bottom: 16px !important;}#unipile-gas-matrix .gas-eyebrow-dot { width: 7px !important; height: 7px !important; background: #3BB98B !important; border-radius: 50% !important; flex-shrink: 0 !important; display: inline-block !important;}#unipile-gas-matrix 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;}#unipile-gas-matrix .gas-intro { font-size: 16px !important; line-height: 1.75 !important; color: #383838 !important; margin-bottom: 40px !important;}#unipile-gas-matrix .gas-matrix-table { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; overflow: hidden !important; margin-bottom: 40px !important; width: 100% !important;}#unipile-gas-matrix .gas-matrix-table table { width: 100% !important; border-collapse: collapse !important;}#unipile-gas-matrix .gas-matrix-table thead tr { background: #0f2736 !important;}#unipile-gas-matrix .gas-matrix-table thead th { padding: 14px 18px !important; font-size: 11px !important; font-weight: 700 !important; color: rgba(255,255,255,0.8) !important; text-align: left !important; text-transform: uppercase !important; letter-spacing: 0.6px !important;}#unipile-gas-matrix .gas-matrix-table tbody tr { border-bottom: 1px solid #f0f2f5 !important; transition: background 0.15s ease !important;}#unipile-gas-matrix .gas-matrix-table tbody tr:last-child { border-bottom: none !important;}#unipile-gas-matrix .gas-matrix-table tbody tr:hover { background: #f8fafc !important;}#unipile-gas-matrix .gas-matrix-table tbody td { padding: 14px 18px !important; font-size: 13.5px !important; color: #383838 !important; vertical-align: middle !important;}#unipile-gas-matrix .gas-matrix-table .td-usecase { font-weight: 600 !important; color: #0f2736 !important;}#unipile-gas-matrix .gas-scope-chip { display: inline-block !important; background: #f4f5f7 !important; color: #383838 !important; padding: 3px 9px !important; border-radius: 5px !important; font-size: 12px !important; font-family: 'Courier New', monospace !important; font-weight: 600 !important; white-space: nowrap !important; border: 1px solid #e5e7eb !important;}#unipile-gas-matrix .gas-risk-badge { display: inline-flex !important; align-items: center !important; gap: 4px !important; padding: 3px 9px !important; border-radius: 10px !important; font-size: 11px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.3px !important; white-space: nowrap !important;}#unipile-gas-matrix .risk-low { background: rgba(59, 185, 139, 0.12) !important; color: #2aaa7e !important; }#unipile-gas-matrix .risk-med { background: rgba(251, 188, 4, 0.15) !important; color: #d97706 !important; }#unipile-gas-matrix .risk-high { background: rgba(234, 67, 53, 0.12) !important; color: #dc2626 !important; }#unipile-gas-matrix .gas-tip-box { background: rgba(59, 185, 139, 0.08) !important; border: 1px solid rgba(59, 185, 139, 0.25) !important; border-radius: 12px !important; padding: 20px 24px !important; display: flex !important; align-items: flex-start !important; gap: 14px !important; margin-bottom: 32px !important;}#unipile-gas-matrix .gas-tip-icon { width: 36px !important; height: 36px !important; border-radius: 8px !important; background: rgba(59, 185, 139, 0.15) !important; display: flex !important; align-items: center !important; justify-content: center !important; flex-shrink: 0 !important;}#unipile-gas-matrix .gas-tip-icon svg { width: 18px !important; height: 18px !important; stroke: #3BB98B !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}#unipile-gas-matrix .gas-tip-content {}#unipile-gas-matrix .gas-tip-title { font-size: 14px !important; font-weight: 700 !important; color: #0f2736 !important; margin-bottom: 6px !important; display: block !important;}#unipile-gas-matrix .gas-tip-text { font-size: 14px !important; line-height: 1.65 !important; color: #4a5568 !important;}#unipile-gas-matrix .gas-tip-text a { color: #2aaa7e !important; text-decoration: underline !important;}@media (max-width: 900px) { #unipile-gas-matrix { padding: 56px 20px !important; } #unipile-gas-matrix h2 { font-size: 28px !important; } #unipile-gas-matrix .gas-matrix-table { overflow-x: auto !important; } #unipile-gas-matrix .gas-matrix-table table { min-width: 650px !important; }}@media (max-width: 600px) { #unipile-gas-matrix { padding: 44px 16px !important; } #unipile-gas-matrix h2 { font-size: 26px !important; }}<\/style><div id=\"unipile-gas-matrix\"> <span id=\"gas-matrix\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"gas-matrix-inner\"> <div class=\"gas-eyebrow\"><span class=\"gas-eyebrow-dot\"><\/span><span>Use Case Matrix<\/span><\/div> <h2>Which Gmail API Scope Do You Need?<\/h2> <pee class=\"gas-intro\">The single most important principle in Gmail API scope selection is the principle of minimum access: request only the gmail api permissions your app actually needs. This table maps common use cases to the minimum recommended scope, helping you avoid unnecessary verification overhead and protect user trust.<\/pee> <div class=\"gas-matrix-table\"> <table> <thead> <tr> <th>Use Case<\/th> <th>Minimum Scope<\/th> <th>Verification Level<\/th> <th>Notes<\/th> <\/tr> <\/thead> <tbody> <tr> <td class=\"td-usecase\">Send emails only (no inbox read)<\/td> <td><span class=\"gas-scope-chip\">gmail.send<\/span><\/td> <td><span class=\"gas-risk-badge risk-med\"><span>Sensitive<\/span><\/span><\/td> <td>Ideal for transactional or outreach tools. No access to existing messages.<\/td> <\/tr> <tr> <td class=\"td-usecase\">Read inbox for analytics or search<\/td> <td><span class=\"gas-scope-chip\">gmail.readonly<\/span><\/td> <td><span class=\"gas-risk-badge risk-high\"><span>Restricted<\/span><\/span><\/td> <td>Full read access to all messages and settings. Requires annual security assessment.<\/td> <\/tr> <tr> <td class=\"td-usecase\">Full email client (read + send + label)<\/td> <td><span class=\"gas-scope-chip\">gmail.modify<\/span><\/td> <td><span class=\"gas-risk-badge risk-high\"><span>Restricted<\/span><\/span><\/td> <td>Preferred over <code>mail.google.com\/<\/code> as it excludes permanent delete. Covers most CRM and helpdesk use cases.<\/td> <\/tr> <tr> <td class=\"td-usecase\">Archive or backup emails permanently<\/td> <td><span class=\"gas-scope-chip\">mail.google.com\/<\/span><\/td> <td><span class=\"gas-risk-badge risk-high\"><span>Restricted<\/span><\/span><\/td> <td>Only use when you truly need delete access. Triggers the broadest Google consent warning.<\/td> <\/tr> <tr> <td class=\"td-usecase\">Organize labels only<\/td> <td><span class=\"gas-scope-chip\">gmail.labels<\/span><\/td> <td><span class=\"gas-risk-badge risk-low\"><span>Non-sensitive<\/span><\/span><\/td> <td>New in 2026. Minimal permissions for label management without reading messages.<\/td> <\/tr> <tr> <td class=\"td-usecase\">Draft management (queue before send)<\/td> <td><span class=\"gas-scope-chip\">gmail.compose<\/span><\/td> <td><span class=\"gas-risk-badge risk-high\"><span>Restricted<\/span><\/span><\/td> <td>Access to drafts and send capability, but no read access to existing messages.<\/td> <\/tr> <tr> <td class=\"td-usecase\">Metadata routing or categorization<\/td> <td><span class=\"gas-scope-chip\">gmail.metadata<\/span><\/td> <td><span class=\"gas-risk-badge risk-high\"><span>Restricted<\/span><\/span><\/td> <td>Headers and labels only – no body access. Good for routing engines that respect message privacy.<\/td> <\/tr> <tr> <td class=\"td-usecase\">Email migration \/ import into Gmail<\/td> <td><span class=\"gas-scope-chip\">gmail.insert<\/span><\/td> <td><span class=\"gas-risk-badge risk-high\"><span>Restricted<\/span><\/span><\/td> <td>New in 2026. Insert-only access – better scoped alternative to <code>mail.google.com\/<\/code> for import tools.<\/td> <\/tr> <tr> <td class=\"td-usecase\">Configure Gmail filters and forwarding<\/td> <td><span class=\"gas-scope-chip\">gmail.settings.basic<\/span><\/td> <td><span class=\"gas-risk-badge risk-high\"><span>Restricted<\/span><\/span><\/td> <td>Manage filters, labels, forwarding rules. No message body access.<\/td> <\/tr> <tr> <td class=\"td-usecase\">Gmail add-on: display sender context<\/td> <td><span class=\"gas-scope-chip\">gmail.addons.current.message.metadata<\/span><\/td> <td><span class=\"gas-risk-badge risk-med\"><span>Sensitive<\/span><\/span><\/td> <td>Headers only in add-on context. Avoids full message read access.<\/td> <\/tr> <\/tbody> <\/table> <\/div> <div class=\"gas-tip-box\"> <div class=\"gas-tip-icon\"> <svg viewBox=\"0 0 24 24\"><path d=\"M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10z\"\/><\/svg> <\/div> <div class=\"gas-tip-content\"> <span class=\"gas-tip-title\">Combine scopes only when necessary<\/span> <pee class=\"gas-tip-text\">You can combine multiple gmail api scopes in a single OAuth request (e.g., <code>gmail.send<\/code> + <code>gmail.labels<\/code>), but each scope adds to the consent screen disclosure. Always audit your scope list before going to production. If you are building a full Gmail sync product, the <a href=\"https:\/\/www.unipile.com\/oauth-email-api\/\" target=\"_self\">OAuth Email API guide<\/a> covers the complete flow including token management and scope re-authorization.<\/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>#unipile-gas-restricted,#unipile-gas-restricted *,#unipile-gas-restricted *::before,#unipile-gas-restricted *::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;}#unipile-gas-restricted { background: #f4f5f7 !important; padding: 72px 20px !important;}#unipile-gas-restricted .gas-rest-inner { max-width: 1100px !important; margin: 0 auto !important;}#unipile-gas-restricted .gas-eyebrow { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: rgba(234, 67, 53, 0.1) !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; width: fit-content !important; margin-bottom: 16px !important;}#unipile-gas-restricted .gas-eyebrow-dot { width: 7px !important; height: 7px !important; background: #ef4444 !important; border-radius: 50% !important; flex-shrink: 0 !important; display: inline-block !important;}#unipile-gas-restricted 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;}#unipile-gas-restricted .gas-intro { font-size: 16px !important; line-height: 1.75 !important; color: #383838 !important; margin-bottom: 40px !important;}#unipile-gas-restricted .gas-steps-grid { display: grid !important; grid-template-columns: repeat(2, 1fr) !important; gap: 20px !important; margin-bottom: 36px !important;}#unipile-gas-restricted .gas-step-card { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; padding: 24px !important; display: flex !important; gap: 16px !important;}#unipile-gas-restricted .gas-step-num { width: 40px !important; height: 40px !important; border-radius: 10px !important; background: rgba(221, 223, 76, 0.18) !important; color: #8a8c2e !important; display: flex !important; align-items: center !important; justify-content: center !important; font-family: 'Poppins', sans-serif !important; font-size: 16px !important; font-weight: 700 !important; flex-shrink: 0 !important;}#unipile-gas-restricted .gas-step-content {}#unipile-gas-restricted .gas-step-title { font-size: 15px !important; font-weight: 700 !important; color: #0f2736 !important; margin-bottom: 8px !important; display: block !important;}#unipile-gas-restricted .gas-step-text { font-size: 14px !important; line-height: 1.65 !important; color: #4a5568 !important;}#unipile-gas-restricted .gas-step-text a { color: #2aaa7e !important; text-decoration: underline !important;}#unipile-gas-restricted .gas-avoidance-card { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; padding: 32px !important; margin-bottom: 32px !important;}#unipile-gas-restricted .gas-avoidance-title { font-family: 'Poppins', sans-serif !important; font-size: 20px !important; font-weight: 700 !important; color: #0f2736 !important; margin-bottom: 20px !important; display: block !important;}#unipile-gas-restricted .gas-avoid-list { display: flex !important; flex-direction: column !important; gap: 14px !important;}#unipile-gas-restricted .gas-avoid-item { display: flex !important; align-items: flex-start !important; gap: 12px !important;}#unipile-gas-restricted .gas-avoid-icon { width: 28px !important; height: 28px !important; border-radius: 6px !important; background: rgba(59, 185, 139, 0.12) !important; display: flex !important; align-items: center !important; justify-content: center !important; flex-shrink: 0 !important; margin-top: 1px !important;}#unipile-gas-restricted .gas-avoid-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;}#unipile-gas-restricted .gas-avoid-text { font-size: 14px !important; line-height: 1.65 !important; color: #383838 !important;}#unipile-gas-restricted .gas-avoid-text strong { color: #0f2736 !important; font-weight: 700 !important;}#unipile-gas-restricted .gas-avoid-text 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;}#unipile-gas-restricted .gas-cta-strip { background: #0f2736 !important; border-radius: 16px !important; padding: 28px 32px !important; display: flex !important; align-items: center !important; justify-content: space-between !important; gap: 20px !important; flex-wrap: wrap !important;}#unipile-gas-restricted .gas-cta-strip-text { font-size: 16px !important; color: rgba(255,255,255,0.88) !important; line-height: 1.5 !important;}#unipile-gas-restricted .gas-cta-strip-text strong { color: #ffffff !important; font-weight: 700 !important;}#unipile-gas-restricted .gas-cta-btn { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: #DDDF4C !important; color: #0f2736 !important; padding: 12px 24px !important; border-radius: 8px !important; font-size: 14px !important; font-weight: 700 !important; border: 2px solid #DDDF4C !important; transition: all 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important; text-decoration: none !important;}#unipile-gas-restricted .gas-cta-btn:hover { transform: translateY(-5px) !important;}#unipile-gas-restricted .gas-cta-btn svg { width: 15px !important; height: 15px !important; stroke: currentColor !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) { #unipile-gas-restricted { padding: 56px 20px !important; } #unipile-gas-restricted h2 { font-size: 28px !important; } #unipile-gas-restricted .gas-steps-grid { grid-template-columns: 1fr !important; } #unipile-gas-restricted .gas-cta-strip { flex-direction: column !important; text-align: center !important; } #unipile-gas-restricted .gas-cta-btn { width: 100% !important; justify-content: center !important; }}@media (max-width: 600px) { #unipile-gas-restricted { padding: 44px 16px !important; } #unipile-gas-restricted h2 { font-size: 26px !important; } #unipile-gas-restricted .gas-avoidance-card { padding: 22px 18px !important; }}<\/style><div id=\"unipile-gas-restricted\"> <span id=\"gas-restricted\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"gas-rest-inner\"> <div class=\"gas-eyebrow\"><span class=\"gas-eyebrow-dot\"><\/span><span>Verification Process<\/span><\/div> <h2>Restricted Scope Verification: What It Means for Your App<\/h2> <pee class=\"gas-intro\">If your app needs any restricted Gmail API scope – including <code>gmail.readonly<\/code>, <code>gmail.modify<\/code>, or <code>mail.google.com\/<\/code> – you must complete Google’s security assessment process before going live beyond 100 test users. Here is what that process looks like and how to minimize the overhead.<\/pee> <div class=\"gas-steps-grid\"> <div class=\"gas-step-card\"> <div class=\"gas-step-num\">1<\/div> <div class=\"gas-step-content\"> <span class=\"gas-step-title\">Register your OAuth app in Google Cloud Console<\/span> <pee class=\"gas-step-text\">Create a project, enable the Gmail API, and configure the OAuth consent screen. Fill in all required fields: app name, support email, authorized domains, and privacy policy URL. This step is required for any Gmail API scope level.<\/pee> <\/div> <\/div> <div class=\"gas-step-card\"> <div class=\"gas-step-num\">2<\/div> <div class=\"gas-step-content\"> <span class=\"gas-step-title\">Submit for app review with restricted scopes declared<\/span> <pee class=\"gas-step-text\">In the OAuth consent screen, click “Prepare for Verification”. Declare each restricted Gmail API scope and provide a justification explaining why your app needs it. Google’s team reviews this before routing you to a security assessor.<\/pee> <\/div> <\/div> <div class=\"gas-step-card\"> <div class=\"gas-step-num\">3<\/div> <div class=\"gas-step-content\"> <span class=\"gas-step-title\">Complete the third-party security assessment<\/span> <pee class=\"gas-step-text\">Google routes restricted scope apps to an approved assessor (Leviathan Security, Coalfire, etc.). The assessment costs approximately $500\/year. You must provide a demo, explain data handling practices, and pass a technical review of your OAuth implementation.<\/pee> <\/div> <\/div> <div class=\"gas-step-card\"> <div class=\"gas-step-num\">4<\/div> <div class=\"gas-step-content\"> <span class=\"gas-step-title\">Annual re-certification for continued access<\/span> <pee class=\"gas-step-text\">Restricted Gmail API scopes require yearly re-certification. If you miss the renewal window, Google can revoke your app’s production access. Plan for this recurring cost and compliance cycle from day one of your Gmail integration architecture.<\/pee> <\/div> <\/div> <\/div> <div class=\"gas-avoidance-card\"> <span class=\"gas-avoidance-title\">How to avoid or minimize restricted scope verification<\/span> <div class=\"gas-avoid-list\"> <div class=\"gas-avoid-item\"> <div class=\"gas-avoid-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><\/div> <pee class=\"gas-avoid-text\"><strong>Choose <code>gmail.send<\/code> over <code>gmail.modify<\/code><\/strong> when your app only sends emails and does not need to read the inbox. <code>gmail.send<\/code> is a sensitive (not restricted) scope and skips the security assessment entirely.<\/pee> <\/div> <div class=\"gas-avoid-item\"> <div class=\"gas-avoid-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><\/div> <pee class=\"gas-avoid-text\"><strong>Use <code>gmail.metadata<\/code> instead of <code>gmail.readonly<\/code><\/strong> if your app routes or categorizes emails without reading body content. You still need verification, but the scope is narrower and easier to justify to Google.<\/pee> <\/div> <div class=\"gas-avoid-item\"> <div class=\"gas-avoid-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><\/div> <pee class=\"gas-avoid-text\"><strong>Use a platform that already holds Google verification.<\/strong> When you build on top of <a href=\"https:\/\/developer.unipile.com\/docs\/google-oauth\" target=\"_blank\">Unipile’s Gmail integration<\/a>, your app benefits from Unipile’s pre-verified OAuth credentials, so you do not need to go through the restricted scope assessment yourself. This is the fastest path to production for most SaaS products.<\/pee> <\/div> <div class=\"gas-avoid-item\"> <div class=\"gas-avoid-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><\/div> <pee class=\"gas-avoid-text\"><strong>Stay in the 100-user testing window<\/strong> during early development. You can test restricted Gmail API scopes with up to 100 Google accounts without completing the full verification. Add test accounts in the Google Cloud Console OAuth consent screen settings.<\/pee> <\/div> <\/div> <\/div> <div class=\"gas-cta-strip\"> <pee class=\"gas-cta-strip-text\"><strong>Skip the Google verification process entirely.<\/strong> Unipile’s hosted Gmail OAuth is already verified for restricted gmail api scopes – your linked accounts connect immediately without additional assessment.<\/pee> <a class=\"gas-cta-btn\" href=\"https:\/\/dashboard.unipile.com\/signup\/\" target=\"_blank\"><span>Start building today<\/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><\/a> <\/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.4″ hover_enabled=”0″ global_colors_info=”{}” theme_builder_area=”post_content” sticky_enabled=”0″]<link href=\"https:\/\/fonts.googleapis.com\/css2?family=Inter:wght@400;500;600;700&family=Poppins:wght@700;800&display=swap\" rel=\"stylesheet\"><style>#unipile-gas-code,#unipile-gas-code *,#unipile-gas-code *::before,#unipile-gas-code *::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;}#unipile-gas-code {  padding: 72px 20px !important;}#unipile-gas-code .gas-code-inner { max-width: 1100px !important; margin: 0 auto !important;}#unipile-gas-code .gas-eyebrow { 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; width: fit-content !important; margin-bottom: 16px !important;}#unipile-gas-code .gas-eyebrow-dot { width: 7px !important; height: 7px !important; background: #DDDF4C !important; border-radius: 50% !important; flex-shrink: 0 !important; display: inline-block !important;}#unipile-gas-code 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;}#unipile-gas-code .gas-intro { font-size: 16px !important; line-height: 1.75 !important; color: #383838 !important; margin-bottom: 40px !important;}#unipile-gas-code .gas-tabs { display: flex !important; gap: 8px !important; margin-bottom: 20px !important; flex-wrap: wrap !important;}#unipile-gas-code .gas-tab-btn { padding: 8px 20px !important; border-radius: 8px !important; font-size: 13px !important; font-weight: 600 !important; cursor: pointer !important; transition: all 0.2s ease !important; background: #f4f5f7 !important; color: #64748b !important; border: 1px solid #e5e7eb !important; display: inline-block !important;}#unipile-gas-code .gas-tab-btn.gas-tab-active { background: #0f2736 !important; color: #ffffff !important; border-color: #0f2736 !important;}#unipile-gas-code .gas-tab-panel { display: none !important;}#unipile-gas-code .gas-tab-panel.gas-panel-active { display: block !important;}#unipile-gas-code .gas-code-wrap { border-radius: 14px !important; overflow: hidden !important; background: #0d1117 !important; margin-bottom: 32px !important;}#unipile-gas-code .gas-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;}#unipile-gas-code .gas-dot { width: 12px !important; height: 12px !important; border-radius: 50% !important; display: inline-block !important; flex-shrink: 0 !important;}#unipile-gas-code .gas-dot-r { background: #ff5f57 !important; }#unipile-gas-code .gas-dot-y { background: #febc2e !important; }#unipile-gas-code .gas-dot-g { background: #28c840 !important; }#unipile-gas-code .gas-filename { color: #8b949e !important; font-size: 13px !important; margin-left: 6px !important; font-family: 'Courier New', monospace !important;}#unipile-gas-code .gas-pre { padding: 22px 24px !important; font-size: 13px !important; line-height: 1.85 !important; overflow-x: auto !important; background: #0d1117 !important;}#unipile-gas-code .gas-pre code { font-family: 'Courier New', monospace !important; white-space: pre !important; display: block !important;}#unipile-gas-code .gc { color: #8b949e !important; }#unipile-gas-code .gk { color: #ff7b72 !important; }#unipile-gas-code .gfn { color: #d2a8ff !important; }#unipile-gas-code .gs { color: #a5d6ff !important; }#unipile-gas-code .gw { color: #e6edf3 !important; }#unipile-gas-code .gn { color: #79c0ff !important; }#unipile-gas-code .gas-editor-ok { background: rgba(59, 185, 139, 0.1) !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;}#unipile-gas-code .gas-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;}#unipile-gas-code .gas-note-box { 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: flex-start !important; gap: 12px !important; margin-bottom: 32px !important;}#unipile-gas-code .gas-note-icon { flex-shrink: 0 !important; margin-top: 1px !important;}#unipile-gas-code .gas-note-icon svg { width: 18px !important; height: 18px !important; stroke: #3BB98B !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}#unipile-gas-code .gas-note-text { font-size: 14px !important; line-height: 1.65 !important; color: #383838 !important;}#unipile-gas-code .gas-note-text a { color: #2aaa7e !important; text-decoration: underline !important;}#unipile-gas-code .gas-note-text strong { color: #0f2736 !important; font-weight: 700 !important;}@media (max-width: 900px) { #unipile-gas-code { padding: 56px 20px !important; } #unipile-gas-code h2 { font-size: 28px !important; } #unipile-gas-code .gas-pre { overflow-x: auto !important; }}@media (max-width: 600px) { #unipile-gas-code { padding: 44px 16px !important; } #unipile-gas-code h2 { font-size: 26px !important; } #unipile-gas-code .gas-pre { font-size: 12px !important; padding: 18px 16px !important; }}<\/style><div id=\"unipile-gas-code\"> <span id=\"gas-code\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"gas-code-inner\"> <div class=\"gas-eyebrow\"><span class=\"gas-eyebrow-dot\"><\/span><span>Implementation<\/span><\/div> <h2>How to Request Gmail API Scopes in Your OAuth Flow<\/h2> <pee class=\"gas-intro\">Once you know which gmail oauth scopes your app needs, you declare them when generating the authorization URL. Here are working code examples in both Node.js and Python showing exactly how to pass gmail api permissions into the OAuth consent screen.<\/pee> <div class=\"gas-tabs\"> <button class=\"gas-tab-btn gas-tab-active\" data-gas-tab=\"node\"><span>Node.js<\/span><\/button> <button class=\"gas-tab-btn\" data-gas-tab=\"python\"><span>Python<\/span><\/button> <\/div> <div class=\"gas-tab-panel gas-panel-active\" data-gas-panel=\"node\"> <div class=\"gas-code-wrap\"> <div class=\"gas-editor-bar\"> <span class=\"gas-dot gas-dot-r\"><\/span> <span class=\"gas-dot gas-dot-y\"><\/span> <span class=\"gas-dot gas-dot-g\"><\/span> <span class=\"gas-filename\">gmail-scopes-node.js<\/span> <\/div> <div class=\"gas-pre\"><code><span class=\"gc\">\/\/ Node.js \u2014 Gmail API scopes in OAuth flow<\/span><span class=\"gc\">\/\/ Uses google-auth-library (official Google client)<\/span><span class=\"gk\">const<\/span> <span class=\"gw\">{ OAuth2Client } =<\/span> <span class=\"gfn\">require<\/span><span class=\"gw\">(<\/span><span class=\"gs\">'google-auth-library'<\/span><span class=\"gw\">);<\/span><span class=\"gk\">const<\/span> <span class=\"gw\">oauth2Client =<\/span> <span class=\"gk\">new<\/span> <span class=\"gfn\">OAuth2Client<\/span><span class=\"gw\">(<\/span> <span class=\"gw\">process.env.GOOGLE_CLIENT_ID,<\/span> <span class=\"gw\">process.env.GOOGLE_CLIENT_SECRET,<\/span> <span class=\"gw\">process.env.REDIRECT_URI<\/span><span class=\"gw\">);<\/span><span class=\"gc\">\/\/ Define the gmail api scopes your app needs<\/span><span class=\"gc\">\/\/ Principle: request minimum scope required<\/span><span class=\"gk\">const<\/span> <span class=\"gw\">SCOPES =<\/span> <span class=\"gw\">[<\/span> <span class=\"gs\">'https:\/\/www.googleapis.com\/auth\/gmail.readonly'<\/span><span class=\"gw\">,<\/span> <span class=\"gc\">\/\/ restricted<\/span> <span class=\"gs\">'https:\/\/www.googleapis.com\/auth\/gmail.send'<\/span><span class=\"gw\">,<\/span> <span class=\"gc\">\/\/ sensitive<\/span> <span class=\"gs\">'https:\/\/www.googleapis.com\/auth\/gmail.labels'<\/span><span class=\"gw\">,<\/span> <span class=\"gc\">\/\/ non-sensitive<\/span><span class=\"gw\">];<\/span><span class=\"gc\">\/\/ Generate the OAuth authorization URL<\/span><span class=\"gk\">const<\/span> <span class=\"gw\">authUrl =<\/span> <span class=\"gw\">oauth2Client.<\/span><span class=\"gfn\">generateAuthUrl<\/span><span class=\"gw\">({<\/span> <span class=\"gw\">access_type:<\/span> <span class=\"gs\">'offline'<\/span><span class=\"gw\">,<\/span> <span class=\"gc\">\/\/ request refresh token<\/span> <span class=\"gw\">scope: SCOPES,<\/span> <span class=\"gw\">prompt:<\/span> <span class=\"gs\">'consent'<\/span><span class=\"gw\">,<\/span> <span class=\"gc\">\/\/ force consent to get refresh token<\/span><span class=\"gw\">});<\/span><span class=\"gw\">console.<\/span><span class=\"gfn\">log<\/span><span class=\"gw\">(<\/span><span class=\"gs\">'Redirect user to:'<\/span><span class=\"gw\">, authUrl);<\/span><span class=\"gc\">\/\/ After user authorizes, exchange code for tokens<\/span><span class=\"gk\">async function<\/span> <span class=\"gfn\">getTokens<\/span><span class=\"gw\">(code) {<\/span> <span class=\"gk\">const<\/span> <span class=\"gw\">{ tokens } =<\/span> <span class=\"gk\">await<\/span> <span class=\"gw\">oauth2Client.<\/span><span class=\"gfn\">getToken<\/span><span class=\"gw\">(code);<\/span> <span class=\"gw\">oauth2Client.<\/span><span class=\"gfn\">setCredentials<\/span><span class=\"gw\">(tokens);<\/span> <span class=\"gk\">return<\/span> <span class=\"gw\">tokens;<\/span><span class=\"gw\">}<\/span><\/code><\/div> <div class=\"gas-editor-ok\"> <svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg> <span>Authorization URL generated – gmail oauth scopes declared<\/span> <\/div> <\/div> <\/div> <div class=\"gas-tab-panel\" data-gas-panel=\"python\"> <div class=\"gas-code-wrap\"> <div class=\"gas-editor-bar\"> <span class=\"gas-dot gas-dot-r\"><\/span> <span class=\"gas-dot gas-dot-y\"><\/span> <span class=\"gas-dot gas-dot-g\"><\/span> <span class=\"gas-filename\">gmail-scopes.py<\/span> <\/div> <div class=\"gas-pre\"><code><span class=\"gc\"># Python \u2014 Gmail API scopes in OAuth flow<\/span><span class=\"gc\"># Uses google-auth-oauthlib (official Google library)<\/span><span class=\"gk\">from<\/span> <span class=\"gw\">google_auth_oauthlib.flow<\/span> <span class=\"gk\">import<\/span> <span class=\"gw\">InstalledAppFlow<\/span><span class=\"gk\">from<\/span> <span class=\"gw\">google.oauth2.credentials<\/span> <span class=\"gk\">import<\/span> <span class=\"gw\">Credentials<\/span><span class=\"gk\">from<\/span> <span class=\"gw\">google.auth.transport.requests<\/span> <span class=\"gk\">import<\/span> <span class=\"gw\">Request<\/span><span class=\"gk\">import<\/span> <span class=\"gw\">os<\/span><span class=\"gc\"># Define gmail api scopes - request only what you need<\/span><span class=\"gw\">SCOPES =<\/span> <span class=\"gw\">[<\/span> <span class=\"gs\">'https:\/\/www.googleapis.com\/auth\/gmail.readonly'<\/span><span class=\"gw\">,<\/span> <span class=\"gc\"># restricted<\/span> <span class=\"gs\">'https:\/\/www.googleapis.com\/auth\/gmail.send'<\/span><span class=\"gw\">,<\/span> <span class=\"gc\"># sensitive<\/span> <span class=\"gs\">'https:\/\/www.googleapis.com\/auth\/gmail.labels'<\/span><span class=\"gw\">,<\/span> <span class=\"gc\"># non-sensitive<\/span><span class=\"gw\">]<\/span><span class=\"gk\">def<\/span> <span class=\"gfn\">get_gmail_credentials<\/span><span class=\"gw\">():<\/span> <span class=\"gw\">creds =<\/span> <span class=\"gk\">None<\/span> <span class=\"gc\"># Load existing token if available<\/span> <span class=\"gk\">if<\/span> <span class=\"gw\">os.path.<\/span><span class=\"gfn\">exists<\/span><span class=\"gw\">(<\/span><span class=\"gs\">'token.json'<\/span><span class=\"gw\">):<\/span> <span class=\"gw\">creds = Credentials.<\/span><span class=\"gfn\">from_authorized_user_file<\/span><span class=\"gw\">(<\/span> <span class=\"gs\">'token.json'<\/span><span class=\"gw\">, SCOPES<\/span> <span class=\"gw\">)<\/span> <span class=\"gc\"># Refresh or request new credentials<\/span> <span class=\"gk\">if not<\/span> <span class=\"gw\">creds<\/span> <span class=\"gk\">or not<\/span> <span class=\"gw\">creds.valid:<\/span> <span class=\"gk\">if<\/span> <span class=\"gw\">creds<\/span> <span class=\"gk\">and<\/span> <span class=\"gw\">creds.expired<\/span> <span class=\"gk\">and<\/span> <span class=\"gw\">creds.refresh_token:<\/span> <span class=\"gw\">creds.<\/span><span class=\"gfn\">refresh<\/span><span class=\"gw\">(<\/span><span class=\"gfn\">Request<\/span><span class=\"gw\">())<\/span> <span class=\"gk\">else<\/span><span class=\"gw\">:<\/span> <span class=\"gc\"># Trigger OAuth consent screen with declared scopes<\/span> <span class=\"gw\">flow = InstalledAppFlow.<\/span><span class=\"gfn\">from_client_secrets_file<\/span><span class=\"gw\">(<\/span> <span class=\"gs\">'credentials.json'<\/span><span class=\"gw\">, SCOPES<\/span> <span class=\"gw\">)<\/span> <span class=\"gw\">creds = flow.<\/span><span class=\"gfn\">run_local_server<\/span><span class=\"gw\">(port=<\/span><span class=\"gn\">0<\/span><span class=\"gw\">)<\/span> <span class=\"gc\"># Persist token for future runs<\/span> <span class=\"gk\">with<\/span> <span class=\"gfn\">open<\/span><span class=\"gw\">(<\/span><span class=\"gs\">'token.json'<\/span><span class=\"gw\">,<\/span> <span class=\"gs\">'w'<\/span><span class=\"gw\">) as token:<\/span> <span class=\"gw\">token.<\/span><span class=\"gfn\">write<\/span><span class=\"gw\">(creds.<\/span><span class=\"gfn\">to_json<\/span><span class=\"gw\">())<\/span> <span class=\"gk\">return<\/span> <span class=\"gw\">creds<\/span><\/code><\/div> <div class=\"gas-editor-ok\"> <svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg> <span>Gmail oauth scopes declared – token persisted to disk<\/span> <\/div> <\/div> <\/div> <div class=\"gas-note-box\"> <div class=\"gas-note-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> <pee class=\"gas-note-text\"><strong>Important:<\/strong> The <code>prompt: 'consent'<\/code> (Node.js) or <code>run_local_server<\/code> call (Python) forces the Google consent screen to appear even if the user has previously authorized. This is required to reliably get a <code>refresh_token<\/code>. Without a refresh token, your access token expires after 1 hour and users must re-authorize. For a complete guide to handling token refresh and scope re-authorization, see the <a href=\"https:\/\/www.unipile.com\/oauth-email-api\/\" target=\"_self\">OAuth Email API guide<\/a> and the <a href=\"https:\/\/developer.unipile.com\/docs\/google-oauth\" target=\"_blank\">Unipile Google OAuth docs<\/a>.<\/pee> <\/div> <\/div> <\/div><\/div><script>(function(){ function initCodeTabs(){ var wrap = document.getElementById('unipile-gas-code'); if (!wrap) return; var tabs = wrap.querySelectorAll('.gas-tab-btn'); var panels = wrap.querySelectorAll('.gas-tab-panel'); tabs.forEach(function(tab){ tab.addEventListener('click', function(){ var target = tab.getAttribute('data-gas-tab'); tabs.forEach(function(t){ t.classList.remove('gas-tab-active'); }); panels.forEach(function(p){ p.classList.remove('gas-panel-active'); }); tab.classList.add('gas-tab-active'); var panel = wrap.querySelector('[data-gas-panel=\"' + target + '\"]'); if (panel) panel.classList.add('gas-panel-active'); }); }); } if (document.readyState === 'loading') { document.addEventListener('DOMContentLoaded', initCodeTabs); } else { initCodeTabs(); }})();<\/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>#unipile-gas-compliance,#unipile-gas-compliance *,#unipile-gas-compliance *::before,#unipile-gas-compliance *::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;}#unipile-gas-compliance { background: #f4f5f7 !important; padding: 72px 20px !important;}#unipile-gas-compliance .gas-compl-inner { max-width: 1100px !important; margin: 0 auto !important;}#unipile-gas-compliance .gas-eyebrow { 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; width: fit-content !important; margin-bottom: 16px !important;}#unipile-gas-compliance .gas-eyebrow-dot { width: 7px !important; height: 7px !important; background: #3BB98B !important; border-radius: 50% !important; flex-shrink: 0 !important; display: inline-block !important;}#unipile-gas-compliance 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;}#unipile-gas-compliance .gas-intro { font-size: 16px !important; line-height: 1.75 !important; color: #383838 !important; margin-bottom: 40px !important;}#unipile-gas-compliance .gas-principles-grid { display: grid !important; grid-template-columns: repeat(2, 1fr) !important; gap: 20px !important; margin-bottom: 36px !important;}#unipile-gas-compliance .gas-principle-card { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; padding: 26px !important;}#unipile-gas-compliance .gas-principle-icon { width: 44px !important; height: 44px !important; border-radius: 10px !important; background: rgba(59, 185, 139, 0.12) !important; display: flex !important; align-items: center !important; justify-content: center !important; margin-bottom: 14px !important;}#unipile-gas-compliance .gas-principle-icon svg { width: 22px !important; height: 22px !important; stroke: #3BB98B !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}#unipile-gas-compliance .gas-principle-title { font-size: 15px !important; font-weight: 700 !important; color: #0f2736 !important; margin-bottom: 10px !important; display: block !important;}#unipile-gas-compliance .gas-principle-text { font-size: 14px !important; line-height: 1.7 !important; color: #4a5568 !important;}#unipile-gas-compliance .gas-principle-text strong { color: #0f2736 !important; font-weight: 700 !important;}#unipile-gas-compliance .gas-compliance-cards { display: grid !important; grid-template-columns: repeat(2, 1fr) !important; gap: 20px !important; margin-bottom: 36px !important;}#unipile-gas-compliance .gas-compl-card { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; padding: 26px !important;}#unipile-gas-compliance .gas-compl-header { display: flex !important; align-items: center !important; gap: 12px !important; margin-bottom: 14px !important;}#unipile-gas-compliance .gas-compl-badge { display: inline-flex !important; align-items: center !important; gap: 6px !important; padding: 4px 10px !important; border-radius: 8px !important; font-size: 11px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.4px !important;}#unipile-gas-compliance .cbadge-gdpr { background: rgba(59, 185, 139, 0.12) !important; color: #2aaa7e !important;}#unipile-gas-compliance .cbadge-soc2 { background: rgba(66, 133, 244, 0.12) !important; color: #4285F4 !important;}#unipile-gas-compliance .gas-compl-title { font-size: 15px !important; font-weight: 700 !important; color: #0f2736 !important; display: block !important;}#unipile-gas-compliance .gas-compl-text { font-size: 14px !important; line-height: 1.7 !important; color: #4a5568 !important;}#unipile-gas-compliance .gas-compl-list { display: flex !important; flex-direction: column !important; gap: 8px !important; margin-top: 12px !important;}#unipile-gas-compliance .gas-compl-list-item { display: flex !important; align-items: flex-start !important; gap: 8px !important; font-size: 13.5px !important; color: #4a5568 !important; line-height: 1.5 !important;}#unipile-gas-compliance .gas-check-dot { width: 16px !important; height: 16px !important; border-radius: 50% !important; background: rgba(59, 185, 139, 0.12) !important; display: flex !important; align-items: center !important; justify-content: center !important; flex-shrink: 0 !important; margin-top: 1px !important;}#unipile-gas-compliance .gas-check-dot svg { width: 9px !important; height: 9px !important; stroke: #3BB98B !important; fill: none !important; stroke-width: 3 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}#unipile-gas-compliance .gas-cta-strip { background: #0f2736 !important; border-radius: 16px !important; padding: 28px 32px !important; display: flex !important; align-items: center !important; justify-content: space-between !important; gap: 20px !important; flex-wrap: wrap !important;}#unipile-gas-compliance .gas-cta-strip-text { font-size: 16px !important; color: rgba(255,255,255,0.88) !important; line-height: 1.5 !important;}#unipile-gas-compliance .gas-cta-strip-text strong { color: #ffffff !important; font-weight: 700 !important;}#unipile-gas-compliance .gas-cta-btn { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: #DDDF4C !important; color: #0f2736 !important; padding: 12px 24px !important; border-radius: 8px !important; font-size: 14px !important; font-weight: 700 !important; border: 2px solid #DDDF4C !important; transition: all 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important; text-decoration: none !important;}#unipile-gas-compliance .gas-cta-btn:hover { transform: translateY(-5px) !important;}#unipile-gas-compliance .gas-cta-btn svg { width: 15px !important; height: 15px !important; stroke: currentColor !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) { #unipile-gas-compliance { padding: 56px 20px !important; } #unipile-gas-compliance h2 { font-size: 28px !important; } #unipile-gas-compliance .gas-principles-grid, #unipile-gas-compliance .gas-compliance-cards { grid-template-columns: 1fr !important; } #unipile-gas-compliance .gas-cta-strip { flex-direction: column !important; text-align: center !important; } #unipile-gas-compliance .gas-cta-btn { width: 100% !important; justify-content: center !important; }}@media (max-width: 600px) { #unipile-gas-compliance { padding: 44px 16px !important; } #unipile-gas-compliance h2 { font-size: 26px !important; }}<\/style><div id=\"unipile-gas-compliance\"> <span id=\"gas-compliance\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"gas-compl-inner\"> <div class=\"gas-eyebrow\"><span class=\"gas-eyebrow-dot\"><\/span><span>Compliance<\/span><\/div> <h2>Minimum Scope Principle and Compliance<\/h2> <pee class=\"gas-intro\">The minimum scope principle is not just a Google recommendation – it directly affects your GDPR and SOC 2 compliance posture. Requesting excessive gmail api permissions creates unnecessary data exposure risks and complicates your data processing agreements with end users.<\/pee> <div class=\"gas-principles-grid\"> <div class=\"gas-principle-card\"> <div class=\"gas-principle-icon\"> <svg viewBox=\"0 0 24 24\"><path d=\"M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10z\"\/><\/svg> <\/div> <span class=\"gas-principle-title\">Least privilege by design<\/span> <pee class=\"gas-principle-text\">The minimum scope principle mirrors the security concept of least privilege. Your Gmail API integration should request the <strong>lowest-permission gmail api scope<\/strong> that enables the feature. If your CRM only sends follow-up emails, <code>gmail.send<\/code> is enough – <code>gmail.modify<\/code> is excessive and creates unnecessary risk.<\/pee> <\/div> <div class=\"gas-principle-card\"> <div class=\"gas-principle-icon\"> <svg viewBox=\"0 0 24 24\"><circle cx=\"12\" cy=\"12\" r=\"10\"\/><path d=\"M12 8v4l3 3\"\/><\/svg> <\/div> <span class=\"gas-principle-title\">Consent screen clarity<\/span> <pee class=\"gas-principle-text\">Google surfaces your declared gmail api scopes directly on the consent screen. Broader scopes trigger more alarming language (“This app wants access to your entire Gmail inbox”). <strong>Minimal gmail oauth scopes<\/strong> produce simpler, less intimidating consent screens – typically improving authorization conversion rates by 15-30% in user-facing OAuth flows.<\/pee> <\/div> <div class=\"gas-principle-card\"> <div class=\"gas-principle-icon\"> <svg viewBox=\"0 0 24 24\"><path d=\"M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z\"\/><polyline points=\"14 2 14 8 20 8\"\/><\/svg> <\/div> <span class=\"gas-principle-title\">Data processing documentation<\/span> <pee class=\"gas-principle-text\">Your privacy policy and DPA (Data Processing Agreement) must accurately reflect which Gmail data your app accesses. If your app requests <code>gmail.readonly<\/code> but your privacy policy only mentions “sending emails,” you have a GDPR documentation gap. Match your declared gmail api scopes to your published data practices.<\/pee> <\/div> <div class=\"gas-principle-card\"> <div class=\"gas-principle-icon\"> <svg viewBox=\"0 0 24 24\"><polyline points=\"22 12 18 12 15 21 9 3 6 12 2 12\"\/><\/svg> <\/div> <span class=\"gas-principle-title\">Scope audit as a recurring practice<\/span> <pee class=\"gas-principle-text\">Gmail API scope requirements evolve as features are added or removed. Conduct a scope audit at each major release: remove any gmail api permissions your current feature set no longer requires. Unused scopes in your OAuth declaration are a compliance liability – they represent data access you claim to need but don’t use.<\/pee> <\/div> <\/div> <div class=\"gas-compliance-cards\"> <div class=\"gas-compl-card\"> <div class=\"gas-compl-header\"> <span class=\"gas-compl-badge cbadge-gdpr\"><span>GDPR<\/span><\/span> <\/div> <span class=\"gas-compl-title\">GDPR alignment with Gmail scopes<\/span> <div class=\"gas-compl-list\"> <div class=\"gas-compl-list-item\"> <div class=\"gas-check-dot\"><svg viewBox=\"0 0 12 12\"><polyline points=\"2 6 5 9 10 3\"\/><\/svg><\/div> <span>Purpose limitation: scopes must match the specific purpose declared to users<\/span> <\/div> <div class=\"gas-compl-list-item\"> <div class=\"gas-check-dot\"><svg viewBox=\"0 0 12 12\"><polyline points=\"2 6 5 9 10 3\"\/><\/svg><\/div> <span>Data minimization: request <code>gmail.metadata<\/code> instead of <code>gmail.readonly<\/code> when body access is not needed<\/span> <\/div> <div class=\"gas-compl-list-item\"> <div class=\"gas-check-dot\"><svg viewBox=\"0 0 12 12\"><polyline points=\"2 6 5 9 10 3\"\/><\/svg><\/div> <span>User rights: token revocation must immediately remove your app’s Gmail access<\/span> <\/div> <div class=\"gas-compl-list-item\"> <div class=\"gas-check-dot\"><svg viewBox=\"0 0 12 12\"><polyline points=\"2 6 5 9 10 3\"\/><\/svg><\/div> <span>Transparency: consent screen language must match the data you actually process<\/span> <\/div> <\/div> <\/div> <div class=\"gas-compl-card\"> <div class=\"gas-compl-header\"> <span class=\"gas-compl-badge cbadge-soc2\"><span>SOC 2<\/span><\/span> <\/div> <span class=\"gas-compl-title\">SOC 2 alignment with Gmail scopes<\/span> <div class=\"gas-compl-list\"> <div class=\"gas-compl-list-item\"> <div class=\"gas-check-dot\"><svg viewBox=\"0 0 12 12\"><polyline points=\"2 6 5 9 10 3\"\/><\/svg><\/div> <span>Access control: document each Gmail API scope and its business justification in your access control policy<\/span> <\/div> <div class=\"gas-compl-list-item\"> <div class=\"gas-check-dot\"><svg viewBox=\"0 0 12 12\"><polyline points=\"2 6 5 9 10 3\"\/><\/svg><\/div> <span>Logical access: scope selection must be reviewed and approved as part of your change management process<\/span> <\/div> <div class=\"gas-compl-list-item\"> <div class=\"gas-check-dot\"><svg viewBox=\"0 0 12 12\"><polyline points=\"2 6 5 9 10 3\"\/><\/svg><\/div> <span>Monitoring: log all gmail api scope changes in your audit trail<\/span> <\/div> <div class=\"gas-compl-list-item\"> <div class=\"gas-check-dot\"><svg viewBox=\"0 0 12 12\"><polyline points=\"2 6 5 9 10 3\"\/><\/svg><\/div> <span>Vendor management: if using a platform like Unipile, include their security attestation in your vendor review<\/span> <\/div> <\/div> <\/div> <\/div> <div class=\"gas-cta-strip\"> <pee class=\"gas-cta-strip-text\"><strong>Compliance-ready Gmail integration.<\/strong> Unipile’s Gmail API implementation follows the minimum scope principle by default – your app only requests the gmail oauth scopes needed for the features you enable.<\/pee> <a class=\"gas-cta-btn\" href=\"https:\/\/dashboard.unipile.com\/signup\/\" target=\"_blank\"><span>Build compliant Gmail apps<\/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><\/a> <\/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.4″ hover_enabled=”0″ global_colors_info=”{}” theme_builder_area=”post_content” sticky_enabled=”0″]<link href=\"https:\/\/fonts.googleapis.com\/css2?family=Inter:wght@400;500;600;700&family=Poppins:wght@700;800&display=swap\" rel=\"stylesheet\"><style>#unipile-gas-upl-light,#unipile-gas-upl-light *,#unipile-gas-upl-light *::before,#unipile-gas-upl-light *::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;}#unipile-gas-upl-light { background: #f4f5f7 !important; padding: 80px 20px !important;}#unipile-gas-upl-light .gasl-inner { max-width: 1100px !important; margin: 0 auto !important;}#unipile-gas-upl-light .gasl-eyebrow { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: rgba(59, 185, 139, 0.12) !important; color: #2da077 !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; width: fit-content !important; margin-bottom: 16px !important;}#unipile-gas-upl-light .gasl-eyebrow-dot { width: 7px !important; height: 7px !important; background: #3BB98B !important; border-radius: 50% !important; flex-shrink: 0 !important; display: inline-block !important;}#unipile-gas-upl-light 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;}#unipile-gas-upl-light .gasl-subtitle { font-size: 17px !important; line-height: 1.75 !important; color: #383838 !important; margin-bottom: 48px !important;}#unipile-gas-upl-light .gasl-providers-strip { display: flex !important; align-items: center !important; gap: 16px !important; justify-content: center !important; margin-bottom: 40px !important; flex-wrap: wrap !important;}#unipile-gas-upl-light .gasl-provider-chip { display: flex !important; align-items: center !important; gap: 8px !important; background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 10px !important; padding: 8px 16px !important;}#unipile-gas-upl-light .gasl-provider-chip img { width: 20px !important; height: 20px !important; display: inline-block !important; flex-shrink: 0 !important;}#unipile-gas-upl-light .gasl-provider-chip span { font-size: 13px !important; font-weight: 600 !important; color: #383838 !important;}#unipile-gas-upl-light .gasl-features-grid { display: grid !important; grid-template-columns: repeat(3, 1fr) !important; gap: 20px !important; margin-bottom: 48px !important;}#unipile-gas-upl-light .gasl-feat-card { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; padding: 24px !important; transition: all 0.2s ease !important;}#unipile-gas-upl-light .gasl-feat-card:hover { border-color: #3BB98B !important; transform: translateY(-2px) !important; box-shadow: 0 4px 12px rgba(59, 185, 139, 0.15) !important;}#unipile-gas-upl-light .gasl-feat-icon { width: 44px !important; height: 44px !important; border-radius: 10px !important; background: rgba(59, 185, 139, 0.12) !important; display: flex !important; align-items: center !important; justify-content: center !important; margin-bottom: 14px !important;}#unipile-gas-upl-light .gasl-feat-icon svg { width: 22px !important; height: 22px !important; stroke: #3BB98B !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}#unipile-gas-upl-light .gasl-feat-title { font-size: 15px !important; font-weight: 700 !important; color: #0f2736 !important; margin-bottom: 8px !important; display: block !important;}#unipile-gas-upl-light .gasl-feat-text { font-size: 13.5px !important; line-height: 1.65 !important; color: #383838 !important;}#unipile-gas-upl-light .gasl-cta-row { display: flex !important; align-items: center !important; justify-content: center !important; gap: 16px !important; flex-wrap: wrap !important; margin-bottom: 40px !important;}#unipile-gas-upl-light .gasl-cta-primary { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: #DDDF4C !important; color: #0f2736 !important; padding: 16px 32px !important; border-radius: 10px !important; font-size: 16px !important; font-weight: 700 !important; border: 2px solid #DDDF4C !important; transition: all 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important; text-decoration: none !important;}#unipile-gas-upl-light .gasl-cta-primary:hover { transform: translateY(-5px) !important;}#unipile-gas-upl-light .gasl-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; flex-shrink: 0 !important;}#unipile-gas-upl-light .gasl-cta-secondary { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: #ffffff !important; color: #0f2736 !important; padding: 14px 28px !important; border-radius: 10px !important; font-size: 15px !important; font-weight: 600 !important; border: 2px solid #d1d5db !important; transition: all 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important; text-decoration: none !important;}#unipile-gas-upl-light .gasl-cta-secondary:hover { border-color: #0f2736 !important; background: #ffffff !important;}#unipile-gas-upl-light .gasl-cta-secondary svg { width: 15px !important; height: 15px !important; stroke: currentColor !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important; flex-shrink: 0 !important;}#unipile-gas-upl-light .gasl-trust-row { display: flex !important; align-items: center !important; justify-content: center !important; gap: 28px !important; flex-wrap: wrap !important;}#unipile-gas-upl-light .gasl-trust-item { display: flex !important; align-items: center !important; gap: 8px !important; font-size: 13px !important; color: #383838 !important;}#unipile-gas-upl-light .gasl-trust-item svg { width: 15px !important; height: 15px !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) { #unipile-gas-upl-light { padding: 60px 20px !important; } #unipile-gas-upl-light h2 { font-size: 28px !important; } #unipile-gas-upl-light .gasl-features-grid { grid-template-columns: 1fr !important; } #unipile-gas-upl-light .gasl-cta-row { flex-direction: column !important; align-items: stretch !important; } #unipile-gas-upl-light .gasl-cta-primary, #unipile-gas-upl-light .gasl-cta-secondary { justify-content: center !important; }}@media (max-width: 600px) { #unipile-gas-upl-light { padding: 48px 16px !important; } #unipile-gas-upl-light h2 { font-size: 26px !important; } #unipile-gas-upl-light .gasl-trust-row { gap: 16px !important; }}<\/style><div id=\"unipile-gas-upl-light\"> <span id=\"gas-upl\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"gasl-inner\"> <div class=\"gasl-eyebrow\"><span class=\"gasl-eyebrow-dot\"><\/span><span>Unipile Solution<\/span><\/div> <h2>Gmail API Scopes with Unipile: Skip the Scope Complexity<\/h2> <pee class=\"gasl-subtitle\">Managing gmail api scopes manually means navigating Google’s verification process, handling token refresh on scope changes, and updating your data processing documentation every time you add a feature. Unipile abstracts this entirely, your team focuses on product, not permission strings.<\/pee> <div class=\"gasl-providers-strip\"> <div class=\"gasl-provider-chip\"> <img decoding=\"async\" src=\"https:\/\/www.unipile.com\/wp-content\/uploads\/2024\/02\/gmail-3.svg\" alt=\"Gmail\" width=\"20\" height=\"20\"> <span>Gmail<\/span> <\/div> <div class=\"gasl-provider-chip\"> <img decoding=\"async\" src=\"https:\/\/www.unipile.com\/wp-content\/uploads\/2024\/02\/outlook-2.svg\" alt=\"Outlook\" width=\"20\" height=\"20\"> <span>Outlook<\/span> <\/div> <div class=\"gasl-provider-chip\"> <img decoding=\"async\" src=\"https:\/\/www.unipile.com\/wp-content\/uploads\/2024\/02\/imap-1.svg\" alt=\"IMAP\" width=\"20\" height=\"20\"> <span>IMAP<\/span> <\/div> <\/div> <div class=\"gasl-features-grid\"> <div class=\"gasl-feat-card\"> <div class=\"gasl-feat-icon\"> <svg viewBox=\"0 0 24 24\"><path d=\"M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10z\"\/><\/svg> <\/div> <span class=\"gasl-feat-title\">Pre-verified Gmail OAuth<\/span> <pee class=\"gasl-feat-text\">Unipile holds Google’s OAuth verification for restricted gmail api scopes. Your app benefits immediately without completing a separate security assessment. The annual re-certification is handled by Unipile’s compliance team.<\/pee> <\/div> <div class=\"gasl-feat-card\"> <div class=\"gasl-feat-icon\"> <svg viewBox=\"0 0 24 24\"><polyline points=\"23 6 13.5 15.5 8.5 10.5 1 18\"\/><polyline points=\"17 6 23 6 23 12\"\/><\/svg> <\/div> <span class=\"gasl-feat-title\">Automatic token management<\/span> <pee class=\"gasl-feat-text\">Unipile manages OAuth token refresh, scope validation, and re-authorization flows for each of your users’ linked accounts. When Google updates scope requirements, Unipile adapts without breaking your integration.<\/pee> <\/div> <div class=\"gasl-feat-card\"> <div class=\"gasl-feat-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> <span class=\"gasl-feat-title\">Unified API across providers<\/span> <pee class=\"gasl-feat-text\">The same Unipile API calls work for Gmail, Outlook, and IMAP. You write your email feature once and it works across all providers, no separate gmail api scope management per provider, no protocol-specific code branches.<\/pee> <\/div> <div class=\"gasl-feat-card\"> <div class=\"gasl-feat-icon\"> <svg viewBox=\"0 0 24 24\"><path d=\"M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z\"\/><polyline points=\"14 2 14 8 20 8\"\/><\/svg> <\/div> <span class=\"gasl-feat-title\">White-label OAuth option<\/span> <pee class=\"gasl-feat-text\">For teams that need to use their own Google credentials, Unipile supports white-label OAuth configuration. Your users see your brand on the consent screen while Unipile handles the scope declaration and token lifecycle in the background.<\/pee> <\/div> <div class=\"gasl-feat-card\"> <div class=\"gasl-feat-icon\"> <svg viewBox=\"0 0 24 24\"><path d=\"M22 11.08V12a10 10 0 1 1-5.93-9.14\"\/><polyline points=\"22 4 12 14.01 9 11.01\"\/><\/svg> <\/div> <span class=\"gasl-feat-title\">Minimum scope by default<\/span> <pee class=\"gasl-feat-text\">Unipile’s Gmail integration requests only the gmail api permissions required for the features you enable. Read, send, sync, each capability maps to the narrowest scope possible, keeping your compliance profile clean.<\/pee> <\/div> <div class=\"gasl-feat-card\"> <div class=\"gasl-feat-icon\"> <svg viewBox=\"0 0 24 24\"><polyline points=\"22 12 18 12 15 21 9 3 6 12 2 12\"\/><\/svg> <\/div> <span class=\"gasl-feat-title\">Real-time webhooks<\/span> <pee class=\"gasl-feat-text\">Receive new Gmail messages as they arrive via Unipile webhooks. No polling, no managing Gmail Pub\/Sub subscriptions manually. Works with the same OAuth token your app already uses for other Gmail API operations.<\/pee> <\/div> <\/div> <div class=\"gasl-cta-row\"> <a class=\"gasl-cta-primary\" href=\"https:\/\/dashboard.unipile.com\/signup\/\" target=\"_blank\"><span>Build your Gmail app now<\/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><\/a> <a class=\"gasl-cta-secondary\" href=\"https:\/\/developer.unipile.com\/docs\/google-oauth\" target=\"_blank\"><span>Read the docs<\/span><svg viewBox=\"0 0 24 24\"><path d=\"M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6\"\/><polyline points=\"15 3 21 3 21 9\"\/><line x1=\"10\" y1=\"14\" x2=\"21\" y2=\"3\"\/><\/svg><\/a> <\/div> <div class=\"gasl-trust-row\"> <div class=\"gasl-trust-item\"> <svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg> <span>No security assessment required<\/span> <\/div> <div class=\"gasl-trust-item\"> <svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg> <span>Gmail, Outlook and IMAP in one API<\/span> <\/div> <div class=\"gasl-trust-item\"> <svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg> <span>GDPR and SOC 2 aligned<\/span> <\/div> <div class=\"gasl-trust-item\"> <svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg> <span>14-day free trial, no card required<\/span> <\/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”]<script type=\"application\/ld+json\">{ \"@context\": \"https:\/\/schema.org\", \"@type\": \"FAQPage\", \"mainEntity\": [ { \"@type\": \"Question\", \"name\": \"What are Gmail API scopes?\", \"acceptedAnswer\": { \"@type\": \"Answer\", \"text\": \"Gmail API scopes are OAuth 2.0 permission strings that define exactly which Gmail resources your application can access on behalf of a user. They are declared when generating the OAuth authorization URL and displayed to the user on Google's consent screen. Once a user grants access, your token is limited to only the actions those gmail api scopes permit.\" } }, { \"@type\": \"Question\", \"name\": \"What is the difference between gmail.readonly and gmail.modify?\", \"acceptedAnswer\": { \"@type\": \"Answer\", \"text\": \"Both gmail.readonly and gmail.modify are restricted gmail api scopes, but they have different access levels. gmail.readonly provides read-only access to all messages, threads, labels, and settings - your app cannot send or modify anything. gmail.modify adds the ability to read, compose, send emails, and manage labels, but excludes the ability to permanently delete messages. If your app needs to read and send but not delete, gmail.modify is preferred over the broader mail.google.com\/ scope.\" } }, { \"@type\": \"Question\", \"name\": \"Do I need a security assessment for all Gmail API scopes?\", \"acceptedAnswer\": { \"@type\": \"Answer\", \"text\": \"No. Only restricted gmail api scopes require a security assessment. Non-sensitive scopes like gmail.labels require only standard OAuth app review. Sensitive scopes like gmail.send require Google's OAuth verification process but no security assessment. Restricted scopes - including gmail.readonly, gmail.modify, gmail.compose, gmail.metadata, gmail.insert, and mail.google.com\/ - require an annual third-party security assessment costing approximately $500 per year.\" } }, { \"@type\": \"Question\", \"name\": \"What is the gmail.modify scope used for?\", \"acceptedAnswer\": { \"@type\": \"Answer\", \"text\": \"The gmail.modify scope grants read, compose, send, and label management access to Gmail, but excludes the ability to permanently delete messages. It is the recommended restricted scope for full-featured email integrations such as CRM email sync, helpdesk tools, and email clients that need to both read and send messages. It is preferred over the broader mail.google.com\/ scope because it limits data exposure by excluding permanent delete.\" } }, { \"@type\": \"Question\", \"name\": \"How many test users can I have before completing Gmail API scope verification?\", \"acceptedAnswer\": { \"@type\": \"Answer\", \"text\": \"You can test your app with up to 100 Google accounts while your OAuth app is in testing mode, regardless of the gmail api scopes you declare. These test accounts must be manually added in the Google Cloud Console OAuth consent screen configuration. Once you exceed 100 test users or want to release to all users, you must complete the appropriate verification process for your scope sensitivity level.\" } }, { \"@type\": \"Question\", \"name\": \"Can I combine multiple Gmail API scopes in one OAuth request?\", \"acceptedAnswer\": { \"@type\": \"Answer\", \"text\": \"Yes, you can combine multiple gmail api scopes in a single OAuth authorization request by passing them as an array to the scope parameter. For example, you can request gmail.readonly and gmail.send together. However, combining scopes increases the permissions shown on Google's consent screen and may trigger additional verification requirements if any of the combined scopes are restricted. Always request only the minimum combination your app needs.\" } }, { \"@type\": \"Question\", \"name\": \"What is the gmail.metadata scope?\", \"acceptedAnswer\": { \"@type\": \"Answer\", \"text\": \"The gmail.metadata scope is a restricted gmail api scope that grants access to email headers and labels only, without any access to email body content or attachments. It is useful for routing engines, categorization systems, or analytics tools that need to process emails based on sender, recipient, subject, or labels without reading private message content. Despite being a restricted scope, it has a narrower data footprint than gmail.readonly and may be easier to justify in a security assessment.\" } }, { \"@type\": \"Question\", \"name\": \"How does Unipile handle Gmail API scopes for my app?\", \"acceptedAnswer\": { \"@type\": \"Answer\", \"text\": \"Unipile manages gmail api scopes internally as part of its hosted Gmail OAuth integration. When your users link their Gmail accounts through Unipile, Unipile requests the appropriate gmail oauth scopes based on the features your app enables, manages token refresh automatically, and handles re-authorization when scope requirements change. Your team does not need to declare or manage gmail api scope lists directly, and you benefit from Unipile's existing Google verification status for restricted scopes.\" } }, { \"@type\": \"Question\", \"name\": \"What is the gmail.send scope and when should I use it?\", \"acceptedAnswer\": { \"@type\": \"Answer\", \"text\": \"The gmail.send scope is a sensitive gmail api scope that allows your app to send emails on behalf of an authenticated user, without granting any read or modify access to their existing messages. It is the recommended minimum scope for apps that only need to send emails - such as outreach tools, notification systems, or follow-up automation - and do not need to read the inbox. Using gmail.send instead of gmail.modify or gmail.readonly avoids the restricted scope security assessment.\" } }, { \"@type\": \"Question\", \"name\": \"How do Gmail API scopes affect GDPR compliance?\", \"acceptedAnswer\": { \"@type\": \"Answer\", \"text\": \"Gmail API scopes directly affect your GDPR compliance posture in several ways. The principle of data minimization requires you to request only the gmail api permissions necessary for your stated purpose. Your privacy policy and data processing agreements must accurately reflect which Gmail data your app accesses based on its declared scopes. Requesting excessive scopes creates a GDPR documentation gap and increases your data breach liability surface. When users revoke authorization, your app must immediately lose access to their Gmail data.\" } } ]}<\/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>#unipile-gas-faq,#unipile-gas-faq *,#unipile-gas-faq *::before,#unipile-gas-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;}#unipile-gas-faq { background: #f4f5f7 !important; padding: 72px 20px !important;}#unipile-gas-faq .gas-faq-container { max-width: 900px !important; margin: 0 auto !important;}#unipile-gas-faq .gas-eyebrow { 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; width: fit-content !important; margin-bottom: 16px !important;}#unipile-gas-faq .gas-eyebrow-dot { width: 7px !important; height: 7px !important; background: #3BB98B !important; border-radius: 50% !important; flex-shrink: 0 !important; display: inline-block !important;}#unipile-gas-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;}#unipile-gas-faq .gas-faq-intro { font-size: 16px !important; line-height: 1.75 !important; color: #383838 !important; margin-bottom: 36px !important;}#unipile-gas-faq .gas-faq-list { display: flex !important; flex-direction: column !important; gap: 12px !important; margin-bottom: 40px !important;}#unipile-gas-faq .gas-faq-item { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; overflow: hidden !important; transition: border-color 0.2s ease !important;}#unipile-gas-faq .gas-faq-item.gas-faq-active { border-color: #3BB98B !important;}#unipile-gas-faq .gas-faq-header { padding: 20px 24px !important; display: flex !important; align-items: center !important; gap: 16px !important; cursor: pointer !important; user-select: none !important;}#unipile-gas-faq .gas-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: all 0.2s ease !important; flex-shrink: 0 !important;}#unipile-gas-faq .gas-faq-item.gas-faq-active .gas-faq-num { background: #3BB98B !important; color: #ffffff !important;}#unipile-gas-faq .gas-faq-question { font-size: 16px !important; font-weight: 600 !important; color: #0f2736 !important; line-height: 1.4 !important; flex: 1 !important;}#unipile-gas-faq .gas-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: all 0.2s ease !important; flex-shrink: 0 !important;}#unipile-gas-faq .gas-faq-item.gas-faq-active .gas-faq-toggle { background: #3BB98B !important; transform: rotate(45deg) !important;}#unipile-gas-faq .gas-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;}#unipile-gas-faq .gas-faq-item.gas-faq-active .gas-faq-toggle svg { stroke: #ffffff !important;}#unipile-gas-faq .gas-faq-body { max-height: 0 !important; overflow: hidden !important; transition: max-height 0.35s ease !important;}#unipile-gas-faq .gas-faq-body.gas-faq-open { max-height: 800px !important;}#unipile-gas-faq .gas-faq-answer { padding: 0 28px 28px 76px !important; font-size: 15px !important; line-height: 1.78 !important; color: #4a5568 !important;}#unipile-gas-faq .gas-faq-answer a { color: #2aaa7e !important; text-decoration: underline !important;}#unipile-gas-faq .gas-faq-answer strong { color: #0f2736 !important; font-weight: 700 !important;}#unipile-gas-faq .gas-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;}#unipile-gas-faq .gas-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;}#unipile-gas-faq .gas-faq-cta-text { font-size: 15.5px !important; color: #383838 !important; line-height: 1.6 !important;}#unipile-gas-faq .gas-faq-cta-text strong { color: #0f2736 !important; font-weight: 700 !important;}#unipile-gas-faq .gas-faq-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: 14px !important; font-weight: 700 !important; border: 2px solid #DDDF4C !important; transition: all 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important; font-family: 'Inter', sans-serif !important;}#unipile-gas-faq .gas-faq-cta-btn:hover { transform: translateY(-3px) !important;}#unipile-gas-faq .gas-faq-cta-btn svg { width: 15px !important; height: 15px !important; stroke: currentColor !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) { #unipile-gas-faq { padding: 56px 16px !important; } #unipile-gas-faq h2 { font-size: 28px !important; } #unipile-gas-faq .gas-faq-answer { padding: 0 16px 20px 16px !important; }}@media (max-width: 600px) { #unipile-gas-faq { padding: 44px 14px !important; } #unipile-gas-faq h2 { font-size: 26px !important; } #unipile-gas-faq .gas-faq-cta-bar { flex-direction: column !important; } #unipile-gas-faq .gas-faq-cta-btn { width: 100% !important; justify-content: center !important; }}<\/style><div id=\"unipile-gas-faq\"> <span id=\"gas-faq\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"gas-faq-container\"> <div class=\"gas-eyebrow\"><span class=\"gas-eyebrow-dot\"><\/span><span>FAQ<\/span><\/div> <h2>Frequently Asked Questions about Gmail API Scopes<\/h2> <pee class=\"gas-faq-intro\">Common questions about gmail api scopes, gmail oauth scopes, and the verification process – answered concisely for developers building Gmail integrations.<\/pee> <div class=\"gas-faq-list\"> <div class=\"gas-faq-item\"> <div class=\"gas-faq-header\"> <div class=\"gas-faq-num\">01<\/div> <div class=\"gas-faq-question\">What are Gmail API scopes?<\/div> <div class=\"gas-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=\"gas-faq-body\"> <div class=\"gas-faq-answer\"><strong>Gmail API scopes<\/strong> are OAuth 2.0 permission strings that define exactly which Gmail resources your application can access on behalf of a user. They are declared when generating the OAuth authorization URL and displayed to the user on Google’s consent screen. Once a user grants access, your token is limited to only the actions those gmail api scopes permit – nothing more. Start with our <a href=\"\/gmail-api-send-email-a-comprehensive-guide-for-developers\/\" style=\"color:#2aaa7e;font-weight:600;text-decoration:underline;\">full Gmail API integration walkthrough<\/a>.<\/div> <\/div> <\/div> <div class=\"gas-faq-item\"> <div class=\"gas-faq-header\"> <div class=\"gas-faq-num\">02<\/div> <div class=\"gas-faq-question\">What is the difference between gmail.readonly and gmail.modify?<\/div> <div class=\"gas-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=\"gas-faq-body\"> <div class=\"gas-faq-answer\">Both <code>gmail.readonly<\/code> and <code>gmail.modify<\/code> are restricted gmail api scopes. <strong>gmail.readonly<\/strong> provides read-only access to all messages, threads, labels, and settings – your app cannot send or change anything. <strong>gmail.modify<\/strong> adds the ability to read, compose, send emails, and manage labels, but excludes permanent message deletion. If your app needs to read and send but not delete, <code>gmail.modify<\/code> is preferred over the broader <code>mail.google.com\/<\/code> scope. See our <a href=\"\/read-email-api\/\" style=\"color:#2aaa7e;font-weight:600;text-decoration:underline;\">how to read user emails via a unified API<\/a>.<\/div> <\/div> <\/div> <div class=\"gas-faq-item\"> <div class=\"gas-faq-header\"> <div class=\"gas-faq-num\">03<\/div> <div class=\"gas-faq-question\">Do I need a security assessment for all Gmail API scopes?<\/div> <div class=\"gas-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=\"gas-faq-body\"> <div class=\"gas-faq-answer\">No. Only <strong>restricted gmail api scopes<\/strong> require an annual third-party security assessment (~$500\/year). Non-sensitive scopes like <code>gmail.labels<\/code> require only standard OAuth app review. Sensitive scopes like <code>gmail.send<\/code> require Google’s OAuth verification process but no security assessment. Restricted scopes – including <code>gmail.readonly<\/code>, <code>gmail.modify<\/code>, <code>gmail.compose<\/code>, <code>gmail.metadata<\/code>, <code>gmail.insert<\/code>, and <code>mail.google.com\/<\/code> – require the full assessment process. More on this in our <a href=\"\/secure-email-api-for-developers-and-businesses\/\" style=\"color:#2aaa7e;font-weight:600;text-decoration:underline;\">secure email API patterns for regulated industries<\/a>.<\/div> <\/div> <\/div> <div class=\"gas-faq-item\"> <div class=\"gas-faq-header\"> <div class=\"gas-faq-num\">04<\/div> <div class=\"gas-faq-question\">What is the gmail.modify scope used for?<\/div> <div class=\"gas-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=\"gas-faq-body\"> <div class=\"gas-faq-answer\">The <code>gmail.modify<\/code> scope grants read, compose, send, and label management access to Gmail, but excludes the ability to permanently delete messages. It is the recommended restricted scope for full-featured email integrations such as <strong>CRM email sync, helpdesk tools, and email clients<\/strong> that need to both read and send messages. It is preferred over <code>mail.google.com\/<\/code> because it limits data exposure by excluding permanent delete functionality. Related: <a href=\"\/send-email-on-behalf-of-user-api-the-game-changer-for-software-editors\/\" style=\"color:#2aaa7e;font-weight:600;text-decoration:underline;\">sending email on behalf of users<\/a>.<\/div> <\/div> <\/div> <div class=\"gas-faq-item\"> <div class=\"gas-faq-header\"> <div class=\"gas-faq-num\">05<\/div> <div class=\"gas-faq-question\">How many test users can I have before completing Gmail API scope verification?<\/div> <div class=\"gas-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=\"gas-faq-body\"> <div class=\"gas-faq-answer\">You can test your app with up to <strong>100 Google accounts<\/strong> while your OAuth app is in testing mode, regardless of the gmail api scopes you declare. These test accounts must be manually added in the Google Cloud Console OAuth consent screen settings. Once you exceed 100 users or want to release publicly, you must complete the appropriate verification process for your scope sensitivity level.<\/div> <\/div> <\/div> <div class=\"gas-faq-item\"> <div class=\"gas-faq-header\"> <div class=\"gas-faq-num\">06<\/div> <div class=\"gas-faq-question\">Can I combine multiple Gmail API scopes in one OAuth request?<\/div> <div class=\"gas-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=\"gas-faq-body\"> <div class=\"gas-faq-answer\">Yes, you can combine multiple gmail api scopes in a single OAuth authorization request by passing them as an array to the <code>scope<\/code> parameter. For example, you can request <code>gmail.send<\/code> + <code>gmail.labels<\/code> together. However, combining scopes increases the permissions shown on Google’s consent screen and may trigger additional verification requirements if any combined scope is restricted. Always request only the minimum combination your app genuinely needs. For the Microsoft side, see <a href=\"\/microsoft-graph-oauth-email\/\" style=\"color:#2aaa7e;font-weight:600;text-decoration:underline;\">Microsoft Graph OAuth scopes equivalent<\/a>.<\/div> <\/div> <\/div> <div class=\"gas-faq-item\"> <div class=\"gas-faq-header\"> <div class=\"gas-faq-num\">07<\/div> <div class=\"gas-faq-question\">What is the gmail.metadata scope?<\/div> <div class=\"gas-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=\"gas-faq-body\"> <div class=\"gas-faq-answer\">The <code>gmail.metadata<\/code> scope is a restricted gmail api scope that grants access to <strong>email headers and labels only<\/strong>, without any access to email body content or attachments. It is useful for routing engines, categorization systems, or analytics tools that process emails based on sender, recipient, subject, or labels without reading private message content. Despite being restricted, it has a narrower data footprint than <code>gmail.readonly<\/code> and may be easier to justify in a security assessment. We dive deeper in our <a href=\"\/email-synchronization-api-for-seamless-software-integration\/\" style=\"color:#2aaa7e;font-weight:600;text-decoration:underline;\">email sync API for full inbox sync<\/a>.<\/div> <\/div> <\/div> <div class=\"gas-faq-item\"> <div class=\"gas-faq-header\"> <div class=\"gas-faq-num\">08<\/div> <div class=\"gas-faq-question\">How does Unipile handle Gmail API scopes for my app?<\/div> <div class=\"gas-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=\"gas-faq-body\"> <div class=\"gas-faq-answer\">Unipile manages gmail api scopes internally as part of its hosted Gmail OAuth integration. When your users link their Gmail accounts through Unipile, Unipile requests the appropriate gmail oauth scopes based on the features you enable, manages token refresh automatically, and handles re-authorization when scope requirements change. Your team does not need to declare or manage gmail api scope lists directly – and you benefit from <a href=\"https:\/\/developer.unipile.com\/docs\/google-oauth\" target=\"_blank\">Unipile’s existing Google verification<\/a> status for restricted scopes. For more on this, check our <a href=\"\/email-api-providers\/\" style=\"color:#2aaa7e;font-weight:600;text-decoration:underline;\">comparison of 6 email API providers<\/a>.<\/div> <\/div> <\/div> <div class=\"gas-faq-item\"> <div class=\"gas-faq-header\"> <div class=\"gas-faq-num\">09<\/div> <div class=\"gas-faq-question\">What is gmail.send and when should I use it?<\/div> <div class=\"gas-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=\"gas-faq-body\"> <div class=\"gas-faq-answer\">The <code>gmail.send<\/code> scope is a <strong>sensitive gmail api scope<\/strong> that allows your app to send emails on behalf of an authenticated user, without granting read or modify access to existing messages. It is the recommended minimum scope for apps that only send emails – outreach tools, notification systems, or follow-up automation. Using <code>gmail.send<\/code> instead of <code>gmail.modify<\/code> avoids the restricted scope security assessment entirely, significantly accelerating your path to production. See our <a href=\"\/send-email-api\/\" style=\"color:#2aaa7e;font-weight:600;text-decoration:underline;\">dedicated Send Email API guide<\/a>.<\/div> <\/div> <\/div> <div class=\"gas-faq-item\"> <div class=\"gas-faq-header\"> <div class=\"gas-faq-num\">10<\/div> <div class=\"gas-faq-question\">How do Gmail API scopes affect GDPR compliance?<\/div> <div class=\"gas-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=\"gas-faq-body\"> <div class=\"gas-faq-answer\">Gmail API scopes directly affect your GDPR posture. The <strong>data minimization principle<\/strong> requires you to request only the gmail api permissions necessary for your stated purpose. Your privacy policy must accurately reflect which Gmail data you access. Requesting excessive scopes creates a GDPR documentation gap and increases breach liability. When users revoke authorization, your app must immediately lose access to their Gmail data – this is enforced by Google’s token invalidation but must also be reflected in your data deletion procedures.<\/div> <\/div> <\/div> <\/div> <div class=\"gas-faq-cta-bar\"> <pee class=\"gas-faq-cta-text\"><strong>Need help choosing the right Gmail API scopes for your use case?<\/strong> Our team can review your integration architecture and recommend the minimum scope set.<\/pee> <span class=\"gas-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 initFaq(){ var faq = document.getElementById('unipile-gas-faq'); if (!faq) return; var items = faq.querySelectorAll('.gas-faq-item'); items.forEach(function(item){ var header = item.querySelector('.gas-faq-header'); var body = item.querySelector('.gas-faq-body'); if (!header || !body) return; header.addEventListener('click', function(){ var isOpen = item.classList.contains('gas-faq-active'); items.forEach(function(i){ i.classList.remove('gas-faq-active'); var b = i.querySelector('.gas-faq-body'); if (b) b.classList.remove('gas-faq-open'); }); if (!isOpen) { item.classList.add('gas-faq-active'); body.classList.add('gas-faq-open'); } }); }); } if (document.readyState === 'loading') { document.addEventListener('DOMContentLoaded', initFaq); } else { initFaq(); }})();<\/script>[\/et_pb_code][\/et_pb_column][\/et_pb_row][\/et_pb_section]\n","protected":false},"excerpt":{"rendered":"<p>Her Gmail API kapsam\u0131 a\u00e7\u0131kland\u0131: gmail.readonly, gmail.modify, gmail.send ve daha fazlas\u0131. Kullan\u0131m durumunuz i\u00e7in minimum kapsam\u0131 se\u00e7in + Node.js ve Python'da kod \u00f6rnekleri.<\/p>","protected":false},"author":4,"featured_media":278967,"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":[37],"tags":[],"post_folder":[],"class_list":["post-278951","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-cat-guides"],"yoast_head":"\n<title>Gmail API Scopes Explained: Choose the Right Permissions for Your App - Unipile<\/title>\n<meta name=\"description\" content=\"Every Gmail API scope explained: gmail.readonly, gmail.modify, gmail.send and more. Choose the minimum scope for your use case + code samples in Node.js and Python.\" \/>\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-kapsamlari-kilavuzu\/\" \/>\n<meta property=\"og:locale\" content=\"tr_TR\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Gmail API Scopes Explained: Choose the Right Permissions for Your App - Unipile\" \/>\n<meta property=\"og:description\" content=\"Every Gmail API scope explained: gmail.readonly, gmail.modify, gmail.send and more. Choose the minimum scope for your use case + code samples in Node.js and Python.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.unipile.com\/tr\/gmail-api-kapsamlari-kilavuzu\/\" \/>\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-25T13:25:16+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-05-25T13:38:11+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.unipile.com\/wp-content\/uploads\/2026\/05\/em-23-gmail-api-scopes.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-scopes-guide\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-scopes-guide\\\/\"},\"author\":{\"name\":\"Damien Girardeau\",\"@id\":\"https:\\\/\\\/www.unipile.com\\\/#\\\/schema\\\/person\\\/a2ac44e22bdc27d497ce8b58716a673e\"},\"headline\":\"Gmail API Scopes Explained: Choose the Right Permissions for Your App\",\"datePublished\":\"2026-05-25T13:25:16+00:00\",\"dateModified\":\"2026-05-25T13:38:11+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-scopes-guide\\\/\"},\"wordCount\":5017,\"publisher\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/#organization\"},\"image\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-scopes-guide\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/www.unipile.com\\\/wp-content\\\/uploads\\\/2026\\\/05\\\/em-23-gmail-api-scopes.png\",\"articleSection\":[\"Guides\"],\"inLanguage\":\"tr\"},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-scopes-guide\\\/\",\"url\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-scopes-guide\\\/\",\"name\":\"Gmail API Scopes Explained: Choose the Right Permissions for Your App - Unipile\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-scopes-guide\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-scopes-guide\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/www.unipile.com\\\/wp-content\\\/uploads\\\/2026\\\/05\\\/em-23-gmail-api-scopes.png\",\"datePublished\":\"2026-05-25T13:25:16+00:00\",\"dateModified\":\"2026-05-25T13:38:11+00:00\",\"description\":\"Every Gmail API scope explained: gmail.readonly, gmail.modify, gmail.send and more. Choose the minimum scope for your use case + code samples in Node.js and Python.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-scopes-guide\\\/#breadcrumb\"},\"inLanguage\":\"tr\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.unipile.com\\\/gmail-api-scopes-guide\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"tr\",\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-scopes-guide\\\/#primaryimage\",\"url\":\"https:\\\/\\\/www.unipile.com\\\/wp-content\\\/uploads\\\/2026\\\/05\\\/em-23-gmail-api-scopes.png\",\"contentUrl\":\"https:\\\/\\\/www.unipile.com\\\/wp-content\\\/uploads\\\/2026\\\/05\\\/em-23-gmail-api-scopes.png\",\"width\":2400,\"height\":1260,\"caption\":\"Gmail API Scopes: 14 OAuth permissions across 3 sensitivity levels\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-scopes-guide\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Accueil\",\"item\":\"https:\\\/\\\/www.unipile.com\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Gmail API Scopes Explained: Choose the Right Permissions for Your App\"}]},{\"@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 Kapsamlar\u0131 A\u00e7\u0131kland\u0131: Uygulaman\u0131z \u0130\u00e7in Do\u011fru Yetkileri Se\u00e7in - Unipile","description":"Her Gmail API kapsam\u0131 a\u00e7\u0131kland\u0131: gmail.readonly, gmail.modify, gmail.send ve daha fazlas\u0131. Kullan\u0131m durumunuz i\u00e7in minimum kapsam\u0131 se\u00e7in + Node.js ve Python'da kod \u00f6rnekleri.","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-kapsamlari-kilavuzu\/","og_locale":"tr_TR","og_type":"article","og_title":"Gmail API Scopes Explained: Choose the Right Permissions for Your App - Unipile","og_description":"Every Gmail API scope explained: gmail.readonly, gmail.modify, gmail.send and more. Choose the minimum scope for your use case + code samples in Node.js and Python.","og_url":"https:\/\/www.unipile.com\/tr\/gmail-api-kapsamlari-kilavuzu\/","og_site_name":"Unipile","article_publisher":"https:\/\/www.facebook.com\/unipilefr","article_published_time":"2026-05-25T13:25:16+00:00","article_modified_time":"2026-05-25T13:38:11+00:00","og_image":[{"width":2400,"height":1260,"url":"https:\/\/www.unipile.com\/wp-content\/uploads\/2026\/05\/em-23-gmail-api-scopes.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-scopes-guide\/#article","isPartOf":{"@id":"https:\/\/www.unipile.com\/gmail-api-scopes-guide\/"},"author":{"name":"Damien Girardeau","@id":"https:\/\/www.unipile.com\/#\/schema\/person\/a2ac44e22bdc27d497ce8b58716a673e"},"headline":"Gmail API Scopes Explained: Choose the Right Permissions for Your App","datePublished":"2026-05-25T13:25:16+00:00","dateModified":"2026-05-25T13:38:11+00:00","mainEntityOfPage":{"@id":"https:\/\/www.unipile.com\/gmail-api-scopes-guide\/"},"wordCount":5017,"publisher":{"@id":"https:\/\/www.unipile.com\/#organization"},"image":{"@id":"https:\/\/www.unipile.com\/gmail-api-scopes-guide\/#primaryimage"},"thumbnailUrl":"https:\/\/www.unipile.com\/wp-content\/uploads\/2026\/05\/em-23-gmail-api-scopes.png","articleSection":["Guides"],"inLanguage":"tr"},{"@type":"WebPage","@id":"https:\/\/www.unipile.com\/gmail-api-scopes-guide\/","url":"https:\/\/www.unipile.com\/gmail-api-scopes-guide\/","name":"Gmail API Kapsamlar\u0131 A\u00e7\u0131kland\u0131: Uygulaman\u0131z \u0130\u00e7in Do\u011fru Yetkileri Se\u00e7in - Unipile","isPartOf":{"@id":"https:\/\/www.unipile.com\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.unipile.com\/gmail-api-scopes-guide\/#primaryimage"},"image":{"@id":"https:\/\/www.unipile.com\/gmail-api-scopes-guide\/#primaryimage"},"thumbnailUrl":"https:\/\/www.unipile.com\/wp-content\/uploads\/2026\/05\/em-23-gmail-api-scopes.png","datePublished":"2026-05-25T13:25:16+00:00","dateModified":"2026-05-25T13:38:11+00:00","description":"Her Gmail API kapsam\u0131 a\u00e7\u0131kland\u0131: gmail.readonly, gmail.modify, gmail.send ve daha fazlas\u0131. Kullan\u0131m durumunuz i\u00e7in minimum kapsam\u0131 se\u00e7in + Node.js ve Python'da kod \u00f6rnekleri.","breadcrumb":{"@id":"https:\/\/www.unipile.com\/gmail-api-scopes-guide\/#breadcrumb"},"inLanguage":"tr","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.unipile.com\/gmail-api-scopes-guide\/"]}]},{"@type":"ImageObject","inLanguage":"tr","@id":"https:\/\/www.unipile.com\/gmail-api-scopes-guide\/#primaryimage","url":"https:\/\/www.unipile.com\/wp-content\/uploads\/2026\/05\/em-23-gmail-api-scopes.png","contentUrl":"https:\/\/www.unipile.com\/wp-content\/uploads\/2026\/05\/em-23-gmail-api-scopes.png","width":2400,"height":1260,"caption":"Gmail API Scopes: 14 OAuth permissions across 3 sensitivity levels"},{"@type":"BreadcrumbList","@id":"https:\/\/www.unipile.com\/gmail-api-scopes-guide\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Accueil","item":"https:\/\/www.unipile.com\/"},{"@type":"ListItem","position":2,"name":"Gmail API Scopes Explained: Choose the Right Permissions for Your App"}]},{"@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\/278951","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=278951"}],"version-history":[{"count":4,"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/posts\/278951\/revisions"}],"predecessor-version":[{"id":278968,"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/posts\/278951\/revisions\/278968"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/media\/278967"}],"wp:attachment":[{"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/media?parent=278951"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/categories?post=278951"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/tags?post=278951"},{"taxonomy":"post_folder","embeddable":true,"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/post_folder?post=278951"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}

{"id":278951,"date":"2026-05-25T15:25:16","date_gmt":"2026-05-25T13:25:16","guid":{"rendered":"https:\/\/www.unipile.com\/?p=278951"},"modified":"2026-05-25T15:38:11","modified_gmt":"2026-05-25T13:38:11","slug":"gmail-api-kapsamlari-kilavuzu","status":"publish","type":"post","link":"https:\/\/www.unipile.com\/tr\/gmail-api-scopes-guide\/","title":{"rendered":"Gmail API Kapsamlar\u0131 A\u00e7\u0131klamas\u0131: Uygulaman\u0131z \u0130\u00e7in Do\u011fru \u0130zinleri Se\u00e7in"},"content":{"rendered":"\n[et_pb_section fb_built=”1″ _builder_version=”4.27.3″ background_color=”transparent” custom_padding=”40px|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 – Send Email via API in Python TOC<\/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 { margin: 0; padding: 0; background: #f4f5f7; font-family: 'Inter', sans-serif;}<\/style><\/head><body><link href=\"https:\/\/fonts.googleapis.com\/css2?family=Inter:wght@400;500;600;700&family=Poppins:wght@700;800&display=swap\" rel=\"stylesheet\"><style>#unipile-toc,#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 { all: initial !important; 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 .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 !important; margin-top: 22px !important; padding-top: 22px !important; border-top: 1px solid #e5e7eb !important; } #unipile-toc.utc-collapsed .utc-grid { max-height: 0 !important; margin-top: 0 !important; padding-top: 0 !important; border-top: none !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><div id=\"unipile-toc\" class=\"utc-collapsed\"> <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\"> <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\">Getting Started<\/span> <div class=\"utc-link-list\"> <a class=\"utc-link\" href=\"#pe-why\"> <span class=\"utc-num\">01<\/span> <span class=\"utc-link-text\">Why Send Email via API<\/span> <\/a> <a class=\"utc-link\" href=\"#pe-prereq\"> <span class=\"utc-num\">02<\/span> <span class=\"utc-link-text\">Prerequisites & Setup<\/span> <\/a> <a class=\"utc-link\" href=\"#pe-methods\"> <span class=\"utc-num\">03<\/span> <span class=\"utc-link-text\">Choosing Your Method<\/span> <\/a> <\/div> <\/div>  <div class=\"utc-col\"> <span class=\"utc-col-label\">Provider Examples<\/span> <div class=\"utc-link-list\"> <a class=\"utc-link\" href=\"#pe-gmail\"> <span class=\"utc-num\">04<\/span> <span class=\"utc-link-text\">Sending via Gmail<\/span> <\/a> <a class=\"utc-link\" href=\"#pe-outlook\"> <span class=\"utc-num\">05<\/span> <span class=\"utc-link-text\">Sending via Outlook<\/span> <\/a> <a class=\"utc-link\" href=\"#pe-smtp\"> <span class=\"utc-num\">06<\/span> <span class=\"utc-link-text\">Sending via SMTP<\/span> <\/a> <\/div> <\/div>  <div class=\"utc-col\"> <span class=\"utc-col-label\">Going Further<\/span> <div class=\"utc-link-list\"> <a class=\"utc-link\" href=\"#pe-attachments\"> <span class=\"utc-num\">07<\/span> <span class=\"utc-link-text\">Attachments & HTML Emails<\/span> <\/a> <a class=\"utc-link\" href=\"#pe-errors\"> <span class=\"utc-num\">08<\/span> <span class=\"utc-link-text\">Error Handling & Delivery<\/span> <\/a> <\/div> <\/div>  <div class=\"utc-col\"> <span class=\"utc-col-label\">Help & Resources<\/span> <div class=\"utc-link-list\"> <a class=\"utc-link\" href=\"#pe-unipile\"> <span class=\"utc-num\">09<\/span> <span class=\"utc-link-text\">Send with Unipile<span class=\"utc-tag-best\">Best<\/span><\/span> <\/a> <a class=\"utc-link\" href=\"#pe-faq\"> <span class=\"utc-num utc-num-faq\">FAQ<\/span> <span class=\"utc-link-text\">Frequently Asked Questions<\/span> <\/a> <\/div> <\/div> <\/div> <\/div><\/div><script>(function(){ var toc = document.getElementById('unipile-toc'); if (!toc) return; var toggleBtn = toc.querySelector('.utc-toggle'); var toggleLabel = toc.querySelector('.utc-toggle-label'); if (toggleBtn) { toggleBtn.addEventListener('click', function(){ var isCollapsed = toc.classList.toggle('utc-collapsed'); if (toggleLabel) toggleLabel.textContent = isCollapsed ? 'Show' : 'Hide'; }); \/\/ Mobile: rester ferm\u00e9. Desktop: ouvrir (la grille s'affiche toujours >700px). if (window.innerWidth > 700) { toc.classList.remove('utc-collapsed'); if (toggleLabel) toggleLabel.textContent = 'Hide'; } else { toc.classList.add('utc-collapsed'); if (toggleLabel) toggleLabel.textContent = 'Show'; } } 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' }); } }); }); 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 Scopes 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; }#unipile-gas-hero,#unipile-gas-hero *,#unipile-gas-hero *::before,#unipile-gas-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;}#unipile-gas-hero { padding: 64px 20px 60px !important; overflow: hidden !important;}#unipile-gas-hero .gas-hero-inner { max-width: 1100px !important; width: 100% !important; margin: 0 auto !important; display: grid !important; grid-template-columns: 1fr 1fr !important; gap: 56px !important; align-items: center !important;}\/* Empeche les colonnes Grid de deborder a cause du contenu non-cassable (code en white-space: pre) *\/#unipile-gas-hero .gas-hero-inner > div { min-width: 0 !important;}#unipile-gas-hero .gas-eyebrow { 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; width: fit-content !important; margin-bottom: 20px !important;}#unipile-gas-hero .gas-eyebrow-dot { width: 7px !important; height: 7px !important; background: #3BB98B !important; border-radius: 50% !important; flex-shrink: 0 !important; display: inline-block !important;}#unipile-gas-hero h2.gas-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;}#unipile-gas-hero h2.gas-h1 .gas-accent { color: #3BB98B !important;}#unipile-gas-hero .gas-desc { font-size: 16px !important; line-height: 1.75 !important; color: #383838 !important; margin-bottom: 28px !important;}#unipile-gas-hero .gas-desc code { font-family: 'Courier New', monospace !important; background: rgba(15,39,54,0.06) !important; color: #0f2736 !important; padding: 1px 6px !important; border-radius: 4px !important; font-size: 13.5px !important; white-space: nowrap !important;}#unipile-gas-hero .gas-meta { display: flex !important; align-items: center !important; gap: 16px !important; flex-wrap: wrap !important; margin-bottom: 28px !important;}#unipile-gas-hero .gas-meta-item { display: flex !important; align-items: center !important; gap: 6px !important; font-size: 13px !important; color: #718096 !important;}#unipile-gas-hero .gas-meta-item svg { width: 14px !important; height: 14px !important; stroke: #3BB98B !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important; flex-shrink: 0 !important;}#unipile-gas-hero .gas-meta-sep { width: 4px !important; height: 4px !important; background: #cbd5e0 !important; border-radius: 50% !important; flex-shrink: 0 !important; display: inline-block !important;}#unipile-gas-hero .gas-tags { display: flex !important; flex-wrap: wrap !important; gap: 8px !important; margin-bottom: 32px !important;}#unipile-gas-hero .gas-tag { background: #ffffff !important; color: #4a5568 !important; padding: 5px 12px !important; border-radius: 6px !important; font-size: 12px !important; font-weight: 500 !important; border: 1px solid #e2e8f0 !important;}#unipile-gas-hero .gas-actions { display: flex !important; align-items: center !important; gap: 14px !important; flex-wrap: wrap !important;}#unipile-gas-hero .gas-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: 15px !important; font-weight: 600 !important; border: 2px solid #DDDF4C !important; transition: all 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important;}#unipile-gas-hero .gas-cta-primary:hover { transform: translateY(-5px) !important;}#unipile-gas-hero .gas-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; flex-shrink: 0 !important;}#unipile-gas-hero .gas-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: 15px !important; font-weight: 600 !important; border: 2px solid #0f2736 !important; transition: all 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important;}#unipile-gas-hero .gas-cta-secondary:hover { background: #0f2736 !important; color: #ffffff !important;}\/* Code mockup *\/#unipile-gas-hero .gas-code-wrap { border-radius: 14px !important; overflow: hidden !important; background: #0d1117 !important; max-width: 100% !important;}#unipile-gas-hero .gas-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;}#unipile-gas-hero .gas-dot { width: 12px !important; height: 12px !important; border-radius: 50% !important; display: inline-block !important; flex-shrink: 0 !important;}#unipile-gas-hero .gas-dot-r { background: #ff5f57 !important; }#unipile-gas-hero .gas-dot-y { background: #febc2e !important; }#unipile-gas-hero .gas-dot-g { background: #28c840 !important; }#unipile-gas-hero .gas-filename { color: #8b949e !important; font-size: 13px !important; margin-left: 6px !important; font-family: 'Courier New', monospace !important;}#unipile-gas-hero .gas-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;}#unipile-gas-hero .gas-pre code { font-family: 'Courier New', monospace !important; white-space: pre !important; display: block !important;}#unipile-gas-hero .gc { color: #8b949e !important; }#unipile-gas-hero .gk { color: #ff7b72 !important; }#unipile-gas-hero .gfn { color: #d2a8ff !important; }#unipile-gas-hero .gs { color: #a5d6ff !important; }#unipile-gas-hero .gw { color: #e6edf3 !important; }#unipile-gas-hero .gn { color: #79c0ff !important; }#unipile-gas-hero .gas-scope-tag { display: inline-block !important; background: rgba(59, 185, 139, 0.15) !important; color: #3BB98B !important; padding: 2px 8px !important; border-radius: 4px !important; font-size: 11.5px !important; font-family: 'Courier New', monospace !important; font-weight: 600 !important; white-space: nowrap !important;}#unipile-gas-hero .gas-scope-list { padding: 16px 24px !important; background: #0d1117 !important; display: flex !important; flex-direction: column !important; gap: 8px !important; border-top: 1px solid rgba(255,255,255,0.06) !important;}#unipile-gas-hero .gas-scope-row { display: flex !important; align-items: center !important; gap: 10px !important; flex-wrap: wrap !important;}#unipile-gas-hero .gas-scope-label { font-size: 11.5px !important; color: #8b949e !important; font-family: 'Courier New', monospace !important;}#unipile-gas-hero .gas-scope-badge { display: inline-flex !important; align-items: center !important; gap: 4px !important; padding: 2px 8px !important; border-radius: 4px !important; font-size: 10px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.4px !important; font-family: 'Inter', sans-serif !important;}#unipile-gas-hero .gas-badge-restricted { background: rgba(234, 67, 53, 0.15) !important; color: #ea4335 !important;}#unipile-gas-hero .gas-badge-sensitive { background: rgba(251, 188, 4, 0.15) !important; color: #d97706 !important;}#unipile-gas-hero .gas-badge-basic { background: rgba(59, 185, 139, 0.15) !important; color: #2aaa7e !important;}@media (max-width: 900px) { #unipile-gas-hero { padding: 50px 20px !important; } #unipile-gas-hero .gas-hero-inner { grid-template-columns: 1fr !important; gap: 40px !important; } #unipile-gas-hero h2.gas-h1 { font-size: 32px !important; }}@media (max-width: 600px) { #unipile-gas-hero { padding: 40px 16px !important; } #unipile-gas-hero h2.gas-h1 { font-size: 28px !important; } #unipile-gas-hero .gas-desc { font-size: 15px !important; } #unipile-gas-hero .gas-actions { flex-direction: column !important; align-items: stretch !important; } #unipile-gas-hero .gas-cta-primary, #unipile-gas-hero .gas-cta-secondary { justify-content: center !important; width: 100% !important; } #unipile-gas-hero .gas-pre { padding: 18px 16px !important; font-size: 11.5px !important; line-height: 1.7 !important; } #unipile-gas-hero .gas-scope-list { padding: 14px 16px !important; }}@media (max-width: 400px) { #unipile-gas-hero h2.gas-h1 { font-size: 24px !important; } #unipile-gas-hero .gas-pre { font-size: 10.5px !important; }}<\/style><div id=\"unipile-gas-hero\"> <div class=\"gas-hero-inner\"> <div class=\"gas-hero-left\"> <div class=\"gas-eyebrow\"><span class=\"gas-eyebrow-dot\"><\/span><span>Gmail API Guide<\/span><\/div> <h2 class=\"gas-h1\">Gmail API Scopes Explained: Choose the <span class=\"gas-accent\">Right Permissions<\/span> for Your App<\/h2> <pee class=\"gas-desc\">Every Gmail API scope documented: from <code>gmail.readonly<\/code> to <code>mail.google.com<\/code>. Understand the 3 sensitivity levels, pick the minimum scope your app actually needs, and ship your OAuth flow faster.<\/pee> <div class=\"gas-actions\"> <a class=\"gas-cta-primary\" href=\"https:\/\/dashboard.unipile.com\/signup\/\" 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><\/a> <a class=\"gas-cta-secondary\" href=\"https:\/\/www.unipile.com\/email-api-guide\/\" target=\"_self\"><span>Email API Guide<\/span><\/a> <\/div> <\/div> <div class=\"gas-hero-right\"> <div class=\"gas-code-wrap\"> <div class=\"gas-editor-bar\"> <span class=\"gas-dot gas-dot-r\"><\/span> <span class=\"gas-dot gas-dot-y\"><\/span> <span class=\"gas-dot gas-dot-g\"><\/span> <span class=\"gas-filename\">gmail-oauth-scopes.js<\/span> <\/div> <div class=\"gas-pre\"><code><span class=\"gc\">\/\/ Request Gmail API scopes in OAuth flow<\/span><span class=\"gk\">const<\/span> <span class=\"gw\">SCOPES<\/span> <span class=\"gw\">=<\/span> <span class=\"gw\">[<\/span> <span class=\"gs\">'https:\/\/www.googleapis.com\/auth\/gmail.readonly'<\/span><span class=\"gw\">,<\/span> <span class=\"gs\">'https:\/\/www.googleapis.com\/auth\/gmail.send'<\/span><span class=\"gw\">,<\/span> <span class=\"gs\">'https:\/\/www.googleapis.com\/auth\/gmail.labels'<\/span><span class=\"gw\">,<\/span><span class=\"gw\">];<\/span><span class=\"gk\">const<\/span> <span class=\"gw\">authUrl<\/span> <span class=\"gw\">=<\/span> <span class=\"gw\">oauth2Client.<\/span><span class=\"gfn\">generateAuthUrl<\/span><span class=\"gw\">({<\/span> <span class=\"gw\">access_type:<\/span> <span class=\"gs\">'offline'<\/span><span class=\"gw\">,<\/span> <span class=\"gw\">scope:<\/span> <span class=\"gw\">SCOPES,<\/span> <span class=\"gw\">prompt:<\/span> <span class=\"gs\">'consent'<\/span><span class=\"gw\">,<\/span><span class=\"gw\">});<\/span><\/code><\/div> <div class=\"gas-scope-list\"> <div class=\"gas-scope-row\"> <span class=\"gas-scope-label\">gmail.readonly<\/span> <span class=\"gas-scope-badge gas-badge-restricted\"><span>Restricted<\/span><\/span> <\/div> <div class=\"gas-scope-row\"> <span class=\"gas-scope-label\">gmail.send<\/span> <span class=\"gas-scope-badge gas-badge-sensitive\"><span>Sensitive<\/span><\/span> <\/div> <div class=\"gas-scope-row\"> <span class=\"gas-scope-label\">gmail.labels<\/span> <span class=\"gas-scope-badge gas-badge-basic\"><span>Non-sensitive<\/span><\/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.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>#unipile-gas-what,#unipile-gas-what *,#unipile-gas-what *::before,#unipile-gas-what *::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;}#unipile-gas-what { background: #f4f5f7 !important; padding: 72px 20px !important;}#unipile-gas-what .gas-what-inner { max-width: 1100px !important; margin: 0 auto !important;}#unipile-gas-what .gas-eyebrow { 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; width: fit-content !important; margin-bottom: 16px !important;}#unipile-gas-what .gas-eyebrow-dot { width: 7px !important; height: 7px !important; background: #3BB98B !important; border-radius: 50% !important; flex-shrink: 0 !important; display: inline-block !important;}#unipile-gas-what 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;}#unipile-gas-what .gas-intro { font-size: 16px !important; line-height: 1.75 !important; color: #383838 !important; margin-bottom: 36px !important;}#unipile-gas-what .gas-definition-card { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; padding: 32px !important; margin-bottom: 32px !important; border-left: 4px solid #3BB98B !important;}#unipile-gas-what .gas-definition-label { font-size: 11px !important; font-weight: 700 !important; color: #94a3b8 !important; text-transform: uppercase !important; letter-spacing: 0.8px !important; margin-bottom: 12px !important; display: block !important;}#unipile-gas-what .gas-definition-text { font-size: 17px !important; line-height: 1.75 !important; color: #1e293b !important; font-weight: 400 !important;}#unipile-gas-what .gas-definition-text strong { color: #0f2736 !important; font-weight: 700 !important;}#unipile-gas-what .gas-why-grid { display: grid !important; grid-template-columns: repeat(3, 1fr) !important; gap: 20px !important; margin-bottom: 36px !important;}#unipile-gas-what .gas-why-card { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; padding: 24px !important;}#unipile-gas-what .gas-why-icon { width: 44px !important; height: 44px !important; border-radius: 10px !important; background: rgba(59, 185, 139, 0.12) !important; display: flex !important; align-items: center !important; justify-content: center !important; margin-bottom: 14px !important;}#unipile-gas-what .gas-why-icon svg { width: 22px !important; height: 22px !important; stroke: #3BB98B !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}#unipile-gas-what .gas-why-title { font-size: 15px !important; font-weight: 700 !important; color: #0f2736 !important; margin-bottom: 8px !important; display: block !important;}#unipile-gas-what .gas-why-text { font-size: 14px !important; line-height: 1.65 !important; color: #4a5568 !important;}#unipile-gas-what .gas-cta-strip { background: #0f2736 !important; border-radius: 16px !important; padding: 28px 32px !important; display: flex !important; align-items: center !important; justify-content: space-between !important; gap: 20px !important; flex-wrap: wrap !important;}#unipile-gas-what .gas-cta-strip-text { font-size: 16px !important; color: rgba(255,255,255,0.88) !important; line-height: 1.5 !important;}#unipile-gas-what .gas-cta-strip-text strong { color: #ffffff !important; font-weight: 700 !important;}#unipile-gas-what .gas-cta-btn { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: #DDDF4C !important; color: #0f2736 !important; padding: 12px 24px !important; border-radius: 8px !important; font-size: 14px !important; font-weight: 700 !important; border: 2px solid #DDDF4C !important; transition: all 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important; text-decoration: none !important;}#unipile-gas-what .gas-cta-btn:hover { transform: translateY(-5px) !important;}#unipile-gas-what .gas-cta-btn svg { width: 15px !important; height: 15px !important; stroke: currentColor !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) { #unipile-gas-what { padding: 56px 20px !important; } #unipile-gas-what h2 { font-size: 28px !important; } #unipile-gas-what .gas-why-grid { grid-template-columns: 1fr !important; } #unipile-gas-what .gas-cta-strip { flex-direction: column !important; text-align: center !important; } #unipile-gas-what .gas-cta-btn { width: 100% !important; justify-content: center !important; }}@media (max-width: 600px) { #unipile-gas-what { padding: 44px 16px !important; } #unipile-gas-what h2 { font-size: 26px !important; } #unipile-gas-what .gas-definition-card { padding: 24px 20px !important; }}<\/style><div id=\"unipile-gas-what\"> <span id=\"gas-what\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"gas-what-inner\"> <div class=\"gas-eyebrow\"><span class=\"gas-eyebrow-dot\"><\/span><span>Fundamentals<\/span><\/div> <h2>What Are Gmail API Scopes?<\/h2> <pee class=\"gas-intro\">Before writing a single line of OAuth code, you need to understand what Gmail API scopes are and why choosing the wrong one can block your app from going to production. This section gives you the foundational knowledge in under two minutes.<\/pee> <div class=\"gas-definition-card\"> <span class=\"gas-definition-label\">Definition<\/span> <pee class=\"gas-definition-text\"><strong>Gmail API scopes<\/strong> are OAuth 2.0 permission strings that define exactly which Gmail resources your application can access on behalf of a user. When a user authorizes your app, Google presents a consent screen listing the Gmail API scopes your app requested. The user grants or denies access based on those scopes. Once granted, your access token is limited to exactly the actions those scopes permit – nothing more.<\/pee> <\/div> <div class=\"gas-why-grid\"> <div class=\"gas-why-card\"> <div class=\"gas-why-icon\"> <svg viewBox=\"0 0 24 24\"><path d=\"M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10z\"\/><\/svg> <\/div> <span class=\"gas-why-title\">Security boundary<\/span> <pee class=\"gas-why-text\">Gmail API scopes create a hard boundary around what your token can do. Even if your server is compromised, an attacker with a <code>gmail.readonly<\/code> token cannot send or delete emails. Scopes are enforced server-side by Google.<\/pee> <\/div> <div class=\"gas-why-card\"> <div class=\"gas-why-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> <span class=\"gas-why-title\">Google verification gate<\/span> <pee class=\"gas-why-text\">Restricted Gmail API scopes require your app to pass Google’s security assessment before you can use them in production with more than 100 test users. The wrong scope choice can add weeks or months to your launch timeline.<\/pee> <\/div> <div class=\"gas-why-card\"> <div class=\"gas-why-icon\"> <svg viewBox=\"0 0 24 24\"><polyline points=\"22 12 18 12 15 21 9 3 6 12 2 12\"\/><\/svg> <\/div> <span class=\"gas-why-title\">User trust signal<\/span> <pee class=\"gas-why-text\">Requesting more Gmail API permissions than your app needs triggers a “This app wants broad access to your Google Account” warning. Minimal Gmail API scopes produce a simpler consent screen, increasing conversion and user trust.<\/pee> <\/div> <\/div> <div class=\"gas-cta-strip\"> <pee class=\"gas-cta-strip-text\"><strong>Skip scope management entirely.<\/strong> Unipile handles Gmail OAuth and scopes internally – your team focuses on product logic, not permission strings.<\/pee> <a class=\"gas-cta-btn\" href=\"https:\/\/dashboard.unipile.com\/signup\/\" 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><\/a> <\/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.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 Scope Sensitivity Levels<\/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-gas-levels,#unipile-gas-levels *,#unipile-gas-levels *::before,#unipile-gas-levels *::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;}#unipile-gas-levels { padding: 72px 20px !important; overflow: hidden !important;}#unipile-gas-levels .gas-levels-inner { max-width: 1100px !important; width: 100% !important; margin: 0 auto !important;}#unipile-gas-levels .gas-eyebrow { 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; width: fit-content !important; margin-bottom: 16px !important;}#unipile-gas-levels .gas-eyebrow-dot { width: 7px !important; height: 7px !important; background: #3BB98B !important; border-radius: 50% !important; flex-shrink: 0 !important; display: inline-block !important;}#unipile-gas-levels 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;}#unipile-gas-levels .gas-intro { font-size: 16px !important; line-height: 1.75 !important; color: #383838 !important; margin-bottom: 40px !important;}#unipile-gas-levels .gas-levels-grid { display: grid !important; grid-template-columns: repeat(3, 1fr) !important; gap: 20px !important; margin-bottom: 40px !important;}#unipile-gas-levels .gas-levels-grid > div { min-width: 0 !important;}#unipile-gas-levels .gas-level-card { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; padding: 28px !important; position: relative !important;}#unipile-gas-levels .gas-level-badge { 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; text-transform: uppercase !important; letter-spacing: 0.4px !important; margin-bottom: 16px !important; width: fit-content !important;}#unipile-gas-levels .gas-badge-ns { background: rgba(59, 185, 139, 0.12) !important; color: #2aaa7e !important;}#unipile-gas-levels .gas-badge-s { background: rgba(251, 188, 4, 0.15) !important; color: #d97706 !important;}#unipile-gas-levels .gas-badge-r { background: rgba(234, 67, 53, 0.12) !important; color: #dc2626 !important;}#unipile-gas-levels .gas-level-dot { width: 8px !important; height: 8px !important; border-radius: 50% !important; flex-shrink: 0 !important; display: inline-block !important;}#unipile-gas-levels .gas-dot-ns { background: #3BB98B !important; }#unipile-gas-levels .gas-dot-s { background: #f59e0b !important; }#unipile-gas-levels .gas-dot-r { background: #ef4444 !important; }#unipile-gas-levels .gas-level-title { font-family: 'Poppins', sans-serif !important; font-size: 18px !important; font-weight: 700 !important; color: #0f2736 !important; margin-bottom: 12px !important; display: block !important;}#unipile-gas-levels .gas-level-desc { font-size: 14px !important; line-height: 1.7 !important; color: #4a5568 !important; margin-bottom: 18px !important;}#unipile-gas-levels .gas-level-divider { height: 1px !important; background: #e5e7eb !important; margin-bottom: 16px !important;}#unipile-gas-levels .gas-level-meta-row { display: flex !important; align-items: flex-start !important; gap: 8px !important; margin-bottom: 10px !important;}#unipile-gas-levels .gas-level-meta-label { font-size: 11px !important; font-weight: 700 !important; color: #94a3b8 !important; text-transform: uppercase !important; letter-spacing: 0.5px !important; min-width: 80px !important; padding-top: 1px !important; flex-shrink: 0 !important; display: block !important;}#unipile-gas-levels .gas-level-meta-val { font-size: 13px !important; color: #383838 !important; line-height: 1.5 !important;}#unipile-gas-levels .gas-level-scopes { display: flex !important; flex-direction: column !important; gap: 6px !important; margin-top: 4px !important;}#unipile-gas-levels .gas-scope-chip { display: inline-block !important; background: #f4f5f7 !important; color: #383838 !important; padding: 3px 10px !important; border-radius: 5px !important; font-size: 12px !important; font-family: 'Courier New', monospace !important; font-weight: 500 !important; width: fit-content !important; max-width: 100% !important; overflow-wrap: break-word !important; word-break: break-all !important;}\/* ===== Desktop table ===== *\/#unipile-gas-levels .gas-comparison-table { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; overflow: hidden !important; margin-bottom: 32px !important; width: 100% !important;}#unipile-gas-levels .gas-comparison-table table { width: 100% !important; border-collapse: collapse !important;}#unipile-gas-levels .gas-comparison-table thead tr { background: #0f2736 !important;}#unipile-gas-levels .gas-comparison-table thead th { padding: 14px 18px !important; font-size: 12px !important; font-weight: 700 !important; color: rgba(255,255,255,0.85) !important; text-align: left !important; text-transform: uppercase !important; letter-spacing: 0.5px !important;}#unipile-gas-levels .gas-comparison-table tbody tr { border-bottom: 1px solid #f0f2f5 !important;}#unipile-gas-levels .gas-comparison-table tbody tr:last-child { border-bottom: none !important;}#unipile-gas-levels .gas-comparison-table tbody td { padding: 14px 18px !important; font-size: 14px !important; color: #383838 !important; vertical-align: middle !important;}#unipile-gas-levels .gas-comparison-table tbody tr:hover { background: #f8fafc !important;}#unipile-gas-levels .gas-tbl-badge { display: inline-flex !important; align-items: center !important; gap: 5px !important; padding: 4px 10px !important; border-radius: 12px !important; font-size: 11px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.3px !important; white-space: nowrap !important;}#unipile-gas-levels .tbl-ns { background: rgba(59, 185, 139, 0.12) !important; color: #2aaa7e !important;}#unipile-gas-levels .tbl-s { background: rgba(251, 188, 4, 0.15) !important; color: #d97706 !important;}#unipile-gas-levels .tbl-r { background: rgba(234, 67, 53, 0.12) !important; color: #dc2626 !important;}#unipile-gas-levels .gas-check { color: #3BB98B !important; font-weight: 700 !important; font-size: 16px !important;}#unipile-gas-levels .gas-cross { color: #ef4444 !important; font-weight: 700 !important; font-size: 16px !important;}#unipile-gas-levels .gas-partial { color: #f59e0b !important; font-weight: 700 !important; font-size: 16px !important;}\/* ===== Mobile cards (hidden on desktop) ===== *\/#unipile-gas-levels .gas-cmp-cards { display: none !important;}#unipile-gas-levels .gas-cmp-card { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 14px !important; overflow: hidden !important; margin-bottom: 14px !important;}#unipile-gas-levels .gas-cmp-card:last-child { margin-bottom: 0 !important;}#unipile-gas-levels .gas-cmp-card-head { background: #0f2736 !important; padding: 13px 16px !important;}#unipile-gas-levels .gas-cmp-card-title { font-size: 14px !important; font-weight: 700 !important; color: #ffffff !important; line-height: 1.4 !important;}#unipile-gas-levels .gas-cmp-row { display: flex !important; align-items: center !important; justify-content: space-between !important; gap: 12px !important; padding: 11px 16px !important; border-bottom: 1px solid #f0f2f5 !important;}#unipile-gas-levels .gas-cmp-row:last-child { border-bottom: none !important;}#unipile-gas-levels .gas-cmp-level { display: inline-flex !important; align-items: center !important; gap: 7px !important; font-size: 12px !important; font-weight: 600 !important; color: #4a5568 !important;}#unipile-gas-levels .gas-cmp-level .gas-level-dot { width: 7px !important; height: 7px !important;}#unipile-gas-levels .gas-cmp-val { font-size: 13px !important; color: #383838 !important; text-align: right !important; font-weight: 500 !important;}@media (max-width: 900px) { #unipile-gas-levels { padding: 56px 20px !important; } #unipile-gas-levels h2 { font-size: 28px !important; } #unipile-gas-levels .gas-levels-grid { grid-template-columns: 1fr !important; }}@media (max-width: 600px) { #unipile-gas-levels { padding: 44px 16px !important; } #unipile-gas-levels h2 { font-size: 26px !important; } #unipile-gas-levels .gas-level-card { padding: 22px !important; } \/* Switch table -> cards *\/ #unipile-gas-levels .gas-comparison-table { display: none !important; } #unipile-gas-levels .gas-cmp-cards { display: block !important; }}@media (max-width: 400px) { #unipile-gas-levels h2 { font-size: 22px !important; }}<\/style><div id=\"unipile-gas-levels\"> <span id=\"gas-levels\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"gas-levels-inner\"> <div class=\"gas-eyebrow\"><span class=\"gas-eyebrow-dot\"><\/span><span>Scope Classification<\/span><\/div> <h2>The 3 Sensitivity Levels Explained<\/h2> <pee class=\"gas-intro\">Google classifies all Gmail API scopes into 3 sensitivity levels. Each level determines the verification requirements before your app can go live. Understanding this classification is the most important decision you make when planning your Gmail integration.<\/pee> <div class=\"gas-levels-grid\"> <div class=\"gas-level-card\"> <div class=\"gas-level-badge gas-badge-ns\"><span class=\"gas-level-dot gas-dot-ns\"><\/span><span>Non-sensitive<\/span><\/div> <span class=\"gas-level-title\">Non-sensitive Scopes<\/span> <pee class=\"gas-level-desc\">The lowest risk tier. These scopes access limited, non-personal Gmail data. Google does not require a formal security assessment to use them in production.<\/pee> <div class=\"gas-level-divider\"><\/div> <div class=\"gas-level-meta-row\"> <span class=\"gas-level-meta-label\">Verification<\/span> <span class=\"gas-level-meta-val\">Standard OAuth app review only<\/span> <\/div> <div class=\"gas-level-meta-row\"> <span class=\"gas-level-meta-label\">Test users<\/span> <span class=\"gas-level-meta-val\">Unlimited once app is verified<\/span> <\/div> <div class=\"gas-level-meta-row\"> <span class=\"gas-level-meta-label\">Examples<\/span> <div class=\"gas-level-scopes\"> <span class=\"gas-scope-chip\">gmail.labels<\/span> <span class=\"gas-scope-chip\">gmail.addons.current.action.compose<\/span> <\/div> <\/div> <\/div> <div class=\"gas-level-card\"> <div class=\"gas-level-badge gas-badge-s\"><span class=\"gas-level-dot gas-dot-s\"><\/span><span>Sensitive<\/span><\/div> <span class=\"gas-level-title\">Sensitive Scopes<\/span> <pee class=\"gas-level-desc\">Medium risk tier. These scopes access Gmail message data that could expose personal information. Additional verification is required before production use.<\/pee> <div class=\"gas-level-divider\"><\/div> <div class=\"gas-level-meta-row\"> <span class=\"gas-level-meta-label\">Verification<\/span> <span class=\"gas-level-meta-val\">Google OAuth app verification required<\/span> <\/div> <div class=\"gas-level-meta-row\"> <span class=\"gas-level-meta-label\">Test users<\/span> <span class=\"gas-level-meta-val\">Up to 100 while in testing<\/span> <\/div> <div class=\"gas-level-meta-row\"> <span class=\"gas-level-meta-label\">Examples<\/span> <div class=\"gas-level-scopes\"> <span class=\"gas-scope-chip\">gmail.send<\/span> <span class=\"gas-scope-chip\">gmail.addons.current.message.readonly<\/span> <\/div> <\/div> <\/div> <div class=\"gas-level-card\"> <div class=\"gas-level-badge gas-badge-r\"><span class=\"gas-level-dot gas-dot-r\"><\/span><span>Restricted<\/span><\/div> <span class=\"gas-level-title\">Restricted Scopes<\/span> <pee class=\"gas-level-desc\">Highest risk tier. These scopes grant broad or sensitive access to Gmail data. Google requires a formal security assessment by an approved third-party auditor.<\/pee> <div class=\"gas-level-divider\"><\/div> <div class=\"gas-level-meta-row\"> <span class=\"gas-level-meta-label\">Verification<\/span> <span class=\"gas-level-meta-val\">Annual security assessment (~$500\/yr)<\/span> <\/div> <div class=\"gas-level-meta-row\"> <span class=\"gas-level-meta-label\">Test users<\/span> <span class=\"gas-level-meta-val\">Up to 100 while in testing<\/span> <\/div> <div class=\"gas-level-meta-row\"> <span class=\"gas-level-meta-label\">Examples<\/span> <div class=\"gas-level-scopes\"> <span class=\"gas-scope-chip\">gmail.readonly<\/span> <span class=\"gas-scope-chip\">gmail.modify<\/span> <span class=\"gas-scope-chip\">mail.google.com\/<\/span> <\/div> <\/div> <\/div> <\/div>  <div class=\"gas-comparison-table\"> <table> <thead> <tr> <th>Criteria<\/th> <th>Non-sensitive<\/th> <th>Sensitive<\/th> <th>Restricted<\/th> <\/tr> <\/thead> <tbody> <tr> <td>Accesses message body<\/td> <td><span class=\"gas-cross\">No<\/span><\/td> <td><span class=\"gas-partial\">Sometimes<\/span><\/td> <td><span class=\"gas-check\">Yes<\/span><\/td> <\/tr> <tr> <td>Security assessment required<\/td> <td><span class=\"gas-cross\">No<\/span><\/td> <td><span class=\"gas-cross\">No<\/span><\/td> <td><span class=\"gas-check\">Yes<\/span><\/td> <\/tr> <tr> <td>App review required<\/td> <td><span class=\"gas-check\">Yes<\/span><\/td> <td><span class=\"gas-check\">Yes<\/span><\/td> <td><span class=\"gas-check\">Yes<\/span><\/td> <\/tr> <tr> <td>Annual re-certification<\/td> <td><span class=\"gas-cross\">No<\/span><\/td> <td><span class=\"gas-cross\">No<\/span><\/td> <td><span class=\"gas-check\">Yes<\/span><\/td> <\/tr> <tr> <td>Consent screen warning level<\/td> <td>Standard<\/td> <td>Standard + disclosure<\/td> <td>Broad access warning<\/td> <\/tr> <tr> <td>Typical cost to verify<\/td> <td>Free<\/td> <td>Free<\/td> <td>~$500\/yr (assessor)<\/td> <\/tr> <\/tbody> <\/table> <\/div>  <div class=\"gas-cmp-cards\"> <div class=\"gas-cmp-card\"> <div class=\"gas-cmp-card-head\"><div class=\"gas-cmp-card-title\">Accesses message body<\/div><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-ns\"><\/span>Non-sensitive<\/span><span class=\"gas-cmp-val\"><span class=\"gas-cross\">No<\/span><\/span><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-s\"><\/span>Sensitive<\/span><span class=\"gas-cmp-val\"><span class=\"gas-partial\">Sometimes<\/span><\/span><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-r\"><\/span>Restricted<\/span><span class=\"gas-cmp-val\"><span class=\"gas-check\">Yes<\/span><\/span><\/div> <\/div> <div class=\"gas-cmp-card\"> <div class=\"gas-cmp-card-head\"><div class=\"gas-cmp-card-title\">Security assessment required<\/div><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-ns\"><\/span>Non-sensitive<\/span><span class=\"gas-cmp-val\"><span class=\"gas-cross\">No<\/span><\/span><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-s\"><\/span>Sensitive<\/span><span class=\"gas-cmp-val\"><span class=\"gas-cross\">No<\/span><\/span><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-r\"><\/span>Restricted<\/span><span class=\"gas-cmp-val\"><span class=\"gas-check\">Yes<\/span><\/span><\/div> <\/div> <div class=\"gas-cmp-card\"> <div class=\"gas-cmp-card-head\"><div class=\"gas-cmp-card-title\">App review required<\/div><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-ns\"><\/span>Non-sensitive<\/span><span class=\"gas-cmp-val\"><span class=\"gas-check\">Yes<\/span><\/span><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-s\"><\/span>Sensitive<\/span><span class=\"gas-cmp-val\"><span class=\"gas-check\">Yes<\/span><\/span><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-r\"><\/span>Restricted<\/span><span class=\"gas-cmp-val\"><span class=\"gas-check\">Yes<\/span><\/span><\/div> <\/div> <div class=\"gas-cmp-card\"> <div class=\"gas-cmp-card-head\"><div class=\"gas-cmp-card-title\">Annual re-certification<\/div><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-ns\"><\/span>Non-sensitive<\/span><span class=\"gas-cmp-val\"><span class=\"gas-cross\">No<\/span><\/span><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-s\"><\/span>Sensitive<\/span><span class=\"gas-cmp-val\"><span class=\"gas-cross\">No<\/span><\/span><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-r\"><\/span>Restricted<\/span><span class=\"gas-cmp-val\"><span class=\"gas-check\">Yes<\/span><\/span><\/div> <\/div> <div class=\"gas-cmp-card\"> <div class=\"gas-cmp-card-head\"><div class=\"gas-cmp-card-title\">Consent screen warning level<\/div><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-ns\"><\/span>Non-sensitive<\/span><span class=\"gas-cmp-val\">Standard<\/span><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-s\"><\/span>Sensitive<\/span><span class=\"gas-cmp-val\">Standard + disclosure<\/span><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-r\"><\/span>Restricted<\/span><span class=\"gas-cmp-val\">Broad access warning<\/span><\/div> <\/div> <div class=\"gas-cmp-card\"> <div class=\"gas-cmp-card-head\"><div class=\"gas-cmp-card-title\">Typical cost to verify<\/div><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-ns\"><\/span>Non-sensitive<\/span><span class=\"gas-cmp-val\">Free<\/span><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-s\"><\/span>Sensitive<\/span><span class=\"gas-cmp-val\">Free<\/span><\/div> <div class=\"gas-cmp-row\"><span class=\"gas-cmp-level\"><span class=\"gas-level-dot gas-dot-r\"><\/span>Restricted<\/span><span class=\"gas-cmp-val\">~$500\/yr (assessor)<\/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>#unipile-gas-ref,#unipile-gas-ref *,#unipile-gas-ref *::before,#unipile-gas-ref *::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;}#unipile-gas-ref { background: #f4f5f7 !important; padding: 72px 20px !important;}#unipile-gas-ref .gas-ref-inner { max-width: 1100px !important; margin: 0 auto !important;}#unipile-gas-ref .gas-eyebrow { 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; width: fit-content !important; margin-bottom: 16px !important;}#unipile-gas-ref .gas-eyebrow-dot { width: 7px !important; height: 7px !important; background: #DDDF4C !important; border-radius: 50% !important; flex-shrink: 0 !important; display: inline-block !important;}#unipile-gas-ref 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;}#unipile-gas-ref .gas-intro { font-size: 16px !important; line-height: 1.75 !important; color: #383838 !important; margin-bottom: 40px !important;}#unipile-gas-ref .gas-section-label { display: flex !important; align-items: center !important; gap: 10px !important; margin-bottom: 16px !important;}#unipile-gas-ref .gas-section-badge { 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; text-transform: uppercase !important; letter-spacing: 0.4px !important; flex-shrink: 0 !important;}#unipile-gas-ref .sec-ns { background: rgba(59, 185, 139, 0.12) !important; color: #2aaa7e !important;}#unipile-gas-ref .sec-s { background: rgba(251, 188, 4, 0.15) !important; color: #d97706 !important;}#unipile-gas-ref .sec-r { background: rgba(234, 67, 53, 0.12) !important; color: #dc2626 !important;}#unipile-gas-ref .gas-sec-dot { width: 8px !important; height: 8px !important; border-radius: 50% !important; flex-shrink: 0 !important; display: inline-block !important;}#unipile-gas-ref .dot-ns { background: #3BB98B !important; }#unipile-gas-ref .dot-s { background: #f59e0b !important; }#unipile-gas-ref .dot-r { background: #ef4444 !important; }#unipile-gas-ref .gas-ref-table { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; overflow: hidden !important; margin-bottom: 32px !important; width: 100% !important;}#unipile-gas-ref .gas-ref-table table { width: 100% !important; border-collapse: collapse !important;}#unipile-gas-ref .gas-ref-table thead tr { background: #0f2736 !important;}#unipile-gas-ref .gas-ref-table thead th { padding: 14px 18px !important; font-size: 11px !important; font-weight: 700 !important; color: rgba(255,255,255,0.75) !important; text-align: left !important; text-transform: uppercase !important; letter-spacing: 0.6px !important;}#unipile-gas-ref .gas-ref-table tbody tr { border-bottom: 1px solid #f0f2f5 !important; transition: background 0.15s ease !important;}#unipile-gas-ref .gas-ref-table tbody tr:last-child { border-bottom: none !important;}#unipile-gas-ref .gas-ref-table tbody tr:hover { background: #f8fafc !important;}#unipile-gas-ref .gas-ref-table tbody td { padding: 14px 18px !important; font-size: 13.5px !important; color: #383838 !important; vertical-align: top !important;}#unipile-gas-ref .gas-ref-table .td-scope { font-family: 'Courier New', monospace !important; font-size: 12.5px !important; color: #0f2736 !important; font-weight: 600 !important; white-space: nowrap !important;}#unipile-gas-ref .gas-ref-table .td-access { min-width: 100px !important;}#unipile-gas-ref .gas-access-badge { display: inline-flex !important; align-items: center !important; gap: 4px !important; padding: 3px 9px !important; border-radius: 10px !important; font-size: 11px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.3px !important; white-space: nowrap !important;}#unipile-gas-ref .acc-ns { background: rgba(59, 185, 139, 0.12) !important; color: #2aaa7e !important; }#unipile-gas-ref .acc-s { background: rgba(251, 188, 4, 0.15) !important; color: #d97706 !important; }#unipile-gas-ref .acc-r { background: rgba(234, 67, 53, 0.12) !important; color: #dc2626 !important; }#unipile-gas-ref .gas-new-badge { display: inline-block !important; background: rgba(59, 185, 139, 0.12) !important; color: #2aaa7e !important; font-size: 9px !important; font-weight: 700 !important; padding: 1px 5px !important; border-radius: 3px !important; text-transform: uppercase !important; letter-spacing: 0.3px !important; vertical-align: middle !important; margin-left: 4px !important; font-family: 'Inter', sans-serif !important;}#unipile-gas-ref .gas-cta-strip { background: #0f2736 !important; border-radius: 16px !important; padding: 28px 32px !important; display: flex !important; align-items: center !important; justify-content: space-between !important; gap: 20px !important; flex-wrap: wrap !important;}#unipile-gas-ref .gas-cta-strip-text { font-size: 16px !important; color: rgba(255,255,255,0.88) !important; line-height: 1.5 !important;}#unipile-gas-ref .gas-cta-strip-text strong { color: #ffffff !important; font-weight: 700 !important;}#unipile-gas-ref .gas-cta-btn { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: #DDDF4C !important; color: #0f2736 !important; padding: 12px 24px !important; border-radius: 8px !important; font-size: 14px !important; font-weight: 700 !important; border: 2px solid #DDDF4C !important; transition: all 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important; text-decoration: none !important;}#unipile-gas-ref .gas-cta-btn:hover { transform: translateY(-5px) !important;}#unipile-gas-ref .gas-cta-btn svg { width: 15px !important; height: 15px !important; stroke: currentColor !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) { #unipile-gas-ref { padding: 56px 20px !important; } #unipile-gas-ref h2 { font-size: 28px !important; } #unipile-gas-ref .gas-cta-strip { flex-direction: column !important; text-align: center !important; } #unipile-gas-ref .gas-cta-btn { width: 100% !important; justify-content: center !important; }}@media (max-width: 600px) { #unipile-gas-ref { padding: 44px 16px !important; } #unipile-gas-ref h2 { font-size: 26px !important; } #unipile-gas-ref .gas-ref-table { overflow-x: auto !important; } #unipile-gas-ref .gas-ref-table table { min-width: 600px !important; }}<\/style><div id=\"unipile-gas-ref\"> <span id=\"gas-ref\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"gas-ref-inner\"> <div class=\"gas-eyebrow\"><span class=\"gas-eyebrow-dot\"><\/span><span>Full Reference<\/span><\/div> <h2>Full Gmail API Scope Reference<\/h2> <pee class=\"gas-intro\">The complete list of Gmail API scopes, grouped by sensitivity level. Use this table as your single reference when choosing gmail api permissions for your application. Scopes marked “2026” reflect the latest additions to Google’s scope list.<\/pee>  <div class=\"gas-section-label\"> <span class=\"gas-section-badge sec-ns\"><span class=\"gas-sec-dot dot-ns\"><\/span><span>Non-sensitive<\/span><\/span> <\/div> <div class=\"gas-ref-table\"> <table> <thead> <tr> <th>Scope URI<\/th> <th>Access Level<\/th> <th>What It Accesses<\/th> <th>When to Use<\/th> <\/tr> <\/thead> <tbody> <tr> <td class=\"td-scope\">gmail.addons.current.action.compose<\/td> <td class=\"td-access\"><span class=\"gas-access-badge acc-ns\"><span>Non-sensitive<\/span><\/span><\/td> <td>Allows add-ons to compose and send email during a compose action<\/td> <td>Gmail add-ons that draft or send email on behalf of user within the compose window<\/td> <\/tr> <tr> <td class=\"td-scope\">gmail.addons.current.message.action<\/td> <td class=\"td-access\"><span class=\"gas-access-badge acc-ns\"><span>Non-sensitive<\/span><\/span><\/td> <td>Allows add-ons to view the current email during a message action<\/td> <td>Gmail add-ons that react to a message action (archiving, labeling) in the message context<\/td> <\/tr> <tr> <td class=\"td-scope\">gmail.labels <span class=\"gas-new-badge\">2026<\/span><\/td> <td class=\"td-access\"><span class=\"gas-access-badge acc-ns\"><span>Non-sensitive<\/span><\/span><\/td> <td>See and edit labels (create, rename, delete), but not message content<\/td> <td>Apps that organize email with labels without needing to read message bodies<\/td> <\/tr> <\/tbody> <\/table> <\/div>  <div class=\"gas-section-label\"> <span class=\"gas-section-badge sec-s\"><span class=\"gas-sec-dot dot-s\"><\/span><span>Sensitive<\/span><\/span> <\/div> <div class=\"gas-ref-table\"> <table> <thead> <tr> <th>Scope URI<\/th> <th>Access Level<\/th> <th>What It Accesses<\/th> <th>When to Use<\/th> <\/tr> <\/thead> <tbody> <tr> <td class=\"td-scope\">gmail.addons.current.message.metadata<\/td> <td class=\"td-access\"><span class=\"gas-access-badge acc-s\"><span>Sensitive<\/span><\/span><\/td> <td>Email headers and metadata (From, To, Subject, Date) in add-on context – not message body<\/td> <td>Add-ons that display contextual information based on sender or subject without reading body<\/td> <\/tr> <tr> <td class=\"td-scope\">gmail.addons.current.message.readonly<\/td> <td class=\"td-access\"><span class=\"gas-access-badge acc-s\"><span>Sensitive<\/span><\/span><\/td> <td>Full read access to the current email including body and attachments, in add-on context<\/td> <td>Add-ons that analyze or extract data from the currently open message<\/td> <\/tr> <tr> <td class=\"td-scope\">gmail.send<\/td> <td class=\"td-access\"><span class=\"gas-access-badge acc-s\"><span>Sensitive<\/span><\/span><\/td> <td>Send email on behalf of the authenticated user – no read or modify access<\/td> <td>Apps that only send transactional or outreach emails and do not need to read inbox<\/td> <\/tr> <\/tbody> <\/table> <\/div>  <div class=\"gas-section-label\"> <span class=\"gas-section-badge sec-r\"><span class=\"gas-sec-dot dot-r\"><\/span><span>Restricted<\/span><\/span> <\/div> <div class=\"gas-ref-table\"> <table> <thead> <tr> <th>Scope URI<\/th> <th>Access Level<\/th> <th>What It Accesses<\/th> <th>When to Use<\/th> <\/tr> <\/thead> <tbody> <tr> <td class=\"td-scope\">mail.google.com\/<\/td> <td class=\"td-access\"><span class=\"gas-access-badge acc-r\"><span>Restricted<\/span><\/span><\/td> <td>Full mailbox access: read, compose, send, and permanently delete emails and settings<\/td> <td>Only when you need every Gmail capability in one scope – typically legacy integrations<\/td> <\/tr> <tr> <td class=\"td-scope\">gmail.readonly<\/td> <td class=\"td-access\"><span class=\"gas-access-badge acc-r\"><span>Restricted<\/span><\/span><\/td> <td>Read-only access to all messages, threads, labels, and settings – cannot send or modify<\/td> <td>Analytics, archiving, search, or email intelligence tools that only read inbox data<\/td> <\/tr> <tr> <td class=\"td-scope\">gmail.compose<\/td> <td class=\"td-access\"><span class=\"gas-access-badge acc-r\"><span>Restricted<\/span><\/span><\/td> <td>Create and manage drafts, and send those drafts – no access to existing emails<\/td> <td>Draft management tools, email composers, or apps that queue emails before sending<\/td> <\/tr> <tr> <td class=\"td-scope\">gmail.insert <span class=\"gas-new-badge\">2026<\/span><\/td> <td class=\"td-access\"><span class=\"gas-access-badge acc-r\"><span>Restricted<\/span><\/span><\/td> <td>Insert messages into Gmail mailbox only – cannot read or send existing emails<\/td> <td>Migration tools or systems that import emails into Gmail from external sources<\/td> <\/tr> <tr> <td class=\"td-scope\">gmail.modify<\/td> <td class=\"td-access\"><span class=\"gas-access-badge acc-r\"><span>Restricted<\/span><\/span><\/td> <td>Read, compose, send, and manage emails and labels – cannot permanently delete<\/td> <td>Full-featured email clients, CRM sync tools, helpdesk integrations needing read+send+label<\/td> <\/tr> <tr> <td class=\"td-scope\">gmail.metadata<\/td> <td class=\"td-access\"><span class=\"gas-access-badge acc-r\"><span>Restricted<\/span><\/span><\/td> <td>Headers and labels only – no access to email body or attachments<\/td> <td>Apps that categorize or route emails based on metadata without reading private content<\/td> <\/tr> <tr> <td class=\"td-scope\">gmail.settings.basic<\/td> <td class=\"td-access\"><span class=\"gas-access-badge acc-r\"><span>Restricted<\/span><\/span><\/td> <td>Manage basic Gmail settings: filters, forwarding rules, POP\/IMAP settings<\/td> <td>Email productivity tools that configure Gmail routing or filtering on behalf of users<\/td> <\/tr> <tr> <td class=\"td-scope\">gmail.settings.sharing<\/td> <td class=\"td-access\"><span class=\"gas-access-badge acc-r\"><span>Restricted<\/span><\/span><\/td> <td>Sensitive settings management: send-as aliases, delegates, vacation responders (domain admin only)<\/td> <td>Workspace admin tools only – requires domain administrator privileges to enable<\/td> <\/tr> <\/tbody> <\/table> <\/div> <div class=\"gas-cta-strip\"> <pee class=\"gas-cta-strip-text\"><strong>Don’t manage these gmail api scopes manually.<\/strong> Unipile’s Gmail integration handles OAuth scope requests, token refresh, and re-authorization flows automatically across your users’ linked accounts.<\/pee> <a class=\"gas-cta-btn\" href=\"https:\/\/dashboard.unipile.com\/signup\/\" target=\"_blank\"><span>Build your Gmail app<\/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><\/a> <\/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.4″ hover_enabled=”0″ global_colors_info=”{}” theme_builder_area=”post_content” sticky_enabled=”0″]<link href=\"https:\/\/fonts.googleapis.com\/css2?family=Inter:wght@400;500;600;700&family=Poppins:wght@700;800&display=swap\" rel=\"stylesheet\"><style>#unipile-gas-matrix,#unipile-gas-matrix *,#unipile-gas-matrix *::before,#unipile-gas-matrix *::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;}#unipile-gas-matrix { padding: 72px 20px !important;}#unipile-gas-matrix .gas-matrix-inner { max-width: 1100px !important; margin: 0 auto !important;}#unipile-gas-matrix .gas-eyebrow { 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; width: fit-content !important; margin-bottom: 16px !important;}#unipile-gas-matrix .gas-eyebrow-dot { width: 7px !important; height: 7px !important; background: #3BB98B !important; border-radius: 50% !important; flex-shrink: 0 !important; display: inline-block !important;}#unipile-gas-matrix 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;}#unipile-gas-matrix .gas-intro { font-size: 16px !important; line-height: 1.75 !important; color: #383838 !important; margin-bottom: 40px !important;}#unipile-gas-matrix .gas-matrix-table { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; overflow: hidden !important; margin-bottom: 40px !important; width: 100% !important;}#unipile-gas-matrix .gas-matrix-table table { width: 100% !important; border-collapse: collapse !important;}#unipile-gas-matrix .gas-matrix-table thead tr { background: #0f2736 !important;}#unipile-gas-matrix .gas-matrix-table thead th { padding: 14px 18px !important; font-size: 11px !important; font-weight: 700 !important; color: rgba(255,255,255,0.8) !important; text-align: left !important; text-transform: uppercase !important; letter-spacing: 0.6px !important;}#unipile-gas-matrix .gas-matrix-table tbody tr { border-bottom: 1px solid #f0f2f5 !important; transition: background 0.15s ease !important;}#unipile-gas-matrix .gas-matrix-table tbody tr:last-child { border-bottom: none !important;}#unipile-gas-matrix .gas-matrix-table tbody tr:hover { background: #f8fafc !important;}#unipile-gas-matrix .gas-matrix-table tbody td { padding: 14px 18px !important; font-size: 13.5px !important; color: #383838 !important; vertical-align: middle !important;}#unipile-gas-matrix .gas-matrix-table .td-usecase { font-weight: 600 !important; color: #0f2736 !important;}#unipile-gas-matrix .gas-scope-chip { display: inline-block !important; background: #f4f5f7 !important; color: #383838 !important; padding: 3px 9px !important; border-radius: 5px !important; font-size: 12px !important; font-family: 'Courier New', monospace !important; font-weight: 600 !important; white-space: nowrap !important; border: 1px solid #e5e7eb !important;}#unipile-gas-matrix .gas-risk-badge { display: inline-flex !important; align-items: center !important; gap: 4px !important; padding: 3px 9px !important; border-radius: 10px !important; font-size: 11px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.3px !important; white-space: nowrap !important;}#unipile-gas-matrix .risk-low { background: rgba(59, 185, 139, 0.12) !important; color: #2aaa7e !important; }#unipile-gas-matrix .risk-med { background: rgba(251, 188, 4, 0.15) !important; color: #d97706 !important; }#unipile-gas-matrix .risk-high { background: rgba(234, 67, 53, 0.12) !important; color: #dc2626 !important; }#unipile-gas-matrix .gas-tip-box { background: rgba(59, 185, 139, 0.08) !important; border: 1px solid rgba(59, 185, 139, 0.25) !important; border-radius: 12px !important; padding: 20px 24px !important; display: flex !important; align-items: flex-start !important; gap: 14px !important; margin-bottom: 32px !important;}#unipile-gas-matrix .gas-tip-icon { width: 36px !important; height: 36px !important; border-radius: 8px !important; background: rgba(59, 185, 139, 0.15) !important; display: flex !important; align-items: center !important; justify-content: center !important; flex-shrink: 0 !important;}#unipile-gas-matrix .gas-tip-icon svg { width: 18px !important; height: 18px !important; stroke: #3BB98B !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}#unipile-gas-matrix .gas-tip-content {}#unipile-gas-matrix .gas-tip-title { font-size: 14px !important; font-weight: 700 !important; color: #0f2736 !important; margin-bottom: 6px !important; display: block !important;}#unipile-gas-matrix .gas-tip-text { font-size: 14px !important; line-height: 1.65 !important; color: #4a5568 !important;}#unipile-gas-matrix .gas-tip-text a { color: #2aaa7e !important; text-decoration: underline !important;}@media (max-width: 900px) { #unipile-gas-matrix { padding: 56px 20px !important; } #unipile-gas-matrix h2 { font-size: 28px !important; } #unipile-gas-matrix .gas-matrix-table { overflow-x: auto !important; } #unipile-gas-matrix .gas-matrix-table table { min-width: 650px !important; }}@media (max-width: 600px) { #unipile-gas-matrix { padding: 44px 16px !important; } #unipile-gas-matrix h2 { font-size: 26px !important; }}<\/style><div id=\"unipile-gas-matrix\"> <span id=\"gas-matrix\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"gas-matrix-inner\"> <div class=\"gas-eyebrow\"><span class=\"gas-eyebrow-dot\"><\/span><span>Use Case Matrix<\/span><\/div> <h2>Which Gmail API Scope Do You Need?<\/h2> <pee class=\"gas-intro\">The single most important principle in Gmail API scope selection is the principle of minimum access: request only the gmail api permissions your app actually needs. This table maps common use cases to the minimum recommended scope, helping you avoid unnecessary verification overhead and protect user trust.<\/pee> <div class=\"gas-matrix-table\"> <table> <thead> <tr> <th>Use Case<\/th> <th>Minimum Scope<\/th> <th>Verification Level<\/th> <th>Notes<\/th> <\/tr> <\/thead> <tbody> <tr> <td class=\"td-usecase\">Send emails only (no inbox read)<\/td> <td><span class=\"gas-scope-chip\">gmail.send<\/span><\/td> <td><span class=\"gas-risk-badge risk-med\"><span>Sensitive<\/span><\/span><\/td> <td>Ideal for transactional or outreach tools. No access to existing messages.<\/td> <\/tr> <tr> <td class=\"td-usecase\">Read inbox for analytics or search<\/td> <td><span class=\"gas-scope-chip\">gmail.readonly<\/span><\/td> <td><span class=\"gas-risk-badge risk-high\"><span>Restricted<\/span><\/span><\/td> <td>Full read access to all messages and settings. Requires annual security assessment.<\/td> <\/tr> <tr> <td class=\"td-usecase\">Full email client (read + send + label)<\/td> <td><span class=\"gas-scope-chip\">gmail.modify<\/span><\/td> <td><span class=\"gas-risk-badge risk-high\"><span>Restricted<\/span><\/span><\/td> <td>Preferred over <code>mail.google.com\/<\/code> as it excludes permanent delete. Covers most CRM and helpdesk use cases.<\/td> <\/tr> <tr> <td class=\"td-usecase\">Archive or backup emails permanently<\/td> <td><span class=\"gas-scope-chip\">mail.google.com\/<\/span><\/td> <td><span class=\"gas-risk-badge risk-high\"><span>Restricted<\/span><\/span><\/td> <td>Only use when you truly need delete access. Triggers the broadest Google consent warning.<\/td> <\/tr> <tr> <td class=\"td-usecase\">Organize labels only<\/td> <td><span class=\"gas-scope-chip\">gmail.labels<\/span><\/td> <td><span class=\"gas-risk-badge risk-low\"><span>Non-sensitive<\/span><\/span><\/td> <td>New in 2026. Minimal permissions for label management without reading messages.<\/td> <\/tr> <tr> <td class=\"td-usecase\">Draft management (queue before send)<\/td> <td><span class=\"gas-scope-chip\">gmail.compose<\/span><\/td> <td><span class=\"gas-risk-badge risk-high\"><span>Restricted<\/span><\/span><\/td> <td>Access to drafts and send capability, but no read access to existing messages.<\/td> <\/tr> <tr> <td class=\"td-usecase\">Metadata routing or categorization<\/td> <td><span class=\"gas-scope-chip\">gmail.metadata<\/span><\/td> <td><span class=\"gas-risk-badge risk-high\"><span>Restricted<\/span><\/span><\/td> <td>Headers and labels only – no body access. Good for routing engines that respect message privacy.<\/td> <\/tr> <tr> <td class=\"td-usecase\">Email migration \/ import into Gmail<\/td> <td><span class=\"gas-scope-chip\">gmail.insert<\/span><\/td> <td><span class=\"gas-risk-badge risk-high\"><span>Restricted<\/span><\/span><\/td> <td>New in 2026. Insert-only access – better scoped alternative to <code>mail.google.com\/<\/code> for import tools.<\/td> <\/tr> <tr> <td class=\"td-usecase\">Configure Gmail filters and forwarding<\/td> <td><span class=\"gas-scope-chip\">gmail.settings.basic<\/span><\/td> <td><span class=\"gas-risk-badge risk-high\"><span>Restricted<\/span><\/span><\/td> <td>Manage filters, labels, forwarding rules. No message body access.<\/td> <\/tr> <tr> <td class=\"td-usecase\">Gmail add-on: display sender context<\/td> <td><span class=\"gas-scope-chip\">gmail.addons.current.message.metadata<\/span><\/td> <td><span class=\"gas-risk-badge risk-med\"><span>Sensitive<\/span><\/span><\/td> <td>Headers only in add-on context. Avoids full message read access.<\/td> <\/tr> <\/tbody> <\/table> <\/div> <div class=\"gas-tip-box\"> <div class=\"gas-tip-icon\"> <svg viewBox=\"0 0 24 24\"><path d=\"M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10z\"\/><\/svg> <\/div> <div class=\"gas-tip-content\"> <span class=\"gas-tip-title\">Combine scopes only when necessary<\/span> <pee class=\"gas-tip-text\">You can combine multiple gmail api scopes in a single OAuth request (e.g., <code>gmail.send<\/code> + <code>gmail.labels<\/code>), but each scope adds to the consent screen disclosure. Always audit your scope list before going to production. If you are building a full Gmail sync product, the <a href=\"https:\/\/www.unipile.com\/oauth-email-api\/\" target=\"_self\">OAuth Email API guide<\/a> covers the complete flow including token management and scope re-authorization.<\/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>#unipile-gas-restricted,#unipile-gas-restricted *,#unipile-gas-restricted *::before,#unipile-gas-restricted *::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;}#unipile-gas-restricted { background: #f4f5f7 !important; padding: 72px 20px !important;}#unipile-gas-restricted .gas-rest-inner { max-width: 1100px !important; margin: 0 auto !important;}#unipile-gas-restricted .gas-eyebrow { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: rgba(234, 67, 53, 0.1) !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; width: fit-content !important; margin-bottom: 16px !important;}#unipile-gas-restricted .gas-eyebrow-dot { width: 7px !important; height: 7px !important; background: #ef4444 !important; border-radius: 50% !important; flex-shrink: 0 !important; display: inline-block !important;}#unipile-gas-restricted 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;}#unipile-gas-restricted .gas-intro { font-size: 16px !important; line-height: 1.75 !important; color: #383838 !important; margin-bottom: 40px !important;}#unipile-gas-restricted .gas-steps-grid { display: grid !important; grid-template-columns: repeat(2, 1fr) !important; gap: 20px !important; margin-bottom: 36px !important;}#unipile-gas-restricted .gas-step-card { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; padding: 24px !important; display: flex !important; gap: 16px !important;}#unipile-gas-restricted .gas-step-num { width: 40px !important; height: 40px !important; border-radius: 10px !important; background: rgba(221, 223, 76, 0.18) !important; color: #8a8c2e !important; display: flex !important; align-items: center !important; justify-content: center !important; font-family: 'Poppins', sans-serif !important; font-size: 16px !important; font-weight: 700 !important; flex-shrink: 0 !important;}#unipile-gas-restricted .gas-step-content {}#unipile-gas-restricted .gas-step-title { font-size: 15px !important; font-weight: 700 !important; color: #0f2736 !important; margin-bottom: 8px !important; display: block !important;}#unipile-gas-restricted .gas-step-text { font-size: 14px !important; line-height: 1.65 !important; color: #4a5568 !important;}#unipile-gas-restricted .gas-step-text a { color: #2aaa7e !important; text-decoration: underline !important;}#unipile-gas-restricted .gas-avoidance-card { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; padding: 32px !important; margin-bottom: 32px !important;}#unipile-gas-restricted .gas-avoidance-title { font-family: 'Poppins', sans-serif !important; font-size: 20px !important; font-weight: 700 !important; color: #0f2736 !important; margin-bottom: 20px !important; display: block !important;}#unipile-gas-restricted .gas-avoid-list { display: flex !important; flex-direction: column !important; gap: 14px !important;}#unipile-gas-restricted .gas-avoid-item { display: flex !important; align-items: flex-start !important; gap: 12px !important;}#unipile-gas-restricted .gas-avoid-icon { width: 28px !important; height: 28px !important; border-radius: 6px !important; background: rgba(59, 185, 139, 0.12) !important; display: flex !important; align-items: center !important; justify-content: center !important; flex-shrink: 0 !important; margin-top: 1px !important;}#unipile-gas-restricted .gas-avoid-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;}#unipile-gas-restricted .gas-avoid-text { font-size: 14px !important; line-height: 1.65 !important; color: #383838 !important;}#unipile-gas-restricted .gas-avoid-text strong { color: #0f2736 !important; font-weight: 700 !important;}#unipile-gas-restricted .gas-avoid-text 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;}#unipile-gas-restricted .gas-cta-strip { background: #0f2736 !important; border-radius: 16px !important; padding: 28px 32px !important; display: flex !important; align-items: center !important; justify-content: space-between !important; gap: 20px !important; flex-wrap: wrap !important;}#unipile-gas-restricted .gas-cta-strip-text { font-size: 16px !important; color: rgba(255,255,255,0.88) !important; line-height: 1.5 !important;}#unipile-gas-restricted .gas-cta-strip-text strong { color: #ffffff !important; font-weight: 700 !important;}#unipile-gas-restricted .gas-cta-btn { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: #DDDF4C !important; color: #0f2736 !important; padding: 12px 24px !important; border-radius: 8px !important; font-size: 14px !important; font-weight: 700 !important; border: 2px solid #DDDF4C !important; transition: all 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important; text-decoration: none !important;}#unipile-gas-restricted .gas-cta-btn:hover { transform: translateY(-5px) !important;}#unipile-gas-restricted .gas-cta-btn svg { width: 15px !important; height: 15px !important; stroke: currentColor !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) { #unipile-gas-restricted { padding: 56px 20px !important; } #unipile-gas-restricted h2 { font-size: 28px !important; } #unipile-gas-restricted .gas-steps-grid { grid-template-columns: 1fr !important; } #unipile-gas-restricted .gas-cta-strip { flex-direction: column !important; text-align: center !important; } #unipile-gas-restricted .gas-cta-btn { width: 100% !important; justify-content: center !important; }}@media (max-width: 600px) { #unipile-gas-restricted { padding: 44px 16px !important; } #unipile-gas-restricted h2 { font-size: 26px !important; } #unipile-gas-restricted .gas-avoidance-card { padding: 22px 18px !important; }}<\/style><div id=\"unipile-gas-restricted\"> <span id=\"gas-restricted\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"gas-rest-inner\"> <div class=\"gas-eyebrow\"><span class=\"gas-eyebrow-dot\"><\/span><span>Verification Process<\/span><\/div> <h2>Restricted Scope Verification: What It Means for Your App<\/h2> <pee class=\"gas-intro\">If your app needs any restricted Gmail API scope – including <code>gmail.readonly<\/code>, <code>gmail.modify<\/code>, or <code>mail.google.com\/<\/code> – you must complete Google’s security assessment process before going live beyond 100 test users. Here is what that process looks like and how to minimize the overhead.<\/pee> <div class=\"gas-steps-grid\"> <div class=\"gas-step-card\"> <div class=\"gas-step-num\">1<\/div> <div class=\"gas-step-content\"> <span class=\"gas-step-title\">Register your OAuth app in Google Cloud Console<\/span> <pee class=\"gas-step-text\">Create a project, enable the Gmail API, and configure the OAuth consent screen. Fill in all required fields: app name, support email, authorized domains, and privacy policy URL. This step is required for any Gmail API scope level.<\/pee> <\/div> <\/div> <div class=\"gas-step-card\"> <div class=\"gas-step-num\">2<\/div> <div class=\"gas-step-content\"> <span class=\"gas-step-title\">Submit for app review with restricted scopes declared<\/span> <pee class=\"gas-step-text\">In the OAuth consent screen, click “Prepare for Verification”. Declare each restricted Gmail API scope and provide a justification explaining why your app needs it. Google’s team reviews this before routing you to a security assessor.<\/pee> <\/div> <\/div> <div class=\"gas-step-card\"> <div class=\"gas-step-num\">3<\/div> <div class=\"gas-step-content\"> <span class=\"gas-step-title\">Complete the third-party security assessment<\/span> <pee class=\"gas-step-text\">Google routes restricted scope apps to an approved assessor (Leviathan Security, Coalfire, etc.). The assessment costs approximately $500\/year. You must provide a demo, explain data handling practices, and pass a technical review of your OAuth implementation.<\/pee> <\/div> <\/div> <div class=\"gas-step-card\"> <div class=\"gas-step-num\">4<\/div> <div class=\"gas-step-content\"> <span class=\"gas-step-title\">Annual re-certification for continued access<\/span> <pee class=\"gas-step-text\">Restricted Gmail API scopes require yearly re-certification. If you miss the renewal window, Google can revoke your app’s production access. Plan for this recurring cost and compliance cycle from day one of your Gmail integration architecture.<\/pee> <\/div> <\/div> <\/div> <div class=\"gas-avoidance-card\"> <span class=\"gas-avoidance-title\">How to avoid or minimize restricted scope verification<\/span> <div class=\"gas-avoid-list\"> <div class=\"gas-avoid-item\"> <div class=\"gas-avoid-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><\/div> <pee class=\"gas-avoid-text\"><strong>Choose <code>gmail.send<\/code> over <code>gmail.modify<\/code><\/strong> when your app only sends emails and does not need to read the inbox. <code>gmail.send<\/code> is a sensitive (not restricted) scope and skips the security assessment entirely.<\/pee> <\/div> <div class=\"gas-avoid-item\"> <div class=\"gas-avoid-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><\/div> <pee class=\"gas-avoid-text\"><strong>Use <code>gmail.metadata<\/code> instead of <code>gmail.readonly<\/code><\/strong> if your app routes or categorizes emails without reading body content. You still need verification, but the scope is narrower and easier to justify to Google.<\/pee> <\/div> <div class=\"gas-avoid-item\"> <div class=\"gas-avoid-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><\/div> <pee class=\"gas-avoid-text\"><strong>Use a platform that already holds Google verification.<\/strong> When you build on top of <a href=\"https:\/\/developer.unipile.com\/docs\/google-oauth\" target=\"_blank\">Unipile’s Gmail integration<\/a>, your app benefits from Unipile’s pre-verified OAuth credentials, so you do not need to go through the restricted scope assessment yourself. This is the fastest path to production for most SaaS products.<\/pee> <\/div> <div class=\"gas-avoid-item\"> <div class=\"gas-avoid-icon\"><svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg><\/div> <pee class=\"gas-avoid-text\"><strong>Stay in the 100-user testing window<\/strong> during early development. You can test restricted Gmail API scopes with up to 100 Google accounts without completing the full verification. Add test accounts in the Google Cloud Console OAuth consent screen settings.<\/pee> <\/div> <\/div> <\/div> <div class=\"gas-cta-strip\"> <pee class=\"gas-cta-strip-text\"><strong>Skip the Google verification process entirely.<\/strong> Unipile’s hosted Gmail OAuth is already verified for restricted gmail api scopes – your linked accounts connect immediately without additional assessment.<\/pee> <a class=\"gas-cta-btn\" href=\"https:\/\/dashboard.unipile.com\/signup\/\" target=\"_blank\"><span>Start building today<\/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><\/a> <\/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.4″ hover_enabled=”0″ global_colors_info=”{}” theme_builder_area=”post_content” sticky_enabled=”0″]<link href=\"https:\/\/fonts.googleapis.com\/css2?family=Inter:wght@400;500;600;700&family=Poppins:wght@700;800&display=swap\" rel=\"stylesheet\"><style>#unipile-gas-code,#unipile-gas-code *,#unipile-gas-code *::before,#unipile-gas-code *::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;}#unipile-gas-code {  padding: 72px 20px !important;}#unipile-gas-code .gas-code-inner { max-width: 1100px !important; margin: 0 auto !important;}#unipile-gas-code .gas-eyebrow { 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; width: fit-content !important; margin-bottom: 16px !important;}#unipile-gas-code .gas-eyebrow-dot { width: 7px !important; height: 7px !important; background: #DDDF4C !important; border-radius: 50% !important; flex-shrink: 0 !important; display: inline-block !important;}#unipile-gas-code 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;}#unipile-gas-code .gas-intro { font-size: 16px !important; line-height: 1.75 !important; color: #383838 !important; margin-bottom: 40px !important;}#unipile-gas-code .gas-tabs { display: flex !important; gap: 8px !important; margin-bottom: 20px !important; flex-wrap: wrap !important;}#unipile-gas-code .gas-tab-btn { padding: 8px 20px !important; border-radius: 8px !important; font-size: 13px !important; font-weight: 600 !important; cursor: pointer !important; transition: all 0.2s ease !important; background: #f4f5f7 !important; color: #64748b !important; border: 1px solid #e5e7eb !important; display: inline-block !important;}#unipile-gas-code .gas-tab-btn.gas-tab-active { background: #0f2736 !important; color: #ffffff !important; border-color: #0f2736 !important;}#unipile-gas-code .gas-tab-panel { display: none !important;}#unipile-gas-code .gas-tab-panel.gas-panel-active { display: block !important;}#unipile-gas-code .gas-code-wrap { border-radius: 14px !important; overflow: hidden !important; background: #0d1117 !important; margin-bottom: 32px !important;}#unipile-gas-code .gas-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;}#unipile-gas-code .gas-dot { width: 12px !important; height: 12px !important; border-radius: 50% !important; display: inline-block !important; flex-shrink: 0 !important;}#unipile-gas-code .gas-dot-r { background: #ff5f57 !important; }#unipile-gas-code .gas-dot-y { background: #febc2e !important; }#unipile-gas-code .gas-dot-g { background: #28c840 !important; }#unipile-gas-code .gas-filename { color: #8b949e !important; font-size: 13px !important; margin-left: 6px !important; font-family: 'Courier New', monospace !important;}#unipile-gas-code .gas-pre { padding: 22px 24px !important; font-size: 13px !important; line-height: 1.85 !important; overflow-x: auto !important; background: #0d1117 !important;}#unipile-gas-code .gas-pre code { font-family: 'Courier New', monospace !important; white-space: pre !important; display: block !important;}#unipile-gas-code .gc { color: #8b949e !important; }#unipile-gas-code .gk { color: #ff7b72 !important; }#unipile-gas-code .gfn { color: #d2a8ff !important; }#unipile-gas-code .gs { color: #a5d6ff !important; }#unipile-gas-code .gw { color: #e6edf3 !important; }#unipile-gas-code .gn { color: #79c0ff !important; }#unipile-gas-code .gas-editor-ok { background: rgba(59, 185, 139, 0.1) !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;}#unipile-gas-code .gas-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;}#unipile-gas-code .gas-note-box { 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: flex-start !important; gap: 12px !important; margin-bottom: 32px !important;}#unipile-gas-code .gas-note-icon { flex-shrink: 0 !important; margin-top: 1px !important;}#unipile-gas-code .gas-note-icon svg { width: 18px !important; height: 18px !important; stroke: #3BB98B !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}#unipile-gas-code .gas-note-text { font-size: 14px !important; line-height: 1.65 !important; color: #383838 !important;}#unipile-gas-code .gas-note-text a { color: #2aaa7e !important; text-decoration: underline !important;}#unipile-gas-code .gas-note-text strong { color: #0f2736 !important; font-weight: 700 !important;}@media (max-width: 900px) { #unipile-gas-code { padding: 56px 20px !important; } #unipile-gas-code h2 { font-size: 28px !important; } #unipile-gas-code .gas-pre { overflow-x: auto !important; }}@media (max-width: 600px) { #unipile-gas-code { padding: 44px 16px !important; } #unipile-gas-code h2 { font-size: 26px !important; } #unipile-gas-code .gas-pre { font-size: 12px !important; padding: 18px 16px !important; }}<\/style><div id=\"unipile-gas-code\"> <span id=\"gas-code\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"gas-code-inner\"> <div class=\"gas-eyebrow\"><span class=\"gas-eyebrow-dot\"><\/span><span>Implementation<\/span><\/div> <h2>How to Request Gmail API Scopes in Your OAuth Flow<\/h2> <pee class=\"gas-intro\">Once you know which gmail oauth scopes your app needs, you declare them when generating the authorization URL. Here are working code examples in both Node.js and Python showing exactly how to pass gmail api permissions into the OAuth consent screen.<\/pee> <div class=\"gas-tabs\"> <button class=\"gas-tab-btn gas-tab-active\" data-gas-tab=\"node\"><span>Node.js<\/span><\/button> <button class=\"gas-tab-btn\" data-gas-tab=\"python\"><span>Python<\/span><\/button> <\/div> <div class=\"gas-tab-panel gas-panel-active\" data-gas-panel=\"node\"> <div class=\"gas-code-wrap\"> <div class=\"gas-editor-bar\"> <span class=\"gas-dot gas-dot-r\"><\/span> <span class=\"gas-dot gas-dot-y\"><\/span> <span class=\"gas-dot gas-dot-g\"><\/span> <span class=\"gas-filename\">gmail-scopes-node.js<\/span> <\/div> <div class=\"gas-pre\"><code><span class=\"gc\">\/\/ Node.js \u2014 Gmail API scopes in OAuth flow<\/span><span class=\"gc\">\/\/ Uses google-auth-library (official Google client)<\/span><span class=\"gk\">const<\/span> <span class=\"gw\">{ OAuth2Client } =<\/span> <span class=\"gfn\">require<\/span><span class=\"gw\">(<\/span><span class=\"gs\">'google-auth-library'<\/span><span class=\"gw\">);<\/span><span class=\"gk\">const<\/span> <span class=\"gw\">oauth2Client =<\/span> <span class=\"gk\">new<\/span> <span class=\"gfn\">OAuth2Client<\/span><span class=\"gw\">(<\/span> <span class=\"gw\">process.env.GOOGLE_CLIENT_ID,<\/span> <span class=\"gw\">process.env.GOOGLE_CLIENT_SECRET,<\/span> <span class=\"gw\">process.env.REDIRECT_URI<\/span><span class=\"gw\">);<\/span><span class=\"gc\">\/\/ Define the gmail api scopes your app needs<\/span><span class=\"gc\">\/\/ Principle: request minimum scope required<\/span><span class=\"gk\">const<\/span> <span class=\"gw\">SCOPES =<\/span> <span class=\"gw\">[<\/span> <span class=\"gs\">'https:\/\/www.googleapis.com\/auth\/gmail.readonly'<\/span><span class=\"gw\">,<\/span> <span class=\"gc\">\/\/ restricted<\/span> <span class=\"gs\">'https:\/\/www.googleapis.com\/auth\/gmail.send'<\/span><span class=\"gw\">,<\/span> <span class=\"gc\">\/\/ sensitive<\/span> <span class=\"gs\">'https:\/\/www.googleapis.com\/auth\/gmail.labels'<\/span><span class=\"gw\">,<\/span> <span class=\"gc\">\/\/ non-sensitive<\/span><span class=\"gw\">];<\/span><span class=\"gc\">\/\/ Generate the OAuth authorization URL<\/span><span class=\"gk\">const<\/span> <span class=\"gw\">authUrl =<\/span> <span class=\"gw\">oauth2Client.<\/span><span class=\"gfn\">generateAuthUrl<\/span><span class=\"gw\">({<\/span> <span class=\"gw\">access_type:<\/span> <span class=\"gs\">'offline'<\/span><span class=\"gw\">,<\/span> <span class=\"gc\">\/\/ request refresh token<\/span> <span class=\"gw\">scope: SCOPES,<\/span> <span class=\"gw\">prompt:<\/span> <span class=\"gs\">'consent'<\/span><span class=\"gw\">,<\/span> <span class=\"gc\">\/\/ force consent to get refresh token<\/span><span class=\"gw\">});<\/span><span class=\"gw\">console.<\/span><span class=\"gfn\">log<\/span><span class=\"gw\">(<\/span><span class=\"gs\">'Redirect user to:'<\/span><span class=\"gw\">, authUrl);<\/span><span class=\"gc\">\/\/ After user authorizes, exchange code for tokens<\/span><span class=\"gk\">async function<\/span> <span class=\"gfn\">getTokens<\/span><span class=\"gw\">(code) {<\/span> <span class=\"gk\">const<\/span> <span class=\"gw\">{ tokens } =<\/span> <span class=\"gk\">await<\/span> <span class=\"gw\">oauth2Client.<\/span><span class=\"gfn\">getToken<\/span><span class=\"gw\">(code);<\/span> <span class=\"gw\">oauth2Client.<\/span><span class=\"gfn\">setCredentials<\/span><span class=\"gw\">(tokens);<\/span> <span class=\"gk\">return<\/span> <span class=\"gw\">tokens;<\/span><span class=\"gw\">}<\/span><\/code><\/div> <div class=\"gas-editor-ok\"> <svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg> <span>Authorization URL generated – gmail oauth scopes declared<\/span> <\/div> <\/div> <\/div> <div class=\"gas-tab-panel\" data-gas-panel=\"python\"> <div class=\"gas-code-wrap\"> <div class=\"gas-editor-bar\"> <span class=\"gas-dot gas-dot-r\"><\/span> <span class=\"gas-dot gas-dot-y\"><\/span> <span class=\"gas-dot gas-dot-g\"><\/span> <span class=\"gas-filename\">gmail-scopes.py<\/span> <\/div> <div class=\"gas-pre\"><code><span class=\"gc\"># Python \u2014 Gmail API scopes in OAuth flow<\/span><span class=\"gc\"># Uses google-auth-oauthlib (official Google library)<\/span><span class=\"gk\">from<\/span> <span class=\"gw\">google_auth_oauthlib.flow<\/span> <span class=\"gk\">import<\/span> <span class=\"gw\">InstalledAppFlow<\/span><span class=\"gk\">from<\/span> <span class=\"gw\">google.oauth2.credentials<\/span> <span class=\"gk\">import<\/span> <span class=\"gw\">Credentials<\/span><span class=\"gk\">from<\/span> <span class=\"gw\">google.auth.transport.requests<\/span> <span class=\"gk\">import<\/span> <span class=\"gw\">Request<\/span><span class=\"gk\">import<\/span> <span class=\"gw\">os<\/span><span class=\"gc\"># Define gmail api scopes - request only what you need<\/span><span class=\"gw\">SCOPES =<\/span> <span class=\"gw\">[<\/span> <span class=\"gs\">'https:\/\/www.googleapis.com\/auth\/gmail.readonly'<\/span><span class=\"gw\">,<\/span> <span class=\"gc\"># restricted<\/span> <span class=\"gs\">'https:\/\/www.googleapis.com\/auth\/gmail.send'<\/span><span class=\"gw\">,<\/span> <span class=\"gc\"># sensitive<\/span> <span class=\"gs\">'https:\/\/www.googleapis.com\/auth\/gmail.labels'<\/span><span class=\"gw\">,<\/span> <span class=\"gc\"># non-sensitive<\/span><span class=\"gw\">]<\/span><span class=\"gk\">def<\/span> <span class=\"gfn\">get_gmail_credentials<\/span><span class=\"gw\">():<\/span> <span class=\"gw\">creds =<\/span> <span class=\"gk\">None<\/span> <span class=\"gc\"># Load existing token if available<\/span> <span class=\"gk\">if<\/span> <span class=\"gw\">os.path.<\/span><span class=\"gfn\">exists<\/span><span class=\"gw\">(<\/span><span class=\"gs\">'token.json'<\/span><span class=\"gw\">):<\/span> <span class=\"gw\">creds = Credentials.<\/span><span class=\"gfn\">from_authorized_user_file<\/span><span class=\"gw\">(<\/span> <span class=\"gs\">'token.json'<\/span><span class=\"gw\">, SCOPES<\/span> <span class=\"gw\">)<\/span> <span class=\"gc\"># Refresh or request new credentials<\/span> <span class=\"gk\">if not<\/span> <span class=\"gw\">creds<\/span> <span class=\"gk\">or not<\/span> <span class=\"gw\">creds.valid:<\/span> <span class=\"gk\">if<\/span> <span class=\"gw\">creds<\/span> <span class=\"gk\">and<\/span> <span class=\"gw\">creds.expired<\/span> <span class=\"gk\">and<\/span> <span class=\"gw\">creds.refresh_token:<\/span> <span class=\"gw\">creds.<\/span><span class=\"gfn\">refresh<\/span><span class=\"gw\">(<\/span><span class=\"gfn\">Request<\/span><span class=\"gw\">())<\/span> <span class=\"gk\">else<\/span><span class=\"gw\">:<\/span> <span class=\"gc\"># Trigger OAuth consent screen with declared scopes<\/span> <span class=\"gw\">flow = InstalledAppFlow.<\/span><span class=\"gfn\">from_client_secrets_file<\/span><span class=\"gw\">(<\/span> <span class=\"gs\">'credentials.json'<\/span><span class=\"gw\">, SCOPES<\/span> <span class=\"gw\">)<\/span> <span class=\"gw\">creds = flow.<\/span><span class=\"gfn\">run_local_server<\/span><span class=\"gw\">(port=<\/span><span class=\"gn\">0<\/span><span class=\"gw\">)<\/span> <span class=\"gc\"># Persist token for future runs<\/span> <span class=\"gk\">with<\/span> <span class=\"gfn\">open<\/span><span class=\"gw\">(<\/span><span class=\"gs\">'token.json'<\/span><span class=\"gw\">,<\/span> <span class=\"gs\">'w'<\/span><span class=\"gw\">) as token:<\/span> <span class=\"gw\">token.<\/span><span class=\"gfn\">write<\/span><span class=\"gw\">(creds.<\/span><span class=\"gfn\">to_json<\/span><span class=\"gw\">())<\/span> <span class=\"gk\">return<\/span> <span class=\"gw\">creds<\/span><\/code><\/div> <div class=\"gas-editor-ok\"> <svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg> <span>Gmail oauth scopes declared – token persisted to disk<\/span> <\/div> <\/div> <\/div> <div class=\"gas-note-box\"> <div class=\"gas-note-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> <pee class=\"gas-note-text\"><strong>Important:<\/strong> The <code>prompt: 'consent'<\/code> (Node.js) or <code>run_local_server<\/code> call (Python) forces the Google consent screen to appear even if the user has previously authorized. This is required to reliably get a <code>refresh_token<\/code>. Without a refresh token, your access token expires after 1 hour and users must re-authorize. For a complete guide to handling token refresh and scope re-authorization, see the <a href=\"https:\/\/www.unipile.com\/oauth-email-api\/\" target=\"_self\">OAuth Email API guide<\/a> and the <a href=\"https:\/\/developer.unipile.com\/docs\/google-oauth\" target=\"_blank\">Unipile Google OAuth docs<\/a>.<\/pee> <\/div> <\/div> <\/div><\/div><script>(function(){ function initCodeTabs(){ var wrap = document.getElementById('unipile-gas-code'); if (!wrap) return; var tabs = wrap.querySelectorAll('.gas-tab-btn'); var panels = wrap.querySelectorAll('.gas-tab-panel'); tabs.forEach(function(tab){ tab.addEventListener('click', function(){ var target = tab.getAttribute('data-gas-tab'); tabs.forEach(function(t){ t.classList.remove('gas-tab-active'); }); panels.forEach(function(p){ p.classList.remove('gas-panel-active'); }); tab.classList.add('gas-tab-active'); var panel = wrap.querySelector('[data-gas-panel=\"' + target + '\"]'); if (panel) panel.classList.add('gas-panel-active'); }); }); } if (document.readyState === 'loading') { document.addEventListener('DOMContentLoaded', initCodeTabs); } else { initCodeTabs(); }})();<\/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>#unipile-gas-compliance,#unipile-gas-compliance *,#unipile-gas-compliance *::before,#unipile-gas-compliance *::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;}#unipile-gas-compliance { background: #f4f5f7 !important; padding: 72px 20px !important;}#unipile-gas-compliance .gas-compl-inner { max-width: 1100px !important; margin: 0 auto !important;}#unipile-gas-compliance .gas-eyebrow { 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; width: fit-content !important; margin-bottom: 16px !important;}#unipile-gas-compliance .gas-eyebrow-dot { width: 7px !important; height: 7px !important; background: #3BB98B !important; border-radius: 50% !important; flex-shrink: 0 !important; display: inline-block !important;}#unipile-gas-compliance 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;}#unipile-gas-compliance .gas-intro { font-size: 16px !important; line-height: 1.75 !important; color: #383838 !important; margin-bottom: 40px !important;}#unipile-gas-compliance .gas-principles-grid { display: grid !important; grid-template-columns: repeat(2, 1fr) !important; gap: 20px !important; margin-bottom: 36px !important;}#unipile-gas-compliance .gas-principle-card { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; padding: 26px !important;}#unipile-gas-compliance .gas-principle-icon { width: 44px !important; height: 44px !important; border-radius: 10px !important; background: rgba(59, 185, 139, 0.12) !important; display: flex !important; align-items: center !important; justify-content: center !important; margin-bottom: 14px !important;}#unipile-gas-compliance .gas-principle-icon svg { width: 22px !important; height: 22px !important; stroke: #3BB98B !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}#unipile-gas-compliance .gas-principle-title { font-size: 15px !important; font-weight: 700 !important; color: #0f2736 !important; margin-bottom: 10px !important; display: block !important;}#unipile-gas-compliance .gas-principle-text { font-size: 14px !important; line-height: 1.7 !important; color: #4a5568 !important;}#unipile-gas-compliance .gas-principle-text strong { color: #0f2736 !important; font-weight: 700 !important;}#unipile-gas-compliance .gas-compliance-cards { display: grid !important; grid-template-columns: repeat(2, 1fr) !important; gap: 20px !important; margin-bottom: 36px !important;}#unipile-gas-compliance .gas-compl-card { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; padding: 26px !important;}#unipile-gas-compliance .gas-compl-header { display: flex !important; align-items: center !important; gap: 12px !important; margin-bottom: 14px !important;}#unipile-gas-compliance .gas-compl-badge { display: inline-flex !important; align-items: center !important; gap: 6px !important; padding: 4px 10px !important; border-radius: 8px !important; font-size: 11px !important; font-weight: 700 !important; text-transform: uppercase !important; letter-spacing: 0.4px !important;}#unipile-gas-compliance .cbadge-gdpr { background: rgba(59, 185, 139, 0.12) !important; color: #2aaa7e !important;}#unipile-gas-compliance .cbadge-soc2 { background: rgba(66, 133, 244, 0.12) !important; color: #4285F4 !important;}#unipile-gas-compliance .gas-compl-title { font-size: 15px !important; font-weight: 700 !important; color: #0f2736 !important; display: block !important;}#unipile-gas-compliance .gas-compl-text { font-size: 14px !important; line-height: 1.7 !important; color: #4a5568 !important;}#unipile-gas-compliance .gas-compl-list { display: flex !important; flex-direction: column !important; gap: 8px !important; margin-top: 12px !important;}#unipile-gas-compliance .gas-compl-list-item { display: flex !important; align-items: flex-start !important; gap: 8px !important; font-size: 13.5px !important; color: #4a5568 !important; line-height: 1.5 !important;}#unipile-gas-compliance .gas-check-dot { width: 16px !important; height: 16px !important; border-radius: 50% !important; background: rgba(59, 185, 139, 0.12) !important; display: flex !important; align-items: center !important; justify-content: center !important; flex-shrink: 0 !important; margin-top: 1px !important;}#unipile-gas-compliance .gas-check-dot svg { width: 9px !important; height: 9px !important; stroke: #3BB98B !important; fill: none !important; stroke-width: 3 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}#unipile-gas-compliance .gas-cta-strip { background: #0f2736 !important; border-radius: 16px !important; padding: 28px 32px !important; display: flex !important; align-items: center !important; justify-content: space-between !important; gap: 20px !important; flex-wrap: wrap !important;}#unipile-gas-compliance .gas-cta-strip-text { font-size: 16px !important; color: rgba(255,255,255,0.88) !important; line-height: 1.5 !important;}#unipile-gas-compliance .gas-cta-strip-text strong { color: #ffffff !important; font-weight: 700 !important;}#unipile-gas-compliance .gas-cta-btn { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: #DDDF4C !important; color: #0f2736 !important; padding: 12px 24px !important; border-radius: 8px !important; font-size: 14px !important; font-weight: 700 !important; border: 2px solid #DDDF4C !important; transition: all 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important; text-decoration: none !important;}#unipile-gas-compliance .gas-cta-btn:hover { transform: translateY(-5px) !important;}#unipile-gas-compliance .gas-cta-btn svg { width: 15px !important; height: 15px !important; stroke: currentColor !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) { #unipile-gas-compliance { padding: 56px 20px !important; } #unipile-gas-compliance h2 { font-size: 28px !important; } #unipile-gas-compliance .gas-principles-grid, #unipile-gas-compliance .gas-compliance-cards { grid-template-columns: 1fr !important; } #unipile-gas-compliance .gas-cta-strip { flex-direction: column !important; text-align: center !important; } #unipile-gas-compliance .gas-cta-btn { width: 100% !important; justify-content: center !important; }}@media (max-width: 600px) { #unipile-gas-compliance { padding: 44px 16px !important; } #unipile-gas-compliance h2 { font-size: 26px !important; }}<\/style><div id=\"unipile-gas-compliance\"> <span id=\"gas-compliance\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"gas-compl-inner\"> <div class=\"gas-eyebrow\"><span class=\"gas-eyebrow-dot\"><\/span><span>Compliance<\/span><\/div> <h2>Minimum Scope Principle and Compliance<\/h2> <pee class=\"gas-intro\">The minimum scope principle is not just a Google recommendation – it directly affects your GDPR and SOC 2 compliance posture. Requesting excessive gmail api permissions creates unnecessary data exposure risks and complicates your data processing agreements with end users.<\/pee> <div class=\"gas-principles-grid\"> <div class=\"gas-principle-card\"> <div class=\"gas-principle-icon\"> <svg viewBox=\"0 0 24 24\"><path d=\"M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10z\"\/><\/svg> <\/div> <span class=\"gas-principle-title\">Least privilege by design<\/span> <pee class=\"gas-principle-text\">The minimum scope principle mirrors the security concept of least privilege. Your Gmail API integration should request the <strong>lowest-permission gmail api scope<\/strong> that enables the feature. If your CRM only sends follow-up emails, <code>gmail.send<\/code> is enough – <code>gmail.modify<\/code> is excessive and creates unnecessary risk.<\/pee> <\/div> <div class=\"gas-principle-card\"> <div class=\"gas-principle-icon\"> <svg viewBox=\"0 0 24 24\"><circle cx=\"12\" cy=\"12\" r=\"10\"\/><path d=\"M12 8v4l3 3\"\/><\/svg> <\/div> <span class=\"gas-principle-title\">Consent screen clarity<\/span> <pee class=\"gas-principle-text\">Google surfaces your declared gmail api scopes directly on the consent screen. Broader scopes trigger more alarming language (“This app wants access to your entire Gmail inbox”). <strong>Minimal gmail oauth scopes<\/strong> produce simpler, less intimidating consent screens – typically improving authorization conversion rates by 15-30% in user-facing OAuth flows.<\/pee> <\/div> <div class=\"gas-principle-card\"> <div class=\"gas-principle-icon\"> <svg viewBox=\"0 0 24 24\"><path d=\"M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z\"\/><polyline points=\"14 2 14 8 20 8\"\/><\/svg> <\/div> <span class=\"gas-principle-title\">Data processing documentation<\/span> <pee class=\"gas-principle-text\">Your privacy policy and DPA (Data Processing Agreement) must accurately reflect which Gmail data your app accesses. If your app requests <code>gmail.readonly<\/code> but your privacy policy only mentions “sending emails,” you have a GDPR documentation gap. Match your declared gmail api scopes to your published data practices.<\/pee> <\/div> <div class=\"gas-principle-card\"> <div class=\"gas-principle-icon\"> <svg viewBox=\"0 0 24 24\"><polyline points=\"22 12 18 12 15 21 9 3 6 12 2 12\"\/><\/svg> <\/div> <span class=\"gas-principle-title\">Scope audit as a recurring practice<\/span> <pee class=\"gas-principle-text\">Gmail API scope requirements evolve as features are added or removed. Conduct a scope audit at each major release: remove any gmail api permissions your current feature set no longer requires. Unused scopes in your OAuth declaration are a compliance liability – they represent data access you claim to need but don’t use.<\/pee> <\/div> <\/div> <div class=\"gas-compliance-cards\"> <div class=\"gas-compl-card\"> <div class=\"gas-compl-header\"> <span class=\"gas-compl-badge cbadge-gdpr\"><span>GDPR<\/span><\/span> <\/div> <span class=\"gas-compl-title\">GDPR alignment with Gmail scopes<\/span> <div class=\"gas-compl-list\"> <div class=\"gas-compl-list-item\"> <div class=\"gas-check-dot\"><svg viewBox=\"0 0 12 12\"><polyline points=\"2 6 5 9 10 3\"\/><\/svg><\/div> <span>Purpose limitation: scopes must match the specific purpose declared to users<\/span> <\/div> <div class=\"gas-compl-list-item\"> <div class=\"gas-check-dot\"><svg viewBox=\"0 0 12 12\"><polyline points=\"2 6 5 9 10 3\"\/><\/svg><\/div> <span>Data minimization: request <code>gmail.metadata<\/code> instead of <code>gmail.readonly<\/code> when body access is not needed<\/span> <\/div> <div class=\"gas-compl-list-item\"> <div class=\"gas-check-dot\"><svg viewBox=\"0 0 12 12\"><polyline points=\"2 6 5 9 10 3\"\/><\/svg><\/div> <span>User rights: token revocation must immediately remove your app’s Gmail access<\/span> <\/div> <div class=\"gas-compl-list-item\"> <div class=\"gas-check-dot\"><svg viewBox=\"0 0 12 12\"><polyline points=\"2 6 5 9 10 3\"\/><\/svg><\/div> <span>Transparency: consent screen language must match the data you actually process<\/span> <\/div> <\/div> <\/div> <div class=\"gas-compl-card\"> <div class=\"gas-compl-header\"> <span class=\"gas-compl-badge cbadge-soc2\"><span>SOC 2<\/span><\/span> <\/div> <span class=\"gas-compl-title\">SOC 2 alignment with Gmail scopes<\/span> <div class=\"gas-compl-list\"> <div class=\"gas-compl-list-item\"> <div class=\"gas-check-dot\"><svg viewBox=\"0 0 12 12\"><polyline points=\"2 6 5 9 10 3\"\/><\/svg><\/div> <span>Access control: document each Gmail API scope and its business justification in your access control policy<\/span> <\/div> <div class=\"gas-compl-list-item\"> <div class=\"gas-check-dot\"><svg viewBox=\"0 0 12 12\"><polyline points=\"2 6 5 9 10 3\"\/><\/svg><\/div> <span>Logical access: scope selection must be reviewed and approved as part of your change management process<\/span> <\/div> <div class=\"gas-compl-list-item\"> <div class=\"gas-check-dot\"><svg viewBox=\"0 0 12 12\"><polyline points=\"2 6 5 9 10 3\"\/><\/svg><\/div> <span>Monitoring: log all gmail api scope changes in your audit trail<\/span> <\/div> <div class=\"gas-compl-list-item\"> <div class=\"gas-check-dot\"><svg viewBox=\"0 0 12 12\"><polyline points=\"2 6 5 9 10 3\"\/><\/svg><\/div> <span>Vendor management: if using a platform like Unipile, include their security attestation in your vendor review<\/span> <\/div> <\/div> <\/div> <\/div> <div class=\"gas-cta-strip\"> <pee class=\"gas-cta-strip-text\"><strong>Compliance-ready Gmail integration.<\/strong> Unipile’s Gmail API implementation follows the minimum scope principle by default – your app only requests the gmail oauth scopes needed for the features you enable.<\/pee> <a class=\"gas-cta-btn\" href=\"https:\/\/dashboard.unipile.com\/signup\/\" target=\"_blank\"><span>Build compliant Gmail apps<\/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><\/a> <\/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.4″ hover_enabled=”0″ global_colors_info=”{}” theme_builder_area=”post_content” sticky_enabled=”0″]<link href=\"https:\/\/fonts.googleapis.com\/css2?family=Inter:wght@400;500;600;700&family=Poppins:wght@700;800&display=swap\" rel=\"stylesheet\"><style>#unipile-gas-upl-light,#unipile-gas-upl-light *,#unipile-gas-upl-light *::before,#unipile-gas-upl-light *::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;}#unipile-gas-upl-light { background: #f4f5f7 !important; padding: 80px 20px !important;}#unipile-gas-upl-light .gasl-inner { max-width: 1100px !important; margin: 0 auto !important;}#unipile-gas-upl-light .gasl-eyebrow { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: rgba(59, 185, 139, 0.12) !important; color: #2da077 !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; width: fit-content !important; margin-bottom: 16px !important;}#unipile-gas-upl-light .gasl-eyebrow-dot { width: 7px !important; height: 7px !important; background: #3BB98B !important; border-radius: 50% !important; flex-shrink: 0 !important; display: inline-block !important;}#unipile-gas-upl-light 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;}#unipile-gas-upl-light .gasl-subtitle { font-size: 17px !important; line-height: 1.75 !important; color: #383838 !important; margin-bottom: 48px !important;}#unipile-gas-upl-light .gasl-providers-strip { display: flex !important; align-items: center !important; gap: 16px !important; justify-content: center !important; margin-bottom: 40px !important; flex-wrap: wrap !important;}#unipile-gas-upl-light .gasl-provider-chip { display: flex !important; align-items: center !important; gap: 8px !important; background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 10px !important; padding: 8px 16px !important;}#unipile-gas-upl-light .gasl-provider-chip img { width: 20px !important; height: 20px !important; display: inline-block !important; flex-shrink: 0 !important;}#unipile-gas-upl-light .gasl-provider-chip span { font-size: 13px !important; font-weight: 600 !important; color: #383838 !important;}#unipile-gas-upl-light .gasl-features-grid { display: grid !important; grid-template-columns: repeat(3, 1fr) !important; gap: 20px !important; margin-bottom: 48px !important;}#unipile-gas-upl-light .gasl-feat-card { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; padding: 24px !important; transition: all 0.2s ease !important;}#unipile-gas-upl-light .gasl-feat-card:hover { border-color: #3BB98B !important; transform: translateY(-2px) !important; box-shadow: 0 4px 12px rgba(59, 185, 139, 0.15) !important;}#unipile-gas-upl-light .gasl-feat-icon { width: 44px !important; height: 44px !important; border-radius: 10px !important; background: rgba(59, 185, 139, 0.12) !important; display: flex !important; align-items: center !important; justify-content: center !important; margin-bottom: 14px !important;}#unipile-gas-upl-light .gasl-feat-icon svg { width: 22px !important; height: 22px !important; stroke: #3BB98B !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important;}#unipile-gas-upl-light .gasl-feat-title { font-size: 15px !important; font-weight: 700 !important; color: #0f2736 !important; margin-bottom: 8px !important; display: block !important;}#unipile-gas-upl-light .gasl-feat-text { font-size: 13.5px !important; line-height: 1.65 !important; color: #383838 !important;}#unipile-gas-upl-light .gasl-cta-row { display: flex !important; align-items: center !important; justify-content: center !important; gap: 16px !important; flex-wrap: wrap !important; margin-bottom: 40px !important;}#unipile-gas-upl-light .gasl-cta-primary { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: #DDDF4C !important; color: #0f2736 !important; padding: 16px 32px !important; border-radius: 10px !important; font-size: 16px !important; font-weight: 700 !important; border: 2px solid #DDDF4C !important; transition: all 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important; text-decoration: none !important;}#unipile-gas-upl-light .gasl-cta-primary:hover { transform: translateY(-5px) !important;}#unipile-gas-upl-light .gasl-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; flex-shrink: 0 !important;}#unipile-gas-upl-light .gasl-cta-secondary { display: inline-flex !important; align-items: center !important; gap: 8px !important; background: #ffffff !important; color: #0f2736 !important; padding: 14px 28px !important; border-radius: 10px !important; font-size: 15px !important; font-weight: 600 !important; border: 2px solid #d1d5db !important; transition: all 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important; text-decoration: none !important;}#unipile-gas-upl-light .gasl-cta-secondary:hover { border-color: #0f2736 !important; background: #ffffff !important;}#unipile-gas-upl-light .gasl-cta-secondary svg { width: 15px !important; height: 15px !important; stroke: currentColor !important; fill: none !important; stroke-width: 2 !important; stroke-linecap: round !important; stroke-linejoin: round !important; flex-shrink: 0 !important;}#unipile-gas-upl-light .gasl-trust-row { display: flex !important; align-items: center !important; justify-content: center !important; gap: 28px !important; flex-wrap: wrap !important;}#unipile-gas-upl-light .gasl-trust-item { display: flex !important; align-items: center !important; gap: 8px !important; font-size: 13px !important; color: #383838 !important;}#unipile-gas-upl-light .gasl-trust-item svg { width: 15px !important; height: 15px !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) { #unipile-gas-upl-light { padding: 60px 20px !important; } #unipile-gas-upl-light h2 { font-size: 28px !important; } #unipile-gas-upl-light .gasl-features-grid { grid-template-columns: 1fr !important; } #unipile-gas-upl-light .gasl-cta-row { flex-direction: column !important; align-items: stretch !important; } #unipile-gas-upl-light .gasl-cta-primary, #unipile-gas-upl-light .gasl-cta-secondary { justify-content: center !important; }}@media (max-width: 600px) { #unipile-gas-upl-light { padding: 48px 16px !important; } #unipile-gas-upl-light h2 { font-size: 26px !important; } #unipile-gas-upl-light .gasl-trust-row { gap: 16px !important; }}<\/style><div id=\"unipile-gas-upl-light\"> <span id=\"gas-upl\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"gasl-inner\"> <div class=\"gasl-eyebrow\"><span class=\"gasl-eyebrow-dot\"><\/span><span>Unipile Solution<\/span><\/div> <h2>Gmail API Scopes with Unipile: Skip the Scope Complexity<\/h2> <pee class=\"gasl-subtitle\">Managing gmail api scopes manually means navigating Google’s verification process, handling token refresh on scope changes, and updating your data processing documentation every time you add a feature. Unipile abstracts this entirely, your team focuses on product, not permission strings.<\/pee> <div class=\"gasl-providers-strip\"> <div class=\"gasl-provider-chip\"> <img decoding=\"async\" src=\"https:\/\/www.unipile.com\/wp-content\/uploads\/2024\/02\/gmail-3.svg\" alt=\"Gmail\" width=\"20\" height=\"20\"> <span>Gmail<\/span> <\/div> <div class=\"gasl-provider-chip\"> <img decoding=\"async\" src=\"https:\/\/www.unipile.com\/wp-content\/uploads\/2024\/02\/outlook-2.svg\" alt=\"Outlook\" width=\"20\" height=\"20\"> <span>Outlook<\/span> <\/div> <div class=\"gasl-provider-chip\"> <img decoding=\"async\" src=\"https:\/\/www.unipile.com\/wp-content\/uploads\/2024\/02\/imap-1.svg\" alt=\"IMAP\" width=\"20\" height=\"20\"> <span>IMAP<\/span> <\/div> <\/div> <div class=\"gasl-features-grid\"> <div class=\"gasl-feat-card\"> <div class=\"gasl-feat-icon\"> <svg viewBox=\"0 0 24 24\"><path d=\"M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10z\"\/><\/svg> <\/div> <span class=\"gasl-feat-title\">Pre-verified Gmail OAuth<\/span> <pee class=\"gasl-feat-text\">Unipile holds Google’s OAuth verification for restricted gmail api scopes. Your app benefits immediately without completing a separate security assessment. The annual re-certification is handled by Unipile’s compliance team.<\/pee> <\/div> <div class=\"gasl-feat-card\"> <div class=\"gasl-feat-icon\"> <svg viewBox=\"0 0 24 24\"><polyline points=\"23 6 13.5 15.5 8.5 10.5 1 18\"\/><polyline points=\"17 6 23 6 23 12\"\/><\/svg> <\/div> <span class=\"gasl-feat-title\">Automatic token management<\/span> <pee class=\"gasl-feat-text\">Unipile manages OAuth token refresh, scope validation, and re-authorization flows for each of your users’ linked accounts. When Google updates scope requirements, Unipile adapts without breaking your integration.<\/pee> <\/div> <div class=\"gasl-feat-card\"> <div class=\"gasl-feat-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> <span class=\"gasl-feat-title\">Unified API across providers<\/span> <pee class=\"gasl-feat-text\">The same Unipile API calls work for Gmail, Outlook, and IMAP. You write your email feature once and it works across all providers, no separate gmail api scope management per provider, no protocol-specific code branches.<\/pee> <\/div> <div class=\"gasl-feat-card\"> <div class=\"gasl-feat-icon\"> <svg viewBox=\"0 0 24 24\"><path d=\"M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z\"\/><polyline points=\"14 2 14 8 20 8\"\/><\/svg> <\/div> <span class=\"gasl-feat-title\">White-label OAuth option<\/span> <pee class=\"gasl-feat-text\">For teams that need to use their own Google credentials, Unipile supports white-label OAuth configuration. Your users see your brand on the consent screen while Unipile handles the scope declaration and token lifecycle in the background.<\/pee> <\/div> <div class=\"gasl-feat-card\"> <div class=\"gasl-feat-icon\"> <svg viewBox=\"0 0 24 24\"><path d=\"M22 11.08V12a10 10 0 1 1-5.93-9.14\"\/><polyline points=\"22 4 12 14.01 9 11.01\"\/><\/svg> <\/div> <span class=\"gasl-feat-title\">Minimum scope by default<\/span> <pee class=\"gasl-feat-text\">Unipile’s Gmail integration requests only the gmail api permissions required for the features you enable. Read, send, sync, each capability maps to the narrowest scope possible, keeping your compliance profile clean.<\/pee> <\/div> <div class=\"gasl-feat-card\"> <div class=\"gasl-feat-icon\"> <svg viewBox=\"0 0 24 24\"><polyline points=\"22 12 18 12 15 21 9 3 6 12 2 12\"\/><\/svg> <\/div> <span class=\"gasl-feat-title\">Real-time webhooks<\/span> <pee class=\"gasl-feat-text\">Receive new Gmail messages as they arrive via Unipile webhooks. No polling, no managing Gmail Pub\/Sub subscriptions manually. Works with the same OAuth token your app already uses for other Gmail API operations.<\/pee> <\/div> <\/div> <div class=\"gasl-cta-row\"> <a class=\"gasl-cta-primary\" href=\"https:\/\/dashboard.unipile.com\/signup\/\" target=\"_blank\"><span>Build your Gmail app now<\/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><\/a> <a class=\"gasl-cta-secondary\" href=\"https:\/\/developer.unipile.com\/docs\/google-oauth\" target=\"_blank\"><span>Read the docs<\/span><svg viewBox=\"0 0 24 24\"><path d=\"M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6\"\/><polyline points=\"15 3 21 3 21 9\"\/><line x1=\"10\" y1=\"14\" x2=\"21\" y2=\"3\"\/><\/svg><\/a> <\/div> <div class=\"gasl-trust-row\"> <div class=\"gasl-trust-item\"> <svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg> <span>No security assessment required<\/span> <\/div> <div class=\"gasl-trust-item\"> <svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg> <span>Gmail, Outlook and IMAP in one API<\/span> <\/div> <div class=\"gasl-trust-item\"> <svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg> <span>GDPR and SOC 2 aligned<\/span> <\/div> <div class=\"gasl-trust-item\"> <svg viewBox=\"0 0 24 24\"><polyline points=\"20 6 9 17 4 12\"\/><\/svg> <span>14-day free trial, no card required<\/span> <\/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”]<script type=\"application\/ld+json\">{ \"@context\": \"https:\/\/schema.org\", \"@type\": \"FAQPage\", \"mainEntity\": [ { \"@type\": \"Question\", \"name\": \"What are Gmail API scopes?\", \"acceptedAnswer\": { \"@type\": \"Answer\", \"text\": \"Gmail API scopes are OAuth 2.0 permission strings that define exactly which Gmail resources your application can access on behalf of a user. They are declared when generating the OAuth authorization URL and displayed to the user on Google's consent screen. Once a user grants access, your token is limited to only the actions those gmail api scopes permit.\" } }, { \"@type\": \"Question\", \"name\": \"What is the difference between gmail.readonly and gmail.modify?\", \"acceptedAnswer\": { \"@type\": \"Answer\", \"text\": \"Both gmail.readonly and gmail.modify are restricted gmail api scopes, but they have different access levels. gmail.readonly provides read-only access to all messages, threads, labels, and settings - your app cannot send or modify anything. gmail.modify adds the ability to read, compose, send emails, and manage labels, but excludes the ability to permanently delete messages. If your app needs to read and send but not delete, gmail.modify is preferred over the broader mail.google.com\/ scope.\" } }, { \"@type\": \"Question\", \"name\": \"Do I need a security assessment for all Gmail API scopes?\", \"acceptedAnswer\": { \"@type\": \"Answer\", \"text\": \"No. Only restricted gmail api scopes require a security assessment. Non-sensitive scopes like gmail.labels require only standard OAuth app review. Sensitive scopes like gmail.send require Google's OAuth verification process but no security assessment. Restricted scopes - including gmail.readonly, gmail.modify, gmail.compose, gmail.metadata, gmail.insert, and mail.google.com\/ - require an annual third-party security assessment costing approximately $500 per year.\" } }, { \"@type\": \"Question\", \"name\": \"What is the gmail.modify scope used for?\", \"acceptedAnswer\": { \"@type\": \"Answer\", \"text\": \"The gmail.modify scope grants read, compose, send, and label management access to Gmail, but excludes the ability to permanently delete messages. It is the recommended restricted scope for full-featured email integrations such as CRM email sync, helpdesk tools, and email clients that need to both read and send messages. It is preferred over the broader mail.google.com\/ scope because it limits data exposure by excluding permanent delete.\" } }, { \"@type\": \"Question\", \"name\": \"How many test users can I have before completing Gmail API scope verification?\", \"acceptedAnswer\": { \"@type\": \"Answer\", \"text\": \"You can test your app with up to 100 Google accounts while your OAuth app is in testing mode, regardless of the gmail api scopes you declare. These test accounts must be manually added in the Google Cloud Console OAuth consent screen configuration. Once you exceed 100 test users or want to release to all users, you must complete the appropriate verification process for your scope sensitivity level.\" } }, { \"@type\": \"Question\", \"name\": \"Can I combine multiple Gmail API scopes in one OAuth request?\", \"acceptedAnswer\": { \"@type\": \"Answer\", \"text\": \"Yes, you can combine multiple gmail api scopes in a single OAuth authorization request by passing them as an array to the scope parameter. For example, you can request gmail.readonly and gmail.send together. However, combining scopes increases the permissions shown on Google's consent screen and may trigger additional verification requirements if any of the combined scopes are restricted. Always request only the minimum combination your app needs.\" } }, { \"@type\": \"Question\", \"name\": \"What is the gmail.metadata scope?\", \"acceptedAnswer\": { \"@type\": \"Answer\", \"text\": \"The gmail.metadata scope is a restricted gmail api scope that grants access to email headers and labels only, without any access to email body content or attachments. It is useful for routing engines, categorization systems, or analytics tools that need to process emails based on sender, recipient, subject, or labels without reading private message content. Despite being a restricted scope, it has a narrower data footprint than gmail.readonly and may be easier to justify in a security assessment.\" } }, { \"@type\": \"Question\", \"name\": \"How does Unipile handle Gmail API scopes for my app?\", \"acceptedAnswer\": { \"@type\": \"Answer\", \"text\": \"Unipile manages gmail api scopes internally as part of its hosted Gmail OAuth integration. When your users link their Gmail accounts through Unipile, Unipile requests the appropriate gmail oauth scopes based on the features your app enables, manages token refresh automatically, and handles re-authorization when scope requirements change. Your team does not need to declare or manage gmail api scope lists directly, and you benefit from Unipile's existing Google verification status for restricted scopes.\" } }, { \"@type\": \"Question\", \"name\": \"What is the gmail.send scope and when should I use it?\", \"acceptedAnswer\": { \"@type\": \"Answer\", \"text\": \"The gmail.send scope is a sensitive gmail api scope that allows your app to send emails on behalf of an authenticated user, without granting any read or modify access to their existing messages. It is the recommended minimum scope for apps that only need to send emails - such as outreach tools, notification systems, or follow-up automation - and do not need to read the inbox. Using gmail.send instead of gmail.modify or gmail.readonly avoids the restricted scope security assessment.\" } }, { \"@type\": \"Question\", \"name\": \"How do Gmail API scopes affect GDPR compliance?\", \"acceptedAnswer\": { \"@type\": \"Answer\", \"text\": \"Gmail API scopes directly affect your GDPR compliance posture in several ways. The principle of data minimization requires you to request only the gmail api permissions necessary for your stated purpose. Your privacy policy and data processing agreements must accurately reflect which Gmail data your app accesses based on its declared scopes. Requesting excessive scopes creates a GDPR documentation gap and increases your data breach liability surface. When users revoke authorization, your app must immediately lose access to their Gmail data.\" } } ]}<\/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>#unipile-gas-faq,#unipile-gas-faq *,#unipile-gas-faq *::before,#unipile-gas-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;}#unipile-gas-faq { background: #f4f5f7 !important; padding: 72px 20px !important;}#unipile-gas-faq .gas-faq-container { max-width: 900px !important; margin: 0 auto !important;}#unipile-gas-faq .gas-eyebrow { 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; width: fit-content !important; margin-bottom: 16px !important;}#unipile-gas-faq .gas-eyebrow-dot { width: 7px !important; height: 7px !important; background: #3BB98B !important; border-radius: 50% !important; flex-shrink: 0 !important; display: inline-block !important;}#unipile-gas-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;}#unipile-gas-faq .gas-faq-intro { font-size: 16px !important; line-height: 1.75 !important; color: #383838 !important; margin-bottom: 36px !important;}#unipile-gas-faq .gas-faq-list { display: flex !important; flex-direction: column !important; gap: 12px !important; margin-bottom: 40px !important;}#unipile-gas-faq .gas-faq-item { background: #ffffff !important; border: 1px solid #e5e7eb !important; border-radius: 16px !important; overflow: hidden !important; transition: border-color 0.2s ease !important;}#unipile-gas-faq .gas-faq-item.gas-faq-active { border-color: #3BB98B !important;}#unipile-gas-faq .gas-faq-header { padding: 20px 24px !important; display: flex !important; align-items: center !important; gap: 16px !important; cursor: pointer !important; user-select: none !important;}#unipile-gas-faq .gas-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: all 0.2s ease !important; flex-shrink: 0 !important;}#unipile-gas-faq .gas-faq-item.gas-faq-active .gas-faq-num { background: #3BB98B !important; color: #ffffff !important;}#unipile-gas-faq .gas-faq-question { font-size: 16px !important; font-weight: 600 !important; color: #0f2736 !important; line-height: 1.4 !important; flex: 1 !important;}#unipile-gas-faq .gas-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: all 0.2s ease !important; flex-shrink: 0 !important;}#unipile-gas-faq .gas-faq-item.gas-faq-active .gas-faq-toggle { background: #3BB98B !important; transform: rotate(45deg) !important;}#unipile-gas-faq .gas-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;}#unipile-gas-faq .gas-faq-item.gas-faq-active .gas-faq-toggle svg { stroke: #ffffff !important;}#unipile-gas-faq .gas-faq-body { max-height: 0 !important; overflow: hidden !important; transition: max-height 0.35s ease !important;}#unipile-gas-faq .gas-faq-body.gas-faq-open { max-height: 800px !important;}#unipile-gas-faq .gas-faq-answer { padding: 0 28px 28px 76px !important; font-size: 15px !important; line-height: 1.78 !important; color: #4a5568 !important;}#unipile-gas-faq .gas-faq-answer a { color: #2aaa7e !important; text-decoration: underline !important;}#unipile-gas-faq .gas-faq-answer strong { color: #0f2736 !important; font-weight: 700 !important;}#unipile-gas-faq .gas-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;}#unipile-gas-faq .gas-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;}#unipile-gas-faq .gas-faq-cta-text { font-size: 15.5px !important; color: #383838 !important; line-height: 1.6 !important;}#unipile-gas-faq .gas-faq-cta-text strong { color: #0f2736 !important; font-weight: 700 !important;}#unipile-gas-faq .gas-faq-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: 14px !important; font-weight: 700 !important; border: 2px solid #DDDF4C !important; transition: all 0.3s ease !important; cursor: pointer !important; white-space: nowrap !important; font-family: 'Inter', sans-serif !important;}#unipile-gas-faq .gas-faq-cta-btn:hover { transform: translateY(-3px) !important;}#unipile-gas-faq .gas-faq-cta-btn svg { width: 15px !important; height: 15px !important; stroke: currentColor !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) { #unipile-gas-faq { padding: 56px 16px !important; } #unipile-gas-faq h2 { font-size: 28px !important; } #unipile-gas-faq .gas-faq-answer { padding: 0 16px 20px 16px !important; }}@media (max-width: 600px) { #unipile-gas-faq { padding: 44px 14px !important; } #unipile-gas-faq h2 { font-size: 26px !important; } #unipile-gas-faq .gas-faq-cta-bar { flex-direction: column !important; } #unipile-gas-faq .gas-faq-cta-btn { width: 100% !important; justify-content: center !important; }}<\/style><div id=\"unipile-gas-faq\"> <span id=\"gas-faq\" style=\"display:block;position:relative;top:-80px;visibility:hidden;\"><\/span> <div class=\"gas-faq-container\"> <div class=\"gas-eyebrow\"><span class=\"gas-eyebrow-dot\"><\/span><span>FAQ<\/span><\/div> <h2>Frequently Asked Questions about Gmail API Scopes<\/h2> <pee class=\"gas-faq-intro\">Common questions about gmail api scopes, gmail oauth scopes, and the verification process – answered concisely for developers building Gmail integrations.<\/pee> <div class=\"gas-faq-list\"> <div class=\"gas-faq-item\"> <div class=\"gas-faq-header\"> <div class=\"gas-faq-num\">01<\/div> <div class=\"gas-faq-question\">What are Gmail API scopes?<\/div> <div class=\"gas-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=\"gas-faq-body\"> <div class=\"gas-faq-answer\"><strong>Gmail API scopes<\/strong> are OAuth 2.0 permission strings that define exactly which Gmail resources your application can access on behalf of a user. They are declared when generating the OAuth authorization URL and displayed to the user on Google’s consent screen. Once a user grants access, your token is limited to only the actions those gmail api scopes permit – nothing more. Start with our <a href=\"\/gmail-api-send-email-a-comprehensive-guide-for-developers\/\" style=\"color:#2aaa7e;font-weight:600;text-decoration:underline;\">full Gmail API integration walkthrough<\/a>.<\/div> <\/div> <\/div> <div class=\"gas-faq-item\"> <div class=\"gas-faq-header\"> <div class=\"gas-faq-num\">02<\/div> <div class=\"gas-faq-question\">What is the difference between gmail.readonly and gmail.modify?<\/div> <div class=\"gas-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=\"gas-faq-body\"> <div class=\"gas-faq-answer\">Both <code>gmail.readonly<\/code> and <code>gmail.modify<\/code> are restricted gmail api scopes. <strong>gmail.readonly<\/strong> provides read-only access to all messages, threads, labels, and settings – your app cannot send or change anything. <strong>gmail.modify<\/strong> adds the ability to read, compose, send emails, and manage labels, but excludes permanent message deletion. If your app needs to read and send but not delete, <code>gmail.modify<\/code> is preferred over the broader <code>mail.google.com\/<\/code> scope. See our <a href=\"\/read-email-api\/\" style=\"color:#2aaa7e;font-weight:600;text-decoration:underline;\">how to read user emails via a unified API<\/a>.<\/div> <\/div> <\/div> <div class=\"gas-faq-item\"> <div class=\"gas-faq-header\"> <div class=\"gas-faq-num\">03<\/div> <div class=\"gas-faq-question\">Do I need a security assessment for all Gmail API scopes?<\/div> <div class=\"gas-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=\"gas-faq-body\"> <div class=\"gas-faq-answer\">No. Only <strong>restricted gmail api scopes<\/strong> require an annual third-party security assessment (~$500\/year). Non-sensitive scopes like <code>gmail.labels<\/code> require only standard OAuth app review. Sensitive scopes like <code>gmail.send<\/code> require Google’s OAuth verification process but no security assessment. Restricted scopes – including <code>gmail.readonly<\/code>, <code>gmail.modify<\/code>, <code>gmail.compose<\/code>, <code>gmail.metadata<\/code>, <code>gmail.insert<\/code>, and <code>mail.google.com\/<\/code> – require the full assessment process. More on this in our <a href=\"\/secure-email-api-for-developers-and-businesses\/\" style=\"color:#2aaa7e;font-weight:600;text-decoration:underline;\">secure email API patterns for regulated industries<\/a>.<\/div> <\/div> <\/div> <div class=\"gas-faq-item\"> <div class=\"gas-faq-header\"> <div class=\"gas-faq-num\">04<\/div> <div class=\"gas-faq-question\">What is the gmail.modify scope used for?<\/div> <div class=\"gas-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=\"gas-faq-body\"> <div class=\"gas-faq-answer\">The <code>gmail.modify<\/code> scope grants read, compose, send, and label management access to Gmail, but excludes the ability to permanently delete messages. It is the recommended restricted scope for full-featured email integrations such as <strong>CRM email sync, helpdesk tools, and email clients<\/strong> that need to both read and send messages. It is preferred over <code>mail.google.com\/<\/code> because it limits data exposure by excluding permanent delete functionality. Related: <a href=\"\/send-email-on-behalf-of-user-api-the-game-changer-for-software-editors\/\" style=\"color:#2aaa7e;font-weight:600;text-decoration:underline;\">sending email on behalf of users<\/a>.<\/div> <\/div> <\/div> <div class=\"gas-faq-item\"> <div class=\"gas-faq-header\"> <div class=\"gas-faq-num\">05<\/div> <div class=\"gas-faq-question\">How many test users can I have before completing Gmail API scope verification?<\/div> <div class=\"gas-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=\"gas-faq-body\"> <div class=\"gas-faq-answer\">You can test your app with up to <strong>100 Google accounts<\/strong> while your OAuth app is in testing mode, regardless of the gmail api scopes you declare. These test accounts must be manually added in the Google Cloud Console OAuth consent screen settings. Once you exceed 100 users or want to release publicly, you must complete the appropriate verification process for your scope sensitivity level.<\/div> <\/div> <\/div> <div class=\"gas-faq-item\"> <div class=\"gas-faq-header\"> <div class=\"gas-faq-num\">06<\/div> <div class=\"gas-faq-question\">Can I combine multiple Gmail API scopes in one OAuth request?<\/div> <div class=\"gas-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=\"gas-faq-body\"> <div class=\"gas-faq-answer\">Yes, you can combine multiple gmail api scopes in a single OAuth authorization request by passing them as an array to the <code>scope<\/code> parameter. For example, you can request <code>gmail.send<\/code> + <code>gmail.labels<\/code> together. However, combining scopes increases the permissions shown on Google’s consent screen and may trigger additional verification requirements if any combined scope is restricted. Always request only the minimum combination your app genuinely needs. For the Microsoft side, see <a href=\"\/microsoft-graph-oauth-email\/\" style=\"color:#2aaa7e;font-weight:600;text-decoration:underline;\">Microsoft Graph OAuth scopes equivalent<\/a>.<\/div> <\/div> <\/div> <div class=\"gas-faq-item\"> <div class=\"gas-faq-header\"> <div class=\"gas-faq-num\">07<\/div> <div class=\"gas-faq-question\">What is the gmail.metadata scope?<\/div> <div class=\"gas-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=\"gas-faq-body\"> <div class=\"gas-faq-answer\">The <code>gmail.metadata<\/code> scope is a restricted gmail api scope that grants access to <strong>email headers and labels only<\/strong>, without any access to email body content or attachments. It is useful for routing engines, categorization systems, or analytics tools that process emails based on sender, recipient, subject, or labels without reading private message content. Despite being restricted, it has a narrower data footprint than <code>gmail.readonly<\/code> and may be easier to justify in a security assessment. We dive deeper in our <a href=\"\/email-synchronization-api-for-seamless-software-integration\/\" style=\"color:#2aaa7e;font-weight:600;text-decoration:underline;\">email sync API for full inbox sync<\/a>.<\/div> <\/div> <\/div> <div class=\"gas-faq-item\"> <div class=\"gas-faq-header\"> <div class=\"gas-faq-num\">08<\/div> <div class=\"gas-faq-question\">How does Unipile handle Gmail API scopes for my app?<\/div> <div class=\"gas-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=\"gas-faq-body\"> <div class=\"gas-faq-answer\">Unipile manages gmail api scopes internally as part of its hosted Gmail OAuth integration. When your users link their Gmail accounts through Unipile, Unipile requests the appropriate gmail oauth scopes based on the features you enable, manages token refresh automatically, and handles re-authorization when scope requirements change. Your team does not need to declare or manage gmail api scope lists directly – and you benefit from <a href=\"https:\/\/developer.unipile.com\/docs\/google-oauth\" target=\"_blank\">Unipile’s existing Google verification<\/a> status for restricted scopes. For more on this, check our <a href=\"\/email-api-providers\/\" style=\"color:#2aaa7e;font-weight:600;text-decoration:underline;\">comparison of 6 email API providers<\/a>.<\/div> <\/div> <\/div> <div class=\"gas-faq-item\"> <div class=\"gas-faq-header\"> <div class=\"gas-faq-num\">09<\/div> <div class=\"gas-faq-question\">What is gmail.send and when should I use it?<\/div> <div class=\"gas-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=\"gas-faq-body\"> <div class=\"gas-faq-answer\">The <code>gmail.send<\/code> scope is a <strong>sensitive gmail api scope<\/strong> that allows your app to send emails on behalf of an authenticated user, without granting read or modify access to existing messages. It is the recommended minimum scope for apps that only send emails – outreach tools, notification systems, or follow-up automation. Using <code>gmail.send<\/code> instead of <code>gmail.modify<\/code> avoids the restricted scope security assessment entirely, significantly accelerating your path to production. See our <a href=\"\/send-email-api\/\" style=\"color:#2aaa7e;font-weight:600;text-decoration:underline;\">dedicated Send Email API guide<\/a>.<\/div> <\/div> <\/div> <div class=\"gas-faq-item\"> <div class=\"gas-faq-header\"> <div class=\"gas-faq-num\">10<\/div> <div class=\"gas-faq-question\">How do Gmail API scopes affect GDPR compliance?<\/div> <div class=\"gas-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=\"gas-faq-body\"> <div class=\"gas-faq-answer\">Gmail API scopes directly affect your GDPR posture. The <strong>data minimization principle<\/strong> requires you to request only the gmail api permissions necessary for your stated purpose. Your privacy policy must accurately reflect which Gmail data you access. Requesting excessive scopes creates a GDPR documentation gap and increases breach liability. When users revoke authorization, your app must immediately lose access to their Gmail data – this is enforced by Google’s token invalidation but must also be reflected in your data deletion procedures.<\/div> <\/div> <\/div> <\/div> <div class=\"gas-faq-cta-bar\"> <pee class=\"gas-faq-cta-text\"><strong>Need help choosing the right Gmail API scopes for your use case?<\/strong> Our team can review your integration architecture and recommend the minimum scope set.<\/pee> <span class=\"gas-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 initFaq(){ var faq = document.getElementById('unipile-gas-faq'); if (!faq) return; var items = faq.querySelectorAll('.gas-faq-item'); items.forEach(function(item){ var header = item.querySelector('.gas-faq-header'); var body = item.querySelector('.gas-faq-body'); if (!header || !body) return; header.addEventListener('click', function(){ var isOpen = item.classList.contains('gas-faq-active'); items.forEach(function(i){ i.classList.remove('gas-faq-active'); var b = i.querySelector('.gas-faq-body'); if (b) b.classList.remove('gas-faq-open'); }); if (!isOpen) { item.classList.add('gas-faq-active'); body.classList.add('gas-faq-open'); } }); }); } if (document.readyState === 'loading') { document.addEventListener('DOMContentLoaded', initFaq); } else { initFaq(); }})();<\/script>[\/et_pb_code][\/et_pb_column][\/et_pb_row][\/et_pb_section]\n","protected":false},"excerpt":{"rendered":"<p>Her Gmail API kapsam\u0131 a\u00e7\u0131kland\u0131: gmail.readonly, gmail.modify, gmail.send ve daha fazlas\u0131. Kullan\u0131m durumunuz i\u00e7in minimum kapsam\u0131 se\u00e7in + Node.js ve Python'da kod \u00f6rnekleri.<\/p>","protected":false},"author":4,"featured_media":278967,"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":[37],"tags":[],"post_folder":[],"class_list":["post-278951","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-cat-guides"],"yoast_head":"\n<title>Gmail API Scopes Explained: Choose the Right Permissions for Your App - Unipile<\/title>\n<meta name=\"description\" content=\"Every Gmail API scope explained: gmail.readonly, gmail.modify, gmail.send and more. Choose the minimum scope for your use case + code samples in Node.js and Python.\" \/>\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-kapsamlari-kilavuzu\/\" \/>\n<meta property=\"og:locale\" content=\"tr_TR\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Gmail API Scopes Explained: Choose the Right Permissions for Your App - Unipile\" \/>\n<meta property=\"og:description\" content=\"Every Gmail API scope explained: gmail.readonly, gmail.modify, gmail.send and more. Choose the minimum scope for your use case + code samples in Node.js and Python.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.unipile.com\/tr\/gmail-api-kapsamlari-kilavuzu\/\" \/>\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-25T13:25:16+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-05-25T13:38:11+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.unipile.com\/wp-content\/uploads\/2026\/05\/em-23-gmail-api-scopes.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-scopes-guide\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-scopes-guide\\\/\"},\"author\":{\"name\":\"Damien Girardeau\",\"@id\":\"https:\\\/\\\/www.unipile.com\\\/#\\\/schema\\\/person\\\/a2ac44e22bdc27d497ce8b58716a673e\"},\"headline\":\"Gmail API Scopes Explained: Choose the Right Permissions for Your App\",\"datePublished\":\"2026-05-25T13:25:16+00:00\",\"dateModified\":\"2026-05-25T13:38:11+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-scopes-guide\\\/\"},\"wordCount\":5017,\"publisher\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/#organization\"},\"image\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-scopes-guide\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/www.unipile.com\\\/wp-content\\\/uploads\\\/2026\\\/05\\\/em-23-gmail-api-scopes.png\",\"articleSection\":[\"Guides\"],\"inLanguage\":\"tr\"},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-scopes-guide\\\/\",\"url\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-scopes-guide\\\/\",\"name\":\"Gmail API Scopes Explained: Choose the Right Permissions for Your App - Unipile\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-scopes-guide\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-scopes-guide\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/www.unipile.com\\\/wp-content\\\/uploads\\\/2026\\\/05\\\/em-23-gmail-api-scopes.png\",\"datePublished\":\"2026-05-25T13:25:16+00:00\",\"dateModified\":\"2026-05-25T13:38:11+00:00\",\"description\":\"Every Gmail API scope explained: gmail.readonly, gmail.modify, gmail.send and more. Choose the minimum scope for your use case + code samples in Node.js and Python.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-scopes-guide\\\/#breadcrumb\"},\"inLanguage\":\"tr\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.unipile.com\\\/gmail-api-scopes-guide\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"tr\",\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-scopes-guide\\\/#primaryimage\",\"url\":\"https:\\\/\\\/www.unipile.com\\\/wp-content\\\/uploads\\\/2026\\\/05\\\/em-23-gmail-api-scopes.png\",\"contentUrl\":\"https:\\\/\\\/www.unipile.com\\\/wp-content\\\/uploads\\\/2026\\\/05\\\/em-23-gmail-api-scopes.png\",\"width\":2400,\"height\":1260,\"caption\":\"Gmail API Scopes: 14 OAuth permissions across 3 sensitivity levels\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.unipile.com\\\/gmail-api-scopes-guide\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Accueil\",\"item\":\"https:\\\/\\\/www.unipile.com\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Gmail API Scopes Explained: Choose the Right Permissions for Your App\"}]},{\"@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 Kapsamlar\u0131 A\u00e7\u0131kland\u0131: Uygulaman\u0131z \u0130\u00e7in Do\u011fru Yetkileri Se\u00e7in - Unipile","description":"Her Gmail API kapsam\u0131 a\u00e7\u0131kland\u0131: gmail.readonly, gmail.modify, gmail.send ve daha fazlas\u0131. Kullan\u0131m durumunuz i\u00e7in minimum kapsam\u0131 se\u00e7in + Node.js ve Python'da kod \u00f6rnekleri.","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-kapsamlari-kilavuzu\/","og_locale":"tr_TR","og_type":"article","og_title":"Gmail API Scopes Explained: Choose the Right Permissions for Your App - Unipile","og_description":"Every Gmail API scope explained: gmail.readonly, gmail.modify, gmail.send and more. Choose the minimum scope for your use case + code samples in Node.js and Python.","og_url":"https:\/\/www.unipile.com\/tr\/gmail-api-kapsamlari-kilavuzu\/","og_site_name":"Unipile","article_publisher":"https:\/\/www.facebook.com\/unipilefr","article_published_time":"2026-05-25T13:25:16+00:00","article_modified_time":"2026-05-25T13:38:11+00:00","og_image":[{"width":2400,"height":1260,"url":"https:\/\/www.unipile.com\/wp-content\/uploads\/2026\/05\/em-23-gmail-api-scopes.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-scopes-guide\/#article","isPartOf":{"@id":"https:\/\/www.unipile.com\/gmail-api-scopes-guide\/"},"author":{"name":"Damien Girardeau","@id":"https:\/\/www.unipile.com\/#\/schema\/person\/a2ac44e22bdc27d497ce8b58716a673e"},"headline":"Gmail API Scopes Explained: Choose the Right Permissions for Your App","datePublished":"2026-05-25T13:25:16+00:00","dateModified":"2026-05-25T13:38:11+00:00","mainEntityOfPage":{"@id":"https:\/\/www.unipile.com\/gmail-api-scopes-guide\/"},"wordCount":5017,"publisher":{"@id":"https:\/\/www.unipile.com\/#organization"},"image":{"@id":"https:\/\/www.unipile.com\/gmail-api-scopes-guide\/#primaryimage"},"thumbnailUrl":"https:\/\/www.unipile.com\/wp-content\/uploads\/2026\/05\/em-23-gmail-api-scopes.png","articleSection":["Guides"],"inLanguage":"tr"},{"@type":"WebPage","@id":"https:\/\/www.unipile.com\/gmail-api-scopes-guide\/","url":"https:\/\/www.unipile.com\/gmail-api-scopes-guide\/","name":"Gmail API Kapsamlar\u0131 A\u00e7\u0131kland\u0131: Uygulaman\u0131z \u0130\u00e7in Do\u011fru Yetkileri Se\u00e7in - Unipile","isPartOf":{"@id":"https:\/\/www.unipile.com\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.unipile.com\/gmail-api-scopes-guide\/#primaryimage"},"image":{"@id":"https:\/\/www.unipile.com\/gmail-api-scopes-guide\/#primaryimage"},"thumbnailUrl":"https:\/\/www.unipile.com\/wp-content\/uploads\/2026\/05\/em-23-gmail-api-scopes.png","datePublished":"2026-05-25T13:25:16+00:00","dateModified":"2026-05-25T13:38:11+00:00","description":"Her Gmail API kapsam\u0131 a\u00e7\u0131kland\u0131: gmail.readonly, gmail.modify, gmail.send ve daha fazlas\u0131. Kullan\u0131m durumunuz i\u00e7in minimum kapsam\u0131 se\u00e7in + Node.js ve Python'da kod \u00f6rnekleri.","breadcrumb":{"@id":"https:\/\/www.unipile.com\/gmail-api-scopes-guide\/#breadcrumb"},"inLanguage":"tr","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.unipile.com\/gmail-api-scopes-guide\/"]}]},{"@type":"ImageObject","inLanguage":"tr","@id":"https:\/\/www.unipile.com\/gmail-api-scopes-guide\/#primaryimage","url":"https:\/\/www.unipile.com\/wp-content\/uploads\/2026\/05\/em-23-gmail-api-scopes.png","contentUrl":"https:\/\/www.unipile.com\/wp-content\/uploads\/2026\/05\/em-23-gmail-api-scopes.png","width":2400,"height":1260,"caption":"Gmail API Scopes: 14 OAuth permissions across 3 sensitivity levels"},{"@type":"BreadcrumbList","@id":"https:\/\/www.unipile.com\/gmail-api-scopes-guide\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Accueil","item":"https:\/\/www.unipile.com\/"},{"@type":"ListItem","position":2,"name":"Gmail API Scopes Explained: Choose the Right Permissions for Your App"}]},{"@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\/278951","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=278951"}],"version-history":[{"count":4,"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/posts\/278951\/revisions"}],"predecessor-version":[{"id":278968,"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/posts\/278951\/revisions\/278968"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/media\/278967"}],"wp:attachment":[{"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/media?parent=278951"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/categories?post=278951"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/tags?post=278951"},{"taxonomy":"post_folder","embeddable":true,"href":"https:\/\/www.unipile.com\/tr\/wp-json\/wp\/v2\/post_folder?post=278951"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}