Google Calendar API Documentation Missing

Environment details

• OS: MacOS Catalina
• Python version: 3.6.9
• pip version: 19.3.1
• google-api-python-client==1.7.11
• google-auth-httplib2==0.0.3
• google-auth-oauthlib==0.4.1
• google-auth==1.10.1

Steps to reproduce

1. It states here https://developers.google.com/calendar/v3/sync that a GoogleJsonResponseException will be returned in Java if a sync token can not be returned. Currently I have the following:

events = service.events().list(calendarId='primary', syncToken=sync_token, pageToken=page_token).execute()
except Exception as e:
    if 'code' in e and e.code == 410:	#sync token was invalidated, full sync required
        #clear token, call full sync

Is there documentation in python for how an invalidated sync token is handled?

1. Is there python documentation that shows the client library automatically refreshing the access token after .execute()? For example, doing the following appears to show the client library automatically refreshing my access token:

credentials = pickle.loads(user.google_api_credentials)	
print(credentials.valid) #false
event_results = service.events().list(calendarId='primary', singleEvents=True).execute()
print(credentials.valid) #true after calling .execute() in the line above. 

Does this confirm using the python library will guarantee automatic refreshing of the access_token without requiring extra code?

[jason-ce]

Try these imports:

from googleapiclient.errors import HttpError
from google.auth.exceptions import RefreshError

To the best of my knowledge, RefreshError happens when the sync token is invalided for any number of reasons such as the user changes their password, manually revokes permissions, or they’ve used the same token for 6 months.

You’ll need to account for RefreshError in your code as well. When we get a RefreshError, we sign them out of google calendar and give the user a message that they need to reconnect.

[danlo9]

@jason-cf Thanks. This might be a silly question, but what is RefreshError?

Also, when I do

try:
    service.events().list(calendarId="primary", syncToken=sync_token, pageToken=page_token).execute()
except urllib.error.HTTPError as e:
    print(e.resp.status)

I am still not catching the error. Is there something I am missing?