This article is about Scopes.

Which integrations are involved?

Breeze: Breeze grants access to all API services via the API KEY. So, Scopes is not required.

Church Community Builder (CCB), Google Calendar (GCal), and Planning Center (PCO) all use Scopes.

How did it start?

What are we doing now?

Scopes when you set up your Integration

Scopes on a day-to-day basis


How did it start?

As you know, part of the integration process is making sure Displaychurch.events (DCE) has the required permissions from your ChMS or external app. The permissions needed depend on your integration and what kind of calendar/groups views you are using.

However, the situation is not a ‘one and done’. You or your staff can change connected account permissions at any time whether accidentally or on purpose. These changes can cause your DCE views to have display issues.


What are we doing now?

Before each sync, we will recheck the permissions situation. If all is well, we do the sync. If something is off, we will stop all automatic syncing, add a notice in your DCE account, and send you an email.

For some of you, especially CCB users, you may get this error as we are making more services mandatory for easier coding. They will be grouped by feature (Events or Groups).

We feel that this improvement will reduce the number of display issues overall.

For those of you who are more 'tech' oriented, here is a diagram of our logic:


Scopes when you set up your Integration

You will find it on the Integrations page when you set up your integrations.

CHURCH COMMUNITY BUILDER (CCB)

You will see Scopes after you click on Start integration.

Mandatory: This first item is a must. It is automatically turned on by DCE.

Calendar / Groups / RSVP: Each of these items describes the permission it will give DCE and the CCB API service(s) needed to make sure it works as required.

Check the items you wish to use. The box will turn blue.

Uncheck the items you do not wish to use. The box will be white.


GOOGLE CALENDAR

You will see Scopes after you click on Start integration.

Public profile: This first item is a must. It is automatically turned on by DCE.

Calendar API / Drive API : Each of these items describes the permission it will give DCE.

Check the items you wish to use. The box will turn blue.

Uncheck the items you do not wish to use. The box will be greyed out.

*** A NOTE ABOUT GIVING GOOGLE DRIVE ACCESS ***

It would be natural to be nervous about giving an app access to ALL your Google Drive files. This is why Google verifies every app that uses Google Drive and Calendar services.

Here is Google documentation about the conditions the app must meet: https://developers.google.com/terms/api-services-user-data-policy#additional-requirements-for-specific-api-scopes

Submitting the app we must describe the usage of the restricted services and then after app submission, there is a manual verification by Google employee.

Having said that, should you still feel unsure, you do not have to give access. The only limitation is that DCE will not be able to pull in your event images.


PLANNING CENTER (PCO)

You will see Scopes after you click on Start integration.

People: This first item is a must. It is automatically turned on by DCE.

Calendar / Groups: Each of these items describes the permission it will give DCE.

Check the items you wish to use. The box will turn blue.

Uncheck the items you do not wish to use. The box will be greyed out.


SCOPES ON A DAY-TO-DAY BASIS

[in process]

First, let's look at what emails/notifications you will see.

Then, we will talk about what you need to do. [Skip the examples and jump to this section.]

Examples of what you will see

Please keep in mind that the actual email/notification will depend on your integration and the scope(s) in question.

Email for CCB

Email for GCal

Email for PCO

CCB Integrations page

GCal Integrations page

PCO Integrations page

---------------------------------------------------------------------------------------------------------------------------

WHAT YOU NEED TO DO

In general, you need to log in to DCE and go to your Integrations page.

Once there, you should see a notification which will explain what you need to do. Click on the Read more.

Using the CCB integration?

Before you follow the steps in the DCE notification, make sure all the necessary API services are enabled.

A little vague?

True, but there are so many combinations of what could need fixing that we cannot give steps for each one. Scroll down for some examples.

Need more support?

No problem - our online chat awaits. Yes, the first step is automated but you know you can always talk to a human.

FOR EXAMPLE

(1) You see this message on your Integrations page (image below):

(2) You click on the Read more (image below):

This message means that you are trying to sync using Groups but you are not authorized to do so.

(3) Here is what your Integration page looks like for this integration (image below):

As you can see in the image above, Groups is indeed checked.

In this case, you would need to uncheck Groups and then click on the blue Re-authenticate button.

Did this answer your question?