Blogger API로 HTML 게시글을 자동 발행할 때 꼭 알아야 할 구조
- 공유 링크 만들기
- X
- 이메일
- 기타 앱
Blogger API로 제목, HTML 본문, 메타데이터를 넣어 자동 발행하는 기본 구조와 주의점을 정리한다. 운영 단계에서 판단의 출발점은 ‘제목과 본문’입니다. Blogger Posts 리소스의 content에는 전체 HTML 문서가 아니라 게시글 본문 조각을 넣습니다. 제목은 별도 필드로 관리해야 수정과 검수가 쉽습니다.
이 글의 범위
실제 경험이나 측정 결과를 가정하지 않고, 공식 문서로 확인 가능한 개념과 적용 순서를 일반 가이드로 설명합니다. 제품 버전과 서비스 정책은 바뀔 수 있으므로 적용 전 연결된 공식 문서를 다시 확인하세요.
| Blogger API로 HTML 게시글을 자동 발행할 때 꼭 알아야 할 구조 핵심 판단 흐름 설명용 개념도 |
그림 1. Blogger API로 HTML 게시글을 자동 발행할 때 꼭 알아야 할 구조의 핵심 판단 순서를 정리한 설명용 개념도입니다. 실제 서비스 화면, 운영 로그 또는 측정 결과가 아닙니다.
자동화 전에 분리할 데이터
제목과 본문
Blogger Posts 리소스의 content에는 전체 HTML 문서가 아니라 게시글 본문 조각을 넣습니다. 제목은 별도 필드로 관리해야 수정과 검수가 쉽습니다.
라벨
라벨은 글의 실제 주제 분류에만 사용합니다. 키워드를 많이 넣는 용도가 아니므로 사이트 전체에서 쓰는 소수의 표준 라벨 목록을 먼저 정합니다.
초안 상태
API의 isDraft 옵션을 이용해 처음에는 초안으로 저장하고 브라우저에서 모바일 표시, 링크, 코드 블록을 확인한 뒤 사람이 발행하는 흐름이 안전합니다.
인증
글 추가는 OAuth 권한이 필요한 쓰기 작업입니다. 액세스 토큰을 소스 코드나 저장소에 넣지 말고 환경 변수와 안전한 토큰 저장소를 사용합니다.
재실행 안전성
네트워크 오류 뒤 같은 요청을 다시 보내면 중복 글이 생길 수 있습니다. 자체 문서 ID와 Blogger post ID를 함께 저장해 insert와 update를 구분합니다.
도구보다 먼저 볼 기준
Blogger API의 장점은 대량 공개가 아니라 반복 입력을 줄이고 검수 가능한 흐름을 만드는 데 있습니다. ‘제목과 본문’에서 시작해 ‘라벨’와의 경계를 정하면 구현할 범위와 실패했을 때 확인할 지점을 구분하기 쉬워집니다.
권장 발행 흐름
- 원고를 제목, HTML 본문, 라벨, 검색 설명, 내부 관리 ID로 분리해 저장합니다.
- 허용할 HTML 태그와 외부 링크 정책을 검사하고 빈 제목이나 짧은 본문을 차단합니다.
- posts.insert를 isDraft=true로 호출해 초안을 만듭니다.
- 반환된 post ID와 URL을 내부 관리 데이터에 기록합니다.
- Blogger 편집기에서 검색 설명과 퍼머링크를 포함해 최종 확인한 뒤 발행합니다.
요청 본문의 최소 구조
POST https://www.googleapis.com/blogger/v3/blogs/{blogId}/posts?isDraft=true
Authorization: Bearer {access_token}
Content-Type: application/json
{
"title": "게시글 제목",
"content": "<p>HTML 본문</p>",
"labels": ["Blogger", "자동화"]
}
변경 전 체크 포인트
| 확인 항목 | 질문 |
|---|---|
| 첫 기준: 제목과 본문 | 변경 전에 전제와 목적을 확인했는가? |
| 분리 대상: 라벨 | 다른 책임과 섞이지 않게 경계를 정했는가? |
| 피할 패턴: 검수 없이 여러 글을 즉시 공개 상태로 생성하기 | 본문에서 경고한 패턴이 남아 있지 않은가? |
| 오류와 복구 | 정상 경로뿐 아니라 실패와 되돌리기도 확인했는가? |
자동 발행에서 피할 것
- 검수 없이 여러 글을 즉시 공개 상태로 생성하기
- 검색 설명까지 content 안의 보이지 않는 문장으로 억지로 넣기
- 실패 응답과 재시도 결과를 기록하지 않기
- 서로 다른 글에 같은 제목·설명·라벨 묶음을 반복하기
결론
Blogger API의 장점은 대량 공개가 아니라 반복 입력을 줄이고 검수 가능한 흐름을 만드는 데 있습니다. 초안 생성, 사람 검수, ID 기록을 기본값으로 두면 자동화 속도와 콘텐츠 품질을 함께 관리할 수 있습니다.
참고한 공식 문서
- 공유 링크 만들기
- X
- 이메일
- 기타 앱
댓글
댓글 쓰기