Skip to content
OmniscapeRenders API
All pages
  1. Overview
  2. Quick start
  3. Authentication
  4. API reference
    1. GET /media
    2. POST /media
    3. GET /media/{id}/preview
    4. GET /integrations/google/connect
    5. GET /integrations/google
    6. DELETE /integrations/google
    7. GET /integrations/google/folders
    8. POST /media/import
    9. GET /media/imports/{id}
    10. POST /renders
    11. GET /renders/{id}
    12. GET /renders/{id}/download
    13. GET /usage
  5. Code examples
  6. Error handling
  7. Rate limits & quotas
  8. Troubleshooting
  9. Changelog

Reference

GET

/api/v1/integrations/google/folders

Requires the media:read scope.

List the sub-folders of a Drive folder, so you can find the folder_id to import from.

Query parameters

NameTypeRequiredNotes
parentstringnoA Drive folder id, or 'root' (the default) for the top level.
cursorstringnoThe next_cursor from a previous page.

Request

curl -s "https://omniscape.io/api/v1/integrations/google/folders?parent=root" \
  -H "Authorization: Bearer $OMNISCAPE_API_KEY"

Response

{
  "object": "list",
  "data": [ { "id": "1AbC...", "name": "Campaign Photos" } ],
  "has_more": false,
  "next_cursor": null
}

Notes

  • Reads only from Google, over your connection. If you are not connected this is 409 integration_not_connected.
  • A browse helper — you can also paste a folder id you already have straight into the import call.

Codes this call can return are on Error handling. If something is behaving unexpectedly, Troubleshooting is organised by symptom.