메서드와 플레이그라운드

그룹 정보 가져오기

Last updated July 6, 2026

요약

getGrouping DAS API 메서드는 모든 멤버를 나열하지 않고 그룹(키, 값) 쌍의 메타데이터를 반환합니다.

  • 조회한 그룹의 group_key, group_name, group_size를 반환합니다
  • Token Metadata 및 mpl-core 컬렉션에는 groupKey: "collection"을 사용합니다
  • 컬렉션, 자산, 중첩 그룹을 묶는 mpl-core GroupV1 계정에는 groupKey: "group"을 사용합니다
  • 개별 멤버를 나열하려면 getAssetsByGroup을 사용하세요

매개변수

이름필수설명
groupKey그룹 키(예: "collection" 또는 mpl-core 그룹의 "group").
groupValue그룹 값(컬렉션 또는 mpl-core 그룹 주소 등).

응답

응답에는 다음이 포함됩니다:

  • group_key - 조회한 그룹 키
  • group_name - 사용 가능한 경우 그룹 표시 이름
  • group_size - 그룹에 인덱싱된 멤버 수

Playground

Notes

  • getGrouping은 요약 메타데이터만 반환합니다 — 그룹 멤버를 페이지네이션하려면 getAssetsByGroup을 사용하세요
  • group_size는 지정한 groupKey/groupValue 쌍에 대해 DAS가 인덱싱한 멤버 수를 나타냅니다
  • mpl-core GroupV1 그룹의 경우 인덱서가 기록한 내용에 따라 컬렉션, 에셋, 중첩 그룹이 멤버로 포함될 수 있습니다