Eliminar todos los comentarios de la hoja de cálculo

Versión de la API: v3.0
Recurso: Worksheets → DeleteWorksheetComments

Aspose.Cells Cloud proporciona un endpoint REST robusto que elimina todos los comentarios de una hoja de cálculo especificada. Esta operación es irreversible; una vez ejecutada, los comentarios no se pueden recuperar.

Requisitos previos

Requisito Detalles
Autenticación Se requiere un token JWT válido en el encabezado Authorization (Bearer <jwt token>). Obtenga el token mediante el flujo de autenticación OAuth2.
Almacenamiento El archivo debe residir en un almacenamiento al que Aspose.Cells Cloud tenga acceso (se utiliza el almacenamiento predeterminado si se omite storageName).
Permisos El token debe tener permisos para leer y escribir el archivo de destino.
SDK (opcional) Disponemos de SDK para .NET, Java, PHP, Ruby, Node.js, Python, Perl y Go (consulte la sección Ejemplos de SDK).

Solicitud HTTP

Endpoint

DELETE https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/comments

Parámetros de ruta

Nombre Tipo Descripción
name string Nombre del archivo de Excel (por ejemplo, test.xlsx).
sheetName string Nombre de la hoja de cálculo (por ejemplo, Sheet1).

Parámetros de consulta

Nombre Tipo Obligatorio Descripción
folder string opcional Ruta a la carpeta que contiene el archivo.
storageName string opcional Nombre del almacenamiento donde se encuentra el archivo.

Encabezados de solicitud

Encabezado Valor
Authorization Bearer <jwt token>
Accept application/json
Content-Type application/json

Ejemplo de solicitud (cURL)

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/comments?folder=Documents&storageName=MyStorage" \
  -X DELETE \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <jwt token>"

Reemplace test.xlsx, Sheet1, Documents, MyStorage y <jwt token> con sus valores reales.

Respuesta

Éxito (200)

{
  "Code": 200,
  "Status": "OK"
}

El cuerpo de la respuesta sigue el modelo CellsCloudResponse.

Respuestas de error

Código HTTP Significado Cuerpo de ejemplo
400 Solicitud incorrecta: parámetros no válidos. { "Code": 400, "Message": "Invalid request." }
401 No autorizado: token JWT ausente o inválido. { "Code": 401, "Message": "Authentication failed." }
404 No encontrado: el archivo o la hoja de cálculo no existe. { "Code": 404, "Message": "Resource not found." }
500 Error interno del servidor. { "Code": 500, "Message": "Server error." }

Ejemplos de SDK

Los fragmentos siguientes muestran cómo llamar al endpoint utilizando los SDK oficiales de Aspose.Cells Cloud (versión 3.13.0). Reemplace los valores de marcador de posición (<fileName>, <sheet>, <jwt token>, etc.) con sus propios datos.

C#

using Aspose.Cells.Cloud.SDK.Api;
using Aspose.Cells.Cloud.SDK.Model;

var apiInstance = new WorksheetsApi();
var name = "test.xlsx"; // string | El nombre del archivo.
var sheetName = "Sheet1"; // string | El nombre de la hoja de cálculo.
var folder = "Documents"; // string | Ruta de la carpeta (opcional)
var storageName = "MyStorage"; // string | Nombre del almacenamiento (opcional)

try
{
    var response = apiInstance.DeleteWorksheetComments(name, sheetName, folder, storageName);
    Console.WriteLine(response.Status);
}
catch (Exception e)
{
    Console.WriteLine("Excepción al llamar a WorksheetsApi.DeleteWorksheetComments: " + e.Message );
}

Java

import com.aspose.cells.cloud.sdk.api.WorksheetsApi;
import com.aspose.cells.cloud.sdk.model.*;

public class DeleteWorksheetComments {
    public static void main(String[] args) {
        WorksheetsApi api = new WorksheetsApi();
        String name = "test.xlsx";
        String sheetName = "Sheet1";
        String folder = "Documents";
        String storageName = "MyStorage";

        try {
            CellsCloudResponse resp = api.deleteWorksheetComments(name, sheetName, folder, storageName);
            System.out.println(resp.getStatus());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

PHP

<?php
require_once(__DIR__ . '/vendor/autoload.php');

use Aspose\Cells\Cloud\Api\WorksheetsApi;

$apiInstance = new WorksheetsApi();
$name = "test.xlsx";
$sheetName = "Sheet1";
$folder = "Documents";
$storageName = "MyStorage";

try {
    $result = $apiInstance->deleteWorksheetComments($name, $sheetName, $folder, $storageName);
    echo $result->getStatus();
} catch (Exception $e) {
    echo 'Excepción al llamar a WorksheetsApi->deleteWorksheetComments: ', $e->getMessage(), PHP_EOL;
}
?>

Ruby

require 'aspose_cells_cloud'

api_instance = AsposeCellsCloud::WorksheetsApi.new
name = 'test.xlsx'
sheet_name = 'Sheet1'
folder = 'Documents'          # opcional
storage_name = 'MyStorage'    # opcional

begin
  result = api_instance.delete_worksheet_comments(name, sheet_name, folder, storage_name)
  puts result.status
rescue AsposeCellsCloud::ApiError => e
  puts "Excepción al llamar a WorksheetsApi->delete_worksheet_comments: #{e}"
end

Node.js (TypeScript)

import { WorksheetsApi } from "@asposecloud/cells-sdk";

const api = new WorksheetsApi();
const name = "test.xlsx";
const sheetName = "Sheet1";
const folder = "Documents";
const storageName = "MyStorage";

api.deleteWorksheetComments(name, sheetName, folder, storageName)
    .then((response) => console.log(response.status))
    .catch((error) => console.error("Error:", error));

Python

from asposecellscloud import WorksheetsApi

api_instance = WorksheetsApi()
name = "test.xlsx"
sheet_name = "Sheet1"
folder = "Documents"          # opcional
storage_name = "MyStorage"    # opcional

try:
    response = api_instance.delete_worksheet_comments(name, sheet_name, folder, storage_name)
    print(response.status)
except Exception as e:
    print("Excepción al llamar a WorksheetsApi->delete_worksheet_comments:", e)

Perl

use AsposeCellsCloud::Api::WorksheetsApi;

my $api_instance = AsposeCellsCloud::Api::WorksheetsApi->new();

my $name = 'test.xlsx';
my $sheet_name = 'Sheet1';
my $folder = 'Documents';
my $storage_name = 'MyStorage';

eval {
    my $result = $api_instance->delete_worksheet_comments(
        name => $name,
        sheet_name => $sheet_name,
        folder => $folder,
        storage_name => $storage_name
    );
    print $result->{status}, "\n";
};
if ($@) {
    print "Excepción al llamar a WorksheetsApi->delete_worksheet_comments: $@\n";
}

Go

package main

import (
    "fmt"
    "github.com/asposecellscloud/aspose-cells-cloud-go/v3/sdk"
)

func main() {
    cfg := sdk.NewConfiguration()
    cfg.AddDefaultHeader("Authorization", "Bearer <jwt token>")
    api := sdk.NewWorksheetsApi(cfg)

    name := "test.xlsx"
    sheetName := "Sheet1"
    folder := "Documents"
    storageName := "MyStorage"

    resp, _, err := api.DeleteWorksheetComments(name, sheetName, folder, storageName)
    if err != nil {
        fmt.Printf("Error: %v\n", err)
        return
    }
    fmt.Println(resp.Status)
}

Notas y limitaciones

Recursos relacionados

Última actualización: 2026‑07‑30