Google 애널리틱스용 MCP 서버를 사용해 보세요.
GitHub에서 설치하고
공지사항에서 자세한 내용을 확인하세요.
Method: properties.provisionSubproperty
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
생성된 하위 속성에 적용되는 하위 속성과 하위 속성 이벤트 필터를 만듭니다.
HTTP 요청
POST https://analyticsadmin.googleapis.com/v1alpha/properties:provisionSubproperty
URL은 gRPC 트랜스코딩 구문을 사용합니다.
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
| 필드 |
subproperty |
object (Property)
필수 항목입니다. 만들 하위 속성입니다.
|
subpropertyEventFilter |
object (SubpropertyEventFilter)
선택사항입니다. 일반 속성에서 만들 하위 속성 이벤트 필터입니다.
|
customDimensionAndMetricSynchronizationMode |
enum (SynchronizationMode)
선택사항입니다. 맞춤 측정기준 및 측정항목의 하위 속성 기능 동기화 모드
|
응답 본문
properties.provisionSubproperty RPC의 응답 메시지입니다.
성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.
| 필드 |
subproperty |
object (Property)
생성된 하위 속성입니다.
|
subpropertyEventFilter |
object (SubpropertyEventFilter)
생성된 하위 속성 이벤트 필터입니다.
|
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/analytics.edit
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
[null,null,["최종 업데이트: 2025-07-26(UTC)"],[[["\u003cp\u003eProvision a new subproperty and an optional subproperty event filter within a Google Analytics property using the \u003ccode\u003eproperties.provisionSubproperty\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eThe request body requires a \u003ccode\u003esubproperty\u003c/code\u003e object and optionally includes a \u003ccode\u003esubpropertyEventFilter\u003c/code\u003e for defining event filtering criteria.\u003c/p\u003e\n"],["\u003cp\u003eA successful response returns the created \u003ccode\u003esubproperty\u003c/code\u003e and the \u003ccode\u003esubpropertyEventFilter\u003c/code\u003e if provided.\u003c/p\u003e\n"],["\u003cp\u003eThis operation requires the \u003ccode\u003ehttps://www.googleapis.com/auth/analytics.edit\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],["This content outlines how to provision a subproperty and its event filter using an HTTP POST request. The request, sent to `https://analyticsadmin.googleapis.com/v1alpha/properties:provisionSubproperty`, requires a JSON body containing the `subproperty` object and an optional `subpropertyEventFilter` object. Upon success, the response body will include the created `subproperty` and the `subpropertyEventFilter`, as objects. Authorization using the `analytics.edit` scope is required.\n"],null,["# Method: properties.provisionSubproperty\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ProvisionSubpropertyResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreate a subproperty and a subproperty event filter that applies to the created subproperty.\n\n### HTTP request\n\n`POST https://analyticsadmin.googleapis.com/v1alpha/properties:provisionSubproperty`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"subproperty\": { object (/analytics/devguides/config/admin/v1/rest/v1alpha/properties#Property) }, \"subpropertyEventFilter\": { object (/analytics/devguides/config/admin/v1/rest/v1alpha/properties.subpropertyEventFilters#SubpropertyEventFilter) }, \"customDimensionAndMetricSynchronizationMode\": enum (/analytics/devguides/config/admin/v1/rest/v1alpha/properties.subpropertySyncConfigs#SynchronizationMode) } ``` |\n\n| Fields ||\n|-----------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `subproperty` | `object (`[Property](/analytics/devguides/config/admin/v1/rest/v1alpha/properties#Property)`)` Required. The subproperty to create. |\n| `subpropertyEventFilter` | `object (`[SubpropertyEventFilter](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.subpropertyEventFilters#SubpropertyEventFilter)`)` Optional. The subproperty event filter to create on an ordinary property. |\n| `customDimensionAndMetricSynchronizationMode` | `enum (`[SynchronizationMode](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.subpropertySyncConfigs#SynchronizationMode)`)` Optional. The subproperty feature synchronization mode for Custom Dimensions and Metrics |\n\n### Response body\n\nResponse message for properties.provisionSubproperty RPC.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"subproperty\": { object (/analytics/devguides/config/admin/v1/rest/v1alpha/properties#Property) }, \"subpropertyEventFilter\": { object (/analytics/devguides/config/admin/v1/rest/v1alpha/properties.subpropertyEventFilters#SubpropertyEventFilter) } } ``` |\n\n| Fields ||\n|--------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `subproperty` | `object (`[Property](/analytics/devguides/config/admin/v1/rest/v1alpha/properties#Property)`)` The created subproperty. |\n| `subpropertyEventFilter` | `object (`[SubpropertyEventFilter](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.subpropertyEventFilters#SubpropertyEventFilter)`)` The created subproperty event filter. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/analytics.edit`"]]
