Blogger API: 파이썬으로 새 블로그 포스트 자동 작성하기 완벽 가이드

작성일: 2024년 11월 15일 | 최종 수정: 2025년 7월 26일

개인 블로그를 운영하거나 대량의 콘텐츠를 효율적으로 관리해야 할 때, 수동으로 모든 포스트를 작성하고 발행하는 것은 시간과 노력이 많이 드는 작업입니다. 이때 **Blogger API**를 활용하면 이 모든 과정을 **프로그래매틱하게 자동화**할 수 있습니다.

이 가이드에서는 **Python**을 사용하여 Blogger API를 통해 새로운 블로그 포스트를 생성하고 발행하는 방법을 자세히 알아보겠습니다. 이 기능을 숙지하면 콘텐츠 게시를 자동화하거나, 특정 조건에 따라 포스트를 예약 발행하는 등 블로그 운영의 효율성을 극대화할 수 있습니다.

---

1. 시작하기 전에: 필수 준비물

Blogger API를 사용하려면 몇 가지 사전 준비가 필요합니다. 이미 Google API를 사용해 보셨다면 익숙하실 내용이지만, 처음이라면 다음 단계를 꼭 확인해주세요.

Google Cloud 프로젝트 설정: Google Cloud Console에서 새 프로젝트를 생성하거나 기존 프로젝트를 사용해야 합니다.
Blogger API 활성화: 해당 프로젝트에서 'Blogger API v3'를 활성화해야 합니다.
OAuth 2.0 클라이언트 ID 생성: 사용자 대신 블로그에 접근할 수 있도록 OAuth 2.0 클라이언트 ID (데스크톱 앱 또는 웹 애플리케이션)를 생성하고 credentials.json 파일을 다운로드합니다.
인증 정보 획득 (token.json): Google API 클라이언트 라이브러리를 사용하여 사용자의 승인을 얻어 token.json 파일을 생성해야 합니다. 이 파일에는 API 접근에 필요한 액세스 토큰과 리프레시 토큰이 포함됩니다. (일반적으로 최초 1회 인증 과정을 거쳐 생성됩니다.)
Python 라이브러리 설치: google-api-python-client 및 google-auth-oauthlib 라이브러리가 필요합니다.
```
pip install google-api-python-client google-auth-oauthlib
                
```
블로그 ID 확인: 새 포스트를 작성할 블로그의 ID를 알아야 합니다. 블로그 주소(예: https://yourblogname.blogspot.com)에서 yourblogname.blogspot.com 부분을 확인하여 Blogger 대시보드 또는 API를 통해 블로그 ID를 얻을 수 있습니다.

---

2. 파이썬 코드 예제: 새 포스트 작성

아래 파이썬 코드는 Blogger API를 사용하여 새 블로그 포스트를 작성하는 가장 기본적인 예제입니다. 주석을 통해 각 코드 라인의 역할과 기능을 설명하고 있습니다.


from googleapiclient.discovery import build
from google.oauth2.credentials import Credentials
import os

# 1. 인증 정보 로드
# 이 'token.json' 파일은 최초 1회 인증 과정을 통해 생성됩니다.
# 예시: google-auth-oauthlib.flow.InstalledAppFlow 사용
try:
    credentials = Credentials.from_authorized_user_file('token.json', ['https://www.googleapis.com/auth/blogger'])
except FileNotFoundError:
    print("token.json 파일을 찾을 수 없습니다. 먼저 인증 과정을 완료해주세요.")
    # 실제 환경에서는 인증 흐름을 시작하는 코드를 여기에 추가해야 합니다.
    # 예:
    # from google_auth_oauthlib.flow import InstalledAppFlow
    # FLOW = InstalledAppFlow.from_client_secrets_file(
    #     'credentials.json', ['https://www.googleapis.com/auth/blogger'])
    # credentials = FLOW.run_local_server(port=0)
    # with open('token.json', 'w') as token:
    #     token.write(credentials.to_json())
    exit() # token.json이 없으면 종료

# 2. Blogger API 서비스 객체 생성
# 'v3'는 Blogger API의 버전을 의미합니다.
service = build('blogger', 'v3', credentials=credentials)

# 3. 블로그 ID 설정
# 'your-blog-id' 부분을 실제 블로그 ID로 교체해야 합니다.
# 블로그 ID는 Blogger 대시보드 URL에서 확인할 수 있습니다 (예: blogger.com/blog/posts/YOUR_BLOG_ID)
blog_id = 'your-blog-id' # <-- 이곳을 실제 블로그 ID로 변경하세요!

# 4. 새 포스트 내용 정의
# 'title'과 'content'는 필수 필드입니다.
# 'labels'는 선택 사항으로, 블로그 포스트에 태그를 추가하는 데 사용됩니다.
new_post = {
    'title': '파이썬으로 작성된 자동 포스트',
    'content': '<p>이것은 <strong>Blogger API</strong>를 사용하여 파이썬 스크립트로 작성된 <em>새로운 블로그 포스트</em>입니다.</p><p>HTML 태그를 사용하여 내용을 자유롭게 포맷팅할 수 있습니다.</p>',
    'labels': ['API', 'Blogger', 'Python', '자동화']
}

try:
    # 5. 포스트 작성 요청 및 실행
    # blogId: 포스트를 게시할 블로그의 ID
    # body: 생성할 포스트의 내용을 담은 딕셔너리
    post = service.posts().insert(blogId=blog_id, body=new_post).execute()

    # 6. 결과 출력
    print(f"새 포스트가 성공적으로 작성되었습니다!")
    print(f"포스트 제목: {post['title']}")
    print(f"포스트 ID: {post['id']}")
    print(f"포스트 URL: {post['url']}")
    print(f"게시 상태: {post['status']}")

except Exception as e:
    # 7. 오류 처리
    print(f"오류가 발생했습니다: {e}")
    if 'Daily Limit Exceeded' in str(e):
        print("API 일일 사용량 한도를 초과했을 수 있습니다. 잠시 후 다시 시도해주세요.")
    elif 'Invalid Credentials' in str(e):
        print("인증 정보가 유효하지 않습니다. token.json 파일을 확인하거나 재인증이 필요합니다.")
    elif 'Not Found' in str(e) and 'blogId' in str(e):
        print("블로그 ID가 올바르지 않거나 해당 블로그에 접근 권한이 없습니다. ID를 확인해주세요.")

---

3. 코드 심층 분석

제공된 파이썬 코드의 각 부분과 그 의미를 더 자세히 살펴보겠습니다.

Credentials.from_authorized_user_file('token.json', ['https://www.googleapis.com/auth/blogger'])

이 라인은 이전에 OAuth 2.0 인증 과정을 통해 얻은 사용자 인증 정보(액세스 토큰 및 리프레시 토큰)를 token.json 파일에서 로드합니다. 이때 ['https://www.googleapis.com/auth/blogger']는 해당 애플리케이션이 Blogger API에 접근할 때 필요한 권한(스코프)을 명시합니다. 이 스코프를 통해 포스트를 생성, 수정, 삭제하는 등의 작업이 가능해집니다.
service = build('blogger', 'v3', credentials=credentials)

Google API 클라이언트 라이브러리의 build 함수를 사용하여 Blogger API 서비스 객체를 생성합니다. 이 객체를 통해 Blogger API의 다양한 기능(포스트, 댓글, 페이지 등)에 접근할 수 있습니다. 'blogger'는 서비스 이름, 'v3'는 API 버전을 나타냅니다.
new_post = {...}

이 딕셔너리는 생성할 새 포스트의 내용을 정의합니다.
- 'title': 블로그 포스트의 제목입니다.
- 'content': 블로그 포스트의 본문 내용입니다. **HTML 태그를 사용하여 내용을 자유롭게 포맷팅**할 수 있습니다. 예를 들어 <p>, <strong>, <em>, <a href="..."> 등의 태그를 사용할 수 있습니다.
- 'labels': (선택 사항) 포스트에 적용할 태그(레이블) 목록입니다. 블로그에서 카테고리처럼 사용됩니다.
service.posts().insert(blogId=blog_id, body=new_post).execute()

이것이 실제로 새 포스트를 생성하는 핵심 API 호출입니다.
- service.posts(): Blogger API의 포스트 관련 메서드에 접근합니다.
- .insert(): 새 포스트를 삽입하는 API 요청을 준비합니다. 이때 두 가지 주요 매개변수가 필요합니다.
  - blogId: 포스트를 게시할 대상 블로그의 고유 ID입니다.
  - body: 위에서 정의한 new_post 딕셔너리로, 생성할 포스트의 제목, 내용, 라벨 등을 포함합니다.
- .execute(): 준비된 API 요청을 Google 서버로 보내고, 그 결과를 받아서 파이썬 객체로 반환합니다. 성공적으로 포스트가 생성되면, 생성된 포스트의 ID, URL, 상태 등 상세 정보가 담긴 딕셔너리가 반환됩니다.

---

4. Blogger API 활용을 위한 추가 팁

Blogger API는 새 포스트 작성 외에도 다양한 기능을 제공하며, 포스트 작성 시에도 여러 옵션을 활용할 수 있습니다. 아래 팁들을 활용하여 블로그 관리를 더욱 효율적으로 자동화해보세요.

HTML 태그를 사용한 고급 포맷팅:

content 필드에 일반 텍스트뿐만 아니라 <h1>, <p>, <ul>, <ol>, <a>, <img> 등의 **HTML 태그를 직접 삽입**하여 블로그 포스트의 시각적 요소를 풍부하게 만들 수 있습니다. 예를 들어, 이미지를 삽입하려면 <img src="이미지_URL" alt="대체 텍스트">와 같이 HTML을 작성하여 content에 넣어주면 됩니다.
초안(Draft)으로 저장하기:

포스트를 즉시 발행하지 않고 초안으로 저장하고 싶다면, insert() 메서드 호출 시 isDraft=True 매개변수를 추가하면 됩니다.
```
post = service.posts().insert(blogId=blog_id, body=new_post, isDraft=True).execute()
                
```
나중에 API를 통해 또는 Blogger 대시보드에서 해당 초안을 게시할 수 있습니다.

포스트 예약 발행 (Scheduled Publishing):

특정 날짜와 시간에 포스트를 자동으로 게시하고 싶다면, new_post 딕셔너리에 publishDate 필드를 추가할 수 있습니다. 날짜 형식은 RFC3339 형식을 따릅니다 (예: "2025-12-31T10:00:00Z").


import datetime

# 현재 시간 + 1시간으로 예약
future_time = (datetime.datetime.now(datetime.timezone.utc) + datetime.timedelta(hours=1)).isoformat() + "Z"

new_post = {
    'title': '예약된 블로그 포스트',
    'content': '이 포스트는 1시간 뒤에 자동으로 발행됩니다.',
    'labels': ['예약', '자동화'],
    'publishDate': future_time # <-- 예약 발행 시간 설정
}
post = service.posts().insert(blogId=blog_id, body=new_post).execute()

오류 처리 및 로깅:

실제 프로덕션 환경에서는 API 호출 시 발생할 수 있는 다양한 오류(네트워크 문제, 인증 오류, 할당량 초과 등)에 대한 견고한 오류 처리 로직을 구현하는 것이 중요합니다. 또한, 포스트 작성 성공/실패 여부와 상세 정보를 로그 파일로 기록하는 것을 권장합니다.
기존 포스트 수정 및 삭제:

Blogger API는 posts().update() 및 posts().delete() 메서드도 제공하여 기존 포스트를 수정하거나 삭제할 수 있는 기능을 제공합니다. 이를 통해 블로그 콘텐츠의 라이프사이클을 완벽하게 자동화할 수 있습니다.

---

5. 결론: 블로그 콘텐츠 관리의 새로운 지평

지금까지 **Blogger API와 Python을 활용하여 새로운 블로그 포스트를 자동 작성하는 방법**에 대해 상세히 알아보았습니다. 이 강력한 기능을 통해 수동으로 진행했던 블로그 운영의 많은 부분을 자동화하고, 콘텐츠 생산 및 관리의 효율성을 획기적으로 높일 수 있습니다.

주기적인 뉴스 업데이트, 데이터 기반의 자동 보고서 발행, 혹은 다양한 소셜 미디어 플랫폼과의 연동 등 무궁무진한 활용 가능성이 열려 있습니다. 이 가이드를 통해 얻은 지식을 바탕으로 여러분의 블로그 콘텐츠 관리 워크플로우를 한 단계 업그레이드해보세요!

Blogger API: 새 블로그 포스트 작성하기

Blogger API: 파이썬으로 새 블로그 포스트 자동 작성하기 완벽 가이드

1. 시작하기 전에: 필수 준비물

2. 파이썬 코드 예제: 새 포스트 작성

3. 코드 심층 분석

`Credentials.from_authorized_user_file('token.json', ['https://www.googleapis.com/auth/blogger'])`

`service = build('blogger', 'v3', credentials=credentials)`

`new_post = {...}`

`service.posts().insert(blogId=blog_id, body=new_post).execute()`

4. Blogger API 활용을 위한 추가 팁

HTML 태그를 사용한 고급 포맷팅:

초안(Draft)으로 저장하기:

포스트 예약 발행 (Scheduled Publishing):

오류 처리 및 로깅:

기존 포스트 수정 및 삭제:

5. 결론: 블로그 콘텐츠 관리의 새로운 지평

POST ADS1

POST ADS 2