timetree sdk python

TimeTree SDK para Python

TimeTree API SDK para Python.

Cronograma de rescisão da API timeTree

Esteja ciente do cronograma a seguir para a rescisão da API timeTree:

• Descontinuação da nova criação de aplicativos: 2 de agosto de 2023 (quarta -feira)
  A partir desta data, a criação de novos aplicativos será descontinuada. Isso não afetará os aplicativos existentes nesta fase.

• Desligamento completo da API do timeTree: 22 de dezembro de 2023 (sexta -feira)
  Nesta data, todos os pontos de extremidade da API deixarão de estar disponíveis, interrompendo efetivamente toda a funcionalidade da API.

Instalação

 $ pip install timetree-sdk

Uso

 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

Obtenha OAuth Authorize URL

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

Usuário

Obtenha o usuário atual

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

Calendário

Obtenha calendários

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

Obtenha calendário

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

Obtenha etiquetas de calendário

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

Obtenha membros do calendário

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

Evento

Obter evento

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

Obtenha os próximos eventos

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

Criar evento

 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

evento de atualização

 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

Excluir evento

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

Comentário do evento

Crie comentário para o evento

 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

Documentação

Documentação oficial da API

Inglês: https://developers.timetreeapp.com/en/docs/api

Japonês: https://developers.timetreeapp.com/ja/docs/api