مصنِّفات المناطق
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يحدّد مصنّف المنطقة التنسيق والموقع الجغرافي لعنصر ما. قد يكون المصنّف مستطيلاً ثنائي الأبعاد لصورة، أو سطراً من النص في مستند، أو مدة زمنية في فيديو، وما إلى ذلك. لتحديد منطقة، اختَر أداة تصنيف المناطق التي تتطابق مع نوع المحتوى الذي تحاول استخدامه. على سبيل المثال، إذا كان المحتوى نصيًا، من المرجّح أن تستخدم أداة تصنيف المنطقة txt أو line. للاطّلاع على مثال على أداة تصنيف المناطق، يُرجى مراجعة مقالة إدارة التعليقات والردود.
في ما يلي قائمة بمصنّفات المناطق المضمّنة في Google Drive API:
rectمستطيل في صورة ثنائية الأبعاد
| الموقع |
الوصف |
النوع |
x |
الموضع على المحور السيني، ويتم ضبط الوحدات تلقائيًا على البكسل للصور والنسبة المئوية لملفات PDF. |
مزدوجة |
y |
الموضع على المحور y، ويتم ضبط الوحدات تلقائيًا على البكسل للصور والنسبة المئوية لملفات PDF. |
مزدوجة |
w |
الطول على المحور السيني، وتكون الوحدات تلقائيًا بالبكسل للصور وبالنسبة المئوية لملفات PDF. |
مزدوجة |
h |
الطول على المحور الصادي، ويتم ضبط الوحدات تلقائيًا على البكسل للصور والنسبة المئوية لملفات PDF. |
مزدوجة |
mw |
تمثّل هذه السمة العرض الكامل للمستند عند إدخال التعليق. استخدِم هذه السمة لجعل x وw بلا وحدات لأنّهما يمكن أن تعملان كنسبة مئوية. |
مزدوجة |
mh |
تمثّل هذه السمة الارتفاع الكامل للمستند عند إدخال التعليق. راجِع mw أعلاه لمعرفة الغرض. |
مزدوجة |
r |
درجات دوران المستند على سبيل المثال، إذا تم تدوير صورة بزاوية 90 درجة في اتجاه عقارب الساعة، سيظهر مستطيل عند 0,0 في أعلى يسار الصورة. يجب أن تكون إحدى القيم 0 أو 90 أو 180 أو 270. |
مزدوجة |
pageرقم صفحة في ملف PDF أو TIFF أو مستند آخر يتضمّن صفحات استخدِم هذا الخيار للمستندات التي تتضمّن عناصر شبيهة بالصفحات (مثل جدول بيانات أو شريحة أو طبقة).
| الموقع |
الوصف |
النوع |
p |
رقم الصفحة (يبدأ من 0). |
عدد صحيح |
mp |
تمثّل هذه السمة عدد الصفحات في هذا المستند. |
عدد صحيح |
timeتمثّل هذه السمة مدة زمنية في فيديو أو مستند آخر يتضمّن سمة الوقت.
| الموقع |
الوصف |
النوع |
t |
وقت البدء |
سلسلة الوقت المنسَّقة hh:MM:ss.frac (حيث M = دقائق، وm = أجزاء من الثانية، والساعات والدقائق اختيارية) |
d |
مدة النطاق الزمني |
سلسلة الوقت المنسَّقة hh:MM:ss:mmm (حيث M = دقائق، m = أجزاء من الثانية) |
md |
تمثّل هذه السمة مدة المستند الكاملة. |
سلسلة الوقت المنسَّقة hh:MM:ss:mmm (حيث M = دقائق، m = أجزاء من الثانية) |
txtنطاق من النص في مستند
| الموقع |
الوصف |
النوع |
o |
إزاحة البداية (إزاحة الأحرف من بداية الملف) |
عدد صحيح |
l |
طول نطاق النص |
عدد صحيح |
ml |
طول هذا المستند بالأحرف |
عدد صحيح |
lineسطر معيّن في ملف نصي أو أي ملفات تتضمّن أسطرًا
| الموقع |
الوصف |
النوع |
n |
رقم السطر |
عدد صحيح |
l |
طول نطاق الأسطر |
عدد صحيح |
ml |
الحد الأقصى لعدد الأسطر في الملف |
عدد صحيح |
matrixتمثّل هذه السمة موقعًا جغرافيًا في بنية تشبه المصفوفة. تُستخدَم لتحديد الصفوف والأعمدة في مستندات جداول البيانات أو أي مستندات أخرى تتضمّن بنية صفوف أو أعمدة.
| الموقع |
الوصف |
النوع |
c |
رقم العمود |
عدد صحيح |
r |
رقم الصف |
عدد صحيح |
w |
تمثّل هذه السمة عدد الأعمدة. |
عدد صحيح |
h |
عدد الصفوف |
عدد صحيح |
mw |
الحد الأقصى للعرض |
عدد صحيح |
mh |
تمثّل هذه السمة الحد الأقصى للارتفاع. |
عدد صحيح |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],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 |"]]
