KosmoKrator

productivity

Google Cloud Search Lua API for KosmoKrator Agents

Agent-facing Lua documentation and function reference for the Google Cloud Search KosmoKrator integration.

Lua Namespace

Agents call this integration through app.integrations.google_cloud_search.*. Use lua_read_doc("integrations.google-cloud-search") inside KosmoKrator to discover the same reference at runtime.

Call Lua from the Headless CLI

Use kosmo integrations:lua when a shell script, CI job, cron job, or another coding CLI should run a deterministic Google Cloud Search workflow without starting an interactive agent session.

Inline Lua call
kosmo integrations:lua --eval 'dump(app.integrations.google_cloud_search.operations_get({}))' --json
Read Lua docs headlessly
kosmo integrations:lua --eval 'print(docs.read("google-cloud-search"))' --json
kosmo integrations:lua --eval 'print(docs.read("google-cloud-search.operations_get"))' --json

Workflow file

Put repeatable logic in a Lua file, then execute it with JSON output for the calling process.

workflow.lua
local google_cloud_search = app.integrations.google_cloud_search
local result = google_cloud_search.operations_get({})

dump(result)
Run the workflow
kosmo integrations:lua workflow.lua --json
kosmo integrations:lua workflow.lua --force --json
Namespace note. integrations:lua exposes app.integrations.google_cloud_search, app.mcp.*, docs.*, json.*, and regex.*. Use app.integrations.google_cloud_search.default.* or app.integrations.google_cloud_search.work.* when you configured named credential accounts.

MCP-only Lua

If the script only needs configured MCP servers and does not need Google Cloud Search, use the narrower mcp:lua command.

MCP Lua command
# Use mcp:lua for MCP-only scripts; use integrations:lua for this integration namespace.
kosmo mcp:lua --eval 'dump(mcp.servers())' --json

Agent-Facing Lua Docs

This is the rendered version of the full Lua documentation exposed to agents when they inspect the integration namespace.

Google Cloud Search

Google Cloud Search tools are exposed under app.integrations.google_cloud_search. This package is generated from Google’s official Cloud Search v1 Discovery document and exposes 49 REST methods.

Use it for enterprise search and connector workflows: query search and suggestions, index data source items, manage schemas, push and poll indexing queues, configure data sources and search applications, inspect debug state, collect stats, upload media, initialize customers, and track operations.

Each method-specific tool accepts Discovery path parameters as top-level arguments, known query parameters as top-level shortcuts or inside query, and request resources inside body. Resource path parameters preserve /, so pass full names like datasources/source, datasources/source/items/item, searchapplications/app, or operations/example.

Examples

local results = app.integrations.google_cloud_search.google_cloud_search_query_search({
  body = {
    query = "quarterly report",
    pageSize = 10
  }
})

local sources = app.integrations.google_cloud_search.google_cloud_search_query_sources_list({})

local item = app.integrations.google_cloud_search.google_cloud_search_indexing_datasources_items_get({
  name = "datasources/source/items/item-id"
})

Returned data is the parsed JSON response from the Cloud Search API. Empty successful responses return { success = true, status = <http_status> }.

Cloud Search indexing and settings endpoints usually require domain-wide delegation, connector setup, and admin privileges. Prefer query/search tools for user-facing search workflows and indexing/settings tools only when the host has the required enterprise setup.

Raw agent markdown
# Google Cloud Search

Google Cloud Search tools are exposed under `app.integrations.google_cloud_search`. This package is generated from Google's official Cloud Search v1 Discovery document and exposes 49 REST methods.

Use it for enterprise search and connector workflows: query search and suggestions, index data source items, manage schemas, push and poll indexing queues, configure data sources and search applications, inspect debug state, collect stats, upload media, initialize customers, and track operations.

Each method-specific tool accepts Discovery path parameters as top-level arguments, known query parameters as top-level shortcuts or inside `query`, and request resources inside `body`. Resource path parameters preserve `/`, so pass full names like `datasources/source`, `datasources/source/items/item`, `searchapplications/app`, or `operations/example`.

