Google 애널리틱스용 MCP 서버를 사용해 보세요.
GitHub에서 설치하고
공지사항에서 자세한 내용을 확인하세요.
Method: properties.audienceExports.create
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
나중에 가져올 수 있도록 잠재고객 내보내기를 만듭니다. 이 메서드는 잠재고객 내보내기의 리소스 이름을 빠르게 반환하고 잠재고객 내보내기를 형성하는 장기 실행 비동기식 요청을 시작합니다. 잠재고객 내보내기에서 사용자를 내보내려면 먼저 이 방법을 통해 잠재고객 내보내기를 만든 다음 잠재고객 리소스 이름을 audienceExports.query 메서드로 전송합니다.
잠재고객 내보내기에 대한 소개와 예를 함께 보려면 잠재고객 내보내기 만들기를 참고하세요.
잠재고객 내보내기는 잠재고객 내보내기 생성 시 현재 잠재고객에 포함되어 있는 사용자의 개요입니다. 서로 다른 날에 한 잠재고객에 대한 잠재고객 내보내기를 만들면 사용자가 잠재고객에 들어오고 나가면 다른 결과가 반환됩니다.
Google 애널리틱스 4의 잠재고객을 사용하면 비즈니스에 중요한 방식으로 사용자를 분류할 수 있습니다. 자세한 내용은 https://support.google.com/analytics/answer/9267572를 참고하세요. 잠재고객 내보내기에는 각 잠재고객의 사용자가 포함됩니다.
Audience Export API에는 알파 버전의 메서드와 베타 안정성의 메서드가 있습니다. 이는 의견을 수렴하고 도입한 후 메서드를 베타 안정성으로 발전시키기 위함입니다. 이 API에 대한 의견을 보내려면 Google 애널리틱스 Audience Export API 의견 양식을 작성하세요.
HTTP 요청
POST https://analyticsdata.googleapis.com/v1beta/{parent=properties/*}/audienceExports
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
| 매개변수 |
parent |
string
필수 항목입니다. 이 잠재고객 내보내기가 생성될 상위 리소스입니다. 형식: properties/{property}
|
요청 본문
요청 본문에는 AudienceExport의 인스턴스가 포함됩니다.
응답 본문
성공한 경우 응답 본문에 새로 생성된 Operation의 인스턴스가 포함됩니다.
승인 범위
다음 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 an audience export for later retrieval that contains a snapshot of users in an audience at the time of creation.\u003c/p\u003e\n"],["\u003cp\u003eThe API initiates a long-running asynchronous request to form an audience export, and the audience export's resource name is returned quickly.\u003c/p\u003e\n"],["\u003cp\u003eTo export users in an audience export, first create the audience export and then use the \u003ccode\u003eaudienceExports.query\u003c/code\u003e method with the audience resource name.\u003c/p\u003e\n"],["\u003cp\u003eAudience exports may vary day-to-day as users join or leave the audience being exported.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with either the \u003ccode\u003eanalytics.readonly\u003c/code\u003e or \u003ccode\u003eanalytics\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This outlines the process of creating an audience export through an API. It involves sending a POST request to a specified URL, including the parent property ID in the path parameters. The request body uses an `AudienceExport` instance. Upon success, it returns an `Operation` instance, signifying a long-running process. The audience export captures a user snapshot at creation, and different creations yield varied user lists. The API requires specific OAuth scopes for authorization.\n"],null,["# Method: properties.audienceExports.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 an audience export for later retrieval. This method quickly returns the audience export's resource name and initiates a long running asynchronous request to form an audience export. To export the users in an audience export, first create the audience export through this method and then send the audience resource name to the `audienceExports.query` method.\n\nSee [Creating an Audience Export](https://developers.google.com/analytics/devguides/reporting/data/v1/audience-list-basics) for an introduction to Audience Exports with examples.\n\nAn audience export is a snapshot of the users currently in the audience at the time of audience export creation. Creating audience exports for one audience on different days will return different results as users enter and exit the audience.\n\nAudiences in Google Analytics 4 allow you to segment your users in the ways that are important to your business. To learn more, see \u003chttps://support.google.com/analytics/answer/9267572\u003e. Audience exports contain the users in each audience.\n\nAudience Export APIs have some methods at alpha and other methods at beta stability. The intention is to advance methods to beta stability after some feedback and adoption. 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/v1beta/{parent=properties/*}/audienceExports`\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 audience export will be created. Format: `properties/{property}` |\n\n### Request body\n\nThe request body contains an instance of [AudienceExport](/analytics/devguides/reporting/data/v1/rest/v1beta/properties.audienceExports#AudienceExport).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Operation](/analytics/devguides/reporting/data/v1/rest/Shared.Types/Operation).\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`"]]
