CalendarList: get

Renvoie un agenda figurant dans la liste des agendas de l'utilisateur. Essayez dès maintenant ou consultez un exemple.

Requête

Requête HTTP

GET https://www.googleapis.com/calendar/v3/users/me/calendarList/calendarId

Paramètres

Nom du paramètre Valeur Description
Paramètres de chemin d'accès
calendarId string Identifiant de l'agenda. Pour récupérer les ID d'agenda, appelez la méthode calendarList.list. Si vous souhaitez accéder à l'agenda principal de l'utilisateur actuellement connecté, utilisez le bouton "primary" mot clé.

Autorisation

Une autorisation est requise pour cette demande. Celle-ci doit inclure au moins l'un des champs d'application suivants:

Champ d'application
https://www.googleapis.com/auth/calendar.readonly
https://www.googleapis.com/auth/calendar

Pour en savoir plus, consultez la page Authentification et autorisation.

Corps de la requête

Ne spécifiez pas de corps de requête pour cette méthode.

Réponse

Lorsque cette méthode fonctionne, elle renvoie une ressource CalendarList dans le corps de réponse.

Exemples

Remarque : Les langages de programmation compatibles ne figurent pas tous dans les exemples de code présentés pour cette méthode (consultez la page Bibliothèques clientes pour obtenir la liste des langages compatibles).

Java

Elle utilise la bibliothèque cliente Java.

import com.google.api.services.calendar.Calendar;
import com.google.api.services.calendar.model.CalendarListEntry;

// ...

// Initialize Calendar service with valid OAuth credentials
Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials)
    .setApplicationName("applicationName").build();

// Retrieve a specific calendar list entry
CalendarListEntry calendarListEntry = service.calendarList().get("calendarId").execute();

System.out.println(calendarListEntry.getSummary());

Python

Elle utilise la bibliothèque cliente Python.

calendar_list_entry = service.calendarList().get(calendarId='calendarId').execute()

print(calendar_list_entry['summary'])

PHP

Elle utilise la bibliothèque cliente PHP.

$calendarListEntry = $service->calendarList->get('calendarId');

echo $calendarListEntry->getSummary();

Ruby

Elle utilise la bibliothèque cliente Ruby.

result = client.get_calendar_list('calendarId')
print result.summary

Essayer

Utilisez l'explorateur d'API ci-dessous pour appeler cette méthode sur des données en direct, puis observez la réponse.