Documentation –

Developer-Guide: Ottieni il commento del foglio di calcolo – Documentazione API di Aspose.Cells Cloud

Mon, 01 Jan 0001 00:00:00 +0000

Questa REST API consente di recuperare un commento di un foglio di calcolo per nome di cella utilizzando Aspose.Cells Cloud.

Prerequisiti: Per chiamare questa operazione, è necessario includere un token di accesso JWT valido nell’header Authorization (Bearer <jwt token>). I token possono essere ottenuti tramite il flusso di autenticazione di Aspose.Cells Cloud descritto nella guida all’autenticazione.

API GetWorksheetComment

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

Sicurezza e autenticazione

Le API di Aspose.Cells Cloud sono sicure e richiedono l'autenticazione basata su token JWT.

Parametri della richiesta

Nome parametro	Tipo	Posizione (percorso URL / stringa di query)	Descrizione
name	string	Percorso URL	Nome del file Excel.
sheetName	string	Percorso URL	Nome del foglio di calcolo contenente il commento.
cellName	string	Percorso URL	Indirizzo della cella (ad esempio A1) di cui recuperare il commento.
folder	string	Stringa di query	Percorso della cartella in cui è memorizzato il documento.
storageName	string	Stringa di query	Nome del servizio di archiviazione.

La specifiche OpenAPI definiscono un’interfaccia di programmazione pubblicamente accessibile e consente di effettuare interazioni REST direttamente da un browser web.

È possibile utilizzare lo strumento a riga di comando cURL per accedere facilmente ai servizi web di Aspose.Cells. L’esempio seguente mostra come effettuare una chiamata all’API Cloud con cURL.

Richiesta

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/comments/A1" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Risposta

{
  "Comment": {
    "CellName": "A1",
    "Author": "roy.wang",
    "HtmlNote": "",
    "Note": "Aspose.Cells Cloud.",
    "AutoSize": "True",
    "IsVisible": "True",
    "Width": 30,
    "Height": 10,
    "TextHorizontalAlignment": "Bottom",
    "TextOrientationType": "TopToBottom",
    "TextVerticalAlignment": "Bottom"
  },
  "Code": 200,
  "Status": "OK"
}

Risposta: L’API restituisce un oggetto JSON contenente un oggetto Comment con i seguenti campi:

Campo	Tipo	Descrizione
`CellName`	string	Indirizzo della cella (ad esempio A1).
`Author`	string	Nome dell’autore del commento.
`HtmlNote`	string	Contenuto del commento in formato HTML (se presente).
`Note`	string	Versione in testo normale del commento.
`AutoSize`	boolean	Indica se il riquadro del commento si ridimensiona automaticamente.
`IsVisible`	boolean	Determina se il commento è visibile.
`Width`	integer	Larghezza del riquadro del commento (in caratteri).
`Height`	integer	Altezza del riquadro del commento (in caratteri).
`TextHorizontalAlignment`	string	Allineamento orizzontale del testo (ad esempio Bottom).
`TextOrientationType`	string	Orientamento del testo (ad esempio TopToBottom).
`TextVerticalAlignment`	string	Allineamento verticale del testo (ad esempio Bottom).

Errori comuni

401 Unauthorized – Verificare che il token JWT sia valido, non scaduto e correttamente inserito nell’header Authorization.
404 Not Found – Assicurarsi che il nome del file, il nome del foglio e l’indirizzo della cella siano corretti e che il file esista nella cartella/archiviazione specificata.
500 Internal Server Error – Verificare la presenza di dati malformed nel payload della richiesta e confermare che il servizio sia operativo.

Codici di stato HTTP

Codice	Significato	Descrizione
200	OK	Filtro applicato correttamente; la risposta contiene i dettagli dell’operazione.
400	Richiesta non valida (Bad Request)	Parametri mancanti o non validi (ad esempio tipo di file non supportato).
401	Non autorizzato (Unauthorized)	Token JWT non valido o mancante.
413	Payload troppo grande (Payload Too Large)	Il file caricato supera il limite di dimensione.
500	Errore interno del server (Internal Server Error)	Errore imprevisto del server.

Famiglia di SDK Cloud

L’utilizzo di un SDK rappresenta il modo migliore per velocizzare lo sviluppo. Un SDK gestisce i dettagli di basso livello, consentendoti di concentrarti sulle attività del tuo progetto. Consulta il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.

I seguenti esempi di codice mostrano come effettuare chiamate ai servizi web di Aspose.Cells utilizzando vari SDK:

Developer-Guide: Aggiorna il commento di una cella in un foglio di calcolo

Mon, 01 Jan 0001 00:00:00 +0000

