Eseguire la migrazione collettiva di script identici da Rhino a V8

Questa pagina descrive come eseguire la migrazione di script identici a V8 utilizzando Apps Script e l'API Apps Script.

Devi eseguire la migrazione di tutti gli script che utilizzano il runtime Rhino prima che questo venga disattivato, a partire dal 31 gennaio 2026. Se hai più script identici in esecuzione su Rhino, puoi eseguirne la migrazione a V8 tutti insieme utilizzando l'API Apps Script.

Configura l'ambiente

  1. Nelle impostazioni della dashboard di Apps Script, attiva l'API Apps Script.
    1. Vai alle impostazioni della dashboard di Apps Script.
    2. Se l'API è disattivata, fai clic su API Google Apps Script, quindi attiva il pulsante di attivazione/disattivazione dell'API Google Apps Script.
  2. Crea un progetto Google Cloud standard o riutilizza un progetto esistente.
  3. Nel tuo progetto Cloud, configura la schermata per il consenso OAuth.

  4. Nel tuo progetto Cloud, attiva l'API Apps Script.

    Attivare l'API Apps Script

  5. Crea un progetto Apps Script e assegnalo al tuo progetto cloud.

    1. Crea un progetto Apps Script autonomo dalla dashboard di Apps Script o andando su script.new.
    2. Fai clic su Impostazioni progetto L'icona delle impostazioni del progetto.
    3. Nella sezione Progetto Google Cloud Platform (GCP), fai clic su Cambia progetto.
    4. Inserisci il numero del progetto Cloud.
    5. Fai clic su Imposta progetto.

Eseguire la migrazione degli script

Il seguente esempio di codice mostra come utilizzare l'API Apps Script per eseguire la migrazione di script identici da Rhino a V8 sostituendo i file in ogni progetto Apps Script con un insieme di file compatibili con V8.

Assicurati di disporre almeno dell'accesso di editor ai progetti di script che prevedi di migrare.

Code.gs

function updateRhinoScripts() {
  // An array of script IDs of script projects to migrate.
  // TODO(developer): Replace with your script IDs.
  const scriptIds = ['abcdef12345678', 'abcdef12345678'];
  // An array of file objects to replace the existing files in each script project.
  // Remember to include all files for the script, excluded files are deleted.
  // TODO(developer): Replace with your script files.
  const filesToUpdate = {
    "files": [
      {
        "name": "Code",
        "type": "SERVER_JS",
        "source": "// New updates\nfunction myFunction() {\n  console.log('Hello, world!');\n}"
      },
      {
        "name": "appsscript",
        "type": "JSON",
        "source": JSON.stringify({
          "timeZone": "America/New_York",
          "dependencies": {},
          "exceptionLogging": "STACKDRIVER",
          "runtimeVersion": "V8"
        })
      }
    ]
  };
  updateMultipleAppsScripts(scriptIds, filesToUpdate);
}

function updateMultipleAppsScripts(scriptIds, filesToUpdate) {
  // 'scriptIds' should be an array of script IDs
  // 'filesToUpdate' should be an array of objects, each with:
  // name: The filename (For example, "Code", "Utilities")
  // source: The source code for that file.
  scriptIds.forEach(function (scriptId) {
    // Makes the API request.
    const response = UrlFetchApp.fetch(
      `https://script.googleapis.com/v1/projects/${scriptId}/content`,
      {
        method: "PUT",
        headers: {
          Authorization: `Bearer ${ScriptApp.getOAuthToken()}`
        },
        contentType: "application/json",
        payload: JSON.stringify(filesToUpdate),
        muteHttpExceptions: true
      }
    );
    if (response.getResponseCode() !== 200) {
      console.log(`Error updating script ${scriptId}: ${response.getContentText()}`);
    } else {
      console.log(`Script ${scriptId} updated successfully!`);
    }
  });
}

appsscript.json

Per utilizzare l'API Apps Script nel tuo progetto Apps Script, devi aggiungere i seguenti ambiti OAuth al file manifest:

  • "https://www.googleapis.com/auth/script.projects"
  • "https://www.googleapis.com/auth/script.external_request"

Per visualizzare il file manifest nell'editor, fai clic su Impostazioni progetto L'icona delle impostazioni del progetto e seleziona la casella Mostra il file manifest "appsscript.json" nell'editor. Di seguito è riportato un file manifest di esempio con gli ambiti OAuth appropriati:

{
  "timeZone": "America/Denver",
  "dependencies": {
  },
  "oauthScopes": [
  "https://www.googleapis.com/auth/script.projects",
  "https://www.googleapis.com/auth/script.external_request"
],
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8"
}