Classificateurs de régions
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Un classificateur de région spécifie le format et l'emplacement d'un objet. Un classificateur peut être un rectangle bidimensionnel pour une image, une ligne de texte dans un document, une durée dans une vidéo, etc. Pour définir une région, sélectionnez le classificateur de région qui correspond au type de contenu que vous essayez d'utiliser. Par exemple, si votre contenu est du texte, vous utiliserez probablement le classificateur de région txt ou line. Pour voir un exemple de classificateur de régions, consultez Gérer les commentaires et les réponses.
Vous trouverez ci-dessous la liste des classificateurs de région inclus dans l'API Google Drive :
rectRectangle dans une image bidimensionnelle.
| Propriété |
Description |
Type |
x |
Position sur l'axe X. Les unités sont définies par défaut sur les pixels pour les images et sur le pourcentage pour les PDF. |
Double |
y |
Position sur l'axe y. Les unités sont définies par défaut sur les pixels pour les images et sur le pourcentage pour les PDF. |
Double |
w |
Longueur sur l'axe X. Les unités sont définies par défaut sur les pixels pour les images et sur le pourcentage pour les PDF. |
Double |
h |
Longueur sur l'axe Y. Les unités sont définies par défaut sur les pixels pour les images et sur le pourcentage pour les PDF. |
Double |
mw |
Largeur totale du document au moment où le commentaire a été ajouté. Utilisez-le pour rendre x et w sans unité, car ils peuvent agir comme un pourcentage. |
Double |
mh |
Hauteur totale du document au moment où le commentaire a été ajouté. Consultez mw ci-dessus pour connaître l'objectif. |
Double |
r |
Degrés de rotation du document. Par exemple, si une image est pivotée de 90 degrés dans le sens des aiguilles d'une montre, un rectangle à 0,0 s'affiche en haut à droite de l'image. Doit être l'une des valeurs suivantes : 0, 90, 180 ou 270. |
Double |
pageNuméro de page dans un PDF, un TIFF ou un autre document comportant des pages. Utilisez cette option pour les documents comportant des éléments de type page (comme une feuille de calcul, une diapositive ou un calque).
| Propriété |
Description |
Type |
p |
Numéro de page (indexé à 0). |
Nombre entier |
mp |
Nombre de pages de ce document. |
Nombre entier |
timeDurée d'une vidéo ou d'un autre document comportant une dimension temporelle.
| Propriété |
Description |
Type |
t |
Heure de début. |
Chaîne temporelle au format hh:MM:ss.frac (où M = minutes, m = millisecondes ; les heures et les minutes sont facultatives) |
d |
Durée de la période. |
Chaîne de temps au format hh:MM:ss:mmm (où M = minutes, m = millisecondes) |
md |
Durée à temps plein du document. |
Chaîne de temps au format hh:MM:ss:mmm (où M = minutes, m = millisecondes) |
txtPlage de texte dans un document.
| Propriété |
Description |
Type |
o |
Décalage de début (décalage de caractères depuis le début du fichier). |
Nombre entier |
l |
Longueur de la plage de texte. |
Nombre entier |
ml |
Longueur de ce document en nombre de caractères. |
Nombre entier |
lineUne ligne spécifique dans un fichier texte ou dans tout fichier contenant des lignes.
| Propriété |
Description |
Type |
n |
Numéro de ligne. |
Nombre entier |
l |
Longueur de la plage de lignes. |
Nombre entier |
ml |
Nombre maximal de lignes dans le fichier. |
Nombre entier |
matrixEmplacement dans une structure de type matrice. Permet de définir des lignes et des colonnes dans des feuilles de calcul ou tout autre document comportant une structure de lignes ou de colonnes.
| Propriété |
Description |
Type |
c |
Numéro de la colonne. |
Nombre entier |
r |
Numéro de ligne. |
Nombre entier |
w |
Nombre de colonnes. |
Nombre entier |
h |
Nombre de lignes |
Nombre entier |
mw |
Largeur maximale. |
Nombre entier |
mh |
Hauteur maximale. |
Nombre entier |
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[null,null,["Dernière mise à jour le 2025/08/29 (UTC)."],[],[],null,["# Region classifiers\n\nA region classifier specifies the format and location for an object. A\nclassifier might be a 2-dimensional rectangle for an image, a line of text in a\ndocument, a time duration in a video, and so on. To define a region, select the\nregion classifier that matches the type of content you're trying to use. For\nexample, if your content is text, you're likely going to use either the `txt`\nor `line` region classifier. To see an example of a region classifier, see\n[Manage comments and\nreplies](https://developers.google.com/workspace/drive/api/guides/manage-comments#define).\n\nThe following is a list of the region classifiers included with the\nGoogle Drive API:\n\n`rect`\n\n: A rectangle in a 2-dimensional image.\n\n | Property | Description | Type |\n |----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------|\n | `x` | Position on the x axis, units default to pixels for images and percent for PDFs. | Double |\n | `y` | Position on the y axis, units default to pixels for images and percent for PDFs. | Double |\n | `w` | Length on the x axis, units default to pixels for images and percent for PDFs. | Double |\n | `h` | Length on the y axis, units default to pixels for images and percent for PDFs. | Double |\n | `mw` | The full width of the document when the comment was made. Use this to make `x` and `w` unitless since they can act like a percentage. | Double |\n | `mh` | The full height of the document when the comment was made. See `mw` above for purpose. | Double |\n | `r` | The degrees of rotation of the document. For example, if an image is rotated 90 degrees clockwise then a rectangle at 0,0 displays in the top right of the image. Should be one of 0, 90, 180, 270. | Double |\n\n`page`\n\n: A page number in a PDF, TIFF, or other document with pages. Use this for documents with page-like elements (such as a spreadsheet, slide, or layer).\n\n | Property | Description | Type |\n |----------|---------------------------------------|---------|\n | `p` | The page number (0-indexed). | Integer |\n | `mp` | The number of pages in this document. | Integer |\n\n`time`\n\n: A duration of time in a video or other document with a time dimension.\n\n | Property | Description | Type |\n |----------|-----------------------------------------|-------------------------------------------------------------------------------------------------------|\n | `t` | The start time. | `hh:MM:ss.frac` formatted time string (where M = minutes, m = millis; hours and minutes are optional) |\n | `d` | The duration of the time range. | `hh:MM:ss:mmm` formatted time string (where M = minutes, m = millis) |\n | `md` | The full-time duration of the document. | `hh:MM:ss:mmm` formatted time string (where M = minutes, m = millis) |\n\n`txt`\n\n: A range of text in a document.\n\n | Property | Description | Type |\n |----------|-------------------------------------------------------------|---------|\n | `o` | Start offset (character offset from the start of the file). | Integer |\n | `l` | The length of the text range. | Integer |\n | `ml` | The length of this document in characters. | Integer |\n\n`line`\n\n: A specific line in a text file or any files with lines in it.\n\n | Property | Description | Type |\n |----------|------------------------------------------|---------|\n | `n` | Line number. | Integer |\n | `l` | The length of the line range. | Integer |\n | `ml` | The maximum number of lines in the file. | Integer |\n\n`matrix`\n\n: A location in a matrix-like structure. Used to define rows and columns in spreadsheet documents, or any other documents that have a row or column structure.\n\n | Property | Description | Type |\n |----------|------------------------|---------|\n | `c` | The column number. | Integer |\n | `r` | The row number. | Integer |\n | `w` | The number of columns. | Integer |\n | `h` | The number of rows. | Integer |\n | `mw` | The maximum width. | Integer |\n | `mh` | The maximum height. | Integer |"]]