Questa API REST aggiorna un commento su una cella di un foglio di calcolo. Utilizza questo endpoint per aggiornare un commento in un foglio di calcolo in un file Excel.

Prerequisiti:

Un token di accesso OAuth/JWT valido deve essere incluso nell’header Authorization.
Il file Excel deve essere memorizzato in una posizione supportata da un servizio di archiviazione cloud (specificare folder e facoltativamente storageName).

API PostWorksheetComment

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

Sicurezza e autenticazione

Le API di Aspose.Cells Cloud sono sicure e richiedono l'autenticazione basata su token JWT.

Parametri della richiesta

Nome parametro	Tipo	Posizione	Descrizione
name	string	path	Il nome del documento Excel.
sheetName	string	path	Il nome del foglio di calcolo contenente la cella.
cellName	string	path	L’indirizzo della cella (ad esempio, A1).
comment	object	body	Un oggetto Comment che definisce il commento da aggiungere o aggiornare.
folder	string	query	La cartella in cui è memorizzato il documento.
storageName	string	query	Il nome del servizio di archiviazione.

La Specifiche OpenAPI definisce un’interfaccia di programmazione pubblicamente accessibile e consente di eseguire interazioni REST direttamente da un browser web.

Puoi utilizzare lo strumento a riga di comando cURL per accedere facilmente ai servizi web di Aspose.Cells. L’esempio seguente mostra come effettuare una chiamata all’API Cloud con cURL.

Richiesta

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/comments/a1" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -d '{
        "CellName": "a1",
        "Author": "test",
        "HtmlNote": "string",
        "Note": "questo è un commento",
        "AutoSize": true,
        "IsVisible": true,
        "Width": 10,
        "Height": 10
      }'

Risposta

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

Codici di stato di risposta possibili:

Codice	Descrizione
200	Commento aggiornato correttamente.
400	Richiesta non valida – parametri mancanti o non validi.
401	Autenticazione non riuscita – non autorizzato.
404	Non trovato – il file Excel, il foglio di calcolo o il commento non esistono.
500	Errore interno del server.

Note / Suggerimenti:

La lunghezza massima del commento è di 1024 caratteri.
I caratteri supportati sono UTF‑8; evitare i caratteri di controllo.

Family di SDK Cloud

Utilizzare un SDK rappresenta il modo più rapido per sviluppare con Aspose.Cells Cloud. Un SDK gestisce i dettagli di basso livello, consentendoti di concentrarti sul tuo progetto. Consulta il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.

I seguenti esempi di codice mostrano come chiamare i servizi web di Aspose.Cells utilizzando vari SDK:

Operazioni correlate:

Developer-Guide:

Mon, 01 Jan 0001 00:00:00 +0000

title: “Aggiungi commento al foglio di calcolo” description: “Aggiungi un commento a una cella specifica in un foglio di calcolo Excel utilizzando l’API REST Aspose.Cells Cloud (PUT /v3.0/cells/{name}/worksheets/{sheetName}/comments/{cellName}).” keywords: “Aspose.Cells, API cloud, aggiungi commento al foglio di calcolo, Excel, foglio di calcolo, commento cella” weight: 20 api_version: “v3.0”

Aggiungi commento al foglio di calcolo

Aggiungi un commento a una cella specifica in un foglio di calcolo di un workbook Excel utilizzando l’API REST Aspose.Cells Cloud.

Prerequisiti / Autenticazione

È richiesto un token Bearer JWT per ogni richiesta.
Ottieni un token tramite l’endpoint /connect/token (vedi la guida all’autenticazione).
Includi il token nell’header Authorization:

Authorization: Bearer <jwt token>

Tutte le chiamate devono essere effettuate tramite HTTPS per proteggere il token e i dati.

Richiesta HTTP

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

Parametri del percorso

Nome	Tipo	Obbligatorio	Descrizione
`name`	string	✔️	Nome del file del workbook (es. `test.xlsx`).
`sheetName`	string	✔️	Nome del foglio di calcolo (es. `Sheet1`).
`cellName`	string	✔️	Indirizzo della cella di destinazione (es. `A1`).

Parametri di query

Nome	Tipo	Obbligatorio	Descrizione
`folder`	string	facoltativo	Cartella contenente il workbook.
`storageName`	string	facoltativo	Nome del servizio di archiviazione in cui si trova il file.

Corpo della richiesta

Il corpo deve contenere un oggetto Comment in formato JSON.

{
  "CellName": "A1",
  "Author": "string",
  "HtmlNote": "string",
  "Note": "string",
  "AutoSize": true,
  "IsVisible": true,
  "Width": 10,
  "Height": 10,
  "TextHorizontalAlignment": "Left",
  "TextOrientationType": "NoRotation",
  "TextVerticalAlignment": "Top"
}

