구조화 데이터 예시 코드를 쓸 때의 주의점

예시 코드의 사용 전 판단 기준

구글 검색 센터의 일반 가이드라인에는 설명을 간략하게 하려고 일부 속성만 담은 예시가 있으며, 전체 내용은 해당 유형의 문서를 참고하도록 안내합니다. 따라서 공식 문서에서 가져왔다는 설명만으로 병원에 적용할 준비가 끝났다고 판단할 수 없습니다. 실장은 예시 주변의 설명까지 받아 생략 안내가 있는지 읽고, 업체에 생략된 내용 중 이번 작업에서 처리할 항목을 설명하도록 요청합니다.

표는 병원 담당자가 업체에 설명을 요청할 범위를 정하는 용도로 사용합니다. 각 칸을 채우기 위해 홈페이지에 없는 사실을 새로 만들 필요는 없습니다. 근거를 찾지 못한 값은 미확정으로 표시하고, 업체가 임의로 채우지 않도록 요청합니다.

간략한 설명과 기능 조건의 차이

예시가 설명하는 기술적 관계와 검색 기능이 요구하는 조건은 별도로 읽어야 합니다. 구글은 검색 동작을 판단할 때 일반적인 용어 정의 문서보다 구글 검색 센터 문서를 최종 참고 기준으로 삼도록 설명합니다. 업체가 용어의 의미만 설명했다면, 병원 담당자는 이번 작업에서 목표로 삼은 검색 기능의 문서도 요청합니다.

예시 안에 항목이 있다고 해서 병원에도 그 내용을 추가해야 하는 것은 아닙니다. 구글은 부정확하거나 불완전한 권장 속성을 많이 제공하는 것보다 정확하고 완전한 내용을 제공하는 편이 중요하다고 설명합니다. 병원은 코드의 길이나 항목 수로 완성도를 판단하지 않고, 각 값의 근거와 남겨야 하는 이유를 업체에 설명받습니다.

업체의 설명에는 예시가 보여주려는 내용과 실제 적용을 위해 추가로 판단한 내용을 나누어 기재하도록 요청합니다. 이렇게 하면 병원은 원래 예시에 있었던 내용과 업체가 새로 제안한 내용을 서로 다르게 승인할 수 있습니다. 출처 설명이 빠진 항목은 공식 예시에 포함된 것으로 추정하지 않습니다.

자료 준비와 대조 순서

담당자는 코드만 받기보다 출처 설명, 변경 내역, 대응하는 페이지 내용을 함께 받아야 합니다. 병원에서는 현재 공개한 본문과 원장이 승인한 진료 설명을 준비하고, 업체에서는 예시를 가져온 문서와 수정 이유를 준비합니다. 자료의 표현이 서로 다르면 적용 승인을 요청하기 전에 차이를 목록으로 정리합니다.

1. 예시 출처와 생략 안내를 읽습니다. 업체에 원래 예시가 설명하는 목적과 일부 항목을 생략했는지 설명하도록 요청합니다.
2. 예시 값과 병원 페이지 정보를 대조합니다. 각 값 옆에 대응하는 본문을 기재하고, 변경할 값과 삭제 여부를 판단할 값을 표시합니다.
3. 해당 검색 기능의 공식 문서와 대조합니다. 업체가 앞에서 정한 기준에 따라 추가한 내용과 아직 해결하지 못한 조건을 설명하도록 요청합니다.

병원이 직접 코드 문법을 작성할 필요는 없습니다. 실장은 업체의 설명에서 어떤 값이 어떤 공개 정보에 근거하는지 읽을 수 있는지를 판단합니다. 기술 용어만 나열한 답변에는 실제 페이지의 대응 문장과 수정 이유를 추가하도록 요청합니다.

업체 설명에 포함할 변경 이유

변경 내역에는 수정 전후의 값뿐 아니라 수정한 이유도 포함해야 합니다. 병원명처럼 교체 근거가 분명한 값과, 의미를 이해한 뒤 판단해야 하는 연결 항목을 같은 방식으로 일괄 처리하지 않도록 요청합니다. 삭제한 내용에도 페이지에 대응 정보가 없었는지, 다른 표현으로 변경했는지 이유를 기재하도록 합니다.

업체가 병원에 판단을 요청하는 항목은 질문 형태로 받아야 합니다. 어느 설명이 현재 페이지와 다른지, 어떤 자료가 부족한지 명시하면 실장이 필요한 부서에 자료를 요청할 수 있습니다. 병원 자료가 도착하기 전에는 임시 문구를 승인된 사실처럼 취급하지 않도록 작업 요청서에 기재합니다.

