- HTTP-Anfrage
- Pfadparameter
- Anfrageparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- MetricsGranularity
- MetricsFilter
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- MetricsValue
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- Testen!
Rufen Sie Messwertdaten für Skripts ab, z. B. die Anzahl der Ausführungen und aktive Nutzer.
HTTP-Anfrage
GET https://script.googleapis.com/v1/projects/{scriptId}/metrics
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
scriptId |
Pflichtfeld, das das Skript angibt, für das Messwerte abgerufen werden sollen. |
Abfrageparameter
Parameter | |
---|---|
metricsGranularity |
Pflichtfeld, das angibt, welcher Detaillierungsgrad von Messwerten zurückgegeben wird. |
metricsFilter |
Optionales Feld mit Filtern, die auf die Anfrage angewendet werden sollen. Dadurch wird der Umfang der zurückgegebenen Messwerte auf die im Filter angegebenen Werte begrenzt. |
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
Ressource mit Nutzungsstatistiken für ein bestimmtes Skript, basierend auf dem angegebenen Filter und der in der Anfrage vorhandenen Maske.
JSON-Darstellung |
---|
{ "activeUsers": [ { object ( |
Felder | |
---|---|
activeUsers[] |
Anzahl der aktiven Nutzer |
totalExecutions[] |
Gesamtzahl der Ausführungen. |
failedExecutions[] |
Anzahl der fehlgeschlagenen Ausführungen. |
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/script.metrics
Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
MetricsGranularity
Der Detaillierungsgrad des Messwerts, für den Daten zurückgegeben werden sollen.
Enums | |
---|---|
UNSPECIFIED_GRANULARITY |
Standardmäßiger Detaillierungsgrad für Messwerte, der verwendet wird, um keine Messwerte abzufragen. |
WEEKLY |
Stellt wöchentliche Messwerte dar. |
DAILY |
Stellt tägliche Messwerte über einen Zeitraum von 7 Tagen dar. |
MetricsFilter
Filter, mit dem der Umfang der Anfrage reduziert wird.
JSON-Darstellung |
---|
{ "deploymentId": string } |
Felder | |
---|---|
deploymentId |
Optionales Feld, das eine bestimmte Bereitstellung angibt, aus der Messwerte abgerufen werden sollen. |
MetricsValue
Messwert, der die Anzahl der gezählten Ausführungen enthält.
JSON-Darstellung |
---|
{ "value": string, "startTime": string, "endTime": string } |
Felder | |
---|---|
value |
Gibt die Anzahl der gezählten Ausführungen an. |
startTime |
Pflichtfeld, das die Startzeit des Intervalls angibt. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
endTime |
Pflichtfeld, das die Endzeit des Intervalls angibt. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |