Google Developer Knowledge

#!/usr/bin/env bash
# Batch get documents from Google Developer Documentation using the Developer Knowledge API

set -e

# Check for API key
if [ -z "$DEVELOPERKNOWLEDGE_API_KEY" ]; then
    echo "============================================================"
    echo "AGENT ERROR: Missing Developer Knowledge API key!"
    echo "============================================================"
    echo ""
    echo "To use the Developer Knowledge API, the user must:"
    echo ""
    echo "1. Enable the Developer Knowledge API in Google Cloud:"
    echo "   https://console.cloud.google.com/apis/library/developerknowledge.googleapis.com"
    echo ""
    echo "2. Create an API key restricted to Developer Knowledge API:"
    echo "   https://console.cloud.google.com/apis/credentials"
    echo ""
    echo "3. Add to .env file:"
    echo "   DEVELOPERKNOWLEDGE_API_KEY=<your-api-key>"
    echo ""
    echo "Please ask the user to configure their API key before retrying."
    echo "============================================================"
    exit 1
fi

OUTPUT=""
NAMES=()

# Parse arguments
while [[ $# -gt 0 ]]; do
    case $1 in
        --output)
            OUTPUT="$2"
            shift 2
            ;;
        -h|--help)
            echo "Usage: batch_get_documents.sh <name1> [name2] ... [--output DIR]"
            echo ""
            echo "Batch get documents from Google Developer Documentation."
            echo ""
            echo "Arguments:"
            echo "  names     Document names (up to 20)"
            echo "  --output  Save documents to directory"
            exit 0
            ;;
        *)
            NAMES+=("$1")
            shift
            ;;
    esac
done

