- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- AudienceRow
- AudienceDimensionValue
- Testen!
Ruft eine Zielgruppenliste mit Nutzern ab. Nutzer, die eine Zielgruppe erstellt haben, können nicht sofort aufgelistet werden. Zuerst ist eine Anfrage an audienceLists.create
erforderlich, um eine Zielgruppenliste mit Nutzern zu erstellen, und dann wird diese Methode verwendet, um die Nutzer in der Zielgruppenliste abzurufen.
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 Sie sinnvoll ist. Weitere Informationen finden Sie unter https://support.google.com/analytics/answer/9267572.
Diese Methode ist in der Betaversion unter audienceExports.query verfügbar. Wenn Sie uns Feedback zu dieser API geben möchten, füllen Sie bitte das Feedback-Formular zur Google Analytics Audience Export API aus.
HTTP-Anfrage
POST https://analyticsdata.googleapis.com/v1alpha/{name=properties/*/audienceLists/*}:query
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 in der ersten Anfrage kein „offset“ angegeben oder entsprechend „offset“ auf 0. Die erste Anfrage gibt die erste Weitere Informationen zu diesem Parameter finden Sie unter Paginierung. |
limit |
Optional. Die Anzahl der zurückzugebenden Zeilen. Wenn kein Wert angegeben ist, werden 10.000 Zeilen zurückgegeben. Die API gibt maximal 250.000 Zeilen pro Anfrage zurück,unabhängig davon, wie viele Zeilen Sie anfordern. Die API kann auch weniger Zeilen als vom angeforderten Weitere Informationen zu diesem Parameter finden Sie unter Paginierung. |
Antworttext
Eine Liste der Nutzer in einer Zielgruppenliste.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{ "audienceRows": [ { object ( |
Felder | |
---|---|
audienceRows[] |
Zeilen für jeden Nutzer in einer Zielgruppenliste. Die Anzahl der Zeilen in dieser Antwort ist kleiner oder gleich der Seitengröße der Anfrage. |
audienceList |
Konfigurationsdaten zur abgefragten AudienceList Wird zurückgegeben, um die Interpretation der Zielgruppenzeilen in dieser Antwort zu erleichtern. Die Dimensionen in dieser AudienceList entsprechen beispielsweise den Spalten in AudienceRows. |
rowCount |
Die Gesamtzahl der Zeilen im Zielgruppenlisten-Ergebnis. Weitere Informationen zu diesem Parameter 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
Attribute für Dimensionswerte in der Zeile „Zielgruppe/Nutzer“
JSON-Darstellung |
---|
{
"dimensionValues": [
{
object ( |
Felder | |
---|---|
dimensionValues[] |
Jedes Dimensionswertattribut für eine Zielgruppe Für jede angeforderte Dimensionsspalte wird ein Dimensionswert hinzugefügt. |
AudienceDimensionValue
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. |