## Examples

```lua
local results = app.integrations.google_cloud_search.google_cloud_search_query_search({
  body = {
    query = "quarterly report",
    pageSize = 10
  }
})

local sources = app.integrations.google_cloud_search.google_cloud_search_query_sources_list({})

local item = app.integrations.google_cloud_search.google_cloud_search_indexing_datasources_items_get({
  name = "datasources/source/items/item-id"
})
```

Returned data is the parsed JSON response from the Cloud Search API. Empty successful responses return `{ success = true, status = <http_status> }`.

Cloud Search indexing and settings endpoints usually require domain-wide delegation, connector setup, and admin privileges. Prefer query/search tools for user-facing search workflows and indexing/settings tools only when the host has the required enterprise setup.
Metadata-derived Lua example
local result = app.integrations.google_cloud_search.operations_get({})
print(result)

Functions

operations_get Read

Operations Get (GET /v1/{+name}).

Lua path
app.integrations.google_cloud_search.operations_get
Full name
google-cloud-search.google_cloud_search_operations_get
ParameterTypeRequiredDescription
No parameters.
operations_lro_list Read

Operations Lro List (GET /v1/{+name}/lro).

Lua path
app.integrations.google_cloud_search.operations_lro_list
Full name
google-cloud-search.google_cloud_search_operations_lro_list
ParameterTypeRequiredDescription
No parameters.
settings_get_customer Read

Settings Get Customer (GET /v1/settings/customer).

Lua path
app.integrations.google_cloud_search.settings_get_customer
Full name
google-cloud-search.google_cloud_search_settings_get_customer
ParameterTypeRequiredDescription
No parameters.
settings_update_customer Write

Settings Update Customer (PATCH /v1/settings/customer).

Lua path
app.integrations.google_cloud_search.settings_update_customer
Full name
google-cloud-search.google_cloud_search_settings_update_customer
ParameterTypeRequiredDescription
No parameters.
settings_searchapplications_update Write

Settings Searchapplications Update (PUT /v1/settings/{+name}).

Lua path
app.integrations.google_cloud_search.settings_searchapplications_update
Full name
google-cloud-search.google_cloud_search_settings_searchapplications_update
ParameterTypeRequiredDescription
No parameters.
settings_searchapplications_patch Write

Settings Searchapplications Patch (PATCH /v1/settings/{+name}).

Lua path
app.integrations.google_cloud_search.settings_searchapplications_patch
Full name
google-cloud-search.google_cloud_search_settings_searchapplications_patch
ParameterTypeRequiredDescription
No parameters.
settings_searchapplications_delete Write

Settings Searchapplications Delete (DELETE /v1/settings/{+name}).

Lua path
app.integrations.google_cloud_search.settings_searchapplications_delete
Full name
google-cloud-search.google_cloud_search_settings_searchapplications_delete
ParameterTypeRequiredDescription
No parameters.
settings_searchapplications_create Write

Settings Searchapplications Create (POST /v1/settings/searchapplications).

Lua path
app.integrations.google_cloud_search.settings_searchapplications_create
Full name
google-cloud-search.google_cloud_search_settings_searchapplications_create
ParameterTypeRequiredDescription
No parameters.
settings_searchapplications_list Read

Settings Searchapplications List (GET /v1/settings/searchapplications).

Lua path
app.integrations.google_cloud_search.settings_searchapplications_list
Full name
google-cloud-search.google_cloud_search_settings_searchapplications_list
ParameterTypeRequiredDescription
No parameters.
settings_searchapplications_get Read

Settings Searchapplications Get (GET /v1/settings/{+name}).

Lua path
app.integrations.google_cloud_search.settings_searchapplications_get
Full name
google-cloud-search.google_cloud_search_settings_searchapplications_get
ParameterTypeRequiredDescription
No parameters.
settings_searchapplications_reset Write

Settings Searchapplications Reset (POST /v1/settings/{+name}:reset).

