{"registry_version":"2026.1025.387","generated_at":"2026-10-25T06:27:00Z","content_sha256":"089d16f627d9365e3d0663cc8069203706d7cb23a76c332226e29686968811a5","signed":true,"signature":{"key_id":"ed25519:74ca19268e364242","algorithm":"ed25519","expires_at":"2026-11-24T06:27:09Z","expired":false,"manifest":"/registry/manifest.json"},"id":"google/workspace-marketplace","name":"Google Workspace Marketplace listing (public or private app)","vendor":"Google","status":"researched","last_verified":null,"last_researched":"2026-10-25","summary":"Publish a Workspace add-on, Chat app or web app to the Google Workspace Marketplace. Configure the Marketplace SDK and a store listing in your Cloud project; public apps must pass OAuth verification and a Marketplace app review, private apps are available to your own organisation straight away.","account_model":{"summary":"The Marketplace listing is configured inside a Google Cloud project (Marketplace SDK). The same project holds the OAuth consent screen and client. Public listings can be published from any Google account's project; private (internal) listings must be built with a Google Workspace account and are visible only to that Workspace organisation.","accounts":[{"name":"Google Account or Google Workspace account","kind":"organisation","owned_by":"the company","required":true,"note":"A Workspace account is required for private apps."},{"name":"Google Cloud project with the Marketplace SDK enabled","kind":"project","owned_by":"the company","parent":"Google Account or Google Workspace account","required":true}],"notes":["Public versus private visibility cannot be changed after the app is published, so choose carefully.","The listing name must match the OAuth consent screen app name."]},"prerequisites":[{"entry":"google/cloud-project-run","note":"Any Google Cloud project works; Cloud Run, Firestore and the domain parts are not needed."},{"entry":"google/oauth-verification","note":"Public apps must have passed OAuth verification before the Marketplace review; restricted scopes also need the annual CASA assessment."}],"identity_requires":["app_name","app_description","privacy_policy_url","terms_url","support_email","website","app_icon_url"],"have_ready":[{"kind":"app_icon","description":"App icons 32x32 and 128x128 px (and 48x48 and 96x96 if the project includes a web app), plus a 220x140 card banner","why":null,"needed_for":["store-listing"],"auto_check":"none","source_url":"https://developers.google.com/workspace/marketplace/create-listing"},{"kind":"other","description":"1 to 10 screenshots, 1280x800 recommended (640x400 or 2560x1600 accepted), square corners and full bleed","why":null,"needed_for":["store-listing"],"auto_check":"none","source_url":"https://developers.google.com/workspace/marketplace/create-listing"},{"kind":"app_privacy_policy_url","description":"Privacy policy URL, terms of service URL and support URL, each a real web page","why":null,"needed_for":["store-listing"],"auto_check":"website_live","source_url":"https://developers.google.com/workspace/marketplace/create-listing"},{"kind":"live_website","description":"Website for the app or developer","why":null,"needed_for":["store-listing"],"auto_check":"website_live","source_url":"https://developers.google.com/workspace/marketplace/how-to-publish"},{"kind":"other","description":"A fully working, tested app (not still in testing) and a justification for each OAuth scope","why":null,"needed_for":["submit"],"auto_check":"none","source_url":"https://developers.google.com/workspace/marketplace/about-app-review"}],"steps":[{"id":"project","title":"Use the app's Google Cloud project","summary":"Create or reuse the Cloud project that holds the app's OAuth client and configuration.","route":"guided","gate":"human_submit","human_only":true,"gate_label":"You press submit","depends_on":[],"optional":false,"url":"https://console.cloud.google.com/projectcreate","lead_time":null,"preflight":[],"captures":null},{"id":"oauth","title":"Configure OAuth and get it verified (public apps)","summary":"Set up the OAuth consent screen with user type External and publishing status In production, request the narrowest scopes, and complete Google OAuth verification. Internal user type or Testing status is a common rejection cause.","route":"guided","gate":"third_party_review","human_only":true,"gate_label":"The provider reviews it","depends_on":["project"],"optional":false,"url":"https://console.cloud.google.com/apis/credentials/consent","lead_time":null,"preflight":[],"captures":null},{"id":"enable-sdk","title":"Enable and configure the Marketplace SDK","summary":"Enable the Google Workspace Marketplace SDK, then set visibility (public or private), installation settings (individual or admin install) and which Workspace apps the app extends.","route":"guided","gate":"human_submit","human_only":true,"gate_label":"You press submit","depends_on":["project"],"optional":false,"url":"https://console.cloud.google.com/apis/library","lead_time":null,"preflight":[],"captures":null},{"id":"store-listing","title":"Create the store listing","summary":"Fill in name, descriptions, category, icons, banner, screenshots and the terms, privacy and support links.","route":"guided","gate":"human_submit","human_only":true,"gate_label":"You press submit","depends_on":["enable-sdk"],"optional":false,"url":null,"lead_time":null,"preflight":["privacy_policy_reachable","app_icon_present","display_name_matches_business"],"captures":null},{"id":"submit","title":"Submit for publication","summary":"Press Submit for review yourself. Private apps become available to your organisation immediately; public apps go to Google review and publish automatically when approved.","route":"guided","gate":"third_party_review","human_only":true,"gate_label":"The provider reviews it","depends_on":["oauth","store-listing"],"optional":false,"url":null,"lead_time":{"official":{"text":"App review typically takes several days, depending on queue and how much work the app needs.","source_url":"https://developers.google.com/workspace/marketplace/about-app-review","source_title":"Google Workspace Marketplace – About app review"},"reported":null,"typical_minutes":null},"preflight":[],"captures":null}],"gates":[{"step":"project","gate":"human_submit","label":"You press submit"},{"step":"oauth","gate":"third_party_review","label":"The provider reviews it"},{"step":"enable-sdk","gate":"human_submit","label":"You press submit"},{"step":"store-listing","gate":"human_submit","label":"You press submit"},{"step":"submit","gate":"third_party_review","label":"The provider reviews it"}],"lead_times":[{"step":"submit","what":"Submit for publication","official":{"text":"App review typically takes several days, depending on queue and how much work the app needs.","source_url":"https://developers.google.com/workspace/marketplace/about-app-review","source_title":"Google Workspace Marketplace – About app review"},"reported":null}],"outputs":[],"renewals":[{"what":"Annual security reassessment (CASA) if the app uses restricted scopes","every":"1 year","every_days":365,"source_url":"https://support.google.com/cloud/answer/13465431?hl=en"}],"estimated_minutes":null,"guide_url":"https://verapli.com/guides/google/workspace-marketplace"}