Google 애널리틱스용 MCP 서버를 사용해 보세요.
GitHub에서 설치하고
공지사항에서 자세한 내용을 확인하세요.
Method: properties.recurringAudienceLists.create
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
반복되는 잠재고객 목록을 만듭니다. 반복되는 잠재고객 목록은 매일 새로운 잠재고객 목록을 생성합니다. 잠재고객 목록은 목록 생성 시점에 잠재고객에 속한 사용자입니다.
반복되는 잠재고객 목록을 사용하면 매일 사용할 수 있는 최신 데이터를 기반으로 잠재고객 목록이 제공됩니다. 잠재고객 목록을 수동으로 만드는 경우 추가 날짜의 데이터를 기반으로 하는 잠재고객 목록을 언제 사용할 수 있는지 알 수 없습니다. 이 반복되는 잠재고객 목록을 사용하면 추가 날짜의 데이터를 사용할 수 있을 때 잠재고객 목록이 자동으로 생성됩니다. 추가 날짜의 데이터가 준비되었을 때 추측하기 위해 하루 중 다양한 시점에 잠재고객 목록을 수동으로 만드는 것보다 반복되는 잠재고객 목록을 사용하면 더 적은 할당량 토큰을 소비할 수 있습니다.
이 메서드는 알파 버전을 출시할 만큼 안정적일 때, 베타를 시작하기 전 구문 및 기능에 대한 의견을 수집하기 위해 도입됩니다. 이 API에 대한 의견을 보내려면 Google 애널리틱스 Audience Export API 의견 양식을 작성하세요.
HTTP 요청
POST https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/recurringAudienceLists
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
| 매개변수 |
parent |
string
필수 항목입니다. 이 반복 잠재고객 목록이 생성될 상위 리소스입니다. 형식: properties/{property}
|
요청 본문
요청 본문에는 RecurringAudienceList의 인스턴스가 포함됩니다.
응답 본문
성공한 경우 응답 본문에 새로 생성된 RecurringAudienceList의 인스턴스가 포함됩니다.
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/analytics.readonlyhttps://www.googleapis.com/auth/analytics
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
[null,null,["최종 업데이트: 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`"]]
