Skip to content

Commit ea41cd0

Browse files
Update and rename docs/2. Pre Onboarding/04. GCS Setup/03. Create an account in Google Cloud Storage GCS.md to docs/2. Pre Onboarding/01.Google Cloud Storage (GCS) Setup.md
1 parent 594f6c1 commit ea41cd0

File tree

1 file changed

+114
-8
lines changed

1 file changed

+114
-8
lines changed
Lines changed: 114 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -16,13 +16,11 @@ ___
1616

1717
<iframe width="560" height="315" src="https://youtube.com/embed/YzdAWnOWqpw?si=awz7ANnzGV2j_P0b" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
1818

19-
### Why is the setup needed ?
2019

21-
Google Cloud Storage (GCS), BigQuery, and Google Sheets API setup is required for the below reasons:
22-
23-
- Store and retrieve chatbot data (including media files like images, PDFs, and audio).
24-
- Analyze chatbot interactions using BigQuery.
20+
___
2521

22+
**Google Cloud Storage (GCS) is a cloud-based service provided by Google Cloud Platform (GCP) that allows you to store and access data—such as files, images, videos, backups, and large datasets—on Google’s secure servers instead of on your local computer or server.**
23+
**Google Cloud Storage (GCS) will be used for various purposes like storing data for reporting via BigQuery as well as for storing media files.**
2624

2725
### Prerequisites
2826

@@ -116,6 +114,64 @@ This whole process of account information and payment information verification w
116114

117115
<img width="560" alt="image" src="https://github.com/user-attachments/assets/9576010a-f8dd-44e4-9be1-2d9bd23c8087" />
118116

117+
### GCS Setup with UPI (not mandatory, required only when the payment method is UPI.)
118+
119+
Step 1: Creating a GCS Account
120+
121+
- Navigate to the GCS registration portal.
122+
- Click on 'Create New Account'.
123+
<img width="624" alt="Screenshot 2025-03-31 at 9 28 01 PM" src="https://github.com/user-attachments/assets/766089d2-8b9a-4f7d-83b4-1d1c18d5d018" />
124+
125+
- Agree to the Terms of Service.
126+
Step 2: Starting the Free Trial
127+
128+
- Click on 'Try for Free'.
129+
<img width="629" alt="Screenshot 2025-03-31 at 9 28 43 PM" src="https://github.com/user-attachments/assets/94d0c0a3-819e-4f80-9b21-bfa6c160d991" />
130+
131+
- Note that this is a trial account with USD 300 in benefits.
132+
133+
Step 3: Selecting Country
134+
135+
- Choose your country from the dropdown and selection “Agree & continue”
136+
<img width="627" alt="Screenshot 2025-03-31 at 9 28 59 PM" src="https://github.com/user-attachments/assets/f314f437-3a26-4551-9c68-6655b4193462" />
137+
138+
Step 4: Selecting Payment Profile
139+
140+
- Choose an existing payment profile or create a new one.
141+
<img width="623" alt="Screenshot 2025-03-31 at 9 29 15 PM" src="https://github.com/user-attachments/assets/030d8510-58c7-48cd-8567-4e63f9ed7e7a" />
142+
143+
Step 5: Filling Out Payment Form
144+
145+
- Enter the required billing details in the form.
146+
<img width="624" alt="Screenshot 2025-03-31 at 9 29 30 PM" src="https://github.com/user-attachments/assets/49960d7d-05f8-4638-a8ed-d8d76468518b" />
147+
148+
Step 6: Choosing Payment Method
149+
150+
- Click on Add payment method.
151+
<img width="592" alt="Screenshot 2025-03-31 at 9 29 43 PM" src="https://github.com/user-attachments/assets/2d701226-2f3b-472b-a956-ea6b86209138" />
152+
153+
In the payment method screen shown here, Choose the UPI QR code option for payment. You can alternatively choose Credit Card or Net banking as well.
154+
155+
<img width="613" alt="Screenshot 2025-03-31 at 9 30 02 PM" src="https://github.com/user-attachments/assets/afa0772d-7339-4327-82e5-5ce44fe15fc2" />
156+
157+
- Highlight: The Reserve Bank of India (RBI) requirement for mandate approval.
158+
159+
Step 7: Selecting UPI QR Code
160+
161+
- Use your phone (UPI app) to make the payment after scanning the QR code.
162+
<img width="621" alt="Screenshot 2025-03-31 at 9 30 16 PM" src="https://github.com/user-attachments/assets/aaa2b627-692b-4517-bbe6-1d0be8d0dcbb" />
163+
164+
Step 8: Completing Welcome Form
165+
166+
<img width="624" alt="Screenshot 2025-03-31 at 9 30 41 PM" src="https://github.com/user-attachments/assets/76c2107d-3fe0-4e44-8c5d-4a95e1ad9295" />
167+
168+
The screen changes once the payment is completed and a welcome form appears after payment confirmation.
169+
170+
Step 9: Verifying Credits
171+
172+
<img width="624" alt="Screenshot 2025-03-31 at 9 30 55 PM" src="https://github.com/user-attachments/assets/4a47237f-1afb-423a-b128-01bbb890f638" />
173+
174+
The account dashboard shows the credited USD 300 trial funds.
119175

