🟆🟆🟆🟆🟆🟆🟆🟆🟆🟆🟆🟆🟆Set-Up🟆🟆🟆🟆🟆🟆🟆🟆🟆🟆🟆🟆🟆🟆
We have detailed video tutorials for each of the actions/elements we have in this plugin. Watch them to understand and use it at ease.

🟆🟆 You must set up your Google Cloud account and create a Google Cloud Project before you can use this plugin. Takes less than 5 mins if you follow the instructions. It is a one time process which is necessary to get your client-id and client-secret. 🟆🟆

✔ Go to https://console.cloud.google.com/
✔ Log in to your Google account.
✔ Create a new project.
✔ Enable Google Contact API.
✔ Create credentials for the API along with redirect URI.
✔ Note down the Client-ID and Client-secret.

➸ Step (1 to 6) is explained in detail:
➸ Watch Youtube video here: https://www.youtube.com/watch?v=k1Y-jR1bpOI


🟆🟆🟆🟆🟆🟆🟆🟆🟆🟆Installing the Plugin🟆🟆🟆🟆🟆🟆🟆🟆🟆🟆


✔ Log in to your Bubble account
✔ Go to Plugins
✔ Search for “Google Contact by Ritz7”
✔ Install the plugin


🟆🟆🟆🟆🟆🟆🟆🟆🟆🟆🟆Using the Plugin🟆🟆🟆🟆🟆🟆🟆🟆🟆🟆🟆


🟆🟆 Note: In all the actions, we have a field named "Authorization". This field should be in the following format: Bearer <Access-Token>. Access Token will be valid for 60 mins from the time it is generated and you can regenerate it using the Refresh Token. And this step is explained in detail here: https://www.youtube.com/watch?v=AsyYBqPsJpA🟆🟆

✔ Drag and drop the element "G-Contacts".

✔ Add an action called "Get G-Contacts Auth-Code via URL" which requires you can add Client-ID and redirect URI. This will return an URL that needs to be opened.  

Note: The redirect URI should match exactly as you have set while configuring in Google Cloud.

✔ Add Next step: You will have to open the URL you get from the previous step.

Note: This will ask your permission for your app to use your Google Account. Once you permit, the element will automatically fetch the code from the URL.

✔ Generate Access Token via code: Call an Action "Get_Access_Token-via_Code". This will require you to pass the client-ID, client-secret, code (you will get it from the element 'G-Contact' and the param is named as 'G-Contact-Code') and redirect URI (this should match the one added in the Google Cloud Project)

Note: You will also get Refresh Token along with Access token from step-4. You use Refresh Token to get the Access Token once the old Access Token expires.  

✔ Use "Get_Access_Token-via_R-Token" action to get the Access token from Refresh Token. This requires you to provide client-ID, client-secret and refresh token.


🟆🟆 Actions 🟆🟆

➽ List all contacts

✔ Inputs:
 ➻ Access token: Token is generated from an action "Get Access Token via Code".

✔ Outputs:
 ➻ List of contacts with their details such as name, phone numbers, email address etc.

➸ Watch the video for the above action here: https://www.youtube.com/watch?v=tNapw2Sxq9k


➽ Create a contact

✔ Inputs:
 ➻ Access token: Token is generated from an action "Get Access Token via Code".
 ➻ First_name: First name of the contact.
 ➻ Last_name: Last name of the contact.
 ➻ Email: Email address of the contact.
 ➻ Phone Number: Phone number with country code of the contact.
 ➻ Birth year: Birth year of the contact in yyyy format.
 ➻ Birth month: Birth month of the contact in mm format.
 ➻ Birth date: Birth date of the contact in dd format.
 ➻ Organization_Name: Name of the organization of the contact.

✔ Outputs:
 ➻ Details of the contact created.

➸ Watch the video for the above action here: https://www.youtube.com/watch?v=5f-uP2xQ-wI


➽ Update a contact

✔ Inputs:
 ➻ Access token: Token is generated from an action "Get Access Token via Code".
 ➻ Resource Name: It is the ID of the contact which you can fetch while listing all the contacts.
 ➻ Etag: It is the etag of the contact which you can fetch while listing all the contacts.
 ➻ First_name: First name of the contact.
 ➻ Last_name: Last name of the contact.
 ➻ Email: Email address of the contact.
 ➻ Phone Number: Phone number with country code of the contact.
 ➻ Birth year: Birth year of the contact in yyyy format.
 ➻ Birth month: Birth month of the contact in mm format.
 ➻ Birth date: Birth date of the contact in dd format.
 ➻ Organization_Name: Name of the organization of the contact.

✔ Outputs:
 ➻ Details of the contact created.

➸ Watch the video for the above action here: https://www.youtube.com/watch?v=xLqWB5H-SG8


➽ Update a contact photo

✔ Inputs:
 ➻ Access token: Token is generated from an action "Get Access Token via Code".
 ➻ Resource Name: It is the ID of the contact which you can fetch while listing all the contacts.
 ➻ photoBytes: It is the base64 of the profile photo that needs to be updated.

✔ Outputs:
 ➻ Details of the photo updated for the contact.

➸ Watch the video for the above action here: https://www.youtube.com/watch?v=xLqWB5H-SG8


➽ Search a contact

✔ Inputs:
 ➻ Access token: Token is generated from an action "Get Access Token via Code".
 ➻ Query: Input any text to search the contact. It can be the first name, the last name, the email address, the phone number.

✔ Outputs:
 ➻ Details of the contact created.

➸ Watch the video for the above action here: https://www.youtube.com/watch?v=ETB1y69xE4E


➽ Delete a contact

✔ Inputs:
 ➻ Access token: Token is generated from an action "Get Access Token via Code".
 ➻ Resource Name: It is the ID of the contact which you can fetch while listing all the contacts.

✔ Outputs: None

➸ Watch the video for the above action here: https://www.youtube.com/watch?v=_SlBPg9OYv4


➽ List all contact groups

✔ Inputs:
 ➻ Access token: Token is generated from an action "Get Access Token via Code".
 ➻ pageToken: Optional. The nextPageToken value returned from a previous call to contactGroups.list. Requests the next page of resources.
 ➻ pageSize: Optional. The maximum number of groups to return. Valid values are between 1 and 1000, inclusive. Defaults to 30 if not set or set to 0.
 ➻ syncToken: Optional. A sync token, returned by a previous call to contactgroups.list. Only resources changed since the sync token was created will be returned..
 ➻ groupFields: Optional. A field mask to restrict which fields on the group are returned. Defaults to metadata, groupType, memberCount, and name if not set or set to empty.

✔ Outputs:
 ➻ List of contact groups with their details.

➸ Watch the video for the above action here: https://www.youtube.com/watch?v=kXVcPfQQBZw


➽ Create a contact group

✔ Inputs:
 ➻ Access token: Token is generated from an action "Get Access Token via Code".
 ➻ Name: It is the name of the contact group which will be created.

✔ Outputs:
 ➻ Details of the contact group created.

➸ Watch the video for the above action here: https://www.youtube.com/watch?v=I5q0p9yc8sM


➽ Update a contact group

✔ Inputs:
 ➻ Access token: Token is generated from an action "Get Access Token via Code".
 ➻ Resource Name: It is the ID of the contact group which you can fetch while listing all the contacts.
 ➻ Etag: It is the etag of the contact group which you can fetch while listing all the contacts groups.
 ➻ Name: Name of the contact group.

✔ Outputs:
 ➻ Details of the contact group updated.

➸ Watch the video for the above action here: https://www.youtube.com/watch?v=kXVcPfQQBZw


➽ Delete a contact group

✔ Inputs:
 ➻ Access token: Token is generated from an action "Get Access Token via Code".
 ➻ deleteContacts: If its true, all the contacts inside the group will be deleted and if its false, group will be deleted without contacts.

✔ Outputs:
 ➻ Details of the contact created.

➸ Watch the video for the above action here: https://www.youtube.com/watch?v=X58rj03Tv1c


➽ Get list of other contacts

✔ Inputs:
 ➻ Access token: Token is generated from an action "Get Access Token via Code".
 ➻ readMask: A field mask to restrict which fields on each contact are returned. Multiple fields can be specified by separating them with commas.
 ➻ sources: Optional. A mask of what source types to return. Defaults to READ_SOURCE_TYPE_CONTACT if not set.

✔ Outputs:
 ➻ List of other contact with their details.

➸ Watch the video for the above action here: https://www.youtube.com/watch?v=zmkn7aSJYTM


➽ Search other contacts

✔ Inputs:
 ➻ Access token: Token is generated from an action "Get Access Token via Code".
 ➻ Query: Input any text to search the contact group. It can be the first name, last name, email address etc.

✔ Outputs:
 ➻ List of the contact groups with their details.

➸ Watch the video for the above action here: https://www.youtube.com/watch?v=zmkn7aSJYTM