> ## Documentation Index
> Fetch the complete documentation index at: https://help.airbridge.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 메타데이터 가져오기 (GroupBy)

사용할 수 있는 리포트 그룹바이를 조회합니다. \[[참고](http://abit.ly/actual-report-dimensions)]

<Card title="Try API Request" icon="rectangle-api" horizontal href="https://www.postman.com/airbridge-engineering/workspace/airbridge-api/request/22395869-59acdbe6-a302-47dc-8835-8e5dd2eb6dd6" />

```text GET theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
https://api.airbridge.io/dataspec/v2/apps/{app_name}/actual-report/fields
```

<h2 id="메타데이터-가져오기-groupby-request">
  Request
</h2>

***

<h3 id="메타데이터-가져오기-groupby-headers">
  Headers
</h3>

<ParamField header="Accept-Language" type="string">
  API 요청 및 결과 반환에 사용할 언어를 지정할 수 있습니다. ISO-639-1 포맷을 따릅니다.
</ParamField>

<ParamField header="Content-Type" type="string">
  리소스의 미디어 타입을 나타냅니다. 기본값으로 `application/json`을 사용합니다.
</ParamField>

<ParamField header="Authorization" type="string">
  API 요청에 사용하는 키값입니다. [키값 생성 및 조회 방법](/ko/references/introduction)을 확인하여 획득할 수 있습니다.
</ParamField>

<h3 id="메타데이터-가져오기-groupby-path-params">
  Path Params
</h3>

<ParamField path="app_name" type="string" required>
  에어브릿지 앱 이름(App Name)
</ParamField>

<RequestExample>
  ```shellscript Request theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
  curl -X GET 'https://api.airbridge.io/dataspec/v2/apps/{app_name}/actual-report/fields' \
    -H 'Accept-Language: ko' \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer {AIRBRIDGE-API-TOKEN}'
  ```
</RequestExample>

<h2 id="메타데이터-가져오기-groupby-response">
  Response
</h2>

***

### 200

### 404

입력한 필드에 오류가 있거나 해당하는 리소스가 없습니다.

<ResponseExample>
  ```json 200 theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
  {
    "data": [
      {
        "fields": [
          {
            "key": "event_date",
            "name": "Event Date",
            "example": "2019-05-31",
            "description": "이벤트 발생 날짜와 시간 (YYYY-MM-DD)",
            "serveToFilter": true
          },
          {
            "key": "event_year",
            "name": "Event Year",
            "example": "2019",
            "description": "이벤트 발생 년도",
            "serveToFilter": true
          },
          {
            "key": "event_month",
            "name": "Event Month",
            "example": "04",
            "description": "이벤트 발생 월",
            "serveToFilter": true
          }
        ],
        "groupName": "Event Datetime",
        "parentGroupName": null
      },
      {
        "fields": [
          {
            "key": "event_source",
            "name": "Event Source",
            "example": "App",
            "description": "Event가 발생한 소스",
            "serveToFilter": true
          },
          {
            "key": "event_type",
            "name": "Event Type",
            "example": "Impression",
            "description": "Event 타입",
            "serveToFilter": true
          },
          {
            "key": "event_category",
            "name": "Event Category",
            "example": "Move to App Store (Link)",
            "description": "Event 카테고리",
            "serveToFilter": true
          }
        ],
        "groupName": "Event Hierarchy",
        "parentGroupName": null
      },
      {
        "fields": [
          {
            "key": "channel",
            "name": "Channel",
            "example": "moloco",
            "description": "Touchpoints 와 Conversion이 발생한 Channel\n",
            "serveToFilter": true
          },
          {
            "key": "campaign",
            "name": "Campaign",
            "example": "2018_summer_campaign",
            "description": "Touchpoints 와 Conversion이 발생한 Campaign \n(SAN Publisher 대시보드에서 입력한 값 또는 Tracking Link의 캠페인 파라미터 값)",
            "serveToFilter": true
          }
        ],
        "groupName": "Touchpoint",
        "parentGroupName": null
      }
    ]
  }
  ```

  ```json 404 theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
  {
    "type": "about:blank",
    "title": "Not Found",
    "status": 404,
    "traceId": "1-000000-000000000000000"
  }
  ```
</ResponseExample>