Exportiert eine Zielgruppenliste mit Nutzern in eine Google-Tabelle. Nachdem eine Zielgruppe erstellt wurde, können die Nutzer nicht sofort Einträge erstellt werden. Zuerst ist eine Anfrage an audienceLists.create
erforderlich, um eine Zielgruppenliste mit Nutzern zu erstellen. Anschließend werden diese Nutzer mit dieser Methode in eine Google-Tabelle exportiert.
Eine Einführung in Zielgruppenlisten mit Beispielen finden Sie unter Zielgruppenlisten erstellen.
Mit Zielgruppen in Google Analytics 4 können Sie Ihre Nutzer so segmentieren, wie es für Ihr Unternehmen wichtig ist. Weitere Informationen finden Sie unter https://support.google.com/analytics/answer/9267572.
Diese Methode wird in der Alpha-Entwicklungsphase eingeführt, um vor der Betaphase Feedback zu Syntax und Funktionen einzuholen. Wenn Sie Feedback zu dieser API geben möchten, füllen Sie das Formular Feedback zur Google Analytics Audience Export API aus.
HTTP-Anfrage
POST https://analyticsdata.googleapis.com/v1alpha/{name=properties/*/audienceLists/*}:exportSheet
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
name |
Erforderlich. Der Name der Zielgruppenliste, aus der Nutzer abgerufen werden sollen. Format: |
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{ "offset": string, "limit": string } |
Felder | |
---|---|
offset |
Optional. Die Zeilenanzahl der Startzeile. Die erste Zeile wird als Zeile 0 gezählt. Beim Paging wird mit der ersten Anfrage kein Offset angegeben. oder entsprechend setzt Offset auf 0; Die erste Anfrage gibt die ersten Weitere Informationen zu diesem Paginierungsparameter finden Sie unter Paginierung. |
limit |
Optional. Die Anzahl der zurückzugebenden Zeilen. Wenn nicht angegeben, werden 10.000 Zeilen zurückgegeben. Die API gibt maximal 250.000 Zeilen pro Anfrage zurück,unabhängig davon, wie viele Zeilen angefordert werden. Die API kann auch weniger Zeilen als die angeforderte Weitere Informationen zu diesem Paginierungsparameter finden Sie unter Paginierung. |
Antworttext
Die erstellte Google-Tabelle mit der Liste der Nutzer in einer Zielgruppenliste
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{
"spreadsheetUri": string,
"spreadsheetId": string,
"rowCount": integer,
"audienceList": {
object ( |
Felder | |
---|---|
spreadsheetUri |
Ein URI, den Sie in Ihrem Browser aufrufen können, um die Google-Tabelle anzusehen. |
spreadsheetId |
Eine ID, die die erstellte Google Tabellen-Ressource identifiziert. |
rowCount |
Die Gesamtzahl der Zeilen im Zielgruppenlisten-Ergebnis. Weitere Informationen zu diesem Paginierungsparameter finden Sie unter Paginierung. |
audienceList |
Konfigurationsdaten für die Zielgruppenliste werden exportiert. Wird zurückgegeben, um die Zielgruppenliste in der Google-Tabelle dieser Antwort zu interpretieren. Beispielsweise kann die Zielgruppenliste mehr Zeilen enthalten, als in der Google-Tabelle vorhanden sind. In diesem Fall können Sie eine zusätzliche Exportanfrage für Tabellen mit einem anderen |
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets