diff --git a/docs/2. Pre Onboarding/04. GCS Setup/03. Create an account in Google Cloud Storage GCS.md b/docs/2. Pre Onboarding/04. GCS Setup/03. Create an account in Google Cloud Storage GCS.md index 421ae01cf..e1c82b856 100644 --- a/docs/2. Pre Onboarding/04. GCS Setup/03. Create an account in Google Cloud Storage GCS.md +++ b/docs/2. Pre Onboarding/04. GCS Setup/03. Create an account in Google Cloud Storage GCS.md @@ -1,14 +1,46 @@ - ### **5 minute read                                                                                                                 `Intermediate`** + +

+ + + + + + +
10 minutes readLevel: BeginnerLast Updated: October 2025
+

___ ## Video Tutorial - +### Why is the setup needed ? + +Google Cloud Storage (GCS), BigQuery, and Google Sheets API setup is required for the below reasons: + +- Store and retrieve chatbot data (including media files like images, PDFs, and audio). +- Analyze chatbot interactions using BigQuery. + + +### Prerequisites + +Before starting, make sure you have: +- A Google account (preferably linked to your organisation). + +- A valid phone number and payment details for Google Cloud billing. + +- Legal documents of your for verification. + +### Setup + +**The overall setup includes:** + +Create Google Cloud Account → Enable Billing → Create Project → Enable APIs→ Create Storage Bucket → Add Service Account Key → Link with Glific + +### Step 1: Create a Google Cloud Account 1. Go to [Google Cloud Console](https://console.cloud.google.com) and sign in with your Gsuite account. @@ -19,9 +51,20 @@ ___ 3. Click on `TRY FOR FREE` and fill in Billing details. +- Google provides USD 300 free credits valid for 90 days. + + +- Once credits expire, you must switch to a paid plan. + + +- If not upgraded, the syncing of data will stop working. + + Screenshot 2024-12-18 at 2 06 16 PM + + 4. Select `Country` and check to agree to terms and conditions. Screenshot 2024-12-18 at 2 12 09 PM @@ -52,20 +95,21 @@ This whole process of account information and payment information verification w image +### Step 2: Create a New Project -7. Click `My Project` in the top bar to create a new project. +1. Click on `My Project` in the top bar to create a new project. image -8. Click on `New Project` at the top right corner. +2. Click on `New Project` at the top right corner. Screenshot 2024-12-18 at 2 22 14 PM -10. Fill in your project details and click on the `CREATE` button. Once the new project is created, select it, and in the top search bar: +3. Fill in your project details and click on the `CREATE` button. Once the new project is created, select it, and in the top search bar: ![image](https://user-images.githubusercontent.com/32592458/212659618-d639b26f-f998-4f78-97f5-09c25a2d210c.png) @@ -73,42 +117,44 @@ This whole process of account information and payment information verification w image +### Step 3: Enable Required APIs +1. In the left menu, go to APIs & Services → Library. -- Type `BigQuery API` and `enable` it if it’s not already enabled. If enabled, it will show as `Manage`. +2. Type `BigQuery API` and `enable` it if it’s not already enabled. If enabled, it will show as `Manage`. image -- Similarly, search for `Google Sheets API` and `enable` it if it’s not already enabled. If enabled, it will show as `Manage`. +3. Similarly, search for `Google Sheets API` and `enable` it if it’s not already enabled. If enabled, it will show as `Manage`. +### Step 4: Create a Storage Bucket - -11. Select `Cloud Storage`and the `Buckets` from the side panel of Google Cloud Console Dashboard +1. Select `Cloud Storage`and the `Buckets` from the side panel of Google Cloud Console Dashboard Screenshot 2024-12-18 at 2 24 31 PM -12. Click on `+CREATE` button to create a bucket to store data +2. Click on `+CREATE` button to create a bucket to store data ![image](https://user-images.githubusercontent.com/32592458/212659921-587ddafc-1d15-4e8c-849c-3b087c987dec.png) -13. Enter the name of the bucket to be created and the preferred data location where data will be stored +3. Enter the name of the bucket to be created and the preferred data location where data will be stored ![image](https://user-images.githubusercontent.com/32592458/212659958-a2f60758-3580-4ebd-a2a6-ecd2d9c9ee97.png) -14. Choose the preferred plan for storage and access control type and click on the `CREATE` button. +4. Choose the preferred plan for storage and access control type and click on the `CREATE` button. ![image](https://user-images.githubusercontent.com/32592458/212659975-fa03ee09-ce26-4126-a12d-67533c64f2af.png) -15. A new bucket is created. +5. A new bucket is created. ![image](https://user-images.githubusercontent.com/32592458/212659992-4e172f37-b99d-43c0-bd1c-42169b90d1c5.png) ___ -## Making bucket Public +### Making bucket Public 1 . Once Bucket is created, Open the bucket and click on `Permissions`. @@ -122,41 +168,45 @@ ___ 3 . Under `add principle`, tab choose `allUsers`and choose a role as `Storage Admin`. -![image](https://user-images.githubusercontent.com/32592458/212660108-74a4e900-2852-41fe-ae95-e8e2adaf81fc.png) - - 4 . Click on `save` open and a pop-up will come for confirmation of making the bucket publicly accessible. 5 . Click on `ALLOW PUBLIC ACCESS` ![image](https://user-images.githubusercontent.com/32592458/212660135-9f33ac04-1b9c-4415-90b3-766ee23df40c.png) -6. Select `IAM & Admin`and then `Service Accounts` from the side panel of Google Cloud Console Dashboard +### Step 5: Create Service Account & Key + + +1. Select `IAM & Admin`and then `Service Accounts` from the side panel of Google Cloud Console Dashboard image -7. Click + Create Service Account, enter the details, and click Create and Continue. +2. Click + Create Service Account, enter the details, and click Create and Continue. image -8. Grant this service account access to the project, ensuring it has Owner access as well. Click Done. +3. Grant this service account access to the project, ensuring it has Owner access as well. Click Done. image image -9. Click on the three-dot dropdown next to the service account, then select Manage Keys. +4. Click on the three-dot dropdown next to the service account, then select Manage Keys. image -10. Click Add Key, select JSON as the key type, and click Create. +5. Click Add Key, select JSON as the key type, and click Create. image image -11. Save the downloaded JSON file and copy its content. +6. Save the downloaded JSON file and copy its content. + + Please Note - Save this JSON file securely. You will upload it to Glific later. +The JSON key is what authenticates Glific to access your data. + ## Integrate Google Cloud Storage with Glific