Lua path
app.integrations.google_cloud_search.settings_searchapplications_reset
Full name
google-cloud-search.google_cloud_search_settings_searchapplications_reset
ParameterTypeRequiredDescription
No parameters.
settings_datasources_delete Write

Settings Datasources Delete (DELETE /v1/settings/{+name}).

Lua path
app.integrations.google_cloud_search.settings_datasources_delete
Full name
google-cloud-search.google_cloud_search_settings_datasources_delete
ParameterTypeRequiredDescription
No parameters.
settings_datasources_patch Write

Settings Datasources Patch (PATCH /v1/settings/{+name}).

Lua path
app.integrations.google_cloud_search.settings_datasources_patch
Full name
google-cloud-search.google_cloud_search_settings_datasources_patch
ParameterTypeRequiredDescription
No parameters.
settings_datasources_update Write

Settings Datasources Update (PUT /v1/settings/{+name}).

Lua path
app.integrations.google_cloud_search.settings_datasources_update
Full name
google-cloud-search.google_cloud_search_settings_datasources_update
ParameterTypeRequiredDescription
No parameters.
settings_datasources_create Write

Settings Datasources Create (POST /v1/settings/datasources).

Lua path
app.integrations.google_cloud_search.settings_datasources_create
Full name
google-cloud-search.google_cloud_search_settings_datasources_create
ParameterTypeRequiredDescription
No parameters.
settings_datasources_get Read

Settings Datasources Get (GET /v1/settings/{+name}).

Lua path
app.integrations.google_cloud_search.settings_datasources_get
Full name
google-cloud-search.google_cloud_search_settings_datasources_get
ParameterTypeRequiredDescription
No parameters.
settings_datasources_list Read

Settings Datasources List (GET /v1/settings/datasources).

Lua path
app.integrations.google_cloud_search.settings_datasources_list
Full name
google-cloud-search.google_cloud_search_settings_datasources_list
ParameterTypeRequiredDescription
No parameters.
debug_identitysources_unmappedids_list Read

Debug Identitysources Unmappedids List (GET /v1/debug/{+parent}/unmappedids).

Lua path
app.integrations.google_cloud_search.debug_identitysources_unmappedids_list
Full name
google-cloud-search.google_cloud_search_debug_identitysources_unmappedids_list
ParameterTypeRequiredDescription
No parameters.
debug_identitysources_items_list_forunmappedidentity Read

Debug Identitysources Items List Forunmappedidentity (GET /v1/debug/{+parent}/items:forunmappedidentity).

Lua path
app.integrations.google_cloud_search.debug_identitysources_items_list_forunmappedidentity
Full name
google-cloud-search.google_cloud_search_debug_identitysources_items_list_forunmappedidentity
ParameterTypeRequiredDescription
No parameters.
debug_datasources_items_check_access Write

Debug Datasources Items Check Access (POST /v1/debug/{+name}:checkAccess).

Lua path
app.integrations.google_cloud_search.debug_datasources_items_check_access
Full name
google-cloud-search.google_cloud_search_debug_datasources_items_check_access
ParameterTypeRequiredDescription
No parameters.
debug_datasources_items_by_view_url Write

Debug Datasources Items Search By View Url (POST /v1/debug/{+name}/items:searchByViewUrl).

Lua path
app.integrations.google_cloud_search.debug_datasources_items_by_view_url
Full name
google-cloud-search.google_cloud_search_debug_datasources_items_search_by_view_url
ParameterTypeRequiredDescription
No parameters.
debug_datasources_items_unmappedids_list Read

Debug Datasources Items Unmappedids List (GET /v1/debug/{+parent}/unmappedids).

Lua path
app.integrations.google_cloud_search.debug_datasources_items_unmappedids_list
Full name
google-cloud-search.google_cloud_search_debug_datasources_items_unmappedids_list
ParameterTypeRequiredDescription
No parameters.
indexing_datasources_delete_schema Write

Indexing Datasources Delete Schema (DELETE /v1/indexing/{+name}/schema).

