Object → Get Many
AI-generatedOverview
This node interacts with Google Cloud Storage to manage objects within storage buckets. Specifically, the "Get Many" operation for the "Object" resource retrieves multiple objects from a specified bucket. It supports filtering and pagination options to control which objects are returned and how many.
Common scenarios where this node is useful include:
- Listing all files or objects stored in a particular Google Cloud Storage bucket.
- Retrieving subsets of objects based on prefixes or delimiters to simulate directory-like structures.
- Fetching object metadata without downloading the actual content.
- Managing large sets of objects by paginating through results or limiting the number of returned items.
Practical example: You want to list all images stored under a specific folder (prefix) in your bucket to process or display them in an application. Using this node, you can specify the bucket name and prefix filter to get only those objects.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method of authentication to use: either "Service Account" or "OAuth2". |
| Bucket Name | The name of the Google Cloud Storage bucket from which to retrieve objects. This is required. |
| Projection | Determines the set of properties returned for each object. Options: - "All Properties": returns full metadata including ACLs. - "No ACL": excludes access control lists from the response. |
| Return All | Boolean flag indicating whether to return all matching objects or limit the number of results. |
| Limit | Maximum number of objects to return if "Return All" is false. Value between 1 and 1000. |
| Additional Parameters | Collection of optional filters and parameters to refine the listing: - Delimiter: character used to group objects like directories (default "/"). - End Offset: filter to names lexicographically before this value. - Include Trailing Delimiter: if true, objects will have exactly one delimiter at the end. - Prefix: filter to names starting with this value. - Start Offset: filter to names lexicographically equal or after this value. - Versions: if true, list all versions of objects as distinct entries. |
Output
The output is a JSON array where each item represents an object retrieved from the specified bucket. Each object includes metadata fields such as:
- Object name
- Bucket name
- Content type
- Size
- Creation and update timestamps
- Metadata and ACL information depending on the projection setting
If the node is configured to fetch binary data (not applicable for "Get Many" operation), it would provide binary streams representing the object contents. However, for this operation, only metadata listings are returned.
Dependencies
- Requires valid Google Cloud Storage API credentials, either via a service account or OAuth2 authentication.
- The node depends on n8n's internal helper functions to make authenticated requests to Google Cloud Storage REST endpoints.
- Proper permissions on the Google Cloud project and bucket are necessary to list objects.
Troubleshooting
- Authentication errors: Ensure that the provided credentials have sufficient permissions to access the bucket and list objects.
- Bucket not found or access denied: Verify the bucket name is correct and accessible by the authenticated user.
- Empty results: Check filters such as prefix, startOffset, and endOffset; overly restrictive filters may yield no objects.
- Limit exceeded: If requesting too many objects without enabling "Return All", the node limits results to the specified maximum.
- API quota limits: Frequent or large requests might hit Google Cloud Storage API quotas; consider adding delays or reducing request sizes.