{"id":1533,"date":"2026-01-17T08:22:14","date_gmt":"2026-01-17T08:22:14","guid":{"rendered":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/?p=1533"},"modified":"2026-01-24T06:29:54","modified_gmt":"2026-01-24T06:29:54","slug":"google-calendar-api-usage-scopes","status":"publish","type":"post","link":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/kivicare-google-meet-telemed-woocommerce-addon\/documentation\/integration-reference\/google-calendar-api-usage-scopes\/","title":{"rendered":"Google Calendar API Usage & Scopes"},"content":{"rendered":"
\n

This section is intended for developers and technical users<\/strong> who want to understand how KiviCare integrates with the Google Calendar API<\/strong> to enable Google Meet\u2013based virtual consultations.<\/p>\n\n\n\n

\n\n\n\n

Google Calendar API Endpoint<\/strong><\/h2>\n\n\n\n

KiviCare uses Google Calendar API v3<\/strong> for all calendar and meeting-related operations.<\/p>\n\n\n\n

Base API URL:<\/strong>
https:\/\/www.googleapis.com\/calendar\/v3\/<\/code><\/p>\n\n\n\n

\n\n\n\n

Required OAuth Scopes<\/strong><\/h2>\n\n\n\n

To ensure proper functionality, the following OAuth scope must be enabled<\/strong> in your Google Cloud Project:<\/p>\n\n\n\n

    \n
  • https:\/\/www.googleapis.com\/auth\/calendar<\/code><\/strong>
    Required to create, update, retrieve, and delete Google Calendar events, including generating Google Meet conference links.<\/li>\n<\/ul>\n\n\n\n
    \n\n\n\n

    Core API Operations<\/strong><\/h2>\n\n\n\n
    1. Create Google Calendar Event with Google Meet<\/strong><\/h5>\n\n\n\n
      \n
    • HTTP Method:<\/strong> POST<\/code><\/li>\n\n\n\n
    • Endpoint:<\/strong>
      \/calendars\/primary\/events?conferenceDataVersion=1<\/code><\/li>\n\n\n\n
    • Handler Function:<\/strong>
      KCGMGoogleMeet::create_meeting()<\/code><\/li>\n\n\n\n
    • Request Payload Includes:<\/strong>\n
        \n
      • summary<\/code> (appointment title)<\/li>\n\n\n\n
      • start<\/code> and end<\/code> (appointment time)<\/li>\n\n\n\n
      • conferenceData<\/code> (requests creation of a Google Meet link)<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n

        This request automatically generates a Google Meet session and associates it with the appointment.<\/p>\n\n\n\n

        \n\n\n\n
        2. OAuth 2.0 Token Exchange<\/strong><\/h5>\n\n\n\n
          \n
        • HTTP Method:<\/strong> POST<\/code><\/li>\n\n\n\n
        • Endpoint:<\/strong>
          https:\/\/oauth2.googleapis.com\/token<\/code><\/li>\n\n\n\n
        • Handler Function:<\/strong>
          KCGMGoogleMeet::handle_google_meet_authorization_callback()<\/code><\/li>\n\n\n\n
        • Supported Grant Types:<\/strong>\n
            \n
          • authorization_code<\/code> (initial login)<\/li>\n\n\n\n
          • refresh_token<\/code> (token renewal)<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n

            This process securely authenticates doctors and maintains continuous API access without repeated user interaction.<\/p>\n\n\n\n

            \n\n\n\n
            API Quotas & Rate Limiting<\/strong><\/h5>\n\n\n\n

            Google Cloud enforces usage quotas and rate limits per project.<\/p>\n\n\n\n

              \n
            • Default Google API quotas are typically sufficient for most clinics.<\/li>\n\n\n\n
            • KiviCare optimizes API usage by:\n
                \n
              • Caching access tokens<\/li>\n\n\n\n
              • Automatically refreshing tokens when required<\/li>\n\n\n\n
              • Reducing unnecessary authorization requests<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/div>","protected":false},"excerpt":{"rendered":"

                This section is intended for developers and technical users who want to understand how KiviCare integrates with the Google Calendar API to enable Google Meet\u2013based virtual consultations. Google Calendar API Endpoint KiviCare uses Google Calendar API v3 for all calendar and meeting-related operations. Base API URL:https:\/\/www.googleapis.com\/calendar\/v3\/ Required OAuth Scopes To ensure proper functionality, the following […]<\/p>\n","protected":false},"author":12,"featured_media":0,"parent":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[45],"tags":[],"class_list":["post-1533","post","type-post","status-publish","format-standard","hentry","category-integration-reference"],"featured_image_src":null,"author_info":{"display_name":"wordpressadminiq","author_link":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/author\/wordpressadminiq\/"},"_links":{"self":[{"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/posts\/1533","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/users\/12"}],"replies":[{"embeddable":true,"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/comments?post=1533"}],"version-history":[{"count":5,"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/posts\/1533\/revisions"}],"predecessor-version":[{"id":1604,"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/posts\/1533\/revisions\/1604"}],"wp:attachment":[{"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/media?parent=1533"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/categories?post=1533"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/tags?post=1533"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}