게시글 속 Google 문서가 안 열릴 때, 어디부터 확인하면 될까요?

게시글 속 문서가 안 열릴 때. 게시글 창 속 삽입 영역이 막혀 있고, 삽입 주소·접근 권한·차단 위치 순서로 확인하는 그림.

고객에게 보여줄 안내문을 게시글에 넣었는데 ‘docs.google.com에서 연결을 거부했습니다’라는 문구만 보여요. 같은 문서를 새 창으로 열면 잘 나오는데 게시글 안에서는 안 되는 상황이죠.

문서를 직접 여는 것과 다른 사이트 안에 넣어 보여주는 것은 허용 조건이 달라요. 삽입할 주소가 맞는지, 방문자가 읽을 권한이 있는지, 어디에서 표시를 막는지를 나눠보면 확인할 지점을 찾기 쉬워요. 오류 문구 하나만 보고 파일이 깨졌다고 판단하거나 사이트 설정부터 바꿀 필요는 없어요.

Google 문서와 사이트 첨부파일은 확인할 곳이 달라요

Google 문서에서 작성한 안내문을 넣었나요? 아니면 게시판에 올린 파일을 외부 미리보기 서비스로 보여주고 있나요?

Google 문서라면 문서에서 제공하는 게시·삽입 기능을 확인해요. 사이트 첨부파일의 주소를 gview 같은 외부 뷰어에 연결했다면 그 뷰어가 원본 파일을 가져올 수 있는지, 파일 형식과 용량을 지원하는지 확인해야 해요. Google 문서에서 삽입 코드를 만드는 방법이 모든 첨부파일 문제를 해결해주는 것은 아니에요.

어느 방식인지 잘 모르겠다면 문서를 넣었던 화면과 사용한 주소를 개발 담당자에게 보여주세요. 주소에 접근용 비밀값이 있다면 공개 질문에 그대로 올리지 말고 필요한 범위로 안전하게 전달해주세요.

공개할 문서라면 삽입용 코드를 확인해보세요

문서를 편집할 때 보이는 주소나 Google 문서 첫 화면 주소를 그대로 넣었다면 삽입용 주소인지부터 살펴보세요. iframe은 게시글 안에 다른 문서나 화면을 넣어 보여줄 때 쓰는 틀이에요. 그 틀에 넣는 주소도 해당 용도로 제공된 것이어야 해요.

공개해도 되는 Google 문서는 파일 → 공유 → 웹에 게시 → 삽입에서 제공하는 코드를 확인할 수 있어요. 사이트에는 관리자가 허용한 삽입 기능으로 적용해주세요. 직장·학교 계정에서는 관리자가 웹 게시를 제한했을 수도 있어요.

웹 게시를 켜는 일은 단순히 오류를 없애는 설정이 아니에요. 문서를 누가 볼 수 있게 할지 바꾸는 일이에요. 고객 정보나 내부 자료를 미리보기 때문에 공개하지 마세요. 일반 공개 자료는 로그인하지 않은 창에서, 대상이 제한된 자료는 실제로 읽을 사람의 계정에서 확인해야 해요.

내가 열 수 있는 파일을 외부 뷰어도 열 수 있을까요?

회원에게만 제공하는 제안서를 사이트에 올리고 외부 뷰어로 보여주는 가상 상황을 생각해볼게요. 나는 로그인해 있어서 파일을 열 수 있어도 뷰어는 같은 회원 권한을 갖고 있지 않을 수 있어요.

이 경우에는 개발 담당자에게 다음 내용을 확인해달라고 요청해보세요.

  • 원본 주소에서 실제 파일이 내려오는지, 로그인 화면이나 오류 페이지가 나오는지
  • 주소의 유효기간이 지났거나 외부에서 가져오는 것을 막고 있는지
  • 파일 형식과 용량이 사용하는 뷰어의 지원 범위에 맞는지

로그인하지 않은 창에서 파일이 열리는지는 첫 확인에 도움이 돼요. 다만 그것만으로 외부 뷰어도 파일을 가져와 표시할 수 있다고 보장할 수는 없어요.

회원 전용 자료라면 미리보기를 띄우려고 접근 제한을 풀기보다 기존 권한을 지키는 다운로드나 다른 미리보기 방식을 살펴보세요.

보안 설정을 바꾸기 전에 막힌 위치를 찾아요

문서가 안 보이는 이유는 게시글을 저장하는 단계에도, 우리 사이트에도, 표시할 문서 쪽에도 있을 수 있어요.

확인할 곳 담당자가 살펴볼 내용
게시판·에디터 저장할 때 삽입 코드나 주소가 지워졌나요?
우리 사이트 외부 화면을 불러오는 것을 정책에서 막았나요?
표시할 문서 다른 사이트 안에 들어가는 것을 제한하나요?

기술 담당자는 저장 후 삽입 코드가 남아 있는지부터 볼 수 있어요. 코드가 남아 있다면 브라우저의 오류 기록, 실제로 요청한 마지막 주소와 서버가 보낸 응답 정보를 확인해요.

이때 설정 이름이 비슷해도 방향은 달라요. 우리 사이트의 frame-src는 어떤 외부 화면을 불러올 수 있는지 정해요. 외부 문서의 frame-ancestors나 X-Frame-Options는 그 문서가 다른 사이트 안에 들어갈 수 있는지를 제한해요. 우리 사이트에 X-Frame-Options: SAMEORIGIN을 추가해도 Google 문서의 삽입 제한이 풀리지는 않아요.

운영자가 설정을 전부 이해하고 직접 고칠 필요는 없어요. 어느 쪽에서 막혔는지 확인한 뒤 필요한 부분만 조정해달라고 요청하세요. 삽입 필터나 보안 설정을 통째로 없애는 방식으로 처리하지 않는 게 좋아요.

마지막에는 실제로 읽을 사람 입장에서 봐주세요

수정한 뒤에는 의도한 방문자가 PC와 휴대전화에서 자료를 읽을 수 있는지 확인해보세요. 제한한 자료는 권한 없는 사람에게 계속 차단되는지도 함께 보고요. 미리보기가 실패하더라도 원문 보기나 다운로드처럼 이용할 수 있는 경로가 준비돼 있는지 확인하면 좋아요.

문제가 남았다면 해당 페이지, 자료 종류와 삽입 방식, 발생 시각, 새 창과 게시글 안에서 각각 확인한 결과를 담당자에게 전달해주세요. “내 화면에서는 보여요”보다 자료를 읽어야 할 사람이 실제로 읽을 수 있는지가 마무리 기준이에요.

공유하기

사이트 운영 분류의 다른 글

더 보기