Lua path
app.integrations.google_cloud_search.indexing_datasources_delete_schema
Full name
google-cloud-search.google_cloud_search_indexing_datasources_delete_schema
ParameterTypeRequiredDescription
No parameters.
indexing_datasources_get_schema Read

Indexing Datasources Get Schema (GET /v1/indexing/{+name}/schema).

Lua path
app.integrations.google_cloud_search.indexing_datasources_get_schema
Full name
google-cloud-search.google_cloud_search_indexing_datasources_get_schema
ParameterTypeRequiredDescription
No parameters.
indexing_datasources_update_schema Write

Indexing Datasources Update Schema (PUT /v1/indexing/{+name}/schema).

Lua path
app.integrations.google_cloud_search.indexing_datasources_update_schema
Full name
google-cloud-search.google_cloud_search_indexing_datasources_update_schema
ParameterTypeRequiredDescription
No parameters.
indexing_datasources_items_delete Write

Indexing Datasources Items Delete (DELETE /v1/indexing/{+name}).

Lua path
app.integrations.google_cloud_search.indexing_datasources_items_delete
Full name
google-cloud-search.google_cloud_search_indexing_datasources_items_delete
ParameterTypeRequiredDescription
No parameters.
indexing_datasources_items_index Write

Indexing Datasources Items Index (POST /v1/indexing/{+name}:index).

Lua path
app.integrations.google_cloud_search.indexing_datasources_items_index
Full name
google-cloud-search.google_cloud_search_indexing_datasources_items_index
ParameterTypeRequiredDescription
No parameters.
indexing_datasources_items_unreserve Write

Indexing Datasources Items Unreserve (POST /v1/indexing/{+name}/items:unreserve).

Lua path
app.integrations.google_cloud_search.indexing_datasources_items_unreserve
Full name
google-cloud-search.google_cloud_search_indexing_datasources_items_unreserve
ParameterTypeRequiredDescription
No parameters.
indexing_datasources_items_poll Write

Indexing Datasources Items Poll (POST /v1/indexing/{+name}/items:poll).

Lua path
app.integrations.google_cloud_search.indexing_datasources_items_poll
Full name
google-cloud-search.google_cloud_search_indexing_datasources_items_poll
ParameterTypeRequiredDescription
No parameters.
indexing_datasources_items_push Write

Indexing Datasources Items Push (POST /v1/indexing/{+name}:push).

Lua path
app.integrations.google_cloud_search.indexing_datasources_items_push
Full name
google-cloud-search.google_cloud_search_indexing_datasources_items_push
ParameterTypeRequiredDescription
No parameters.
indexing_datasources_items_delete_queue_items Write

Indexing Datasources Items Delete Queue Items (POST /v1/indexing/{+name}/items:deleteQueueItems).

Lua path
app.integrations.google_cloud_search.indexing_datasources_items_delete_queue_items
Full name
google-cloud-search.google_cloud_search_indexing_datasources_items_delete_queue_items
ParameterTypeRequiredDescription
No parameters.
indexing_datasources_items_get Read

Indexing Datasources Items Get (GET /v1/indexing/{+name}).

Lua path
app.integrations.google_cloud_search.indexing_datasources_items_get
Full name
google-cloud-search.google_cloud_search_indexing_datasources_items_get
ParameterTypeRequiredDescription
No parameters.
indexing_datasources_items_list Read

Indexing Datasources Items List (GET /v1/indexing/{+name}/items).

Lua path
app.integrations.google_cloud_search.indexing_datasources_items_list
Full name
google-cloud-search.google_cloud_search_indexing_datasources_items_list
ParameterTypeRequiredDescription
No parameters.
indexing_datasources_items_upload Write

Indexing Datasources Items Upload (POST /v1/indexing/{+name}:upload).

Lua path
app.integrations.google_cloud_search.indexing_datasources_items_upload
Full name
google-cloud-search.google_cloud_search_indexing_datasources_items_upload
ParameterTypeRequiredDescription
No parameters.
media_upload Write

Media Upload (POST /v1/media/{+resourceName}).