Campi dell’oggetto Comment

Campo	Tipo	Obbligatorio	Descrizione
`CellName`	string	✔️	Indirizzo della cella (deve corrispondere al valore `{cellName}` del percorso).
`Author`	string	facoltativo	Nome dell’autore del commento.
`HtmlNote`	string	facoltativo	Testo del commento in formato HTML.
`Note`	string	facoltativo	Testo del commento in formato testo semplice.
`AutoSize`	boolean	facoltativo	Ridimensiona automaticamente il riquadro del commento.
`IsVisible`	boolean	facoltativo	Mostra il commento per impostazione predefinita.
`Width` / `Height`	number	facoltativo	Dimensioni del riquadro del commento (in punti).
`TextHorizontalAlignment`	string	facoltativo	Allineamento orizzontale (`Left`, `Center`, `Right`).
`TextOrientationType`	string	facoltativo	Rotazione del testo (`NoRotation`, `Rotate90`, ecc.).
`TextVerticalAlignment`	string	facoltativo	Allineamento verticale (`Top`, `Center`, `Bottom`).

Esempio cURL

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/comments/A1" \
  -X PUT \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -d '{
        "CellName": "A1",
        "Author": "test",
        "HtmlNote": "<font style=\"font-weight:bold;font-family:Tahoma;font-size:9pt;color:#000000;text-align:left;\">this is a comment</font>",
        "Note": "this is a comment",
        "AutoSize": true,
        "IsVisible": true,
        "Width": 10,
        "Height": 10,
        "TextHorizontalAlignment": "Left",
        "TextOrientationType": "NoRotation",
        "TextVerticalAlignment": "Top"
      }'

Schema della risposta

Campo	Tipo	Descrizione
`Comment`	object	Oggetto commento creato (vedi Campi dell’oggetto Comment sopra, più metadati del link).
`Code`	integer	Codice di stato HTTP restituito dall’API (es. `200`).
`Status`	string	Messaggio di stato in formato testo (es. `"OK"`).

L’oggetto Comment contiene inoltre un sottoolgetto link:

Sottocampo	Tipo	Descrizione
`Href`	string	URL di riferimento a se stesso per la risorsa commento.
`Rel`	string	Tipo di relazione (`self`).
`Title`	string	Titolo facoltativo (può essere `null`).
`Type`	string	Tipo MIME facoltativo (può essere `null`).

Esempio di risposta con successo

{
  "Comment": {
    "CellName": "A1",
    "Author": "test",
    "HtmlNote": "<Font Style=\"FONT-WEIGHT: bold;FONT-FAMILY: Tahoma;FONT-SIZE: 9pt;COLOR: #000000;TEXT-ALIGN: left;\">this is a comment</Font>",
    "Note": "this is a comment",
    "AutoSize": true,
    "IsVisible": true,
    "Width": 10,
    "Height": 10,
    "TextHorizontalAlignment": "Left",
    "TextOrientationType": "NoRotation",
    "TextVerticalAlignment": "Top",
    "link": {
      "Href": "/test.xlsx/worksheets/Sheet1/comments/A1",
      "Rel": "self",
      "Title": null,
      "Type": null
    }
  },
  "Code": 200,
  "Status": "OK"
}

Risposte di errore

Codice HTTP	Descrizione	Esempio
400	Richiesta non valida – parametri mancanti o non validi.	`{ "Error": { "Code": "InvalidParameter", "Message": "Il parametro 'cellName' è mancante o malformato." }, "Code": 400, "Status": "Bad Request" }`
401	Non autorizzato – token mancante o non valido.	`{ "Error": { "Code": "InvalidToken", "Message": "Autenticazione fallita." }, "Code": 401, "Status": "Unauthorized" }`
404	Non trovato – workbook, foglio di calcolo o cella inesistenti.	`{ "Error": { "Code": "FileNotFound", "Message": "Workbook 'test.xlsx' non trovato." }, "Code": 404, "Status": "Not Found" }`
500	Errore interno del server – condizione imprevista sul server.	`{ "Error": { "Code": "ServerError", "Message": "Si è verificato un errore imprevisto." }, "Code": 500, "Status": "Internal Server Error" }`

Esempi SDK

I seguenti SDK forniscono wrapper già pronti per questa operazione. Sostituisci i valori segnaposto (<YOUR_TOKEN>, <FILE_NAME>, ecc.) con dati reali.

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

// Configura il client API
var config = new Configuration
{
    ClientId = "<your_client_id>",
    ClientSecret = "<your_client_secret>"
};
var apiInstance = new WorksheetsApi(config);

