Classificadores de região
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Um classificador de região especifica o formato e o local de um objeto. Um
classificador pode ser um retângulo bidimensional para uma imagem, uma linha de texto em um
documento, uma duração de tempo em um vídeo e assim por diante. Para definir uma região, selecione o classificador que corresponde ao tipo de conteúdo que você quer usar. Por exemplo, se o conteúdo for texto, provavelmente você vai usar o classificador de região txt ou line. Para conferir um exemplo de classificador de região, consulte
Gerenciar comentários e
respostas.
A seguir, uma lista dos classificadores de região incluídos na
API Google Drive:
rectUm retângulo em uma imagem bidimensional.
| Propriedade |
Descrição |
Tipo |
x |
Posição no eixo x. As unidades padrão são pixels para imagens e porcentagem para PDFs. |
Duplo |
y |
Posição no eixo y. As unidades padrão são pixels para imagens e porcentagem para PDFs. |
Duplo |
w |
Comprimento no eixo x. As unidades padrão são pixels para imagens e porcentagem para PDFs. |
Duplo |
h |
Comprimento no eixo y. As unidades padrão são pixels para imagens e porcentagem para PDFs. |
Duplo |
mw |
A largura total do documento quando o comentário foi feito. Use isso para tornar x e w sem unidade, já que eles podem agir como uma porcentagem. |
Duplo |
mh |
A altura total do documento quando o comentário foi feito. Consulte mw acima para saber a finalidade. |
Duplo |
r |
Os graus de rotação do documento. Por exemplo, se uma imagem for girada 90 graus no sentido horário, um retângulo em 0,0 vai aparecer na parte superior direita da imagem. Precisa ser um dos seguintes valores: 0, 90, 180, 270. |
Duplo |
pageUm número de página em um PDF, TIFF ou outro documento com páginas. Use isso para documentos com elementos semelhantes a páginas, como uma planilha, um slide ou uma camada.
| Propriedade |
Descrição |
Tipo |
p |
O número da página (indexado em zero). |
Número inteiro |
mp |
O número de páginas neste documento. |
Número inteiro |
timeUm período de tempo em um vídeo ou outro documento com uma dimensão de tempo.
| Propriedade |
Descrição |
Tipo |
t |
O horário de início. |
String de tempo formatada hh:MM:ss.frac (em que M = minutos, m = milissegundos; horas e minutos são opcionais) |
d |
A duração do período. |
String de tempo formatada hh:MM:ss:mmm (em que M = minutos, m = milissegundos) |
md |
A duração total do documento. |
String de tempo formatada hh:MM:ss:mmm (em que M = minutos, m = milissegundos) |
txtUm intervalo de texto em um documento.
| Propriedade |
Descrição |
Tipo |
o |
Deslocamento inicial (deslocamento de caracteres desde o início do arquivo). |
Número inteiro |
l |
O comprimento do intervalo de texto. |
Número inteiro |
ml |
O comprimento deste documento em caracteres. |
Número inteiro |
lineUma linha específica em um arquivo de texto ou qualquer arquivo com linhas.
| Propriedade |
Descrição |
Tipo |
n |
Número da linha. |
Número inteiro |
l |
O comprimento do intervalo de linhas. |
Número inteiro |
ml |
O número máximo de linhas no arquivo. |
Número inteiro |
matrixUm local em uma estrutura semelhante a uma matriz. Usado para definir linhas e colunas em documentos de planilha ou qualquer outro documento que tenha uma estrutura de linha ou coluna.
| Propriedade |
Descrição |
Tipo |
c |
O número da coluna. |
Número inteiro |
r |
O número da linha. |
Número inteiro |
w |
O número de colunas. |
Número inteiro |
h |
O número de linhas. |
Número inteiro |
mw |
A largura máxima. |
Número inteiro |
mh |
A altura máxima. |
Número inteiro |
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-29 UTC.
[null,null,["Última atualização 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 |"]]
