Actions23
- Spreadsheet Actions
- Sheet Filter Actions
- Sheet Filter View Actions
- Filter Condition Filter View Actions
- Sheet Row Column Actions
- Sheet Data Actions
- Sheet Floating Image Actions
Overview
The node interacts with Lark Sheets, specifically enabling management and querying of floating images within a sheet. The "Query Floating Images" operation under the "Sheet Floating Image" resource allows users to retrieve information about floating images present in a specified sheet of a spreadsheet.
This node is beneficial when you need to programmatically access metadata or details about floating images embedded in sheets, such as for auditing, reporting, or further automated processing. For example, a user might want to list all floating images in a particular sheet to generate a report on visual content usage or to synchronize image data with another system.
Properties
Name | Meaning |
---|---|
Authentication | Method of authentication to use: either "Tenant Token" (an API key credential) or "OAuth2". |
Spreadsheet Token | The unique token identifying the target spreadsheet from which to query floating images. |
Sheet Id | The identifier of the specific sheet within the spreadsheet where floating images are queried. |
Options > Use Custom Body | Boolean flag indicating whether to send a custom request body instead of default parameters. |
Output
The node outputs JSON data containing details about the floating images found in the specified sheet. This typically includes metadata such as image IDs, positions, sizes, and possibly URLs or references to the actual image content.
If the node supports binary data output (not explicitly shown here), it would represent the actual image files or related binary content associated with the floating images.
Dependencies
- Requires an active connection to the Lark Suite API.
- Needs either a Tenant Token or OAuth2 credentials configured in n8n for authentication.
- The base URL for API requests is
https://open.larksuite.com/open-apis
. - Proper permissions on the spreadsheet and sheet to read floating image data.
Troubleshooting
- Authentication errors: Ensure that the selected authentication method is correctly configured with valid credentials. Expired or invalid tokens will cause failures.
- Invalid Spreadsheet Token or Sheet Id: Double-check that the provided tokens and IDs correspond to existing and accessible spreadsheets and sheets.
- API rate limits or connectivity issues: Network problems or hitting API rate limits may cause request failures; retry after some time or verify network settings.
- Use Custom Body option misuse: If enabled without proper formatting, the custom body may cause API errors. Validate the custom body structure if this option is used.