Tous les produits
Search

Ce produit

    :CreateOfficeConversionTask

    Centre de documentation

    :CreateOfficeConversionTask

    Dernière mise à jour :Aug 07, 2026

    Crée une tâche de conversion de document qui convertit des documents, tels que des fichiers Word, PowerPoint, Excel et PDF, stockés dans Object Storage Service (OSS) en images, fichiers texte ou fichiers PDF.

    Description de l'opération

    • Avant d'utiliser cette opération, assurez-vous de bien comprendre les méthodes de facturation et la tarification d'Intelligent Media Management (IMM).

      Important Le temps d'exécution des tâches asynchrones n'est pas garanti.

    • Formats de fichiers d'entrée pris en charge :

      • Documents de traitement de texte (Word) : doc, docx, wps, wpss, docm, dotm, dot et dotx.

      • Documents de présentation (PowerPoint) : pptx, ppt, pot, potx, pps, ppsx, dps, dpt, pptm, potm, ppsm et dpss.

      • Documents de feuille de calcul (Excel) : xls, xlt, et, ett, xlsx, xltx, csv, xlsb, xlsm, xltm et ets.

      • Documents PDF : pdf.

    • Formats de fichiers de sortie pris en charge :

      • Images : png et jpg.

      • Texte : txt.

      • PDF : pdf.

    • La taille maximale d'un fichier unique est de 200 Mo. Cette limite ne peut pas être modifiée.

    • Si un fichier est volumineux ou si son contenu est complexe, la conversion peut expirer.

    • Le nombre de requêtes par seconde est limité à 50 pour un seul utilisateur.

    • Les informations de la tâche ne sont conservées que pendant 7 jours après le démarrage de la tâche. Passé ce délai, les informations ne peuvent plus être récupérées. Vous pouvez obtenir rapidement les informations de la tâche en utilisant l'une des méthodes suivantes :

    Testez maintenant

    Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

    Test

    Autorisation RAM

    Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

    • Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.

    • API : l'API que vous pouvez appeler pour exécuter l'action.

    • Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.

    • Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.

      • Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.

      • Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.

    • Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.

    • Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

    imm:CreateOfficeConversionTask

    create

    *Project

    acs:imm:{#regionId}:{#accountId}:project/{#ProjectName}

    		 Aucune Aucune

    Paramètres de requête

    Paramètre

    Type

    Requis

    Description

    Exemple
    ProjectName

    string

    Oui

    Le nom du projet. Pour plus d'informations sur la façon d'obtenir le nom du projet, consultez Créer un projet.

    test-project
    SourceURI

    string

    Non

    L'adresse de stockage des données source.

    L'adresse OSS doit être au format oss://${Bucket}/${Object}. `${Bucket}` est le nom du compartiment OSS qui se trouve dans la même région que le projet actuel. `${Object}` est le chemin complet du fichier, y compris l'extension du nom de fichier.

    oss://test-bucket/test-object
    Sources

    array<object>

    Non

    Une liste d'images d'entrée. Les images sont converties dans l'ordre de leurs URI dans la liste. (Ce paramètre n'est pas encore publié. Ne l'utilisez pas.)

    oss://imm-test/test.pptx

    object

    Non

    Les informations concernant une image d'entrée.

    URI

    string

    Non

    L'adresse OSS de l'image source.

    L'adresse OSS doit être au format oss://${Bucket}/${Object}. ${Bucket} est le nom du compartiment OSS qui se trouve dans la même région que le projet actuel. ${Object} est le chemin complet du fichier, y compris l'extension du nom de fichier.

    Formats d'image pris en charge : jpg, jp2, png, tiff, webp, bmp et svg.

    oss://examplebucket/sampleobject.jpg
    Rotate

    integer

    Non

    L'angle de rotation de l'image. Valeurs valides :

    • 0 (par défaut)

    • 90

    • 180

    • 270

    90
    TargetURI

    string

    Non

    Le modèle pour l'adresse de sortie du document converti.

    L'adresse doit être au format oss://{bucket}/{tags.custom}/{dirname}/{barename}.{autoext}. Pour plus d'informations, consultez Modèles TargetURI.

    Remarque

    Spécifiez soit ce paramètre, soit `TargetURIPrefix`.

    oss://examplebucket/outputDocument.pdf
    TargetURIPrefix

    string

    Non

    Le préfixe de l'adresse de stockage du fichier de sortie après la conversion du document.

    Le préfixe doit être au format oss://${Bucket}/${Prefix}/. `${Bucket}` est le nom du compartiment OSS qui se trouve dans la même région que le projet actuel. `${Prefix}` est le préfixe de l'adresse de stockage du fichier de sortie.

    Remarque

    Spécifiez soit ce paramètre, soit `TargetURI`.

    oss://examplebucket/outputprefix/
    SourceType

    string

    Non

    Le type d'extension des données source. Par défaut, le type des données source est déterminé par l'extension de l'objet OSS. Si l'objet OSS n'a pas d'extension, vous pouvez définir ce paramètre. Valeurs valides :

    • Documents de traitement de texte (Word) : doc, docx, wps, wpss, docm, dotm, dot et dotx

    • Documents de présentation (PowerPoint) : pptx, ppt, pot, potx, pps, ppsx, dps, dpt, pptm, potm, ppsm et dpss

    • Documents de feuille de calcul (Excel) : xls, xlt, et, ett, xlsx, xltx, csv, xlsb, xlsm, xltm et ets

    • Documents PDF : pdf

    doc
    TargetType

    string

    Oui

    Le type du fichier de sortie. Valeurs valides :

    • png : convertit le document en images PNG.

    • jpg : convertit le document en images JPG.

    • pdf : convertit le document en fichier PDF.

    • txt : convertit le document en fichier texte uniquement. Ceci est principalement utilisé pour extraire le contenu textuel du fichier. Cette option n'est prise en charge que pour les documents de présentation, les documents de traitement de texte et les documents de feuille de calcul. Lorsque vous convertissez un document de feuille de calcul, un seul fichier txt est généré et les paramètres des variables liées aux feuilles ne prennent pas effet.

    png
    UserData

    string

    Non

    Les informations personnalisées. Ces informations sont renvoyées dans le message de notification asynchrone pour vous aider à associer la notification à vos services. La valeur peut comporter jusqu'à 2 048 octets.

    { "id": "test-id", "name": "test-name" }
    Tags

    object

    Non

    Les balises personnalisées. La valeur est un dictionnaire. Vous pouvez utiliser les balises pour rechercher des tâches.

    { "key": "value" }
    StartPage

    integer

    Non

    La page de début pour la conversion du document. La valeur par défaut est 1.

    Remarque

    • Si le fichier source est une feuille de calcul, vous devez spécifier le numéro de la feuille de calcul.

    • Ce paramètre ne prend effet que lorsque vous convertissez le document en images. Il ne prend pas effet lorsque vous convertissez le document en fichier PDF ou en fichier texte.

    1
    EndPage

    integer

    Non

    La page de fin pour la conversion du document. La valeur par défaut est -1, ce qui indique que toutes les pages de la page de début à la dernière page sont converties.

    Remarque

    • Si le fichier source est une feuille de calcul, vous devez spécifier le numéro de la feuille de calcul (`SheetIndex`).

    • Si le document comporte de nombreuses pages, nous vous recommandons de les convertir par lots. Sinon, la conversion peut expirer.

    • Ce paramètre ne prend effet que lorsque vous convertissez le document en images. Il ne prend pas effet lorsque vous convertissez le document en fichier PDF ou en fichier texte.

    -1
    Password

    string

    Non

    Le mot de passe pour ouvrir le document. Définissez ce paramètre si vous souhaitez convertir un document protégé par mot de passe.

    123456
    ScalePercentage

    integer

    Non

    Le rapport de mise à l'échelle du document. Valeurs valides : de 20 à 199. La valeur par défaut est 100, ce qui indique que le document n'est pas mis à l'échelle.

    Remarque

    Une valeur inférieure à 100 indique que le document est réduit. Une valeur supérieure à 100 indique que le document est agrandi.

    100
    Quality

    integer

    Non

    La qualité du fichier converti. Valeurs valides : de 0 à 100. Une valeur de 0 indique la qualité la plus basse et les meilleures performances. Une valeur de 100 indique la qualité la plus haute et les performances les plus faibles. Par défaut, le système définit une valeur appropriée en fonction du contenu du document pour équilibrer la qualité et les performances.

    60
    Pages

    string

    Non

    Les numéros de page à convertir. Ce paramètre a une priorité supérieure à celle des paramètres `StartPage` et `EndPage`. Le format est le suivant :

    • Séparez plusieurs numéros de page par des virgules (,), par exemple 1,2.

    • Spécifiez une plage de pages consécutives avec un trait d'union (-), par exemple 1,2-4,7.

    1,2-4,7
    MaxSheetRow

    integer

    Non

    Le nombre maximal de lignes à convertir lorsque vous convertissez un document de feuille de calcul en images. Par défaut, toutes les lignes sont converties.

    Remarque

    Ce paramètre ne prend effet que lorsque vous définissez LongPicture sur true.

    10
    MaxSheetColumn

    integer

    Non

    Le nombre maximal de colonnes à convertir lorsque vous convertissez un document de feuille de calcul en images. Par défaut, toutes les colonnes sont converties.

    Remarque

    Ce paramètre ne prend effet que lorsque vous définissez LongPicture sur true.

    10
    SheetCount

    integer

    Non

    Le nombre de feuilles de calcul à convertir en images dans le document de feuille de calcul. Par défaut, toutes les feuilles de calcul sont converties.

    1
    SheetIndex

    integer

    Non

    Le numéro de la feuille de calcul à convertir en images dans le document de feuille de calcul. Valeurs valides : de 1 au numéro de la dernière feuille de calcul. La valeur par défaut est 1.

    1
    FitToWidth

    boolean

    Non

    Lorsque vous convertissez un document de feuille de calcul en images ou en fichier PDF, indique si toutes les colonnes doivent être rendues sur une seule image ou page PDF. Valeurs valides :

    • false (par défaut) : non. Le contenu est rendu sur plusieurs images ou pages PDF.

    • true : oui. Le contenu est rendu sur une seule image ou page PDF.

    false
    FitToHeight

    boolean

    Non

    Lorsque vous convertissez un document de feuille de calcul en images ou en fichier PDF, indique si toutes les lignes doivent être rendues sur une seule image ou page PDF. Valeurs valides :

    • false (par défaut) : non. Le contenu est rendu sur plusieurs images ou pages PDF.

    • true : oui. Le contenu est rendu sur une seule image ou page PDF.

    false
    FirstPage

    boolean

    Non

    Lorsque vous convertissez un document de feuille de calcul en images, indique si seule la première image du résultat de la conversion doit être renvoyée. Le nombre de lignes et de colonnes dans l'image est le résultat d'un fractionnement automatique. Valeurs valides :

    • false (par défaut) : non. Toutes les images sont renvoyées.

    • true : oui. Seule la première image est renvoyée. Ceci est utilisé pour extraire une miniature.

    Remarque

    Ce paramètre ne prend effet que si vous définissez le paramètre LongPicture sur true.

    false
    PaperSize

    string

    Non

    Le format de papier pour la conversion d'un document de feuille de calcul en images. L'image de sortie est similaire à une page imprimée. Valeurs valides :

    • A0

    • A2

    • A4 (par défaut)

    Remarque

    Ce paramètre ne prend effet que lorsque vous l'utilisez avec les paramètres FitToHeight et FitToWidth.

    A4
    PaperHorizontal

    boolean

    Non

    Lorsque vous convertissez un document de feuille de calcul en images, indique si le papier doit être placé horizontalement. L'image de sortie est similaire à une page imprimée. Valeurs valides :

    • false (par défaut) : non. Le papier est placé verticalement.

    • true : oui. Le papier est placé horizontalement.

    false
    TrimPolicy TrimPolicy

    Non

    La politique de rognage pour la conversion de feuille de calcul. Par exemple, si une feuille de calcul contient de nombreuses lignes et colonnes vides, une grande quantité d'espace blanc peut être générée si aucune politique de rognage n'est spécifiée.

    ShowComments

    boolean

    Non

    Lorsque vous convertissez un document de traitement de texte en images, indique si les commentaires doivent être affichés. Valeurs valides :

    • false (par défaut) : non. Les commentaires ne sont pas affichés.

    • true : oui. Les commentaires sont affichés.

    false
    LongPicture

    boolean

    Non

    Lorsque vous convertissez un document en images, indique s'il doit être converti en une image longue. Valeurs valides :

    • false (par défaut) : non. Le document est converti en plusieurs images.

    • true : oui. Le document est converti en une image longue.

    Remarque

    Vous pouvez combiner un maximum de 20 pages en une image longue. Si le nombre de pages dépasse cette limite, la tâche de conversion peut échouer.

    false
    ImageDPI

    integer

    Non

    Le DPI de l'image de sortie. Valeurs valides : de 96 à 600. La valeur par défaut est 96.

    96
    LongText

    boolean

    Non

    Lorsque vous convertissez un document en texte, indique s'il doit être converti en un long fichier texte. Valeurs valides :

    • false (par défaut) : non. Chaque page du document est convertie en un fichier texte distinct.

    • true : oui. Tout le contenu est placé dans un seul fichier texte.

    false
    HoldLineFeed

    boolean

    Non

    Lorsque vous convertissez un document en texte, indique si les sauts de ligne du document doivent être conservés. Valeurs valides :

    • false (par défaut) : non. Les sauts de ligne ne sont pas conservés.

    • true : oui. Les sauts de ligne sont conservés.

    false
    CredentialConfig CredentialConfig

    Non

    Si vous n'avez pas d'exigences particulières, laissez ce paramètre vide.

    La configuration d'autorisation en chaîne. Ce paramètre n'est pas requis. Pour plus d'informations, consultez Utiliser l'autorisation en chaîne pour accéder aux ressources d'autres entités.

    Notification Notification

    Non

    La configuration de notification des messages. Pour plus d'informations, cliquez sur Notification. Pour plus d'informations sur le format des messages de notification asynchrone, consultez Format des messages de notification asynchrone.

    Éléments de réponse

    Élément

    Type

    Description

    Exemple

    object

    La réponse pour la tâche asynchrone.

    RequestId

    string

    L'identifiant de la requête.

    FF3B7D81-66AE-47E0-BF69-157DCF18*****
    TaskId

    string

    L'identifiant de la tâche.

    formatconvert-00bec802-073a-4b61-ba3b-39bc2fdd*****
    EventId

    string

    L'identifiant de l'événement.

    2C2-1I0EG57VR37J4rQ8oKG6C9*****

    Exemples

    JSON format

    {
  "RequestId": "FF3B7D81-66AE-47E0-BF69-157DCF18*****",
  "TaskId": "formatconvert-00bec802-073a-4b61-ba3b-39bc2fdd*****",
  "EventId": "2C2-1I0EG57VR37J4rQ8oKG6C9*****"
}

    Codes d'erreur

    Consultez Codes d'erreur pour la liste complète.

    Notes de version

    Consultez Notes de version pour la liste complète.