// Prepara l'oggetto commento
var comment = new Comment
{
    CellName = "A1",
    Author = "test",
    Note = "this is a comment",
    HtmlNote = "<font style=\"font-weight:bold;\">this is a comment</font>",
    AutoSize = true,
    IsVisible = true,
    Width = 10,
    Height = 10
};

try
{
    var response = apiInstance.PutWorksheetComment("test.xlsx", "Sheet1", "A1", comment, folder: null, storageName: null);
    Console.WriteLine(response);
}
catch (Exception e)
{
    Console.WriteLine("Eccezione durante la chiamata a WorksheetsApi.PutWorksheetComment: " + e.Message );
}

Java

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

ApiClient client = new ApiClient();
client.setAppSid("<your_client_id>");
client.setAppKey("<your_client_secret>");

WorksheetsApi worksheetsApi = new WorksheetsApi(client);

Comment comment = new Comment()
        .cellName("A1")
        .author("test")
        .note("this is a comment")
        .htmlNote("<font style=\"font-weight:bold;\">this is a comment</font>")
        .autoSize(true)
        .isVisible(true)
        .width(10)
        .height(10);

try {
    CommentResponse resp = worksheetsApi.putWorksheetComment("test.xlsx", "Sheet1", "A1", comment, null, null);
    System.out.println(resp);
} catch (ApiException e) {
    e.printStackTrace();
}

PHP

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

$config = new Aspose\Cells\Configuration();
$config->setAppSid('<your_client_id>');
$config->setAppKey('<your_client_secret>');

$apiInstance = new Aspose\Cells\Api\WorksheetsApi(
    new GuzzleHttp\Client(),
    $config
);

$comment = new Aspose\Cells\Model\Comment([
    'CellName' => 'A1',
    'Author'   => 'test',
    'Note'     => 'this is a comment',
    'HtmlNote' => '<font style="font-weight:bold;">this is a comment</font>',
    'AutoSize' => true,
    'IsVisible'=> true,
    'Width'    => 10,
    'Height'   => 10
]);

try {
    $result = $apiInstance->putWorksheetComment('test.xlsx', 'Sheet1', 'A1', $comment);
    print_r($result);
} catch (Exception $e) {
    echo 'Eccezione durante la chiamata a WorksheetsApi->putWorksheetComment: ', $e->getMessage(), PHP_EOL;
}
?>

Ruby

require 'aspose_cells_cloud'

config = AsposeCellsCloud::Configuration.new
config.client_id = '<your_client_id>'
config.client_secret = '<your_client_secret>'

api_instance = AsposeCellsCloud::WorksheetsApi.new

comment = AsposeCellsCloud::Comment.new(
  cell_name: 'A1',
  author: 'test',
  note: 'this is a comment',
  html_note: '<font style="font-weight:bold;">this is a comment</font>',
  auto_size: true,
  is_visible: true,
  width: 10,
  height: 10
)

begin
  result = api_instance.put_worksheet_comment('test.xlsx', 'Sheet1', 'A1', comment)
  puts result
rescue AsposeCellsCloud::ApiError => e
  puts "Eccezione durante la chiamata a WorksheetsApi->put_worksheet_comment: #{e}"
end

Node.js

const { WorksheetsApi, Configuration, Comment } = require('asposecellscloud');

let config = new Configuration();
config.clientId = '<your_client_id>';
config.clientSecret = '<your_client_secret>';

let api = new WorksheetsApi(config);

let comment = new Comment({
  CellName: 'A1',
  Author: 'test',
  Note: 'this is a comment',
  HtmlNote: '<font style="font-weight:bold;">this is a comment</font>',
  AutoSize: true,
  IsVisible: true,
  Width: 10,
  Height: 10
});

api.putWorksheetComment('test.xlsx', 'Sheet1', 'A1', comment)
  .then(response => console.log(response))
  .catch(err => console.error(err));

Python

import asposecellscloud
from asposecellscloud.rest import ApiException
from asposecellscloud.models import Comment

config = asposecellscloud.Configuration()
config.client_id = '<your_client_id>'
config.client_secret = '<your_client_secret>'

api_instance = asposecellscloud.WorksheetsApi(asposecellscloud.ApiClient(config))

comment = Comment(
    CellName='A1',
    Author='test',
    Note='this is a comment',
    HtmlNote='<font style="font-weight:bold;">this is a comment</font>',
    AutoSize=True,
    IsVisible=True,
    Width=10,
    Height=10
)

try:
    api_response = api_instance.put_worksheet_comment('test.xlsx', 'Sheet1', 'A1', comment)
    print(api_response)
except ApiException as e:
    print("Eccezione durante la chiamata a WorksheetsApi->put_worksheet_comment: %s\\n" % e)