if [ ${#NAMES[@]} -eq 0 ]; then
    echo "Error: At least one document name is required"
    echo "Usage: batch_get_documents.sh <name1> [name2] ... [--output DIR]"
    exit 1
fi

if [ ${#NAMES[@]} -gt 20 ]; then
    echo "Error: Maximum 20 documents can be retrieved in a batch"
    exit 1
fi

# Build URL with names parameters
URL="https://developerknowledge.googleapis.com/v1alpha/documents:batchGet?key=$DEVELOPERKNOWLEDGE_API_KEY"

for name in "${NAMES[@]}"; do
    # Ensure name starts with documents/
    if [[ ! "$name" == documents/* ]]; then
        name="documents/$name"
    fi
    URL="${URL}&names=$name"
done

# Make request
RESPONSE=$(curl -s "$URL")

if [ -n "$OUTPUT" ]; then
    mkdir -p "$OUTPUT"
    echo "$RESPONSE" > "$OUTPUT/batch_result.json"
    echo "Results saved to $OUTPUT/batch_result.json"
else
    echo "$RESPONSE"
fi

#!/usr/bin/env bash
# Get a document from Google Developer Documentation using the Developer Knowledge API

set -e

# Check for API key
if [ -z "$DEVELOPERKNOWLEDGE_API_KEY" ]; then
    echo "============================================================"
    echo "AGENT ERROR: Missing Developer Knowledge API key!"
    echo "============================================================"
    echo ""
    echo "To use the Developer Knowledge API, the user must:"
    echo ""
    echo "1. Enable the Developer Knowledge API in Google Cloud:"
    echo "   https://console.cloud.google.com/apis/library/developerknowledge.googleapis.com"
    echo ""
    echo "2. Create an API key restricted to Developer Knowledge API:"
    echo "   https://console.cloud.google.com/apis/credentials"
    echo ""
    echo "3. Add to .env file:"
    echo "   DEVELOPERKNOWLEDGE_API_KEY=<your-api-key>"
    echo ""
    echo "Please ask the user to configure their API key before retrying."
    echo "============================================================"
    exit 1
fi

OUTPUT=""

# Parse arguments
while [[ $# -gt 0 ]]; do
    case $1 in
        --output)
            OUTPUT="$2"
            shift 2
            ;;
        -h|--help)
            echo "Usage: get_document.sh <document-name> [--output FILE]"
            echo ""
            echo "Get a document from Google Developer Documentation."
            echo ""
            echo "Arguments:"
            echo "  document-name  Document name (e.g., documents/ai.google.dev/gemini-api/docs/get-started/python)"
            echo "  --output       Save content to file"
            exit 0
            ;;
        *)
            DOC_NAME="$1"
            shift
            ;;
    esac
done

if [ -z "$DOC_NAME" ]; then
    echo "Error: Document name is required"
    echo "Usage: get_document.sh <document-name> [--output FILE]"
    exit 1
fi

# Ensure name starts with documents/
if [[ ! "$DOC_NAME" == documents/* ]]; then
    DOC_NAME="documents/$DOC_NAME"
fi

# Make request
URL="https://developerknowledge.googleapis.com/v1alpha/$DOC_NAME?key=$DEVELOPERKNOWLEDGE_API_KEY"
RESPONSE=$(curl -s "$URL")

if [ -n "$OUTPUT" ]; then
    echo "$RESPONSE" > "$OUTPUT"
    echo "Document saved to $OUTPUT"
else
    echo "$RESPONSE"
fi

#!/usr/bin/env bash
# Search Google Developer Documentation using the Developer Knowledge API

set -e

# Check for API key
if [ -z "$DEVELOPERKNOWLEDGE_API_KEY" ]; then
    echo "============================================================"
    echo "AGENT ERROR: Missing Developer Knowledge API key!"
    echo "============================================================"
    echo ""
    echo "To use the Developer Knowledge API, the user must:"
    echo ""
    echo "1. Enable the Developer Knowledge API in Google Cloud:"
    echo "   https://console.cloud.google.com/apis/library/developerknowledge.googleapis.com"
    echo ""
    echo "2. Create an API key restricted to Developer Knowledge API:"
    echo "   https://console.cloud.google.com/apis/credentials"
    echo ""
    echo "3. Add to .env file:"
    echo "   DEVELOPERKNOWLEDGE_API_KEY=<your-api-key>"
    echo ""
    echo "Please ask the user to configure their API key before retrying."
    echo "============================================================"
    exit 1
fi

# Defaults
PAGE_SIZE=5
PAGE_TOKEN=""
OUTPUT=""

# Parse arguments
while [[ $# -gt 0 ]]; do
    case $1 in
        --page-size)
            PAGE_SIZE="$2"
            shift 2
            ;;
        --page-token)
            PAGE_TOKEN="$2"
            shift 2
            ;;
        --output)
            OUTPUT="$2"
            shift 2
            ;;
        -h|--help)
            echo "Usage: search_docs.sh <query> [--page-size N] [--page-token TOKEN] [--output FILE]"
            echo ""
            echo "Search Google Developer Documentation."
            echo ""
            echo "Arguments:"
            echo "  query         The search query"
            echo "  --page-size   Number of results (1-20, default: 5)"
            echo "  --page-token  Token for next page of results"
            echo "  --output      Save results to JSON file"
            exit 0
            ;;
        *)
            QUERY="$1"
            shift
            ;;
    esac
done

if [ -z "$QUERY" ]; then
    echo "Error: Query is required"
    echo "Usage: search_docs.sh <query> [--page-size N] [--page-token TOKEN] [--output FILE]"
    exit 1
fi

# Build URL
URL="https://developerknowledge.googleapis.com/v1alpha/documents:searchDocumentChunks?query=$(echo "$QUERY" | sed 's/ /%20/g')&pageSize=$PAGE_SIZE&key=$DEVELOPERKNOWLEDGE_API_KEY"

if [ -n "$PAGE_TOKEN" ]; then
    URL="${URL}&pageToken=$PAGE_TOKEN"
fi

# Make request
RESPONSE=$(curl -s "$URL")

if [ -n "$OUTPUT" ]; then
    echo "$RESPONSE" > "$OUTPUT"
    echo "Results saved to $OUTPUT"
else
    echo "$RESPONSE"
fi