اضغط الصور داخل Google Docs و Slides

Manual install, step by step

1. 1

   Get your API key

   Create a free MiCompress account (or sign in), open My account and press Copy key under API Access. The key starts with mc_. A free account includes 50 images a month — enough to try it; see plans for more.

2. 2

   Create an Apps Script project

   Go to script.google.com → New project. Click Untitled project at the top and rename it MiCompress.

3. 3

   Show the manifest file

   Click the gear icon (Project Settings) in the left bar and tick Show "appsscript.json" manifest file in editor. Go back to the Editor (the <> icon).

4. 4

   Paste in the five files

   Use the Copy buttons below. For Code.gs and appsscript.json, select everything already in the file and paste over it. For the other three, click + next to Files → Script and type the name without ".gs" (Apps Script adds it): CardBuilder, DocsHandler, SlidesHandler. Press Ctrl+S (⌘S on Mac) to save.

   Code.gs

   replace the default file

   View Copy

   CardBuilder.gs

   new script: CardBuilder

   View Copy

   DocsHandler.gs

   new script: DocsHandler

   View Copy

   SlidesHandler.gs

   new script: SlidesHandler

   View Copy

   appsscript.json

   replace the manifest

   View Copy
5. 5

   Add your API key

   Back in Project Settings, scroll to Script Properties → Add script property. Property: ADDON_API_KEY, value: your mc_… key. Click Save script properties.

6. 6

   Link a Google Cloud project

   Google requires add-ons to run under a standard Cloud project. In Google Cloud Console create a project (free, no billing needed). Open Google Auth Platform (OAuth consent screen) → Get started: any app name, your email, audience External (or Internal on a company Workspace). Under Audience → Test users, add your own Google address. Copy the Project number from the project's dashboard, then in Apps Script → Project Settings → Google Cloud Platform (GCP) Project → Change project, paste it and confirm. You do not need to enable any APIs.

7. 7

   Install the test deployment

   Click Deploy → Test deployments. Next to Application(s) make sure Google Docs and Google Slides are listed, click Install, then Done.

8. 8

   Open a document and authorize

   Open (or reload) any Google Doc or Slides deck. The MiCompress icon appears in the right-hand side panel — click it, then Authorize access. Because this copy belongs to you and is not verified by Google, you will see "Google hasn't verified this app": click Advanced → Go to MiCompress (unsafe) → Allow. It is your own script; the only data it sends out is each image, to the MiCompress API.

Troubleshooting