Perl

use AsposeCellsCloud::Api::WorksheetsApi;
use AsposeCellsCloud::Object::Comment;

my $config = AsposeCellsCloud::Configuration->new(
    client_id     => '<your_client_id>',
    client_secret => '<your_client_secret>'
);
my $api_instance = AsposeCellsCloud::Api::WorksheetsApi->new();

my $comment = AsposeCellsCloud::Object::Comment->new(
    CellName => 'A1',
    Author   => 'test',
    Note     => 'this is a comment',
    HtmlNote => '<font style="font-weight:bold;">this is a comment</font>',
    AutoSize => 1,
    IsVisible=> 1,
    Width    => 10,
    Height   => 10
);

eval {
    my $result = $api_instance->put_worksheet_comment(
        name      => 'test.xlsx',
        sheet_name=> 'Sheet1',
        cell_name => 'A1',
        comment   => $comment
    );
    print $result;
};
if ($@) {
    warn "Eccezione durante la chiamata a WorksheetsApi->put_worksheet_comment: $@";
}

package main

import (
    "fmt"
    "github.com/aspose-cells-cloud/aspose-cells-cloud-go/v3"
    "github.com/aspose-cells-cloud/aspose-cells-cloud-go/v3/api"
    "github.com/aspose-cells-cloud/aspose-cells-cloud-go/v3/model"
)

func main() {
    cfg := cellscloud.NewConfiguration()
    cfg.ClientId = "<your_client_id>"
    cfg.ClientSecret = "<your_client_secret>"

    apiInstance := api.NewWorksheetsApi(cfg)

    comment := model.Comment{
        CellName: "A1",
        Author:   "test",
        Note:     "this is a comment",
        HtmlNote: "<font style=\"font-weight:bold;\">this is a comment</font>",
        AutoSize: true,
        IsVisible: true,
        Width: 10,
        Height: 10,
    }

    resp, _, err := apiInstance.PutWorksheetComment("test.xlsx", "Sheet1", "A1", comment, nil, nil)
    if err != nil {
        fmt.Printf("Errore: %v\\n", err)
    } else {
        fmt.Printf("Risposta: %+v\\n", resp)
    }
}

Vedi anche

Ottieni commento del foglio di calcolo – GET /cells/{name}/worksheets/{sheetName}/comments/{cellName}
Aggiorna commento del foglio di calcolo – POST /cells/{name}/worksheets/{sheetName}/comments/{cellName}
Elimina commento del foglio di calcolo – DELETE /cells/{name}/worksheets/{sheetName}/comments/{cellName}
Cancella tutti i commenti – DELETE /cells/{name}/worksheets/{sheetName}/comments

Note aggiuntive

Il percorso dell’endpoint include v3.0. Una versione più recente (v3.1) è disponibile; aggiorna l’URL di base di conseguenza se hai bisogno delle funzionalità più recenti.
Per la definizione completa OpenAPI, visita il riferimento API Aspose.Cells Cloud.
Ricorda di gestire il rate limiting (HTTP 429) e di effettuare nuovamente le richieste secondo le linee guida dell’API.

Developer-Guide:

Mon, 01 Jan 0001 00:00:00 +0000

title: “API di eliminazione del commento nel foglio di lavoro – Aspose.Cells Cloud” description: “Elimina un commento specifico di una cella in un foglio di lavoro Excel utilizzando l’API REST Aspose.Cells Cloud (v3.0). Include endpoint, parametri, esempi di richiesta/risposta, frammenti SDK e gestione degli errori.” keywords: “Aspose.Cells, elimina commento, API Excel, REST, commento foglio di lavoro” date: “2026-07-30” lastModified: “2026-07-30”

API di eliminazione del commento nel foglio di lavoro – Aspose.Cells Cloud

Ultima modifica della pagina: 30 luglio 2026

Panoramica

Un commento è una nota di testo associata a una particolare cella in un foglio di lavoro Excel.
L’operazione Elimina commento foglio di lavoro rimuove un commento dalla cella specificata.

Autenticazione

Tutti gli endpoint di Aspose.Cells Cloud richiedono l'autenticazione basata su token JWT.
Includere il token nell’intestazione Authorization:

Authorization: Bearer <jwt token>

Per maggiori dettagli su come ottenere un token JWT, consulta la Guida all’autenticazione.

Prerequisiti

Un token di accesso JWT valido.
Il workbook di destinazione ({name}) deve esistere nella posizione di archiviazione specificata.
Opzionale: Uno degli SDK di Aspose.Cells Cloud installati per il linguaggio preferito.

Richiesta HTTP

Endpoint

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

Parametri del percorso

