파일에서 컬렉션 가져오기
다른 사람이 만든 컬렉션이나 AI가 작성한 JSON 파일을 기기에 추가할 수 있습니다.
가져오는 순서
- 컬렉션 JSON 파일을 기기에 저장합니다.
- Graph Card의 내 컬렉션을 엽니다.
- 가져오기 → 파일을 누르고 저장한 파일을 선택합니다.
- 저장 완료 안내가 나타나면 목록에서 컬렉션을 엽니다.
Google Drive 파일 링크에서 가져오기
Google Drive에서 컬렉션 JSON 파일의 공유 범위를 링크가 있는 모든 사용자로 바꾸고 다운로드를 허용하세요. 앱에서 내 컬렉션 → 가져오기 → 링크를 열어 파일 링크를 붙여 넣습니다.
이미지가 있는 컬렉션은 앱에서 내보낸 이미지 포함 JSON 파일을 Drive에 올려 주세요. 같은 Drive 파일의 내용을 교체한 뒤 링크를 다시 가져오면 아래와 같은 갱신 규칙이 적용됩니다. 브라우저나 Drive의 다운로드 제한으로 링크를 읽을 수 없는 경우에는 Drive에서 JSON을 내려받아 파일로 가져올 수 있습니다.
어떤 파일을 지원하나요?
- 컬렉션 JSON: protocolVersion이 2인 컬렉션입니다. 이미지 없는 예제를 만들 때 가장 간단합니다.
- 이미지를 포함한 내보내기 JSON: 앱에서 내보낸
graph-card/v1패키지입니다.collection과images가 함께 들어 있습니다.
{
"format": "graph-card/v1",
"collection": { "protocolVersion": 2, "...": "전체 컬렉션" },
"images": {}
}
위 코드는 구조 설명용이며 그대로 가져오는 파일은 아닙니다. graph-card/v1은 포장 형식이고 내부 컬렉션의 프로토콜 버전은 2입니다.
이미지가 있다면
로컬 파일에 이미지 경로만 적어두면 다른 파일을 자동으로 찾아 읽지 못합니다. 이미지가 든 컬렉션은 앱에서 내보낸 이미지 포함 JSON을 쓰거나, JSON과 이미지가 함께 있는 공개 GitHub 주소를 이용하세요.
가져오지 못했을 때
파일 선택은 JSON을 대상으로 하며 파일 크기는 최대 64 MiB입니다. JSON 문법, 프로토콜 버전, 카드 ID와 관계 대상이 맞는지 확인하세요. 이 크기는 MCP 서버의 요청·저장 한도와 다릅니다.
같은 ID로 파일을 다시 가져오면 원본의 카드 추가·수정·삭제를 반영합니다. 원본과 기기에서 같은 부분을 다르게 수정했거나 비교할 이전 원본을 확인할 수 없으면 내 컬렉션 → … → 원본 변경 검토에서 차이를 확인한 뒤 적용할 수 있습니다. 별개 컬렉션으로 추가하려면 새 collectionId를 사용하세요.