timetree sdk python

SDK TIMETREE pour Python

SDK API TIMETREE pour Python.

Horaire de terminaison de l'API TIMETREE

Veuillez être conscient du calendrier suivant pour la résiliation de l'API TimeTree:

• Arrêt de la création de nouvelles applications: 2 août 2023 (mercredi)
  À partir de cette date, la création de nouvelles applications sera interrompue. Cela n'a pas d'impact sur les applications existantes à ce stade.

• Arrêt complet de l'API TIMERREE: 22 décembre 2023 (vendredi)
  À cette date, tous les points de terminaison de l'API cesseront d'être disponibles, ce qui interrompra efficacement toutes les fonctionnalités de l'API.

Installation

 $ pip install timetree-sdk

Usage

 from timetree_sdk import TimeTreeApi

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

API

Notamment

Obtenez une UAUTH URL

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

Utilisateur

Obtenez l'utilisateur actuel

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

Calendrier

obtenir des calendriers

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

obtenir le calendrier

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

Obtenez des étiquettes de calendrier

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

Obtenez les membres du calendrier

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

Événement

Obtenir l'événement

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

Obtenez des événements à venir

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

créer un événement

 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

mettre à jour l'événement

 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

Supprimer l'événement

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

Commentaire de l'événement

Créer un commentaire à l'événement

 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

Documentation

Documentation officielle de l'API

Anglais: https://developers.timetreeapp.com/en/docs/API

Japonais: https://developers.timetreeapp.com/ja/docs/api