Parametro	Tipo	Obbligatorio	Descrizione
`name`	string	✅	Nome del workbook Excel (ad esempio, `test.xlsx`).
`sheetName`	string	✅	Nome del foglio di lavoro contenente il commento.
`cellName`	string	✅	Indirizzo della cella il cui commento verrà eliminato (ad esempio, `A1`).

Parametri di query

Parametro	Tipo	Obbligatorio	Descrizione
`folder`	string	❌	Percorso della cartella in cui è memorizzato il workbook. Se omesso, viene utilizzata la cartella root.
`storageName`	string	❌	Nome del servizio di archiviazione (ad esempio, `MyCloud`). Se omesso, viene utilizzato l’archivio predefinito.

Esempio di richiesta

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

Risposta

Esito positivo (200)

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

Codici di stato HTTP

Codice	Significato	Descrizione
200	OK	Filtro applicato correttamente; la risposta contiene i dettagli dell’operazione.
400	Richiesta non valida	Parametri mancanti o non validi (ad esempio, tipo di file non supportato).
401	Non autorizzato	Token JWT non valido o mancante.
413	Payload troppo grande	Il file caricato supera il limite di dimensione.
500	Errore interno del server	Errore imprevisto nel server.

Risposte di errore

Codice HTTP	Descrizione	Esempio
400	Richiesta non valida – parametri mancanti o non corretti.	`{ "Code": 400, "Message": "Parametri non validi." }`
401	Non autorizzato – token non valido o mancante.	`{ "Code": 401, "Message": "Autenticazione richiesta." }`
404	Non trovato – il file, il foglio di lavoro o il commento non esiste.	`{ "Code": 404, "Message": "Risorsa non trovata." }`
500	Errore interno del server – condizione imprevista sul server.	`{ "Code": 500, "Message": "Errore del server." }`

Esempi SDK

Di seguito sono riportati frammenti pronti all’uso per i linguaggi più diffusi. Sostituisci <jwt token>, test.xlsx, Sheet1 e A1 con i tuoi valori.

C#

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

// Configura il client dell'API
var config = new Configuration
{
    AccessToken = "<jwt token>",
    BasePath = "https://api.aspose.cloud"
};

var apiInstance = new WorksheetsApi(config);
try
{
    var result = apiInstance.DeleteWorksheetComment(
        name: "test.xlsx",
        sheetName: "Sheet1",
        cellName: "A1",
        folder: "Docs",
        storageName: "MyStorage"
    );
    Console.WriteLine("Commento eliminato. Stato: " + result.Status);
}
catch (Exception e)
{
    Console.WriteLine("Eccezione durante la chiamata a WorksheetsApi.DeleteWorksheetComment: " + e.Message);
}

Java

import com.aspose.cloud.cells.api.WorksheetsApi;
import com.aspose.cloud.cells.client.ApiException;
import com.aspose.cloud.cells.model.CellsCloudResponse;

public class DeleteWorksheetCommentExample {
    public static void main(String[] args) {
        WorksheetsApi api = new WorksheetsApi();
        api.getApiClient().setAccessToken("<jwt token>");
        try {
            CellsCloudResponse response = api.deleteWorksheetComment(
                "test.xlsx",
                "Sheet1",
                "A1",
                "Docs",
                "MyStorage"
            );
            System.out.println("Commento eliminato, stato: " + response.getStatus());
        } catch (ApiException e) {
            System.err.println("Eccezione durante la chiamata a WorksheetsApi#deleteWorksheetComment");
            e.printStackTrace();
        }
    }
}

PHP

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

$config = new Aspose\Cells\Configuration();
$config->setAccessToken('<jwt token>');
$config->setHost('https://api.aspose.cloud');

$apiInstance = new Aspose\Cells\Api\WorksheetsApi(
    new GuzzleHttp\Client(),
    $config
);

try {
    $result = $apiInstance->deleteWorksheetComment(
        'test.xlsx',
        'Sheet1',
        'A1',
        'Docs',
        'MyStorage'
    );
    echo "Commento eliminato. Stato: " . $result->getStatus();
} catch (Exception $e) {
    echo 'Eccezione durante la chiamata a WorksheetsApi->deleteWorksheetComment: ', $e->getMessage(), PHP_EOL;
}
?>

Ruby

require 'aspose_cells_cloud'

config = AsposeCellsCloud::Configuration.new
config.access_token = '<jwt token>'
config.host = 'https://api.aspose.cloud'

api_instance = AsposeCellsCloud::WorksheetsApi.new
begin
  result = api_instance.delete_worksheet_comment('test.xlsx', 'Sheet1', 'A1', 'Docs', 'MyStorage')
  puts "Commento eliminato – stato: #{result.status}"
