timetree sdk python

Timetree SDK для Python

Timetree API SDK для Python.

Расписание завершения Timetree API

Пожалуйста, имейте в виду следующее расписание для прекращения Timetree API:

• Открытие новых приложений: 2 августа 2023 г. (среда)
  С этой даты создание новых приложений будет прекращено. Это не повлияет на существующие приложения на этом этапе.

• Полное закрытие API Timetree: 22 декабря 2023 г. (пятница)
  В эту дату все конечные точки 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 arlize 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