조회 테이블 API

지역

기본 URL은 프로젝트의 데이터 상주 위치에 따라 달라집니다. 이 페이지의 모든 예제에서 프로젝트가 Amplitude의 EU 데이터 센터를 사용하지 않는 한 기본 URL을 사용하십시오. 이 경우 이 표의 EU 기본 URL을 사용하십시오.

요청은 https://amplitude.com(기본값) 또는 https://analytics.eu.amplitude.com (EU)로 이동합니다. https://analytics.amplitude.com호스트 이름은 분석 웹 앱(브라우저 UI)입니다. REST 요청에는 analytics.amplitude.com이 표에 나와 있는 호스트를 사용하십시오.

고려 사항

CSV 파일은 다음 요구 사항을 충족해야 합니다.

• 최대 파일 크기는 100MB이며 파일의 행 수는 1,000,000개를 초과할 수 없습니다.
• 첫 번째 행에는 열 이름/헤더가 포함되어야 합니다.
• 첫 번째 열은 매핑 속성 값과 일치해야 하며 고유한 값을 포함해야 합니다. 룩업 테이블은 정확히 일치하는 항목을 검색하며 대소문자를 구분합니다.
• 각 열은 쉼표로 구분해야 합니다.
• 행은 줄 바꿈으로 구분해야 합니다.
• 필드 값에 쉼표나 따옴표가 포함되어 있는 경우 해당 값을 큰따옴표로 묶으십시오. 첫 번째 큰따옴표는 열 데이터의 시작을 표시하고 마지막 큰따옴표는 열 데이터의 끝을 표시합니다. 값에 큰따옴표가 있는 문자열이 포함되어 있으면 각 문자열을 두 개의 큰따옴표로 바꿉니다("").

조회 테이블 작성

기존 속성을 생성할 새 속성에 매핑하는 CSV를 업로드하여 조회 테이블 객체를 생성합니다. 요청을 multipart/form-data콘텐츠 유형과 함께 전송합니다.

매개 변수

요청

curl -L -X POST 'https://amplitude.com/api/2/lookup_table/:name' \
        -u API_KEY:SECRET_KEY \
        -F 'file=@"/path/to/file.csv"' \

응답

{
  "name": "skuToMetadata",
  "column_headers": ["Product Category", "Product Name"],
  "created_at": "2021-07-15T21:04:23.000593",
  "created_by": "rest",
  "last_modified_at": "2021-07-16T19:14:11.627477",
  "last_modified_by": "rest"
}

조회 테이블 검색

이름별로 룩업 테이블을 검색합니다.

매개 변수

요청

curl -L -X GET 'https://amplitude.com/api/2/lookup_table/:name' \
        -u API_KEY:SECRET_KEY

응답

{
  "name": "skuToMetadata",
  "column_headers": ["Product Category", "Product Name"],
  "created_at": "2021-07-15T21:04:23.000593",
  "created_by": "rest",
  "last_modified_at": "2021-07-16T19:14:11.627477",
  "last_modified_by": "rest"
}

룩업 테이블 업데이트

룩업 테이블의 열과 데이터를 업데이트합니다.

매개 변수

요청

curl -L -X PATCH 'https://amplitude.com/api/2/lookup_table/:name' \
        -u API_KEY:SECRET_KEY
        -F 'file=@"/path/to/file.csv"' \

응답

{
  "name": "skuToMetadata",
  "column_headers": ["Product Category", "Product Name"],
  "created_at": "2021-07-15T21:04:23.000593",
  "created_by": "rest",
  "last_modified_at": "2021-07-16T19:14:11.627477",
  "last_modified_by": "rest"
}

조회 테이블 삭제

룩업 테이블을 삭제합니다.

매개 변수

요청

curl -L -X DELETE 'https://amplitude.com/api/2/lookup_table/:name' \
        -u API_KEY:SECRET_KEY

응답

{
  "name": "skuToMetadata",
  "success": true
}

모든 룩업 테이블 나열

프로젝트의 모든 룩업 테이블을 나열합니다.

curl -L -X GET 'https://amplitude.com/api/2/lookup_table' \
        -u API_KEY:SECRET_KEY

응답

{
  "data": [
    {
      "name": "isbnToMetadata",
      "column_headers": ["Genres", "Authors"],
      "created_at": "2021-07-15T21:04:23.000593",
      "created_by": "rest",
      "last_modified_at": "2021-07-16T19:14:11.627477",
      "last_modified_by": "rest"
    },
    {
      "name": "skuToMetadata",
      "column_headers": ["Product Category", "Product Name"],
      "created_at": "2021-07-16T19:28:18.070073",
      "created_by": "rest",
      "last_modified_at": "2021-07-16T19:28:18.070073",
      "last_modified_by": "rest"
    }
  ]
}