- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- AudienceRow
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- AudienceDimensionValue
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- Testen!
Ruft einen Zielgruppenexport von Nutzern ab. Nachdem eine Zielgruppe erstellt wurde, können die Nutzer nicht sofort exportiert werden. Zuerst ist eine Anfrage an audienceExports.create
erforderlich, um einen Zielgruppenexport von Nutzern zu erstellen. Anschließend werden mit dieser Methode die Nutzer im Zielgruppenexport abgerufen.
Unter Zielgruppenexport erstellen finden Sie eine Einführung in Zielgruppenexporte mit Beispielen.
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.
Einige Methoden der Audience Export APIs befinden sich in der Alphaphase und andere in der Betaphase. Ziel ist es, Methoden für die Beta-Stabilität nach etwas Feedback und der Einführung weiterzuentwickeln. 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/v1beta/{name=properties/*/audienceExports/*}:query
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
name |
Erforderlich. Der Name des Zielgruppenexports, aus dem 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
Eine Liste der Nutzer in einem Zielgruppenexport.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{ "audienceRows": [ { object ( |
Felder | |
---|---|
audienceRows[] |
Zeilen für jeden Nutzer in einem Zielgruppenexport. Die Anzahl der Zeilen in dieser Antwort ist kleiner oder gleich der Seitengröße der Anfrage. |
audienceExport |
Konfigurationsdaten zu AudienceExport, die abgefragt werden. Wird zurückgegeben, um die Zielgruppenzeilen in dieser Antwort zu interpretieren. Beispielsweise entsprechen die Dimensionen in diesem AudienceExport den Spalten in den AudienceRows. |
rowCount |
Die Gesamtzahl der Zeilen im AudienceExport-Ergebnis. Weitere Informationen zu diesem Paginierungsparameter finden Sie unter Paginierung. |
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
AudienceRow
Dimensionswertattribute für die Zeile „Zielgruppennutzer“.
JSON-Darstellung |
---|
{
"dimensionValues": [
{
object ( |
Felder | |
---|---|
dimensionValues[] |
Jedes Dimensionswertattribut für einen Zielgruppennutzer. Für jede angeforderte Dimensionsspalte wird ein Dimensionswert hinzugefügt. |
AudienceDimensionValue
Der Wert einer Dimension.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld one_value . Eine Art von Dimensionswert. Für one_value ist nur einer der folgenden Werte zulässig: |
|
value |
Wert als String, wenn der Dimensionstyp ein String ist. |