Styxis
Company
Knowledge

Shopify Metaobject values 수정: 생략한 필드를 유지하는 패치와의 차이

values의 편리한 직렬화 뒤에는 생략 필드를 지우는 수정 의미가 있다. 유지 의도를 별도 계약으로 남긴다.

화면에서 건드리지 않았어도 지워질 수 있다

values에서 생략한 필드는 유지되는 패치가 아니라 지워지는 값이다. 부분 수정 의도를 가진 호출은 전송 방식부터 구별해야 한다. 운영자가 설명 문구 하나만 고쳤다고 생각해도 요청 생성기가 나머지 필드를 생략했다면 기존 안내 정보가 사라질 수 있다. 이때 필요한 기준은 필드 개수가 아니라 어떤 값을 유지하기로 했는지다. [1, 2, 3]

간소화된 API의 서로 다른 수정 동작

Shopify의 2026년 6월 11일 공지는 2026-07 Metaobject API에 JSON 호환 객체를 읽고 쓸 수 있는 values를 소개한다. API가 직렬화를 처리하지만 values에서 생략한 정의된 필드는 지워진다고 설명한다. 기존 field·fields는 추가 타입 정보가 필요하거나 지정하지 않은 필드를 그대로 두는 패치 동작이 필요할 때 계속 사용할 수 있다. [1]

유지 대상도 인계 가능한 데이터로 만든다

콘텐츠 운영 담당자는 수정할 필드와 유지할 필드를 나누어 인계하고, 부분 변경에는 패치 방식 사용 여부를 확인한 뒤 수정 전후의 유지 필드를 대조한다. 어떤 선택 필드를 일부러 삭제한 작업은 유지 검사에서 제외하도록 승인 기록에 남긴다. 변경 후 값만 받으면 삭제가 의도인지 누락인지 복원할 수 없으므로 변경 전 원문도 확보한다. [1, 3]

한 필드만 수정하려던 예시

설명용으로 안내 색상 blue는 유지하고 다른 필드만 고친다고 정한다. 기대 유지 값은 blue다. 수정 후 blue이면 의도를 보존했다. cleared이면 부분 수정에 전체 교체 방식을 사용했는지 확인한다. cleared는 실제 API 문자열이 아니라 삭제 상태를 읽기 쉽게 나타낸 시험 표기다. 원본을 확인하지 않고 기본색을 다시 넣으면 의도와 다른 두 번째 수정을 만들 수 있다. [1, 3]

Truthound는 유지 의도와 결과의 간극을 표시한다

Truthound Core 3.3.2의 ColumnPairValidator는 준비한 변경 전 기준과 수정 후 값을 비교할 수 있다. null 쌍은 건너뛰므로 삭제 상태를 별도 존재 여부로 보존하고 필수값·상태 검사를 함께 해야 한다. 제품이 metaobject를 수정하거나 지운 값을 복구하지는 않는다. 부분 변경에는 패치 동작을 검토하고 values를 쓰려면 유지할 필드도 전송한다. 애초에 전체 교체와 삭제가 의도였다면 전후 동일성을 강제하는 규칙은 적용하지 않는다. [1, 2, 3]

적용 조건

2026-07 이상에서 values와 field·fields의 수정 의미를 구분하고, 유지 대상 필드의 변경 전 값을 원문과 함께 확보한다. 의도적 삭제는 별도 승인 항목으로 제외한다.

대안

일부 필드만 바꾸려면 field·fields의 패치 동작을 사용하고, values를 쓰려면 유지할 전체 필드도 전송 대상으로 구성한다.

한계

  • Truthound는 metaobject를 수정하거나 삭제된 값을 복원하지 않는다. 생략 자체가 제품 오류라는 뜻은 아니며 선택한 수정 방식과 사용자의 의도가 충돌한 경우를 찾는다.

근거

사건 확인일
대상 확인일
수정일