User Guide for the Google Safe Browsing Plugin
This guide is designed for users who are installing and using the Google Safe Browsing plugin for the first time in your Bubble app. The plugin helps you check the safety of URLs in real-time, categorizing them into three modern threat classifications: Clean, Risky, and Dangerous.

Plugin Overview

The Google Safe Browsing Plugin checks if a given URL is safe to visit by referencing Google's Safe Browsing database. It detects URLs that may contain:

Malware: Harmful software intended to damage or disrupt devices.
Social Engineering: Deceptive tactics to manipulate users into revealing personal information.
Potentially Unwanted Software: Programs that might not be harmful but can create an unwanted user experience.
Abusive Experience: Websites that use manipulative tactics (e.g., aggressive ads, misleading pages).

The plugin classifies URLs into three categories:
1. Clean: The URL is free from known threats and is safe to visit.
2. Risky: The URL may contain potentially unwanted software or other mild issues.
3. Dangerous: The URL contains high-severity threats like malware or phishing attempts.

Installation Instructions

1. Install the Plugin:
  - Go to the Plugin tab in your Bubble app.
  - Search for "Google Safe Browsing" and click Install.

2. API Key Setup:
  - After installation, navigate to the plugin settings.
  - You will need to enter a Google API Key to authenticate the requests to Google Safe Browsing API.
  - To get your API Key, visit the Google Cloud Console:
    1. Create a new project (or use an existing one).
    2. Enable the Google Safe Browsing API.
    3. Create an API key under the Credentials tab and copy it.

3. Configure the Plugin:
  - Once you have the API Key, paste it in the API Key field of the plugin settings in Bubble.
  - This API key will be used for all URL checks in your app.

How to Use the Plugin in Your Bubble Workflow

1. Create Input Fields for URL:
  - Add an Input field where the user can enter a URL they want to check.
 
2. Set Up a Button to Trigger the URL Check:
  - Add a Button that the user can click to check the URL.
 
3. Create a Workflow for URL Safety Check:
  - In your Workflow tab, create an action that calls the Google Safe Browsing Plugin's "Check Safe Browsing" action.
  - Set the URL to be the value entered in the Input field (e.g., Input URL's value).
  - Set the API Key to be the key you entered in the plugin settings.

4. Display the Result:
  - Add a Text element to display the result of the URL check (i.e., "Clean", "Risky", or "Dangerous").
  - In the Workflow, after the URL is checked, update the Text element with the result from the plugin's response.

Plugin Action Breakdown

The plugin offers a single action: "Check Safe Browsing".

Parameters:
1. API Key: Your Google API key (this must be set in the plugin settings).
2. URL: The URL you want to check for safety.

Outputs:
1. Safety Status: The classification of the URL's safety.
  - Clean: No threats detected, the URL is safe.
  - Risky: The URL may contain unwanted software or abusive experience.
  - Dangerous: The URL contains high-severity threats like malware or phishing.
2. Threat Type: Detailed description of the type of threat if the URL is flagged.

Example Workflow (Step-by-Step)

1. Create Input Field:
  - Drag an Input element onto your page where users can type in a URL (e.g., "Enter URL").
 
2. Create Button:
  - Add a Button (e.g., "Check URL").

3. Add Workflow for Button:
  - Go to the Workflow tab.
  - Select the Button as the trigger.
  - Add an action: Plugins > Google Safe Browsing > Check Safe Browsing.
  - Set the URL to the value of the Input field (e.g., Input URL's value).
  - Set the API Key to the key you generated in the plugin settings.

4. Display the Result:
  - Add a Text element (e.g., "Safety Status").
  - After the action runs, update the Text element with the result (use a condition like When Result is Safe to show appropriate text).

Plugin Description for Users

Google Safe Browsing helps ensure that the URLs entered into your application are safe to visit. This plugin checks URLs against Google’s Safe Browsing database to detect potential threats like malware, phishing, or unwanted software.

With this plugin, you can classify URLs into:
1. Clean: The URL is safe to visit.
2. Risky: The URL may be harmful, but the threat is not severe.
3. Dangerous: The URL is unsafe and should be avoided, with threats like malware or phishing.

This plugin is designed to help safeguard users and ensure they’re not visiting malicious websites.

Troubleshooting Tips

1. Invalid API Key: If you're seeing errors related to the API key, ensure that it is correctly entered in the plugin settings and that the Google Safe Browsing API is enabled in your Google Cloud Console.
2. Empty Response: If the plugin returns no results, check the URL format or ensure that the Google Safe Browsing API is correctly responding to requests.
3. Slow Response Times: Google’s API may experience delays during high traffic periods. You may need to retry the request or implement a loading indicator in your app.