Nachdem Sie alles eingerichtet haben, können Sie Anfragen an die Google Play Developer Reporting API senden, um Metadaten zu Messwertsätzen abzurufen und deren Messwerte abzufragen.
Die folgenden Codebeispiele zeigen, wie Sie einige einfache Anfragen senden. Die folgenden Methoden zeigen beispielsweise, wie Sie verschiedene Messwerte für Ihre Anwendung abrufen können. Es gibt verschiedene Suchparameter, mit denen Sie Ihre Abfrage eingrenzen können.
Metadaten des Messwertsatzes abrufen
Im folgenden Beispiel werden die Metadaten für den Messwert der Absturzrate für die fiktive Anwendung com.example.app abgerufen.
Einfache Anfrage:
In dieser HTTP-GET-Anfrage wird der Parameter für den Anwendungsnamen angegeben und die vollständige Messwertressource zurückgegeben, die Ihrer Anwendung zugeordnet ist.
GET https://playdeveloperreporting.googleapis.com/v1beta1/apps/com.example.app/crashRateMetricSet
Antwort auf Messwertinformationen:
Die Antwort enthält die folgenden Felder, die sich auf den Messwertsatz beziehen:
{
"freshness_info": {
"freshness": [
"aggregation_period": "DAILY"
"latest_end_time": { year: "2021" month: "7" day: "22" time_zone: "America/Los_Angeles" }
]
}
}
Abfragefunktion verwenden
Die folgende HTTP-POST-Anfrage für dieselbe Ressource verwendet den Endpunkt query, um bestimmte Daten aus dem Messwertsatz abzurufen.
POST https://playdeveloperreporting.googleapis.com/v1beta1/apps/com.example.app/crashRateMetricSet:query
Übergeben Sie im Anfragetext die Abfrageoptionen, um Messwerte basierend auf bestimmten Kriterien abzurufen.
{
"timeline_spec": {
"aggregation_period": "DAILY"
"start_time": { year: "2021" month: "7" day: "1" time_zone: "America/Los_Angeles" }
"end_time": { year: "2021" month: "7" day: "3" time_zone: "America/Los_Angeles" }
}
"dimensions": ["apiLevel"]
"metrics": ["errorReportCount", "distinctUsers"]
"page_size": "10"
}
Hier einige Beispiele für die Sammlungsebene:
| Felder | |
|---|---|
timelineSpec |
Spezifikation der Zeitachsenaggregationsparameter. Eine Liste der unterstützten Zusammenfassungszeiträume finden Sie in der Dokumentation der einzelnen Messwerte. |
dimensions[] |
Dimensionen zum Aufschlüsseln der Messwerte. Eine Liste der unterstützten Dimensionen finden Sie in der Dokumentation der einzelnen Messwerte. |
metrics[] |
Zusammengefasste Messwerte. |
pageSize |
Maximale Größe der zurückgegebenen Daten. Wenn nicht angegeben, werden maximal 1.000 Zeilen zurückgegeben. Der Höchstwert beträgt 100.000. Werte über 100.000 werden zu 100.000 gezwungen. |
Umgang mit Antworten
Nachdem ein Server eine gültige Anfrage verarbeitet hat, die gültige Felder enthält, sendet er einen HTTP-Statuscode 200 OK zusammen mit den angeforderten Daten zurück. Wenn der fields-Abfrageparameter einen Fehler enthält oder aus einem anderen Grund ungültig ist, gibt der Server den HTTP-Statuscode 400 Bad Request zusammen mit einer Fehlermeldung zurück, die den Nutzer darüber informiert, was bei seiner Feldauswahl falsch war (z. B. "Invalid field timeline_spec").
Hier sehen Sie das Antwortbeispiel aus der Einführung oben.
POST https://playdeveloperreporting.googleapis.com/v1beta1/apps/com.example.app/crashRateMetricSet:query
Die Antwort sieht so aus:
200 OK
{
rows: [
{
aggregation_period: "DAILY"
start_time: { year: "2021" month: "7" day: "1" time_zone: "America/Los_Angeles" }
dimensions: [{dimension: "apiLevel" int64_value: "20"}]
metrics: [
{metric: "errorReportCount" decimal_value: "100"},
{metric: "distinctUsers" decimal_value: "57"},
]
}, {
aggregation_period: "DAILY"
start_time: { year: "2021" month: "7" day: "1" time_zone: "America/Los_Angeles" }
dimensions: [{dimension: "apiLevel" int64_value: "21"}]
metrics: [
{metric: "errorReportCount" decimal_value: "123"},
{metric: "distinctUsers" decimal_value: "65"},
]
},
...
]
next_page_token: "eW91IGhhdmUgdG9vIG11Y2ggZnJlZSB0aW1l"
}
Hinweis:Bei APIs, die Abfrageparameter für die Datenpaginierung (z. B. maxResults und nextPageToken) unterstützen, können Sie mit diesen Parametern die Ergebnisse der einzelnen Abfragen auf eine überschaubare Größe reduzieren.