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/01.Google Cloud Storage (GCS) Setup.md similarity index 58% rename from docs/2. Pre Onboarding/04. GCS Setup/03. Create an account in Google Cloud Storage GCS.md rename to docs/2. Pre Onboarding/01.Google Cloud Storage (GCS) Setup.md index e1c82b856..6c2b3bc2d 100644 --- a/docs/2. Pre Onboarding/04. GCS Setup/03. Create an account in Google Cloud Storage GCS.md +++ b/docs/2. Pre Onboarding/01.Google Cloud Storage (GCS) Setup.md @@ -16,13 +16,11 @@ ___ -### 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. +___ +**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.** +**Google Cloud Storage (GCS) will be used for various purposes like storing data for reporting via BigQuery as well as for storing media files.** ### Prerequisites @@ -116,6 +114,64 @@ This whole process of account information and payment information verification w image +### GCS Setup with UPI (not mandatory, required only when the payment method is UPI.) + +Step 1: Creating a GCS Account + +- Navigate to the GCS registration portal. +- Click on 'Create New Account'. +Screenshot 2025-03-31 at 9 28 01 PM + +- Agree to the Terms of Service. +Step 2: Starting the Free Trial + +- Click on 'Try for Free'. +Screenshot 2025-03-31 at 9 28 43 PM + +- Note that this is a trial account with USD 300 in benefits. + +Step 3: Selecting Country + +- Choose your country from the dropdown and selection “Agree & continue” +Screenshot 2025-03-31 at 9 28 59 PM + +Step 4: Selecting Payment Profile + +- Choose an existing payment profile or create a new one. +Screenshot 2025-03-31 at 9 29 15 PM + +Step 5: Filling Out Payment Form + +- Enter the required billing details in the form. +Screenshot 2025-03-31 at 9 29 30 PM + +Step 6: Choosing Payment Method + +- Click on Add payment method. +Screenshot 2025-03-31 at 9 29 43 PM + +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. + +Screenshot 2025-03-31 at 9 30 02 PM + +- Highlight: The Reserve Bank of India (RBI) requirement for mandate approval. + +Step 7: Selecting UPI QR Code + +- Use your phone (UPI app) to make the payment after scanning the QR code. +Screenshot 2025-03-31 at 9 30 16 PM + +Step 8: Completing Welcome Form + +Screenshot 2025-03-31 at 9 30 41 PM + +The screen changes once the payment is completed and a welcome form appears after payment confirmation. + +Step 9: Verifying Credits + + Screenshot 2025-03-31 at 9 30 55 PM + +The account dashboard shows the credited USD 300 trial funds. ### Step 3: Enable Required APIs @@ -208,7 +264,7 @@ ___ The JSON key is what authenticates Glific to access your data. -## Integrate Google Cloud Storage with Glific +### Integrate Google Cloud Storage with Glific 1. Open the Glific account and click on the NGO main account button (bottom left corner), then go to Settings and select Google Cloud Storage. @@ -218,15 +274,65 @@ select Google Cloud Storage. 4. Enter the bucket name (you can find it in Google Cloud Console > Cloud Storage > Buckets). -## Integrate BigQuery API with Glific +### Integrate BigQuery API with Glific 1. Open BigQuery from the left panel in Glific. 2. Enable the active box and paste the copied JSON content into the Goth Credentials field. Click Save. -## Integrate Google Sheets API with Glific +### Integrate Google Sheets API with Glific 1. Open Google Sheets from the left panel in Glific. 2. Enable the active box and paste the copied JSON content into the Goth Credentials field. Click Save. +### What's the reason for setting the GCS bucket to public? + +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. + +This is especially useful when files need to be accessed directly through chatbot flows or shared publicly with partners and beneficiaries. +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. + +Example: + +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. +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. + +### Is it possible to keep my GCS bucket private instead of making it public? + +It's perfectly fine to keep your `GCS bucket` private as long as you don't plan to share any content publicly. + +However, if you need to send media as attachments (instead of sharing via links), the bucket would need to be public for access. + +Also, just to clarify — `BigQuery tables` and `GCS buckets` serve different purposes. + +- BigQuery tables are used to store structured data (like databases). +- GCS buckets are used to store media files such as images, audio, and documents. + +### Assign access to the Service Account in Google Console + +- Go to [Google Cloud Console](https://console.cloud.google.com) and sign in with your Gsuite account. + +![image](https://user-images.githubusercontent.com/32592458/212658353-8fed1d92-2e9d-4a9f-99c9-a359dc08698f.png) + +- Click on `IAM & Admin` and select `Service Accounts`. + +image + +image + +- Access the created `Service Account` and go to `Permissions`. + +image + +- Click on Grant Access, select `New Principal`, enter the desired email address (e.g., reporting@projecttech4dev.org), and assign the role as `Owner`. + +image + +- Click `Save`. + +### Reference Articles + +- [GCS Pricing Details](https://cloud.google.com/storage/pricing) + +- [Google Help Docs](https://cloud.google.com/storage/docs/quickstart-console)