최종 설명에서는 원래 예시와 달라진 부분을 찾을 수 있어야 합니다. 변경 내역 없이 완성 코드만 전달받았다면, 담당자는 승인 전에 수정 목록을 추가로 요청합니다. 병원은 그 목록에 답변한 내용과 미확정 내용을 표시해 업체에 회신합니다.

예시 진료 설명의 잘못된 재사용

예시 안의 진료 설명은 병원명만 변경해서 사용할 수 있는 문구로 취급하면 안 됩니다. 원장은 예시의 문장이 실제로 공개한 본문과 같은 뜻인지 판단하고, 적응 대상이나 주의 조건이 달라지는 표현을 가려냅니다. 홈페이지에 없는 설명을 코드에만 추가하려는 요청은 본문 내용에 대한 별도 승인 없이 진행하지 않습니다.

구글은 마크업이 페이지 내용을 실제로 표현해야 하며, 페이지의 주제와 관계없거나 오해를 유발하는 내용을 담지 않도록 안내합니다. 진료 설명을 줄일 때도 대상과 조건을 생략해 원래 뜻이 달라지지 않도록 해야 합니다. 원장이 승인한 문장이라도 현재 페이지에 게시된 설명과 차이가 있으면 담당자가 그 차이를 업체에 전달합니다.

원장의 진료 설명 승인과 구글 기능 조건에 대한 판단은 서로 다른 업무입니다. 의학적으로 타당한 문장이라는 이유만으로 코드의 구성까지 승인됐다고 처리하지 않습니다. 업체에는 승인된 설명을 어떤 항목에 반영했는지 별도로 설명하도록 요청합니다.

이름 교체 뒤 남는 연결 정보

눈에 읽히는 이름을 변경했더라도 항목 사이의 연결 정보에는 예시의 관계가 남을 수 있습니다. 구글은 한 페이지의 여러 항목을 중첩하거나 각각 표현할 수 있으며, 관련 항목에 @id를 사용해 관계를 명시할 수 있다고 설명합니다. 업체에는 각 연결이 무엇을 가리키며 병원 페이지에서도 그 관계가 성립하는지 설명하도록 요청합니다.

병원 담당자는 연결 값의 표기 방식보다 연결된 대상의 의미를 먼저 이해해야 합니다. 설명 문장과 영상이 연결되어 있다면, 실제 영상이 그 설명의 내용을 다루는지 담당자가 대조합니다. 관계를 설명할 수 없는 연결은 단순한 예시 흔적으로 판단하지 말고 업체에 유지 이유를 묻습니다.

이미지를 지정한 경우에도 파일 이름을 병원용으로 변경했다는 답변만으로 판단을 끝내지 않습니다. 구글은 지정한 이미지가 페이지 내용과 관련되어야 하고, 검색에서 사용할 수 있도록 크롤링과 색인 생성이 가능해야 한다고 안내합니다. 담당자는 이미지의 내용이 페이지와 연결되는지 판단하고, 기술적 접근 조건은 업체의 설명 자료로 받습니다.

주석과 실제 값의 혼동

업체가 설명용 메모를 포함한 자료를 전달하면, 병원은 메모와 실제 반영할 값을 따로 읽을 수 있어야 합니다. 설명 자료에 있는 ‘추후 변경’이나 ‘병원 정보 입력’ 같은 문구는 작업 상태를 나타낼 뿐, 병원이 승인한 내용이 아닙니다. 담당자는 미완료 표시가 남은 항목과 최종 승인 대상이 같은 자료에서 혼동되지 않도록 정리를 요청합니다.

예시의 화면 설명과 코드 안의 값이 다를 때도 어느 쪽이 최종안인지 추정하지 않습니다. 업체에 승인 대상 자료를 명시하도록 요청하고, 병원은 그 자료에 대한 답변만 회신합니다. 이후 수정안이 오면 이전 답변을 자동으로 적용하지 말고 달라진 항목에 대해서만 추가 판단을 전달합니다.

이어서 읽을 주제

구조화 데이터의 항목별 역할을 이어 읽으면 업체가 추가하거나 제외한 내용의 의미를 이해하는 데 도움이 됩니다. 병원 사이트 색인을 이어 읽으면 페이지에 게시한 정보와 검색엔진이 접근할 수 있는 상태를 별도로 판단하는 데 도움이 됩니다.