Définir la mise en page pour une feuille de calcul – Guide de l'API Aspose.Cells Cloud

Conditions préalables : Pour appeler cette API, vous devez disposer d’un jeton JWT (OAuth) valide, et le classeur doit se trouver dans un emplacement de stockage Aspose Cloud où vous avez les autorisations de lecture/écriture. Assurez-vous que le jeton est inclus dans l’en-tête Authorization et que votre compte dispose du quota API nécessaire.

Cette API REST permet de définir la mise en page d’une feuille de calcul Excel.

API REST

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

Sécurité et authentification

Les API REST d’Aspose.Cells Cloud sont sécurisées et exigent une authentification basée sur un jeton JWT.

Paramètres de la requête

Nom du paramètre	Type	Emplacement	Description
name	string	path	Nom du document.
sheetName	string	path	Nom de la feuille de calcul.
pageSetup	object	body	Description de la mise en page.
folder	string	query	Dossier du document.
storageName	string	query	Nom du stockage.

Exemple de charge utile JSON pour l’objet pageSetup

{
  "pageSetup": {
    "orientation": "Portrait",
    "paperSize": "A4",
    "fitToPagesTall": 1,
    "fitToPagesWide": 1,
    "centerHorizontally": true,
    "centerVertically": false
  }
}

La spécification OpenAPI définit une interface de programmation publiquement accessible et permet d’effectuer directement des interactions REST depuis un navigateur web.

Vous pouvez utiliser l’outil en ligne de commande cURL pour accéder facilement aux services web d’Aspose.Cells. L’exemple suivant montre comment effectuer des appels à l’API Cloud avec cURL.

Requête

curl -v "https://api.aspose.cloud/v3.0/cells/myWorkbook.xlsx/worksheets/Tasks/pagesetup" \
-X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jeton jwt>" \
-d '{
  "pageSetup": {
    "orientation": "Portrait",
    "paperSize": "A4",
    "fitToPagesTall": 1,
    "fitToPagesWide": 1,
    "centerHorizontally": true,
    "centerVertically": false
  }
}'

Réponse

L’API renvoie un objet JSON indiquant le résultat de l’opération :

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

Codes de statut de réponse possibles

Code	Signification	Cas
200	OK	Mise à jour de la mise en page réussie
400	Requête incorrecte	Charge utile JSON invalide ou champs obligatoires manquants
401	Non autorisé	Jeton JWT manquant ou invalide
404	Non trouvé	Le classeur ou le nom de la feuille de calcul n’existe pas
500	Erreur interne du serveur	Échec inattendu du serveur

Famille de SDK Cloud

L’utilisation d’un SDK est le meilleur moyen d’accélérer le développement. Un SDK gère les détails de bas niveau et vous permet de vous concentrer sur les tâches de votre projet. Veuillez consulter le dépôt GitHub pour obtenir la liste complète des SDK d’Aspose.Cells Cloud.

Les exemples de code suivants montrent comment effectuer des appels aux services web Aspose.Cells à l’aide de divers SDK :