Method: properties.audienceLists.create
나중에 검색할 수 있도록 잠재고객 목록을 만듭니다. 이 메서드는 잠재고객 목록의 리소스 이름을 빠르게 반환하고 장기 실행 비동기 요청을 시작하여 잠재고객 목록을 만듭니다. 잠재고객 목록에 사용자를 나열하려면 먼저 이 메서드를 통해 잠재고객 목록을 만든 후 잠재고객 리소스 이름을 audienceLists.query 메서드로 전송합니다.
잠재고객 목록에 대한 소개와 예를 보려면 잠재고객 목록 만들기를 참조하세요.
잠재고객 목록은 잠재고객 목록을 만들 때 현재 잠재고객에 포함되어 있던 사용자에 대한 개요입니다. 각기 다른 날에 한 잠재고객에 대한 잠재고객 목록을 만들면 사용자가 잠재고객에 들어오고 나갈 때 다른 결과가 반환됩니다.
Google 애널리틱스 4의 잠재고객을 사용하면 비즈니스에 중요한 방식으로 사용자를 분류할 수 있습니다. 자세한 내용은 https://support.google.com/analytics/answer/9267572를 참고하세요. 잠재고객 목록에는 각 잠재고객의 사용자가 포함됩니다.
이 메서드는 audienceExports.create에서 베타 버전으로 제공됩니다. 이 API에 대한 의견을 보내려면 Google 애널리틱스 Audience Export API 의견 양식을 작성하세요.
HTTP 요청
POST https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/audienceLists
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
| 매개변수 |
parent |
string
필수 항목입니다. 이 잠재고객 목록이 생성될 상위 리소스입니다. 형식: properties/{property}
|
요청 본문
요청 본문에는 AudienceList의 인스턴스가 포함됩니다.
응답 본문
성공한 경우 응답 본문에 새로 생성된 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 계열사의 등록 상표입니다.
최종 업데이트: 2024-05-02(UTC)
[null,null,["최종 업데이트: 2024-05-02(UTC)"],[[["Creates an audience list containing a snapshot of users in an audience at the time of creation, allowing for later retrieval and querying."],["The method utilizes an asynchronous request, returning the audience list resource name immediately while the list formation process occurs in the background."],["Audience lists are dynamic and reflect the current state of an audience; creating lists on different days for the same audience may yield varied results due to user fluctuations."],["Utilizes the `audienceExports.create` method at beta stability, requiring specific authorization scopes for access."]]],["This API method facilitates the creation of audience lists in Google Analytics 4. It initiates an asynchronous process to generate a list of users matching a defined audience. Key actions include sending a POST request to `audienceLists` with a defined `parent` path parameter, representing the property. The request body defines the audience list, and the successful response includes the audience list's resource name and an Operation instance. Authorization requires specific OAuth scopes. The newly created list can then be used for user segmentation.\n"]]