120176
### Step 3: Enable Required APIs
121177

@@ -208,7 +264,7 @@ ___
208264
The JSON key is what authenticates Glific to access your data.
209265

210266

211-
## Integrate Google Cloud Storage with Glific
267+
### Integrate Google Cloud Storage with Glific
212268

213269
1. Open the Glific account and click on the NGO main account button (bottom left corner), then go to Settings and
214270
select Google Cloud Storage.
@@ -218,15 +274,65 @@ select Google Cloud Storage.
218274

219275
4. Enter the bucket name (you can find it in Google Cloud Console > Cloud Storage > Buckets).
220276

221-
## Integrate BigQuery API with Glific
277+
### Integrate BigQuery API with Glific
222278

223279
1. Open BigQuery from the left panel in Glific.
224280

225281
2. Enable the active box and paste the copied JSON content into the Goth Credentials field. Click Save.
226282

227-
## Integrate Google Sheets API with Glific
283+
### Integrate Google Sheets API with Glific
228284

229285
1. Open Google Sheets from the left panel in Glific.
230286

231287
2. Enable the active box and paste the copied JSON content into the Goth Credentials field. Click Save.
232288

289+
### What's the reason for setting the GCS bucket to public?
290+
291+
The `GCS (Google Cloud Storage)` bucket is set to public to make it easier to share files—like PDFs, images, videos etc — without needing user authentication.
292+
293+
This is especially useful when files need to be accessed directly through chatbot flows or shared publicly with partners and beneficiaries.
294+
When a file is public, anyone with the link can open or download it without logging in. This avoids errors or delays caused by restricted access.
295+
296+
Example:
297+
298+
If an NGO’s bot sends a PDF through a the chatbot, and the file is stored in a public bucket, the end user can simply tap the link and view it — no login or permission required.
299+
Note: Only non-sensitive, public-facing files should be stored in the public bucket. Private or personal data should always be stored securely with proper access controls.
300+
301+
### Is it possible to keep my GCS bucket private instead of making it public?
302+
303+
It's perfectly fine to keep your `GCS bucket` private as long as you don't plan to share any content publicly.
304+
305+
However, if you need to send media as attachments (instead of sharing via links), the bucket would need to be public for access.
306+
307+
Also, just to clarify — `BigQuery tables` and `GCS buckets` serve different purposes.
308+
309+
- BigQuery tables are used to store structured data (like databases).
310+
- GCS buckets are used to store media files such as images, audio, and documents.
311+
312+
### Assign access to the Service Account in Google Console
313+
314+
- Go to [Google Cloud Console](https://console.cloud.google.com) and sign in with your Gsuite account.
315+
316+
![image](https://user-images.githubusercontent.com/32592458/212658353-8fed1d92-2e9d-4a9f-99c9-a359dc08698f.png)
317+
318+
- Click on `IAM & Admin` and select `Service Accounts`.
319+
320+
<img width="1467" alt="image" src="https://github.com/user-attachments/assets/4864bf84-2ab1-44f5-957c-f80c62dc3ead"/>
321+
322+
<img width="1464" alt="image" src="https://github.com/user-attachments/assets/bcb9735b-088a-4a8f-abce-f382e081b720"/>
323+
324+
- Access the created `Service Account` and go to `Permissions`.
325+
326+
<img width="1282" alt="image" src="https://github.com/user-attachments/assets/3205a3b3-504b-4ff8-b9af-3870d8f2cc18"/>
327+
328+
- Click on Grant Access, select `New Principal`, enter the desired email address (e.g., [email protected]), and assign the role as `Owner`.
329+
330+
<img width="1308" alt="image" src="https://github.com/user-attachments/assets/b6ddcaee-8e5f-4b79-94e1-19a877d9a44e"/>
331+
332+
- Click `Save`.
333+
334+
### Reference Articles
335+
336+
- [GCS Pricing Details](https://cloud.google.com/storage/pricing)
337+
338+
- [Google Help Docs](https://cloud.google.com/storage/docs/quickstart-console)

0 commit comments

Comments
 (0)