Lua path
app.integrations.google_cloud_search.media_upload
Full name
google-cloud-search.google_cloud_search_media_upload
ParameterTypeRequiredDescription
No parameters.
v1_initialize_customer Write

V1 Initialize Customer (POST /v1:initializeCustomer).

Lua path
app.integrations.google_cloud_search.v1_initialize_customer
Full name
google-cloud-search.google_cloud_search_v1_initialize_customer
ParameterTypeRequiredDescription
No parameters.
query_suggest Write

Query Suggest (POST /v1/query/suggest).

Lua path
app.integrations.google_cloud_search.query_suggest
Full name
google-cloud-search.google_cloud_search_query_suggest
ParameterTypeRequiredDescription
No parameters.
query Write

Query Search (POST /v1/query/search).

Lua path
app.integrations.google_cloud_search.query
Full name
google-cloud-search.google_cloud_search_query_search
ParameterTypeRequiredDescription
No parameters.
query_remove_activity Write

Query Remove Activity (POST /v1/query:removeActivity).

Lua path
app.integrations.google_cloud_search.query_remove_activity
Full name
google-cloud-search.google_cloud_search_query_remove_activity
ParameterTypeRequiredDescription
No parameters.
query_sources_list Read

Query Sources List (GET /v1/query/sources).

Lua path
app.integrations.google_cloud_search.query_sources_list
Full name
google-cloud-search.google_cloud_search_query_sources_list
ParameterTypeRequiredDescription
No parameters.
stats_get_user Read

Stats Get User (GET /v1/stats/user).

Lua path
app.integrations.google_cloud_search.stats_get_user
Full name
google-cloud-search.google_cloud_search_stats_get_user
ParameterTypeRequiredDescription
No parameters.
stats_get_searchapplication Read

Stats Get Searchapplication (GET /v1/stats/searchapplication).

Lua path
app.integrations.google_cloud_search.stats_get_searchapplication
Full name
google-cloud-search.google_cloud_search_stats_get_searchapplication
ParameterTypeRequiredDescription
No parameters.
stats_get_index Read

Stats Get Index (GET /v1/stats/index).

Lua path
app.integrations.google_cloud_search.stats_get_index
Full name
google-cloud-search.google_cloud_search_stats_get_index
ParameterTypeRequiredDescription
No parameters.
stats_get_query Read

Stats Get Query (GET /v1/stats/query).

Lua path
app.integrations.google_cloud_search.stats_get_query
Full name
google-cloud-search.google_cloud_search_stats_get_query
ParameterTypeRequiredDescription
No parameters.
stats_get_session Read

Stats Get Session (GET /v1/stats/session).

Lua path
app.integrations.google_cloud_search.stats_get_session
Full name
google-cloud-search.google_cloud_search_stats_get_session
ParameterTypeRequiredDescription
No parameters.
stats_user_searchapplications_get Read

Stats User Searchapplications Get (GET /v1/stats/user/{+name}).

Lua path
app.integrations.google_cloud_search.stats_user_searchapplications_get
Full name
google-cloud-search.google_cloud_search_stats_user_searchapplications_get
ParameterTypeRequiredDescription
No parameters.
stats_query_searchapplications_get Read

Stats Query Searchapplications Get (GET /v1/stats/query/{+name}).

Lua path
app.integrations.google_cloud_search.stats_query_searchapplications_get
Full name
google-cloud-search.google_cloud_search_stats_query_searchapplications_get
ParameterTypeRequiredDescription
No parameters.
stats_index_datasources_get Read

Stats Index Datasources Get (GET /v1/stats/index/{+name}).

Lua path
app.integrations.google_cloud_search.stats_index_datasources_get
Full name
google-cloud-search.google_cloud_search_stats_index_datasources_get
ParameterTypeRequiredDescription
No parameters.
stats_session_searchapplications_get Read

Stats Session Searchapplications Get (GET /v1/stats/session/{+name}).

Lua path
app.integrations.google_cloud_search.stats_session_searchapplications_get
Full name
google-cloud-search.google_cloud_search_stats_session_searchapplications_get
ParameterTypeRequiredDescription
No parameters.