rescue AsposeCellsCloud::ApiError => e
  puts "Eccezione durante la chiamata a WorksheetsApi->delete_worksheet_comment: #{e}"
end

Node.js (TypeScript)

import { WorksheetsApi, Configuration } from "@asposecloud/cells-cloud";

const config = new Configuration({
    accessToken: "<jwt token>",
    basePath: "https://api.aspose.cloud"
});

const api = new WorksheetsApi(config);

api.deleteWorksheetComment("test.xlsx", "Sheet1", "A1", "Docs", "MyStorage")
    .then((response) => {
        console.log("Commento eliminato. Stato:", response.status);
    })
    .catch((error) => {
        console.error("Errore durante l'eliminazione del commento:", error);
    });

Python

from asposecellscloud.apis import WorksheetsApi
from asposecellscloud import Configuration, ApiClient

config = Configuration()
config.access_token = "<jwt token>"
config.host = "https://api.aspose.cloud"

api_client = ApiClient(configuration=config)
api = WorksheetsApi(api_client)

try:
    response = api.delete_worksheet_comment(
        name="test.xlsx",
        sheet_name="Sheet1",
        cell_name="A1",
        folder="Docs",
        storage_name="MyStorage"
    )
    print("Commento eliminato. Stato:", response.status)
except Exception as e:
    print("Eccezione durante la chiamata a WorksheetsApi->delete_worksheet_comment:", e)

Perl

use AsposeCellsCloud::Api::WorksheetsApi;
use AsposeCellsCloud::Configuration;

my $config = AsposeCellsCloud::Configuration->new(
    access_token => '<jwt token>',
    host => 'https://api.aspose.cloud'
);
my $api_instance = AsposeCellsCloud::Api::WorksheetsApi->new($config);

eval {
    my $result = $api_instance->delete_worksheet_comment(
        name        => 'test.xlsx',
        sheet_name  => 'Sheet1',
        cell_name   => 'A1',
        folder      => 'Docs',
        storage_name=> 'MyStorage'
    );
    print "Commento eliminato. Stato: " . $result->{status} . "\n";
};
if ($@) {
    warn "Eccezione durante la chiamata a WorksheetsApi->delete_worksheet_comment: $@\n";
}

Go

package main

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

func main() {
    cfg := config.NewConfiguration()
    cfg.AccessToken = "<jwt token>"
    cfg.Host = "https://api.aspose.cloud"

    apiInstance := api.NewWorksheetsApi(cfg)

    result, _, err := apiInstance.DeleteWorksheetComment(
        "test.xlsx",   // name
        "Sheet1",      // sheetName
        "A1",          // cellName
        "Docs",        // folder (opzionale)
        "MyStorage",   // storageName (opzionale)
    )
    if err != nil {
        fmt.Printf("Errore durante la chiamata a DeleteWorksheetComment: %v\n", err)
        return
    }
    fmt.Printf("Commento eliminato. Stato: %s\n", result.Status)
}

Operazioni correlate

Limitazione della velocità

Aspose.Cells Cloud applica un limite predefinito di 100 richieste al minuto per account. Superare questo limite restituisce HTTP 429 Too Many Requests. Implementa un ritardo esponenziale o rispetta l’intestazione Retry-After per evitare throttling.

Vedi anche

Specifiche OpenAPI: https://apireference.aspose.cloud/cells/#/Worksheets/DeleteWorksheetComment
Guida all’autenticazione: https://docs.aspose.cloud/total/getting-started/rest-api-overview/authenticating-api-requests/
Repository SDK: https://github.com/aspose-cells-cloud

Developer-Guide:

Mon, 01 Jan 0001 00:00:00 +0000

title: “Elimina tutti i commenti del foglio di lavoro” description: “Elimina tutti i commenti da un foglio di lavoro in un file Excel utilizzando l’API Aspose.Cells Cloud. Scopri l’endpoint DELETE, i parametri richiesti, l’autenticazione, la richiesta cURL di esempio, il formato della risposta, i codici di errore e gli esempi di SDK.” keywords: “Aspose, Cells, elimina commenti, foglio di lavoro, API, REST, Excel, cloud” url: /comments/clear/ aliases:

/delete-all-comments-in-a-worksheet/ weight: 50

Elimina tutti i commenti del foglio di lavoro

Versione API: v3.0
Risorsa: Worksheets → DeleteWorksheetComments

Aspose.Cells Cloud fornisce un endpoint REST robusto che rimuove tutti i commenti da un foglio di lavoro specificato. Questa operazione è irreversibile: una volta eseguita, i commenti non possono essere recuperati.

Prerequisiti

