Skripts, die an Google Docs gebunden sind, In Google Tabellen und Google Formulare können verschiedene Arten von Benutzeroberflächenelementen angezeigt werden: vordefinierte Benachrichtigungen und Eingabeaufforderungen sowie Dialogfelder und Seitenleisten mit benutzerdefinierten Seiten des HTML-Dienstes. In der Regel umfassen diese Elemente werden über die Menüpunkte geöffnet. Hinweis: In Google Formulare Elemente der Benutzeroberfläche sind nur für Mitbearbeiter sichtbar, die das Formular öffnen. und nicht an Nutzer, die das Formular öffnen, um zu antworten.)
Dialogfelder für Benachrichtigungen
Eine Benachrichtigung ist ein vordefiniertes Dialogfeld, das in einem
Präsentationen oder Formulare-Editoren. Es wird eine Meldung und ein „OK“ angezeigt. Schaltfläche; Titel und
sind optional. Es ähnelt dem Aufrufen von
window.alert()
in clientseitigem JavaScript
in einem Webbrowser.
Bei Benachrichtigungen wird das serverseitige Script angehalten, während das Dialogfeld geöffnet ist. Das Skript wird fortgesetzt, nachdem der Nutzer das Dialogfeld geschlossen hat, aber JDBC Verbindungen bleiben über die Dauer der Sperrung hinweg nicht bestehen.
Wie im Beispiel unten gezeigt,
und Google Tabellen verwenden die Methode Ui.alert()
,
gibt es in drei Varianten. Standardeinstellung "OK" überschreiben Schaltfläche, übergeben eine
Wert aus Ui.ButtonSet
-Enum
als buttons
-Argument. Um zu ermitteln, auf welche Schaltfläche
die Nutzenden geklickt haben,
den Rückgabewert für alert()
an den
Ui.Button
enum.
function onOpen() {
SpreadsheetApp.getUi() // Or DocumentApp or SlidesApp or FormApp.
.createMenu('Custom Menu')
.addItem('Show alert', 'showAlert')
.addToUi();
}
function showAlert() {
var ui = SpreadsheetApp.getUi(); // Same variations.
var result = ui.alert(
'Please confirm',
'Are you sure you want to continue?',
ui.ButtonSet.YES_NO);
// Process the user's response.
if (result == ui.Button.YES) {
// User clicked "Yes".
ui.alert('Confirmation received.');
} else {
// User clicked "No" or X in the title bar.
ui.alert('Permission denied.');
}
}
Aufforderungsdialogfelder
Eine Aufforderung ist ein vordefiniertes Dialogfeld, das in Google Docs, Google Tabellen,
Präsentationen oder Formulare-Editoren. Es wird eine Nachricht, ein Texteingabefeld und die Meldung „OK“ angezeigt.
Schaltfläche; ein Titel und alternative Schaltflächen sind optional. Es ähnelt dem Aufrufen von
window.prompt()
in clientseitigem JavaScript
in einem Webbrowser.
Bei Eingabeaufforderungen wird das serverseitige Skript angehalten, während das Dialogfeld geöffnet ist. Das Skript wird fortgesetzt, nachdem der Nutzer das Dialogfeld geschlossen hat, aber JDBC Verbindungen bleiben über die Dauer der Sperrung hinweg nicht bestehen.
Wie im Beispiel unten gezeigt, wird in Google Docs – Formulare, Präsentationen und Tabellen die Methode Ui.prompt()
,
das in drei Varianten erhältlich ist. Standardeinstellung "OK" überschreiben Schaltfläche
einen Wert aus Ui.ButtonSet
übergeben.
enum als Argument buttons
auf. Um die Antwort des Nutzers zu bewerten, erfassen Sie die
Rückgabewert für prompt()
, dann Aufruf
PromptResponse.getResponseText()
um die Eingabe des Nutzers abzurufen und den Rückgabewert für
PromptResponse.getSelectedButton()
zur Ui.Button
-Enum hinzu.
function onOpen() {
SpreadsheetApp.getUi() // Or DocumentApp or SlidesApp or FormApp.
.createMenu('Custom Menu')
.addItem('Show prompt', 'showPrompt')
.addToUi();
}
function showPrompt() {
var ui = SpreadsheetApp.getUi(); // Same variations.
var result = ui.prompt(
'Let\'s get to know each other!',
'Please enter your name:',
ui.ButtonSet.OK_CANCEL);
// Process the user's response.
var button = result.getSelectedButton();
var text = result.getResponseText();
if (button == ui.Button.OK) {
// User clicked "OK".
ui.alert('Your name is ' + text + '.');
} else if (button == ui.Button.CANCEL) {
// User clicked "Cancel".
ui.alert('I didn\'t get your name.');
} else if (button == ui.Button.CLOSE) {
// User clicked X in the title bar.
ui.alert('You closed the dialog.');
}
}
Benutzerdefinierte Dialogfelder
In einem benutzerdefinierten Dialogfeld kann ein Nutzer des HTML-Dienstes angezeigt werden Google Docs-, Google Tabellen-, Google Präsentationen- oder Google Formulare-Editoren verwenden.
Bei benutzerdefinierten Dialogfeldern wird das serverseitige Script nicht angehalten, wenn es geöffnet ist.
Die clientseitige Komponente kann asynchrone Aufrufe an das serverseitige Skript senden.
mit der google.script
API
für HTML-Dienst-Schnittstellen.
Das Dialogfeld kann sich selbst schließen, indem es
google.script.host.close()
Clientseite einer HTML-Dienst-Schnittstelle. Das Dialogfeld kann nicht geschlossen werden durch
Benutzeroberflächen
oder andere Benutzeroberflächen.
Wie im Beispiel unten gezeigt, wird in Google Docs, Google Formulare, Google Präsentationen und Google Tabellen die Methode Ui.showModalDialog()
zum Öffnen des Dialogfelds verwendet.
Code.gs
function onOpen() { SpreadsheetApp.getUi() // Or DocumentApp or SlidesApp or FormApp. .createMenu('Custom Menu') .addItem('Show dialog', 'showDialog') .addToUi(); } function showDialog() { var html = HtmlService.createHtmlOutputFromFile('Page') .setWidth(400) .setHeight(300); SpreadsheetApp.getUi() // Or DocumentApp or SlidesApp or FormApp. .showModalDialog(html, 'My custom dialog'); }
Page.html
Hello, world! <input type="button" value="Close" onclick="google.script.host.close()" />
Benutzerdefinierte Seitenleisten
In einer Seitenleiste kann der Nutzer eines HTML-Dienstes angezeigt werden. in Google Docs, Google Formulare, Google Präsentationen oder Google Tabellen
Das serverseitige Script wird über Seitenleisten nicht angehalten, wenn das Dialogfeld geöffnet ist. Die
kann die clientseitige Komponente asynchrone Aufrufe an das serverseitige Skript senden.
mit der google.script
API
für HTML-Dienst-Schnittstellen.
Die Seitenleiste kann sich selbst schließen, indem sie
google.script.host.close()
Clientseite einer HTML-Dienst-Schnittstelle. Die Seitenleiste kann nicht geschlossen werden
durch andere Benutzeroberflächen, nur durch den Benutzer oder sich selbst.
Wie im Beispiel unten gezeigt, wird die Seitenleiste in Google Docs, Google Formulare, Google Präsentationen und Google Tabellen mit der Methode Ui.showSidebar()
geöffnet.
Code.gs
function onOpen() { SpreadsheetApp.getUi() // Or DocumentApp or SlidesApp or FormApp. .createMenu('Custom Menu') .addItem('Show sidebar', 'showSidebar') .addToUi(); } function showSidebar() { var html = HtmlService.createHtmlOutputFromFile('Page') .setTitle('My custom sidebar'); SpreadsheetApp.getUi() // Or DocumentApp or SlidesApp or FormApp. .showSidebar(html); }
Page.html
Hello, world! <input type="button" value="Close" onclick="google.script.host.close()" />
Dialogfelder zum Öffnen von Dateien
Google Picker ist ein „file-open“- Dialogfeld für Informationen gespeichert in Google-Server, einschließlich Google Drive, Google Bildersuche, Google Video Suche und mehr.
Wie im Beispiel unten gezeigt, kann die clientseitige JavaScript API von Picker verwendet werden. im HTML-Dienst, um ein benutzerdefiniertes Dialogfeld zu erstellen, mit dem Nutzer wählen vorhandene Dateien aus oder laden neue hoch und geben diese Auswahl an Ihr Skript für die weitere Verwendung.
So aktivieren Sie die Auswahl und rufen einen API-Schlüssel ab:
- Prüfen Sie, ob Ihr Skriptprojekt ein GCP-Standardprojekt verwendet.
- „Google Picker API“ aktivieren in Ihrem Google Cloud-Projekt.
- Wählen Sie, während Ihr Google Cloud-Projekt noch geöffnet ist, APIs und Dienste, dann Klicken Sie auf Anmeldedaten.
- Klicken Sie auf Anmeldedaten erstellen > API-Schlüssel. Durch diese Aktion wird der Schlüssel erstellt. Sie sollten ihn jedoch bearbeiten, um sowohl Anwendungseinschränkungen als auch eine API-Einschränkung hinzuzufügen.
- Klicken Sie im Dialogfeld „API-Schlüssel“ auf Schließen.
- Klicken Sie neben dem erstellten API-Schlüssel auf das Dreipunkt-Menü > API-Schlüssel bearbeiten.
Führen Sie unter Anwendungseinschränkungen die folgenden Schritte aus:
- Wählen Sie HTTP-Verweis-URLs (Websites) aus.
- Klicken Sie unter Website-Einschränkungen auf Element hinzufügen.
- Klicken Sie auf Referrer-URL und geben Sie
*.google.com
ein. - Fügen Sie ein weiteres Element hinzu und geben Sie
*.googleusercontent.com
als Referrer-URL ein. - Klicken Sie auf Fertig.
Führen Sie unter API-Einschränkungen die folgenden Schritte aus:
- Wählen Sie Schlüssel einschränken aus.
Wählen Sie im Abschnitt APIs auswählen die Option Google Picker API aus und klicken Sie auf OK.
Hinweis: Die Google Picker API wird nur angezeigt, wenn Sie da in der Liste nur APIs angezeigt werden, die für die Cloud Projekt arbeiten.
Klicken Sie unter API-Schlüssel auf „In Zwischenablage kopieren“ .
Klicken Sie unten auf Speichern.