Wypróbuj serwer MCP w Google Analytics. Zainstaluj go z
GitHub. Więcej informacji znajdziesz w
ogłoszeniu.
Method: properties.recurringAudienceLists.create
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Tworzy cykliczną listę odbiorców. Cykliczne listy odbiorców generują nowe listy odbiorców każdego dnia. Listy odbiorców to użytkownicy znajdujący się na liście odbiorców w momencie jej utworzenia.
Cykliczna lista odbiorców zapewnia, że lista odbiorców powstaje na podstawie najnowszych danych dostępnych do użycia z danego dnia. Jeśli ręcznie utworzysz listę odbiorców, nie dowiesz się, kiedy będzie dostępna lista odbiorców utworzona na podstawie danych z dodatkowego dnia. Taka cykliczna lista odbiorców automatyzuje tworzenie listy odbiorców, gdy dostępne są dane z dodatkowego dnia. Użycie cyklicznej listy odbiorców oznacza mniejsze zużycie tokenów przydziału, a nie ręczne tworzenie listy odbiorców o różnych porach dnia, próbując się doczekać, kiedy będą gotowe dane z dodatkowego dnia.
Wprowadzamy tę metodę na poziomie stabilności alfa, aby zebrać opinie na temat jej składni i możliwości, zanim udostępnimy wersję beta. Aby przesłać opinię na temat tego interfejsu API, wypełnij formularz opinii o interfejsie Google Analytics Audience Export API.
Żądanie HTTP
POST https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/recurringAudienceLists
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
| Parametry |
parent |
string
Wymagane. Zasób nadrzędny, w którym zostanie utworzona ta cykliczna lista odbiorców. Format: properties/{property}
|
Treść żądania
Treść żądania zawiera wystąpienie elementu RecurringAudienceList.
Treść odpowiedzi
Jeśli operacja się uda, treść odpowiedzi będzie zawierała nowo utworzoną instancję RecurringAudienceList.
Zakresy autoryzacji
Wymaga jednego z tych zakresów OAuth:
https://www.googleapis.com/auth/analytics.readonlyhttps://www.googleapis.com/auth/analytics
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-26 UTC.
[null,null,["Ostatnia aktualizacja: 2025-07-26 UTC."],[[["\u003cp\u003eCreates recurring audience lists daily, ensuring the most recent data is available for use.\u003c/p\u003e\n"],["\u003cp\u003eAutomates audience list creation, reducing manual effort and quota token consumption.\u003c/p\u003e\n"],["\u003cp\u003eIntroduced at alpha stability, seeking feedback through a provided form.\u003c/p\u003e\n"],["\u003cp\u003eUses an HTTP POST request to create recurring audience lists under a specified property.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific OAuth scopes for authorization.\u003c/p\u003e\n"]]],["This content details how to create a recurring audience list via an API. Key actions include sending a `POST` request to a specific URL (`https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/recurringAudienceLists`). The request requires a `parent` path parameter indicating the property. The request body contains the `RecurringAudienceList` instance, and upon success, the response body returns a newly created `RecurringAudienceList`. This automated list generation uses less quota and ensures the use of the most recent data available. The use of certain authorization scopes are required.\n"],null,["# Method: properties.recurringAudienceLists.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates a recurring audience list. Recurring audience lists produces new audience lists each day. Audience lists are users in an audience at the time of the list's creation.\n\nA recurring audience list ensures that you have audience list based on the most recent data available for use each day. If you manually create audience list, you don't know when an audience list based on an additional day's data is available. This recurring audience list automates the creation of an audience list when an additional day's data is available. You will consume fewer quota tokens by using recurring audience list versus manually creating audience list at various times of day trying to guess when an additional day's data is ready.\n\nThis method is introduced at alpha stability with the intention of gathering feedback on syntax and capabilities before entering beta. To give your feedback on this API, complete the [Google Analytics Audience Export API Feedback](https://forms.gle/EeA5u5LW6PEggtCEA) form.\n\n### HTTP request\n\n`POST https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/recurringAudienceLists`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|----------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The parent resource where this recurring audience list will be created. Format: `properties/{property}` |\n\n### Request body\n\nThe request body contains an instance of [RecurringAudienceList](/analytics/devguides/reporting/data/v1/rest/v1alpha/properties.recurringAudienceLists#RecurringAudienceList).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [RecurringAudienceList](/analytics/devguides/reporting/data/v1/rest/v1alpha/properties.recurringAudienceLists#RecurringAudienceList).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/analytics.readonly`\n- `https://www.googleapis.com/auth/analytics`"]]
