sendgo-python 1.4.0__tar.gz → 1.5.0__tar.gz

{sendgo_python-1.4.0 → sendgo_python-1.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sendgo-python
-Version: 1.4.0
+Version: 1.5.0
 Summary: Sendgo Python SDK — 카카오 알림톡/브랜드메시지, SMS/LMS/MMS
 Author-email: Sendgo <dev@sendgo.io>
 License: MIT
@@ -809,7 +809,7 @@ MIT License © 2026 [Sendgo](https://sendgo.io)
 
 *키워드: 카카오 알림톡 Python, 카카오 친구톡 Django, SMS 발송 FastAPI, 알림톡 SDK pip, Python 카카오 API 연동, Django 문자 발송, FastAPI 알림톡, Celery 알림톡 비동기, Sendgo Python SDK*
 
-## 계정·조직·API 키 관리 (1.4.0)
+## 계정·조직·API 키 관리 (1.5.0)
 
 발송용 `accessKey`/`secretKey`가 없는 단계에서 사용하는 **별도 계정 클라이언트**입니다.
 콘솔에서 발급받은 에이전트 토큰(`SENDGO_AGENT_TOKEN`)으로 `/api/v2/account`를 호출합니다.
@@ -835,3 +835,29 @@ issued = account.create_api_key({'name': '서버 연동'})
 지원 메서드: `me`, `organizations`, `select_organization`, `api_keys`, `create_api_key`, `api_key`, `update_api_key`, `delete_api_key`, `issue_token`, `allowed_ips`, `add_allowed_ip`, `delete_allowed_ip`.
 
 키 생성 인자는 `name`, 선택적 `ipAddresses: [{ip, description}]`이며, 허용 IP 추가 인자는 `ip`, 선택적 `description`입니다. 키·IP 식별자는 응답의 `id`(UUID)를 사용합니다.
+
+## 템플릿 폴더 (1.5.0)
+
+기업 계정의 발송용 API 키와 `apiVersion=v2` 설정으로 사용하는 서버 전용 API입니다.
+폴더는 알림톡·브랜드메시지가 공유하며, 목록의 `templateType`은 `notice` 또는 `brand`입니다.
+목록은 `data.folders` 트리와 `total`, `uncategorised` 개수를 반환합니다.
+`templateCount`는 하위 폴더를 제외한 해당 폴더의 템플릿 수입니다.
+
+- 생성: `name`, 선택 `parentUuid`. 최대 5단계이며 같은 부모 아래 이름 중복은 409입니다.
+- 이동: 동일 발신프로필의 `templateCodes` 1~100개. `folderUuid`는 필수이며 `null`이면 미분류로 이동합니다.
+- 템플릿 목록: `folderUuid=none`은 미분류, UUID는 해당 폴더, 생략은 전체입니다.
+- 템플릿 등록: 선택 필드 `folderUuid`로 폴더를 지정합니다. 기존 템플릿 수정 API 대신 폴더 이동 API를 사용하세요.
+
+승인되지 않은 키의 `403 ACCESS_KEY_NOT_APPROVED`는 토큰 재발급·재시도 없이 반환합니다.
+계정 API의 `autoApprove`는 서버 설정의 실제 승인 정책을 나타냅니다.
+
+```python
+client.template_folders.list(template_type="notice")
+client.template_folders.create(name="주문 안내")
+client.template_folders.assign(
+    template_type="notice", kakao_sender_key=kakao_sender_key,
+    template_codes=["ORDER_001"], folder_uuid=None,
+)
+client.notice_templates.list(folder_uuid="none")
+# 템플릿 생성 시 folder_uuid=폴더_UUID를 선택 인자로 전달합니다.
+```

{sendgo_python-1.4.0 → sendgo_python-1.5.0}/README.md

@@ -782,7 +782,7 @@ MIT License © 2026 [Sendgo](https://sendgo.io)
 
 *키워드: 카카오 알림톡 Python, 카카오 친구톡 Django, SMS 발송 FastAPI, 알림톡 SDK pip, Python 카카오 API 연동, Django 문자 발송, FastAPI 알림톡, Celery 알림톡 비동기, Sendgo Python SDK*
 
-## 계정·조직·API 키 관리 (1.4.0)
+## 계정·조직·API 키 관리 (1.5.0)
 
 발송용 `accessKey`/`secretKey`가 없는 단계에서 사용하는 **별도 계정 클라이언트**입니다.
 콘솔에서 발급받은 에이전트 토큰(`SENDGO_AGENT_TOKEN`)으로 `/api/v2/account`를 호출합니다.
@@ -808,3 +808,29 @@ issued = account.create_api_key({'name': '서버 연동'})
 지원 메서드: `me`, `organizations`, `select_organization`, `api_keys`, `create_api_key`, `api_key`, `update_api_key`, `delete_api_key`, `issue_token`, `allowed_ips`, `add_allowed_ip`, `delete_allowed_ip`.
 
 키 생성 인자는 `name`, 선택적 `ipAddresses: [{ip, description}]`이며, 허용 IP 추가 인자는 `ip`, 선택적 `description`입니다. 키·IP 식별자는 응답의 `id`(UUID)를 사용합니다.
+
+## 템플릿 폴더 (1.5.0)
+
+기업 계정의 발송용 API 키와 `apiVersion=v2` 설정으로 사용하는 서버 전용 API입니다.
+폴더는 알림톡·브랜드메시지가 공유하며, 목록의 `templateType`은 `notice` 또는 `brand`입니다.
+목록은 `data.folders` 트리와 `total`, `uncategorised` 개수를 반환합니다.
+`templateCount`는 하위 폴더를 제외한 해당 폴더의 템플릿 수입니다.
+
+- 생성: `name`, 선택 `parentUuid`. 최대 5단계이며 같은 부모 아래 이름 중복은 409입니다.
+- 이동: 동일 발신프로필의 `templateCodes` 1~100개. `folderUuid`는 필수이며 `null`이면 미분류로 이동합니다.
+- 템플릿 목록: `folderUuid=none`은 미분류, UUID는 해당 폴더, 생략은 전체입니다.
+- 템플릿 등록: 선택 필드 `folderUuid`로 폴더를 지정합니다. 기존 템플릿 수정 API 대신 폴더 이동 API를 사용하세요.
+
+승인되지 않은 키의 `403 ACCESS_KEY_NOT_APPROVED`는 토큰 재발급·재시도 없이 반환합니다.
+계정 API의 `autoApprove`는 서버 설정의 실제 승인 정책을 나타냅니다.
+
+```python
+client.template_folders.list(template_type="notice")
+client.template_folders.create(name="주문 안내")
+client.template_folders.assign(
+    template_type="notice", kakao_sender_key=kakao_sender_key,
+    template_codes=["ORDER_001"], folder_uuid=None,
+)
+client.notice_templates.list(folder_uuid="none")
+# 템플릿 생성 시 folder_uuid=폴더_UUID를 선택 인자로 전달합니다.
+```

{sendgo_python-1.4.0 → sendgo_python-1.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sendgo-python"
-version = "1.4.0"
+version = "1.5.0"
 description = "Sendgo Python SDK — 카카오 알림톡/브랜드메시지, SMS/LMS/MMS"
 readme = "README.md"
 license = {text = "MIT"}

{sendgo_python-1.4.0 → sendgo_python-1.5.0}/sendgo/brand_template.py

@@ -43,11 +43,12 @@ class BrandTemplateService:
         kakao_sender_key: str | None = None,
         search: str | None = None,
         count: int | None = None,
+        folder_uuid: str | None = None,
     ) -> dict[str, Any]:
         """목록 조회."""
         return self._http.get(
             self._RESOURCE,
-            {"kakaoSenderKey": kakao_sender_key, "search": search, "count": count},
+            {"folderUuid": folder_uuid, "kakaoSenderKey": kakao_sender_key, "search": search, "count": count},
         )
 
     def show(self, template_code: str) -> dict[str, Any]:

{sendgo_python-1.4.0 → sendgo_python-1.5.0}/sendgo/client.py

@@ -15,6 +15,7 @@ from .short_url import ShortUrlService
 from .sms import SmsService
 from .token_manager import TokenManager
 from .webhook import WebhookService
+from .template_folder import TemplateFolderService
 
 
 class Sendgo:
@@ -81,3 +82,4 @@ class Sendgo:
         self.kakao_images        = KakaoImageService(http)
         self.rejected_numbers    = RejectedNumberService(http)
         self.webhook             = WebhookService(http)
+        self.template_folders    = TemplateFolderService(http)

{sendgo_python-1.4.0 → sendgo_python-1.5.0}/sendgo/notice_template.py

@@ -52,11 +52,13 @@ class NoticeTemplateService:
         inspection_status: str | None = None,
         search: str | None = None,
         count: int | None = None,
+        folder_uuid: str | None = None,
     ) -> dict[str, Any]:
         """목록 조회."""
         return self._http.get(
             self._RESOURCE,
             {
+                "folderUuid": folder_uuid,
                 "kakaoSenderKey": kakao_sender_key,
                 "inspectionStatus": inspection_status,
                 "search": search,

sendgo_python-1.5.0/sendgo/template_folder.py

@@ -0,0 +1,25 @@
+"""템플릿 공용 폴더. v2 전용, 기업 계정 전용."""
+from __future__ import annotations
+from typing import Any, Literal
+from .http_client import HttpClient
+
+class TemplateFolderService:
+    def __init__(self, http: HttpClient) -> None:
+        self._http = http
+
+    def list(self, *, template_type: Literal["notice", "brand"] | None = None,
+             kakao_sender_key: str | None = None) -> dict[str, Any]:
+        """폴더 트리와 유형별 템플릿 수를 조회합니다."""
+        return self._http.get("template-folders", {"templateType": template_type, "kakaoSenderKey": kakao_sender_key})
+
+    def create(self, *, name: str, parent_uuid: str | None = None) -> dict[str, Any]:
+        """루트 또는 하위 폴더를 생성합니다."""
+        return self._http.post("template-folders", {"name": name, "parentUuid": parent_uuid})
+
+    def assign(self, *, template_type: Literal["notice", "brand"], kakao_sender_key: str,
+               template_codes: list[str], folder_uuid: str | None) -> dict[str, Any]:
+        """1~100개 템플릿을 이동합니다. None이면 미분류로 이동합니다."""
+        return self._http.patch("template-folders/templates", {
+            "templateType": template_type, "kakaoSenderKey": kakao_sender_key,
+            "templateCodes": template_codes, "folderUuid": folder_uuid,
+        })

{sendgo_python-1.4.0 → sendgo_python-1.5.0}/sendgo_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sendgo-python
-Version: 1.4.0
+Version: 1.5.0
 Summary: Sendgo Python SDK — 카카오 알림톡/브랜드메시지, SMS/LMS/MMS
 Author-email: Sendgo <dev@sendgo.io>
 License: MIT
@@ -809,7 +809,7 @@ MIT License © 2026 [Sendgo](https://sendgo.io)
 
 *키워드: 카카오 알림톡 Python, 카카오 친구톡 Django, SMS 발송 FastAPI, 알림톡 SDK pip, Python 카카오 API 연동, Django 문자 발송, FastAPI 알림톡, Celery 알림톡 비동기, Sendgo Python SDK*
 
-## 계정·조직·API 키 관리 (1.4.0)
+## 계정·조직·API 키 관리 (1.5.0)
 
 발송용 `accessKey`/`secretKey`가 없는 단계에서 사용하는 **별도 계정 클라이언트**입니다.
 콘솔에서 발급받은 에이전트 토큰(`SENDGO_AGENT_TOKEN`)으로 `/api/v2/account`를 호출합니다.
@@ -835,3 +835,29 @@ issued = account.create_api_key({'name': '서버 연동'})
 지원 메서드: `me`, `organizations`, `select_organization`, `api_keys`, `create_api_key`, `api_key`, `update_api_key`, `delete_api_key`, `issue_token`, `allowed_ips`, `add_allowed_ip`, `delete_allowed_ip`.
 
 키 생성 인자는 `name`, 선택적 `ipAddresses: [{ip, description}]`이며, 허용 IP 추가 인자는 `ip`, 선택적 `description`입니다. 키·IP 식별자는 응답의 `id`(UUID)를 사용합니다.
+
+## 템플릿 폴더 (1.5.0)
+
+기업 계정의 발송용 API 키와 `apiVersion=v2` 설정으로 사용하는 서버 전용 API입니다.
+폴더는 알림톡·브랜드메시지가 공유하며, 목록의 `templateType`은 `notice` 또는 `brand`입니다.
+목록은 `data.folders` 트리와 `total`, `uncategorised` 개수를 반환합니다.
+`templateCount`는 하위 폴더를 제외한 해당 폴더의 템플릿 수입니다.
+
+- 생성: `name`, 선택 `parentUuid`. 최대 5단계이며 같은 부모 아래 이름 중복은 409입니다.
+- 이동: 동일 발신프로필의 `templateCodes` 1~100개. `folderUuid`는 필수이며 `null`이면 미분류로 이동합니다.
+- 템플릿 목록: `folderUuid=none`은 미분류, UUID는 해당 폴더, 생략은 전체입니다.
+- 템플릿 등록: 선택 필드 `folderUuid`로 폴더를 지정합니다. 기존 템플릿 수정 API 대신 폴더 이동 API를 사용하세요.
+
+승인되지 않은 키의 `403 ACCESS_KEY_NOT_APPROVED`는 토큰 재발급·재시도 없이 반환합니다.
+계정 API의 `autoApprove`는 서버 설정의 실제 승인 정책을 나타냅니다.
+
+```python
+client.template_folders.list(template_type="notice")
+client.template_folders.create(name="주문 안내")
+client.template_folders.assign(
+    template_type="notice", kakao_sender_key=kakao_sender_key,
+    template_codes=["ORDER_001"], folder_uuid=None,
+)
+client.notice_templates.list(folder_uuid="none")
+# 템플릿 생성 시 folder_uuid=폴더_UUID를 선택 인자로 전달합니다.
+```

{sendgo_python-1.4.0 → sendgo_python-1.5.0}/sendgo_python.egg-info/SOURCES.txt

@@ -18,6 +18,7 @@ sendgo/rejected_number.py
 sendgo/sender_registration.py
 sendgo/short_url.py
 sendgo/sms.py
+sendgo/template_folder.py
 sendgo/token_manager.py
 sendgo/webhook.py
 sendgo_python.egg-info/PKG-INFO