Requisito	Dettagli
Autenticazione	È necessario un token di accesso JWT valido nell’intestazione `Authorization` (`Bearer <jwt token>`). Ottieni il token tramite il flusso di autenticazione OAuth2.
Archiviazione	Il file deve trovarsi in un’archiviazione accessibile ad Aspose.Cells Cloud (viene utilizzata l’archiviazione predefinita se `storageName` viene omesso).
Permessi	Il token deve avere il permesso di leggere e scrivere il file di destinazione.
SDK (opzionale)	Gli SDK sono disponibili per .NET, Java, PHP, Ruby, Node.js, Python, Perl e Go (vedi la sezione Esempi di SDK).

Richiesta HTTP

Endpoint

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

Parametri del percorso

Nome	Tipo	Descrizione
`name`	string	Nome del file Excel (ad esempio `test.xlsx`).
`sheetName`	string	Nome del foglio di lavoro (ad esempio `Sheet1`).

Parametri di query

Nome	Tipo	Obbligatorio	Descrizione
`folder`	string	opzionale	Percorso della cartella contenente il file.
`storageName`	string	opzionale	Nome dell’archiviazione in cui si trova il file.

Intestazioni della richiesta

Intestazione	Valore
`Authorization`	`Bearer <jwt token>`
`Accept`	`application/json`
`Content-Type`	`application/json`

Esempio di richiesta (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>"

Sostituisci test.xlsx, Sheet1, Documents, MyStorage e <jwt token> con i tuoi valori effettivi.

Risposta

Esito positivo (200)

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

Il corpo della risposta conforma al modello CellsCloudResponse.

Risposte di errore

Codice HTTP	Significato	Corpo di esempio
400	Richiesta non valida – parametri non validi.	`{ "Code": 400, "Message": "Invalid request." }`
401	Non autorizzato – token JWT mancante o non valido.	`{ "Code": 401, "Message": "Authentication failed." }`
404	Non trovato – il file o il foglio di lavoro non esiste.	`{ "Code": 404, "Message": "Resource not found." }`
500	Errore interno del server.	`{ "Code": 500, "Message": "Server error." }`

Esempi di SDK

I frammenti seguenti mostrano come chiamare l’endpoint utilizzando gli SDK ufficiali di Aspose.Cells Cloud (versione 3.13.0). Sostituisci i valori segnaposto (<fileName>, <sheet>, <jwt token>, ecc.) con i tuoi dati.

C#

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

var apiInstance = new WorksheetsApi();
var name = "test.xlsx"; // string | Nome del file.
var sheetName = "Sheet1"; // string | Nome del foglio di lavoro.
var folder = "Documents"; // string | Percorso della cartella (opzionale)
var storageName = "MyStorage"; // string | Nome dell'archiviazione (opzionale)

try
{
    var response = apiInstance.DeleteWorksheetComments(name, sheetName, folder, storageName);
    Console.WriteLine(response.Status);
}
catch (Exception e)
{
    Console.WriteLine("Eccezione durante la chiamata 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 'Eccezione durante la chiamata 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'          # opzionale
storage_name = 'MyStorage'    # opzionale

begin
  result = api_instance.delete_worksheet_comments(name, sheet_name, folder, storage_name)
  puts result.status
rescue AsposeCellsCloud::ApiError => e
  puts "Eccezione durante la chiamata 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("Errore:", error));

Python

from asposecellscloud import WorksheetsApi

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

try:
    response = api_instance.delete_worksheet_comments(name, sheet_name, folder, storage_name)
    print(response.status)
except Exception as e:
    print("Eccezione durante la chiamata 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 "Eccezione durante la chiamata 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("Errore: %v\n", err)
        return
    }
    fmt.Println(resp.Status)
}

Note e limitazioni

Questa operazione elimina ogni commento nel foglio di lavoro specificato. Utilizzala con attenzione—non è prevista alcuna funzione di annullamento.
La richiesta non accetta un corpo; tutte le informazioni necessarie vengono trasmesse tramite URL ed intestazioni.
Se il file di destinazione è protetto o il foglio di lavoro è in sola lettura, l’API restituirà un errore 400 o 401 a seconda della causa sottostante.
L’endpoint funziona con file memorizzati sia in Aspose Cloud Storage che in Amazon S3, Azure Blob o Google Cloud Storage, quando correttamente referenziati tramite storageName.

Risorse correlate

Specifiche OpenAPI – DeleteWorksheetComments
Guida all’autenticazione – OAuth2 per Aspose.Cells Cloud
Repository degli SDK – https://github.com/aspose-cells-cloud
API generica per i fogli di lavoro – https://docs.aspose.cloud/cells/worksheets/

Ultimo aggiornamento: 2026‑07‑30