Google Cloud Storage Enhanced icon

Google Cloud Storage Enhanced

Use the Google Cloud Storage API

Overview

The Google Cloud Storage Enhanced node for n8n allows you to interact with Google Cloud Storage buckets. Specifically, the Bucket → Get operation retrieves metadata and configuration details about a specified storage bucket. This is useful for automation scenarios where you need to inspect or verify bucket properties, such as in backup workflows, compliance checks, or dynamic infrastructure management.

Example use cases:

  • Fetching bucket settings before performing data operations.
  • Auditing bucket configurations across multiple projects.
  • Integrating bucket metadata into reporting or monitoring flows.

Properties

Name Type Meaning
Authentication options Selects the authentication method: Service Account or OAuth2.
Bucket Name string The name of the Google Cloud Storage bucket to retrieve information from.
Projection options Determines which set of properties to return: "All Properties" (full) or "No ACL" (noAcl).
Filters collection Optional filters to refine the request. Includes:
• Metageneration Match (number): Only return data if the metageneration value matches.
• Metageneration Exclude (number): Only return data if the metageneration value does not match.

Output

The output is a JSON object containing the metadata and configuration of the specified bucket. Typical fields include:

{
  "kind": "storage#bucket",
  "id": "your-bucket-name",
  "selfLink": "https://www.googleapis.com/storage/v1/b/your-bucket-name",
  "projectNumber": "1234567890",
  "name": "your-bucket-name",
  "location": "US",
  "storageClass": "STANDARD",
  "etag": "CAE=",
  // ...additional bucket properties depending on projection
}
  • If Projection is set to "All Properties", more detailed information (including ACLs) will be included.
  • If Projection is set to "No ACL", access control lists are omitted.

Note: No binary data is returned by this operation.


Dependencies

  • Google Cloud Platform account with appropriate permissions to access the target bucket.
  • Authentication: Requires either a Service Account credential or OAuth2 setup in n8n.
  • n8n credentials: You must configure either "googleApi" (Service Account) or "googleCloudStorageOAuth2Api" (OAuth2) credentials in your n8n instance.

Troubleshooting

Common issues:

  • Invalid Credentials: If authentication fails, ensure your credentials are correctly configured and have sufficient permissions.
  • Bucket Not Found: If the specified bucket does not exist or is misspelled, you'll receive a "Not Found" error.
  • Permission Denied: If your service account or OAuth2 user lacks permission to view the bucket, an error will be thrown.
  • Metageneration Mismatch: If using metageneration filters, ensure the provided values match the current state of the bucket.

Error messages and resolutions:

  • "Error: Request had insufficient authentication scopes": Update your credentials to include the correct scopes.
  • "Error: Not Found": Double-check the bucket name.
  • "Error: Permission denied": Verify IAM roles and permissions for the authenticated user/service account.

Links and References

Discussion