Method: properties.audienceLists.list

Listet alle Zielgruppenlisten für eine Property auf. Mit dieser Methode können Sie vorhandene Zielgruppenlisten finden und wiederverwenden, anstatt unnötige neue Zielgruppenlisten zu erstellen. Eine Zielgruppe kann mehrere Zielgruppenlisten enthalten, die wiederum die Nutzer umfassen, die an verschiedenen Tagen in einer Zielgruppe waren.

Eine Einführung in Zielgruppenlisten mit Beispielen finden Sie unter Zielgruppenlisten erstellen.

Diese Methode ist in der Betaversion unter audienceExports.list 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

GET https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/audienceLists

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. In der Antwort sind alle Zielgruppenlisten für diese Property aufgeführt. Format: properties/{property}

Suchparameter

Parameter
pageSize

integer

Optional. Die maximale Anzahl von Zielgruppenlisten, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn keine Vorgabe erfolgt, werden maximal 200 Zielgruppenlisten zurückgegeben. Der Maximalwert beträgt 1.000 (höhere Werte werden auf das Maximum erzwungen).
pageToken

string

Optional. Ein Seitentoken, das von einem vorherigen audienceLists.list-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für audienceLists.list bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Eine Liste aller Zielgruppenlisten für eine Property.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "audienceLists": [
    {
      object (AudienceList)
    }
  ],
  "nextPageToken": string
}
Felder
audienceLists[]

object (AudienceList)

Jede Zielgruppenliste für eine Property.
nextPageToken

string

Ein Token, das als pageToken gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics