22

Is it somehow possible to publish add-on without Google approval if it is going to be used for my internal use only?

If not, is there any possibility to make some of the Google Apps Script projects global. So that I would not need to copy same code/functionality to another spreadsheets or docs to get my custom macros to work again.

3 Answers 3

28

Yes. An Add-On can be published as private from the Workspace Marketplace SDK. A private add-on is restricted to the domain/Workspace Account that the Apps Script file is in.

https://developers.google.com/apps-script/add-ons/publish

An add-on can also be published as unlisted. Publishing the add-on as private to the Workspace account is not the same as publishing an add-on as unlisted. An unlisted add-on is technically public, it's just not shown in the Workspace Marketplace. To install an unlisted add-on the users need the link.

There are two different approvals for an add-on. One for the OAuth consent, and another for the function of the add-on. The OAuth consent is for asking the user for permission to different services / access in their account. The function of the add-on is for appearance, content and whether it works or not.

Both private and unlisted Add-ons are actually published to the Workspace Marketplace, but who is allowed to access/see them is what is controlled. You need to create a "standard" Google Cloud Project, associate it with your Apps Script project, and then enable the Workspace Marketplace SDK, and configure settings in the Workspace Marketplace SDK.

To get to your Google Cloud Platform dashboard, use the URL

https://console.cloud.google.com/home/dashboard

  • From "IAM and Admin" navigate to "Manage Resources"
  • If you don't have an organization name, then create an organization. NOTE: An organization can only be set up through a Workspace account OR through "Cloud Identity." https://cloud.google.com/resource-manager/docs/creating-managing-organization#acquiring
  • Create a new GCP project
  • Get the GCP Project Number
  • Put the GCP Project Number into the Apps Script project
  • Navigate to the APIs and Services dashboard.
  • Make sure that the project that you want to use is listed in the drop down
  • Click "Enable APIs and Services"
  • Search for Workspace Marketplace
  • Enable the Workspace Marketplace SDK
  • Configure the Workspace Marketplace SDK

There is also the option to make an Apps Script project file available to other Apps Script projects as a "library." A library can be made available to other Apps Script projects, by providing the "project key" of the source Apps Script (library).

Whoever wants to use the source Apps Script file as a library needs the project key. To find the project key, from the code editor choose "File" - "Project Properties" and look for "Project key (Deprecated)"

To add an Apps Script file as a library, from the code editor, choose "Resources" - "Libraries". You don't need to do anything to create a Library. Every Apps Script project is available as a Library. All you need to do is share the Project Key.

You can add an "Add-On" menu item to a Google Spreadsheet or Doc, without publishing an Add-On, and that Add-On menu item will run any code that is in that document, just like an add on. But you would need to edit the document of every user you wanted to deploy the code to, and manually add the code to their document.

If the Apps Script file is not published as an add-on, then there's no point in creating an Add-On menu, since you can create a custom menu.

9
  • Thanks for the throughout answer. Mar 11, 2015 at 20:25
  • 1
    I already included my Google Forms add-on as Library, but there is no option to share the project key, not even in the File menu. I built this add-on based on a specific form, but I want to make it privately available to all my other forms without duplicating the code files across all form. Google Forms don't seem to allow a custom menu item to be added though. Any suggestions? Thanks! Sep 26, 2016 at 11:01
  • Can you clarify how a library works? For instance, I added the project create to Libraries but when I open a page the item it should add to the add-ons menu does not get created, and thus I am unable to access my functionality.
    – Michael
    Apr 25, 2018 at 23:21
  • @Michael Your question may be difficult to answer without knowing the details. Please read the troubleshooting guide, if you are not familiar with it. If you have a unique question, you can post a new question.
    – Alan Wells
    Apr 26, 2018 at 1:08
  • It now says that a project key is deprecated, is there a modern solution? Jan 30, 2019 at 19:20
1

By selecting Publish > Deploy as Spreadsheets Add-on under the Script Editor, will create a new item under the Chrome Web Store. This item will be linked to your CWS developer account, and you can publish the item as 'private', or as a draft available to testers, so that only people internal to your domain can access it.

4
  • Thanks Rivero, that sounds like a viable option as well. Mar 11, 2015 at 20:26
  • This requires to pay USD$5.00 to Google? Sep 26, 2016 at 11:19
  • 1
    Yes, there is a $5.00 fee for publishing. It's a single payment transaction, and will allow you to publish on the Chrome Web Store as well.
    – Rivero
    Sep 30, 2016 at 21:41
  • 2
    Wait, so you have to pay Google $5 every time you want to use or update your own script for internal use only???
    – Michael
    Apr 25, 2018 at 22:09
1

The upvoted answer is out of date. You can publish an add-on using G Suite Marketplace SDK which has its own "Integrate With Google" button in its configuration tab for local integration. See https://developers.google.com/gsuite/marketplace/sdk.

Google's help on the subject is decent enough, at https://developers.google.com/gsuite/add-ons/how-tos/publishing-editor-addons.

1
  • 2
    I can't find any documentation about an "Integrate with Google" button.
    – Alan Wells
    Aug 26, 2020 at 19:55

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.