Calendars: transferOwnership

Transfère un agenda secondaire entre utilisateurs d'une organisation Google Workspace. Nécessite l'authentification de l'utilisateur avec le droit d'administrateur Gérer les agendas et l'un des champs d'application d'autorisation suivants :

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.calendars
 Dans la requête, définissez useAdminAccess sur true. L'agenda secondaire doit être actif pour pouvoir être transféré. Il n'est pas possible de transférer des agendas désactivés ou supprimés. Essayez-le maintenant.

Requête

Requête HTTP

POST https://www.googleapis.com/calendar/v3/calendars/calendarId/transferOwnership

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.
Paramètres de requête obligatoires
newDataOwner string Adresse e-mail d'un utilisateur qui deviendra le propriétaire des données de l'agenda.
useAdminAccess boolean Si la valeur est "true", la méthode s'exécute avec les droits d'administrateur Google Workspace de l'utilisateur. L'utilisateur appelant doit être un administrateur Google Workspace disposant du droit "Gérer les agendas". Cette méthode n'accepte actuellement que l'accès administrateur. Par conséquent, seule la valeur true est acceptée pour ce champ.

Autorisation

Cette requête nécessite une autorisation avec au moins l'une des portées suivantes :

Champ d'application
https://www.googleapis.com/auth/calendar.calendars
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

Si la requête aboutit, cette méthode renvoie un corps de réponse vide.

Essayer

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