PyPI - sendgo-python - Versions diffs - 1.1.0__tar.gz → 1.2.1__tar.gz - Mend

sendgo-python 1.1.0tar.gz → 1.2.1tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (19) hide show

{sendgo_python-1.1.0 → sendgo_python-1.2.1}/PKG-INFO RENAMED Viewed

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: sendgo-python
-Version: 1.1.0
-Summary: Sendgo Python SDK — 카카오 알림톡/친구톡, SMS/LMS/MMS
+Version: 1.2.1
+Summary: Sendgo Python SDK — 카카오 알림톡/브랜드메시지, SMS/LMS/MMS
 Author-email: Sendgo <dev@sendgo.io>
 License: MIT
 Project-URL: Homepage, https://sendgo.io
@@ -27,7 +27,7 @@ Requires-Dist: httpx>=0.27; extra == "async"
 # sendgo-python
-> **Python / Django / FastAPI에서 카카오 알림톡, 친구톡, SMS를 가장 쉽게 발송하는 SDK**
+> **Python / Django / FastAPI에서 카카오 알림톡, 브랜드메시지, SMS를 가장 쉽게 발송하는 SDK**
 [![PyPI version](https://img.shields.io/pypi/v/sendgo-python?logo=pypi)](https://pypi.org/project/sendgo-python/)
 [![Python](https://img.shields.io/badge/Python-3.10%2B-3776AB?logo=python)](https://python.org)
@@ -184,6 +184,19 @@ client.alimtalk.send(
 ### 카카오 친구톡
+> ⚠️ **Deprecated — 친구톡은 카카오 정책에 따라 2025-12-31 종료되었습니다.**
+> 2026-01-01 부터 친구톡 발송 요청은 카카오 측에서 **브랜드메시지(자유형)** 로 자동 대체 발송됩니다.
+> 호출은 계속 성공하며, 자유 본문 타입(`FT`/`FI`/`FW`)을 개별 수신자에게 보내는 경로는
+> 현재 이것뿐이므로 기존 코드를 당장 바꿀 필요는 없습니다.
+>
+> 다음의 경우에는 **브랜드메시지**를 사용하세요.
+> - 템플릿 기반 리치 타입 (`FL`/`FC`/`FM`/`FP`/`FA`)
+> - 채널 친구가 **아닌** 수신자 (`targeting` = `N` / `I`)
+> - 수신 동의한 전체 채널 친구 동보 (`targeting` = `F`)
+>
+> 메시지 타입은 1:1 대응되며 변환은 서버가 처리합니다 — `FT`→`BT`, `FI`→`BI`, `FW`→`BW`,
+> `FL`→`BL`, `FC`→`BC`, `FM`→`BM`, `FP`→`BP`, `FA`→`BA`.
 ```python
 # 텍스트형
 client.friendtalk.send(
@@ -244,7 +257,7 @@ client.sms.send_mms(
 - 수신 동의한 **전체 채널 친구 동보** 발송 (`targeting: F`, 수신자 목록 불필요)
 - 리스트·캐러셀·커머스·동영상 등 **템플릿 기반 리치 메시지**
-> v2 전용입니다. `FT`/`FI`/`FW`를 채널 친구에게만 보낼 때는 친구톡 API가 더 간단합니다.
+> v2 전용입니다. 자유 본문 타입(`FT`/`FI`/`FW`)을 개별 수신자에게 보낼 때는 여전히 친구톡 API 를 쓰세요 — 이 엔드포인트는 그 조합에 `NOT_A_BRAND_MESSAGE` 를 반환합니다. 친구톡 요청은 카카오 측에서 브랜드메시지(자유형)로 대체 발송됩니다.
 ```python
 # 단건 발송 — 채널 친구 대상
@@ -455,6 +468,63 @@ A. Sendgo 플랜별로 TPS 제한이 있습니다. [요금 정책](https://sendg
 ---
+## 짧은 URL
+짧은 URL 은 메시지 본문의 링크를 줄이고, 그 링크가 실제로 눌렸는지 집계합니다.
+문자는 바이트 수가 요금과 직결되므로 링크를 줄이면 그만큼 본문을 더 쓸 수 있습니다.
+같은 원본 URL 을 다시 줄이면 **기존 링크가 그대로 반환**됩니다. 캠페인별로 반응을
+따로 집계하려면 `forceNew` 로 새 코드를 만드세요.
+`deactivate` 는 링크를 삭제하지 않고 리다이렉트만 중지합니다. 이미 발송한 메시지의
+링크를 무효화할 때 쓰며, 누적 통계는 남고 이후 접속은 `410 Gone` 이 됩니다.
+```python
+# 짧은 URL 생성 (v2 전용)
+created = sendgo.short_url.create(
+    target_url="https://example.com/promotions/summer-sale",
+    title="여름 세일 랜딩",
+)
+code = created["data"]["code"]
+link = created["data"]["shortUrl"]
+# 반응 통계 — 일별 추이 + 디바이스/유입경로/국가별 분해
+# `from` 은 파이썬 예약어이므로 `from_` 을 쓴다
+stats = sendgo.short_url.stats(code, from_="2026-08-01")
+sendgo.short_url.list(count=10)
+sendgo.short_url.show(code)
+sendgo.short_url.deactivate(code)   # 리다이렉트만 중지, 통계는 남는다
+```
+`stats` 는 일별 추이(`daily`)와 디바이스(`byDevice`)·유입경로(`byReferer`)·국가(`byCountry`)별
+분해를 반환합니다. 일별 추이는 사전 집계 표에서 읽으므로 클릭이 많아도 응답 시간이 일정합니다.
+## 변경 사항
+### 1.2.1 (2026-08-14)
+- 레지스트리 목록에 노출되는 패키지 설명에서 친구톡을 브랜드메시지로 교체했습니다.
+  npm/PyPI/Packagist/Maven/NuGet/RubyGems 검색 결과에 그대로 찍히는 문자열이라
+  종료된 채널을 계속 홍보하고 있었습니다.
+- 검색 키워드에 `brand-message` 를 추가했습니다 (`friendtalk` 은 유입 검색어라 유지).
+### 1.2.0 (2026-08-14)
+- **친구톡 Deprecated 표기** — 친구톡은 카카오 정책에 따라 2025-12-31 종료되었고,
+  2026-01-01 부터 발송 요청이 브랜드메시지(자유형)로 자동 대체 발송됩니다.
+  관련 API 에 각 언어의 표준 deprecation 표기를 달았습니다.
+- 자유 본문 타입(`FT`/`FI`/`FW`)의 개별 발송 경로는 아직 친구톡 API 뿐이라는 점을
+  문서에 명시했습니다 — 브랜드메시지 API 는 그 조합에 `NOT_A_BRAND_MESSAGE` 를 반환합니다.
+- 브랜드메시지 전환 안내와 메시지 타입 1:1 대응표를 README 에 추가했습니다.
+### 1.1.0 (2026-08-11)
+- 짧은 URL 추가 — `client.short_url`
+- `HttpClient.delete()` 추가
+- **버전 단일화** — `__init__.py` 에 하드코딩된 `__version__` 을 제거하고 `importlib.metadata` 로 `pyproject.toml` 값을 읽는다. 두 곳이 어긋나 릴리스가 실패한 적이 있다.
 ## 라이선스
 MIT License © 2026 [Sendgo](https://sendgo.io)

{sendgo_python-1.1.0 → sendgo_python-1.2.1}/README.md RENAMED Viewed

@@ -1,6 +1,6 @@
 # sendgo-python
-> **Python / Django / FastAPI에서 카카오 알림톡, 친구톡, SMS를 가장 쉽게 발송하는 SDK**
+> **Python / Django / FastAPI에서 카카오 알림톡, 브랜드메시지, SMS를 가장 쉽게 발송하는 SDK**
 [![PyPI version](https://img.shields.io/pypi/v/sendgo-python?logo=pypi)](https://pypi.org/project/sendgo-python/)
 [![Python](https://img.shields.io/badge/Python-3.10%2B-3776AB?logo=python)](https://python.org)
@@ -157,6 +157,19 @@ client.alimtalk.send(
 ### 카카오 친구톡
+> ⚠️ **Deprecated — 친구톡은 카카오 정책에 따라 2025-12-31 종료되었습니다.**
+> 2026-01-01 부터 친구톡 발송 요청은 카카오 측에서 **브랜드메시지(자유형)** 로 자동 대체 발송됩니다.
+> 호출은 계속 성공하며, 자유 본문 타입(`FT`/`FI`/`FW`)을 개별 수신자에게 보내는 경로는
+> 현재 이것뿐이므로 기존 코드를 당장 바꿀 필요는 없습니다.
+>
+> 다음의 경우에는 **브랜드메시지**를 사용하세요.
+> - 템플릿 기반 리치 타입 (`FL`/`FC`/`FM`/`FP`/`FA`)
+> - 채널 친구가 **아닌** 수신자 (`targeting` = `N` / `I`)
+> - 수신 동의한 전체 채널 친구 동보 (`targeting` = `F`)
+>
+> 메시지 타입은 1:1 대응되며 변환은 서버가 처리합니다 — `FT`→`BT`, `FI`→`BI`, `FW`→`BW`,
+> `FL`→`BL`, `FC`→`BC`, `FM`→`BM`, `FP`→`BP`, `FA`→`BA`.
 ```python
 # 텍스트형
 client.friendtalk.send(
@@ -217,7 +230,7 @@ client.sms.send_mms(
 - 수신 동의한 **전체 채널 친구 동보** 발송 (`targeting: F`, 수신자 목록 불필요)
 - 리스트·캐러셀·커머스·동영상 등 **템플릿 기반 리치 메시지**
-> v2 전용입니다. `FT`/`FI`/`FW`를 채널 친구에게만 보낼 때는 친구톡 API가 더 간단합니다.
+> v2 전용입니다. 자유 본문 타입(`FT`/`FI`/`FW`)을 개별 수신자에게 보낼 때는 여전히 친구톡 API 를 쓰세요 — 이 엔드포인트는 그 조합에 `NOT_A_BRAND_MESSAGE` 를 반환합니다. 친구톡 요청은 카카오 측에서 브랜드메시지(자유형)로 대체 발송됩니다.
 ```python
 # 단건 발송 — 채널 친구 대상
@@ -428,6 +441,63 @@ A. Sendgo 플랜별로 TPS 제한이 있습니다. [요금 정책](https://sendg
 ---
+## 짧은 URL
+짧은 URL 은 메시지 본문의 링크를 줄이고, 그 링크가 실제로 눌렸는지 집계합니다.
+문자는 바이트 수가 요금과 직결되므로 링크를 줄이면 그만큼 본문을 더 쓸 수 있습니다.
+같은 원본 URL 을 다시 줄이면 **기존 링크가 그대로 반환**됩니다. 캠페인별로 반응을
+따로 집계하려면 `forceNew` 로 새 코드를 만드세요.
+`deactivate` 는 링크를 삭제하지 않고 리다이렉트만 중지합니다. 이미 발송한 메시지의
+링크를 무효화할 때 쓰며, 누적 통계는 남고 이후 접속은 `410 Gone` 이 됩니다.
+```python
+# 짧은 URL 생성 (v2 전용)
+created = sendgo.short_url.create(
+    target_url="https://example.com/promotions/summer-sale",
+    title="여름 세일 랜딩",
+)
+code = created["data"]["code"]
+link = created["data"]["shortUrl"]
+# 반응 통계 — 일별 추이 + 디바이스/유입경로/국가별 분해
+# `from` 은 파이썬 예약어이므로 `from_` 을 쓴다
+stats = sendgo.short_url.stats(code, from_="2026-08-01")
+sendgo.short_url.list(count=10)
+sendgo.short_url.show(code)
+sendgo.short_url.deactivate(code)   # 리다이렉트만 중지, 통계는 남는다
+```
+`stats` 는 일별 추이(`daily`)와 디바이스(`byDevice`)·유입경로(`byReferer`)·국가(`byCountry`)별
+분해를 반환합니다. 일별 추이는 사전 집계 표에서 읽으므로 클릭이 많아도 응답 시간이 일정합니다.
+## 변경 사항
+### 1.2.1 (2026-08-14)
+- 레지스트리 목록에 노출되는 패키지 설명에서 친구톡을 브랜드메시지로 교체했습니다.
+  npm/PyPI/Packagist/Maven/NuGet/RubyGems 검색 결과에 그대로 찍히는 문자열이라
+  종료된 채널을 계속 홍보하고 있었습니다.
+- 검색 키워드에 `brand-message` 를 추가했습니다 (`friendtalk` 은 유입 검색어라 유지).
+### 1.2.0 (2026-08-14)
+- **친구톡 Deprecated 표기** — 친구톡은 카카오 정책에 따라 2025-12-31 종료되었고,
+  2026-01-01 부터 발송 요청이 브랜드메시지(자유형)로 자동 대체 발송됩니다.
+  관련 API 에 각 언어의 표준 deprecation 표기를 달았습니다.
+- 자유 본문 타입(`FT`/`FI`/`FW`)의 개별 발송 경로는 아직 친구톡 API 뿐이라는 점을
+  문서에 명시했습니다 — 브랜드메시지 API 는 그 조합에 `NOT_A_BRAND_MESSAGE` 를 반환합니다.
+- 브랜드메시지 전환 안내와 메시지 타입 1:1 대응표를 README 에 추가했습니다.
+### 1.1.0 (2026-08-11)
+- 짧은 URL 추가 — `client.short_url`
+- `HttpClient.delete()` 추가
+- **버전 단일화** — `__init__.py` 에 하드코딩된 `__version__` 을 제거하고 `importlib.metadata` 로 `pyproject.toml` 값을 읽는다. 두 곳이 어긋나 릴리스가 실패한 적이 있다.
 ## 라이선스
 MIT License © 2026 [Sendgo](https://sendgo.io)

{sendgo_python-1.1.0 → sendgo_python-1.2.1}/pyproject.toml RENAMED Viewed

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "sendgo-python"
-version = "1.1.0"
-description = "Sendgo Python SDK — 카카오 알림톡/친구톡, SMS/LMS/MMS"
+version = "1.2.1"
+description = "Sendgo Python SDK — 카카오 알림톡/브랜드메시지, SMS/LMS/MMS"
 readme = "README.md"
 license = {text = "MIT"}
 authors = [{name = "Sendgo", email = "dev@sendgo.io"}]

{sendgo_python-1.1.0 → sendgo_python-1.2.1}/sendgo/client.py RENAMED Viewed

@@ -48,6 +48,7 @@ class Sendgo:
         http = HttpClient(token_manager, base_url, api_version)
         self.alimtalk      = AlimtalkService(http, kakao_sender_key, sms_sender_key)
+        # Deprecated — 친구톡은 2025-12-31 종료. brand_message 를 사용한다.
         self.friendtalk    = FriendtalkService(http, kakao_sender_key, sms_sender_key)
         # 카카오 브랜드메시지 — 친구톡의 후속 채널. v2 전용.
         self.brand_message = BrandMessageService(http, kakao_sender_key, sms_sender_key)

{sendgo_python-1.1.0 → sendgo_python-1.2.1}/sendgo/friendtalk.py RENAMED Viewed

@@ -1,5 +1,6 @@
 from __future__ import annotations
+import warnings
 from typing import Any, Literal
 from .http_client import HttpClient
@@ -10,6 +11,17 @@ FriendtalkMessageType = Literal["FT", "FI", "FW", "FL", "FM", "FC", "FA", "FP"]
 class FriendtalkService:
     """카카오 친구톡 전송 서비스.
+    .. deprecated::
+        친구톡은 카카오 정책에 따라 2025-12-31 종료되었습니다. 2026-01-01 부터
+        친구톡 발송 요청은 카카오 측에서 브랜드메시지(자유형)로 자동 대체 발송되므로,
+        이 서비스를 호출해도 실제로 나가는 것은 브랜드메시지입니다.
+        신규 연동은 :class:`~sendgo.brand_message.BrandMessageService`
+        (``client.brand_message``) 를 사용하세요. 다만 자유 본문 타입(FT/FI/FW)을
+        개별 수신자에게 보내는 경로는 아직 이 서비스뿐입니다 — 브랜드메시지 API 는
+        그 조합에 ``NOT_A_BRAND_MESSAGE`` 를 반환합니다.
+        메시지 타입은 1:1 대응됩니다 — FT→BT, FI→BI, FW→BW, FL→BL,
+        FC→BC, FM→BM, FP→BP, FA→BA.
     Example::
         client.friendtalk.send(
@@ -42,7 +54,19 @@ class FriendtalkService:
         sms_subject: str | None = None,
         sms_content: str | None = None,
     ) -> dict:
-        """친구톡을 전송합니다."""
+        """친구톡을 전송합니다.
+        .. deprecated::
+            2025-12-31 종료. ``client.brand_message.send()`` 를 사용하세요.
+        """
+        # 파이썬의 DeprecationWarning 은 기본적으로 숨겨지므로 운영 로그를 더럽히지
+        # 않으면서, 테스트(-W error)나 개발 모드(-X dev)에서는 확실히 드러난다.
+        warnings.warn(
+            "친구톡은 2025-12-31 종료되어 2026-01-01 부터 브랜드메시지(자유형)로 "
+            "자동 대체 발송됩니다. client.brand_message.send() 를 사용하세요.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         body: dict[str, Any] = {
             "at": at,
             "scheduleType": schedule_type,

{sendgo_python-1.1.0 → sendgo_python-1.2.1}/sendgo_python.egg-info/PKG-INFO RENAMED Viewed

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: sendgo-python
-Version: 1.1.0
-Summary: Sendgo Python SDK — 카카오 알림톡/친구톡, SMS/LMS/MMS
+Version: 1.2.1
+Summary: Sendgo Python SDK — 카카오 알림톡/브랜드메시지, SMS/LMS/MMS
 Author-email: Sendgo <dev@sendgo.io>
 License: MIT
 Project-URL: Homepage, https://sendgo.io
@@ -27,7 +27,7 @@ Requires-Dist: httpx>=0.27; extra == "async"
 # sendgo-python
-> **Python / Django / FastAPI에서 카카오 알림톡, 친구톡, SMS를 가장 쉽게 발송하는 SDK**
+> **Python / Django / FastAPI에서 카카오 알림톡, 브랜드메시지, SMS를 가장 쉽게 발송하는 SDK**
 [![PyPI version](https://img.shields.io/pypi/v/sendgo-python?logo=pypi)](https://pypi.org/project/sendgo-python/)
 [![Python](https://img.shields.io/badge/Python-3.10%2B-3776AB?logo=python)](https://python.org)
@@ -184,6 +184,19 @@ client.alimtalk.send(
 ### 카카오 친구톡
+> ⚠️ **Deprecated — 친구톡은 카카오 정책에 따라 2025-12-31 종료되었습니다.**
+> 2026-01-01 부터 친구톡 발송 요청은 카카오 측에서 **브랜드메시지(자유형)** 로 자동 대체 발송됩니다.
+> 호출은 계속 성공하며, 자유 본문 타입(`FT`/`FI`/`FW`)을 개별 수신자에게 보내는 경로는
+> 현재 이것뿐이므로 기존 코드를 당장 바꿀 필요는 없습니다.
+>
+> 다음의 경우에는 **브랜드메시지**를 사용하세요.
+> - 템플릿 기반 리치 타입 (`FL`/`FC`/`FM`/`FP`/`FA`)
+> - 채널 친구가 **아닌** 수신자 (`targeting` = `N` / `I`)
+> - 수신 동의한 전체 채널 친구 동보 (`targeting` = `F`)
+>
+> 메시지 타입은 1:1 대응되며 변환은 서버가 처리합니다 — `FT`→`BT`, `FI`→`BI`, `FW`→`BW`,
+> `FL`→`BL`, `FC`→`BC`, `FM`→`BM`, `FP`→`BP`, `FA`→`BA`.
 ```python
 # 텍스트형
 client.friendtalk.send(
@@ -244,7 +257,7 @@ client.sms.send_mms(
 - 수신 동의한 **전체 채널 친구 동보** 발송 (`targeting: F`, 수신자 목록 불필요)
 - 리스트·캐러셀·커머스·동영상 등 **템플릿 기반 리치 메시지**
-> v2 전용입니다. `FT`/`FI`/`FW`를 채널 친구에게만 보낼 때는 친구톡 API가 더 간단합니다.
+> v2 전용입니다. 자유 본문 타입(`FT`/`FI`/`FW`)을 개별 수신자에게 보낼 때는 여전히 친구톡 API 를 쓰세요 — 이 엔드포인트는 그 조합에 `NOT_A_BRAND_MESSAGE` 를 반환합니다. 친구톡 요청은 카카오 측에서 브랜드메시지(자유형)로 대체 발송됩니다.
 ```python
 # 단건 발송 — 채널 친구 대상
@@ -455,6 +468,63 @@ A. Sendgo 플랜별로 TPS 제한이 있습니다. [요금 정책](https://sendg
 ---
+## 짧은 URL
+짧은 URL 은 메시지 본문의 링크를 줄이고, 그 링크가 실제로 눌렸는지 집계합니다.
+문자는 바이트 수가 요금과 직결되므로 링크를 줄이면 그만큼 본문을 더 쓸 수 있습니다.
+같은 원본 URL 을 다시 줄이면 **기존 링크가 그대로 반환**됩니다. 캠페인별로 반응을
+따로 집계하려면 `forceNew` 로 새 코드를 만드세요.
+`deactivate` 는 링크를 삭제하지 않고 리다이렉트만 중지합니다. 이미 발송한 메시지의
+링크를 무효화할 때 쓰며, 누적 통계는 남고 이후 접속은 `410 Gone` 이 됩니다.
+```python
+# 짧은 URL 생성 (v2 전용)
+created = sendgo.short_url.create(
+    target_url="https://example.com/promotions/summer-sale",
+    title="여름 세일 랜딩",
+)
+code = created["data"]["code"]
+link = created["data"]["shortUrl"]
+# 반응 통계 — 일별 추이 + 디바이스/유입경로/국가별 분해
+# `from` 은 파이썬 예약어이므로 `from_` 을 쓴다
+stats = sendgo.short_url.stats(code, from_="2026-08-01")
+sendgo.short_url.list(count=10)
+sendgo.short_url.show(code)
+sendgo.short_url.deactivate(code)   # 리다이렉트만 중지, 통계는 남는다
+```
+`stats` 는 일별 추이(`daily`)와 디바이스(`byDevice`)·유입경로(`byReferer`)·국가(`byCountry`)별
+분해를 반환합니다. 일별 추이는 사전 집계 표에서 읽으므로 클릭이 많아도 응답 시간이 일정합니다.
+## 변경 사항
+### 1.2.1 (2026-08-14)
+- 레지스트리 목록에 노출되는 패키지 설명에서 친구톡을 브랜드메시지로 교체했습니다.
+  npm/PyPI/Packagist/Maven/NuGet/RubyGems 검색 결과에 그대로 찍히는 문자열이라
+  종료된 채널을 계속 홍보하고 있었습니다.
+- 검색 키워드에 `brand-message` 를 추가했습니다 (`friendtalk` 은 유입 검색어라 유지).
+### 1.2.0 (2026-08-14)
+- **친구톡 Deprecated 표기** — 친구톡은 카카오 정책에 따라 2025-12-31 종료되었고,
+  2026-01-01 부터 발송 요청이 브랜드메시지(자유형)로 자동 대체 발송됩니다.
+  관련 API 에 각 언어의 표준 deprecation 표기를 달았습니다.
+- 자유 본문 타입(`FT`/`FI`/`FW`)의 개별 발송 경로는 아직 친구톡 API 뿐이라는 점을
+  문서에 명시했습니다 — 브랜드메시지 API 는 그 조합에 `NOT_A_BRAND_MESSAGE` 를 반환합니다.
+- 브랜드메시지 전환 안내와 메시지 타입 1:1 대응표를 README 에 추가했습니다.
+### 1.1.0 (2026-08-11)
+- 짧은 URL 추가 — `client.short_url`
+- `HttpClient.delete()` 추가
+- **버전 단일화** — `__init__.py` 에 하드코딩된 `__version__` 을 제거하고 `importlib.metadata` 로 `pyproject.toml` 값을 읽는다. 두 곳이 어긋나 릴리스가 실패한 적이 있다.
 ## 라이선스
 MIT License © 2026 [Sendgo](https://sendgo.io)