timetree sdk python

Python的时间表SDK

Python的时间表API SDK。

时间表API终止时间表

请注意终止时间表API的时间表：

• 新申请创建的停用：2023年8月2日（星期三）
  从这个日期开始，将停止创建新应用程序。在此阶段，这不会影响现有的应用程序。

• 完全关闭时间表API：2023年12月22日（星期五）
  在此日期，所有API端点将停止可用，有效地停止了API的所有功能。

安装

 $ pip install timetree-sdk

用法

 from timetree_sdk import TimeTreeApi

api = TimeTreeApi ( 'API_ACCESS_TOKEN' )
calendar = api . get_calendar ( 'CALENDAR_ID' )
print ( calendar . data . attributes . name ) # calendar name

API

Oauth

获取Oauth授权URL

 oauth_authorize_url = TimeTreeApi . get_oauth_authorize_url ( 'CLIENT_ID' , 'REDIRECT_URI' , 'RESPONSE_TYPE' , 'STATE' )

用户

获取当前用户

 user = api . get_current_user ()
print ( user . data . attributes . name ) # user name 

日历

获取日历

 calendars = api . get_calendars ()
print ( calendars . data [ 0 ]. attributes . name ) # first calendar name

获取日历

 calendar = api . get_calendar ( 'CALENDAR_ID' )
print ( calendar . data . attributes . name ) # calendar name

获取日历标签

 labels = api . get_calendar_labels ( 'CALENDAR_ID' )
print ( labels . data [ 0 ]. attributes . name ) # first calendar's label name

获取日历成员

 members = api . get_calendar_members ( 'CALENDAR_ID' )
print ( members . data [ 0 ]. attributes . name ) # first calendar's member name 

事件

获取事件

 event = api . get_event ( 'CALENDAR_ID' , 'EVENT_ID' )
print ( event . data . attributes . title ) # event title

获得即将举行的活动

 events = api . get_upcoming_events ( 'CALENDAR_ID' , 'Asia/Tokyo' , 7 )
print ( events . data [ 0 ]. attributes . title ) # most recent event title in 7 days

创建事件

 event = Event (
    data = EventData (
        attributes = EventAttributes (
            title = 'Title' ,
            category = 'schedule' ,
            all_day = False ,
            start_at = '2020-04-04T11:00:00.000Z' ,
            end_at = '2020-04-04T13:00:00.000Z' ,
            description = 'Description' ,
            location = 'Location' ,
            start_timezone = 'Japan' ,
            end_timezone = 'Japan'
        ),
        relationships = EventRelationships (
            label = EventRelationshipsLabel (
                data = EventRelationshipsLabelData (
                    id = 'LABEL_ID' ,
                    type = 'label'
                )
            ),
            attendees = EventRelationshipsAttendees (
                data = [ EventRelationshipsAttendeesData (
                    id = 'USER_ID' ,
                    type = 'user'
                )]
            )
        )
    )
)
response = api . create_event ( 'CALENDAR_ID' , event )
print ( response . data . attributes . title ) # Title

更新事件

 event = Event (
    data = EventData (
        attributes = EventAttributes (
            title = 'Updated Title' ,
            category = 'schedule' ,
            all_day = False ,
            start_at = '2020-04-04T11:30:00.000Z' ,
            end_at = '2020-04-04T13:30:00.000Z' ,
            description = 'Description' ,
            location = 'Location' ,
            start_timezone = 'Japan' ,
            end_timezone = 'Japan'
        ),
        relationships = EventRelationships (
            label = EventRelationshipsLabel (
                data = EventRelationshipsLabelData (
                    id = 'LABEL_ID' ,
                    type = 'label'
                )
            ),
            attendees = EventRelationshipsAttendees (
                data = [ EventRelationshipsAttendeesData (
                    id = 'USER_ID' ,
                    type = 'user'
                )]
            )
        )
    )
)
response = api . create_event ( 'CALENDAR_ID' , 'EVENT_ID' , event )
print ( response . data . attributes . title ) # Updated Title

删除事件

 status_code = api . delete_event ( 'CALENDAR_ID' , 'EVENT_ID' )
print ( status_code ) # 204 on success 

事件评论

创建评论到活动

 comment = EventComment (
    data = EventCommentData (
        attributes = EventCommentAttributes (
            content = 'Hello, world'
        )
    )
)
event_comment = api . create_event_comment ( 'CALENDAR_ID' , 'EVENT_ID' , comment )
print ( event_comment . data . attributes . content ) # Hello, world

文档

官方API文档

英语：https：//developers.timetreeapp.com/en/docs/api

日语：https：//developers.timetreeapp.com/ja/docs/api