Method: properties.audienceLists.list

Listet alle Zielgruppenlisten für eine Property auf. So können Sie vorhandene Zielgruppenlisten finden und wiederverwenden, anstatt unnötig neue Zielgruppenlisten zu erstellen. Für dieselbe Zielgruppe können mehrere Zielgruppenlisten vorhanden sein, die die Nutzerlisten darstellen, die an verschiedenen Tagen zu einer Zielgruppe gehörten.

Im Hilfeartikel Zielgruppenliste erstellen finden Sie eine Einführung in Zielgruppenlisten mit Beispielen.

Diese Methode ist in der Betaversion unter audienceExports.list verfügbar. Wenn Sie 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 werden alle Zielgruppenlisten für diese Property aufgeführt. Format: properties/{property}

Suchparameter

Parameter
pageSize

integer

Optional. Die maximale Anzahl der Zielgruppenlisten, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 200 Zielgruppenlisten zurückgegeben. Der Höchstwert ist 1.000. Höhere Werte werden auf den Höchstwert festgelegt.
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